events.iterate.com

Event type

events.iterate.com/capability-host/capability-provided

A capability was mounted at a path.

Payload schema

One of 2 shapes:

type: "live"

type"live"

A session-bound mount: the provider's value lives on the providing connection; only this record is durable.

pathstring[]

Mount point as path segments, e.g. ["tools", "weather"].

instructionsstringoptional

Prose for the model: what the capability does and how to call it (surfaced by __describe and itx.docs).

typesstringoptional

The mount's Capability Type Declaration — TypeScript declaration text describing the mounted value; read by itx.docs and the script typecheck gate.

flattenNestedPathsbooleanoptional

True when the provider is a dispatcher: any dotted call under the mount arrives as ONE invokeCapability({ path, args }) instead of property traversal.

type: "itx-expression"

type"itx-expression"

A durable mount: the recorded expression is re-evaluated against this scope's own itx on every call.

pathstring[]

Mount point as path segments, e.g. ["pets"].

expression(string | any[])[]

The recipe: property names and [method, ...args] steps walked over this scope's itx on every use.

instructionsstringoptional

Prose for the model: what the capability does and how to call it (surfaced by __describe and itx.docs).

typesstringoptional

The mount's Capability Type Declaration — TypeScript declaration text describing the mounted value; read by itx.docs and the script typecheck gate.

flattenNestedPathsbooleanoptional

True when the evaluated provider is a dispatcher: any dotted call under the mount arrives as ONE invokeCapability({ path, args }) instead of property traversal.

Raw JSON schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "const": "live",
          "description": "A session-bound mount: the provider's value lives on the providing connection; only this record is durable."
        },
        "path": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Mount point as path segments, e.g. [\"tools\", \"weather\"]."
        },
        "instructions": {
          "description": "Prose for the model: what the capability does and how to call it (surfaced by __describe and itx.docs).",
          "type": "string"
        },
        "types": {
          "description": "The mount's Capability Type Declaration — TypeScript declaration text describing the mounted value; read by itx.docs and the script typecheck gate.",
          "type": "string"
        },
        "flattenNestedPaths": {
          "description": "True when the provider is a dispatcher: any dotted call under the mount arrives as ONE invokeCapability({ path, args }) instead of property traversal.",
          "type": "boolean"
        }
      },
      "required": [
        "type",
        "path"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "const": "itx-expression",
          "description": "A durable mount: the recorded expression is re-evaluated against this scope's own itx on every call."
        },
        "path": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Mount point as path segments, e.g. [\"pets\"]."
        },
        "expression": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "array",
                "items": {}
              }
            ]
          },
          "description": "The recipe: property names and [method, ...args] steps walked over this scope's itx on every use."
        },
        "instructions": {
          "description": "Prose for the model: what the capability does and how to call it (surfaced by __describe and itx.docs).",
          "type": "string"
        },
        "types": {
          "description": "The mount's Capability Type Declaration — TypeScript declaration text describing the mounted value; read by itx.docs and the script typecheck gate.",
          "type": "string"
        },
        "flattenNestedPaths": {
          "description": "True when the evaluated provider is a dispatcher: any dotted call under the mount arrives as ONE invokeCapability({ path, args }) instead of property traversal.",
          "type": "boolean"
        }
      },
      "required": [
        "type",
        "path",
        "expression"
      ],
      "additionalProperties": false
    }
  ],
  "description": "The mount record — everything durable about the capability."
}