LoomInspection

The state of a loom: its shape, what is held close, what is fading, and what the night last did.

Kind: an object, used in responses.

Fields

Every field is present in a response; empty ones are null.

Field	Type	Description
loom	Loom	The loom itself.
tally	LoomTally	How many threads the loom holds, by strand, kind and state.
pinned	LoomThread[]	Threads held close (up to 10, heaviest first): always part of what an agent wakes up knowing.
recentlyAccessed	LoomThread[]	The threads most recently recalled or used (up to 5).
highWeightDormant	LoomThread[]	Important threads (weight 0.7 or more) that have gone unused for over 30 days (up to 5).
fraying	LoomThread[]	Threads loosening through disuse (up to 5, the most frayed first).
openTensions	LoomTensionView[]	Pairs of threads that pull against each other and have not been resolved (up to 5).
lastNightWeaving	NightWeaving| null	The most recent night weaving of this loom that completed. Null if none has.
panelSubjects	string[]	The subjects (people and things) the tapestry has a panel about.
patterns	string[]	The codebases this loom keeps a pattern for.

Example

{
  "loom": {
    "name": "...",
    "description": "...",
    "scopeKey": "...",
    "seedFromLoomId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
    "seededAt": "2026-10-26T12:00:00.0000000Z",
    "settings": {
      "nightWeaving": false,
      "quietMinutes": 0,
      "weaverModel": "...",
      "effectiveNightWeaving": false,
      "effectiveQuietPeriod": "00:05:00"
    },
    "lastWovenAt": "2026-10-26T12:00:00.0000000Z",
    "lastActivityAt": "2026-10-26T12:00:00.0000000Z",
    "lastActivityProcessId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
    "lastNightWeavingAt": "2026-10-26T12:00:00.0000000Z",
    "nightWeavingPending": false,
    "nightWeavingNotBefore": "2026-10-26T12:00:00.0000000Z",
    "namespaceId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
    "tenantId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
    "id": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
    "dateCreated": "2026-10-26T12:00:00.0000000Z",
    "dateUpdated": "2026-10-26T12:00:00.0000000Z"
  },
  "tally": {
    "threads": 0,
    "warp": 0,
    "weft": 0,
    "knots": 0,
    "pinned": 0,
    "private": 0,
    "byKind": {
      "key": 0
    }
  },
  "pinned": [
    {
      "loomId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "content": "...",
      "kind": "Semantic",
      "strand": "Weft",
      "weight": 0,
      "fray": 0,
      "decayRate": "Normal",
      "subjects": [],
      "subjectKeys": [],
      "tags": [],
      "cues": [],
      "visibility": "Shared",
      "until": "2026-10-26T12:00:00.0000000Z",
      "basis": "Said",
      "pinned": false,
      "origin": {},
      "companions": [],
      "provenance": {},
      "canTravel": false,
      "accessCount": 0,
      "lastAccessedAt": "2026-10-26T12:00:00.0000000Z",
      "surfacedCount": 0,
      "lastSurfacedAt": "2026-10-26T12:00:00.0000000Z",
      "reinforcements": 0,
      "knot": {},
      "seams": [],
      "revision": 0,
      "isKnot": false,
      "isWarp": false,
      "isIntention": false,
      "isLoose": false,
      "salience": 0,
      "shortId": "...",
      "tenantId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "id": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "dateCreated": "2026-10-26T12:00:00.0000000Z",
      "dateUpdated": "2026-10-26T12:00:00.0000000Z"
    }
  ],
  "recentlyAccessed": [
    {
      "loomId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "content": "...",
      "kind": "Semantic",
      "strand": "Weft",
      "weight": 0,
      "fray": 0,
      "decayRate": "Normal",
      "subjects": [],
      "subjectKeys": [],
      "tags": [],
      "cues": [],
      "visibility": "Shared",
      "until": "2026-10-26T12:00:00.0000000Z",
      "basis": "Said",
      "pinned": false,
      "origin": {},
      "companions": [],
      "provenance": {},
      "canTravel": false,
      "accessCount": 0,
      "lastAccessedAt": "2026-10-26T12:00:00.0000000Z",
      "surfacedCount": 0,
      "lastSurfacedAt": "2026-10-26T12:00:00.0000000Z",
      "reinforcements": 0,
      "knot": {},
      "seams": [],
      "revision": 0,
      "isKnot": false,
      "isWarp": false,
      "isIntention": false,
      "isLoose": false,
      "salience": 0,
      "shortId": "...",
      "tenantId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "id": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "dateCreated": "2026-10-26T12:00:00.0000000Z",
      "dateUpdated": "2026-10-26T12:00:00.0000000Z"
    }
  ],
  "highWeightDormant": [
    {
      "loomId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "content": "...",
      "kind": "Semantic",
      "strand": "Weft",
      "weight": 0,
      "fray": 0,
      "decayRate": "Normal",
      "subjects": [],
      "subjectKeys": [],
      "tags": [],
      "cues": [],
      "visibility": "Shared",
      "until": "2026-10-26T12:00:00.0000000Z",
      "basis": "Said",
      "pinned": false,
      "origin": {},
      "companions": [],
      "provenance": {},
      "canTravel": false,
      "accessCount": 0,
      "lastAccessedAt": "2026-10-26T12:00:00.0000000Z",
      "surfacedCount": 0,
      "lastSurfacedAt": "2026-10-26T12:00:00.0000000Z",
      "reinforcements": 0,
      "knot": {},
      "seams": [],
      "revision": 0,
      "isKnot": false,
      "isWarp": false,
      "isIntention": false,
      "isLoose": false,
      "salience": 0,
      "shortId": "...",
      "tenantId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "id": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "dateCreated": "2026-10-26T12:00:00.0000000Z",
      "dateUpdated": "2026-10-26T12:00:00.0000000Z"
    }
  ],
  "fraying": [
    {
      "loomId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "content": "...",
      "kind": "Semantic",
      "strand": "Weft",
      "weight": 0,
      "fray": 0,
      "decayRate": "Normal",
      "subjects": [],
      "subjectKeys": [],
      "tags": [],
      "cues": [],
      "visibility": "Shared",
      "until": "2026-10-26T12:00:00.0000000Z",
      "basis": "Said",
      "pinned": false,
      "origin": {},
      "companions": [],
      "provenance": {},
      "canTravel": false,
      "accessCount": 0,
      "lastAccessedAt": "2026-10-26T12:00:00.0000000Z",
      "surfacedCount": 0,
      "lastSurfacedAt": "2026-10-26T12:00:00.0000000Z",
      "reinforcements": 0,
      "knot": {},
      "seams": [],
      "revision": 0,
      "isKnot": false,
      "isWarp": false,
      "isIntention": false,
      "isLoose": false,
      "salience": 0,
      "shortId": "...",
      "tenantId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "id": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "dateCreated": "2026-10-26T12:00:00.0000000Z",
      "dateUpdated": "2026-10-26T12:00:00.0000000Z"
    }
  ],
  "openTensions": [
    {
      "tension": {},
      "thread1": {},
      "thread2": {}
    }
  ],
  "lastNightWeaving": {
    "loomId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
    "status": "Running",
    "dateCompleted": "2026-10-26T12:00:00.0000000Z",
    "sourceInteractionProcessId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
    "sessionIds": [
      "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f"
    ],
    "counts": {
      "sessionsConsolidated": 0,
      "episodesWoven": 0,
      "threadsWoven": 0,
      "threadsTightened": 0,
      "threadsFrayed": 0,
      "threadsMerged": 0,
      "threadsSuperseded": 0,
      "dreamLogsRetired": 0,
      "intentionsLapsed": 0,
      "tensionsFound": 0,
      "themesWoven": 0,
      "themesRefined": 0,
      "panelsWoven": 0,
      "patternsRefined": 0,
      "threadsMadeOwn": 0,
      "companionsLinked": 0,
      "threadsEmbedded": 0
    },
    "dreamLog": "...",
    "dreamLogThreadId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
    "error": "...",
    "tokenUsage": [
      {}
    ],
    "tenantId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
    "id": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
    "dateCreated": "2026-10-26T12:00:00.0000000Z",
    "dateUpdated": "2026-10-26T12:00:00.0000000Z"
  },
  "panelSubjects": [
    "..."
  ],
  "patterns": [
    "..."
  ]
}

Where it’s used

• looms.inspect (GET /looms/by-id/{id}/inspect)