# 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`](https://docs.maitento.com/reference/types/loom.md) | The loom itself. |
| `tally` | [`LoomTally`](https://docs.maitento.com/reference/types/loom-tally.md) | How many threads the loom holds, by strand, kind and state. |
| `pinned` | [`LoomThread`](https://docs.maitento.com/reference/types/loom-thread.md)`[]` | Threads held close (up to 10, heaviest first): always part of what an agent wakes up knowing. |
| `recentlyAccessed` | [`LoomThread`](https://docs.maitento.com/reference/types/loom-thread.md)`[]` | The threads most recently recalled or used (up to 5). |
| `highWeightDormant` | [`LoomThread`](https://docs.maitento.com/reference/types/loom-thread.md)`[]` | Important threads (weight 0.7 or more) that have gone unused for over 30 days (up to 5). |
| `fraying` | [`LoomThread`](https://docs.maitento.com/reference/types/loom-thread.md)`[]` | Threads loosening through disuse (up to 5, the most frayed first). |
| `openTensions` | [`LoomTensionView`](https://docs.maitento.com/reference/types/loom-tension-view.md)`[]` | Pairs of threads that pull against each other and have not been resolved (up to 5). |
| `lastNightWeaving` | [`NightWeaving`](https://docs.maitento.com/reference/types/night-weaving.md)`\| 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

```json
{
  "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`](https://docs.maitento.com/reference/api/looms.md) (`GET /looms/by-id/{id}/inspect`)