Skip to content

ThingDetail

ThingDetail = ThingDetailFields & object

Full record shape for a single Thing returned by single-record SDK reads. Returned by client.thing.get and client.thing.resolve, the items[] element type for client.thing.getMany, the base of client.thing.graph, and the return of client.repo.getReadme and getAgents. Identity fields (wref, name, kind, declaredShapes) are populated. data carries the shape-validated payload when present; active is false for retracted reads. The [key: string]: unknown index signature is a forward-compat affordance — current callers should rely on the named fields. Note: list reads — client.thing.head, query, and search — return a thinner row shape (no committerWref); use client.thing.get to hydrate a full ThingDetail from a list result.

Authored WREF values inside data and identity metadata such as aboutWref, committerWref, createdBy, and revisedBy use durable ids in the reader-independent base response. Body references preserve their exact version pin; identity references are unpinned. With decorateResponses, a separate decorations sidecar maps readable durable ids to current canonical labels without rewriting the base body. A durable id grants no target access.

optional systemShapes?: string[]

The validatedShapes that are system Shapes; absent when none.

https://docs.warmhub.ai/data-modeling/things/