Loom files

A named loom: a long-term memory several interactions can share. A participant uses it with loom = @ref("name") on its seat. A deploy creates the loom, or brings its description and settings up to date; it never touches what the loom remembers, and removing the file does not delete the loom.

What looms are for, and how to use them: Memory.

Where the file goes

looms/, or any sub-folder of it. The file name without .mtr is the loom’s name. Other files refer to it as @ref("<name>").

A resource’s name is its file name without .mtr (an app’s is its folder’s name). Use letters, digits, _, - and . (but not ..), at most 128 characters. Two files of the same kind may not have the same name, even in different sub-folders or with different capitals.

Properties

Every property is optional.

`description`

Optional. Text.

What the loom is for, shown in the portal.

description = "What the input is for"

`nightWeaving`

Optional. true or false. Default: true.

Tidy up the loom once conversations go quiet: summarise them, merge duplicates, note contradictions and write a short portrait of each person.

nightWeaving = true

`quietMinutes`

Optional. Whole number. Default: 15.

Minutes without activity before night weaving starts.

quietMinutes = 5

`weaverModel`

Optional. Text.

The catalogue model that night-weaves the loom, such as "anthropic.haiku-4.5". The model of the agent whose conversation it is when not set.

weaverModel = "deepseek.deepseek-v4-flash"

A complete example

From the 20-memory example project:

// A loom a whole household shares. Declared here, it exists before anyone talks to Wren: deploying
// creates it (or updates its settings); a deploy never touches what it holds.

description = "What Wren knows about the family: shared across everyone who talks to it in wren-family."
nightWeaving = true
quietMinutes = 5