@agentshouse/mdruntime-adapter 0.1.0-cd673d02b6e50 → 0.1.0-cd75dfaf57319

package/dist/house-model.js

@@ -1,486 +1,393 @@
-export const HOUSE_MODEL_TYPES = `$defs:
-  room:
-    description: A Room, by its Room reference, under the key \`room\`.
-    type: string
-    pattern: '^r_([0123456789abcdefghjkmnpqrstvwxyz]+)\\.([0123456789abcdefghjkmnpqrstvwxyz])$'
-  app:
-    description: An App, by its App reference, under the key \`app\`.
-    type: string
-    pattern: '^a_([0123456789abcdefghjkmnpqrstvwxyz]+)\\.([0123456789abcdefghjkmnpqrstvwxyz])$'
-  document:
-    description: A document of a Room, by its file reference, under the key \`document\`.
-    type: string
-    pattern: '^af_([123456789abcdefghjkmnpqrstvwxyz][0123456789abcdefghjkmnpqrstvwxyz]*)\\.([0123456789abcdefghjkmnpqrstvwxyz])$'
-  id:
-    description: Any other entity, by its identifier, under the key of its kind. An entity a type says more about is an object holding it under that key beside its facts.
-    type: string
-    format: uuid
-  namespace:
-    description: The Namespace a grant entry covers, an App or a Room by its reference with the area of it.
-    type: string
-    maxLength: 512
-    pattern: '^(?:a_[A-Za-z0-9._-]+(?:\\/source)?|r_[A-Za-z0-9._-]+(?:\\/(?:settings|settings\\/schema|settings\\/model|settings\\/indexing|content))?)$'
-  request:
-    description: One Routine Request of a Room.
-    type: object
-    additionalProperties: false
-    properties:
-      routine_request: { $ref: '#/$defs/id' }
-      conversation: { $ref: '#/$defs/id' }
-      origin: { enum: [ user, trigger ] }
-      state: { enum: [ awaiting_approval, started, finished, not_started, withdrawn_by_author, withdrawn_admission, declined ] }
-      target: { type: object, additionalProperties: false, properties: { user: { $ref: '#/$defs/id' } }, required: [ user ] }
-      record: { $ref: '#/$defs/id' }
-      routine_access: { $ref: '#/$defs/id' }
-      agent: { $ref: '#/$defs/id' }
-      routine: { type: object, additionalProperties: false, properties: { name: { type: string }, version: { type: integer, exclusiveMinimum: 0 } }, minProperties: 1 }
-      approved: { type: string, format: date-time }
-      approved_by: { type: object, additionalProperties: false, properties: { user: { $ref: '#/$defs/id' } }, required: [ user ] }
-      settled_by: { type: object, additionalProperties: false, properties: { user: { $ref: '#/$defs/id' } }, required: [ user ] }
-      failure_category: { enum: [ routine_access_not_found, routine_retired, target_agent_unavailable, agent_unavailable, admission_lapsed ] }
-      created: { type: string, format: date-time }
-      activated: { type: string, format: date-time }
-      settled: { type: string, format: date-time }
-      environment_starting: { const: true }
-      undelivered: { const: true }
-      result: { type: string }
-      url: { type: string, format: uri }
-    required: [ routine_request, origin, state, target, created ]
-  caller:
-    description: One caller of a Routine Access, a User under \`user\` with their account \`email\` and display \`name\`, or under \`user\` alone once they left the Room, or the Access's \`room\`, whose Triggers then call.
-    type: object
-    additionalProperties: false
-    properties:
-      user: { $ref: '#/$defs/id' }
-      email: { type: string }
-      name: { type: string }
-      room: { $ref: '#/$defs/room' }
-    minProperties: 1
-  trigger_test:
-    description: One test of a Trigger condition as the Trigger reference page writes one, a value compared at a \`path\` or \`all\`, \`any\` or \`not\` of tests.
-    type: object
-    additionalProperties: true
-  trigger_values:
-    type: array
-    items: { anyOf: [ { type: string }, { type: number }, { type: boolean } ] }
-  trigger_scope:
-    description: The documents a Trigger condition watches, by \`type\`, by \`folder\` or one document at its \`path\`, which \`create_trigger\` takes as \`document\`.
-    type: object
-    additionalProperties: false
-    properties:
-      type: { type: string }
-      folder: { type: string }
-      path: { type: string }
-    minProperties: 1
-    maxProperties: 1
-house-account:
-  description: "The User's own identifier as \`user\`, their registration as \`created\`, their email verification and chosen language, every notification group with the channels it now reaches as \`notifications\`, \`telegram: available\` while the Building runs its Telegram bots and no Telegram account is linked to it, \`linked\` while one is, \`started\` once that account has also pressed Start in the Inbox bot, \`meta\`, the Building's Meta app as \`application\` and its signup configuration as \`configuration\`, with \`business_app\` where its signup offers to keep the WhatsApp Business app on the number's phone, while it offers Connect Meta, \`tiktok: available\` while it offers Connect TikTok, \`building: administrator\` while the User is one of the Building's administrators, and \`full_house: true\` while the User holds Full House."
-  properties:
-    reflected: { type: string, format: date-time }
-    user: { $ref: '#/$defs/id' }
-    email_verified: { type: string, format: date-time }
-    language: { enum: [ en ] }
-    notifications: { type: array, items: { type: object, additionalProperties: false, properties: { group: { type: string }, channels: { type: array, items: { type: string } } }, required: [ group, channels ] } }
-    created: { type: string, format: date-time }
-    telegram: { enum: [ available, linked, started ] }
-    meta: { type: object, additionalProperties: false, properties: { application: { type: string, pattern: '^\\d{1,32}$' }, configuration: { type: string, pattern: '^\\d{1,32}$' }, business_app: { const: true } }, required: [ application, configuration ] }
-    tiktok: { enum: [ available ] }
-    building: { enum: [ administrator ] }
-    full_house: { const: true }
-  required: [ reflected, user, email_verified, notifications, created ]
-house-agent:
-  description: One registered Agent this User owns, with the \`profile\` and \`environment\` it binds, when it was \`created\` and, once it is, \`retired\`.
-  properties:
-    reflected: { type: string, format: date-time }
-    agent: { $ref: '#/$defs/id' }
-    name: { type: string }
-    profile: { $ref: '#/$defs/id' }
-    environment: { $ref: '#/$defs/id' }
-    launch_directory: { type: string }
-    created: { type: string, format: date-time }
-    retired: { type: string, format: date-time }
-  required: [ reflected, agent, name, profile, environment, launch_directory, created ]
-house-agent-profile:
-  description: One reusable Agent Profile this User owns, with the execution route it binds and the \`arguments\` that route passes its CLI. Its body is its instructions, whole, in Markdown.
-  properties:
-    reflected: { type: string, format: date-time }
-    profile: { $ref: '#/$defs/id' }
-    name: { type: string }
-    revision: { type: integer, minimum: 0 }
-    adapter_kind: { type: string }
-    model: { type: string }
-    effort: { type: string }
-    mode: { type: string }
-    arguments: { type: array, items: { type: string } }
-  required: [ reflected, profile, name, revision ]
-house-app:
-  description: "One App this User owns, holds or installed, \`ownership\` naming whether it is its own or one it holds, its \`owner\` by \`name\` when another User owns it, and \`my_app\` \`true\` on this User's My App alone, with the path of its window on the control origin as \`address\`, its tab icon for a light and for a dark appearance as image data addresses with, while the icon is generated, its one to four colours, blend and angle, its running release as \`latest_release\` by \`release\` and \`sequence\`, with the external origins it declares as \`external_origins\`, whether its code reaches this User's conversations as \`conversations\`, the Room slots it declares in order as \`room_slots\`, each \`slot\` with its \`access\` and \`types\`, and the names of the App functions it declares in order as \`functions\`, each installation this User holds, and every User who holds the App as \`holders\`, this User and its owner included, by \`user\`, \`name\` and \`email\`. Each installation entry names the \`installation\`, the App's running \`release\` and when it was installed as \`created\`. Each features entry names, for an App this User does not own, a \`feature\`, a browser feature, a House model type or a House act its release declares, and its \`consent\`, \`allowed\` or \`denied\` the first time the App asked; a feature never asked is absent. \`features_version\` is the version of this User's latest consent change for the App, which apps/features/set answers as \`features_version\`."
-  properties:
-    reflected: { type: string, format: date-time }
-    app: { $ref: '#/$defs/app' }
-    address: { type: string, pattern: '^\\/app\\/a_([0123456789abcdefghjkmnpqrstvwxyz]+)\\.([0123456789abcdefghjkmnpqrstvwxyz])$' }
-    name: { type: string }
-    ownership: { enum: [ own, held ] }
-    owner: { type: object, additionalProperties: false, properties: { name: { type: string } }, required: [ name ] }
-    my_app: { const: true }
-    created: { type: string, format: date-time }
-    tab_icon_light: { type: string, pattern: ^data:image\\/ }
-    tab_icon_dark: { type: string, pattern: ^data:image\\/ }
-    tab_icon_colours: { type: array, items: { type: string, pattern: '^#[0-9a-f]{6}$' } }
-    tab_icon_blend: { enum: [ linear, radial ] }
-    tab_icon_angle: { type: integer, minimum: 0, maximum: 359 }
-    latest_release: { type: object, additionalProperties: false, properties: { release: { $ref: '#/$defs/id' }, sequence: { type: integer, exclusiveMinimum: 0 } }, required: [ release, sequence ] }
-    external_origins: { type: array, items: { type: string, format: uri } }
-    conversations: { enum: [ yes, no ] }
-    room_slots: { type: array, items: { type: object, additionalProperties: false, properties: { slot: { type: string }, access: { enum: [ read, write ] }, types: { type: array, items: { type: string } } }, required: [ slot, access, types ] } }
-    functions: { type: array, items: { type: string } }
-    installations: { type: array, items: { type: object, additionalProperties: false, properties: { installation: { $ref: '#/$defs/id' }, release: { $ref: '#/$defs/id' }, created: { type: string, format: date-time } }, required: [ installation, release, created ] } }
-    holders: { type: array, items: { type: object, additionalProperties: false, properties: { user: { $ref: '#/$defs/id' }, name: { type: string }, email: { type: string } }, required: [ user, name, email ] } }
-    features: { type: array, items: { type: object, additionalProperties: false, properties: { feature: { type: string }, consent: { enum: [ allowed, denied ] } }, required: [ feature, consent ] } }
-    features_version: { type: integer, exclusiveMinimum: 0 }
-  required: [ reflected, app, address, name, ownership, created ]
-house-app-preferences:
-  description: An App's preferences. Its own vocabulary is in the body.
-  properties:
-    app: { $ref: '#/$defs/app' }
-  required: [ app ]
-house-app-room-binding:
-  description: "One durable App-Room binding this User holds: an ordered Room list, one Shared schema, or \`rooms\`, \`all\` for every Room this User has or \`all_but_private\` for every one but their Private Room, for a named Room slot of one \`app\`, shared by every device and browser installation they sign in from. Only this User's own bindings appear here. A Shared-schema binding names the \`shared_schema\` with its own structural \`compatibility\` and \`findings\`, the Rooms that currently use it and this User reads, and how many Rooms the instance bound leaves out. A \`rooms\` binding holds this User's Rooms that fit the slot, and \`left_out\` counts the others and those past the instance bound. Each entry names a \`room\` and the last structural comparison of the slot with its selected model as \`compatibility\`, \`unchecked\`, \`compatible\` or \`incompatible\`, and each finding a \`room\` and one exact structural \`finding\` of it against the slot. An explicit entry whose Room this User cannot read is absent until access returns; an empty explicit list has no document. An incompatible entry or Shared schema blocks nothing: the App still opens and the model still changes."
-  properties:
-    reflected: { type: string, format: date-time }
-    app: { $ref: '#/$defs/app' }
-    slot: { type: string, pattern: '^[a-z0-9]([a-z0-9-]*[a-z0-9])?$' }
-    types: { type: array, items: { type: string } }
-    slot_access: { enum: [ read, write ] }
-    shared_schema: { type: object, additionalProperties: false, properties: { shared_schema: { $ref: '#/$defs/id' }, compatibility: { enum: [ unchecked, compatible, incompatible ] }, findings: { type: array, items: { type: string } } }, required: [ shared_schema, compatibility, findings ] }
-    rooms: { enum: [ all, all_but_private ] }
-    left_out: { type: integer, minimum: 0 }
-    entries: { type: array, items: { type: object, additionalProperties: false, properties: { room: { $ref: '#/$defs/room' }, compatibility: { enum: [ unchecked, compatible, incompatible ] } }, required: [ room, compatibility ] } }
-    findings: { type: array, items: { type: object, additionalProperties: false, properties: { room: { $ref: '#/$defs/room' }, finding: { type: string } }, required: [ room, finding ] } }
-  required: [ reflected, app, slot ]
-house-client:
-  description: One MCP client this User authorized, named as it was created. Its last use and whether its credentials expired are read on request.
-  properties:
-    reflected: { type: string, format: date-time }
-    client: { $ref: '#/$defs/id' }
-    name: { type: string }
-    kind: { enum: [ browser, headless ] }
-    created: { type: string, format: date-time }
-    ended: { type: string, format: date-time }
-    end: { enum: [ revoked ] }
-  required: [ reflected, client, name, kind, created ]
-house-environment:
-  description: "One Environment this User holds, with its configuration, its \`name\`, the one its User entered, when it was \`created\`, the Rooms it reaches, \`all\`, \`all_but_private\` or the \`selected\` ones \`rooms\` names, each by its \`room\`, \`login_code\`, \`yes\` while it holds a reusable login code, the agent CLI kinds House admits in \`offered\`, the kinds House last set in \`wanted\`, and the latest readiness its Kit reported in \`agents\`. \`kind\` is the kind of Environment, \`sandbox\`, a small Environment House runs with limited capacity, especially disk, \`vps\`, an always-on Environment House runs with better specs, or \`own\` for its owner's own computer. \`lifecycle\` is the state of that Sandbox or VPS: \`provisioning\` while House creates it, \`starting\` while it starts or House wakes it, \`available\` once its Kit connected, \`stopped\` or \`failed\`. For a Sandbox, \`budget\` is its runtime budget in hours a month and \`budget_spent\` is \`yes\` once its runtime this UTC month reached it. Each offered entry names one adapter kind the owner may select for this Environment. Each wanted entry names one adapter kind the Kit should hold. Each agent entry names the adapter \`kind\`, its installed \`version\` or null when the Kit could not install it, for a CLI below its adapter's minimum that \`minimum\`, \`failure\`, that install's cause, \`installing\`, true only while the Kit installs it, whether the CLI is \`signed_in\`, its \`models\`, each \`model\` with its \`efforts\` as the CLI's session options name them, its \`modes\`, each \`mode\` with the \`name\` the CLI gives it, and \`full_access\`, the mode that bypasses every permission, or null for a CLI that offers no mode and always runs so. A wanted kind no entry names is not yet reported. \`transcribe\` is whether the Kit transcribes a message's audio files, as House last set it, and \`transcription\` names whether the Kit has the engine \`installed\` and the \`failure\` of its last download or null, as the Kit last reported it. \`os\` is the operating system and version of the Environment, \`kit_release\` the installed Kit release and \`form\` the computer's form, \`laptop\`, \`desktop\` or \`server\`, as the Kit last reported them. Placement failure is projected on its transitions; \`failed\` names the failure's category and never its cause. For a VPS, \`ssh\` is its owner's root login on port 22."
-  properties:
-    reflected: { type: string, format: date-time }
-    environment: { $ref: '#/$defs/id' }
-    name: { type: string }
-    created: { type: string, format: date-time }
-    revoked: { type: string, format: date-time }
-    reach: { enum: [ all, all_but_private, selected ] }
-    rooms: { type: array, items: { type: object, additionalProperties: false, properties: { room: { $ref: '#/$defs/room' } }, required: [ room ] } }
-    login_code: { enum: [ yes, no ] }
-    kind: { enum: [ sandbox, vps, own ] }
-    lifecycle: { enum: [ provisioning, starting, available, stopped, failed ] }
-    offered: { type: array, items: { type: string } }
-    wanted: { type: array, items: { type: string } }
-    agents: { type: array, items: { type: object, additionalProperties: false, properties: { kind: { type: string, minLength: 1, maxLength: 64 }, version: { anyOf: [ { type: string, minLength: 1, maxLength: 64 }, { type: 'null' } ] }, minimum: { description: "Present only for a CLI below its adapter's minimum version: that minimum.", type: string, minLength: 1, maxLength: 64 }, failure: { anyOf: [ { type: string, minLength: 1, maxLength: 4096 }, { type: 'null' } ] }, installing: { description: 'Present only while the Kit installs the CLI, whose version and failure are then null.', type: boolean, const: true }, signed_in: { type: boolean }, models: { maxItems: 256, type: array, items: { type: object, additionalProperties: false, properties: { model: { type: string, minLength: 1 }, efforts: { maxItems: 32, type: array, items: { type: string, minLength: 1 } } }, required: [ model, efforts ] } }, modes: { maxItems: 32, type: array, items: { type: object, additionalProperties: false, properties: { mode: { type: string, minLength: 1 }, name: { type: string, minLength: 1, maxLength: 128 } }, required: [ mode, name ] } }, full_access: { anyOf: [ { type: string, minLength: 1 }, { type: 'null' } ] } }, required: [ kind, version, failure, signed_in, models, modes, full_access ] } }
-    transcribe: { enum: [ on, off ] }
-    transcription: { type: object, additionalProperties: false, properties: { installed: { type: boolean }, failure: { anyOf: [ { type: string, minLength: 1, maxLength: 4096 }, { type: 'null' } ] } }, required: [ installed, failure ] }
-    os: { type: string }
-    kit_release: { type: string }
-    form: { enum: [ laptop, desktop, server ] }
-    failed: { enum: [ provisioning_failed, bootstrap_timeout, provider_capacity, provider_unavailable, provider_removed, placement_conflict, placement_intervention, environment_authority_unavailable ] }
-    budget: { type: string, pattern: ^\\d+(?:\\.\\d+)?$ }
-    budget_spent: { enum: [ yes, no ] }
-    ssh: { type: string, pattern: ^root@\\S+$ }
-  required: [ reflected, environment, name, created, reach, kind, offered, transcribe ]
-house-exports:
-  description: This User's Exports, each with its \`status\`, when it was \`created\` and, once it has one, when it \`expires\`; a ready one names its download page as \`page\`.
-  properties:
-    reflected: { type: string, format: date-time }
-    exports: { type: array, items: { type: object, additionalProperties: false, properties: { export: { $ref: '#/$defs/id' }, status: { enum: [ queued, running, ready, failed ] }, created: { type: string, format: date-time }, expires: { type: string, format: date-time }, page: { type: string, pattern: '^\\/exports\\/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$' } }, required: [ export, status, created ] } }
-  required: [ reflected ]
-house-member:
-  description: One User who shares a Room with this User, with their current display name and accepted about-me Markdown. Their email, the Rooms they share and each one's access are in the \`roster\` of each \`house-room\` document.
-  properties:
-    reflected: { type: string, format: date-time }
-    user: { $ref: '#/$defs/id' }
-    name: { type: string }
-    about_me: { type: string }
-  required: [ reflected, user, name ]
-house-notification:
-  description: "One kept Human Notification for this User: its kind, when it was sent as \`created\`, its way in, its email's subject and each fact of its value that is not sealed, named in snake_case. An entity a fact names is an object holding its identifier under the key of its kind, when the notification carries it, and its \`name\`, \`email\` and other facts beside it; a fact holding null is absent. \`way_in\` is either the House \`path\` it opens or the entity it is about, by its identifier under the key of its kind, a Trigger with its \`room\`. Its body is its email's words in Markdown. Both were worded once, in the User's language when it was delivered; an App may show them or word it itself from its kind and value. Read state belongs to each browser."
-  properties:
-    notification: { $ref: '#/$defs/id' }
-    kind: { type: string, enum: [ share-offer, join-request, join-request-approved, app-room-binding-incompatible, app-deleted, app-call, room-ownership-offer, managed-environment-retention-opened, managed-environment-placement-intervention, storage-full, sandbox-budget-spent, break-glass-owner-disclosure, routine-start-approval-request, routine-request-declined, routine-request-started, routine-request-finished, routine-request-not-started, export-ready, export-failed, site-disabled, site-binding-incompatible, site-room-left, site-images-full, custom, trigger-did-nothing ] }
-    created: { type: string, format: date-time }
-    way_in: { type: object, additionalProperties: false, properties: { path: { type: string, pattern: ^\\/ }, room: { $ref: '#/$defs/room' }, app: { $ref: '#/$defs/app' }, agent: { $ref: '#/$defs/id' }, environment: { $ref: '#/$defs/id' }, routine: { $ref: '#/$defs/id' }, routine_request: { $ref: '#/$defs/id' }, trigger: { $ref: '#/$defs/id' }, site: { $ref: '#/$defs/id' } }, minProperties: 1 }
-    subject: { type: string }
-    share: { $ref: '#/$defs/id' }
-    issuer: { type: object, additionalProperties: false, properties: { name: { type: string }, email: { type: string, format: email } }, required: [ name, email ] }
-    rooms: { type: array, items: { type: object, additionalProperties: false, properties: { name: { type: string } }, required: [ name ] } }
-    apps: { maxItems: 20, type: array, items: { type: object, additionalProperties: false, properties: { name: { type: string, minLength: 1, maxLength: 200 }, reaches: { type: array, items: { type: string, minLength: 1, maxLength: 512 } } }, required: [ name, reaches ] } }
-    expires_at: { type: string, format: date-time }
-    join_request: { $ref: '#/$defs/id' }
-    user: { type: object, additionalProperties: false, properties: { name: { type: string }, email: { type: string, format: email } }, required: [ name, email ] }
-    room: { type: object, additionalProperties: false, properties: { room: { $ref: '#/$defs/room' }, name: { type: string } }, minProperties: 1 }
-    app: { type: object, additionalProperties: false, properties: { app: { $ref: '#/$defs/app' }, name: { type: string } }, minProperties: 1 }
-    binding: { $ref: '#/$defs/id' }
-    slot: { type: string }
-    findings: { type: array, items: { type: string } }
-    owner: { type: object, additionalProperties: false, properties: { name: { type: string } }, required: [ name ] }
-    caller: { type: object, additionalProperties: false, properties: { user: { $ref: '#/$defs/id' }, name: { type: string } }, required: [ user, name ] }
-    ownership_offer: { $ref: '#/$defs/id' }
-    offerer: { type: object, additionalProperties: false, properties: { name: { type: string }, email: { type: string, format: email } }, required: [ name, email ] }
-    environment: { type: object, additionalProperties: false, properties: { environment: { $ref: '#/$defs/id' }, name: { type: string }, kind: { enum: [ vps, sandbox ] } }, required: [ environment, name ] }
-    reason: { type: string }
-    deadline: { type: string, format: date-time }
-    operation_kind: { type: string }
-    free: { type: object, additionalProperties: false, properties: { held: { type: string, pattern: ^\\d+$ }, limit: { type: string, pattern: '^[1-9]\\d*$' }, measure: { type: string, enum: [ content, retained ] } }, required: [ held, limit, measure ] }
-    budget: { type: string, pattern: ^\\d+(?:\\.\\d+)?$ }
-    resets_at: { type: string, format: date-time }
-    grant: { $ref: '#/$defs/id' }
-    category: { type: string }
-    access_started_at: { type: string, format: date-time }
-    access_ended_at: { type: string, format: date-time }
-    systems: { type: array, items: { type: string } }
-    case_reference: { type: string }
-    routine_request: { $ref: '#/$defs/id' }
-    requester: { type: object, additionalProperties: false, properties: { name: { type: string } }, required: [ name ] }
-    agent: { type: object, additionalProperties: false, properties: { agent: { $ref: '#/$defs/id' }, name: { type: string } }, required: [ name ] }
-    conversation: { $ref: '#/$defs/id' }
-    routine: { type: object, additionalProperties: false, properties: { routine: { $ref: '#/$defs/id' }, name: { type: string }, version: { type: integer, minimum: 1 } }, required: [ name ] }
-    decliner: { type: object, additionalProperties: false, properties: { name: { type: string } }, required: [ name ] }
-    input: { type: string }
-    export: { $ref: '#/$defs/id' }
-    size_bytes: { type: integer, minimum: 0 }
-    site: { type: object, additionalProperties: false, properties: { site: { $ref: '#/$defs/id' }, name: { type: string } }, required: [ site, name ] }
-    address: { type: string, maxLength: 300, format: uri }
-    to: { type: object, additionalProperties: false, properties: { name: { type: string } }, required: [ name ] }
-    copies: { type: integer, minimum: 0 }
-    bound: { type: integer, minimum: 0 }
-    title: { type: string }
-    body: { type: string }
-    authorship: { type: object, additionalProperties: false, properties: { kind: { type: string, const: trigger-action }, trigger: { $ref: '#/$defs/id' }, position: { type: integer, minimum: 0 } }, required: [ kind, trigger, position ] }
-    path: { type: string, maxLength: 4096, pattern: ^\\/.* }
-    trigger: { type: object, additionalProperties: false, properties: { trigger: { $ref: '#/$defs/id' }, name: { type: string } }, required: [ trigger, name ] }
-    cause: { type: string }
-  required: [ notification, kind, created, way_in, subject ]
-house-ownership-offer:
-  description: One open Room ownership offer addressed to this User. The Room's name and the name of the owner it is \`from\` are captured when the offer is made. The page is the House approval path where this User accepts or declines.
-  properties:
-    reflected: { type: string, format: date-time }
-    ownership_offer: { $ref: '#/$defs/id' }
-    room: { type: object, additionalProperties: false, properties: { room: { $ref: '#/$defs/room' }, name: { type: string } }, required: [ room, name ] }
-    from: { type: object, additionalProperties: false, properties: { name: { type: string } }, required: [ name ] }
-    page: { type: string, pattern: '^\\/approve\\/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$' }
-    created: { type: string, format: date-time }
-    expires: { type: string, format: date-time }
-  required: [ reflected, ownership_offer, room, from, page, created, expires ]
-house-panel-preferences:
-  description: The panel's preferences at /rooms/private/settings/panel.md. Its own vocabulary is in the body.
-  properties: {}
-house-profile:
-  description: The User's display name, the email they sign in with and accepted about-me Markdown.
-  properties:
-    reflected: { type: string, format: date-time }
-    name: { type: string }
-    email: { type: string }
-    about_me: { type: string }
-  required: [ reflected, name, email ]
-house-public-room:
-  description: One Public Room this User added and reads without being its member. Its members are read with \`list_members\`, and \`leave_room\` removes it.
-  properties:
-    reflected: { type: string, format: date-time }
-    room: { $ref: '#/$defs/room' }
-    handle: { type: string, minLength: 6, maxLength: 63, pattern: '^[a-z0-9]+(?:-[a-z0-9]+)*$' }
-    name: { type: string }
-    archived: { type: string, format: date-time }
-  required: [ reflected, room, handle, name ]
-house-push-address:
-  description: "One push address this User minted, never its secret: the Room it captures into, the Source it names, and where an outside service's post carries its event's identifier, the header \`event_header\` or the JSON pointer \`event_json\`."
-  properties:
-    reflected: { type: string, format: date-time }
-    push_address: { $ref: '#/$defs/id' }
-    room: { $ref: '#/$defs/room' }
-    source: { type: string }
-    event_header: { type: string }
-    event_json: { type: string }
-  required: [ reflected, push_address, room, source ]
-house-requests:
-  description: "The Routine Requests of one Room this User holds at the Keep level: each one waiting or started under \`current\` and the 50 that changed last under \`history\`. Each names its \`routine\` by \`name\` and \`version\`, the \`target\` User whose Agent it asks, the \`agent\` that took it, the \`routine_access\` and \`record\` it went through, the Users it was \`approved_by\` and \`settled_by\`, and when it was \`created\`, \`approved\`, \`activated\` and \`settled\`; a started one is \`undelivered\` while its Agent's computer has not taken it, which House hands it once that computer connects; a fact it does not hold is absent. Only the Agent’s owner sees a request’s conversation. A Room with no request has no such document."
-  properties:
-    reflected: { type: string, format: date-time }
-    room: { $ref: '#/$defs/room' }
-    current: { type: array, items: { $ref: '#/$defs/request' } }
-    history: { type: array, items: { $ref: '#/$defs/request' } }
-  required: [ reflected, room, current, history ]
-house-room:
-  description: "One Room this User reads, with the processing configuration that indexes it. \`my_room\` is \`true\` on this User's My Room alone, whatever its name and handle become. \`admission\` is \`pending\` while House is still settling this User into the Room, which finishes on its own and needs no act. \`access\` is this User's access word in the Room, \`owner\`, \`manage\`, \`edit\`, \`keep\`, \`open\` or \`search\`, with \`only_while_online\` on a \`manage\` or \`edit\` held at the Open level; \`level\` is the access level they hold on its content, \`search\`, \`open\` or \`keep\`, and \`operations\` are their own on its content. \`policy\` is whether House indexes the Room's documents, \`Off\` while it withholds indexing. Each indexing entry names a folder \`path\` and the \`policy\` set on it. \`shared_schema\` names the Shared schema whose copy is the Room's schema while the Room uses one, with its \`name\`. The owner alone sees \`ownership_offer\`, the \`nominee\` it is offered to and when it \`expires\`, while an offer is open, and \`public\`, the time they made the Room public, while every House User may read it; a member who does not own it sees its \`owner\` by name. \`roster\` lists the Room's members, each with when they were \`admitted\`, their member \`document\` and the access level and operations a Room Share could offer them without giving them anything new as \`held\`; it and \`rights\` carry the access this User may see, every member's to one who manages the Room and their own otherwise; \`routines\` lists the Routine Accesses this User or the Room's Triggers may call in it, each with its \`routine\`, by \`name\`, \`description\`, \`input\` and \`version\`, its \`agent\` and that Agent's \`owner\` by name: \`starts_without_approval\` on one this User may call and \`triggers: true\` on one the Triggers may call."
-  properties:
-    reflected: { type: string, format: date-time }
-    room: { $ref: '#/$defs/room' }
-    handle: { type: string, minLength: 6, maxLength: 63, pattern: '^[a-z0-9]+(?:-[a-z0-9]+)*$' }
-    name: { type: string }
-    my_room: { const: true }
-    membership: { enum: [ owner, member ] }
-    ownership_offer: { type: object, additionalProperties: false, properties: { nominee: { type: object, additionalProperties: false, properties: { user: { $ref: '#/$defs/id' }, name: { type: string } }, required: [ user, name ] }, expires: { type: string, format: date-time } }, required: [ nominee, expires ] }
-    access: { enum: [ owner, manage, edit, keep, open, search ] }
-    level: { enum: [ search, open, keep ] }
-    only_while_online: { const: true }
-    operations: { type: array, items: { type: string, enum: [ write, delete, export, manageAccess ] } }
-    owner: { type: object, additionalProperties: false, properties: { name: { type: string } }, required: [ name ] }
-    members: { type: integer, minimum: 0 }
-    triggers: { type: integer, minimum: 0 }
-    published: { enum: [ yes, no ] }
-    intake: { enum: [ yes, no ] }
-    size: { type: number }
-    admission: { enum: [ admitted, pending ] }
-    created: { type: string, format: date-time }
-    archived: { type: string, format: date-time }
-    public: { type: string, format: date-time }
-    policy: { enum: [ On, Off ] }
-    indexing: { type: array, items: { type: object, additionalProperties: false, properties: { path: { type: string, minLength: 1 }, policy: { enum: [ On, Off ] } }, required: [ path, policy ] } }
-    shared_schema: { type: object, additionalProperties: false, properties: { shared_schema: { $ref: '#/$defs/id' }, name: { type: string } }, required: [ shared_schema, name ] }
-    roster: { type: array, items: { type: object, additionalProperties: false, properties: { user: { $ref: '#/$defs/id' }, name: { type: string }, owner: { type: boolean }, email: { type: string }, admitted: { type: string, format: date-time }, access: { type: string, enum: [ owner, manage, edit, keep, open, search ] }, only_while_online: { const: true }, document: { $ref: '#/$defs/document' }, schema_roles: { type: array, items: { type: string } }, held: { type: object, additionalProperties: false, properties: { level: { anyOf: [ { type: string, enum: [ search, open, keep ] }, { type: 'null' } ] }, operations: { type: array, items: { type: string, enum: [ write, delete, export, manageAccess ] } } }, required: [ level, operations ] } }, required: [ user, name, owner, email ] } }
-    rights: { type: array, items: { type: object, additionalProperties: false, properties: { user: { $ref: '#/$defs/id' }, name: { type: string }, entries: { type: array, items: { type: object, additionalProperties: false, properties: { namespace: { $ref: '#/$defs/namespace' }, level: { anyOf: [ { type: string, enum: [ search, open, keep ] }, { type: 'null' } ] }, operations: { type: array, items: { type: string, enum: [ write, delete, export, manageAccess ] } }, sources: { type: array, items: { type: object, additionalProperties: false, properties: { kind: { type: string, enum: [ direct, inherited ] }, namespace: { $ref: '#/$defs/namespace' }, level: { anyOf: [ { type: string, enum: [ search, open, keep ] }, { type: 'null' } ] }, operations: { type: array, items: { type: string, enum: [ write, delete, export, manageAccess ] } } }, required: [ kind, namespace, level, operations ] } } }, required: [ namespace, level, operations, sources ] } }, direct: { type: array, items: { type: object, additionalProperties: false, properties: { namespace: { $ref: '#/$defs/namespace' }, level: { anyOf: [ { type: string, enum: [ search, open, keep ] }, { type: 'null' } ] }, operations: { type: array, items: { type: string, enum: [ write, delete, export, manageAccess ] } } }, required: [ namespace, level, operations ] } }, admitted: { type: string, format: date-time }, schema_roles: { type: array, items: { type: string } } }, required: [ user, name, entries, direct, schema_roles ] } }
-    routines: { type: array, items: { type: object, additionalProperties: false, properties: { routine_access: { $ref: '#/$defs/id' }, agent: { $ref: '#/$defs/id' }, owner: { type: object, additionalProperties: false, properties: { name: { type: string } }, required: [ name ] }, routine: { type: object, additionalProperties: false, properties: { name: { type: string }, description: { type: string }, input: { type: string }, version: { type: integer, exclusiveMinimum: 0 } }, required: [ name, description, input, version ] }, starts_without_approval: { type: boolean }, triggers: { type: boolean, const: true } }, required: [ routine_access, agent, owner, routine ] } }
-  required: [ reflected, room, name, membership, access, admission, created, policy ]
-house-routine-access:
-  description: "One Routine Access this User granted, its \`routine\` by identifier and \`name\`, the \`agent\` it calls, its \`room\` and when it was \`created\`. While a scope is \`selected_users\`, each invokers or starters entry names one \`user\` by identifier with their account \`email\` and display \`name\` as of the last write of this document, or by identifier alone once that User has left the Room. An entry naming the Access's \`room\` admits the Room's Triggers as a caller, or lets them start without approval, whatever the scope. \`allowance\` is the daily request allowance every caller is under, absent when open, \`0\` excluding them. Each allowances entry names a caller under a value of their own instead: the \`user\` or the \`room\` and their \`allowance\`, or the caller alone when they have none. While \`follow_up_scope\` is \`selected_users\`, each follow_ups entry names one User who may send follow-up mail to the conversations their requests started, as invokers entries name them; \`all_admitted\` lets every User caller send it, and the Agent's owner always may. \`mail_allowance\` is the daily follow-up mail allowance every User caller is under, and each mail_allowances entry names a \`user\` under an \`allowance\` of their own. \`last_failure\` is the latest withdrawn request, whatever starts after it: its \`origin\`, \`user\` or \`trigger\`, its time \`at\` and its \`reason\`."
-  properties:
-    reflected: { type: string, format: date-time }
-    routine_access: { $ref: '#/$defs/id' }
-    routine: { type: object, additionalProperties: false, properties: { routine: { $ref: '#/$defs/id' }, name: { type: string } }, required: [ routine, name ] }
-    agent: { $ref: '#/$defs/id' }
-    room: { $ref: '#/$defs/room' }
-    invoker_scope: { type: string, enum: [ all_members, selected_users ] }
-    start_scope: { type: string, enum: [ none, all_admitted, selected_users ] }
-    follow_up_scope: { type: string, enum: [ none, all_admitted, selected_users ] }
-    created: { type: string, format: date-time }
-    revoked: { type: string, format: date-time }
-    invokers: { type: array, items: { $ref: '#/$defs/caller' } }
-    starters: { type: array, items: { $ref: '#/$defs/caller' } }
-    follow_ups: { type: array, items: { type: object, additionalProperties: false, properties: { user: { $ref: '#/$defs/id' }, email: { type: string }, name: { type: string } }, required: [ user ] } }
-    allowance: { type: integer, minimum: 0 }
-    allowances: { type: array, items: { type: object, additionalProperties: false, properties: { user: { $ref: '#/$defs/id' }, room: { $ref: '#/$defs/room' }, allowance: { type: integer, minimum: 0 } }, minProperties: 1 } }
-    mail_allowance: { type: integer, minimum: 0 }
-    mail_allowances: { type: array, items: { type: object, additionalProperties: false, properties: { user: { $ref: '#/$defs/id' }, allowance: { type: integer, minimum: 0 } }, required: [ user, allowance ] } }
-    last_failure: { type: object, additionalProperties: false, properties: { origin: { enum: [ user, trigger ] }, at: { type: string, format: date-time }, reason: { type: string } }, required: [ origin, at, reason ] }
-  required: [ reflected, routine_access, routine, agent, room, invoker_scope, start_scope, follow_up_scope, created ]
-house-service-key:
-  description: "One Service key a Room this User owns or manages holds, never the key itself: its \`room\`, its \`name\`, the one \`origin\` House sends it to, the \`form\` it is sent in, its \`kind\` with the header or query parameter \`name\` or the path \`prefix\`, and the address of its origin's icon once House kept one."
-  properties:
-    reflected: { type: string, format: date-time }
-    service_key: { $ref: '#/$defs/id' }
-    room: { $ref: '#/$defs/room' }
-    name: { type: string }
-    origin: { type: string, format: uri }
-    form: { type: object, additionalProperties: false, properties: { kind: { enum: [ bearer, header, query, basic, path ] }, name: { type: string }, prefix: { type: string } }, required: [ kind ] }
-    icon: { type: string, pattern: '^\\/service-keys\\/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\\/icon$' }
-  required: [ reflected, service_key, room, name, origin, form ]
-house-share:
-  description: "One Share this User issued, kept until it expires or is cancelled. An email delivery carries \`share_to\`, the address this User entered; a link delivery never carries the link. Each item names its \`kind\`, \`room\` or \`app\`, the Room or App under that key with its \`name\`, its \`state\`, \`offerable\`, \`held\`, \`accepted\`, \`declined\` or \`superseded\`, for a Room item the \`level\` it grants, the \`operations\` it grants as this User chose them and the Schema Roles its member gets as \`roles\` when it names any, and for an App item the external \`origins\` its latest release declared when this document was written, when it declared any. An App item is never shown \`held\`. Each pack entry names an App item's \`app\`, one of its \`slot\`s, and the \`room\` of the Room item that fills it, with that Room's \`name\`. Each \`join_requests\` entry of a link delivery names one Join request, its \`state\`, \`waiting\`, \`approved\` or \`declined\`, and the User it is \`from\` by account \`email\` and display \`name\` as House held them when this document was written, oldest first; the House approval path of a Join request is \`/approve/\` followed by its identifier."
-  properties:
-    reflected: { type: string, format: date-time }
-    share: { $ref: '#/$defs/id' }
-    share_link: { enum: [ yes, no ] }
-    share_to: { type: string, format: email }
-    items: { type: array, items: { type: object, additionalProperties: false, properties: { kind: { enum: [ room, app ] }, name: { type: string }, state: { enum: [ offerable, held, accepted, declined, superseded ] }, level: { enum: [ search, open, keep ] }, operations: { type: array, items: { type: string, enum: [ write, delete, export, manageAccess ] } }, roles: { type: array, items: { type: string } }, origins: { type: array, items: { type: string, format: uri } }, room: { $ref: '#/$defs/room' }, app: { $ref: '#/$defs/app' } }, required: [ kind, name, state, operations ] } }
-    pack: { type: array, items: { type: object, additionalProperties: false, properties: { app: { $ref: '#/$defs/app' }, slot: { type: string, pattern: '^[a-z0-9]([a-z0-9-]*[a-z0-9])?$' }, room: { type: object, additionalProperties: false, properties: { room: { $ref: '#/$defs/room' }, name: { type: string } }, required: [ room, name ] } }, required: [ app, slot, room ] } }
-    join_requests: { type: array, items: { type: object, additionalProperties: false, properties: { join_request: { $ref: '#/$defs/id' }, state: { enum: [ waiting, approved, declined ] }, from: { type: object, additionalProperties: false, properties: { email: { type: string }, name: { type: string } }, required: [ email, name ] } }, required: [ join_request, state, from ] } }
-    created: { type: string, format: date-time }
-    expires: { type: string, format: date-time }
-  required: [ reflected, share, share_link, created, expires ]
-house-share-offer:
-  description: "One live Share offered to this User by email while an item of it is still offered, \`from\` its issuer by display \`name\` and account \`email\`. Each item names its \`kind\`, \`room\` or \`app\`, its \`name\`, its \`state\` for this User, \`offerable\`, \`held\`, \`accepted\`, \`declined\` or \`superseded\`, for a Room item the \`level\` it grants and the \`operations\` it grants; it carries no reference. A Room item's access level and operations are the ones its issuer chose for the Room's content; its holder reads the Room's settings at that level, and holds \`manageAccess\` over its document model when it names \`manageAccess\`. A Room item naming Schema Roles names them as \`roles\`, which accepting the Share adds to this User's own in that Room. An App item grants use of the App and never its source, is never shown \`held\`, and names as \`origins\` the external origins its latest release declared when this document was written, when it declared any, which accepting the Share lets its code reach. Each pack entry names an offered \`app\`, one of its \`slot\`s, and the offered \`room\` that fills it, each by \`name\`. Names are as House held them when this document was written. The page is the House approval path where this User accepts or declines the whole Share."
-  properties:
-    reflected: { type: string, format: date-time }
-    share: { $ref: '#/$defs/id' }
-    from: { type: object, additionalProperties: false, properties: { name: { type: string }, email: { type: string, format: email } }, required: [ name, email ] }
-    page: { type: string, pattern: '^\\/approve\\/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$' }
-    items: { type: array, items: { type: object, additionalProperties: false, properties: { kind: { enum: [ room, app ] }, name: { type: string }, state: { enum: [ offerable, held, accepted, declined, superseded ] }, level: { enum: [ search, open, keep ] }, operations: { type: array, items: { type: string, enum: [ write, delete, export, manageAccess ] } }, roles: { type: array, items: { type: string } }, origins: { type: array, items: { type: string, format: uri } } }, required: [ kind, name, state, operations ] } }
-    pack: { type: array, items: { type: object, additionalProperties: false, properties: { app: { type: object, additionalProperties: false, properties: { name: { type: string } }, required: [ name ] }, slot: { type: string, pattern: '^[a-z0-9]([a-z0-9-]*[a-z0-9])?$' }, room: { type: object, additionalProperties: false, properties: { name: { type: string } }, required: [ name ] } }, required: [ app, slot, room ] } }
-    created: { type: string, format: date-time }
-    expires: { type: string, format: date-time }
-  required: [ reflected, share, from, page, created, expires ]
-house-site:
-  description: "One Site this User owns: its \`name\`, its address under this environment's Site suffix, its own \`app\` with that App's tab icon as a Site shows it, the running \`release\` of that App, which the Site serves, by \`release\` and \`sequence\`, its title and \`intake_room\`, the Intake Room by its \`room\`, whether an operator disabled it, its mode, and every Room slot of that release in its order. Each slot names its \`slot\` and as \`entries\` each Room its list holds, in list order, by its \`room\`, with that entry's address \`segment\` and the last \`compatibility\` outcome of that entry; a slot that lists no Room has no entry. Each finding names its \`slot\`, its \`room\` and one exact structural \`finding\` of that Room against the slot. An incompatible entry stays listed and blocks nothing. \`release\` is absent until that App's first release. \`disabled\` is \`yes\` while an operator holds the Site disabled, and \`disabled_reason\` carries the reason the operator stated; visitors then find the Site unavailable, this User may still change or delete it, and only an operator enables it again. \`mode\` is \`snapshot\` while visitors see the Published Snapshot \`publication\` names, or \`live\` while they see what its Rooms hold as it changes, which needs Full House; only this User changes it. \`unpublished\` is \`yes\` while this User holds the Site unpublished: visitors then find it unavailable at every address and nothing else changes, and only this User's republication serves it again; an operator's enable never does. \`suspended\` is \`yes\` while visitors find the Site unavailable at every address for the reason \`suspended_reason\` names: \`full_house_required\` while the Site is \`live\` and this User lacks Full House, or \`public_delivery_limit\` while what House's server sent for this User's Sites this UTC month has reached this User's Public delivery limit, unless \`public_overage\` is \`on\` while this User holds Full House. A suspension keeps the publication, the addresses, the Custom domains and every act of this User's, and ends by itself at the next UTC month, when this User gains Full House or when \`public_overage\` turns \`on\` while this User holds Full House; it lifts no Unpublish and no operator's disable. \`public_overage\` is \`on\` while this User keeps the Site serving past the Public delivery limit, which it does only while this User holds Full House; what it sends past the limit is charged as overage. It stays \`on\` when Full House ends and acts again when Full House returns. \`publication\` is the Published Snapshot the Site serves, or serves once republished, absent while it holds none. \`acts\` names the publication acts this User may take now: \`unpublish\` while the Site is published, \`republish\` while it is unpublished and holds a publication to serve; Publish data also serves an unpublished Site again, with what its Rooms hold. A cleared title is absent. \`description\` carries presentation. \`screenshot\` is the address of the image House captured of the Site at its primary address after a release, which a shared link to the Site shows, absent before the first capture. \`analytics\` is the owner's measurement ID the Site loads its analytics tag with, absent while unset. \`indexing\` is the search-engines-and-agents switch: while it is \`yes\`, the Site serves its documents as Markdown and lists them in its indexes. \`entry_fallback\` names the last time this release's Entry Data Contract could not serve an Entry Page as HTML: its \`cause\` (\`over_bound\`, \`query_refused\` or \`unavailable\`), the \`route\` and when it was \`recorded\`; that page then started the App as usual. \`external_origins\` names the declared external origins of that release. \`notify_me\` is \`on\` while the Site's notification Trigger is present and enabled in its Intake Room. \`addresses\` lists every address the Site answers at: its address under the Site suffix and each active Custom domain; every address other than \`primary_address\` redirects to it. Each \`domains\` entry names one Custom domain's \`host\`, its \`state\`, \`pending\`, \`active\` or \`failed\`, the DNS alias target its hostname must point at as \`dns_target\`, which is this environment's and the same for every domain, and the edge's \`reason\` when it gives one."
-  properties:
-    reflected: { type: string, format: date-time }
-    site: { $ref: '#/$defs/id' }
-    name: { type: string }
-    address: { type: string, format: uri }
-    addresses: { type: array, items: { type: string, format: uri } }
-    primary_address: { type: string, format: uri }
-    domains: { type: array, items: { type: object, additionalProperties: false, properties: { host: { type: string }, state: { enum: [ pending, active, failed ] }, dns_target: { type: string }, reason: { type: string } }, required: [ host, state, dns_target ] } }
-    app: { $ref: '#/$defs/app' }
-    tab_icon_light: { type: string, pattern: ^data:image\\/ }
-    tab_icon_dark: { type: string, pattern: ^data:image\\/ }
-    tab_icon_colours: { type: array, items: { type: string, pattern: '^#[0-9a-f]{6}$' } }
-    tab_icon_blend: { enum: [ linear, radial ] }
-    tab_icon_angle: { type: integer, minimum: 0, maximum: 359 }
-    release: { type: object, additionalProperties: false, properties: { release: { $ref: '#/$defs/id' }, sequence: { type: integer, exclusiveMinimum: 0 } }, required: [ release, sequence ] }
-    title: { type: string }
-    description: { type: string }
-    screenshot: { type: string, format: uri }
-    analytics: { type: string, pattern: '^G-[A-Z0-9]{1,32}$' }
-    intake_room: { type: object, additionalProperties: false, properties: { room: { $ref: '#/$defs/room' } }, required: [ room ] }
-    external_origins: { type: array, items: { type: string, format: uri } }
-    disabled: { enum: [ yes, no ] }
-    disabled_reason: { type: string }
-    mode: { enum: [ snapshot, live ] }
-    unpublished: { enum: [ yes, no ] }
-    suspended: { enum: [ yes, no ] }
-    suspended_reason: { type: string, enum: [ full_house_required, public_delivery_limit ] }
-    public_overage: { enum: [ on, off ] }
-    publication: { $ref: '#/$defs/id' }
-    acts: { type: array, items: { type: string, enum: [ unpublish, republish ] } }
-    indexing: { enum: [ yes, no ] }
-    entry_fallback: { type: object, additionalProperties: false, properties: { cause: { enum: [ over_bound, query_refused, unavailable ] }, route: { type: string }, recorded: { type: string, format: date-time } }, required: [ cause, route, recorded ] }
-    created: { type: string, format: date-time }
-    new_browsers: { type: integer, minimum: 0 }
-    submissions: { type: integer, minimum: 0 }
-    notify_me: { enum: [ on, off ] }
-    image_copies: { type: integer, minimum: 0 }
-    image_copy_bound: { type: integer, minimum: 0 }
-    image_copy_limit_reached: { enum: [ yes, no ] }
-    slots: { type: array, items: { type: object, additionalProperties: false, properties: { slot: { type: string, pattern: '^[a-z0-9]([a-z0-9-]*[a-z0-9])?$' }, entries: { type: array, items: { type: object, additionalProperties: false, properties: { room: { $ref: '#/$defs/room' }, segment: { type: string }, compatibility: { enum: [ unchecked, compatible, incompatible ] } }, required: [ room, segment, compatibility ] } } }, required: [ slot, entries ] } }
-    findings: { type: array, items: { type: object, additionalProperties: false, properties: { slot: { type: string, pattern: '^[a-z0-9]([a-z0-9-]*[a-z0-9])?$' }, room: { $ref: '#/$defs/room' }, finding: { type: string } }, required: [ slot, room, finding ] } }
-  required: [ reflected, site, name, address, primary_address, app, disabled, mode, unpublished, suspended, public_overage, indexing, created, new_browsers, submissions, notify_me, image_copies, image_copy_bound, image_copy_limit_reached ]
-house-trigger:
-  description: "One Trigger of this Room as its acts wrote it, which House alone writes: its \`description\`, the \`condition\` it fires on, its \`actions\` in order, whether each action and the Trigger are \`enabled\`, \`paused_by\` \`types\` while a change of the Room's types paused it, its \`creator\` by \`user\` and the \`name\` they had then, and when it was \`created\`. A \`notify\` action reaches the \`users\` its \`to\` names, the members its \`fields\` name in the matched document and the holders of its \`roles\`; a \`routine\` action sends its \`payload\` through its \`routine_access\`; a \`function\` action runs the \`function\` its \`app\`'s latest release declares, on House's servers. Whether an action's target holds is not written: it follows from the Room's members, the Routine Access and the App's latest release."
-  properties:
-    reflected: { type: string, format: date-time }
-    trigger: { $ref: '#/$defs/id' }
-    description: { type: string }
-    condition:
-      anyOf:
-        - { type: object, additionalProperties: false, properties: { on: { const: documents }, scope: { $ref: '#/$defs/trigger_scope' }, mode: { const: starts_matching }, new_documents: { type: boolean }, match: { $ref: '#/$defs/trigger_test' }, by: { $ref: '#/$defs/trigger_test' }, moved_between_rooms: { type: boolean } }, required: [ on, scope, mode, new_documents, match ] }
-        - { type: object, additionalProperties: false, properties: { on: { const: documents }, scope: { $ref: '#/$defs/trigger_scope' }, mode: { const: field_changes }, field: { type: string }, from: { anyOf: [ { $ref: '#/$defs/trigger_values' }, { const: new } ] }, to: { anyOf: [ { $ref: '#/$defs/trigger_values' }, { const: deleted } ] }, match: { $ref: '#/$defs/trigger_test' }, by: { $ref: '#/$defs/trigger_test' }, moved_between_rooms: { type: boolean } }, required: [ on, scope, mode, field ] }
-        - { type: object, additionalProperties: false, properties: { on: { const: items }, source: { type: string }, address: { type: string }, match: { $ref: '#/$defs/trigger_test' } }, required: [ on ] }
-        - { type: object, additionalProperties: false, properties: { on: { const: clock }, cron: { type: string }, time_zone: { type: string } }, required: [ on, cron, time_zone ] }
-        - { type: object, additionalProperties: false, properties: { on: { const: clock }, scope: { type: object, additionalProperties: false, properties: { type: { type: string } }, required: [ type ] }, date: { type: string }, days: { type: integer }, at: { type: string }, time_zone: { type: string }, match: { $ref: '#/$defs/trigger_test' } }, required: [ on, scope, date, days, at, time_zone ] }
-    actions:
-      type: array
-      items:
-        anyOf:
-          - { type: object, additionalProperties: false, properties: { kind: { const: notify }, enabled: { type: boolean }, title: { type: string }, text: { type: string }, to: { type: object, additionalProperties: false, properties: { users: { type: array, items: { type: object, additionalProperties: false, properties: { user: { $ref: '#/$defs/id' } }, required: [ user ] } }, fields: { type: array, items: { type: string } }, roles: { type: array, items: { type: string } } }, required: [ users, fields, roles ] } }, required: [ kind, enabled, title, text, to ] }
-          - { type: object, additionalProperties: false, properties: { kind: { const: routine }, enabled: { type: boolean }, routine_access: { $ref: '#/$defs/id' }, payload: { type: string } }, required: [ kind, enabled, payload ] }
-          - { type: object, additionalProperties: false, properties: { kind: { const: function }, enabled: { type: boolean }, app: { $ref: '#/$defs/app' }, function: { type: string } }, required: [ kind, enabled, app, function ] }
-    enabled: { type: boolean }
-    paused_by: { enum: [ types ] }
-    creator: { type: object, additionalProperties: false, properties: { user: { $ref: '#/$defs/id' }, name: { type: string } }, required: [ user, name ] }
-    created: { type: string, format: date-time }
-  required: [ reflected, trigger, description, condition, actions, enabled, creator, created ]
-house-web-wizard:
-  description: "One Web Wizard an agent made for this User: the \`environment\` it runs on, with that Environment's \`name\`, and its \`state\`, \`waiting\` until its owner presses Run, \`running\`, \`finished\` with the script's \`exit_code\`, \`failed\`, \`cancelled\` when its page closed before the script ended, or \`lapsed\` when nobody ran it in its time. Its body is the script, whole, in one fenced code block. The terminal's output is never kept."
-  properties:
-    reflected: { type: string, format: date-time }
-    web_wizard: { $ref: '#/$defs/id' }
-    environment: { type: object, additionalProperties: false, properties: { environment: { $ref: '#/$defs/id' }, name: { type: string } }, required: [ environment, name ] }
-    state: { enum: [ waiting, running, finished, failed, cancelled, lapsed ] }
-    exit_code: { type: integer }
-  required: [ reflected, web_wizard, environment, state ]
-`;
+export const HOUSE_MODEL_DECLARATION = {
+    $defs: {
+        room: {
+            description: 'A Room, by its Room reference, under the key `room`.',
+            type: 'string',
+            pattern: '^r_([0123456789abcdefghjkmnpqrstvwxyz]+)\\.([0123456789abcdefghjkmnpqrstvwxyz])$',
+        },
+        app: {
+            description: 'An App, by its App reference, under the key `app`.',
+            type: 'string',
+            pattern: '^a_([0123456789abcdefghjkmnpqrstvwxyz]+)\\.([0123456789abcdefghjkmnpqrstvwxyz])$',
+        },
+        document: {
+            description: 'A document of a Room, by its file reference, under the key `document`.',
+            type: 'string',
+            pattern: '^af_([123456789abcdefghjkmnpqrstvwxyz][0123456789abcdefghjkmnpqrstvwxyz]*)\\.([0123456789abcdefghjkmnpqrstvwxyz])$',
+        },
+        id: {
+            description: 'Any other entity, by its identifier, under the key of its kind. An entity a type says more about is an object holding it under that key beside its facts.',
+            type: 'string',
+            format: 'uuid',
+        },
+        namespace: {
+            description: 'The Namespace a grant entry covers, an App or a Room by its reference with the area of it.',
+            type: 'string',
+            maxLength: 512,
+            pattern: '^(?:a_[A-Za-z0-9._-]+(?:\\/source)?|r_[A-Za-z0-9._-]+(?:\\/(?:settings|settings\\/schema|settings\\/model|settings\\/indexing|content))?)$',
+        },
+    },
+    'house-app-preferences': {
+        description: "An App's preferences. Its own vocabulary is in the body.",
+        properties: { app: { $ref: '#/$defs/app' } },
+        required: ['app'],
+    },
+    'house-notification': {
+        description: "One kept Notification for this User: its kind, when it was sent as `created`, its way in, its email's subject and each fact of its value that is not sealed, named in snake_case. An entity a fact names is an object holding its identifier under the key of its kind, when the notification carries it, and its `name`, `email` and other facts beside it; a fact holding null is absent. `way_in` is either the House `path` it opens or the entity it is about, by its identifier under the key of its kind, a Trigger with its `room`. Its body is its email's words in Markdown. Both were worded once, in the User's language when it was delivered; an App may show them or word it itself from its kind and value. Read state belongs to each browser.",
+        properties: {
+            notification: { $ref: '#/$defs/id' },
+            kind: {
+                type: 'string',
+                enum: [
+                    'share-offer',
+                    'join-request',
+                    'join-request-approved',
+                    'app-room-binding-incompatible',
+                    'app-call',
+                    'room-ownership-offer',
+                    'managed-environment-retention-opened',
+                    'managed-environment-placement-intervention',
+                    'storage-full',
+                    'sandbox-budget-spent',
+                    'break-glass-owner-disclosure',
+                    'agent-function-start-approval-request',
+                    'export-ready',
+                    'export-failed',
+                    'site-disabled',
+                    'site-binding-incompatible',
+                    'site-images-full',
+                    'custom',
+                ],
+            },
+            created: { type: 'string', format: 'date-time' },
+            way_in: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    path: { type: 'string', pattern: '^\\/' },
+                    room: { $ref: '#/$defs/room' },
+                    app: { $ref: '#/$defs/app' },
+                    environment: { $ref: '#/$defs/id' },
+                    trigger: { $ref: '#/$defs/id' },
+                    site: { $ref: '#/$defs/id' },
+                },
+                minProperties: 1,
+            },
+            subject: { type: 'string' },
+            share: { $ref: '#/$defs/id' },
+            issuer: {
+                type: 'object',
+                additionalProperties: false,
+                properties: { name: { type: 'string' }, email: { type: 'string', format: 'email' } },
+                required: ['name', 'email'],
+            },
+            rooms: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    additionalProperties: false,
+                    properties: { name: { type: 'string' } },
+                    required: ['name'],
+                },
+            },
+            apps: {
+                maxItems: 20,
+                type: 'array',
+                items: {
+                    type: 'object',
+                    additionalProperties: false,
+                    properties: {
+                        name: { type: 'string', minLength: 1, maxLength: 200 },
+                        reaches: { type: 'array', items: { type: 'string', minLength: 1, maxLength: 512 } },
+                    },
+                    required: ['name', 'reaches'],
+                },
+            },
+            expires_at: { type: 'string', format: 'date-time' },
+            join_request: { $ref: '#/$defs/id' },
+            user: {
+                type: 'object',
+                additionalProperties: false,
+                properties: { name: { type: 'string' }, email: { type: 'string', format: 'email' } },
+                required: ['name', 'email'],
+            },
+            room: {
+                type: 'object',
+                additionalProperties: false,
+                properties: { room: { $ref: '#/$defs/room' }, name: { type: 'string' } },
+                minProperties: 1,
+            },
+            app: {
+                type: 'object',
+                additionalProperties: false,
+                properties: { app: { $ref: '#/$defs/app' }, name: { type: 'string' } },
+                minProperties: 1,
+            },
+            release: { type: 'integer', minimum: 1 },
+            binding: { $ref: '#/$defs/id' },
+            slot: { type: 'string' },
+            findings: { type: 'array', items: { type: 'string' } },
+            caller: {
+                type: 'object',
+                additionalProperties: false,
+                properties: { user: { $ref: '#/$defs/id' }, name: { type: 'string' } },
+                required: ['user', 'name'],
+            },
+            ownership_offer: { $ref: '#/$defs/id' },
+            offerer: {
+                type: 'object',
+                additionalProperties: false,
+                properties: { name: { type: 'string' }, email: { type: 'string', format: 'email' } },
+                required: ['name', 'email'],
+            },
+            environment: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    environment: { $ref: '#/$defs/id' },
+                    name: { type: 'string' },
+                    kind: { enum: ['vps', 'sandbox'] },
+                },
+                required: ['environment', 'name'],
+            },
+            reason: { type: 'string' },
+            deadline: { type: 'string', format: 'date-time' },
+            operation_kind: { type: 'string' },
+            free: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    held: { type: 'string', pattern: '^\\d+$' },
+                    limit: { type: 'string', pattern: '^[1-9]\\d*$' },
+                    measure: { type: 'string', enum: ['content', 'retained'] },
+                },
+                required: ['held', 'limit', 'measure'],
+            },
+            budget: { type: 'string', pattern: '^\\d+(?:\\.\\d+)?$' },
+            resets_at: { type: 'string', format: 'date-time' },
+            grant: { $ref: '#/$defs/id' },
+            category: { type: 'string' },
+            access_started_at: { type: 'string', format: 'date-time' },
+            access_ended_at: { type: 'string', format: 'date-time' },
+            systems: { type: 'array', items: { type: 'string' } },
+            case_reference: { type: 'string' },
+            agent_function_request: { $ref: '#/$defs/id' },
+            requester: {
+                type: 'object',
+                additionalProperties: false,
+                properties: { name: { type: 'string' } },
+                required: ['name'],
+            },
+            agent: {
+                type: 'object',
+                additionalProperties: false,
+                properties: { agent: { $ref: '#/$defs/id' }, name: { type: 'string' } },
+                required: ['name'],
+            },
+            conversation: { $ref: '#/$defs/id' },
+            agent_function: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    name: { type: 'string' },
+                    version: { type: 'integer', minimum: 1 },
+                },
+                required: ['name'],
+            },
+            export: { $ref: '#/$defs/id' },
+            size_bytes: { type: 'integer', minimum: 0 },
+            site: {
+                type: 'object',
+                additionalProperties: false,
+                properties: { site: { $ref: '#/$defs/id' }, name: { type: 'string' } },
+                required: ['site', 'name'],
+            },
+            address: { type: 'string', maxLength: 300, format: 'uri' },
+            copies: { type: 'integer', minimum: 0 },
+            bound: { type: 'integer', minimum: 0 },
+            title: { type: 'string' },
+            body: { type: 'string' },
+            authorship: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    kind: { type: 'string', const: 'trigger-action' },
+                    trigger: { $ref: '#/$defs/id' },
+                    position: { type: 'integer', minimum: 0 },
+                },
+                required: ['kind', 'trigger', 'position'],
+            },
+            path: { type: 'string', maxLength: 4096, pattern: '^\\/.*' },
+        },
+        required: ['notification', 'kind', 'created', 'way_in', 'subject'],
+    },
+    'house-panel-preferences': {
+        description: "The panel's preferences at /rooms/private/settings/panel.md. Its own vocabulary is in the body.",
+        properties: {},
+    },
+    'house-agent-function': {
+        description: "One Agent function that serves this Room, which House alone writes from its owner's document in their Private Room: the `agent_function` by identifier, its `description`, the `input` a caller sends, empty when it takes nothing, and the `agent` it starts, by `agent` and the `name` that Agent had when this card was last written. The Agent function's instruction is never written here.",
+        properties: {
+            reflected: { type: 'string', format: 'date-time' },
+            agent_function: { $ref: '#/$defs/id' },
+            description: { type: 'string' },
+            input: { type: 'string' },
+            agent: {
+                type: 'object',
+                additionalProperties: false,
+                properties: { agent: { $ref: '#/$defs/id' }, name: { type: 'string' } },
+                required: ['agent', 'name'],
+            },
+        },
+        required: ['reflected', 'agent_function', 'description', 'input', 'agent'],
+    },
+    'house-agent-function-document': {
+        description: 'One Agent function as its owner writes it in their Private Room at rooms/<room-handle>/agent-functions/<name>.md, a path that binds this type and a document that names no type: what it does as `description`, what a caller sends as `input`, empty when it takes nothing, and the `agent` it starts, by identifier. Its body is the instruction that Agent follows.',
+        properties: {
+            description: { type: 'string', maxLength: 2000, pattern: '\\S' },
+            input: { type: 'string' },
+            agent: { $ref: '#/$defs/id' },
+        },
+        required: ['description', 'input', 'agent'],
+    },
+    'house-trigger': {
+        description: "One Trigger of this Room as its acts wrote it, which House alone writes: its `description`, the `condition` it fires on, its `actions` in order, whether each action and the Trigger are `enabled`, `paused_by` `types` while a change of the Room's types paused it, its `creator` by `user` and the `name` they had then, and when it was `created`. A `notify` action reaches the `users` its `to` names, the members its `fields` name in the matched document and the holders of its `roles`; an `agent_function` action sends its `payload` to the Agent function whose card under this Room's `house/agent-functions/` its `card` names, absent while this Room holds no card of that Agent function; a `message` action puts its `text` into the active conversation that Agent function started for what the Event is about, or starts that Agent function when none is active; a `done` action marks Done every active conversation an Agent function request of this Room started for the Event's document; a `function` action runs the `function` its `app`'s latest release declares, on House's servers, or, naming no `app`, the Room owner's Environment function of that name on its Environment, which only a Trigger of their Private Room holds. Whether an action's target holds is not written: it follows from the Room's members, the Agent function's card, the App's latest release and the owner's functions.",
+        properties: {
+            reflected: { type: 'string', format: 'date-time' },
+            trigger: { $ref: '#/$defs/id' },
+            description: { type: 'string' },
+            condition: {
+                description: 'When it fires, as the Trigger reference page writes it, a document it names at its current path.',
+                type: 'object',
+                additionalProperties: true,
+            },
+            actions: {
+                type: 'array',
+                items: {
+                    anyOf: [
+                        {
+                            type: 'object',
+                            additionalProperties: false,
+                            properties: {
+                                kind: { const: 'notify' },
+                                enabled: { type: 'boolean' },
+                                title: { type: 'string' },
+                                text: { type: 'string' },
+                                to: {
+                                    type: 'object',
+                                    additionalProperties: false,
+                                    properties: {
+                                        users: {
+                                            type: 'array',
+                                            items: {
+                                                type: 'object',
+                                                additionalProperties: false,
+                                                properties: { user: { $ref: '#/$defs/id' } },
+                                                required: ['user'],
+                                            },
+                                        },
+                                        fields: { type: 'array', items: { type: 'string' } },
+                                        roles: { type: 'array', items: { type: 'string' } },
+                                    },
+                                    required: ['users', 'fields', 'roles'],
+                                },
+                            },
+                            required: ['kind', 'enabled', 'title', 'text', 'to'],
+                        },
+                        {
+                            type: 'object',
+                            additionalProperties: false,
+                            properties: {
+                                kind: { const: 'agent_function' },
+                                enabled: { type: 'boolean' },
+                                card: { type: 'string', minLength: 1 },
+                                payload: { type: 'string' },
+                            },
+                            required: ['kind', 'enabled', 'payload'],
+                        },
+                        {
+                            type: 'object',
+                            additionalProperties: false,
+                            properties: {
+                                kind: { const: 'message' },
+                                enabled: { type: 'boolean' },
+                                card: { type: 'string', minLength: 1 },
+                                text: { type: 'string' },
+                            },
+                            required: ['kind', 'enabled', 'text'],
+                        },
+                        {
+                            type: 'object',
+                            additionalProperties: false,
+                            properties: { kind: { const: 'done' }, enabled: { type: 'boolean' } },
+                            required: ['kind', 'enabled'],
+                        },
+                        {
+                            type: 'object',
+                            additionalProperties: false,
+                            properties: {
+                                kind: { const: 'function' },
+                                enabled: { type: 'boolean' },
+                                app: { $ref: '#/$defs/app' },
+                                function: { type: 'string' },
+                            },
+                            required: ['kind', 'enabled', 'function'],
+                        },
+                    ],
+                },
+            },
+            enabled: { type: 'boolean' },
+            paused_by: { enum: ['types'] },
+            creator: {
+                type: 'object',
+                additionalProperties: false,
+                properties: { user: { $ref: '#/$defs/id' }, name: { type: 'string' } },
+                required: ['user', 'name'],
+            },
+            created: { type: 'string', format: 'date-time' },
+        },
+        required: [
+            'reflected',
+            'trigger',
+            'description',
+            'condition',
+            'actions',
+            'enabled',
+            'creator',
+            'created',
+        ],
+    },
+    'house-web-wizard': {
+        description: "One Web Wizard an agent made for this User: the `environment` it runs on, with the `name` that Environment had when the Web Wizard was made, and its `state`, `waiting` until its owner presses Run or Keep, `running`, `finished` with the script's `exit_code`, `failed`, `cancelled` when its page closed before the script ended, `lapsed` when nobody ran it in its time, or `kept` when its owner kept the script, without running it, as their Environment function named `function`. Its body is the script, whole, in one fenced code block. The terminal's output is never kept.",
+        properties: {
+            reflected: { type: 'string', format: 'date-time' },
+            web_wizard: { $ref: '#/$defs/id' },
+            environment: {
+                type: 'object',
+                additionalProperties: false,
+                properties: { environment: { $ref: '#/$defs/id' }, name: { type: 'string' } },
+                required: ['environment', 'name'],
+            },
+            state: { enum: ['waiting', 'running', 'finished', 'failed', 'cancelled', 'lapsed', 'kept'] },
+            exit_code: { type: 'integer' },
+            function: { type: 'string' },
+        },
+        required: ['reflected', 'web_wizard', 'environment', 'state'],
+    },
+};
+function modelText(model) {
+    return `${Object.entries(model)
+        .map(([name, declared]) => `${name}: ${JSON.stringify(declared)}`)
+        .join('\n')}\n`;
+}
+export const HOUSE_MODEL_TYPES = modelText(HOUSE_MODEL_DECLARATION);
+export const HOUSE_TYPED_PATHS = [
+    { path: 'settings/panel.md', type: 'house-panel-preferences', named: true, body: false },
+    { path: 'settings/apps/*.md', type: 'house-app-preferences', named: true, body: false },
+    {
+        path: 'rooms/*/agent-functions/*.md',
+        type: 'house-agent-function-document',
+        named: false,
+        body: true,
+    },
+];