# Threadplane — Full Reference

See /llms.txt for a compact summary.


---

## API Reference (TypeDoc)

### a2ui

[
  {
    "name": "A2uiActionMessage",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "action",
        "type": "object",
        "description": "",
        "optional": false
      },
      {
        "name": "metadata",
        "type": "object",
        "description": "",
        "optional": true
      },
      {
        "name": "version",
        "type": "string",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiAudioPlayer",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "accessibility",
        "type": "Record<string, unknown>",
        "description": "Accessibility attributes (spec `AccessibilityAttributes`).",
        "optional": true
      },
      {
        "name": "catalogId",
        "type": "string",
        "description": "Overrides the surface's default catalog for this component.",
        "optional": true
      },
      {
        "name": "component",
        "type": "\"AudioPlayer\"",
        "description": "",
        "optional": false
      },
      {
        "name": "description",
        "type": "DynamicString",
        "description": "",
        "optional": true
      },
      {
        "name": "id",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "url",
        "type": "DynamicString",
        "description": "",
        "optional": false
      },
      {
        "name": "weight",
        "type": "number",
        "description": "Flex-grow-like weight; only valid as a direct child of Row/Column.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiButton",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "accessibility",
        "type": "Record<string, unknown>",
        "description": "Accessibility attributes (spec `AccessibilityAttributes`).",
        "optional": true
      },
      {
        "name": "action",
        "type": "A2uiAction",
        "description": "",
        "optional": false
      },
      {
        "name": "catalogId",
        "type": "string",
        "description": "Overrides the surface's default catalog for this component.",
        "optional": true
      },
      {
        "name": "child",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "component",
        "type": "\"Button\"",
        "description": "",
        "optional": false
      },
      {
        "name": "id",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "variant",
        "type": "\"default\" | \"primary\" | \"borderless\"",
        "description": "",
        "optional": true
      },
      {
        "name": "weight",
        "type": "number",
        "description": "Flex-grow-like weight; only valid as a direct child of Row/Column.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiCard",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "accessibility",
        "type": "Record<string, unknown>",
        "description": "Accessibility attributes (spec `AccessibilityAttributes`).",
        "optional": true
      },
      {
        "name": "catalogId",
        "type": "string",
        "description": "Overrides the surface's default catalog for this component.",
        "optional": true
      },
      {
        "name": "child",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "component",
        "type": "\"Card\"",
        "description": "",
        "optional": false
      },
      {
        "name": "id",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "weight",
        "type": "number",
        "description": "Flex-grow-like weight; only valid as a direct child of Row/Column.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiCheck",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "condition",
        "type": "unknown",
        "description": "A DynamicBoolean — typically a validator function call (`required`,\n`regex`, `length`, `numeric`, `email`) or a logic combinator. The rule\npasses when the condition resolves to `true`.",
        "optional": false
      },
      {
        "name": "message",
        "type": "string",
        "description": "Error message displayed when the check fails.",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiCheckable",
    "kind": "interface",
    "description": "Mixin for input components that support client-side validation checks.",
    "properties": [
      {
        "name": "checks",
        "type": "A2uiCheck[]",
        "description": "",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiCheckBox",
    "kind": "interface",
    "description": "Mixin for input components that support client-side validation checks.",
    "properties": [
      {
        "name": "accessibility",
        "type": "Record<string, unknown>",
        "description": "Accessibility attributes (spec `AccessibilityAttributes`).",
        "optional": true
      },
      {
        "name": "catalogId",
        "type": "string",
        "description": "Overrides the surface's default catalog for this component.",
        "optional": true
      },
      {
        "name": "checks",
        "type": "A2uiCheck[]",
        "description": "",
        "optional": true
      },
      {
        "name": "component",
        "type": "\"CheckBox\"",
        "description": "",
        "optional": false
      },
      {
        "name": "id",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "label",
        "type": "DynamicString",
        "description": "",
        "optional": false
      },
      {
        "name": "value",
        "type": "DynamicBoolean",
        "description": "",
        "optional": false
      },
      {
        "name": "weight",
        "type": "number",
        "description": "Flex-grow-like weight; only valid as a direct child of Row/Column.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiChoicePicker",
    "kind": "interface",
    "description": "Mixin for input components that support client-side validation checks.",
    "properties": [
      {
        "name": "accessibility",
        "type": "Record<string, unknown>",
        "description": "Accessibility attributes (spec `AccessibilityAttributes`).",
        "optional": true
      },
      {
        "name": "catalogId",
        "type": "string",
        "description": "Overrides the surface's default catalog for this component.",
        "optional": true
      },
      {
        "name": "checks",
        "type": "A2uiCheck[]",
        "description": "",
        "optional": true
      },
      {
        "name": "component",
        "type": "\"ChoicePicker\"",
        "description": "",
        "optional": false
      },
      {
        "name": "displayStyle",
        "type": "\"checkbox\" | \"chips\"",
        "description": "",
        "optional": true
      },
      {
        "name": "filterable",
        "type": "boolean",
        "description": "",
        "optional": true
      },
      {
        "name": "id",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "label",
        "type": "DynamicString",
        "description": "",
        "optional": true
      },
      {
        "name": "options",
        "type": "object[]",
        "description": "",
        "optional": false
      },
      {
        "name": "value",
        "type": "DynamicStringList",
        "description": "",
        "optional": false
      },
      {
        "name": "variant",
        "type": "\"mutuallyExclusive\" | \"multipleSelection\"",
        "description": "",
        "optional": true
      },
      {
        "name": "weight",
        "type": "number",
        "description": "Flex-grow-like weight; only valid as a direct child of Row/Column.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiClientCapabilities",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "inlineCatalogs",
        "type": "unknown[]",
        "description": "",
        "optional": true
      },
      {
        "name": "supportedCatalogIds",
        "type": "string[]",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiClientDataModel",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "surfaces",
        "type": "Record<string, Record<string, unknown>>",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiColumn",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "accessibility",
        "type": "Record<string, unknown>",
        "description": "Accessibility attributes (spec `AccessibilityAttributes`).",
        "optional": true
      },
      {
        "name": "align",
        "type": "A2uiAlign",
        "description": "",
        "optional": true
      },
      {
        "name": "catalogId",
        "type": "string",
        "description": "Overrides the surface's default catalog for this component.",
        "optional": true
      },
      {
        "name": "children",
        "type": "A2uiChildren",
        "description": "",
        "optional": false
      },
      {
        "name": "component",
        "type": "\"Column\"",
        "description": "",
        "optional": false
      },
      {
        "name": "id",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "justify",
        "type": "A2uiJustify",
        "description": "",
        "optional": true
      },
      {
        "name": "weight",
        "type": "number",
        "description": "Flex-grow-like weight; only valid as a direct child of Row/Column.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiComponentBase",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "accessibility",
        "type": "Record<string, unknown>",
        "description": "Accessibility attributes (spec `AccessibilityAttributes`).",
        "optional": true
      },
      {
        "name": "catalogId",
        "type": "string",
        "description": "Overrides the surface's default catalog for this component.",
        "optional": true
      },
      {
        "name": "component",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "id",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "weight",
        "type": "number",
        "description": "Flex-grow-like weight; only valid as a direct child of Row/Column.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiCreateSurface",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "catalogId",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "sendDataModel",
        "type": "boolean",
        "description": "When true, the client attaches the surface's full data model to every outbound message.",
        "optional": true
      },
      {
        "name": "surfaceId",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "theme",
        "type": "A2uiTheme",
        "description": "",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiDateTimeInput",
    "kind": "interface",
    "description": "Mixin for input components that support client-side validation checks.",
    "properties": [
      {
        "name": "accessibility",
        "type": "Record<string, unknown>",
        "description": "Accessibility attributes (spec `AccessibilityAttributes`).",
        "optional": true
      },
      {
        "name": "catalogId",
        "type": "string",
        "description": "Overrides the surface's default catalog for this component.",
        "optional": true
      },
      {
        "name": "checks",
        "type": "A2uiCheck[]",
        "description": "",
        "optional": true
      },
      {
        "name": "component",
        "type": "\"DateTimeInput\"",
        "description": "",
        "optional": false
      },
      {
        "name": "enableDate",
        "type": "boolean",
        "description": "",
        "optional": true
      },
      {
        "name": "enableTime",
        "type": "boolean",
        "description": "",
        "optional": true
      },
      {
        "name": "id",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "label",
        "type": "DynamicString",
        "description": "",
        "optional": true
      },
      {
        "name": "max",
        "type": "DynamicString",
        "description": "",
        "optional": true
      },
      {
        "name": "min",
        "type": "DynamicString",
        "description": "",
        "optional": true
      },
      {
        "name": "value",
        "type": "DynamicString",
        "description": "ISO 8601 value.",
        "optional": false
      },
      {
        "name": "weight",
        "type": "number",
        "description": "Flex-grow-like weight; only valid as a direct child of Row/Column.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiDeleteSurface",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "surfaceId",
        "type": "string",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiDivider",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "accessibility",
        "type": "Record<string, unknown>",
        "description": "Accessibility attributes (spec `AccessibilityAttributes`).",
        "optional": true
      },
      {
        "name": "axis",
        "type": "\"vertical\" | \"horizontal\"",
        "description": "",
        "optional": true
      },
      {
        "name": "catalogId",
        "type": "string",
        "description": "Overrides the surface's default catalog for this component.",
        "optional": true
      },
      {
        "name": "component",
        "type": "\"Divider\"",
        "description": "",
        "optional": false
      },
      {
        "name": "id",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "weight",
        "type": "number",
        "description": "Flex-grow-like weight; only valid as a direct child of Row/Column.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiErrorMessage",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "error",
        "type": "object",
        "description": "",
        "optional": false
      },
      {
        "name": "version",
        "type": "string",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiEventAction",
    "kind": "interface",
    "description": "Dispatches a named event (with optional context) to the agent.",
    "properties": [
      {
        "name": "event",
        "type": "object",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiFunctionAction",
    "kind": "interface",
    "description": "Executes a client-side function locally (e.g. `openUrl`).",
    "properties": [
      {
        "name": "functionCall",
        "type": "A2uiFunctionCall",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiFunctionCall",
    "kind": "interface",
    "description": "Client-side function invocation (e.g. `formatString`, `required`).",
    "properties": [
      {
        "name": "args",
        "type": "Record<string, unknown>",
        "description": "",
        "optional": true
      },
      {
        "name": "call",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "returnType",
        "type": "\"string\" | \"number\" | \"boolean\" | \"object\" | \"array\" | \"any\" | \"void\"",
        "description": "",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiFunctionContext",
    "kind": "interface",
    "description": "Execution context handed to every function implementation.",
    "properties": [
      {
        "name": "locale",
        "type": "string",
        "description": "BCP 47 locale for Intl-based formatting; host default when undefined.",
        "optional": true
      }
    ],
    "methods": [
      {
        "name": "resolveArg",
        "signature": "resolveArg(value: unknown): unknown",
        "description": "Resolve a (possibly dynamic) argument value — bare literal, `{ path }`\nbinding, or nested `{ call }` — against the current data model/scope.",
        "params": [
          {
            "name": "value",
            "type": "unknown",
            "description": "",
            "optional": false
          }
        ]
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiIcon",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "accessibility",
        "type": "Record<string, unknown>",
        "description": "Accessibility attributes (spec `AccessibilityAttributes`).",
        "optional": true
      },
      {
        "name": "catalogId",
        "type": "string",
        "description": "Overrides the surface's default catalog for this component.",
        "optional": true
      },
      {
        "name": "component",
        "type": "\"Icon\"",
        "description": "",
        "optional": false
      },
      {
        "name": "id",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "name",
        "type": "DynamicString | object",
        "description": "",
        "optional": false
      },
      {
        "name": "weight",
        "type": "number",
        "description": "Flex-grow-like weight; only valid as a direct child of Row/Column.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiImage",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "accessibility",
        "type": "Record<string, unknown>",
        "description": "Accessibility attributes (spec `AccessibilityAttributes`).",
        "optional": true
      },
      {
        "name": "catalogId",
        "type": "string",
        "description": "Overrides the surface's default catalog for this component.",
        "optional": true
      },
      {
        "name": "component",
        "type": "\"Image\"",
        "description": "",
        "optional": false
      },
      {
        "name": "description",
        "type": "DynamicString",
        "description": "",
        "optional": true
      },
      {
        "name": "fit",
        "type": "\"contain\" | \"cover\" | \"fill\" | \"none\" | \"scaleDown\"",
        "description": "",
        "optional": true
      },
      {
        "name": "id",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "url",
        "type": "DynamicString",
        "description": "",
        "optional": false
      },
      {
        "name": "variant",
        "type": "\"icon\" | \"avatar\" | \"smallFeature\" | \"mediumFeature\" | \"largeFeature\" | \"header\"",
        "description": "",
        "optional": true
      },
      {
        "name": "weight",
        "type": "number",
        "description": "Flex-grow-like weight; only valid as a direct child of Row/Column.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiList",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "accessibility",
        "type": "Record<string, unknown>",
        "description": "Accessibility attributes (spec `AccessibilityAttributes`).",
        "optional": true
      },
      {
        "name": "align",
        "type": "A2uiAlign",
        "description": "",
        "optional": true
      },
      {
        "name": "catalogId",
        "type": "string",
        "description": "Overrides the surface's default catalog for this component.",
        "optional": true
      },
      {
        "name": "children",
        "type": "A2uiChildren",
        "description": "",
        "optional": false
      },
      {
        "name": "component",
        "type": "\"List\"",
        "description": "",
        "optional": false
      },
      {
        "name": "direction",
        "type": "\"vertical\" | \"horizontal\"",
        "description": "",
        "optional": true
      },
      {
        "name": "id",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "weight",
        "type": "number",
        "description": "Flex-grow-like weight; only valid as a direct child of Row/Column.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiMessageParser",
    "kind": "interface",
    "description": "",
    "properties": [],
    "methods": [
      {
        "name": "push",
        "signature": "push(chunk: string): A2uiMessage[]",
        "description": "Push a JSONL stream chunk and return every complete A2UI envelope parsed from it.",
        "params": [
          {
            "name": "chunk",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiModal",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "accessibility",
        "type": "Record<string, unknown>",
        "description": "Accessibility attributes (spec `AccessibilityAttributes`).",
        "optional": true
      },
      {
        "name": "catalogId",
        "type": "string",
        "description": "Overrides the surface's default catalog for this component.",
        "optional": true
      },
      {
        "name": "component",
        "type": "\"Modal\"",
        "description": "",
        "optional": false
      },
      {
        "name": "content",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "id",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "trigger",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "weight",
        "type": "number",
        "description": "Flex-grow-like weight; only valid as a direct child of Row/Column.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiPathRef",
    "kind": "interface",
    "description": "JSON-pointer data-model binding. Absolute (`/a/b`) or relative inside templates.",
    "properties": [
      {
        "name": "path",
        "type": "string",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiRow",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "accessibility",
        "type": "Record<string, unknown>",
        "description": "Accessibility attributes (spec `AccessibilityAttributes`).",
        "optional": true
      },
      {
        "name": "align",
        "type": "A2uiAlign",
        "description": "",
        "optional": true
      },
      {
        "name": "catalogId",
        "type": "string",
        "description": "Overrides the surface's default catalog for this component.",
        "optional": true
      },
      {
        "name": "children",
        "type": "A2uiChildren",
        "description": "",
        "optional": false
      },
      {
        "name": "component",
        "type": "\"Row\"",
        "description": "",
        "optional": false
      },
      {
        "name": "id",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "justify",
        "type": "A2uiJustify",
        "description": "",
        "optional": true
      },
      {
        "name": "weight",
        "type": "number",
        "description": "Flex-grow-like weight; only valid as a direct child of Row/Column.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiScope",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "basePath",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "item",
        "type": "unknown",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiSlider",
    "kind": "interface",
    "description": "Mixin for input components that support client-side validation checks.",
    "properties": [
      {
        "name": "accessibility",
        "type": "Record<string, unknown>",
        "description": "Accessibility attributes (spec `AccessibilityAttributes`).",
        "optional": true
      },
      {
        "name": "catalogId",
        "type": "string",
        "description": "Overrides the surface's default catalog for this component.",
        "optional": true
      },
      {
        "name": "checks",
        "type": "A2uiCheck[]",
        "description": "",
        "optional": true
      },
      {
        "name": "component",
        "type": "\"Slider\"",
        "description": "",
        "optional": false
      },
      {
        "name": "id",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "label",
        "type": "DynamicString",
        "description": "",
        "optional": true
      },
      {
        "name": "max",
        "type": "number",
        "description": "",
        "optional": false
      },
      {
        "name": "min",
        "type": "number",
        "description": "",
        "optional": true
      },
      {
        "name": "value",
        "type": "DynamicNumber",
        "description": "",
        "optional": false
      },
      {
        "name": "weight",
        "type": "number",
        "description": "Flex-grow-like weight; only valid as a direct child of Row/Column.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiSurface",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "catalogId",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "components",
        "type": "Map<string, A2uiComponent>",
        "description": "",
        "optional": false
      },
      {
        "name": "dataModel",
        "type": "Record<string, unknown>",
        "description": "",
        "optional": false
      },
      {
        "name": "sendDataModel",
        "type": "boolean",
        "description": "",
        "optional": true
      },
      {
        "name": "surfaceId",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "theme",
        "type": "A2uiTheme",
        "description": "",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiTabs",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "accessibility",
        "type": "Record<string, unknown>",
        "description": "Accessibility attributes (spec `AccessibilityAttributes`).",
        "optional": true
      },
      {
        "name": "catalogId",
        "type": "string",
        "description": "Overrides the surface's default catalog for this component.",
        "optional": true
      },
      {
        "name": "component",
        "type": "\"Tabs\"",
        "description": "",
        "optional": false
      },
      {
        "name": "id",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "tabs",
        "type": "object[]",
        "description": "",
        "optional": false
      },
      {
        "name": "weight",
        "type": "number",
        "description": "Flex-grow-like weight; only valid as a direct child of Row/Column.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiText",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "accessibility",
        "type": "Record<string, unknown>",
        "description": "Accessibility attributes (spec `AccessibilityAttributes`).",
        "optional": true
      },
      {
        "name": "catalogId",
        "type": "string",
        "description": "Overrides the surface's default catalog for this component.",
        "optional": true
      },
      {
        "name": "component",
        "type": "\"Text\"",
        "description": "",
        "optional": false
      },
      {
        "name": "id",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "text",
        "type": "DynamicString",
        "description": "",
        "optional": false
      },
      {
        "name": "variant",
        "type": "\"h1\" | \"h2\" | \"h3\" | \"h4\" | \"h5\" | \"caption\" | \"body\"",
        "description": "",
        "optional": true
      },
      {
        "name": "weight",
        "type": "number",
        "description": "Flex-grow-like weight; only valid as a direct child of Row/Column.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiTextField",
    "kind": "interface",
    "description": "Mixin for input components that support client-side validation checks.",
    "properties": [
      {
        "name": "accessibility",
        "type": "Record<string, unknown>",
        "description": "Accessibility attributes (spec `AccessibilityAttributes`).",
        "optional": true
      },
      {
        "name": "catalogId",
        "type": "string",
        "description": "Overrides the surface's default catalog for this component.",
        "optional": true
      },
      {
        "name": "checks",
        "type": "A2uiCheck[]",
        "description": "",
        "optional": true
      },
      {
        "name": "component",
        "type": "\"TextField\"",
        "description": "",
        "optional": false
      },
      {
        "name": "id",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "label",
        "type": "DynamicString",
        "description": "",
        "optional": false
      },
      {
        "name": "validationRegexp",
        "type": "string",
        "description": "",
        "optional": true
      },
      {
        "name": "value",
        "type": "DynamicString",
        "description": "",
        "optional": true
      },
      {
        "name": "variant",
        "type": "\"number\" | \"shortText\" | \"longText\" | \"obscured\"",
        "description": "",
        "optional": true
      },
      {
        "name": "weight",
        "type": "number",
        "description": "Flex-grow-like weight; only valid as a direct child of Row/Column.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiTheme",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "agentDisplayName",
        "type": "string",
        "description": "",
        "optional": true
      },
      {
        "name": "iconUrl",
        "type": "string",
        "description": "",
        "optional": true
      },
      {
        "name": "primaryColor",
        "type": "string",
        "description": "",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiUpdateComponents",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "components",
        "type": "A2uiComponent[]",
        "description": "",
        "optional": false
      },
      {
        "name": "surfaceId",
        "type": "string",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiUpdateDataModel",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "path",
        "type": "string",
        "description": "JSON pointer into the data model. Omitted or `/` targets the whole model.",
        "optional": true
      },
      {
        "name": "surfaceId",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "value",
        "type": "unknown",
        "description": "Replacement value at `path`. Omitted value deletes the key at `path`.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiVideo",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "accessibility",
        "type": "Record<string, unknown>",
        "description": "Accessibility attributes (spec `AccessibilityAttributes`).",
        "optional": true
      },
      {
        "name": "catalogId",
        "type": "string",
        "description": "Overrides the surface's default catalog for this component.",
        "optional": true
      },
      {
        "name": "component",
        "type": "\"Video\"",
        "description": "",
        "optional": false
      },
      {
        "name": "id",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "url",
        "type": "DynamicString",
        "description": "",
        "optional": false
      },
      {
        "name": "weight",
        "type": "number",
        "description": "Flex-grow-like weight; only valid as a direct child of Row/Column.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiAction",
    "kind": "type",
    "description": "",
    "signature": "A2uiEventAction | A2uiFunctionAction",
    "examples": []
  },
  {
    "name": "A2uiCatalogComponent",
    "kind": "type",
    "description": "Union of the basic-catalog component shapes.",
    "signature": "A2uiText | A2uiImage | A2uiIcon | A2uiVideo | A2uiAudioPlayer | A2uiRow | A2uiColumn | A2uiList | A2uiCard | A2uiTabs | A2uiModal | A2uiDivider | A2uiButton | A2uiCheckBox | A2uiTextField | A2uiDateTimeInput | A2uiChoicePicker | A2uiSlider",
    "examples": []
  },
  {
    "name": "A2uiChildren",
    "kind": "type",
    "description": "Static child-id list, or a template stamped per element of a data-model list.",
    "signature": "string[] | object",
    "examples": []
  },
  {
    "name": "A2uiComponent",
    "kind": "type",
    "description": "Any component, including non-basic-catalog types. Renderers treat unknown\n`component` strings as unrenderable and fall back gracefully.",
    "signature": "A2uiCatalogComponent | A2uiComponentBase & Record<string, unknown>",
    "examples": []
  },
  {
    "name": "A2uiFunctionImpl",
    "kind": "type",
    "description": "",
    "signature": "(args: Record<string, unknown>, ctx: A2uiFunctionContext) => unknown",
    "examples": []
  },
  {
    "name": "A2uiFunctionRegistry",
    "kind": "type",
    "description": "",
    "signature": "ReadonlyMap<string, A2uiFunctionImpl>",
    "examples": []
  },
  {
    "name": "A2uiMessage",
    "kind": "type",
    "description": "",
    "signature": "A2uiEnvelopeBase & ({ createSurface: A2uiCreateSurface } | { updateComponents: A2uiUpdateComponents } | { updateDataModel: A2uiUpdateDataModel } | { deleteSurface: A2uiDeleteSurface })",
    "examples": []
  },
  {
    "name": "DynamicBoolean",
    "kind": "type",
    "description": "",
    "signature": "boolean | A2uiPathRef | A2uiFunctionCall",
    "examples": []
  },
  {
    "name": "DynamicNumber",
    "kind": "type",
    "description": "",
    "signature": "number | A2uiPathRef | A2uiFunctionCall",
    "examples": []
  },
  {
    "name": "DynamicString",
    "kind": "type",
    "description": "",
    "signature": "string | A2uiPathRef | A2uiFunctionCall",
    "examples": []
  },
  {
    "name": "DynamicStringList",
    "kind": "type",
    "description": "",
    "signature": "string[] | A2uiPathRef | A2uiFunctionCall",
    "examples": []
  },
  {
    "name": "DynamicValue",
    "kind": "type",
    "description": "Any dynamic value position where the concrete type is component-defined.",
    "signature": "unknown",
    "examples": []
  },
  {
    "name": "A2UI_BASIC_CATALOG_ID",
    "kind": "const",
    "description": "Catalog id of the standard A2UI basic component catalog.",
    "signature": "\"https://a2ui.org/specification/v0_9/catalogs/basic/catalog.json\"",
    "examples": []
  },
  {
    "name": "A2UI_MIME_TYPE",
    "kind": "const",
    "description": "MIME type for A2UI payloads, standardized in the v0.9.1 release.",
    "signature": "\"application/a2ui+json\"",
    "examples": []
  },
  {
    "name": "A2UI_WIRE_VERSION",
    "kind": "const",
    "description": "Wire version stamped on every A2UI v0.9-family envelope.",
    "signature": "\"v0.9\"",
    "examples": []
  },
  {
    "name": "createA2uiFunctionRegistry",
    "kind": "function",
    "description": "Creates an A2UI client-side function registry containing the standard\nbasic-catalog functions (`formatString`, `formatNumber`, `formatCurrency`,\n`formatDate`, `pluralize`, `and`, `or`, `not`), optionally extended or\noverridden with custom implementations.",
    "signature": "createA2uiFunctionRegistry(overrides: Record<string, A2uiFunctionImpl>): A2uiFunctionRegistry",
    "params": [
      {
        "name": "overrides",
        "type": "Record<string, A2uiFunctionImpl>",
        "description": "",
        "optional": true
      }
    ],
    "returns": {
      "type": "A2uiFunctionRegistry",
      "description": ""
    },
    "examples": [
      "```ts\nconst registry = createA2uiFunctionRegistry();\nresolveDynamic({ call: 'formatCurrency', args: { value: 42, currency: 'USD' } }, {}, undefined, registry);\n```"
    ]
  },
  {
    "name": "createA2uiMessageParser",
    "kind": "function",
    "description": "Creates a stateful parser for newline-delimited A2UI v0.9 message streams.\n\nThe parser buffers incomplete lines, skips malformed JSON, and returns only\nrecognized A2UI envelopes: `createSurface`, `updateComponents`,\n`updateDataModel`, and `deleteSurface`. Unknown envelope keys (e.g. future\nv1.0 messages) are skipped rather than treated as errors. A missing\n`version` field defaults to `v0.9`.",
    "signature": "createA2uiMessageParser(): A2uiMessageParser",
    "params": [],
    "returns": {
      "type": "A2uiMessageParser",
      "description": ""
    },
    "examples": [
      "```ts\nconst parser = createA2uiMessageParser();\nconst messages = parser.push(\n  '{\"version\":\"v0.9\",\"createSurface\":{\"surfaceId\":\"s1\",\"catalogId\":\"basic\"}}\\n',\n);\n```"
    ]
  },
  {
    "name": "deleteByPointer",
    "kind": "function",
    "description": "Returns a new model with the key at `pointer` removed.\n\nEmpty string and `/` clear the whole model. Missing parent paths leave the\ninput model unchanged.",
    "signature": "deleteByPointer(model: Record<string, unknown>, pointer: string): Record<string, unknown>",
    "params": [
      {
        "name": "model",
        "type": "Record<string, unknown>",
        "description": "",
        "optional": false
      },
      {
        "name": "pointer",
        "type": "string",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "Record<string, unknown>",
      "description": ""
    },
    "examples": [
      "```ts\nconst next = deleteByPointer({ user: { name: 'Ada' } }, '/user/name');\n```"
    ]
  },
  {
    "name": "getByPointer",
    "kind": "function",
    "description": "Reads a value from a model using the package's simple slash-separated pointer syntax.\n\nEmpty string and `/` target the root. Segments are not RFC 6901-unescaped;\nnormalize keys before using pointers that would require `~0` or `~1`.",
    "signature": "getByPointer(model: Record<string, unknown>, pointer: string): unknown",
    "params": [
      {
        "name": "model",
        "type": "Record<string, unknown>",
        "description": "",
        "optional": false
      },
      {
        "name": "pointer",
        "type": "string",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "unknown",
      "description": ""
    },
    "examples": [
      "```ts\ngetByPointer({ user: { name: 'Ada' } }, '/user/name'); // 'Ada'\n```"
    ]
  },
  {
    "name": "isFunctionCall",
    "kind": "function",
    "description": "Returns true when `value` is an A2UI client-side function call.",
    "signature": "isFunctionCall(value: unknown): value is { args?: Record<string, unknown>; call: string }",
    "params": [
      {
        "name": "value",
        "type": "unknown",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "value is { args?: Record<string, unknown>; call: string }",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "isPathRef",
    "kind": "function",
    "description": "Returns true when `value` is an A2UI dynamic path reference.",
    "signature": "isPathRef(value: unknown): value is { path: string }",
    "params": [
      {
        "name": "value",
        "type": "unknown",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "value is { path: string }",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "resolveDynamic",
    "kind": "function",
    "description": "Resolves an A2UI v0.9 dynamic value against a client data model.\n\nBare literals (strings, numbers, booleans) pass through unchanged, `{ path }`\nreferences read from the model by JSON-pointer path, arrays resolve\nelement-wise, and client-side function calls (`{ call }`) execute through the\nprovided function registry — argument values resolve recursively, so args may\nthemselves be bindings or nested calls. Without a registry (or for unknown\nfunction names) calls resolve to `undefined`. Unrecognized plain objects pass\nthrough unchanged.",
    "signature": "resolveDynamic(value: unknown, model: Record<string, unknown>, scope: A2uiScope, registry: A2uiFunctionRegistry): unknown",
    "params": [
      {
        "name": "value",
        "type": "unknown",
        "description": "",
        "optional": false
      },
      {
        "name": "model",
        "type": "Record<string, unknown>",
        "description": "",
        "optional": false
      },
      {
        "name": "scope",
        "type": "A2uiScope",
        "description": "",
        "optional": true
      },
      {
        "name": "registry",
        "type": "A2uiFunctionRegistry",
        "description": "",
        "optional": true
      }
    ],
    "returns": {
      "type": "unknown",
      "description": ""
    },
    "examples": [
      "```ts\nconst model = { customer: { name: 'Ada' } };\nresolveDynamic({ path: '/customer/name' }, model); // 'Ada'\nresolveDynamic('Checkout', model); // 'Checkout'\nresolveDynamic(\n  { call: 'formatString', args: { value: 'Hi ${/customer/name}' } },\n  model, undefined, createA2uiFunctionRegistry(),\n); // 'Hi Ada'\n```"
    ]
  },
  {
    "name": "setByPointer",
    "kind": "function",
    "description": "Returns a new model with `value` written at `pointer`.\n\nThe input model is not mutated. Missing intermediate objects are created.",
    "signature": "setByPointer(model: Record<string, unknown>, pointer: string, value: unknown): Record<string, unknown>",
    "params": [
      {
        "name": "model",
        "type": "Record<string, unknown>",
        "description": "",
        "optional": false
      },
      {
        "name": "pointer",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "value",
        "type": "unknown",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "Record<string, unknown>",
      "description": ""
    },
    "examples": [
      "```ts\nconst next = setByPointer({}, '/user/name', 'Ada');\n```"
    ]
  }
]

### ag-ui

[
  {
    "name": "FakeAgent",
    "kind": "class",
    "description": "In-process AG-UI agent that emits a canned streaming response.\n\nUse for offline demos and tests where a real backend isn't available.\nEchoes a fixed assistant reply token-by-token with realistic timing.\n\nNOT for production use.",
    "params": [
      {
        "name": "opts",
        "type": "object",
        "description": "",
        "optional": true
      }
    ],
    "examples": [],
    "properties": [
      {
        "name": "agentId",
        "type": "string",
        "description": "",
        "optional": true
      },
      {
        "name": "description",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "isRunning",
        "type": "boolean",
        "description": "",
        "optional": false
      },
      {
        "name": "messages",
        "type": "object | object | object | object | object | object | object[]",
        "description": "",
        "optional": false
      },
      {
        "name": "pendingInterrupts",
        "type": "object[]",
        "description": "Interrupts emitted by the most recent run that have not yet been resolved.\n Populated when RUN_FINISHED arrives with outcome.type === \"interrupt\".\n Cleared when a subsequent run completes successfully.",
        "optional": false
      },
      {
        "name": "state",
        "type": "any",
        "description": "",
        "optional": false
      },
      {
        "name": "subscribers",
        "type": "AgentSubscriber[]",
        "description": "",
        "optional": false
      },
      {
        "name": "threadId",
        "type": "string",
        "description": "",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "abortRun",
        "signature": "abortRun(): void",
        "description": "",
        "params": []
      },
      {
        "name": "addMessage",
        "signature": "addMessage(message: object | object | object | object | object | object | object): void",
        "description": "",
        "params": [
          {
            "name": "message",
            "type": "object | object | object | object | object | object | object",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "addMessages",
        "signature": "addMessages(messages: object | object | object | object | object | object | object[]): void",
        "description": "",
        "params": [
          {
            "name": "messages",
            "type": "object | object | object | object | object | object | object[]",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "apply",
        "signature": "apply(input: object, events$: Observable<objectOutputType<object, ZodTypeAny, \"passthrough\">>, subscribers: AgentSubscriber[]): Observable<AgentStateMutation>",
        "description": "",
        "params": [
          {
            "name": "input",
            "type": "object",
            "description": "",
            "optional": false
          },
          {
            "name": "events$",
            "type": "Observable<objectOutputType<object, ZodTypeAny, \"passthrough\">>",
            "description": "",
            "optional": false
          },
          {
            "name": "subscribers",
            "type": "AgentSubscriber[]",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "clone",
        "signature": "clone(): any",
        "description": "",
        "params": []
      },
      {
        "name": "connect",
        "signature": "connect(input: object): Observable<objectOutputType<object, ZodTypeAny, \"passthrough\">>",
        "description": "",
        "params": [
          {
            "name": "input",
            "type": "object",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "connectAgent",
        "signature": "connectAgent(parameters: RunAgentParameters<>, subscriber: AgentSubscriber): Promise<RunAgentResult>",
        "description": "",
        "params": [
          {
            "name": "parameters",
            "type": "RunAgentParameters<>",
            "description": "",
            "optional": true
          },
          {
            "name": "subscriber",
            "type": "AgentSubscriber",
            "description": "",
            "optional": true
          }
        ]
      },
      {
        "name": "detachActiveRun",
        "signature": "detachActiveRun(): Promise<void>",
        "description": "",
        "params": []
      },
      {
        "name": "getCapabilities",
        "signature": "getCapabilities(): Promise<object>",
        "description": "Returns the agent's current capabilities.\nOptional — subclasses implement this to advertise what they support.",
        "params": []
      },
      {
        "name": "legacy_to_be_removed_runAgentBridged",
        "signature": "legacy_to_be_removed_runAgentBridged(config: RunAgentParameters<>): Observable<object | object | object | object | object | object | object | object | object | object>",
        "description": "",
        "params": [
          {
            "name": "config",
            "type": "RunAgentParameters<>",
            "description": "",
            "optional": true
          }
        ]
      },
      {
        "name": "onError",
        "signature": "onError(input: object, error: Error, subscribers: AgentSubscriber[]): Observable<AgentStateMutation>",
        "description": "",
        "params": [
          {
            "name": "input",
            "type": "object",
            "description": "",
            "optional": false
          },
          {
            "name": "error",
            "type": "Error",
            "description": "",
            "optional": false
          },
          {
            "name": "subscribers",
            "type": "AgentSubscriber[]",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onFinalize",
        "signature": "onFinalize(input: object, subscribers: AgentSubscriber[]): Promise<void>",
        "description": "",
        "params": [
          {
            "name": "input",
            "type": "object",
            "description": "",
            "optional": false
          },
          {
            "name": "subscribers",
            "type": "AgentSubscriber[]",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onInitialize",
        "signature": "onInitialize(input: object, subscribers: AgentSubscriber[]): Promise<void>",
        "description": "",
        "params": [
          {
            "name": "input",
            "type": "object",
            "description": "",
            "optional": false
          },
          {
            "name": "subscribers",
            "type": "AgentSubscriber[]",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "prepareRunAgentInput",
        "signature": "prepareRunAgentInput(parameters: RunAgentParameters<>): object",
        "description": "",
        "params": [
          {
            "name": "parameters",
            "type": "RunAgentParameters<>",
            "description": "",
            "optional": true
          }
        ]
      },
      {
        "name": "processApplyEvents",
        "signature": "processApplyEvents(input: object, events$: Observable<AgentStateMutation>, subscribers: AgentSubscriber[]): Observable<AgentStateMutation>",
        "description": "",
        "params": [
          {
            "name": "input",
            "type": "object",
            "description": "",
            "optional": false
          },
          {
            "name": "events$",
            "type": "Observable<AgentStateMutation>",
            "description": "",
            "optional": false
          },
          {
            "name": "subscribers",
            "type": "AgentSubscriber[]",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "run",
        "signature": "run(input: object): Observable<objectOutputType<object, ZodTypeAny, \"passthrough\">>",
        "description": "",
        "params": [
          {
            "name": "input",
            "type": "object",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "runAgent",
        "signature": "runAgent(parameters: RunAgentParameters<>, subscriber: AgentSubscriber): Promise<RunAgentResult>",
        "description": "",
        "params": [
          {
            "name": "parameters",
            "type": "RunAgentParameters<>",
            "description": "",
            "optional": true
          },
          {
            "name": "subscriber",
            "type": "AgentSubscriber",
            "description": "",
            "optional": true
          }
        ]
      },
      {
        "name": "setMessages",
        "signature": "setMessages(messages: object | object | object | object | object | object | object[]): void",
        "description": "",
        "params": [
          {
            "name": "messages",
            "type": "object | object | object | object | object | object | object[]",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "setState",
        "signature": "setState(state: any): void",
        "description": "",
        "params": [
          {
            "name": "state",
            "type": "any",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "subscribe",
        "signature": "subscribe(subscriber: AgentSubscriber): object",
        "description": "",
        "params": [
          {
            "name": "subscriber",
            "type": "AgentSubscriber",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "use",
        "signature": "use(...middlewares: Middleware<> | MiddlewareFunction[]): this",
        "description": "",
        "params": [
          {
            "name": "...middlewares",
            "type": "Middleware<> | MiddlewareFunction[]",
            "description": "",
            "optional": false
          }
        ]
      }
    ]
  },
  {
    "name": "AgentConfig",
    "kind": "interface",
    "description": "Connection options for the AG-UI agent provider, passed to provideAgent.\nMirrors the underlying `HttpAgent` config (`@ag-ui/client`) plus an optional\ntelemetry sink.",
    "properties": [
      {
        "name": "agentId",
        "type": "string",
        "description": "Agent identifier, when the endpoint serves more than one agent.",
        "optional": true
      },
      {
        "name": "headers",
        "type": "Record<string, string>",
        "description": "Extra HTTP headers sent with every request (e.g. auth tokens).",
        "optional": true
      },
      {
        "name": "telemetry",
        "type": "false | AgentRuntimeTelemetrySink",
        "description": "Omit to enable automatic development-only collection. Set `false` to disable.\nAn app-owned sink replaces the automatic destination and receives the\nexisting runtime lifecycle callbacks.",
        "optional": true
      },
      {
        "name": "threadId",
        "type": "string",
        "description": "Thread to connect to on start; omit to begin a fresh conversation.",
        "optional": true
      },
      {
        "name": "url",
        "type": "string",
        "description": "Endpoint URL of the AG-UI HTTP agent (e.g. `'http://localhost:8000/agent'`). Required.",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "AgUiAgent",
    "kind": "interface",
    "description": "The neutral Agent contract, widened with the AG-UI adapter's\n`customEvents` signal (the chat composition feature-detects it to enable\nlive a2ui streaming), the browser client-tools capability, and concrete\nACTIVITY-backed `subagents`.\nMirrors langgraph's LangGraphAgent extension where the protocol surfaces\noverlap.",
    "properties": [
      {
        "name": "clientTools",
        "type": "ClientToolsCapability",
        "description": "Optional: client-declared, client-executed tools (see ClientToolsCapability).",
        "optional": false
      },
      {
        "name": "customEvents",
        "type": "Signal<CustomStreamEvent[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "error",
        "type": "Signal<AgentError<> | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "events$",
        "type": "Observable<AgentEvent>",
        "description": "",
        "optional": false
      },
      {
        "name": "interrupt",
        "type": "Signal<AgentInterrupt | undefined>",
        "description": "",
        "optional": true
      },
      {
        "name": "isLoading",
        "type": "Signal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "messages",
        "type": "Signal<Message[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "regenerate",
        "type": "(assistantMessageIndex: number) => Promise<void>",
        "description": "Discards the assistant message at the given index AND all messages after\nit, then re-runs the agent against the trimmed conversation tail. The\npreceding user message (at index - 1) is preserved and re-submitted as\nthe agent's input. No new user message is added to the history.\n\nThrows if the message at `index` is not 'assistant' role, or if the\nagent is currently loading another response.",
        "optional": false
      },
      {
        "name": "retry",
        "type": "() => Promise<void>",
        "description": "Re-run the last submitted input after a failure. No-op if a run is already\n in flight or there is nothing to retry. Clears `error` and sets loading.",
        "optional": false
      },
      {
        "name": "state",
        "type": "Signal<TState>",
        "description": "",
        "optional": false
      },
      {
        "name": "status",
        "type": "Signal<AgentStatus>",
        "description": "",
        "optional": false
      },
      {
        "name": "stop",
        "type": "() => Promise<void>",
        "description": "",
        "optional": false
      },
      {
        "name": "subagents",
        "type": "Signal<Map<string, Subagent>>",
        "description": "Subagent activities (activityType==='subagent') projected to the neutral\n Subagent contract, keyed by messageId. Narrows the base Agent's optional\n `subagents?` to a concrete signal for AG-UI consumers.",
        "optional": false
      },
      {
        "name": "submit",
        "type": "(input: AgentSubmitInput, opts: AgentSubmitOptions) => Promise<void>",
        "description": "",
        "optional": false
      },
      {
        "name": "toolCalls",
        "type": "Signal<ToolCall[]>",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "CustomStreamEvent",
    "kind": "interface",
    "description": "A custom event surfaced to consumers via the agent's `customEvents` signal.\nMirrors the LangGraph adapter's CustomStreamEvent shape so the chat\na2ui partial-args bridge consumes both transports identically.",
    "properties": [
      {
        "name": "data",
        "type": "unknown",
        "description": "Arbitrary payload from the backend (JSON-string values are parsed).",
        "optional": false
      },
      {
        "name": "name",
        "type": "string",
        "description": "Event name set by the backend (e.g. 'a2ui-partial', 'state_update').",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "ToAgentOptions",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "a2uiClientCapabilities",
        "type": "object",
        "description": "A2UI client capabilities (catalog negotiation) to advertise to the agent.\nWhen set, they are seeded once into the AG-UI shared state under the\n`a2ui_client_capabilities` key, so every RunAgentInput.state carries them.\nUse `@threadplane/chat`'s `a2uiClientCapabilities()` for the renderer's\nstandard value.",
        "optional": true
      },
      {
        "name": "telemetry",
        "type": "false | AgentRuntimeTelemetrySink",
        "description": "Omit to enable automatic development-only collection. Set `false` to disable.\nAn app-owned sink replaces the automatic destination and receives the\nexisting runtime lifecycle callbacks.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "bridgeCitationsState",
    "kind": "function",
    "description": "Attach per-message Citations carried in an AG-UI thread's `state`\n(`state.citations`, keyed by message id) onto the corresponding assistant\nMessages — for advanced consumers wiring citations from STATE events\ninto the neutral chat contract.",
    "signature": "bridgeCitationsState(thread: ThreadStateLike, messages: Message[]): Message[]",
    "params": [
      {
        "name": "thread",
        "type": "ThreadStateLike",
        "description": "The thread-state container holding `state.citations`.",
        "optional": false
      },
      {
        "name": "messages",
        "type": "Message[]",
        "description": "The messages to enrich.",
        "optional": false
      }
    ],
    "returns": {
      "type": "Message[]",
      "description": ""
    },
    "examples": [
      "```ts\nconst enriched = bridgeCitationsState(threadState, agent.messages());\n```"
    ]
  },
  {
    "name": "injectAgent",
    "kind": "function",
    "description": "Injects the AG-UI agent from Angular's dependency injection container.\nUse this in components or services provided via `provideAgent()` (or\n`provideFakeAgent()`).\n\nReturns an `AgUiAgent` — the runtime-neutral `Agent` contract plus the\nAG-UI-specific `customEvents` signal — so `customEvents` is reachable\ndirectly, without casting.\n\n**Typed state via AgentRef.** Pass the same ref that was supplied to\n`provideAgent(ref, …)` to carry the state type through DI without repeating\nthe generic at every call site. The no-arg form defaults to\n`AgUiAgent<Record<string, unknown>>`.",
    "signature": "injectAgent(): AgUiAgent<>",
    "params": [],
    "returns": {
      "type": "AgUiAgent<>",
      "description": ""
    },
    "examples": [
      "```ts\nconst agent = injectAgent(TRIP); // AgUiAgent<TripState>\n```"
    ]
  },
  {
    "name": "provideAgent",
    "kind": "function",
    "description": "Provides an Agent instance wired through HttpAgent and toAgent.\nConstructs an HttpAgent from config and wraps it in the runtime-neutral\nAgent contract via toAgent(). Returns a provider array suitable for\nbootstrapApplication or TestBed.configureTestingModule().\n\n**Static vs factory config.** Pass a plain `AgentConfig` object when the\nconfig is known up front. Pass a `() => AgentConfig` factory when the config\ndepends on runtime/DI state — the factory runs inside an Angular injection\ncontext, so it may call `inject()` to read services or route params.\n\n**Typed state via AgentRef.** Pass a typed ref as the first argument to flow\nthe state shape from `provideAgent` to `injectAgent` without repeating the\ngeneric at every call site.\n\n**Several agents at one injector level.** Each `provideAgent(ref, …)` call\nbuilds its own agent, so two (or more) refs may be provided side by side in a\nsingle `providers` array and `injectAgent(refA)` / `injectAgent(refB)` return\ndistinct agents. The ref-less `injectAgent()` resolves a single shared token,\nwhich can only point at one of them: when more than one ref is provided at\nthe same level the **last** call wins. Always inject by ref when an injector\nprovides more than one agent.",
    "signature": "provideAgent(ref: AgentRef<T>, configOrFactory: AgentConfig | () => AgentConfig): Provider[]",
    "params": [
      {
        "name": "ref",
        "type": "AgentRef<T>",
        "description": "",
        "optional": false
      },
      {
        "name": "configOrFactory",
        "type": "AgentConfig | () => AgentConfig",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "Provider[]",
      "description": ""
    },
    "examples": [
      "```ts\ninterface TripState { day: number; places: string[]; }\nexport const TRIP = createAgentRef<TripState>('trip');\n// app.config.ts:\nproviders: [provideAgent(TRIP, { url: 'http://localhost:8000/agent' })]\n// component:\nconst agent = injectAgent(TRIP); // AgUiAgent<TripState>\n```"
    ]
  },
  {
    "name": "provideFakeAgent",
    "kind": "function",
    "description": "Registers an in-process FakeAgent under AGENT.\n\nUse for offline demos and development. Drop-in replacement for\nprovideAgent({ url }) when no real backend is available.",
    "signature": "provideFakeAgent(config: FakeAgentConfig): Provider[]",
    "params": [
      {
        "name": "config",
        "type": "FakeAgentConfig",
        "description": "",
        "optional": true
      }
    ],
    "returns": {
      "type": "Provider[]",
      "description": ""
    },
    "examples": [
      "```ts\nTestBed.configureTestingModule({\n  providers: [provideFakeAgent({ tokens: ['Hello from the fake agent'] })],\n});\n```"
    ]
  },
  {
    "name": "toAgent",
    "kind": "function",
    "description": "Wraps an AG-UI AbstractAgent into the runtime-neutral Agent contract.\n\nThe adapter subscribes to source.subscribe({ onEvent }) and reduces every\nevent into the produced Agent's signals. submit() optimistically appends the\nuser message to both our signals and the source agent's internal message\nlist, then calls source.runAgent(). stop() calls source.abortRun().\n\nSubscription cleanup: the returned Agent does NOT manage its own lifetime.\nCallers using DI should rely on the provider's destroy hook; direct callers\nof toAgent() should treat the returned object's lifecycle as tied to the\nagent instance they constructed. The subscriber registered via\nsource.subscribe() will fire for the lifetime of source.",
    "signature": "toAgent(source: AbstractAgent<>, options: ToAgentOptions): AgUiAgent<>",
    "params": [
      {
        "name": "source",
        "type": "AbstractAgent<>",
        "description": "",
        "optional": false
      },
      {
        "name": "options",
        "type": "ToAgentOptions",
        "description": "",
        "optional": true
      }
    ],
    "returns": {
      "type": "AgUiAgent<>",
      "description": ""
    },
    "examples": [
      "```ts\nimport { HttpAgent } from '@ag-ui/client';\nimport { toAgent } from '@threadplane/ag-ui';\n\nconst agent = toAgent(new HttpAgent({ url: '/api/agent' }));\n```"
    ]
  }
]

### chat

[
  {
    "name": "A2uiAudioPlayerComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "bindings",
        "type": "InputSignal<Record<string, string>>",
        "description": "",
        "optional": false
      },
      {
        "name": "childKeys",
        "type": "InputSignal<string[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "description",
        "type": "InputSignal<string>",
        "description": "v0.9 prop: short description / title rendered above the player.",
        "optional": false
      },
      {
        "name": "emit",
        "type": "InputSignal<(event: string) => void>",
        "description": "",
        "optional": false
      },
      {
        "name": "loading",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "spec",
        "type": "InputSignal<Spec | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "url",
        "type": "InputSignal<string>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "A2uiButtonComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "bindings",
        "type": "InputSignal<Record<string, string>>",
        "description": "",
        "optional": false
      },
      {
        "name": "childKeys",
        "type": "InputSignal<string[]>",
        "description": "v0.9: child Text component is rendered inside the button via childKeys.",
        "optional": false
      },
      {
        "name": "disabled",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "emit",
        "type": "InputSignal<(event: string) => void>",
        "description": "",
        "optional": false
      },
      {
        "name": "loading",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "spec",
        "type": "InputSignal<Spec>",
        "description": "",
        "optional": false
      },
      {
        "name": "variant",
        "type": "InputSignal<ButtonVariant>",
        "description": "v0.9 prop: visual style (default 'default').",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "cssClass",
        "signature": "cssClass(): string",
        "description": "",
        "params": []
      },
      {
        "name": "handleClick",
        "signature": "handleClick(): void",
        "description": "",
        "params": []
      }
    ]
  },
  {
    "name": "A2uiCardComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "bindings",
        "type": "InputSignal<Record<string, string>>",
        "description": "",
        "optional": false
      },
      {
        "name": "childKeys",
        "type": "InputSignal<string[]>",
        "description": "v1: a single child key, delivered via childKeys[0] from the render framework.",
        "optional": false
      },
      {
        "name": "emit",
        "type": "InputSignal<(event: string) => void>",
        "description": "",
        "optional": false
      },
      {
        "name": "loading",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "spec",
        "type": "InputSignal<Spec>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "A2uiCheckBoxComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "_bindings",
        "type": "InputSignal<Record<string, string>>",
        "description": "",
        "optional": false
      },
      {
        "name": "bindings",
        "type": "InputSignal<Record<string, string>>",
        "description": "",
        "optional": false
      },
      {
        "name": "childKeys",
        "type": "InputSignal<string[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "errorText",
        "type": "InputSignal<string>",
        "description": "Live validation message written by the surface's check gate\n(bound to /_a2uiChecks/<id>); empty when valid.",
        "optional": false
      },
      {
        "name": "label",
        "type": "InputSignal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "loading",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "spec",
        "type": "InputSignal<Spec | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "value",
        "type": "InputSignal<boolean>",
        "description": "v0.9 prop: boolean checked state.",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "onChange",
        "signature": "onChange(event: Event): void",
        "description": "",
        "params": [
          {
            "name": "event",
            "type": "Event",
            "description": "",
            "optional": false
          }
        ]
      }
    ]
  },
  {
    "name": "A2uiChoicePickerComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "_bindings",
        "type": "InputSignal<Record<string, string>>",
        "description": "",
        "optional": false
      },
      {
        "name": "_groupName",
        "type": "string",
        "description": "Groups the radio inputs of this instance (mutuallyExclusive mode).",
        "optional": false
      },
      {
        "name": "bindings",
        "type": "InputSignal<Record<string, string>>",
        "description": "",
        "optional": false
      },
      {
        "name": "childKeys",
        "type": "InputSignal<string[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "displayStyle",
        "type": "InputSignal<\"checkbox\" | \"chips\">",
        "description": "v0.9 prop: render as 'checkbox' rows (default) or 'chips'.",
        "optional": false
      },
      {
        "name": "errorText",
        "type": "InputSignal<string>",
        "description": "Live validation message written by the surface's check gate\n(bound to /_a2uiChecks/<id>); empty when valid.",
        "optional": false
      },
      {
        "name": "filterable",
        "type": "InputSignal<boolean>",
        "description": "v0.9 prop: when true, show a client-side option filter input.",
        "optional": false
      },
      {
        "name": "filterText",
        "type": "WritableSignal<string>",
        "description": "Local, client-side option filter (only rendered when filterable).",
        "optional": false
      },
      {
        "name": "isSingleSelect",
        "type": "Signal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "label",
        "type": "InputSignal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "loading",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "options",
        "type": "InputSignal<ResolvedOption[]>",
        "description": "Resolved options with plain string labels (surface-to-spec resolves DynamicString).",
        "optional": false
      },
      {
        "name": "spec",
        "type": "InputSignal<Spec | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "value",
        "type": "InputSignal<string | string[] | undefined>",
        "description": "v0.9 prop: current selection (string[]). Normalized in `valueArray`\nbecause LLMs sometimes seed the data model with a scalar (e.g. `\"5\"`)\ninstead of an array (`[\"5\"]`); we coerce so .includes() works either way.",
        "optional": false
      },
      {
        "name": "valueArray",
        "type": "Signal<string[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "variant",
        "type": "InputSignal<\"mutuallyExclusive\" | \"multipleSelection\">",
        "description": "v0.9 prop: 'mutuallyExclusive' (single-select, default) or 'multipleSelection'.",
        "optional": false
      },
      {
        "name": "visibleOptions",
        "type": "Signal<ResolvedOption[]>",
        "description": "",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "isSelected",
        "signature": "isSelected(value: string): boolean",
        "description": "",
        "params": [
          {
            "name": "value",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onCheckChange",
        "signature": "onCheckChange(value: string, event: Event): void",
        "description": "",
        "params": [
          {
            "name": "value",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "event",
            "type": "Event",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onChipToggle",
        "signature": "onChipToggle(value: string): void",
        "description": "",
        "params": [
          {
            "name": "value",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onFilterInput",
        "signature": "onFilterInput(event: Event): void",
        "description": "",
        "params": [
          {
            "name": "event",
            "type": "Event",
            "description": "",
            "optional": false
          }
        ]
      }
    ]
  },
  {
    "name": "A2uiColumnComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "align",
        "type": "InputSignal<ColumnAlign>",
        "description": "v0.9 prop: cross-axis alignment (default 'stretch').",
        "optional": false
      },
      {
        "name": "alignItems",
        "type": "Signal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "bindings",
        "type": "InputSignal<Record<string, string>>",
        "description": "",
        "optional": false
      },
      {
        "name": "childKeys",
        "type": "InputSignal<string[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "cssClass",
        "type": "Signal<\"a2ui-col a2ui-col--justify-stretch\" | \"a2ui-col\">",
        "description": "",
        "optional": false
      },
      {
        "name": "emit",
        "type": "InputSignal<(event: string) => void>",
        "description": "",
        "optional": false
      },
      {
        "name": "gap",
        "type": "InputSignal<number | \"small\" | \"medium\" | \"large\" | undefined>",
        "description": "Not part of the v0.9 catalog — kept for json-render generative-ui\nspecs, which may set a numeric spacing unit (multiples of 4px) or a\nnamed size. Unset falls back to the CSS default gap.",
        "optional": false
      },
      {
        "name": "gapPx",
        "type": "Signal<number | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "justify",
        "type": "InputSignal<ColumnJustify>",
        "description": "v0.9 prop: main-axis distribution (default 'start').",
        "optional": false
      },
      {
        "name": "justifyContent",
        "type": "Signal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "loading",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "spec",
        "type": "InputSignal<Spec>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "A2uiDateTimeInputComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "_bindings",
        "type": "InputSignal<Record<string, string>>",
        "description": "",
        "optional": false
      },
      {
        "name": "_inputId",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "bindings",
        "type": "InputSignal<Record<string, string>>",
        "description": "",
        "optional": false
      },
      {
        "name": "childKeys",
        "type": "InputSignal<string[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "enableDate",
        "type": "InputSignal<boolean>",
        "description": "v0.9 prop: enableDate — include date portion.",
        "optional": false
      },
      {
        "name": "enableTime",
        "type": "InputSignal<boolean>",
        "description": "v0.9 prop: enableTime — include time portion.",
        "optional": false
      },
      {
        "name": "errorText",
        "type": "InputSignal<string>",
        "description": "Live validation message written by the surface's check gate\n(bound to /_a2uiChecks/<id>); empty when valid.",
        "optional": false
      },
      {
        "name": "htmlInputType",
        "type": "Signal<string>",
        "description": "Derives HTML input type from enableDate + enableTime.",
        "optional": false
      },
      {
        "name": "label",
        "type": "InputSignal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "loading",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "max",
        "type": "InputSignal<string | undefined>",
        "description": "v0.9 prop: ISO upper bound mapped to the native input's max.",
        "optional": false
      },
      {
        "name": "min",
        "type": "InputSignal<string | undefined>",
        "description": "v0.9 prop: ISO lower bound mapped to the native input's min.",
        "optional": false
      },
      {
        "name": "spec",
        "type": "InputSignal<Spec | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "value",
        "type": "InputSignal<string>",
        "description": "v0.9 prop: ISO 8601 value (resolved DynamicString). Still renders when absent.",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "onChange",
        "signature": "onChange(event: Event): void",
        "description": "",
        "params": [
          {
            "name": "event",
            "type": "Event",
            "description": "",
            "optional": false
          }
        ]
      }
    ]
  },
  {
    "name": "A2uiDividerComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "axis",
        "type": "InputSignal<\"horizontal\" | \"vertical\">",
        "description": "v0.9 prop: divider axis (default 'horizontal').",
        "optional": false
      },
      {
        "name": "bindings",
        "type": "InputSignal<Record<string, string>>",
        "description": "",
        "optional": false
      },
      {
        "name": "childKeys",
        "type": "InputSignal<string[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "emit",
        "type": "InputSignal<(event: string) => void>",
        "description": "",
        "optional": false
      },
      {
        "name": "loading",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "orientation",
        "type": "Signal<\"horizontal\" | \"vertical\">",
        "description": "",
        "optional": false
      },
      {
        "name": "spec",
        "type": "InputSignal<Spec | undefined>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "A2uiIconComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "bindings",
        "type": "InputSignal<Record<string, string>>",
        "description": "",
        "optional": false
      },
      {
        "name": "childKeys",
        "type": "InputSignal<string[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "emit",
        "type": "InputSignal<(event: string) => void>",
        "description": "",
        "optional": false
      },
      {
        "name": "glyphName",
        "type": "Signal<string>",
        "description": "The effective name as a Material Symbols ligature (camelCase → snake_case).",
        "optional": false
      },
      {
        "name": "ligatureName",
        "type": "Signal<string>",
        "description": "The string ligature name when `name` is a string.",
        "optional": false
      },
      {
        "name": "loading",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "name",
        "type": "InputSignal<string | object | undefined>",
        "description": "v0.9 prop: a Material Symbols name (string) or an inline `{ svgPath }`.",
        "optional": false
      },
      {
        "name": "spec",
        "type": "InputSignal<Spec | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "svgPath",
        "type": "Signal<string | null>",
        "description": "Inline SVG path when `name` is the `{ svgPath }` object form.",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "A2uiImageComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "bindings",
        "type": "InputSignal<Record<string, string>>",
        "description": "",
        "optional": false
      },
      {
        "name": "childKeys",
        "type": "InputSignal<string[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "cssClass",
        "type": "Signal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "description",
        "type": "InputSignal<string>",
        "description": "v0.9 prop: alt text / accessible description.",
        "optional": false
      },
      {
        "name": "emit",
        "type": "InputSignal<(event: string) => void>",
        "description": "",
        "optional": false
      },
      {
        "name": "fit",
        "type": "InputSignal<ImageFit>",
        "description": "v0.9 prop: CSS object-fit equivalent ('scaleDown' → 'scale-down').",
        "optional": false
      },
      {
        "name": "loading",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "objectFit",
        "type": "Signal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "spec",
        "type": "InputSignal<Spec | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "url",
        "type": "InputSignal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "variant",
        "type": "InputSignal<ImageVariant>",
        "description": "v0.9 prop: sizing preset.",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "A2uiListComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "align",
        "type": "InputSignal<\"start\" | \"center\" | \"end\" | \"stretch\">",
        "description": "v0.9 prop: cross-axis alignment (default 'stretch').",
        "optional": false
      },
      {
        "name": "alignmentCss",
        "type": "Signal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "bindings",
        "type": "InputSignal<Record<string, string>>",
        "description": "",
        "optional": false
      },
      {
        "name": "childKeys",
        "type": "InputSignal<string[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "direction",
        "type": "InputSignal<\"horizontal\" | \"vertical\">",
        "description": "",
        "optional": false
      },
      {
        "name": "emit",
        "type": "InputSignal<(event: string) => void>",
        "description": "",
        "optional": false
      },
      {
        "name": "listClass",
        "type": "Signal<\"a2ui-list--horizontal\" | \"a2ui-list--vertical\">",
        "description": "",
        "optional": false
      },
      {
        "name": "loading",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "spec",
        "type": "InputSignal<Spec>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "A2uiModalComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "bindings",
        "type": "InputSignal<Record<string, string>>",
        "description": "",
        "optional": false
      },
      {
        "name": "childKeys",
        "type": "InputSignal<string[]>",
        "description": "v0.9: childKeys[0] = trigger (inline entry point),\n      childKeys[1] = content (modal body).",
        "optional": false
      },
      {
        "name": "contentKey",
        "type": "Signal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "emit",
        "type": "InputSignal<(event: string) => void>",
        "description": "",
        "optional": false
      },
      {
        "name": "entryPointKey",
        "type": "Signal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "loading",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "open",
        "type": "WritableSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "spec",
        "type": "InputSignal<Spec>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "A2uiRowComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "align",
        "type": "InputSignal<RowAlign>",
        "description": "v0.9 prop: cross-axis alignment (default 'stretch').",
        "optional": false
      },
      {
        "name": "alignItems",
        "type": "Signal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "bindings",
        "type": "InputSignal<Record<string, string>>",
        "description": "",
        "optional": false
      },
      {
        "name": "childKeys",
        "type": "InputSignal<string[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "cssClass",
        "type": "Signal<\"a2ui-row a2ui-row--justify-stretch\" | \"a2ui-row\">",
        "description": "",
        "optional": false
      },
      {
        "name": "emit",
        "type": "InputSignal<(event: string) => void>",
        "description": "",
        "optional": false
      },
      {
        "name": "gap",
        "type": "InputSignal<number | \"small\" | \"medium\" | \"large\" | undefined>",
        "description": "Not part of the v0.9 catalog — kept for json-render generative-ui\nspecs, which may set a numeric spacing unit (multiples of 4px) or a\nnamed size. Unset falls back to the CSS default gap.",
        "optional": false
      },
      {
        "name": "gapPx",
        "type": "Signal<number | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "justify",
        "type": "InputSignal<RowJustify>",
        "description": "v0.9 prop: main-axis distribution (default 'start').",
        "optional": false
      },
      {
        "name": "justifyContent",
        "type": "Signal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "loading",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "spec",
        "type": "InputSignal<Spec>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "A2uiSliderComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "_bindings",
        "type": "InputSignal<Record<string, string>>",
        "description": "",
        "optional": false
      },
      {
        "name": "_inputId",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "bindings",
        "type": "InputSignal<Record<string, string>>",
        "description": "",
        "optional": false
      },
      {
        "name": "childKeys",
        "type": "InputSignal<string[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "errorText",
        "type": "InputSignal<string>",
        "description": "Live validation message written by the surface's check gate\n(bound to /_a2uiChecks/<id>); empty when valid.",
        "optional": false
      },
      {
        "name": "label",
        "type": "InputSignal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "loading",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "max",
        "type": "InputSignal<number>",
        "description": "v0.9 prop: upper bound.",
        "optional": false
      },
      {
        "name": "min",
        "type": "InputSignal<number>",
        "description": "v0.9 prop: lower bound (default 0).",
        "optional": false
      },
      {
        "name": "spec",
        "type": "InputSignal<Spec | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "value",
        "type": "InputSignal<number>",
        "description": "v0.9 prop: value (resolved DynamicNumber).",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "onInput",
        "signature": "onInput(event: Event): void",
        "description": "",
        "params": [
          {
            "name": "event",
            "type": "Event",
            "description": "",
            "optional": false
          }
        ]
      }
    ]
  },
  {
    "name": "A2uiSurfaceComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "action",
        "type": "OutputEmitterRef<A2uiActionMessage>",
        "description": "",
        "optional": false
      },
      {
        "name": "agentDisplayName",
        "type": "Signal<string | null>",
        "description": "Agent identity chrome from `createSurface.theme`. When neither\n`agentDisplayName` nor `iconUrl` is set, no header renders at all\n(zero layout impact for themeless surfaces — the common case).",
        "optional": false
      },
      {
        "name": "catalog",
        "type": "InputSignal<Readonly<Record<string, Type<unknown> | RenderViewEntry>> | Readonly<Record<string, Type<unknown> | RenderViewEntry>>>",
        "description": "",
        "optional": false
      },
      {
        "name": "events",
        "type": "OutputEmitterRef<RenderEvent>",
        "description": "",
        "optional": false
      },
      {
        "name": "handlers",
        "type": "InputSignal<Record<string, (params: Record<string, unknown>) => unknown>>",
        "description": "",
        "optional": false
      },
      {
        "name": "iconUrl",
        "type": "Signal<string | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "internalHandlers",
        "type": "Signal<object>",
        "description": "Merge built-in A2UI handlers with consumer-provided handlers.",
        "optional": false
      },
      {
        "name": "liveStore",
        "type": "StateStore",
        "description": "Surface-owned live state store: `$bindState` props read it and input\ncomponents write user edits into it, so event-time logic (checks,\naction context) sees CURRENT values instead of the agent-seeded\nsnapshot. Seeded from spec.state with user edits preserved. Public so\nhosts (and tests) can read the live values of a rendered surface.",
        "optional": false
      },
      {
        "name": "primaryColor",
        "type": "Signal<string | null>",
        "description": "Agent-set primary color from `createSurface.theme.primaryColor`.\nReturns null when unset so the host binding doesn't override the\nconsumer's `:root`-level `--a2ui-primary` default.",
        "optional": false
      },
      {
        "name": "registry",
        "type": "Signal<AngularRegistry>",
        "description": "Convert ViewRegistry to AngularRegistry for RenderSpecComponent.",
        "optional": false
      },
      {
        "name": "rootIds",
        "type": "Signal<string[]>",
        "description": "Roots from the surface state. The v0.9 wire contract reserves the\ncomponent id `root` as the single tree root; we keep the renderer\npermissive in case future surfaces emit multiple top-level\ncomponents.\n\nConservative: returns only the first key from componentViews\ninsertion order.",
        "optional": false
      },
      {
        "name": "spec",
        "type": "Signal<Spec | null>",
        "description": "Convert the A2UI surface to a json-render Spec for rendering.\n Prefers `state().surface` (the progressively-built wire surface)\n over the legacy `surface` input. surfaceToSpec handles\n children-id-list → spec.children translation + reserved-key\n filtering + path-ref → $bindState rewriting; the rendered tree\n then uses render-element's standard input-mapping\n (`childKeys: el.children`) so catalog components receive the\n inputs they actually declare.\n\n This supersedes the earlier slot-based progressive renderer,\n which mounted root components but never populated their\n childKeys input — leaving Columns/Rows/etc. with no children.",
        "optional": false
      },
      {
        "name": "state",
        "type": "InputSignal<A2uiSurfaceState | undefined>",
        "description": "Chat-side surface state with per-component readiness. When set,\nthis takes priority and the progressive renderer is used.",
        "optional": false
      },
      {
        "name": "surface",
        "type": "InputSignal<any>",
        "description": "Wire-format surface (legacy path — kept for backwards compat).",
        "optional": false
      },
      {
        "name": "surfaceFallback",
        "type": "InputSignal<Type<unknown> | undefined>",
        "description": "Optional top-level placeholder when the surface has no components\nyet. Defaults to A2uiDefaultFallbackComponent.",
        "optional": false
      },
      {
        "name": "validationError",
        "type": "OutputEmitterRef<A2uiErrorMessage>",
        "description": "Emitted when a submit is blocked by failing validation checks —\nthe spec client → agent error message (code VALIDATION_FAILED).",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "onRenderEvent",
        "signature": "onRenderEvent(event: RenderEvent): void",
        "description": "",
        "params": [
          {
            "name": "event",
            "type": "RenderEvent",
            "description": "",
            "optional": false
          }
        ]
      }
    ]
  },
  {
    "name": "A2uiTabsComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "activeChildKey",
        "type": "Signal<string | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "activeIndex",
        "type": "WritableSignal<number>",
        "description": "",
        "optional": false
      },
      {
        "name": "bindings",
        "type": "InputSignal<Record<string, string>>",
        "description": "",
        "optional": false
      },
      {
        "name": "childKeys",
        "type": "InputSignal<string[]>",
        "description": "v0.9: each child key corresponds to a tab's child (childKeys[i] ↔ tabTitles[i]).",
        "optional": false
      },
      {
        "name": "emit",
        "type": "InputSignal<(event: string) => void>",
        "description": "",
        "optional": false
      },
      {
        "name": "loading",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "spec",
        "type": "InputSignal<Spec>",
        "description": "",
        "optional": false
      },
      {
        "name": "tabTitles",
        "type": "InputSignal<string[]>",
        "description": "Resolved tab titles from tabs[*].title — produced by surface-to-spec.",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "selectTab",
        "signature": "selectTab(index: number): void",
        "description": "",
        "params": [
          {
            "name": "index",
            "type": "number",
            "description": "",
            "optional": false
          }
        ]
      }
    ]
  },
  {
    "name": "A2uiTextComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "bindings",
        "type": "InputSignal<Record<string, string>>",
        "description": "",
        "optional": false
      },
      {
        "name": "childKeys",
        "type": "InputSignal<string[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "emit",
        "type": "InputSignal<(event: string) => void>",
        "description": "",
        "optional": false
      },
      {
        "name": "loading",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "spec",
        "type": "InputSignal<Spec | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "text",
        "type": "InputSignal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "variant",
        "type": "InputSignal<TextVariant>",
        "description": "v0.9 prop: typography variant.",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "cssClass",
        "signature": "cssClass(): string",
        "description": "",
        "params": []
      }
    ]
  },
  {
    "name": "A2uiTextFieldComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "_bindings",
        "type": "InputSignal<Record<string, string>>",
        "description": "",
        "optional": false
      },
      {
        "name": "_inputId",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "bindings",
        "type": "InputSignal<Record<string, string>>",
        "description": "",
        "optional": false
      },
      {
        "name": "childKeys",
        "type": "InputSignal<string[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "errorText",
        "type": "InputSignal<string>",
        "description": "Live validation message written by the surface's check gate\n(bound to /_a2uiChecks/<id>); empty when valid.",
        "optional": false
      },
      {
        "name": "htmlInputType",
        "type": "Signal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "label",
        "type": "InputSignal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "loading",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "placeholder",
        "type": "InputSignal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "spec",
        "type": "InputSignal<Spec | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "validationRegexp",
        "type": "InputSignal<string>",
        "description": "Enforced by the surface's check gate as an implicit regex rule (plus the native pattern attribute).",
        "optional": false
      },
      {
        "name": "value",
        "type": "InputSignal<string>",
        "description": "v0.9 prop: resolved string value.",
        "optional": false
      },
      {
        "name": "variant",
        "type": "InputSignal<TextFieldVariant>",
        "description": "v0.9 prop: input variant (default 'shortText').",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "onInput",
        "signature": "onInput(event: Event): void",
        "description": "",
        "params": [
          {
            "name": "event",
            "type": "Event",
            "description": "",
            "optional": false
          }
        ]
      }
    ]
  },
  {
    "name": "A2uiVideoComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "bindings",
        "type": "InputSignal<Record<string, string>>",
        "description": "",
        "optional": false
      },
      {
        "name": "childKeys",
        "type": "InputSignal<string[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "emit",
        "type": "InputSignal<(event: string) => void>",
        "description": "",
        "optional": false
      },
      {
        "name": "loading",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "spec",
        "type": "InputSignal<Spec | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "url",
        "type": "InputSignal<string>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "AgentError",
    "kind": "class",
    "description": "Structured, classified failure surfaced on `Agent.error`. Extends `Error`, so\nexisting `.message` / `instanceof Error` reads keep working — but adds a\nmachine-readable AgentErrorKind, a `retryable` flag, an optional HTTP\n`status`, and the original `cause`.\n\nYou rarely construct one yourself; adapters normalize raw failures via\ntoAgentError. Read it off the agent to render legible, cause-specific UI:",
    "params": [
      {
        "name": "init",
        "type": "object",
        "description": "",
        "optional": false
      }
    ],
    "examples": [
      "```ts\nconst err = agent.error();            // AgentError | undefined\nif (err) {\n  console.warn(err.message);          // legible, per-kind copy\n  if (err.kind === 'auth') showApiKeyHelp();\n  if (err.retryable) showRetryButton(); // → agent.retry()\n}\n```"
    ],
    "properties": [
      {
        "name": "cause",
        "type": "unknown",
        "description": "The original raw error this was classified from, preserved for debugging/telemetry.",
        "optional": false
      },
      {
        "name": "kind",
        "type": "AgentErrorKind",
        "description": "The classified failure type. See AgentErrorKind.",
        "optional": false
      },
      {
        "name": "message",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "name",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "retryable",
        "type": "boolean",
        "description": "Whether retrying the same request could plausibly succeed:\n `connection` | `server` (5xx) | `interrupted` → true; `auth` | `aborted` | non-auth `4xx` → false.",
        "optional": false
      },
      {
        "name": "stack",
        "type": "string",
        "description": "",
        "optional": true
      },
      {
        "name": "status",
        "type": "number",
        "description": "The HTTP status code when the failure came from an HTTP response.",
        "optional": true
      }
    ],
    "methods": []
  },
  {
    "name": "ChatApprovalCardComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "action",
        "type": "OutputEmitterRef<ChatApprovalAction>",
        "description": "",
        "optional": false
      },
      {
        "name": "agent",
        "type": "InputSignal<Agent<unknown>>",
        "description": "",
        "optional": false
      },
      {
        "name": "bodyTemplate",
        "type": "Signal<TemplateRef<unknown> | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "matchKind",
        "type": "InputSignal<string | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "payload",
        "type": "Signal<object | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "showEdit",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "title",
        "type": "InputSignal<string>",
        "description": "",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "emit",
        "signature": "emit(action: ChatApprovalAction): void",
        "description": "",
        "params": [
          {
            "name": "action",
            "type": "ChatApprovalAction",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onCancelEvent",
        "signature": "onCancelEvent(ev: Event): void",
        "description": "",
        "params": [
          {
            "name": "ev",
            "type": "Event",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onDialogClose",
        "signature": "onDialogClose(): void",
        "description": "",
        "params": []
      }
    ]
  },
  {
    "name": "ChatCitationCardTemplateDirective",
    "kind": "class",
    "description": "ContentChild template directive for custom citation card rendering.\nUsage: <ng-template chatCitationCard let-citation>...</ng-template>",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "tpl",
        "type": "TemplateRef<object>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "ChatCitationPreviewComponent",
    "kind": "class",
    "description": "Presentational provenance card for a single Citation. Rendered inside the\ninline marker's connected-overlay pane (hover/tap preview) — self-contained\nso its encapsulated styles apply even when portaled to the body-level pane.",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "citation",
        "type": "InputSignal<Citation>",
        "description": "",
        "optional": false
      },
      {
        "name": "domain",
        "type": "Signal<string | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "published",
        "type": "Signal<string | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "sourceIcon",
        "type": "Signal<CitationTypeIcon | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "sourceIconUrl",
        "type": "Signal<string | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "sourceMonoColor",
        "type": "Signal<string | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "sourceMonogram",
        "type": "Signal<string | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "typeLabel",
        "type": "Signal<string | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "typeTone",
        "type": "Signal<CitationTypeIcon>",
        "description": "",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "isTypeTone",
        "signature": "isTypeTone(tone: CitationTypeIcon): boolean",
        "description": "",
        "params": [
          {
            "name": "tone",
            "type": "CitationTypeIcon",
            "description": "",
            "optional": false
          }
        ]
      }
    ]
  },
  {
    "name": "ChatCitationsCardComponent",
    "kind": "class",
    "description": "Sources-panel detail card: index badge, favicon/monogram + domain + type,\ntitle, one-line snippet. Renders as an <a> (opens the source) when a url is\npresent, otherwise a non-interactive <div>. Shares the panel style module.",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "citation",
        "type": "InputSignal<Citation>",
        "description": "",
        "optional": false
      },
      {
        "name": "domain",
        "type": "Signal<string | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "sourceIcon",
        "type": "Signal<CitationTypeIcon | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "sourceIconUrl",
        "type": "Signal<string | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "sourceMonoColor",
        "type": "Signal<string | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "sourceMonogram",
        "type": "Signal<string | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "title",
        "type": "Signal<string | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "typeLabel",
        "type": "Signal<string | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "typeTone",
        "type": "Signal<CitationTypeIcon>",
        "description": "",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "isTypeTone",
        "signature": "isTypeTone(tone: CitationTypeIcon): boolean",
        "description": "",
        "params": [
          {
            "name": "tone",
            "type": "CitationTypeIcon",
            "description": "",
            "optional": false
          }
        ]
      }
    ]
  },
  {
    "name": "ChatCitationsComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "cardTpl",
        "type": "ChatCitationCardTemplateDirective<> | null",
        "description": "",
        "optional": false
      },
      {
        "name": "citations",
        "type": "Signal<Citation[]>",
        "description": "Combined citation list:\n  1. Message.citations (provider-populated, takes precedence by id)\n  2. Markdown sidecar defs (Pandoc [^id]: lines), merged for unseen ids.\nSorted by index ascending.",
        "optional": false
      },
      {
        "name": "expanded",
        "type": "WritableSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "favstack",
        "type": "Signal<FavEntry[]>",
        "description": "First 3 sources, mapped to favicon/monogram chips for the header preview.",
        "optional": false
      },
      {
        "name": "heading",
        "type": "InputSignal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "listId",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "message",
        "type": "InputSignal<Message>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "ChatComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "activeThreadId",
        "type": "InputSignal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "agent",
        "type": "InputSignal<Agent<unknown>>",
        "description": "",
        "optional": false
      },
      {
        "name": "clientToolContinuationLimit",
        "type": "OutputEmitterRef<ClientToolContinuationLimitEvent>",
        "description": "",
        "optional": false
      },
      {
        "name": "clientToolContinuationPolicy",
        "type": "InputSignal<ClientToolContinuationPolicy | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "clientToolExecutionGuard",
        "type": "InputSignal<ClientToolExecutionGuard | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "clientTools",
        "type": "InputSignal<Readonly<Record<string, ClientToolDef>> | undefined>",
        "description": "Client-declared tools (`view`/`ask`/`function`) the model may call. When\nprovided, a coordinator ships their catalog to the agent, runs `function`\ntools in the browser, and renders/resolves `view`/`ask` tools through the\nsame tool-views pipeline as `views`. Additive — leave undefined for the\nclassic server-tools-only experience.",
        "optional": false
      },
      {
        "name": "currentAssistantStreaming",
        "type": "Signal<boolean>",
        "description": "True iff the current (last-index) assistant message owns an active\ndelivery generation. The bubble's own caret already signals loading;\nwe suppress the floor typing-indicator in that case so the user\ndoesn't see two loading affordances at once.\n\nMatches the same `streaming + current` condition the bubble uses\nto enable `.chat-message__caret`.\n\nRestricted to assistant role because the caret only renders on\nassistant bubbles (`:host([data-role=\"assistant\"][data-current=...\n ][data-streaming=...])`).",
        "optional": false
      },
      {
        "name": "effectiveViews",
        "type": "Signal<Readonly<Record<string, Type<unknown> | RenderViewEntry>> | undefined>",
        "description": "The view registry actually used for rendering tool-views and for\nexcluding view-backed tool names from default tool-call cards. Merges\nthe coordinator's `view`/`ask` components (keyed by tool name) into the\nuser-supplied `views()` so client-declared component tools render through\nthe same pipeline. Falls back to `views()` when no client tools exist.",
        "optional": false
      },
      {
        "name": "excludedToolNames",
        "type": "Signal<readonly string[]>",
        "description": "Union of GenUI dispatcher tool names and registered view tool names.",
        "optional": false
      },
      {
        "name": "genuiToolNames",
        "type": "InputSignal<readonly string[]>",
        "description": "Tool names whose calls produce a rendered GenUI surface rather than\nvisible text. Used to (a) filter <chat-tool-calls> so internal\ndispatchers don't render args JSON as cards, and (b) detect\n\"this is a GenUI turn\" for the building-UI skeleton.\nDefault covers the canonical A2UI + json-render schema tools.",
        "optional": false
      },
      {
        "name": "handlers",
        "type": "InputSignal<Record<string, (params: Record<string, unknown>) => unknown>>",
        "description": "",
        "optional": false
      },
      {
        "name": "liveSurfaceStore",
        "type": "A2uiSurfaceStore",
        "description": "Shared A2UI surface store fed by the live partial-args bridge. The\ncontent-classifier path will share this store via tool_call_id\nshort-circuit (skipping re-dispatch for live tool_call_ids).",
        "optional": false
      },
      {
        "name": "messageContent",
        "type": "(message: BaseMessage<>) => string",
        "description": "",
        "optional": false
      },
      {
        "name": "messageCopy",
        "type": "OutputEmitterRef<object>",
        "description": "Emitted when the user copies an assistant message.",
        "optional": false
      },
      {
        "name": "modelOptions",
        "type": "InputSignal<readonly ChatSelectOption[]>",
        "description": "High-level model-picker API. When `modelOptions` is non-empty, the chat\ncomposition renders a `<chat-select>` inside the input pill (in BOTH\nwelcome and conversation modes), wired to the two-way `selectedModel`\nmodel. Consumers who want full control should leave `modelOptions`\nempty and project a `<chat-select chatInputModelSelect>` themselves.",
        "optional": false
      },
      {
        "name": "modelPickerPlaceholder",
        "type": "InputSignal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "pinned",
        "type": "WritableSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "rate",
        "type": "OutputEmitterRef<object>",
        "description": "Emitted when the user rates an assistant message.",
        "optional": false
      },
      {
        "name": "regenerate",
        "type": "OutputEmitterRef<void>",
        "description": "Emitted when the user clicks the regenerate button on an assistant message.",
        "optional": false
      },
      {
        "name": "renderEvent",
        "type": "OutputEmitterRef<ChatRenderEvent>",
        "description": "",
        "optional": false
      },
      {
        "name": "renderRegistry",
        "type": "Signal<AngularRegistry | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "resolvedStore",
        "type": "Signal<StateStore | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "selectedModel",
        "type": "ModelSignal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "showModelPicker",
        "type": "InputSignal<boolean>",
        "description": "When `false`, hide the auto-rendered model picker even when\n`modelOptions` is non-empty. Useful in cramped surfaces (popup,\nsidebar) where the picker crowds the input. Defaults to `true`.\nHas no effect when consumers project their own\n`<chat-select chatInputModelSelect>` via content projection.",
        "optional": false
      },
      {
        "name": "showWelcome",
        "type": "Signal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "store",
        "type": "InputSignal<StateStore | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "threads",
        "type": "InputSignal<Thread[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "threadSelected",
        "type": "OutputEmitterRef<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "views",
        "type": "InputSignal<Readonly<Record<string, Type<unknown> | RenderViewEntry>> | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "viewToolNames",
        "type": "Signal<readonly string[]>",
        "description": "Tool names that have a registered view (keys of the effective view\n registry, including client-declared view/ask tools). These render as\n inline tool-views and are excluded from the default tool-call card so\n they don't render twice.",
        "optional": false
      },
      {
        "name": "welcomeDisabled",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "classifyMessage",
        "signature": "classifyMessage(content: string, message: Pick<Message, \"id\" | \"delivery\">): ContentClassifier",
        "description": "",
        "params": [
          {
            "name": "content",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "message",
            "type": "Pick<Message, \"id\" | \"delivery\">",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "clearClassifiers",
        "signature": "clearClassifiers(): void",
        "description": "",
        "params": []
      },
      {
        "name": "clearThread",
        "signature": "clearThread(): void",
        "description": "Clears local view state (classifiers, surface store, lifecycle counters)\nfor a new thread.\n\nResets messageCount to 0 and inputSubmittedAt to null. componentReady and\nfirstMessageSent are NOT reset (sticky for the chat instance lifetime).",
        "params": []
      },
      {
        "name": "humanContent",
        "signature": "humanContent(message: unknown): string",
        "description": "Renderable content for a human-role message bubble. Most human\nmessages are typed prompts and pass through `messageContent`\nunchanged. A2UI action messages (e.g. form submits, button clicks\non a rendered surface) flow through the same submit channel and\nland in the message stream as a HumanMessage whose content is a\nJSON-serialized `A2uiActionMessage`. Showing the raw JSON as if\nthe user typed it leaks the protocol; per the A2UI spec\nthose events resemble tool calls more than user utterances.\n\n`a2uiActionLabel` returns a short human-readable label for\nrecognized action shapes (\"Search flights\", \"Selected flight UA123\",\netc.) — or null for any non-action content, in which case we fall\nback to the original text.",
        "params": [
          {
            "name": "message",
            "type": "unknown",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "isGenuiTurn",
        "signature": "isGenuiTurn(message: unknown, _prevMsg: unknown, index: number): boolean",
        "description": "True when this assistant message is part of a GenUI render turn.\nWalks backward through messages from `index` until it finds either\nan assistant message with `tool_calls` referencing a GenUI tool\n(→ this turn produces a surface) or a human message (→ the\npreceding turn ended; this assistant message stands on its own).\n\nAlso checks the message itself for:\n  - `extra.tool_calls[].name` matching a GenUI tool (post-streaming\n    state of the tool-call AI message), OR\n  - `extra.content[].type === 'function_call' && .name` matching\n    (live during the OpenAI Responses-API streaming chunks before\n    `tool_calls` populates).\n\nThe walk-back approach is robust to LangGraph's in-place\nreplacement of the ToolMessage (which strips the `name` field),\nunlike a single prev-message check.",
        "params": [
          {
            "name": "message",
            "type": "unknown",
            "description": "",
            "optional": false
          },
          {
            "name": "_prevMsg",
            "type": "unknown",
            "description": "",
            "optional": false
          },
          {
            "name": "index",
            "type": "number",
            "description": "",
            "optional": true
          }
        ]
      },
      {
        "name": "markdownDocumentFor",
        "signature": "markdownDocumentFor(content: string, message: Pick<Message, \"id\" | \"delivery\">): StreamingMarkdownDocument",
        "description": "",
        "params": [
          {
            "name": "content",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "message",
            "type": "Pick<Message, \"id\" | \"delivery\">",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onA2uiAction",
        "signature": "onA2uiAction(message: A2uiActionMessage): void",
        "description": "",
        "params": [
          {
            "name": "message",
            "type": "A2uiActionMessage",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onA2uiEvent",
        "signature": "onA2uiEvent(event: RenderEvent, messageIndex: number, surfaceId: string): void",
        "description": "",
        "params": [
          {
            "name": "event",
            "type": "RenderEvent",
            "description": "",
            "optional": false
          },
          {
            "name": "messageIndex",
            "type": "number",
            "description": "",
            "optional": false
          },
          {
            "name": "surfaceId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onClientToolEvent",
        "signature": "onClientToolEvent(event: RenderEvent): void",
        "description": "Forwards a render event bubbled up from a `<chat-tool-views>` component\n(a client-declared `view`/`ask` tool's rendered UI) to the client-tools\ncoordinator. The coordinator resolves the matching pending `ask` tool call\nwhen the event is a `result`. No-op when no client tools are wired.",
        "params": [
          {
            "name": "event",
            "type": "RenderEvent",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onCopy",
        "signature": "onCopy(message: unknown, content: string): void",
        "description": "",
        "params": [
          {
            "name": "message",
            "type": "unknown",
            "description": "",
            "optional": false
          },
          {
            "name": "content",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onRate",
        "signature": "onRate(message: unknown, value: \"up\" | \"down\"): void",
        "description": "",
        "params": [
          {
            "name": "message",
            "type": "unknown",
            "description": "",
            "optional": false
          },
          {
            "name": "value",
            "type": "\"up\" | \"down\"",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onRegenerate",
        "signature": "onRegenerate(messageIndex: number): void",
        "description": "Regenerate the assistant response at the given message index.",
        "params": [
          {
            "name": "messageIndex",
            "type": "number",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onScroll",
        "signature": "onScroll(): void",
        "description": "",
        "params": []
      },
      {
        "name": "onScrollBubbleClick",
        "signature": "onScrollBubbleClick(): void",
        "description": "",
        "params": []
      },
      {
        "name": "onSpecEvent",
        "signature": "onSpecEvent(event: RenderEvent, messageIndex: number): void",
        "description": "",
        "params": [
          {
            "name": "event",
            "type": "RenderEvent",
            "description": "",
            "optional": false
          },
          {
            "name": "messageIndex",
            "type": "number",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onUserSubmitted",
        "signature": "onUserSubmitted(): void",
        "description": "",
        "params": []
      },
      {
        "name": "prevMessage",
        "signature": "prevMessage(index: number): unknown",
        "description": "Look up the previous message in the agent's messages list.\nReturns undefined for the first message.",
        "params": [
          {
            "name": "index",
            "type": "number",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "prevRole",
        "signature": "prevRole(index: number): ChatMessageRole | undefined",
        "description": "",
        "params": [
          {
            "name": "index",
            "type": "number",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "reasoningRun",
        "signature": "reasoningRun(index: number): object",
        "description": "Aggregate the reasoning RUN starting at `index`: joins each step's\nreasoning, sums durations, counts steps, and returns the last step's\ndelivery because that step owns the current aggregate snapshot. Also\ncomputes the merged label when N > 1 (\"Thought for {total} · {N} steps\",\nor just \"{N} steps\" when no step reported timing).",
        "params": [
          {
            "name": "index",
            "type": "number",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "reasoningRunStart",
        "signature": "reasoningRunStart(index: number): boolean",
        "description": "True when message[index] starts a reasoning RUN — a maximal sequence of\nconsecutive assistant reasoning steps separated only by (hidden) tool\nmessages. The merged reasoning pill renders once, here.",
        "params": [
          {
            "name": "index",
            "type": "number",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "submitMessage",
        "signature": "submitMessage(text: string): void",
        "description": "Programmatic submit. Calls `agent.submit({ message: text })` and updates\nthe CHAT_LIFECYCLE signals. Trimmed-empty text is a no-op.",
        "params": [
          {
            "name": "text",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      }
    ]
  },
  {
    "name": "ChatConfirmDialogComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "body",
        "type": "InputSignal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "bodyId",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "cancelLabel",
        "type": "InputSignal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "cancelled",
        "type": "OutputEmitterRef<void>",
        "description": "",
        "optional": false
      },
      {
        "name": "confirmed",
        "type": "OutputEmitterRef<void>",
        "description": "",
        "optional": false
      },
      {
        "name": "confirmLabel",
        "type": "InputSignal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "open",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "title",
        "type": "InputSignal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "titleId",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "tone",
        "type": "InputSignal<\"normal\" | \"destructive\">",
        "description": "",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "onDialogKeydown",
        "signature": "onDialogKeydown(e: KeyboardEvent): void",
        "description": "",
        "params": [
          {
            "name": "e",
            "type": "KeyboardEvent",
            "description": "",
            "optional": false
          }
        ]
      }
    ]
  },
  {
    "name": "ChatConnectedOverlayDirective",
    "kind": "class",
    "description": "Applied to an `<ng-template>`. When `chatOverlayOpen` is true, the template\ncontent is portaled into the shared body-level overlay container and\npositioned connected to `chatOverlayOrigin`, repositioning live on\nscroll/resize. Closes on outside mousedown (via the `chatOverlayOutsideClick`\noutput) and Tab; returns focus to the origin when focus was inside the pane.\n\nNOTE: the directive does not own the open state — it only emits. To fully\nclose the overlay, consumers MUST handle BOTH `(chatOverlayOutsideClick)` and\n`(chatOverlayDetach)`. Tab-close (and Escape, when the consumer routes it)\nsurface through `chatOverlayDetach`, so wiring only `chatOverlayOutsideClick`\nleaves the overlay stuck open on Tab.",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "attached",
        "type": "OutputEmitterRef<HTMLElement>",
        "description": "Emits the pane element once attached (consumers focus content from it).",
        "optional": false
      },
      {
        "name": "detached",
        "type": "OutputEmitterRef<void>",
        "description": "",
        "optional": false
      },
      {
        "name": "open",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "origin",
        "type": "InputSignal<ChatOverlayOriginDirective<>>",
        "description": "",
        "optional": false
      },
      {
        "name": "outsideClick",
        "type": "OutputEmitterRef<MouseEvent>",
        "description": "",
        "optional": false
      },
      {
        "name": "panelClass",
        "type": "InputSignal<string | string[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "positions",
        "type": "InputSignal<ConnectedPosition[]>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "ChatErrorComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "agent",
        "type": "InputSignal<Agent<unknown>>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "ChatGenerativeUiComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "events",
        "type": "OutputEmitterRef<RenderEvent>",
        "description": "",
        "optional": false
      },
      {
        "name": "handlers",
        "type": "InputSignal<Record<string, (params: Record<string, unknown>) => unknown> | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "loading",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "normalizedSpec",
        "type": "Signal<Spec | null>",
        "description": "The bound spec with schema-documented `{ statePath }` prop refs\nrewritten to engine-native `{ $bindState }` + `_bindings` so values\nresolve against the state store instead of interpolating as\n\"[object Object]\" (F4).",
        "optional": false
      },
      {
        "name": "registry",
        "type": "InputSignal<AngularRegistry | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "spec",
        "type": "InputSignal<Spec | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "store",
        "type": "InputSignal<StateStore | undefined>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "ChatGenuiSkeletonComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [],
    "methods": []
  },
  {
    "name": "ChatHistorySearchPaletteComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "activeIndex",
        "type": "WritableSignal<number>",
        "description": "",
        "optional": false
      },
      {
        "name": "closed",
        "type": "OutputEmitterRef<void>",
        "description": "",
        "optional": false
      },
      {
        "name": "listId",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "loading",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "open",
        "type": "ModelSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "placeholder",
        "type": "InputSignal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "query",
        "type": "ModelSignal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "results",
        "type": "InputSignal<ThreadMatch[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "threadSelected",
        "type": "OutputEmitterRef<string>",
        "description": "",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "activeRowId",
        "signature": "activeRowId(): string | null",
        "description": "",
        "params": []
      },
      {
        "name": "onInput",
        "signature": "onInput(e: Event): void",
        "description": "",
        "params": [
          {
            "name": "e",
            "type": "Event",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onInputKeydown",
        "signature": "onInputKeydown(e: KeyboardEvent): void",
        "description": "",
        "params": [
          {
            "name": "e",
            "type": "KeyboardEvent",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onRowClick",
        "signature": "onRowClick(id: string): void",
        "description": "",
        "params": [
          {
            "name": "id",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "rowId",
        "signature": "rowId(index: number): string",
        "description": "",
        "params": [
          {
            "name": "index",
            "type": "number",
            "description": "",
            "optional": false
          }
        ]
      }
    ]
  },
  {
    "name": "ChatInputComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "agent",
        "type": "InputSignal<Agent<unknown>>",
        "description": "",
        "optional": false
      },
      {
        "name": "canStop",
        "type": "Signal<boolean>",
        "description": "The stop button only appears when the consumer opted in AND we're loading.",
        "optional": false
      },
      {
        "name": "canSubmit",
        "type": "Signal<boolean>",
        "description": "Submit is allowed only when not loading and there's non-whitespace text.",
        "optional": false
      },
      {
        "name": "composing",
        "type": "WritableSignal<boolean>",
        "description": "True while an IME composition (CJK input, accent, autocorrect) is active.",
        "optional": false
      },
      {
        "name": "focused",
        "type": "WritableSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "isLoading",
        "type": "Signal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "messageText",
        "type": "WritableSignal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "placeholder",
        "type": "InputSignal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "showStopButton",
        "type": "InputSignal<boolean>",
        "description": "When true (default), shows a stop button while the agent is streaming.",
        "optional": false
      },
      {
        "name": "stopped",
        "type": "OutputEmitterRef<void>",
        "description": "",
        "optional": false
      },
      {
        "name": "submitOnEnter",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "submitted",
        "type": "OutputEmitterRef<string>",
        "description": "",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "focusTextarea",
        "signature": "focusTextarea(): void",
        "description": "",
        "params": []
      },
      {
        "name": "onInput",
        "signature": "onInput(event: Event): void",
        "description": "Sync the textarea's value into the signal on user input. A direct\n [value]/(input) pair is used instead of ngModel: NgModel does not\n reliably write a programmatic clear back to the view under zoneless\n + OnPush, leaving sent text visible in the composer (audit F1).",
        "params": [
          {
            "name": "event",
            "type": "Event",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onKeydown",
        "signature": "onKeydown(event: KeyboardEvent): void",
        "description": "",
        "params": [
          {
            "name": "event",
            "type": "KeyboardEvent",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onStop",
        "signature": "onStop(): void",
        "description": "Abort the current streaming response (if the adapter supports it).",
        "params": []
      },
      {
        "name": "onSubmit",
        "signature": "onSubmit(): void",
        "description": "",
        "params": []
      }
    ]
  },
  {
    "name": "ChatInterruptComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "agent",
        "type": "InputSignal<Agent<unknown>>",
        "description": "",
        "optional": false
      },
      {
        "name": "interrupt",
        "type": "Signal<AgentInterrupt | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "templateRef",
        "type": "Signal<TemplateRef<any> | undefined>",
        "description": "",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "defaultText",
        "signature": "defaultText(i: AgentInterrupt): string",
        "description": "",
        "params": [
          {
            "name": "i",
            "type": "AgentInterrupt",
            "description": "",
            "optional": false
          }
        ]
      }
    ]
  },
  {
    "name": "ChatInterruptPanelComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "action",
        "type": "OutputEmitterRef<InterruptAction>",
        "description": "",
        "optional": false
      },
      {
        "name": "agent",
        "type": "InputSignal<Agent<unknown>>",
        "description": "",
        "optional": false
      },
      {
        "name": "interrupt",
        "type": "Signal<AgentInterrupt | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "interruptReason",
        "type": "Signal<string>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "ChatLauncherButtonComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "clicked",
        "type": "OutputEmitterRef<void>",
        "description": "Fires when the inner <button> receives a click. Prefer this over\n binding `(click)` on the host element — explicit output gives\n consumers (and Playwright) an unambiguous click target that won't\n be intercepted by sibling overlays in higher stacking contexts.\n Native `(click)` on the host still works for back-compat: the\n click event bubbles through unchanged.",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "ChatMessageActionsComponent",
    "kind": "class",
    "description": "Default action buttons that appear under each assistant message:\nregenerate, copy-to-clipboard, thumbs up, thumbs down.\n\nHidden by default, fades in on `:hover`/`:focus-within` of the parent\n`chat-message`, and stays visible on the current/last assistant message\nand on mobile.",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "content",
        "type": "InputSignal<string>",
        "description": "Plain text content to copy. Required for the copy button to function.",
        "optional": false
      },
      {
        "name": "contentCopied",
        "type": "OutputEmitterRef<string>",
        "description": "Emitted with the copied content after a successful clipboard write.",
        "optional": false
      },
      {
        "name": "copied",
        "type": "WritableSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "disabled",
        "type": "InputSignal<boolean>",
        "description": "When true, the regenerate button is disabled (e.g. while the agent is streaming).",
        "optional": false
      },
      {
        "name": "rate",
        "type": "OutputEmitterRef<\"up\" | \"down\">",
        "description": "Emitted with 'up' or 'down' when the user rates the response.",
        "optional": false
      },
      {
        "name": "rating",
        "type": "WritableSignal<\"up\" | \"down\" | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "regenerate",
        "type": "OutputEmitterRef<void>",
        "description": "Emitted when the user clicks regenerate. Wire this to `agent.regenerate(index)`.",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "onCopy",
        "signature": "onCopy(): Promise<void>",
        "description": "",
        "params": []
      },
      {
        "name": "onRate",
        "signature": "onRate(value: \"up\" | \"down\"): void",
        "description": "",
        "params": [
          {
            "name": "value",
            "type": "\"up\" | \"down\"",
            "description": "",
            "optional": false
          }
        ]
      }
    ]
  },
  {
    "name": "ChatMessageComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "bodyClass",
        "type": "Signal<\"chat-message__bubble\" | \"chat-message__assistant-body\" | \"chat-message__plain\">",
        "description": "",
        "optional": false
      },
      {
        "name": "current",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "currentStr",
        "type": "Signal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "message",
        "type": "InputSignal<Message | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "prevRole",
        "type": "InputSignal<ChatMessageRole | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "role",
        "type": "InputSignal<ChatMessageRole>",
        "description": "",
        "optional": false
      },
      {
        "name": "streaming",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "streamingStr",
        "type": "Signal<string>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "ChatMessageListComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "agent",
        "type": "InputSignal<Agent<unknown>>",
        "description": "",
        "optional": false
      },
      {
        "name": "getMessageType",
        "type": "(message: Message) => MessageTemplateType",
        "description": "",
        "optional": false
      },
      {
        "name": "messages",
        "type": "Signal<Message[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "messageTemplates",
        "type": "Signal<readonly MessageTemplateDirective[]>",
        "description": "",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "findTemplate",
        "signature": "findTemplate(type: MessageTemplateType): MessageTemplateDirective<> | undefined",
        "description": "",
        "params": [
          {
            "name": "type",
            "type": "MessageTemplateType",
            "description": "",
            "optional": false
          }
        ]
      }
    ]
  },
  {
    "name": "ChatOverflowMenuComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "anchor",
        "type": "InputSignal<HTMLElement | null>",
        "description": "Element the menu anchors against (positions just below its bottom-right corner).",
        "optional": false
      },
      {
        "name": "anchorPos",
        "type": "InputSignal<object | null>",
        "description": "Alternative anchor: explicit viewport coordinates (e.g. cursor position\n from a right-click). Takes precedence over `anchor` when set.",
        "optional": false
      },
      {
        "name": "closed",
        "type": "OutputEmitterRef<void>",
        "description": "",
        "optional": false
      },
      {
        "name": "items",
        "type": "InputSignal<OverflowMenuItem[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "itemSelected",
        "type": "OutputEmitterRef<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "open",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "position",
        "type": "Signal<object>",
        "description": "",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "onItemClick",
        "signature": "onItemClick(item: OverflowMenuItem): void",
        "description": "",
        "params": [
          {
            "name": "item",
            "type": "OverflowMenuItem",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onMenuKeydown",
        "signature": "onMenuKeydown(e: KeyboardEvent): void",
        "description": "",
        "params": [
          {
            "name": "e",
            "type": "KeyboardEvent",
            "description": "",
            "optional": false
          }
        ]
      }
    ]
  },
  {
    "name": "ChatOverlayOriginDirective",
    "kind": "class",
    "description": "Marks the anchor element a connected overlay positions against.",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "elementRef",
        "type": "ElementRef<HTMLElement>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "ChatPopupComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "agent",
        "type": "InputSignal<Agent<unknown>>",
        "description": "",
        "optional": false
      },
      {
        "name": "clientTools",
        "type": "InputSignal<Readonly<Record<string, ClientToolDef>> | undefined>",
        "description": "Frontend-declared client tools forwarded to the inner `<chat>`.",
        "optional": false
      },
      {
        "name": "closeOnEscape",
        "type": "InputSignal<boolean>",
        "description": "Close the popup on Escape (default true).",
        "optional": false
      },
      {
        "name": "modelOptions",
        "type": "InputSignal<readonly ChatSelectOption[]>",
        "description": "Forwarded to the inner <chat>. When non-empty, a model picker pill\nrenders in the chat-input chrome.",
        "optional": false
      },
      {
        "name": "open",
        "type": "ModelSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "selectedModel",
        "type": "ModelSignal<string>",
        "description": "Two-way bound current model value.",
        "optional": false
      },
      {
        "name": "shortcut",
        "type": "InputSignal<string | null>",
        "description": "Keyboard shortcut (single key) that toggles the popup with cmd (mac)\nor ctrl (other). Set to `null` to disable. Default: 'k' — matches the\nwidely-used cmd/ctrl+K convention.",
        "optional": false
      },
      {
        "name": "showModelPicker",
        "type": "InputSignal<boolean>",
        "description": "Forwarded to the inner `<chat>`. When `false`, hides the\nauto-rendered model picker even with non-empty `modelOptions`.\nUse this in narrow surfaces (the chat-sidebar panel is 28rem\nwide; chat-popup is 24rem) where the picker crowds the input.\nDefaults to `true`.",
        "optional": false
      },
      {
        "name": "views",
        "type": "InputSignal<Readonly<Record<string, Type<unknown> | RenderViewEntry>> | undefined>",
        "description": "A2UI component catalog forwarded to the inner <chat>. Without it,\nmessages classified as A2UI parse correctly but never mount a\nsurface. Pass `a2uiBasicCatalog()` from `@threadplane/chat`.",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "closeWindow",
        "signature": "closeWindow(): void",
        "description": "",
        "params": []
      },
      {
        "name": "openWindow",
        "signature": "openWindow(): void",
        "description": "",
        "params": []
      },
      {
        "name": "toggle",
        "signature": "toggle(): void",
        "description": "",
        "params": []
      }
    ]
  },
  {
    "name": "ChatProjectListComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "actions",
        "type": "InputSignal<ProjectActionAdapter | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "activeProjectId",
        "type": "InputSignal<string | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "confirmDeleteId",
        "type": "WritableSignal<string | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "creatingProject",
        "type": "WritableSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "creatingValue",
        "type": "WritableSignal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "currentMenuItems",
        "type": "Signal<OverflowMenuItem[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "editingProjectId",
        "type": "WritableSignal<string | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "editingValue",
        "type": "WritableSignal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "menuAnchor",
        "type": "WritableSignal<HTMLElement | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "menuOpenForId",
        "type": "WritableSignal<string | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "newProjectRequested",
        "type": "OutputEmitterRef<void>",
        "description": "",
        "optional": false
      },
      {
        "name": "projects",
        "type": "InputSignal<Project[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "projectSelected",
        "type": "OutputEmitterRef<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "showNewProjectButton",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "visibleProjects",
        "type": "Signal<Project[]>",
        "description": "",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "cancelCreate",
        "signature": "cancelCreate(): void",
        "description": "",
        "params": []
      },
      {
        "name": "cancelRename",
        "signature": "cancelRename(): void",
        "description": "",
        "params": []
      },
      {
        "name": "commitCreate",
        "signature": "commitCreate(): Promise<void>",
        "description": "",
        "params": []
      },
      {
        "name": "commitRename",
        "signature": "commitRename(projectId: string): Promise<void>",
        "description": "",
        "params": [
          {
            "name": "projectId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onCreateInput",
        "signature": "onCreateInput(e: Event): void",
        "description": "",
        "params": [
          {
            "name": "e",
            "type": "Event",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onEditInput",
        "signature": "onEditInput(e: Event): void",
        "description": "",
        "params": [
          {
            "name": "e",
            "type": "Event",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onMenuAction",
        "signature": "onMenuAction(id: string): void",
        "description": "",
        "params": [
          {
            "name": "id",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onNewProjectClicked",
        "signature": "onNewProjectClicked(): void",
        "description": "",
        "params": []
      },
      {
        "name": "openMenu",
        "signature": "openMenu(projectId: string, anchor: HTMLElement): void",
        "description": "",
        "params": [
          {
            "name": "projectId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "anchor",
            "type": "HTMLElement",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "performDelete",
        "signature": "performDelete(): Promise<void>",
        "description": "",
        "params": []
      },
      {
        "name": "selectProject",
        "signature": "selectProject(projectId: string): void",
        "description": "",
        "params": [
          {
            "name": "projectId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "showKebab",
        "signature": "showKebab(): boolean",
        "description": "",
        "params": []
      }
    ]
  },
  {
    "name": "ChatReasoningComponent",
    "kind": "class",
    "description": "Renders an assistant's reasoning content as a compact pill that\nexpands to reveal the underlying text. Three visual states:\n\n- Streaming: pill shows \"Thinking…\" with a pulsing dot; auto-expanded\n  so the user sees reasoning stream in real time.\n- Idle, with durationMs known: pill shows \"Thought for {duration}\";\n  collapsed by default, expand on click.\n- Idle, no duration: pill shows \"Show reasoning\"; collapsed by default.\n\nThe body re-uses chat-streaming-md so reasoning content gets the same\nmarkdown rendering pipeline as the visible response (lists, code,\nstep labels often appear in reasoning output).\n\nInternal state: a tristate \"expanded\" — null means follow auto state-\ndriven logic (force-expand while delivery is streaming, otherwise honor\ndefaultExpanded), boolean is a manual user choice that wins for the\nlifetime of the instance.",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "content",
        "type": "InputSignal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "defaultExpanded",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "delivery",
        "type": "InputSignal<MessageDelivery>",
        "description": "",
        "optional": false
      },
      {
        "name": "document",
        "type": "Signal<StreamingMarkdownDocument>",
        "description": "",
        "optional": false
      },
      {
        "name": "durationMs",
        "type": "InputSignal<number | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "expanded",
        "type": "Signal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "expandedStr",
        "type": "Signal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "hasContent",
        "type": "Signal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "isStreaming",
        "type": "Signal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "label",
        "type": "InputSignal<string | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "resolvedLabel",
        "type": "Signal<string>",
        "description": "",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "toggle",
        "signature": "toggle(): void",
        "description": "",
        "params": []
      }
    ]
  },
  {
    "name": "ChatScrollBubbleComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "ariaLabel",
        "type": "Signal<\"Latest activity\" | \"Scroll to latest\">",
        "description": "",
        "optional": false
      },
      {
        "name": "clicked",
        "type": "OutputEmitterRef<void>",
        "description": "",
        "optional": false
      },
      {
        "name": "mode",
        "type": "InputSignal<ChatScrollBubbleMode>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "ChatSelectComponent",
    "kind": "class",
    "description": "Generic single-select dropdown. The menu renders through the chat\nconnected-overlay primitive (a body-level portal), so it is never clipped by\nan ancestor's `overflow` and never trapped by an ancestor `transform`.\n\nInputs: options (required), value (two-way), placeholder, disabled, menuLabel,\npanelClass (extra class(es) on the overlay pane — the menu is portaled, so\n`::ng-deep chat-select .chat-select__menu` no longer reaches it).",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "currentLabel",
        "type": "Signal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "disabled",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "menuId",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "menuLabel",
        "type": "InputSignal<string | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "open",
        "type": "WritableSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "options",
        "type": "InputSignal<readonly ChatSelectOption[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "overlayPositions",
        "type": "ConnectedPosition[]",
        "description": "",
        "optional": false
      },
      {
        "name": "panelClass",
        "type": "InputSignal<string | string[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "panelClasses",
        "type": "Signal<string[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "placeholder",
        "type": "InputSignal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "value",
        "type": "ModelSignal<string>",
        "description": "",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "onAttached",
        "signature": "onAttached(pane: HTMLElement): void",
        "description": "",
        "params": [
          {
            "name": "pane",
            "type": "HTMLElement",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onMenuKeydown",
        "signature": "onMenuKeydown(e: KeyboardEvent): void",
        "description": "",
        "params": [
          {
            "name": "e",
            "type": "KeyboardEvent",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onTriggerKeydown",
        "signature": "onTriggerKeydown(e: KeyboardEvent): void",
        "description": "",
        "params": [
          {
            "name": "e",
            "type": "KeyboardEvent",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "selectOption",
        "signature": "selectOption(opt: ChatSelectOption): void",
        "description": "",
        "params": [
          {
            "name": "opt",
            "type": "ChatSelectOption",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "toggle",
        "signature": "toggle(): void",
        "description": "",
        "params": []
      }
    ]
  },
  {
    "name": "ChatSidebarComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "agent",
        "type": "InputSignal<Agent<unknown>>",
        "description": "",
        "optional": false
      },
      {
        "name": "clientTools",
        "type": "InputSignal<Readonly<Record<string, ClientToolDef>> | undefined>",
        "description": "Frontend-declared client tools forwarded to the inner `<chat>`.",
        "optional": false
      },
      {
        "name": "closeOnEscape",
        "type": "InputSignal<boolean>",
        "description": "Close the sidebar on Escape (default true).",
        "optional": false
      },
      {
        "name": "modelOptions",
        "type": "InputSignal<readonly ChatSelectOption[]>",
        "description": "Forwarded to the inner <chat>. When non-empty, a model picker pill\nrenders in the chat-input chrome.",
        "optional": false
      },
      {
        "name": "open",
        "type": "ModelSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "pushContent",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "selectedModel",
        "type": "ModelSignal<string>",
        "description": "Two-way bound current model value.",
        "optional": false
      },
      {
        "name": "showModelPicker",
        "type": "InputSignal<boolean>",
        "description": "Forwarded to the inner `<chat>`. When `false`, hides the\nauto-rendered model picker even with non-empty `modelOptions`.\nUse this in narrow surfaces (the chat-sidebar panel is 28rem\nwide; chat-popup is 24rem) where the picker crowds the input.\nDefaults to `true`.",
        "optional": false
      },
      {
        "name": "views",
        "type": "InputSignal<Readonly<Record<string, Type<unknown> | RenderViewEntry>> | undefined>",
        "description": "A2UI component catalog forwarded to the inner <chat>. Without it,\nmessages classified as A2UI parse correctly but never mount a\nsurface. Pass `a2uiBasicCatalog()` from `@threadplane/chat`.",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "closeWindow",
        "signature": "closeWindow(): void",
        "description": "",
        "params": []
      },
      {
        "name": "openWindow",
        "signature": "openWindow(): void",
        "description": "",
        "params": []
      },
      {
        "name": "toggle",
        "signature": "toggle(): void",
        "description": "",
        "params": []
      }
    ]
  },
  {
    "name": "ChatSidenavComponent",
    "kind": "class",
    "description": "The conversation sidebar: thread list, projects, search, and the new-chat\naction. Pair it with a runtime's thread store (e.g. `LangGraphThreadsAdapter`)\nand a ThreadActionAdapter for the per-row rename/delete/archive menu.\n\n**This component renders the sidebar only — it is not a layout wrapper.** Its\n`<ng-content>` slots are all named (`sidenavHeader`, `sidenavPrimary`,\n`sidenavSections`, `sidenavFooterLeft`, `sidenavFooterRight`,\n`sidenavAccount`) and target regions *inside* the sidebar. There is no default\nslot, so a `<chat>` placed between the tags is silently dropped. Render the\nchat as a sibling and lay the two out yourself:",
    "params": [],
    "examples": [
      "```html\n<chat-sidenav\n  [threads]=\"threads.threads()\"\n  [activeThreadId]=\"activeThread()\"\n  [actions]=\"threadActions\"\n  [agent]=\"agent\"\n  (newChat)=\"activeThread.set(null)\"\n  (threadSelected)=\"activeThread.set($event)\"\n/>\n<main class=\"chat-pane\">\n  <chat [agent]=\"agent\" />\n</main>\n```\n```css\n:host { display: flex; height: 100dvh; }\n.chat-pane { flex: 1; min-width: 0; }\n```"
    ],
    "properties": [
      {
        "name": "actions",
        "type": "InputSignal<ThreadActionAdapter | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "activeThreadId",
        "type": "InputSignal<string | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "agent",
        "type": "InputSignal<Agent<unknown> | AgentWithHistory<unknown> | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "archivedOpen",
        "type": "WritableSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "archivedThreads",
        "type": "InputSignal<Thread[] | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "debug",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "isDebugStreaming",
        "type": "Signal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "mode",
        "type": "InputSignal<ChatSidenavMode>",
        "description": "",
        "optional": false
      },
      {
        "name": "modeChange",
        "type": "OutputEmitterRef<ChatSidenavMode>",
        "description": "",
        "optional": false
      },
      {
        "name": "newChat",
        "type": "OutputEmitterRef<void>",
        "description": "",
        "optional": false
      },
      {
        "name": "newProjectRequested",
        "type": "OutputEmitterRef<void>",
        "description": "",
        "optional": false
      },
      {
        "name": "open",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "openChange",
        "type": "OutputEmitterRef<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "projectActions",
        "type": "InputSignal<ProjectActionAdapter | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "projects",
        "type": "InputSignal<Project[] | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "projectSelected",
        "type": "OutputEmitterRef<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "searchOpened",
        "type": "OutputEmitterRef<void>",
        "description": "",
        "optional": false
      },
      {
        "name": "selectedProjectId",
        "type": "InputSignal<string | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "showDebugButton",
        "type": "Signal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "threads",
        "type": "InputSignal<Thread[] | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "threadSelected",
        "type": "OutputEmitterRef<string>",
        "description": "",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "onCollapseToggle",
        "signature": "onCollapseToggle(): void",
        "description": "",
        "params": []
      },
      {
        "name": "onEscape",
        "signature": "onEscape(): void",
        "description": "",
        "params": []
      },
      {
        "name": "openDebug",
        "signature": "openDebug(event: MouseEvent): void",
        "description": "",
        "params": [
          {
            "name": "event",
            "type": "MouseEvent",
            "description": "",
            "optional": false
          }
        ]
      }
    ]
  },
  {
    "name": "ChatSidenavScrimComponent",
    "kind": "class",
    "description": "Backdrop scrim for chat-sidenav's drawer mode, rendered as a sibling of\n<chat-sidenav> so its z-index sits cleanly between the page content\nand the drawer host (escapes the drawer host's stacking context).\n\nUsage:\n  <chat-sidenav-scrim [open]=\"drawerOpen()\" (dismiss)=\"drawerOpen.set(false)\" />\n  <chat-sidenav [(open)]=\"drawerOpen\" ...></chat-sidenav>",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "dismiss",
        "type": "OutputEmitterRef<void>",
        "description": "Fires when the user clicks the backdrop.",
        "optional": false
      },
      {
        "name": "open",
        "type": "InputSignal<boolean>",
        "description": "When true, render the backdrop button covering the viewport.",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "ChatStreamingMdComponent",
    "kind": "class",
    "description": "Renders one explicitly-versioned markdown document through the shared view\nregistry. A generation owns one parser session; append-only updates preserve\nparser and subtree identity, while generation changes replace the session.",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "document",
        "type": "InputSignal<StreamingMarkdownDocument>",
        "description": "",
        "optional": false
      },
      {
        "name": "resolvedRegistry",
        "type": "Signal<Readonly<Record<string, Type<unknown> | RenderViewEntry>>>",
        "description": "",
        "optional": false
      },
      {
        "name": "root",
        "type": "Signal<MarkdownDocumentNode | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "viewRegistry",
        "type": "InputSignal<Readonly<Record<string, Type<unknown> | RenderViewEntry>> | undefined>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "ChatSubagentCardComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "state",
        "type": "Signal<TraceState>",
        "description": "",
        "optional": false
      },
      {
        "name": "subagent",
        "type": "InputSignal<Subagent>",
        "description": "",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "markdownDocumentFor",
        "signature": "markdownDocumentFor(content: string, message: Message): StreamingMarkdownDocument",
        "description": "",
        "params": [
          {
            "name": "content",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "message",
            "type": "Message",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "textOf",
        "signature": "textOf(m: Message): string",
        "description": "",
        "params": [
          {
            "name": "m",
            "type": "Message",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "toolCallsFor",
        "signature": "toolCallsFor(m: Message): ToolCall[]",
        "description": "",
        "params": [
          {
            "name": "m",
            "type": "Message",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "toToolCallInfo",
        "signature": "toToolCallInfo(tc: ToolCall): ToolCallInfo",
        "description": "",
        "params": [
          {
            "name": "tc",
            "type": "ToolCall",
            "description": "",
            "optional": false
          }
        ]
      }
    ]
  },
  {
    "name": "ChatSubagentsComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "activeSubagents",
        "type": "Signal<Subagent[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "agent",
        "type": "InputSignal<Agent<unknown>>",
        "description": "",
        "optional": false
      },
      {
        "name": "templateRef",
        "type": "Signal<TemplateRef<any> | undefined>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "ChatSuggestionsComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "selected",
        "type": "OutputEmitterRef<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "suggestions",
        "type": "InputSignal<string[]>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "ChatThreadListComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "actions",
        "type": "InputSignal<ThreadActionAdapter | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "activeThreadId",
        "type": "InputSignal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "confirmDeleteId",
        "type": "WritableSignal<string | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "currentMenuItems",
        "type": "Signal<OverflowMenuItem[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "draggingThreadId",
        "type": "WritableSignal<string | null>",
        "description": "Id of the thread currently being dragged via HTML5 drag-and-drop.",
        "optional": false
      },
      {
        "name": "dropTarget",
        "type": "WritableSignal<object | null>",
        "description": "Drop target during a drag: which row, and whether the indicator shows\n on the top edge ('before') or bottom edge ('after').",
        "optional": false
      },
      {
        "name": "editingThreadId",
        "type": "WritableSignal<string | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "editingValue",
        "type": "WritableSignal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "menuAnchor",
        "type": "WritableSignal<HTMLElement | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "menuAnchorPos",
        "type": "WritableSignal<object | null>",
        "description": "Cursor-anchored position when the menu was opened via right-click.\n Mutually exclusive with `menuAnchor` — set one, null the other.",
        "optional": false
      },
      {
        "name": "menuOpenForId",
        "type": "WritableSignal<string | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "mode",
        "type": "InputSignal<\"active\" | \"archived\">",
        "description": "",
        "optional": false
      },
      {
        "name": "moveMenuItems",
        "type": "Signal<OverflowMenuItem[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "moveMenuOpenForId",
        "type": "WritableSignal<string | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "newThreadRequested",
        "type": "OutputEmitterRef<void>",
        "description": "",
        "optional": false
      },
      {
        "name": "projects",
        "type": "InputSignal<Project[] | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "showNewThreadButton",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "templateRef",
        "type": "Signal<TemplateRef<any> | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "threads",
        "type": "InputSignal<Thread[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "threadSelected",
        "type": "OutputEmitterRef<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "visibleThreads",
        "type": "Signal<Thread[]>",
        "description": "",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "cancelRename",
        "signature": "cancelRename(): void",
        "description": "",
        "params": []
      },
      {
        "name": "commitRename",
        "signature": "commitRename(threadId: string): Promise<void>",
        "description": "",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "dropPositionFor",
        "signature": "dropPositionFor(threadId: string): \"before\" | \"after\" | null",
        "description": "",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "initialOf",
        "signature": "initialOf(title: string): string",
        "description": "First grapheme of a title rendered as an uppercase initial for the\n collapsed sidenav. Falls back to \"?\" for empty/whitespace titles.",
        "params": [
          {
            "name": "title",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onDragEnd",
        "signature": "onDragEnd(): void",
        "description": "",
        "params": []
      },
      {
        "name": "onDragLeave",
        "signature": "onDragLeave(_e: DragEvent, threadId: string): void",
        "description": "",
        "params": [
          {
            "name": "_e",
            "type": "DragEvent",
            "description": "",
            "optional": false
          },
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onDragOver",
        "signature": "onDragOver(e: DragEvent, threadId: string): void",
        "description": "",
        "params": [
          {
            "name": "e",
            "type": "DragEvent",
            "description": "",
            "optional": false
          },
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onDragStart",
        "signature": "onDragStart(e: DragEvent, threadId: string): void",
        "description": "",
        "params": [
          {
            "name": "e",
            "type": "DragEvent",
            "description": "",
            "optional": false
          },
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onDrop",
        "signature": "onDrop(e: DragEvent, targetThreadId: string): void",
        "description": "",
        "params": [
          {
            "name": "e",
            "type": "DragEvent",
            "description": "",
            "optional": false
          },
          {
            "name": "targetThreadId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onEditInput",
        "signature": "onEditInput(e: Event): void",
        "description": "",
        "params": [
          {
            "name": "e",
            "type": "Event",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onMenuAction",
        "signature": "onMenuAction(id: string): void",
        "description": "",
        "params": [
          {
            "name": "id",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onMoveMenuAction",
        "signature": "onMoveMenuAction(itemId: string): void",
        "description": "",
        "params": [
          {
            "name": "itemId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onRowContextMenu",
        "signature": "onRowContextMenu(threadId: string, event: MouseEvent): void",
        "description": "Right-click on a row opens the same overflow menu anchored at the\n cursor. Always prevents the native context menu — including when the\n adapter exposes no row actions (in which case we open nothing rather\n than confusing the user with the OS menu on what looks like a custom\n list).",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "event",
            "type": "MouseEvent",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "openMenu",
        "signature": "openMenu(threadId: string, anchor: HTMLElement): void",
        "description": "",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "anchor",
            "type": "HTMLElement",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "performArchive",
        "signature": "performArchive(threadId: string): Promise<void>",
        "description": "",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "performDelete",
        "signature": "performDelete(): Promise<void>",
        "description": "",
        "params": []
      },
      {
        "name": "performMoveDown",
        "signature": "performMoveDown(threadId: string): Promise<void>",
        "description": "",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "performMoveToProject",
        "signature": "performMoveToProject(threadId: string, projectId: string | null): Promise<void>",
        "description": "",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "projectId",
            "type": "string | null",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "performMoveUp",
        "signature": "performMoveUp(threadId: string): Promise<void>",
        "description": "",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "performPin",
        "signature": "performPin(threadId: string): Promise<void>",
        "description": "",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "performReorderPinned",
        "signature": "performReorderPinned(threadId: string, beforeId: string | null): Promise<void>",
        "description": "",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "beforeId",
            "type": "string | null",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "performUnarchive",
        "signature": "performUnarchive(threadId: string): Promise<void>",
        "description": "",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "performUnpin",
        "signature": "performUnpin(threadId: string): Promise<void>",
        "description": "",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "relativeTime",
        "signature": "relativeTime(epochMs: number): string",
        "description": "",
        "params": [
          {
            "name": "epochMs",
            "type": "number",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "selectThread",
        "signature": "selectThread(threadId: string): void",
        "description": "",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "showKebab",
        "signature": "showKebab(): boolean",
        "description": "",
        "params": []
      },
      {
        "name": "threadLabel",
        "signature": "threadLabel(thread: Thread): string",
        "description": "",
        "params": [
          {
            "name": "thread",
            "type": "Thread",
            "description": "",
            "optional": false
          }
        ]
      }
    ]
  },
  {
    "name": "ChatTimelineComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "agent",
        "type": "InputSignal<AgentWithHistory<unknown>>",
        "description": "",
        "optional": false
      },
      {
        "name": "checkpointSelected",
        "type": "OutputEmitterRef<AgentCheckpoint>",
        "description": "",
        "optional": false
      },
      {
        "name": "history",
        "type": "Signal<AgentCheckpoint[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "templateRef",
        "type": "Signal<TemplateRef<any> | undefined>",
        "description": "",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "selectCheckpoint",
        "signature": "selectCheckpoint(cp: AgentCheckpoint): void",
        "description": "",
        "params": [
          {
            "name": "cp",
            "type": "AgentCheckpoint",
            "description": "",
            "optional": false
          }
        ]
      }
    ]
  },
  {
    "name": "ChatTimelineSliderComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "agent",
        "type": "InputSignal<AgentWithHistory<unknown>>",
        "description": "",
        "optional": false
      },
      {
        "name": "forkRequested",
        "type": "OutputEmitterRef<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "history",
        "type": "Signal<AgentCheckpoint[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "replayRequested",
        "type": "OutputEmitterRef<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "selectedIndex",
        "type": "WritableSignal<number>",
        "description": "",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "fork",
        "signature": "fork(cp: AgentCheckpoint, index: number): void",
        "description": "",
        "params": [
          {
            "name": "cp",
            "type": "AgentCheckpoint",
            "description": "",
            "optional": false
          },
          {
            "name": "index",
            "type": "number",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "replay",
        "signature": "replay(cp: AgentCheckpoint): void",
        "description": "",
        "params": [
          {
            "name": "cp",
            "type": "AgentCheckpoint",
            "description": "",
            "optional": false
          }
        ]
      }
    ]
  },
  {
    "name": "ChatToolCallCardComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "ariaLabel",
        "type": "Signal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "autoExpanded",
        "type": "Signal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "defaultCollapsed",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "state",
        "type": "Signal<TraceState>",
        "description": "",
        "optional": false
      },
      {
        "name": "status",
        "type": "Signal<ToolCallStatus>",
        "description": "",
        "optional": false
      },
      {
        "name": "toolCall",
        "type": "InputSignal<ToolCallInfo>",
        "description": "",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "formatJson",
        "signature": "formatJson(value: unknown): string",
        "description": "",
        "params": [
          {
            "name": "value",
            "type": "unknown",
            "description": "",
            "optional": false
          }
        ]
      }
    ]
  },
  {
    "name": "ChatToolCallsComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "agent",
        "type": "InputSignal<Agent<unknown>>",
        "description": "",
        "optional": false
      },
      {
        "name": "excludeToolNames",
        "type": "InputSignal<readonly string[]>",
        "description": "Tool names whose groups should be hidden. Used by chat compositions\nto filter out internal/orchestration tools (e.g. GenUI dispatchers)\nwhose args streaming is not meaningful to surface in the chat.\nDefault empty — preserves prior behavior for non-filtering consumers.",
        "optional": false
      },
      {
        "name": "expandedGroups",
        "type": "Signal<Set<number>>",
        "description": "",
        "optional": false
      },
      {
        "name": "grouping",
        "type": "InputSignal<\"auto\" | \"none\">",
        "description": "",
        "optional": false
      },
      {
        "name": "groups",
        "type": "Signal<Group[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "groupSummary",
        "type": "InputSignal<(name: string, count: number) => string | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "message",
        "type": "InputSignal<Message | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "templates",
        "type": "Signal<readonly ChatToolCallTemplateDirective[]>",
        "description": "Per-tool-name + wildcard templates registered as content children.",
        "optional": false
      },
      {
        "name": "toolCalls",
        "type": "Signal<ToolCall[]>",
        "description": "",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "summarize",
        "signature": "summarize(name: string, count: number): string",
        "description": "",
        "params": [
          {
            "name": "name",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "count",
            "type": "number",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "toggleGroup",
        "signature": "toggleGroup(index: number): void",
        "description": "",
        "params": [
          {
            "name": "index",
            "type": "number",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "toToolCallInfo",
        "signature": "toToolCallInfo(tc: ToolCall): ToolCallInfo",
        "description": "",
        "params": [
          {
            "name": "tc",
            "type": "ToolCall",
            "description": "",
            "optional": false
          }
        ]
      }
    ]
  },
  {
    "name": "ChatToolCallTemplateDirective",
    "kind": "class",
    "description": "Registers a per-tool-name template inside <chat-tool-calls>. The\nprimitive collects all directive instances via contentChildren() and\ndispatches incoming calls by their `name` field. A literal \"*\" name\nregisters a wildcard catch-all that handles any tool name without a\nspecific template registered.\n\nUsage:\n\n  <chat-tool-calls [agent]=\"agent\" [message]=\"msg\">\n    <ng-template chatToolCallTemplate=\"search_web\" let-call let-status=\"status\">\n      <my-search-result-card [query]=\"call.args.query\" [status]=\"status\"/>\n    </ng-template>\n    <ng-template chatToolCallTemplate=\"*\" let-call>\n      <chat-tool-call-card [toolCall]=\"call\"/>\n    </ng-template>\n  </chat-tool-calls>",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "name",
        "type": "InputSignal<string>",
        "description": "The tool name this template handles, or \"*\" for the wildcard catch-all.",
        "optional": false
      },
      {
        "name": "templateRef",
        "type": "TemplateRef<any>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "ChatToolViewsComponent",
    "kind": "class",
    "description": "Renders a frontend component for a tool call by reusing the chat\ncomposition's `views` registry. A tool call whose `name` matches a\nregistry key is bridged into a synthetic one-element render spec\n(`{ root: name, elements: { [name]: { type: name, props } } }`) and\nrendered through the existing render-spec pipeline.\n\nProps merge the live `args` (present while the call streams) with the\n`result` (on completion; a JSON-object string result is parsed first,\nsince that is how a LangGraph ToolMessage carries a dict return) and\nalways include `status`, so a view\ncomponent can show its own loading/empty/error states. `RenderElement`\nfilters props down to the component's declared inputs, so extra keys\n(and a `status` a component chooses not to declare) are harmless.",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "agent",
        "type": "InputSignal<Agent<unknown>>",
        "description": "",
        "optional": false
      },
      {
        "name": "events",
        "type": "OutputEmitterRef<RenderEvent>",
        "description": "",
        "optional": false
      },
      {
        "name": "handlers",
        "type": "InputSignal<Record<string, (params: Record<string, unknown>) => unknown>>",
        "description": "",
        "optional": false
      },
      {
        "name": "message",
        "type": "InputSignal<Message | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "registry",
        "type": "Signal<AngularRegistry | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "store",
        "type": "InputSignal<StateStore | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "toolViews",
        "type": "Signal<object[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "views",
        "type": "InputSignal<Readonly<Record<string, Type<unknown> | RenderViewEntry>> | undefined>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "ChatTraceComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "defaultExpanded",
        "type": "InputSignal<boolean>",
        "description": "When state is not 'running' or 'error', honors this input as the default expansion.",
        "optional": false
      },
      {
        "name": "expanded",
        "type": "Signal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "expandedStr",
        "type": "Signal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "state",
        "type": "InputSignal<TraceState>",
        "description": "",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "toggle",
        "signature": "toggle(): void",
        "description": "",
        "params": []
      }
    ]
  },
  {
    "name": "ChatTypingIndicatorComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "agent",
        "type": "InputSignal<Agent<unknown>>",
        "description": "",
        "optional": false
      },
      {
        "name": "visible",
        "type": "Signal<boolean>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "ChatWelcomeComponent",
    "kind": "class",
    "description": "Empty-state owner. Renders a centered greeting + slot-projected input +\noptional vertical suggestion rows. Mounted only when the parent chat has\nno messages and welcome is not disabled.\n\nSlots:\n  [chatWelcomeTitle]       — replaces the default <h1> \"How can I help?\"\n  [chatWelcomeInput]       — projects the chat input into the center column\n  [chatWelcomeSuggestions] — projects suggestion rows below the input\n\nHost CSS variables (override on :host or any ancestor):\n  --tplane-chat-welcome-max-width  default 36rem\n  --tplane-chat-welcome-gap        default 1.25rem\n  --tplane-chat-welcome-padding    default 24px",
    "params": [],
    "examples": [],
    "properties": [],
    "methods": []
  },
  {
    "name": "ChatWelcomeSuggestionComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "description",
        "type": "InputSignal<string | undefined>",
        "description": "Optional short description, surfaced as a hover/focus tooltip on the chip.",
        "optional": false
      },
      {
        "name": "label",
        "type": "InputSignal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "selected",
        "type": "OutputEmitterRef<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "value",
        "type": "InputSignal<string>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "ChatWindowComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [],
    "methods": []
  },
  {
    "name": "CitationsResolverService",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "markdownDefs",
        "type": "WritableSignal<Map<string, CitationDefinition>>",
        "description": "",
        "optional": false
      },
      {
        "name": "message",
        "type": "WritableSignal<Message | null>",
        "description": "",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "lookup",
        "signature": "lookup(refId: string): Signal<ResolvedCitation | null>",
        "description": "",
        "params": [
          {
            "name": "refId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      }
    ]
  },
  {
    "name": "MarkdownAutolinkComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "node",
        "type": "InputSignal<MarkdownAutolinkNode>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "MarkdownBlockquoteComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "node",
        "type": "InputSignal<MarkdownBlockquoteNode>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "MarkdownChildrenComponent",
    "kind": "class",
    "description": "Recursively dispatches a parent node's children through the markdown view\nregistry. Each child's `type` is looked up in the registry; the resolved\ncomponent is rendered with `[node]` bound to that child.\n\nPosition-stable: `track $index` avoids NG0956 re-creation warnings that\noccur when the markdown pipeline re-parses content on every stream delta,\nproducing new child object references even for unchanged nodes.",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "children",
        "type": "Signal<readonly MarkdownNode[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "parent",
        "type": "InputSignal<MarkdownNode>",
        "description": "",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "resolve",
        "signature": "resolve(child: MarkdownNode): Type<unknown> | null",
        "description": "",
        "params": [
          {
            "name": "child",
            "type": "MarkdownNode",
            "description": "",
            "optional": false
          }
        ]
      }
    ]
  },
  {
    "name": "MarkdownCitationReferenceComponent",
    "kind": "class",
    "description": "Inline citation marker. Renders a numbered pill and reveals a provenance\npreview card (portaled via the connected-overlay primitive) on hover/focus\n(desktop) or tap (touch). Click navigates on desktop when a url exists;\non touch it previews instead of navigating.",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "node",
        "type": "InputSignal<MarkdownCitationReferenceNode>",
        "description": "",
        "optional": false
      },
      {
        "name": "open",
        "type": "WritableSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "positions",
        "type": "ConnectedPosition[]",
        "description": "",
        "optional": false
      },
      {
        "name": "resolved",
        "type": "Signal<ResolvedCitation | null>",
        "description": "",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "ariaLabel",
        "signature": "ariaLabel(c: Citation): string",
        "description": "",
        "params": [
          {
            "name": "c",
            "type": "Citation",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "close",
        "signature": "close(): void",
        "description": "",
        "params": []
      },
      {
        "name": "onAttached",
        "signature": "onAttached(pane: HTMLElement): void",
        "description": "",
        "params": [
          {
            "name": "pane",
            "type": "HTMLElement",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onBlur",
        "signature": "onBlur(): void",
        "description": "",
        "params": []
      },
      {
        "name": "onClick",
        "signature": "onClick(e: MouseEvent, c: Citation): void",
        "description": "",
        "params": [
          {
            "name": "e",
            "type": "MouseEvent",
            "description": "",
            "optional": false
          },
          {
            "name": "c",
            "type": "Citation",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onEnter",
        "signature": "onEnter(): void",
        "description": "",
        "params": []
      },
      {
        "name": "onFocus",
        "signature": "onFocus(): void",
        "description": "",
        "params": []
      },
      {
        "name": "onKeydown",
        "signature": "onKeydown(e: KeyboardEvent, c: Citation): void",
        "description": "",
        "params": [
          {
            "name": "e",
            "type": "KeyboardEvent",
            "description": "",
            "optional": false
          },
          {
            "name": "c",
            "type": "Citation",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "onLeave",
        "signature": "onLeave(): void",
        "description": "",
        "params": []
      }
    ]
  },
  {
    "name": "MarkdownCodeBlockComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "languageClass",
        "type": "Signal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "node",
        "type": "InputSignal<MarkdownCodeBlockNode>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "MarkdownDocumentComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "node",
        "type": "InputSignal<MarkdownDocumentNode>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "MarkdownEmphasisComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "node",
        "type": "InputSignal<MarkdownEmphasisNode>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "MarkdownHardBreakComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "node",
        "type": "InputSignal<MarkdownHardBreakNode>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "MarkdownHeadingComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "node",
        "type": "InputSignal<MarkdownHeadingNode>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "MarkdownHtmlComponent",
    "kind": "class",
    "description": "Renders a `html-block` / `html-inline` markdown node as **escaped text** —\nthe raw HTML is shown literally (Angular interpolation auto-escapes it),\nnever injected as live markup. This preserves the pre-0.4 behavior where\nraw HTML was plain text, and keeps the chat XSS-safe: model-emitted\n`<script>`, `<iframe>`, etc. are displayed as text and never executed.",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "node",
        "type": "InputSignal<MarkdownHtmlBlockNode | MarkdownHtmlInlineNode>",
        "description": "",
        "optional": false
      },
      {
        "name": "raw",
        "type": "Signal<string>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "MarkdownImageComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "failed",
        "type": "WritableSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "node",
        "type": "InputSignal<MarkdownImageNode>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "MarkdownInlineCodeComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "node",
        "type": "InputSignal<MarkdownInlineCodeNode>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "MarkdownLinkComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "node",
        "type": "InputSignal<MarkdownLinkNode>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "MarkdownListComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "node",
        "type": "InputSignal<MarkdownListNode>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "MarkdownListItemComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "node",
        "type": "InputSignal<MarkdownListItemNode>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "MarkdownMathComponent",
    "kind": "class",
    "description": "Renders a `math-inline` / `math-display` markdown node as KaTeX. KaTeX is\nlazy-loaded (see katex-loader); until it resolves, or if the LaTeX is\ninvalid, the raw `$…$` source is shown — never blank, never a crash.",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "display",
        "type": "Signal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "html",
        "type": "Signal<SafeHtml | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "node",
        "type": "InputSignal<MathNode>",
        "description": "",
        "optional": false
      },
      {
        "name": "raw",
        "type": "Signal<string>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "MarkdownParagraphComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "node",
        "type": "InputSignal<MarkdownParagraphNode>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "MarkdownSoftBreakComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "node",
        "type": "InputSignal<MarkdownSoftBreakNode>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "MarkdownStrikethroughComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "node",
        "type": "InputSignal<MarkdownStrikethroughNode>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "MarkdownStrongComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "node",
        "type": "InputSignal<MarkdownStrongNode>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "MarkdownTableCellComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "alignment",
        "type": "Signal<Alignment>",
        "description": "",
        "optional": false
      },
      {
        "name": "isHeader",
        "type": "Signal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "node",
        "type": "InputSignal<MarkdownTableCellNode>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "MarkdownTableComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "bodyRows",
        "type": "Signal<MarkdownTableRowNode[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "headerRow",
        "type": "Signal<MarkdownTableRowNode | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "node",
        "type": "InputSignal<MarkdownTableNode>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "MarkdownTableRowComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "node",
        "type": "InputSignal<MarkdownTableRowNode>",
        "description": "",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "resolve",
        "signature": "resolve(child: MarkdownNode): Type<unknown> | null",
        "description": "",
        "params": [
          {
            "name": "child",
            "type": "MarkdownNode",
            "description": "",
            "optional": false
          }
        ]
      }
    ]
  },
  {
    "name": "MarkdownTextComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "node",
        "type": "InputSignal<MarkdownTextNode>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "MarkdownThematicBreakComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "node",
        "type": "InputSignal<MarkdownThematicBreakNode>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "MessageTemplateDirective",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "chatMessageTemplate",
        "type": "InputSignal<MessageTemplateType>",
        "description": "",
        "optional": false
      },
      {
        "name": "templateRef",
        "type": "TemplateRef<any>",
        "description": "",
        "optional": false
      }
    ],
    "methods": []
  },
  {
    "name": "A2uiComponentView",
    "kind": "interface",
    "description": "Chat-internal projection of an A2UI component, materialized by the\nsurface store. Distinct from the wire-format `A2uiComponent` in\n`@threadplane/a2ui` — this type adds the per-component readiness fields\nthe progressive renderer consumes.",
    "properties": [
      {
        "name": "bindings",
        "type": "readonly string[]",
        "description": "Data model paths this component references via its `{$.path}` prop\nexpressions. Extracted once on `updateComponents` apply; immutable.",
        "optional": false
      },
      {
        "name": "def",
        "type": "A2uiComponent",
        "description": "The raw wire-format component, retained so the slot directive\ncan look up the catalog entry by type and resolve nested children\non re-renders.",
        "optional": false
      },
      {
        "name": "id",
        "type": "string",
        "description": "The component's id (same as the wire-format `A2uiComponent.id`).",
        "optional": false
      },
      {
        "name": "props",
        "type": "Readonly<Record<string, unknown>>",
        "description": "Resolved property bag (reserved protocol keys stripped). Meaningful\nonly when `ready === true`.",
        "optional": false
      },
      {
        "name": "ready",
        "type": "boolean",
        "description": "Monotonic: `false` until every binding has resolved at least once\nin the accumulated data model, then `true` forever. Once `true`,\nsubsequent `updateDataModel` envelopes push new prop values but do\nNOT flip this back to `false`.",
        "optional": false
      },
      {
        "name": "type",
        "type": "string",
        "description": "The component type — e.g. `'Button'`, `'TextField'` — matched\nagainst catalog `views` entries. Mirrors the wire `component` string.",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiSurfaceState",
    "kind": "interface",
    "description": "Chat-side state for a surface — wraps the wire-format `A2uiSurface`\nwith the per-component projection the progressive renderer consumes.\nBoth maps are kept in sync; the wire shape preserves existing\n`surfaceToSpec` semantics, the view shape carries readiness.",
    "properties": [
      {
        "name": "componentViews",
        "type": "ReadonlyMap<string, A2uiComponentView>",
        "description": "",
        "optional": false
      },
      {
        "name": "surface",
        "type": "A2uiSurface",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiSurfaceStore",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "surfaces",
        "type": "Signal<Map<string, A2uiSurface>>",
        "description": "Wire-format surfaces, for downstream consumers (e.g. surfaceToSpec).",
        "optional": false
      },
      {
        "name": "surfaceStates",
        "type": "Signal<Map<string, A2uiSurfaceState>>",
        "description": "Chat-side projections with per-component readiness.",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "apply",
        "signature": "apply(message: A2uiMessage): void",
        "description": "",
        "params": [
          {
            "name": "message",
            "type": "A2uiMessage",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "applyPartialArgs",
        "signature": "applyPartialArgs(toolCallId: string, envelopes: readonly A2uiMessage[]): void",
        "description": "Live-stream entry point. Iterates envelopes and feeds each through\n`apply()`. Records the tool_call_id so the wrapped-content classifier\ncan short-circuit duplicate dispatch when the final AIMessage arrives.",
        "params": [
          {
            "name": "toolCallId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "envelopes",
            "type": "readonly A2uiMessage[]",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "isPartialLive",
        "signature": "isPartialLive(toolCallId: string): boolean",
        "description": "True if a tool_call_id has produced live envelopes via applyPartialArgs.",
        "params": [
          {
            "name": "toolCallId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "surface",
        "signature": "surface(surfaceId: string): Signal<any>",
        "description": "",
        "params": [
          {
            "name": "surfaceId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "surfaceState",
        "signature": "surfaceState(surfaceId: string): Signal<A2uiSurfaceState | undefined>",
        "description": "",
        "params": [
          {
            "name": "surfaceId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      }
    ],
    "examples": []
  },
  {
    "name": "Agent",
    "kind": "interface",
    "description": "Runtime-neutral contract chat primitives consume.\n\nImplementations are produced by runtime adapters (e.g. a LangGraph or\nAG-UI adapter) or by user code for custom backends.\n\n`interrupt` and `subagents` are optional: runtimes that do not support these\nconcepts should leave them undefined, and primitives that need them check\npresence and render a neutral fallback when absent.\n\nInvariant: state lives on signals; `events$` carries only things that are\nnot derivable from signals.",
    "properties": [
      {
        "name": "clientTools",
        "type": "ClientToolsCapability",
        "description": "Optional: client-declared, client-executed tools (see ClientToolsCapability).",
        "optional": true
      },
      {
        "name": "error",
        "type": "Signal<AgentError<> | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "events$",
        "type": "Observable<AgentEvent>",
        "description": "",
        "optional": false
      },
      {
        "name": "interrupt",
        "type": "Signal<AgentInterrupt | undefined>",
        "description": "",
        "optional": true
      },
      {
        "name": "isLoading",
        "type": "Signal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "messages",
        "type": "Signal<Message[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "regenerate",
        "type": "(assistantMessageIndex: number) => Promise<void>",
        "description": "Discards the assistant message at the given index AND all messages after\nit, then re-runs the agent against the trimmed conversation tail. The\npreceding user message (at index - 1) is preserved and re-submitted as\nthe agent's input. No new user message is added to the history.\n\nThrows if the message at `index` is not 'assistant' role, or if the\nagent is currently loading another response.",
        "optional": false
      },
      {
        "name": "retry",
        "type": "() => Promise<void>",
        "description": "Re-run the last submitted input after a failure. No-op if a run is already\n in flight or there is nothing to retry. Clears `error` and sets loading.",
        "optional": false
      },
      {
        "name": "state",
        "type": "Signal<TState>",
        "description": "",
        "optional": false
      },
      {
        "name": "status",
        "type": "Signal<AgentStatus>",
        "description": "",
        "optional": false
      },
      {
        "name": "stop",
        "type": "() => Promise<void>",
        "description": "",
        "optional": false
      },
      {
        "name": "subagents",
        "type": "Signal<Map<string, Subagent>>",
        "description": "",
        "optional": true
      },
      {
        "name": "submit",
        "type": "(input: AgentSubmitInput, opts: AgentSubmitOptions) => Promise<void>",
        "description": "",
        "optional": false
      },
      {
        "name": "toolCalls",
        "type": "Signal<ToolCall[]>",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "AgentCheckpoint",
    "kind": "interface",
    "description": "Runtime-neutral snapshot of a point in an agent's execution history.\n\nConsumed by time-travel / debug UIs. `id` is adapter-opaque — UIs emit\nit back to the parent app on replay/fork, and the parent app dispatches\nto the underlying runtime.",
    "properties": [
      {
        "name": "id",
        "type": "string",
        "description": "Adapter-opaque checkpoint identifier (e.g. LangGraph checkpoint_id).",
        "optional": true
      },
      {
        "name": "label",
        "type": "string",
        "description": "Human-friendly label for the checkpoint (e.g. next node name).",
        "optional": true
      },
      {
        "name": "values",
        "type": "Record<string, unknown>",
        "description": "State snapshot at this checkpoint.",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "AgentCustomEvent",
    "kind": "interface",
    "description": "Escape hatch for runtime-specific or user-defined events that do not\n(yet) have a well-known structured variant. `name` carries the runtime\nevent name; `data` carries the payload verbatim.",
    "properties": [
      {
        "name": "data",
        "type": "unknown",
        "description": "",
        "optional": false
      },
      {
        "name": "name",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "type",
        "type": "\"custom\"",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "AgentInterrupt",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "id",
        "type": "string",
        "description": "Stable identifier for this interrupt instance.",
        "optional": false
      },
      {
        "name": "resumable",
        "type": "boolean",
        "description": "True when the runtime supports resuming via `submit({ resume })`.",
        "optional": false
      },
      {
        "name": "value",
        "type": "unknown",
        "description": "Opaque payload the app renders. Runtime-specific shape.",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "AgentRef",
    "kind": "interface",
    "description": "A typed handle that threads a state shape through Angular DI from\n `provideAgent(ref, …)` to `injectAgent(ref)` without per-call-site\n restatement of the generic.",
    "properties": [
      {
        "name": "token",
        "type": "InjectionToken<Agent<TState>>",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "AgentRuntimeTelemetryPayload",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "event",
        "type": "AgentRuntimeTelemetryEvent",
        "description": "",
        "optional": false
      },
      {
        "name": "properties",
        "type": "AgentRuntimeTelemetryProperties",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "AgentRuntimeTelemetryProperties",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "durationMs",
        "type": "number",
        "description": "",
        "optional": true
      },
      {
        "name": "errorClass",
        "type": "string",
        "description": "",
        "optional": true
      },
      {
        "name": "model",
        "type": "string",
        "description": "",
        "optional": true
      },
      {
        "name": "provider",
        "type": "string",
        "description": "",
        "optional": true
      },
      {
        "name": "requestType",
        "type": "string",
        "description": "",
        "optional": true
      },
      {
        "name": "surface",
        "type": "string",
        "description": "",
        "optional": true
      },
      {
        "name": "transport",
        "type": "string",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "AgentStateUpdateEvent",
    "kind": "interface",
    "description": "Render-state-store sync event. Adapters emit this when the runtime\npublishes a state-snapshot intended for the chat library's render store\n(used by generative UI and a2ui surfaces).",
    "properties": [
      {
        "name": "data",
        "type": "Record<string, unknown>",
        "description": "",
        "optional": false
      },
      {
        "name": "type",
        "type": "\"state_update\"",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "AgentSubmitInput",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "message",
        "type": "string | ContentBlock[]",
        "description": "New user message to append. May be combined with `resume` and/or `state` in the same submit call.",
        "optional": true
      },
      {
        "name": "resume",
        "type": "unknown",
        "description": "Resume payload for an active interrupt.",
        "optional": true
      },
      {
        "name": "state",
        "type": "Record<string, unknown>",
        "description": "State patch to merge before submitting (runtime-interpreted).",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "AgentSubmitOptions",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "signal",
        "type": "AbortSignal",
        "description": "",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "AgentWithHistory",
    "kind": "interface",
    "description": "Extension of Agent that exposes checkpoint history for time-travel UIs.\n\nConcrete adapters that record per-node checkpoints (e.g. LangGraph) should\nimplement this. Pure request/response runtimes that don't have checkpoints\nshould implement plain Agent.",
    "properties": [
      {
        "name": "clientTools",
        "type": "ClientToolsCapability",
        "description": "Optional: client-declared, client-executed tools (see ClientToolsCapability).",
        "optional": true
      },
      {
        "name": "error",
        "type": "Signal<AgentError<> | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "events$",
        "type": "Observable<AgentEvent>",
        "description": "",
        "optional": false
      },
      {
        "name": "history",
        "type": "Signal<AgentCheckpoint[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "interrupt",
        "type": "Signal<AgentInterrupt | undefined>",
        "description": "",
        "optional": true
      },
      {
        "name": "isLoading",
        "type": "Signal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "messageCheckpoints",
        "type": "Signal<ReadonlyMap<string, string>>",
        "description": "Optional reactive map of `messageId → checkpointId`, computed by\nwalking history once: for each checkpoint, find the most recent\nassistant message present in its `values.messages` and pair them.\nUIs use this to anchor inline checkpoint markers on each assistant\nturn. Missing on adapters that don't compute it.",
        "optional": true
      },
      {
        "name": "messages",
        "type": "Signal<Message[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "regenerate",
        "type": "(assistantMessageIndex: number) => Promise<void>",
        "description": "Discards the assistant message at the given index AND all messages after\nit, then re-runs the agent against the trimmed conversation tail. The\npreceding user message (at index - 1) is preserved and re-submitted as\nthe agent's input. No new user message is added to the history.\n\nThrows if the message at `index` is not 'assistant' role, or if the\nagent is currently loading another response.",
        "optional": false
      },
      {
        "name": "retry",
        "type": "() => Promise<void>",
        "description": "Re-run the last submitted input after a failure. No-op if a run is already\n in flight or there is nothing to retry. Clears `error` and sets loading.",
        "optional": false
      },
      {
        "name": "state",
        "type": "Signal<TState>",
        "description": "",
        "optional": false
      },
      {
        "name": "status",
        "type": "Signal<AgentStatus>",
        "description": "",
        "optional": false
      },
      {
        "name": "stop",
        "type": "() => Promise<void>",
        "description": "",
        "optional": false
      },
      {
        "name": "subagents",
        "type": "Signal<Map<string, Subagent>>",
        "description": "",
        "optional": true
      },
      {
        "name": "submit",
        "type": "(input: AgentSubmitInput, opts: AgentSubmitOptions) => Promise<void>",
        "description": "",
        "optional": false
      },
      {
        "name": "toolCalls",
        "type": "Signal<ToolCall[]>",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "AnyFunctionToolDef",
    "kind": "interface",
    "description": "Bivariant union member used only for registry storage/iteration. The handler\n param is `any` (NOT `never`): `any` is simultaneously a supertype any precise\n `FunctionToolDef<S,R>` is assignable to under `strictFunctionTypes`, AND\n callable by internal code that has narrowed by `kind` and parsed runtime args.\n A `never` param would satisfy the former but break the latter.",
    "properties": [
      {
        "name": "description",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "followUp",
        "type": "boolean",
        "description": "",
        "optional": true
      },
      {
        "name": "handler",
        "type": "(args: any, context: FunctionToolHandlerContext) => unknown",
        "description": "",
        "optional": false
      },
      {
        "name": "idempotent",
        "type": "boolean",
        "description": "",
        "optional": true
      },
      {
        "name": "kind",
        "type": "\"function\"",
        "description": "",
        "optional": false
      },
      {
        "name": "schema",
        "type": "StandardSchemaV1<>",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "AskToolDef",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "component",
        "type": "Type<C>",
        "description": "",
        "optional": false
      },
      {
        "name": "description",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "followUp",
        "type": "boolean",
        "description": "",
        "optional": true
      },
      {
        "name": "kind",
        "type": "\"ask\"",
        "description": "",
        "optional": false
      },
      {
        "name": "schema",
        "type": "S",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "ChatConfig",
    "kind": "interface",
    "description": "Application-wide options for provideChat. Every field is optional;\nthe values are exposed to all chat components in the tree via the\n`CHAT_CONFIG` injection token, so you set them once at bootstrap instead of\nthreading props through every component.",
    "properties": [
      {
        "name": "assistantName",
        "type": "string",
        "description": "Shared assistant display name for consumers that read CHAT_CONFIG (default: \"Assistant\").",
        "optional": true
      },
      {
        "name": "avatarLabel",
        "type": "string",
        "description": "Shared AI avatar label for consumers that read CHAT_CONFIG (default: \"A\").",
        "optional": true
      },
      {
        "name": "renderRegistry",
        "type": "AngularRegistry",
        "description": "Shared render registry for consumers that read CHAT_CONFIG.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "ChatLifecycle",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "componentReady",
        "type": "Signal<boolean>",
        "description": "True after `<chat>` initializes with a non-null agent binding.",
        "optional": false
      },
      {
        "name": "firstMessageSent",
        "type": "Signal<boolean>",
        "description": "True after the first user submit. Sticky for the life of the chat instance — does NOT reset on clearThread.",
        "optional": false
      },
      {
        "name": "inputSubmittedAt",
        "type": "Signal<number | null>",
        "description": "Epoch ms of the most recent user submit. Resets on clearThread.",
        "optional": false
      },
      {
        "name": "messageCount",
        "type": "Signal<number>",
        "description": "Count of user submits. Resets on clearThread.",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "ChatRenderEvent",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "event",
        "type": "RenderEvent",
        "description": "",
        "optional": false
      },
      {
        "name": "messageIndex",
        "type": "number",
        "description": "",
        "optional": false
      },
      {
        "name": "surfaceId",
        "type": "string",
        "description": "",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "ChatSelectOption",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "description",
        "type": "string",
        "description": "",
        "optional": true
      },
      {
        "name": "disabled",
        "type": "boolean",
        "description": "",
        "optional": true
      },
      {
        "name": "label",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "value",
        "type": "string",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "ChatToolCallTemplateContext",
    "kind": "interface",
    "description": "Template-context surface available to a per-tool template. The first\nargument is the ToolCall itself (let-call); status is exposed as a\nnamed context property (let-status=\"status\").",
    "properties": [
      {
        "name": "$implicit",
        "type": "ToolCall",
        "description": "",
        "optional": false
      },
      {
        "name": "status",
        "type": "ToolCallStatus",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "Citation",
    "kind": "interface",
    "description": "Provider-agnostic citation entry. Populated by adapters from message\nmetadata (LangGraph additional_kwargs.citations, AG-UI STATE_DELTA at\n/citations/{messageId}). Pandoc-formatted [^id]: ... defs in message\ncontent remain in the markdown AST sidecar and are merged via\nCitationsResolverService at render time.",
    "properties": [
      {
        "name": "extra",
        "type": "Record<string, unknown>",
        "description": "Provider-specific extras (retrieval score, source type, etc.).",
        "optional": true
      },
      {
        "name": "iconUrl",
        "type": "string",
        "description": "Provider-supplied favicon/logo (absolute URL or `data:` URI). NEVER\nauto-fetched by the library — supply this from your own resolver if you\nwant real favicons; otherwise a monogram is rendered.",
        "optional": true
      },
      {
        "name": "id",
        "type": "string",
        "description": "Stable id used to match `[^id]` markers in Pandoc-formatted content.",
        "optional": false
      },
      {
        "name": "index",
        "type": "number",
        "description": "1-based display order. Stable per-message.",
        "optional": false
      },
      {
        "name": "publishedAt",
        "type": "string | number | Date",
        "description": "Freshness signal shown in the preview-card footer.",
        "optional": true
      },
      {
        "name": "snippet",
        "type": "string",
        "description": "",
        "optional": true
      },
      {
        "name": "sourceType",
        "type": "string",
        "description": "Source classification driving the type badge. Free-form and extensible:\n'web' (default-inferred from an http(s) url) | 'file' | 'app' | 'memory'\n| any custom string. Optional — display derives 'web' from the url when absent.",
        "optional": true
      },
      {
        "name": "title",
        "type": "string",
        "description": "",
        "optional": true
      },
      {
        "name": "url",
        "type": "string",
        "description": "",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "CitationImageVisual",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "iconUrl",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "kind",
        "type": "\"image\"",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "CitationMonogramVisual",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "color",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "kind",
        "type": "\"monogram\"",
        "description": "",
        "optional": false
      },
      {
        "name": "monogram",
        "type": "string",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "CitationTypeIconVisual",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "icon",
        "type": "CitationTypeIcon",
        "description": "",
        "optional": false
      },
      {
        "name": "kind",
        "type": "\"type-icon\"",
        "description": "",
        "optional": false
      },
      {
        "name": "label",
        "type": "string | null",
        "description": "",
        "optional": false
      },
      {
        "name": "tone",
        "type": "CitationTypeIcon",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "CitationTypeMeta",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "icon",
        "type": "CitationTypeIcon",
        "description": "",
        "optional": false
      },
      {
        "name": "isKnown",
        "type": "boolean",
        "description": "",
        "optional": false
      },
      {
        "name": "label",
        "type": "string | null",
        "description": "",
        "optional": false
      },
      {
        "name": "tone",
        "type": "CitationTypeIcon",
        "description": "",
        "optional": false
      },
      {
        "name": "type",
        "type": "string",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "ClientToolContinuationLimitEvent",
    "kind": "interface",
    "description": "Diagnostic emitted when client-tool continuation would exceed the configured max turn count.",
    "properties": [
      {
        "name": "attemptedTurn",
        "type": "number",
        "description": "",
        "optional": false
      },
      {
        "name": "maxTurns",
        "type": "number",
        "description": "",
        "optional": false
      },
      {
        "name": "toolCallIds",
        "type": "readonly string[]",
        "description": "",
        "optional": false
      },
      {
        "name": "toolNames",
        "type": "readonly string[]",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "ClientToolContinuationOptions",
    "kind": "interface",
    "description": "Execution policy options for browser-executed function tools.",
    "properties": [
      {
        "name": "followUp",
        "type": "boolean",
        "description": "False when the tool result should be recorded without forcing a continuation.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "ClientToolContinuationPolicy",
    "kind": "interface",
    "description": "Policy for automatic client-tool continuation.",
    "properties": [
      {
        "name": "maxTurns",
        "type": "number",
        "description": "Maximum consecutive client-tool continuation groups per user turn. Default: 10. Use 0 for unlimited.",
        "optional": true
      },
      {
        "name": "onLimit",
        "type": "(event: ClientToolContinuationLimitEvent) => void",
        "description": "Called when the max-turn guard stops a continuation group.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "ClientToolExecutionGuard",
    "kind": "interface",
    "description": "Opt-in guard configuration for claim-before-execute client tools.",
    "properties": [
      {
        "name": "store",
        "type": "ClientToolExecutionStore",
        "description": "",
        "optional": false
      },
      {
        "name": "threadId",
        "type": "string",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "ClientToolExecutionKey",
    "kind": "interface",
    "description": "Durable identity for one client-tool execution on one thread.",
    "properties": [
      {
        "name": "threadId",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "toolCallId",
        "type": "string",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "ClientToolExecutionOptions",
    "kind": "interface",
    "description": "Execution policy options for browser-executed function tools.",
    "properties": [
      {
        "name": "followUp",
        "type": "boolean",
        "description": "False when the tool result should be recorded without forcing a continuation.",
        "optional": true
      },
      {
        "name": "idempotent",
        "type": "boolean",
        "description": "True when the handler may safely re-run and should skip durable pre-claims.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "ClientToolExecutionStore",
    "kind": "interface",
    "description": "Structural store contract for guarded browser client-tool execution.",
    "properties": [],
    "methods": [
      {
        "name": "claim",
        "signature": "claim(key: ClientToolExecutionKey): Promise<\"claimed\" | ClientToolExecutionRecord>",
        "description": "Atomically claim a tool-call execution. Returns prior state when present.",
        "params": [
          {
            "name": "key",
            "type": "ClientToolExecutionKey",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "lookup",
        "signature": "lookup(threadId: string, toolCallIds: readonly string[]): Promise<Record<string, ClientToolExecutionRecord>>",
        "description": "Lookup prior execution states for pending tool calls on a thread.",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "toolCallIds",
            "type": "readonly string[]",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "record",
        "signature": "record(key: ClientToolExecutionKey, result: ClientToolResult): Promise<void>",
        "description": "Record the final client-tool result for a claimed execution.",
        "params": [
          {
            "name": "key",
            "type": "ClientToolExecutionKey",
            "description": "",
            "optional": false
          },
          {
            "name": "result",
            "type": "ClientToolResult",
            "description": "",
            "optional": false
          }
        ]
      }
    ],
    "examples": []
  },
  {
    "name": "ClientToolExecutorOptions",
    "kind": "interface",
    "description": "Options for wiring automatic browser function-tool execution.",
    "properties": [
      {
        "name": "executionGuard",
        "type": "ClientToolExecutionGuard",
        "description": "",
        "optional": true
      },
      {
        "name": "settleToolCall",
        "type": "(toolCall: ToolCall, result: ClientToolResult) => void",
        "description": "",
        "optional": true
      },
      {
        "name": "settleWithoutContinuing",
        "type": "(toolCall: ToolCall, result: ClientToolResult) => void",
        "description": "Settlement for calls that must NOT continue the run (user abort, teardown).",
        "optional": true
      },
      {
        "name": "shouldExecuteToolCall",
        "type": "(toolCall: ToolCall) => boolean",
        "description": "",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "ClientToolLifecycle",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "error",
        "type": "unknown",
        "description": "",
        "optional": true
      },
      {
        "name": "hasResult",
        "type": "boolean",
        "description": "",
        "optional": false
      },
      {
        "name": "id",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "name",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "phase",
        "type": "ClientToolLifecyclePhase",
        "description": "",
        "optional": false
      },
      {
        "name": "result",
        "type": "unknown",
        "description": "",
        "optional": true
      },
      {
        "name": "status",
        "type": "ToolCallStatus",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "ClientToolsCapability",
    "kind": "interface",
    "description": "Optional Agent capability that lets the client declare tools to the model\nand return their results. Implemented per-transport by each adapter\n(AG-UI: native RunAgentInput.tools + addMessage/re-run; LangGraph: catalog\nvia run input + ToolMessage re-run).",
    "properties": [
      {
        "name": "pending",
        "type": "Signal<readonly ToolCall[]>",
        "description": "Tool calls the model made for client tools that await a client result.",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "flush",
        "signature": "flush(): void | Promise<void>",
        "description": "Make every result recorded via settle durable on the server\nWITHOUT continuing the run. No-op for adapters whose settle() is already\ndurable. Adapters that buffer locally MUST clear their buffer only on a\nsuccessful write, so a failure degrades to a later flush or submit.",
        "params": []
      },
      {
        "name": "resolve",
        "signature": "resolve(toolCallId: string, result: ClientToolResult): void",
        "description": "Return a client tool's result (or error) and continue the run.",
        "params": [
          {
            "name": "toolCallId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "result",
            "type": "ClientToolResult",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "setCatalog",
        "signature": "setCatalog(specs: readonly ClientToolSpec[]): void",
        "description": "Ship the client tool catalog to the model at run start.",
        "params": [
          {
            "name": "specs",
            "type": "readonly ClientToolSpec[]",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "settle",
        "signature": "settle(toolCallId: string, result: ClientToolResult): void",
        "description": "Record a client tool's result without continuing the run.",
        "params": [
          {
            "name": "toolCallId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "result",
            "type": "ClientToolResult",
            "description": "",
            "optional": false
          }
        ]
      }
    ],
    "examples": []
  },
  {
    "name": "ClientToolsCoordinator",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "viewRegistry",
        "type": "ViewRegistry",
        "description": "Components for `view`/`ask` tools, keyed by tool name — merge into the chat `views`.",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "connect",
        "signature": "connect(agent: Agent<>): void",
        "description": "Wire the coordinator to an agent: ship the catalog, run function tools, auto-ack view tools.\n MUST be called inside an injection context (sets up effects). Safe no-op if the agent lacks\n the clientTools capability.",
        "params": [
          {
            "name": "agent",
            "type": "Agent<>",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "handleRenderEvent",
        "signature": "handleRenderEvent(agent: Agent<>, event: RenderEvent): void",
        "description": "Handle a render event bubbled up from a mounted view/ask component (resolves `ask` results).",
        "params": [
          {
            "name": "agent",
            "type": "Agent<>",
            "description": "",
            "optional": false
          },
          {
            "name": "event",
            "type": "RenderEvent",
            "description": "",
            "optional": false
          }
        ]
      }
    ],
    "examples": []
  },
  {
    "name": "ClientToolSpec",
    "kind": "interface",
    "description": "A client tool spec as shipped to the model / AG-UI RunAgentInput.tools.",
    "properties": [
      {
        "name": "description",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "name",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "parameters",
        "type": "Record<string, unknown>",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "ConnectedPosition",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "offsetX",
        "type": "number",
        "description": "",
        "optional": true
      },
      {
        "name": "offsetY",
        "type": "number",
        "description": "",
        "optional": true
      },
      {
        "name": "originX",
        "type": "HorizontalConnectionPos",
        "description": "",
        "optional": false
      },
      {
        "name": "originY",
        "type": "VerticalConnectionPos",
        "description": "",
        "optional": false
      },
      {
        "name": "overlayX",
        "type": "HorizontalConnectionPos",
        "description": "",
        "optional": false
      },
      {
        "name": "overlayY",
        "type": "VerticalConnectionPos",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "ContentClassifier",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "a2uiSurfaces",
        "type": "Signal<Map<string, A2uiSurface>>",
        "description": "",
        "optional": false
      },
      {
        "name": "a2uiSurfaceStates",
        "type": "Signal<Map<string, A2uiSurfaceState>>",
        "description": "",
        "optional": false
      },
      {
        "name": "elementStates",
        "type": "Signal<Map<string, ElementAccumulationState>>",
        "description": "",
        "optional": false
      },
      {
        "name": "errors",
        "type": "Signal<string[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "markdown",
        "type": "Signal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "spec",
        "type": "Signal<Spec | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "streaming",
        "type": "Signal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "type",
        "type": "Signal<ContentType>",
        "description": "",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "dispose",
        "signature": "dispose(): void",
        "description": "",
        "params": []
      },
      {
        "name": "update",
        "signature": "update(content: string): void",
        "description": "",
        "params": [
          {
            "name": "content",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      }
    ],
    "examples": []
  },
  {
    "name": "ElementAccumulationState",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "hasChildren",
        "type": "boolean",
        "description": "",
        "optional": false
      },
      {
        "name": "hasProps",
        "type": "boolean",
        "description": "",
        "optional": false
      },
      {
        "name": "hasType",
        "type": "boolean",
        "description": "",
        "optional": false
      },
      {
        "name": "streaming",
        "type": "boolean",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "FunctionToolDef",
    "kind": "interface",
    "description": "Precise authored function tool — what `action()` returns. Carries the schema\n `S` and the handler's resolved return type `R`.",
    "properties": [
      {
        "name": "description",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "followUp",
        "type": "boolean",
        "description": "",
        "optional": true
      },
      {
        "name": "handler",
        "type": "(args: StandardSchemaInferOutput<S>, context: FunctionToolHandlerContext) => R | Promise<R>",
        "description": "",
        "optional": false
      },
      {
        "name": "idempotent",
        "type": "boolean",
        "description": "",
        "optional": true
      },
      {
        "name": "kind",
        "type": "\"function\"",
        "description": "",
        "optional": false
      },
      {
        "name": "schema",
        "type": "S",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "FunctionToolHandlerContext",
    "kind": "interface",
    "description": "Runtime context passed to browser-executed function tool handlers.",
    "properties": [
      {
        "name": "signal",
        "type": "AbortSignal",
        "description": "Aborts when the client tool execution should stop without resolving.",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "Message",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "citations",
        "type": "Citation[]",
        "description": "Provider-agnostic citation list. Populated by adapters.",
        "optional": true
      },
      {
        "name": "content",
        "type": "string | ContentBlock[]",
        "description": "Plain text, or a list of structured content blocks.",
        "optional": false
      },
      {
        "name": "delivery",
        "type": "MessageDelivery",
        "description": "Adapter-owned authoritative delivery lifecycle state for this message.",
        "optional": false
      },
      {
        "name": "extra",
        "type": "Record<string, unknown>",
        "description": "Runtime-specific extras; do not rely on shape in portable code.",
        "optional": true
      },
      {
        "name": "id",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "name",
        "type": "string",
        "description": "Optional display/author name.",
        "optional": true
      },
      {
        "name": "reasoning",
        "type": "string",
        "description": "Reasoning text emitted by the model before/alongside the visible\nresponse. Populated by adapters from {type:'reasoning'} or\n{type:'thinking'} content blocks (LangGraph) or REASONING_MESSAGE_*\nevents (AG-UI). Always a plain string — provider-specific shape\n(encrypted blocks, multi-step summaries) is absorbed by the adapter\nand not surfaced here.",
        "optional": true
      },
      {
        "name": "reasoningDurationMs",
        "type": "number",
        "description": "Wall-clock duration of the reasoning phase in milliseconds.\nPopulated by the adapter when both start (first reasoning chunk) and\nend (first response-text chunk, or final canonical message) are\nknown. Undefined when reasoning timing isn't available.",
        "optional": true
      },
      {
        "name": "role",
        "type": "Role",
        "description": "",
        "optional": false
      },
      {
        "name": "toolCallId",
        "type": "string",
        "description": "Present when role === 'tool'.",
        "optional": true
      },
      {
        "name": "toolCallIds",
        "type": "string[]",
        "description": "IDs of tool calls emitted BY this assistant message. Populated by\nadapters from provider-native fields (LangGraph: `tool_calls[].id`;\nAnthropic: `tool_use` content blocks). Used by `<chat-tool-calls>` to\nscope its rendering to a single message — otherwise it falls back to\nthe agent's global toolCalls list, which renders duplicates across\nevery AI message in a thread.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "MockAgent",
    "kind": "interface",
    "description": "Runtime-neutral contract chat primitives consume.\n\nImplementations are produced by runtime adapters (e.g. a LangGraph or\nAG-UI adapter) or by user code for custom backends.\n\n`interrupt` and `subagents` are optional: runtimes that do not support these\nconcepts should leave them undefined, and primitives that need them check\npresence and render a neutral fallback when absent.\n\nInvariant: state lives on signals; `events$` carries only things that are\nnot derivable from signals.",
    "properties": [
      {
        "name": "_internal",
        "type": "object",
        "description": "Test-only escape hatch for driving lifecycle signals from a spec. Mirrors\nthe `_internal` pattern used by CHAT_LIFECYCLE so tests can flip the\nunderlying writable without going through a full submit/stream cycle.",
        "optional": false
      },
      {
        "name": "clientTools",
        "type": "ClientToolsCapability",
        "description": "Optional: client-declared, client-executed tools (see ClientToolsCapability).",
        "optional": true
      },
      {
        "name": "error",
        "type": "WritableSignal<AgentError<> | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "events$",
        "type": "Observable<AgentEvent>",
        "description": "",
        "optional": false
      },
      {
        "name": "history",
        "type": "WritableSignal<AgentCheckpoint[]>",
        "description": "",
        "optional": true
      },
      {
        "name": "interrupt",
        "type": "WritableSignal<AgentInterrupt | undefined>",
        "description": "",
        "optional": true
      },
      {
        "name": "isLoading",
        "type": "WritableSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "lifecycle",
        "type": "object",
        "description": "Minimal lifecycle stub the chat lib's effects subscribe to. We only\nmodel the signals the chat composition currently reads; richer adapter\nlifecycles (langgraph, AG-UI) extend this contract on their own mocks.\nThe public `lifecycle` view is a readonly signal; tests drive the\nvalue via `_internal.streamStartedAt.set(...)` below.",
        "optional": false
      },
      {
        "name": "messages",
        "type": "WritableSignal<Message[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "regenerate",
        "type": "(assistantMessageIndex: number) => Promise<void>",
        "description": "Discards the assistant message at the given index AND all messages after\nit, then re-runs the agent against the trimmed conversation tail. The\npreceding user message (at index - 1) is preserved and re-submitted as\nthe agent's input. No new user message is added to the history.\n\nThrows if the message at `index` is not 'assistant' role, or if the\nagent is currently loading another response.",
        "optional": false
      },
      {
        "name": "retry",
        "type": "() => Promise<void>",
        "description": "Re-run the last submitted input after a failure. No-op if a run is already\n in flight or there is nothing to retry. Clears `error` and sets loading.",
        "optional": false
      },
      {
        "name": "state",
        "type": "WritableSignal<Record<string, unknown>>",
        "description": "",
        "optional": false
      },
      {
        "name": "status",
        "type": "WritableSignal<AgentStatus>",
        "description": "",
        "optional": false
      },
      {
        "name": "stop",
        "type": "() => Promise<void>",
        "description": "",
        "optional": false
      },
      {
        "name": "stopCount",
        "type": "number",
        "description": "Count of stop() invocations.",
        "optional": false
      },
      {
        "name": "subagents",
        "type": "WritableSignal<Map<string, Subagent>>",
        "description": "",
        "optional": true
      },
      {
        "name": "submit",
        "type": "(input: AgentSubmitInput, opts: AgentSubmitOptions) => Promise<void>",
        "description": "",
        "optional": false
      },
      {
        "name": "submitCalls",
        "type": "object[]",
        "description": "Captured calls to submit() in order.",
        "optional": false
      },
      {
        "name": "toolCalls",
        "type": "WritableSignal<ToolCall[]>",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "MockAgentOptions",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "error",
        "type": "AgentError<>",
        "description": "",
        "optional": true
      },
      {
        "name": "events$",
        "type": "Observable<AgentEvent>",
        "description": "",
        "optional": true
      },
      {
        "name": "history",
        "type": "AgentCheckpoint[]",
        "description": "",
        "optional": true
      },
      {
        "name": "isLoading",
        "type": "boolean",
        "description": "",
        "optional": true
      },
      {
        "name": "messages",
        "type": "Message[]",
        "description": "",
        "optional": true
      },
      {
        "name": "state",
        "type": "Record<string, unknown>",
        "description": "",
        "optional": true
      },
      {
        "name": "status",
        "type": "AgentStatus",
        "description": "",
        "optional": true
      },
      {
        "name": "toolCalls",
        "type": "ToolCall[]",
        "description": "",
        "optional": true
      },
      {
        "name": "withInterrupt",
        "type": "boolean",
        "description": "",
        "optional": true
      },
      {
        "name": "withSubagents",
        "type": "boolean",
        "description": "",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "OverflowMenuItem",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "disabled",
        "type": "boolean",
        "description": "Disabled items render muted and ignore clicks/keypresses.",
        "optional": true
      },
      {
        "name": "id",
        "type": "string",
        "description": "Stable id emitted via (itemSelected).",
        "optional": false
      },
      {
        "name": "label",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "tone",
        "type": "\"normal\" | \"destructive\"",
        "description": "'destructive' renders the label in red. Default 'normal'.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "OverlayPositionResult",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "left",
        "type": "number",
        "description": "",
        "optional": false
      },
      {
        "name": "position",
        "type": "ConnectedPosition",
        "description": "",
        "optional": false
      },
      {
        "name": "top",
        "type": "number",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "ParseTreeStore",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "elementStates",
        "type": "Signal<Map<string, ElementAccumulationState>>",
        "description": "",
        "optional": false
      },
      {
        "name": "spec",
        "type": "Signal<Spec | null>",
        "description": "",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "push",
        "signature": "push(chunk: string): void",
        "description": "",
        "params": [
          {
            "name": "chunk",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      }
    ],
    "examples": []
  },
  {
    "name": "PartialArgsBridge",
    "kind": "interface",
    "description": "",
    "properties": [],
    "methods": [
      {
        "name": "isPoisoned",
        "signature": "isPoisoned(toolCallId: string): boolean",
        "description": "True if a tool_call_id has been poisoned by malformed input.",
        "params": [
          {
            "name": "toolCallId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "push",
        "signature": "push(toolCallId: string, argsSoFar: string): void",
        "description": "Replace the cumulative argument-string buffer for `toolCallId` with\n`argsSoFar` and re-extract any newly-complete envelopes. The args\nstring is expected to grow monotonically.",
        "params": [
          {
            "name": "toolCallId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "argsSoFar",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      }
    ],
    "examples": []
  },
  {
    "name": "ProjectActionAdapter",
    "kind": "interface",
    "description": "Consumer-provided adapter for project lifecycle actions. The framework calls\nthese methods after user confirmation (delete) or commit (create/rename) and\nmanages optimistic UI + rollback on rejection.",
    "properties": [],
    "methods": [
      {
        "name": "create",
        "signature": "create(name: string): Promise<object>",
        "description": "Create a new project. Returns the new project id; consumer is expected\n to also refresh its projects signal.",
        "params": [
          {
            "name": "name",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "delete",
        "signature": "delete(projectId: string): Promise<void>",
        "description": "Permanently delete the project. The framework calls this AFTER user\n confirms via the confirm dialog.",
        "params": [
          {
            "name": "projectId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "rename",
        "signature": "rename(projectId: string, newName: string): Promise<void>",
        "description": "",
        "params": [
          {
            "name": "projectId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "newName",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      }
    ],
    "examples": []
  },
  {
    "name": "ResolvedCitation",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "citation",
        "type": "Citation",
        "description": "",
        "optional": false
      },
      {
        "name": "source",
        "type": "\"message\" | \"markdown\"",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "SelectPendingClientToolCallsInput",
    "kind": "interface",
    "description": "Inputs for selectPendingClientToolCalls.",
    "properties": [
      {
        "name": "catalogNames",
        "type": "ReadonlySet<string>",
        "description": "Client-declared tool names that should be handled in the browser.",
        "optional": false
      },
      {
        "name": "isLoading",
        "type": "boolean",
        "description": "Whether the agent is currently streaming a run. Pending client tools are hidden while loading.",
        "optional": false
      },
      {
        "name": "resolvedIds",
        "type": "ReadonlySet<string>",
        "description": "Tool-call ids already resolved by the local client instance.",
        "optional": false
      },
      {
        "name": "toolCalls",
        "type": "readonly ToolCall[]",
        "description": "Tool calls observed from the current agent state.",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "StandardSchemaV1",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "~standard",
        "type": "StandardSchemaProps<Input, Output>",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "StreamingMarkdownDocument",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "content",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "generation",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "phase",
        "type": "\"streaming\" | \"complete\"",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "Subagent",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "messages",
        "type": "Signal<Message[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "name",
        "type": "string",
        "description": "Optional human-readable name.",
        "optional": true
      },
      {
        "name": "state",
        "type": "Signal<Record<string, unknown>>",
        "description": "",
        "optional": false
      },
      {
        "name": "status",
        "type": "Signal<SubagentStatus>",
        "description": "",
        "optional": false
      },
      {
        "name": "toolCallId",
        "type": "string",
        "description": "Tool call ID that spawned this subagent.",
        "optional": false
      },
      {
        "name": "toolCalls",
        "type": "Signal<ToolCall[]>",
        "description": "The subagent's own tool calls (name/args/result), referenced by\n`Message.toolCallIds` in `messages`. Optional: adapters that don't surface\nsubagent tool calls omit it; consumers default to `[]`.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "ThreadActionAdapter",
    "kind": "interface",
    "description": "Per-thread row-action adapter. Consumer-provided. The framework calls\nthese methods after user confirmation (delete) or commit (rename) and\nmanages optimistic UI + rollback on rejection.\n\nConsumers MUST refresh their `threads` signal on success — the framework\nclears optimistic overrides in a `finally` block, so a successful adapter\ncall that leaves the input list unchanged would re-render the row.",
    "properties": [],
    "methods": [
      {
        "name": "archive",
        "signature": "archive(threadId: string): Promise<void>",
        "description": "Archive a thread (reversible). No confirmation dialog — framework calls\n this immediately on click.",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "delete",
        "signature": "delete(threadId: string): Promise<void>",
        "description": "",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "moveToProject",
        "signature": "moveToProject(threadId: string, projectId: string | null): Promise<void>",
        "description": "Move thread to a project (or pass null to remove from any project).\n Optimistically hides the row from the current project's visible list;\n consumer is expected to refresh the threads input.",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "projectId",
            "type": "string | null",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "pin",
        "signature": "pin(threadId: string): Promise<void>",
        "description": "Mark the thread as pinned.",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "rename",
        "signature": "rename(threadId: string, newTitle: string): Promise<void>",
        "description": "",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "newTitle",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "reorderPinned",
        "signature": "reorderPinned(threadId: string, beforeId: string | null): Promise<void>",
        "description": "Reorder a pinned thread. `beforeId` is the id of the pinned thread it\n should be placed before, or null to move to the end of the pinned list.\n Framework optimistically reorders the visible list and awaits this\n method; rejection rolls back.",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "beforeId",
            "type": "string | null",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "unarchive",
        "signature": "unarchive(threadId: string): Promise<void>",
        "description": "Restore an archived thread to the active list.",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "unpin",
        "signature": "unpin(threadId: string): Promise<void>",
        "description": "Unpin a previously pinned thread.",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      }
    ],
    "examples": []
  },
  {
    "name": "ThreadMatch",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "id",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "subtitle",
        "type": "string",
        "description": "Optional secondary line, rendered muted under the title.",
        "optional": true
      },
      {
        "name": "title",
        "type": "string",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "ThreadRoutingConfig",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "navigationExtras",
        "type": "NavigationExtras",
        "description": "Extras merged into every navigate (default `{ queryParamsHandling: 'preserve' }`).",
        "optional": true
      },
      {
        "name": "threadId",
        "type": "WritableSignal<string | null>",
        "description": "The app-owned source-of-truth signal for the active thread id.",
        "optional": false
      },
      {
        "name": "threadIdFromUrl",
        "type": "(url: string) => string | null",
        "description": "Extract the thread id from a URL (null = bare). Default: last non-empty path segment.",
        "optional": true
      },
      {
        "name": "toCommands",
        "type": "(id: string | null) => unknown[]",
        "description": "Router commands for a thread id (or the bare/welcome path when null).\n Default: `(id) => (id ? ['/', id] : ['/'])`.",
        "optional": true
      },
      {
        "name": "validate",
        "type": "(id: string) => Promise<boolean>",
        "description": "Optional async validity check; on `false` the helper redirects to the bare path\n (`replaceUrl: true`). LangGraph apps pass `id => threads.getThread(id).then(Boolean)`.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "ToolCall",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "args",
        "type": "unknown",
        "description": "Arguments. May be partial while streaming (`status !== 'complete'`).",
        "optional": false
      },
      {
        "name": "error",
        "type": "unknown",
        "description": "Optional error payload when status === 'error'.",
        "optional": true
      },
      {
        "name": "id",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "name",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "result",
        "type": "unknown",
        "description": "Present when status === 'complete' or 'error'.",
        "optional": true
      },
      {
        "name": "status",
        "type": "ToolCallStatus",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "ToolCallInfo",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "args",
        "type": "unknown",
        "description": "",
        "optional": false
      },
      {
        "name": "id",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "name",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "result",
        "type": "unknown",
        "description": "",
        "optional": true
      },
      {
        "name": "status",
        "type": "ToolCallStatus",
        "description": "Optional — present when the parent provides it. Drives the pill + default-collapsed logic.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "ViewToolDef",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "component",
        "type": "Type<C>",
        "description": "",
        "optional": false
      },
      {
        "name": "description",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "followUp",
        "type": "boolean",
        "description": "",
        "optional": true
      },
      {
        "name": "kind",
        "type": "\"view\"",
        "description": "",
        "optional": false
      },
      {
        "name": "schema",
        "type": "S",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "A2uiActionMessage",
    "kind": "type",
    "description": "",
    "signature": "any",
    "examples": []
  },
  {
    "name": "A2uiViewEntry",
    "kind": "type",
    "description": "Catalog entry for the A2UI surface renderer.\n\n`component` is mounted once all of the component's bindings (data\nmodel paths referenced in its prop expressions) have resolved. While\nany binding is unpopulated, the `fallback` is mounted instead. If\n`fallback` is omitted, the lib's default fallback\n(`A2uiDefaultFallbackComponent`) is mounted.\n\nThis is a chat-side alias for the shared `RenderViewEntry` shape so\nconsumers of `@threadplane/chat` don't have to import from `@threadplane/render`.",
    "signature": "RenderViewEntry",
    "examples": []
  },
  {
    "name": "A2uiViews",
    "kind": "type",
    "description": "Catalog shape accepted by `<a2ui-surface>`. Each entry is either a\nbare `Type<unknown>` (legacy shape — no per-component fallback) or\nan `A2uiViewEntry`.",
    "signature": "Readonly<Record<string, Type<unknown> | A2uiViewEntry>>",
    "examples": []
  },
  {
    "name": "AgentErrorKind",
    "kind": "type",
    "description": "The failure class of an AgentError, used to drive UI and retry logic:\n\n- `connection` — offline / DNS / connection refused / `fetch` failed. Retryable.\n- `auth` — `401` / `403`; credentials or API key are wrong. Not retryable.\n- `server` — a `5xx` (retryable) or a non-auth `4xx` like `400`/`404`/`429` (not retryable).\n- `interrupted` — the stream closed mid-response after a run had started. Retryable.\n- `aborted` — the user pressed stop; treated as a graceful idle, not surfaced as an error.",
    "signature": "\"connection\" | \"auth\" | \"server\" | \"interrupted\" | \"aborted\"",
    "examples": []
  },
  {
    "name": "AgentEvent",
    "kind": "type",
    "description": "Discriminated union of events flowing on `Agent.events$`.\n\nInvariant: state lives on signals (`messages`, `status`, `toolCalls`,\n`state`, `interrupt`, `subagents`, `history`); events on `events$`\ncarry only things that are not derivable from signals. New variants\nare added purely additively when patterns prove necessary.",
    "signature": "AgentStateUpdateEvent | AgentCustomEvent",
    "examples": []
  },
  {
    "name": "AgentRuntimeTelemetryEvent",
    "kind": "type",
    "description": "",
    "signature": "\"tplane:runtime_instance_created\" | \"tplane:runtime_request_created\" | \"tplane:stream_started\" | \"tplane:stream_ended\" | \"tplane:stream_errored\"",
    "examples": []
  },
  {
    "name": "AgentRuntimeTelemetrySink",
    "kind": "type",
    "description": "",
    "signature": "(payload: AgentRuntimeTelemetryPayload) => void | Promise<void>",
    "examples": []
  },
  {
    "name": "AgentStatus",
    "kind": "type",
    "description": "",
    "signature": "\"idle\" | \"running\" | \"error\"",
    "examples": []
  },
  {
    "name": "ChatApprovalAction",
    "kind": "type",
    "description": "",
    "signature": "\"approve\" | \"edit\" | \"cancel\"",
    "examples": []
  },
  {
    "name": "ChatMessageRole",
    "kind": "type",
    "description": "",
    "signature": "\"user\" | \"assistant\" | \"system\" | \"tool\"",
    "examples": []
  },
  {
    "name": "ChatScrollBubbleMode",
    "kind": "type",
    "description": "",
    "signature": "\"streaming\" | \"idle\"",
    "examples": []
  },
  {
    "name": "ChatSidenavMode",
    "kind": "type",
    "description": "",
    "signature": "\"expanded\" | \"collapsed\" | \"drawer\"",
    "examples": []
  },
  {
    "name": "CitationSourceVisual",
    "kind": "type",
    "description": "",
    "signature": "CitationImageVisual | CitationTypeIconVisual | CitationMonogramVisual",
    "examples": []
  },
  {
    "name": "CitationTypeIcon",
    "kind": "type",
    "description": "",
    "signature": "\"web\" | \"file\" | \"app\" | \"memory\" | \"generic\"",
    "examples": []
  },
  {
    "name": "ClientToolDef",
    "kind": "type",
    "description": "A client tool the model can call; executed in the browser.",
    "signature": "AnyFunctionToolDef | ViewToolDef | AskToolDef",
    "examples": []
  },
  {
    "name": "ClientToolExecutionRecord",
    "kind": "type",
    "description": "Prior durable execution state returned by a client-tool execution store.",
    "signature": "object | object | object",
    "examples": []
  },
  {
    "name": "ClientToolLifecyclePhase",
    "kind": "type",
    "description": "",
    "signature": "\"running\" | \"complete\" | \"error\"",
    "examples": []
  },
  {
    "name": "ClientToolRegistry",
    "kind": "type",
    "description": "A frozen, name-keyed registry of client tools.",
    "signature": "Readonly<Record<string, ClientToolDef>>",
    "examples": []
  },
  {
    "name": "ClientToolResult",
    "kind": "type",
    "description": "The outcome of running a client tool.",
    "signature": "object | object",
    "examples": []
  },
  {
    "name": "ClientToolViewProps",
    "kind": "type",
    "description": "",
    "signature": "StandardSchemaInferOutput<S> & { clientTool?: ClientToolLifecycle; status?: ToolCallStatus }",
    "examples": []
  },
  {
    "name": "CompleteOutcome",
    "kind": "type",
    "description": "Terminal result of one response attempt.\n\n`paused` is an intentional stop awaiting resumable input; `interrupted` means\nthe response stream ended unexpectedly. The other outcomes indicate normal\ncompletion, failure, or caller cancellation.",
    "signature": "\"success\" | \"error\" | \"aborted\" | \"interrupted\" | \"paused\"",
    "examples": []
  },
  {
    "name": "ContentBlock",
    "kind": "type",
    "description": "",
    "signature": "object | object | object | object",
    "examples": []
  },
  {
    "name": "ContentType",
    "kind": "type",
    "description": "",
    "signature": "\"pending\" | \"markdown\" | \"json-render\" | \"a2ui\" | \"mixed\"",
    "examples": []
  },
  {
    "name": "InterruptAction",
    "kind": "type",
    "description": "",
    "signature": "\"accept\" | \"edit\" | \"respond\" | \"ignore\"",
    "examples": []
  },
  {
    "name": "MessageDelivery",
    "kind": "type",
    "description": "Delivery lifecycle for one response attempt. `generation` identifies that\nattempt and is stable only for its lifetime. `streaming` means chunks may\nstill arrive; `complete` means the attempt has stopped with a terminal outcome.",
    "signature": "object | object",
    "examples": []
  },
  {
    "name": "MessageTemplateType",
    "kind": "type",
    "description": "",
    "signature": "\"human\" | \"ai\" | \"tool\" | \"system\" | \"function\"",
    "examples": []
  },
  {
    "name": "Project",
    "kind": "type",
    "description": "",
    "signature": "unknown",
    "examples": []
  },
  {
    "name": "Role",
    "kind": "type",
    "description": "",
    "signature": "\"user\" | \"assistant\" | \"system\" | \"tool\"",
    "examples": []
  },
  {
    "name": "StandardSchemaInferInput",
    "kind": "type",
    "description": "",
    "signature": "NonNullable<Schema[\"~standard\"][\"types\"]>[\"input\"]",
    "examples": []
  },
  {
    "name": "StandardSchemaInferOutput",
    "kind": "type",
    "description": "",
    "signature": "NonNullable<Schema[\"~standard\"][\"types\"]>[\"output\"]",
    "examples": []
  },
  {
    "name": "StreamingMarkdownContractViolationPolicy",
    "kind": "type",
    "description": "",
    "signature": "\"throw\" | \"rebuild\"",
    "examples": []
  },
  {
    "name": "SubagentStatus",
    "kind": "type",
    "description": "",
    "signature": "\"pending\" | \"running\" | \"complete\" | \"error\"",
    "examples": []
  },
  {
    "name": "Thread",
    "kind": "type",
    "description": "",
    "signature": "unknown",
    "examples": []
  },
  {
    "name": "ToolArgs",
    "kind": "type",
    "description": "Inferred argument type for a schema (alias of StandardSchemaInferOutput).",
    "signature": "StandardSchemaInferOutput",
    "examples": []
  },
  {
    "name": "ToolCallStatus",
    "kind": "type",
    "description": "",
    "signature": "\"pending\" | \"running\" | \"complete\" | \"error\"",
    "examples": []
  },
  {
    "name": "TraceState",
    "kind": "type",
    "description": "",
    "signature": "\"pending\" | \"running\" | \"done\" | \"error\"",
    "examples": []
  },
  {
    "name": "ViewProps",
    "kind": "type",
    "description": "Reverse helper: derive a component's input prop types FROM a schema, so a\n component authored straight from the schema is guaranteed compatible.",
    "signature": "Prettify<StandardSchemaInferOutput<S>>",
    "examples": []
  },
  {
    "name": "ViewRegistry",
    "kind": "type",
    "description": "A registry of view components available for generative UI rendering.\nEach entry is either a bare component Type (legacy shape) or a\n`RenderViewEntry` { component, fallback? }.",
    "signature": "Readonly<Record<string, Type<unknown> | RenderViewEntry>>",
    "examples": []
  },
  {
    "name": "AGENT_ERROR_MESSAGES",
    "kind": "const",
    "description": "Default, human-facing copy per AgentErrorKind. Used as the message when\na classified error has no better text. Override by mapping `error.kind` to your\nown strings in a custom error component.",
    "signature": "Record<AgentErrorKind, string>",
    "examples": []
  },
  {
    "name": "cacheplaneMarkdownViews",
    "kind": "const",
    "description": "Default view registry consumed by <chat-streaming-md>. Maps every\nMarkdownNode.type emitted by @cacheplane/partial-markdown@0.2 to its\ncorresponding Angular component.\n\nOverride per-node-type via `withViews(cacheplaneMarkdownViews, { … })`.",
    "signature": "ViewRegistry",
    "examples": []
  },
  {
    "name": "CHAT_CONFIG",
    "kind": "const",
    "description": "",
    "signature": "InjectionToken<ChatConfig>",
    "examples": []
  },
  {
    "name": "CHAT_LIFECYCLE",
    "kind": "const",
    "description": "",
    "signature": "InjectionToken<ChatLifecycle>",
    "examples": []
  },
  {
    "name": "IS_HEADER_ROW",
    "kind": "const",
    "description": "Provided by MarkdownTableRowComponent for header rows so that\nMarkdownTableCellComponent can render <th> instead of <td>.\nThe value is a Signal<boolean> so that it tracks the row's isHeader reactively.",
    "signature": "InjectionToken<Signal<boolean>>",
    "examples": []
  },
  {
    "name": "MARKDOWN_VIEW_REGISTRY",
    "kind": "const",
    "description": "DI token for the markdown view registry consumed by <chat-streaming-md>\nand <md-children>. Maps MarkdownNode.type strings (e.g. \"paragraph\",\n\"heading\") to Angular components that render that node type.\n\n`<chat-streaming-md>` provides the runtime registry on its component-level\ninjector — either the consumer-supplied [viewRegistry] input, or\n`cacheplaneMarkdownViews` (the default) — so descendant <md-children>\ncomponents resolve the right components for each node.",
    "signature": "InjectionToken<Readonly<Record<string, Type<unknown> | RenderViewEntry>>>",
    "examples": []
  },
  {
    "name": "STREAMING_MARKDOWN_CONTRACT_VIOLATION_POLICY",
    "kind": "const",
    "description": "",
    "signature": "InjectionToken<StreamingMarkdownContractViolationPolicy>",
    "examples": []
  },
  {
    "name": "a2uiBasicCatalog",
    "kind": "function",
    "description": "Build the built-in A2UI component catalog — a ViewRegistry mapping\nthe standard A2UI element types (Card, Button, TextField, Image, AudioPlayer,\nVideo, …) to their Angular renderers. Spread it into `provideViews` (with any\nof your own views) so an agent's A2UI surface specs render.",
    "signature": "a2uiBasicCatalog(): ViewRegistry",
    "params": [],
    "returns": {
      "type": "ViewRegistry",
      "description": ""
    },
    "examples": [
      "```ts\nproviders: [provideViews({ ...a2uiBasicCatalog(), MyWidget: MyWidgetComponent })]\n```"
    ]
  },
  {
    "name": "a2uiClientCapabilities",
    "kind": "function",
    "description": "The A2UI client capabilities this renderer supports — the typed\n`a2uiClientCapabilities` metadata a host attaches to agent requests so\nthe agent knows which component catalogs it may target\n(catalog negotiation, A2UI v0.9 transport metadata).",
    "signature": "a2uiClientCapabilities(): A2uiClientCapabilities",
    "params": [],
    "returns": {
      "type": "A2uiClientCapabilities",
      "description": ""
    },
    "examples": [
      "```ts\nconst metadata = { a2uiClientCapabilities: a2uiClientCapabilities() };\n```"
    ]
  },
  {
    "name": "action",
    "kind": "function",
    "description": "Declare an async function tool the model can call; its resolved return value\nbecomes the tool result shipped back to the model.",
    "signature": "action(description: string, schema: S, handler: (args: StandardSchemaInferOutput<S>, context: FunctionToolHandlerContext) => R | Promise<R>, options: ClientToolExecutionOptions): FunctionToolDef<S, R>",
    "params": [
      {
        "name": "description",
        "type": "string",
        "description": "Natural-language description the model sees.",
        "optional": false
      },
      {
        "name": "schema",
        "type": "S",
        "description": "Standard Schema (e.g. a Zod object) for the arguments; the\n  handler's argument type is inferred from it.",
        "optional": false
      },
      {
        "name": "handler",
        "type": "(args: StandardSchemaInferOutput<S>, context: FunctionToolHandlerContext) => R | Promise<R>",
        "description": "Runs in the browser when the model calls the tool. The second\n  argument carries an `AbortSignal`; its return type `R` is carried on the\n  resulting FunctionToolDef.",
        "optional": false
      },
      {
        "name": "options",
        "type": "ClientToolExecutionOptions",
        "description": "Execution policy options, including `idempotent: true` to skip\n  durable pre-execution claims when a guard is configured.",
        "optional": true
      }
    ],
    "returns": {
      "type": "FunctionToolDef<S, R>",
      "description": ""
    },
    "examples": [
      "```ts\nconst move = action('Move a stop', z.object({ fromDay: z.number() }), (a) => a.fromDay);\nconst registry = tools({ move_stop: move });\n```"
    ]
  },
  {
    "name": "ask",
    "kind": "function",
    "description": "Interactive (human-in-the-loop) component tool — the model fills the\ncomponent's props from the schema's output; the value the component emits\nback to the framework becomes the tool result sent to the model.\n\nThe component's signal inputs are checked against the schema output type\n(strict-but-flexible: every schema key must be a declared input with an\nassignable type; the component may declare extra inputs the schema doesn't\nfill). Author the component with `ViewProps<typeof schema>` to derive input\nprop types directly from the schema.",
    "signature": "ask(description: string, schema: S, component: AcceptComponent<S, C>, options: ClientToolContinuationOptions): AskToolDef<S, C>",
    "params": [
      {
        "name": "description",
        "type": "string",
        "description": "Natural-language description the model sees.",
        "optional": false
      },
      {
        "name": "schema",
        "type": "S",
        "description": "Standard Schema defining the props the model must supply.",
        "optional": false
      },
      {
        "name": "component",
        "type": "AcceptComponent<S, C>",
        "description": "Angular component whose signal inputs must be compatible with\n  the schema output. A type-level error is reported here when they diverge.",
        "optional": false
      },
      {
        "name": "options",
        "type": "ClientToolContinuationOptions",
        "description": "",
        "optional": true
      }
    ],
    "returns": {
      "type": "AskToolDef<S, C>",
      "description": ""
    },
    "examples": [
      "```ts\nconst schema = z.object({ question: z.string(), options: z.array(z.string()) });\ntype Inputs = ViewProps<typeof schema>;\n\n\\@Component({ ... })\nclass ChoiceCardComponent {\n  question = input.required<string>();\n  options  = input.required<string[]>();\n  // Emits the chosen option back to the model.\n}\n\nconst choice = ask('Ask the user to choose', schema, ChoiceCardComponent);\nconst registry = tools({ pick_option: choice });\n```"
    ]
  },
  {
    "name": "buildA2uiActionMessage",
    "kind": "function",
    "description": "Builds a v0.9 A2uiActionMessage from handler params and the current\n surface. The action.context is the resolved plain object the renderer\n produced from the component's `action.event.context`. Sets action.label\n when the source component is a Button with a Text child whose text is a\n non-empty bare literal.",
    "signature": "buildA2uiActionMessage(params: Record<string, unknown>, surface: A2uiSurface): A2uiActionMessage",
    "params": [
      {
        "name": "params",
        "type": "Record<string, unknown>",
        "description": "",
        "optional": false
      },
      {
        "name": "surface",
        "type": "A2uiSurface",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "A2uiActionMessage",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "cancelledClientToolResult",
    "kind": "function",
    "description": "Result recorded when the user stops a run while a client tool is running.",
    "signature": "cancelledClientToolResult(toolCallId: string): ClientToolResult",
    "params": [
      {
        "name": "toolCallId",
        "type": "string",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "ClientToolResult",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "citationSourceVisual",
    "kind": "function",
    "description": "Choose the visual source marker for a citation: provider image, type icon, or monogram.",
    "signature": "citationSourceVisual(c: Citation): CitationSourceVisual",
    "params": [
      {
        "name": "c",
        "type": "Citation",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "CitationSourceVisual",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "citationTypeLabel",
    "kind": "function",
    "description": "Human label for the source-type badge; null when type is 'unknown'.",
    "signature": "citationTypeLabel(c: Citation): string | null",
    "params": [
      {
        "name": "c",
        "type": "Citation",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "string | null",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "citationTypeMeta",
    "kind": "function",
    "description": "Derive normalized source-type metadata for badges, icons, and tone tokens.",
    "signature": "citationTypeMeta(c: Citation): CitationTypeMeta",
    "params": [
      {
        "name": "c",
        "type": "Citation",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "CitationTypeMeta",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "clientToolGuardFailureResult",
    "kind": "function",
    "description": "Default fail-closed result when the execution guard itself cannot be reached.",
    "signature": "clientToolGuardFailureResult(toolCallId: string, error: unknown): ClientToolResult",
    "params": [
      {
        "name": "toolCallId",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "error",
        "type": "unknown",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "ClientToolResult",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "completeDelivery",
    "kind": "function",
    "description": "Creates a terminal delivery state for an existing response-attempt generation.",
    "signature": "completeDelivery(generation: string, outcome: TOutcome): object",
    "params": [
      {
        "name": "generation",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "outcome",
        "type": "TOutcome",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "object",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "createA2uiSurfaceStore",
    "kind": "function",
    "description": "Create an A2uiSurfaceStore — the per-conversation store that buffers\nstreamed A2UI v0.9 envelopes, tracks each surface's data model + lifecycle\nstate, and exposes them as signals for rendering. One store backs a chat\nthread's A2UI surfaces.\n\nA surface becomes visible once its `createSurface` envelope has arrived AND\na component with id `root` has been defined (the v0.9 progressive-rendering\nrule). Everything received earlier is buffered; afterwards, components merge\nincrementally by id and data-model updates apply immediately.",
    "signature": "createA2uiSurfaceStore(): A2uiSurfaceStore",
    "params": [],
    "returns": {
      "type": "A2uiSurfaceStore",
      "description": ""
    },
    "examples": [
      "```ts\nconst store = createA2uiSurfaceStore();\nconst surfaces = store.surfaces; // Signal<Map<string, A2uiSurface>>\n```"
    ]
  },
  {
    "name": "createAgentRef",
    "kind": "function",
    "description": "Create a typed agent handle.",
    "signature": "createAgentRef(debugName: string): AgentRef<TState>",
    "params": [
      {
        "name": "debugName",
        "type": "string",
        "description": "Optional name shown in Angular DI error messages.",
        "optional": true
      }
    ],
    "returns": {
      "type": "AgentRef<TState>",
      "description": ""
    },
    "examples": [
      "```ts\ninterface TripState { day: number; places: string[]; }\nexport const TRIP = createAgentRef<TripState>('trip');\n// app.config.ts: provideAgent(TRIP, { assistantId: 'trip' })\n// component:     const agent = injectAgent(TRIP); // LangGraphAgent<TripState>\n```"
    ]
  },
  {
    "name": "createContentClassifier",
    "kind": "function",
    "description": "Create a ContentClassifier — the streaming accumulator that inspects\nan assistant message's content as it arrives and classifies it (markdown vs a\ngenerative-UI/A2UI spec), exposing the parsed result and per-element state as\nsignals so the renderer can switch modes mid-stream.",
    "signature": "createContentClassifier(): ContentClassifier",
    "params": [],
    "returns": {
      "type": "ContentClassifier",
      "description": ""
    },
    "examples": [
      "```ts\nconst cc = createContentClassifier();\neffect(() => console.log(cc.type())); // 'pending' | 'markdown' | 'spec'\n```"
    ]
  },
  {
    "name": "createParseTreeStore",
    "kind": "function",
    "description": "Create a ParseTreeStore — feeds streamed JSON chunks through a\npartial-JSON parser and exposes the progressively-materialized spec and\nper-element accumulation state as signals, so a generative-UI surface can\nrender while the spec is still arriving.",
    "signature": "createParseTreeStore(parser: PartialJsonParser): ParseTreeStore",
    "params": [
      {
        "name": "parser",
        "type": "PartialJsonParser",
        "description": "The partial-JSON parser used to incrementally materialize chunks.",
        "optional": false
      }
    ],
    "returns": {
      "type": "ParseTreeStore",
      "description": ""
    },
    "examples": [
      "```ts\nconst store = createParseTreeStore(parser);\nstore.push('{\"type\":\"Car');\nstore.spec(); // best-effort Spec | null\n```"
    ]
  },
  {
    "name": "createPartialArgsBridge",
    "kind": "function",
    "description": "Subscribes to LangGraph custom events of name 'a2ui-partial' and feeds\nthe surface store envelope-by-envelope as the parent LLM streams its\ntool_call.arguments JSON. Uses @cacheplane/partial-json to extract\nstructurally-complete envelope objects from the growing args string.\n\nSynthesis safety net: v0.9 requires a `createSurface` envelope before\nany `updateComponents`. If a complete `updateComponents` arrives for a\nsurface with no `createSurface` seen yet this turn, the bridge\nsynthesises one (basic catalog) so the surface can mount as soon as its\n`root` component is defined — the store gates rendering on\ncreateSurface + root, and fills the tree in progressively after that.\n\nThe store treats a later \"real\" createSurface for the same surface as an\nidempotent refresh, so LLMs that emit one out of order are harmless.",
    "signature": "createPartialArgsBridge(store: A2uiSurfaceStore): PartialArgsBridge",
    "params": [
      {
        "name": "store",
        "type": "A2uiSurfaceStore",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "PartialArgsBridge",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "defaultInterruptedClientToolResult",
    "kind": "function",
    "description": "Default fail-closed result for a stale in-progress client-tool execution.",
    "signature": "defaultInterruptedClientToolResult(toolCallId: string): ClientToolResult",
    "params": [
      {
        "name": "toolCallId",
        "type": "string",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "ClientToolResult",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "deriveDomain",
    "kind": "function",
    "description": "Hostname of `url` with a leading `www.` removed; null if absent/malformed.",
    "signature": "deriveDomain(url: string): string | null",
    "params": [
      {
        "name": "url",
        "type": "string",
        "description": "",
        "optional": true
      }
    ],
    "returns": {
      "type": "string | null",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "deriveJsonSchema",
    "kind": "function",
    "description": "Convert a Standard Schema to a JSON Schema for the model's `parameters`.\nUses Zod's converter; throws a clear error for non-Zod validators (callers\nshould supply a Zod schema — see the client-tools docs).",
    "signature": "deriveJsonSchema(toolName: string, schema: StandardSchemaV1<>): Record<string, unknown>",
    "params": [
      {
        "name": "toolName",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "schema",
        "type": "StandardSchemaV1<>",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "Record<string, unknown>",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "deriveMonogram",
    "kind": "function",
    "description": "Uppercased first letter of the domain (or title) for the monogram chip.",
    "signature": "deriveMonogram(c: Citation): string",
    "params": [
      {
        "name": "c",
        "type": "Citation",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "string",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "deriveSourceType",
    "kind": "function",
    "description": "Explicit `sourceType`, else 'web' inferred from a url, else 'unknown'.",
    "signature": "deriveSourceType(c: Citation): string",
    "params": [
      {
        "name": "c",
        "type": "Citation",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "string",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "emitBinding",
    "kind": "function",
    "description": "Writes a typed value to the render state store if the prop has a binding path.",
    "signature": "emitBinding(host: RenderHost, bindings: Record<string, string> | undefined, prop: string, value: unknown): void",
    "params": [
      {
        "name": "host",
        "type": "RenderHost",
        "description": "",
        "optional": false
      },
      {
        "name": "bindings",
        "type": "Record<string, string> | undefined",
        "description": "",
        "optional": false
      },
      {
        "name": "prop",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "value",
        "type": "unknown",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "void",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "executeFunctionTool",
    "kind": "function",
    "description": "Validate args, run the handler, and normalize the outcome to a ClientToolResult.",
    "signature": "executeFunctionTool(def: AnyFunctionToolDef, rawArgs: unknown, context: FunctionToolHandlerContext): Promise<ClientToolResult>",
    "params": [
      {
        "name": "def",
        "type": "AnyFunctionToolDef",
        "description": "",
        "optional": false
      },
      {
        "name": "rawArgs",
        "type": "unknown",
        "description": "",
        "optional": false
      },
      {
        "name": "context",
        "type": "FunctionToolHandlerContext",
        "description": "",
        "optional": true
      }
    ],
    "returns": {
      "type": "Promise<ClientToolResult>",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "extractErrorMessage",
    "kind": "function",
    "description": "Coerce an unknown error value into a human-readable message string — reads\n`.message` from `Error`s, returns strings as-is, and `String()`-casts the\nrest. Useful when rendering an agent's `error` outside the built-in\n`chat-error` component.",
    "signature": "extractErrorMessage(error: unknown): string | null",
    "params": [
      {
        "name": "error",
        "type": "unknown",
        "description": "Any caught/agent error value.",
        "optional": false
      }
    ],
    "returns": {
      "type": "string | null",
      "description": ""
    },
    "examples": [
      "```ts\nconst msg = extractErrorMessage(agent.error());\n```"
    ]
  },
  {
    "name": "formatDuration",
    "kind": "function",
    "description": "Render a millisecond duration as a human-readable label suitable for\nthe chat-reasoning \"Thought for Ns\" pill.\n\n- <1 s         → \"<1s\"\n- 1–59 s       → \"Ns\"     (e.g. \"4s\")\n- ≥60 s        → \"Nm Ms\"  (e.g. \"1m 12s\", \"60m 0s\")\n\nNegative or non-finite inputs collapse to \"<1s\" so a corrupted timing\nmap never produces noisy output.",
    "signature": "formatDuration(ms: number): string",
    "params": [
      {
        "name": "ms",
        "type": "number",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "string",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "formatPublished",
    "kind": "function",
    "description": "Short freshness label (e.g. \"Apr 2024\"); null when absent or unparseable.",
    "signature": "formatPublished(value: string | number | Date): string | null",
    "params": [
      {
        "name": "value",
        "type": "string | number | Date",
        "description": "",
        "optional": true
      }
    ],
    "returns": {
      "type": "string | null",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "getInterrupt",
    "kind": "function",
    "description": "Read the agent's current human-in-the-loop interrupt, if any.",
    "signature": "getInterrupt(agent: Agent<>): AgentInterrupt | undefined",
    "params": [
      {
        "name": "agent",
        "type": "Agent<>",
        "description": "The agent to inspect.",
        "optional": false
      }
    ],
    "returns": {
      "type": "AgentInterrupt | undefined",
      "description": ""
    },
    "examples": [
      "```ts\nconst interrupt = getInterrupt(agent);\nif (interrupt) agent.resume('approved');\n```"
    ]
  },
  {
    "name": "getMessageType",
    "kind": "function",
    "description": "Maps a Message to a MessageTemplateType.\nExported as a standalone function so it can be unit-tested without DOM rendering.",
    "signature": "getMessageType(message: Message): MessageTemplateType",
    "params": [
      {
        "name": "message",
        "type": "Message",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "MessageTemplateType",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "injectThreadRouting",
    "kind": "function",
    "description": "Bind an app-owned `activeThreadId` signal to the URL — restore on load, stamp on change,\nvalidate-or-redirect, with a bare URL meaning \"no thread\" (welcome). URL is the source of\ntruth; nothing is written to localStorage. Must be called in an injection context.",
    "signature": "injectThreadRouting(config: ThreadRoutingConfig): void",
    "params": [
      {
        "name": "config",
        "type": "ThreadRoutingConfig",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "void",
      "description": ""
    },
    "examples": [
      "```ts\nexport const ACTIVE_THREAD = signal<string | null>(null);\n// providers: provideAgent({ threadId: ACTIVE_THREAD, onThreadId: id => ACTIVE_THREAD.set(id) })\nconst threads = inject(LangGraphThreadsAdapter);\ninjectThreadRouting({ threadId: ACTIVE_THREAD, validate: id => threads.getThread(id).then(Boolean) });\n```"
    ]
  },
  {
    "name": "isAbortError",
    "kind": "function",
    "description": "Whether `raw` represents an abort (a `DOMException`/`Error` named `AbortError`,\nor an abort-ish message). Shared by the runtime adapters and toAgentError\nso a user-requested stop settles to idle instead of surfacing as an error.",
    "signature": "isAbortError(raw: unknown): boolean",
    "params": [
      {
        "name": "raw",
        "type": "unknown",
        "description": "Any thrown/rejected value.",
        "optional": false
      }
    ],
    "returns": {
      "type": "boolean",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "isAssistantMessage",
    "kind": "function",
    "description": "Type guard narrowing a Message to `role: 'assistant'`.",
    "signature": "isAssistantMessage(m: Message): m is Message & { role: \"assistant\" }",
    "params": [
      {
        "name": "m",
        "type": "Message",
        "description": "The message to test.",
        "optional": false
      }
    ],
    "returns": {
      "type": "m is Message & { role: \"assistant\" }",
      "description": ""
    },
    "examples": [
      "```ts\nconst reply = agent.messages().findLast(isAssistantMessage);\n```"
    ]
  },
  {
    "name": "isSystemMessage",
    "kind": "function",
    "description": "Type guard narrowing a Message to `role: 'system'`.",
    "signature": "isSystemMessage(m: Message): m is Message & { role: \"system\" }",
    "params": [
      {
        "name": "m",
        "type": "Message",
        "description": "The message to test.",
        "optional": false
      }
    ],
    "returns": {
      "type": "m is Message & { role: \"system\" }",
      "description": ""
    },
    "examples": [
      "```ts\nconst visible = agent.messages().filter((m) => !isSystemMessage(m));\n```"
    ]
  },
  {
    "name": "isToolMessage",
    "kind": "function",
    "description": "Type guard narrowing a Message to `role: 'tool'` (a tool result turn).",
    "signature": "isToolMessage(m: Message): m is Message & { role: \"tool\" }",
    "params": [
      {
        "name": "m",
        "type": "Message",
        "description": "The message to test.",
        "optional": false
      }
    ],
    "returns": {
      "type": "m is Message & { role: \"tool\" }",
      "description": ""
    },
    "examples": [
      "```ts\nif (isToolMessage(m)) console.log(m.toolCallId);\n```"
    ]
  },
  {
    "name": "isTyping",
    "kind": "function",
    "description": "Whether the agent should show a \"typing\" indicator — it is loading and has\nnot yet started streaming the assistant's reply.",
    "signature": "isTyping(agent: Agent<>): boolean",
    "params": [
      {
        "name": "agent",
        "type": "Agent<>",
        "description": "The agent to inspect.",
        "optional": false
      }
    ],
    "returns": {
      "type": "boolean",
      "description": ""
    },
    "examples": [
      "```ts\n\\@if (isTyping(agent)) { <chat-typing-indicator [agent]=\"agent\" /> }\n```"
    ]
  },
  {
    "name": "isUserMessage",
    "kind": "function",
    "description": "Type guard narrowing a Message to `role: 'user'`.",
    "signature": "isUserMessage(m: Message): m is Message & { role: \"user\" }",
    "params": [
      {
        "name": "m",
        "type": "Message",
        "description": "The message to test.",
        "optional": false
      }
    ],
    "returns": {
      "type": "m is Message & { role: \"user\" }",
      "description": ""
    },
    "examples": [
      "```ts\nconst userTurns = agent.messages().filter(isUserMessage);\n```"
    ]
  },
  {
    "name": "markdownDocument",
    "kind": "function",
    "description": "Creates the atomic document consumed by the streaming Markdown renderer.",
    "signature": "markdownDocument(content: string, delivery: MessageDelivery, suffix: string): StreamingMarkdownDocument",
    "params": [
      {
        "name": "content",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "delivery",
        "type": "MessageDelivery",
        "description": "",
        "optional": false
      },
      {
        "name": "suffix",
        "type": "string",
        "description": "",
        "optional": true
      }
    ],
    "returns": {
      "type": "StreamingMarkdownDocument",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "messageContent",
    "kind": "function",
    "description": "Extracts a human-readable string from a message's content.\n\n`BaseMessage.content` is `string | MessageContentComplex[]`. Reasoning-\ncapable models (OpenAI gpt-5/o-series, Anthropic) emit complex arrays of\ntyped blocks: `{type:'text',text}`, `{type:'reasoning',...}`, tool-use\nblocks, etc. We render only the visible text portions and skip anything\nelse. Stringifying the whole array would dump raw JSON like\n`[{\"type\":\"text\",...}]` into the chat bubble.",
    "signature": "messageContent(message: BaseMessage<>): string",
    "params": [
      {
        "name": "message",
        "type": "BaseMessage<>",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "string",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "mockAgent",
    "kind": "function",
    "description": "Build an in-memory Agent for tests and stories — no transport, no\nnetwork. Every field is a writable signal so a test can drive UI states\n(loading, error, interrupts, tool calls, subagents) deterministically.",
    "signature": "mockAgent(opts: MockAgentOptions): MockAgent<>",
    "params": [
      {
        "name": "opts",
        "type": "MockAgentOptions",
        "description": "Initial values for the mock's signals; all optional.",
        "optional": true
      }
    ],
    "returns": {
      "type": "MockAgent<>",
      "description": ""
    },
    "examples": [
      "```ts\nimport { staticDelivery } from '@threadplane/chat';\n\nconst agent = mockAgent({\n  messages: [{ id: '1', role: 'assistant', content: 'Hi', delivery: staticDelivery('1') }],\n  isLoading: true,\n});\n```"
    ]
  },
  {
    "name": "monogramColor",
    "kind": "function",
    "description": "Deterministic monogram-chip background color (stable per source).",
    "signature": "monogramColor(c: Citation): string",
    "params": [
      {
        "name": "c",
        "type": "Citation",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "string",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "monogramHue",
    "kind": "function",
    "description": "Deterministic hue in [0,360) from a seed string (stable monogram color).",
    "signature": "monogramHue(seed: string): number",
    "params": [
      {
        "name": "seed",
        "type": "string",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "number",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "normalizeEnvelopeArgs",
    "kind": "function",
    "description": "The parent LLM may emit envelope-tool arguments in four shapes (observed in\nthe spike across gpt-5-mini and gpt-5): the canonical {envelopes: [...]},\na singular typo {envelope: [...]}, positional keys {0: env, 1: env, ...}\nwhen the model treats the args as the array, or a flat single envelope.\nThis pure function maps all four into a canonical envelope list.\n\nStrict-mode tool binding (OpenAI) should eliminate the non-canonical\nshapes in production, but the normalizer is the safety net.",
    "signature": "normalizeEnvelopeArgs(args: Record<string, unknown> | null | undefined): unknown[] | null",
    "params": [
      {
        "name": "args",
        "type": "Record<string, unknown> | null | undefined",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "unknown[] | null",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "normalizeViewEntry",
    "kind": "function",
    "description": "Normalize a catalog entry to the `A2uiViewEntry` shape. Bare\n`Type<unknown>` entries are wrapped as `{ component }`; entries\nalready in the discriminated shape are returned unchanged.",
    "signature": "normalizeViewEntry(entry: Type<unknown> | RenderViewEntry): RenderViewEntry",
    "params": [
      {
        "name": "entry",
        "type": "Type<unknown> | RenderViewEntry",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "RenderViewEntry",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "provideChat",
    "kind": "function",
    "description": "Bootstrap `@threadplane/chat` in an Angular application or standalone\ncomponent tree.\n\nCall this once inside `bootstrapApplication` (or the `providers` array of a\nroot `ApplicationConfig`). It registers the shared ChatConfig token\nso every chat component in the tree can read the render registry, avatar\nlabel, and assistant display name without explicit prop threading.",
    "signature": "provideChat(config: ChatConfig): EnvironmentProviders",
    "params": [
      {
        "name": "config",
        "type": "ChatConfig",
        "description": "Options bag that controls the chat feature set:\n  - `renderRegistry` — shared AngularRegistry wiring tool-view\n    components to their names; pass the value returned by\n    `defineAngularRegistry` from `\\@threadplane/render`.\n  - `avatarLabel` — short label shown in the AI avatar bubble (default `\"A\"`).\n  - `assistantName` — display name shown above assistant messages\n    (default `\"Assistant\"`).",
        "optional": false
      }
    ],
    "returns": {
      "type": "EnvironmentProviders",
      "description": ""
    },
    "examples": [
      "```ts\n// main.ts\nimport { bootstrapApplication } from '@angular/platform-browser';\nimport { provideChat } from '@threadplane/chat';\nimport { defineAngularRegistry, provideRender } from '@threadplane/render';\nimport { DayCardComponent } from './day-card.component';\n\nconst registry = defineAngularRegistry({ day_card: DayCardComponent });\n\nbootstrapApplication(AppComponent, {\n  providers: [\n    provideChat({ renderRegistry: registry, avatarLabel: 'AI' }),\n    provideRender({ registry }),\n  ],\n});\n```"
    ]
  },
  {
    "name": "renderMarkdown",
    "kind": "function",
    "description": "Renders markdown content to sanitized HTML.\nFalls back to plain text with newline->br conversion if `marked` is not installed.",
    "signature": "renderMarkdown(content: string, sanitizer: DomSanitizer<>): SafeHtml",
    "params": [
      {
        "name": "content",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "sanitizer",
        "type": "DomSanitizer<>",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "SafeHtml",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "selectPendingClientToolCalls",
    "kind": "function",
    "description": "Select client tool calls that are ready for browser-side resolution.",
    "signature": "selectPendingClientToolCalls(input: SelectPendingClientToolCallsInput): readonly ToolCall[]",
    "params": [
      {
        "name": "input",
        "type": "SelectPendingClientToolCallsInput",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "readonly ToolCall[]",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "shouldClaimBeforeExecute",
    "kind": "function",
    "description": "Return whether this function tool should claim before browser execution.",
    "signature": "shouldClaimBeforeExecute(def: AnyFunctionToolDef): boolean",
    "params": [
      {
        "name": "def",
        "type": "AnyFunctionToolDef",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "boolean",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "startClientToolExecutor",
    "kind": "function",
    "description": "Watches the agent's pending client tool calls and auto-runs FUNCTION tools,\nresolving each with its result. View/ask (component) tools are handled by the\nrendering layer, not here. No-op if the agent lacks the clientTools\ncapability. MUST be called in an injection context (sets up an effect).",
    "signature": "startClientToolExecutor(agent: Agent<>, registry: ClientToolRegistry, options: ClientToolExecutorOptions): void",
    "params": [
      {
        "name": "agent",
        "type": "Agent<>",
        "description": "",
        "optional": false
      },
      {
        "name": "registry",
        "type": "ClientToolRegistry",
        "description": "",
        "optional": false
      },
      {
        "name": "options",
        "type": "ClientToolExecutorOptions",
        "description": "",
        "optional": true
      }
    ],
    "returns": {
      "type": "void",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "staticDelivery",
    "kind": "function",
    "description": "Creates a successful terminal delivery state for an already-complete message.",
    "signature": "staticDelivery(messageId: string): object",
    "params": [
      {
        "name": "messageId",
        "type": "string",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "object",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "statusColor",
    "kind": "function",
    "description": "Returns a CSS style string for a subagent's status badge.\nKept exported for backward compatibility with existing consumers; the\npreferred way to style status visually is via the `data-status` attribute\n+ CSS selectors (see component styles below).",
    "signature": "statusColor(status: SubagentStatus): string",
    "params": [
      {
        "name": "status",
        "type": "SubagentStatus",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "string",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "streamingDelivery",
    "kind": "function",
    "description": "Creates the active delivery state for one response-attempt generation.",
    "signature": "streamingDelivery(generation: string): object",
    "params": [
      {
        "name": "generation",
        "type": "string",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "object",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "submitMessage",
    "kind": "function",
    "description": "Submits a trimmed message to the agent.\nReturns the trimmed string on success, or `null` if the input was empty.",
    "signature": "submitMessage(agent: Agent<>, text: string): string | null",
    "params": [
      {
        "name": "agent",
        "type": "Agent<>",
        "description": "",
        "optional": false
      },
      {
        "name": "text",
        "type": "string",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "string | null",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "toAgentError",
    "kind": "function",
    "description": "Classify any raw error into a structured AgentError.\n\nResolution order (first match wins): an existing `AgentError` is returned\nunchanged (idempotent) → a user abort → a structured `status`/`cause.status`\n→ network/connection markers → an HTTP-shaped status in the message → a\n`server` + retryable fallback. The original error is always preserved on\n`cause`. Runtime adapters call this before setting `Agent.error`; custom\nbackends can call it too (or throw an `AgentError` directly).",
    "signature": "toAgentError(raw: unknown): AgentError<>",
    "params": [
      {
        "name": "raw",
        "type": "unknown",
        "description": "Any thrown/rejected value — an `Error`, a `{ status }` object, a string, etc.",
        "optional": false
      }
    ],
    "returns": {
      "type": "AgentError<>",
      "description": ""
    },
    "examples": [
      "```ts\nconst e = toAgentError(new Error('HTTP 500: Internal Server Error'));\ne.kind;      // 'server'\ne.retryable; // true\ne.status;    // 500\n```"
    ]
  },
  {
    "name": "toClientToolSpecs",
    "kind": "function",
    "description": "Build the catalog spec list shipped to the model.",
    "signature": "toClientToolSpecs(registry: ClientToolRegistry): ClientToolSpec[]",
    "params": [
      {
        "name": "registry",
        "type": "ClientToolRegistry",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "ClientToolSpec[]",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "tools",
    "kind": "function",
    "description": "Collect named client tools into a frozen, name-keyed registry.\n\nThe overload is generic over the entire map (`const M`) so that each tool's\nprecise type (FunctionToolDef`<S,R>`, ViewToolDef`<S,C>`, or\nAskToolDef`<S,C>`) and every literal key are preserved in the\nClientToolRegistry passed to `provideChat`. This lets downstream\nconsumers look up individual tools without losing generic information.",
    "signature": "tools(map: M): Readonly<M>",
    "params": [
      {
        "name": "map",
        "type": "M",
        "description": "An object literal mapping tool names to tool definitions created\n  by action, view, or ask.",
        "optional": false
      }
    ],
    "returns": {
      "type": "Readonly<M>",
      "description": ""
    },
    "examples": [
      "```ts\nconst move = action('Move a stop', z.object({ fromDay: z.number() }), (a) => a.fromDay);\nconst dayCard = view('Show a day card', z.object({ label: z.string() }), DayCardComponent);\n\nconst registry = tools({ move_stop: move, day_card: dayCard });\n// registry.move_stop is FunctionToolDef<...>\n// registry.day_card  is ViewToolDef<...>\n```"
    ]
  },
  {
    "name": "toRenderRegistry",
    "kind": "function",
    "description": "Converts a ViewRegistry to an AngularRegistry for use with RenderSpecComponent.",
    "signature": "toRenderRegistry(registry: ViewRegistry): AngularRegistry",
    "params": [
      {
        "name": "registry",
        "type": "ViewRegistry",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "AngularRegistry",
      "description": ""
    },
    "examples": [
      "```ts\nconst registry = toRenderRegistry(views({ metric: MetricCardComponent }));\n```"
    ]
  },
  {
    "name": "validateArgs",
    "kind": "function",
    "description": "Validate raw model args against a Standard Schema.",
    "signature": "validateArgs(schema: StandardSchemaV1<>, args: unknown): Promise<object | object>",
    "params": [
      {
        "name": "schema",
        "type": "StandardSchemaV1<>",
        "description": "",
        "optional": false
      },
      {
        "name": "args",
        "type": "unknown",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "Promise<object | object>",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "view",
    "kind": "function",
    "description": "Render-only component tool — the model fills the component's props from the\nschema's output; the tool call is auto-acknowledged once the component mounts.\n\nThe component's signal inputs are checked against the schema output type\n(strict-but-flexible: every schema key must be a declared input with an\nassignable type; the component may declare extra inputs the schema doesn't fill).\nAuthor the component with `ViewProps<typeof schema>` as the input type set to\nguarantee the shapes stay aligned.",
    "signature": "view(description: string, schema: S, component: AcceptComponent<S, C>, options: ClientToolContinuationOptions): ViewToolDef<S, C>",
    "params": [
      {
        "name": "description",
        "type": "string",
        "description": "Natural-language description the model sees.",
        "optional": false
      },
      {
        "name": "schema",
        "type": "S",
        "description": "Standard Schema defining the props the model must supply.",
        "optional": false
      },
      {
        "name": "component",
        "type": "AcceptComponent<S, C>",
        "description": "Angular component whose signal inputs must be compatible with\n  the schema output. A type-level error is reported here when they diverge.",
        "optional": false
      },
      {
        "name": "options",
        "type": "ClientToolContinuationOptions",
        "description": "",
        "optional": true
      }
    ],
    "returns": {
      "type": "ViewToolDef<S, C>",
      "description": ""
    },
    "examples": [
      "```ts\nconst schema = z.object({ label: z.string(), day: z.number() });\ntype Inputs = ViewProps<typeof schema>; // { label: string; day: number }\n\n\\@Component({ ... })\nclass DayCardComponent {\n  label = input.required<string>();\n  day   = input.required<number>();\n}\n\nconst dayCard = view('Show a day card', schema, DayCardComponent);\nconst registry = tools({ day_card: dayCard });\n```"
    ]
  },
  {
    "name": "views",
    "kind": "function",
    "description": "Creates a view registry from a name → component map.",
    "signature": "views(map: Record<string, Type<unknown> | RenderViewEntry>): ViewRegistry",
    "params": [
      {
        "name": "map",
        "type": "Record<string, Type<unknown> | RenderViewEntry>",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "ViewRegistry",
      "description": ""
    },
    "examples": [
      "```ts\nconst registry = views({ metric: MetricCardComponent, chart: ChartComponent });\n// providers: [provideViews(registry)]\n```"
    ]
  },
  {
    "name": "withoutViews",
    "kind": "function",
    "description": "Removes views from a registry by name.",
    "signature": "withoutViews(base: ViewRegistry, ...names: string[]): ViewRegistry",
    "params": [
      {
        "name": "base",
        "type": "ViewRegistry",
        "description": "",
        "optional": false
      },
      {
        "name": "...names",
        "type": "string[]",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "ViewRegistry",
      "description": ""
    },
    "examples": [
      "```ts\nconst trimmed = withoutViews(a2uiBasicCatalog(), 'Video', 'AudioPlayer');\n```"
    ]
  },
  {
    "name": "withViews",
    "kind": "function",
    "description": "Adds views to a registry without overwriting existing entries.\nNew keys are added; keys that already exist in `base` are preserved.",
    "signature": "withViews(base: ViewRegistry, additions: Record<string, Type<unknown> | RenderViewEntry>): ViewRegistry",
    "params": [
      {
        "name": "base",
        "type": "ViewRegistry",
        "description": "",
        "optional": false
      },
      {
        "name": "additions",
        "type": "Record<string, Type<unknown> | RenderViewEntry>",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "ViewRegistry",
      "description": ""
    },
    "examples": [
      "```ts\nconst extended = withViews(a2uiBasicCatalog(), { MyWidget: MyWidgetComponent });\n```"
    ]
  },
  {
    "name": "AbstractEvent",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "delta",
        "type": "string",
        "description": "",
        "optional": true
      },
      {
        "name": "kind",
        "type": "\"reasoning-start\" | \"reasoning-chunk\" | \"reasoning-end\" | \"text-start\" | \"text-chunk\" | \"text-end\"",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "FakeAgentConfig",
    "kind": "interface",
    "description": "Shared config for the adapters' `provideFakeAgent()` helpers\n(@threadplane/langgraph and @threadplane/ag-ui). Drives an in-process\nfake backend that streams a canned assistant reply.",
    "properties": [
      {
        "name": "delayMs",
        "type": "number",
        "description": "Milliseconds between successive token emissions.",
        "optional": true
      },
      {
        "name": "reasoningTokens",
        "type": "string[]",
        "description": "Optional reasoning chunks emitted before the text reply.",
        "optional": true
      },
      {
        "name": "tokens",
        "type": "string[]",
        "description": "Assistant reply, streamed token-by-token.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "REASONING_FIXTURE_EVENTS",
    "kind": "const",
    "description": "Canonical sequence: reasoning starts, three reasoning chunks, reasoning\nends, text starts, three text chunks, text ends.",
    "signature": "AbstractEvent[]",
    "examples": []
  },
  {
    "name": "REASONING_FIXTURE_MESSAGE_ID",
    "kind": "const",
    "description": "",
    "signature": "\"fixture-msg-1\"",
    "examples": []
  },
  {
    "name": "REASONING_FIXTURE_REASONING",
    "kind": "const",
    "description": "",
    "signature": "\"I read the prompt and decided to greet the user.\"",
    "examples": []
  },
  {
    "name": "REASONING_FIXTURE_RESPONSE",
    "kind": "const",
    "description": "",
    "signature": "\"Hello!\"",
    "examples": []
  },
  {
    "name": "assertReasoningFixtureMessages",
    "kind": "function",
    "description": "Assertion — common to both adapters. Throws if the produced messages\ndon't match the shared expectation.",
    "signature": "assertReasoningFixtureMessages(messages: readonly Message[]): void",
    "params": [
      {
        "name": "messages",
        "type": "readonly Message[]",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "void",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "runAgentConformance",
    "kind": "function",
    "description": "Runs a suite of contract conformance assertions against a factory that\nproduces a fresh Agent. Adapter packages should call this in their\nown test suites to verify the contract is satisfied.",
    "signature": "runAgentConformance(label: string, factory: () => Agent<>): void",
    "params": [
      {
        "name": "label",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "factory",
        "type": "() => Agent<>",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "void",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "runAgentWithHistoryConformance",
    "kind": "function",
    "description": "Conformance suite for AgentWithHistory implementations.\n\nRuns the base Agent conformance suite, then verifies the history\nsignal is present and returns an array of AgentCheckpoint-shaped entries.",
    "signature": "runAgentWithHistoryConformance(label: string, factory: (seed: object) => AgentWithHistory<>): void",
    "params": [
      {
        "name": "label",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "factory",
        "type": "(seed: object) => AgentWithHistory<>",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "void",
      "description": ""
    },
    "examples": []
  }
]

### langgraph

[
  {
    "name": "AgentLifecycleRegistry",
    "kind": "class",
    "description": "Optional registry that collects per-instance agent lifecycles within\nan Angular injection context. External instrumentation packages\n(e.g. cockpit-telemetry) provide this token and read from it.\n\n`@threadplane/langgraph` does NOT provide this itself — the configured agent\ninstance writes to the registry only when an external consumer has provided it.",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "lifecycles",
        "type": "Signal<readonly AgentLifecycle[]>",
        "description": "Reactive list of registered lifecycles.",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "register",
        "signature": "register(lifecycle: AgentLifecycle): void",
        "description": "",
        "params": [
          {
            "name": "lifecycle",
            "type": "AgentLifecycle",
            "description": "",
            "optional": false
          }
        ]
      }
    ]
  },
  {
    "name": "FakeStreamTransport",
    "kind": "class",
    "description": "In-process AgentTransport that auto-streams a canned assistant reply.\n\nBacks `provideFakeAgent()`. Unlike `MockAgentTransport` (passive, driven\nmanually from specs), this transport emits its tokens automatically on\n`stream()`, then completes — suitable for offline demos and integration tests.\n\nNOT for production use.",
    "params": [
      {
        "name": "config",
        "type": "FakeAgentConfig",
        "description": "",
        "optional": true
      }
    ],
    "examples": [],
    "properties": [],
    "methods": [
      {
        "name": "cancelRun",
        "signature": "cancelRun(_threadId: string, _runId: string, _signal: AbortSignal): Promise<void>",
        "description": "Optional: cancel a server-side run.",
        "params": [
          {
            "name": "_threadId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "_runId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "_signal",
            "type": "AbortSignal",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "createQueuedRun",
        "signature": "createQueuedRun(_assistantId: string, threadId: string, payload: unknown, _signal: AbortSignal, options: LangGraphSubmitOptions): Promise<AgentQueueEntry<unknown>>",
        "description": "Optional: create a server-side queued run without joining it immediately.",
        "params": [
          {
            "name": "_assistantId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "payload",
            "type": "unknown",
            "description": "",
            "optional": false
          },
          {
            "name": "_signal",
            "type": "AbortSignal",
            "description": "",
            "optional": false
          },
          {
            "name": "options",
            "type": "LangGraphSubmitOptions",
            "description": "",
            "optional": true
          }
        ]
      },
      {
        "name": "getHistory",
        "signature": "getHistory(_threadId: string, _signal: AbortSignal): Promise<ThreadState<DefaultValues>[]>",
        "description": "Optional: load persisted checkpoint history for a thread.",
        "params": [
          {
            "name": "_threadId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "_signal",
            "type": "AbortSignal",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "joinStream",
        "signature": "joinStream(): AsyncIterable<StreamEvent>",
        "description": "Optional: join an already-started run without creating a new one.",
        "params": []
      },
      {
        "name": "stream",
        "signature": "stream(_assistantId: string, _threadId: string | null, _payload: unknown, signal: AbortSignal, _options: LangGraphSubmitOptions): AsyncIterable<StreamEvent>",
        "description": "Open a streaming connection to an agent and yield events.",
        "params": [
          {
            "name": "_assistantId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "_threadId",
            "type": "string | null",
            "description": "",
            "optional": false
          },
          {
            "name": "_payload",
            "type": "unknown",
            "description": "",
            "optional": false
          },
          {
            "name": "signal",
            "type": "AbortSignal",
            "description": "",
            "optional": false
          },
          {
            "name": "_options",
            "type": "LangGraphSubmitOptions",
            "description": "",
            "optional": true
          }
        ]
      }
    ]
  },
  {
    "name": "FetchStreamTransport",
    "kind": "class",
    "description": "Production transport that connects to a LangGraph Platform API via HTTP and SSE.\n\nCreates threads automatically if no threadId is provided, and streams events\nusing the LangGraph SDK client.",
    "params": [
      {
        "name": "apiUrl",
        "type": "string",
        "description": "Base URL of the LangGraph Platform API",
        "optional": false
      },
      {
        "name": "onThreadId",
        "type": "(id: string) => void",
        "description": "Optional callback invoked when a new thread is created",
        "optional": true
      },
      {
        "name": "clientOptions",
        "type": "LangGraphClientOptions",
        "description": "Optional SDK client tuning (e.g. `maxRetries`)",
        "optional": true
      }
    ],
    "examples": [
      "```typescript\nconst transport = new FetchStreamTransport(\n  'http://localhost:2024',\n  (id) => console.log('New thread:', id),\n);\n```"
    ],
    "properties": [],
    "methods": [
      {
        "name": "cancelRun",
        "signature": "cancelRun(threadId: string, runId: string, signal: AbortSignal): Promise<void>",
        "description": "Cancel a server-side run.",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "runId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "signal",
            "type": "AbortSignal",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "createQueuedRun",
        "signature": "createQueuedRun(assistantId: string, threadId: string, payload: unknown, signal: AbortSignal, options: LangGraphSubmitOptions): Promise<AgentQueueEntry<unknown>>",
        "description": "Create a pending server-side run using LangGraph's enqueue strategy.",
        "params": [
          {
            "name": "assistantId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "payload",
            "type": "unknown",
            "description": "",
            "optional": false
          },
          {
            "name": "signal",
            "type": "AbortSignal",
            "description": "",
            "optional": false
          },
          {
            "name": "options",
            "type": "LangGraphSubmitOptions",
            "description": "",
            "optional": true
          }
        ]
      },
      {
        "name": "getHistory",
        "signature": "getHistory(threadId: string, signal: AbortSignal): Promise<ThreadState<DefaultValues>[]>",
        "description": "Load persisted checkpoint history for a thread.",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "signal",
            "type": "AbortSignal",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "joinStream",
        "signature": "joinStream(threadId: string, runId: string, lastEventId: string | undefined, signal: AbortSignal): AsyncIterable<StreamEvent>",
        "description": "Join an already-started run without creating a new thread.",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "runId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "lastEventId",
            "type": "string | undefined",
            "description": "",
            "optional": false
          },
          {
            "name": "signal",
            "type": "AbortSignal",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "stream",
        "signature": "stream(assistantId: string, threadId: string | null, payload: unknown, signal: AbortSignal, options: LangGraphSubmitOptions): AsyncIterable<StreamEvent>",
        "description": "Open a streaming connection, creating a thread if needed.",
        "params": [
          {
            "name": "assistantId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "threadId",
            "type": "string | null",
            "description": "",
            "optional": false
          },
          {
            "name": "payload",
            "type": "unknown",
            "description": "",
            "optional": false
          },
          {
            "name": "signal",
            "type": "AbortSignal",
            "description": "",
            "optional": false
          },
          {
            "name": "options",
            "type": "LangGraphSubmitOptions",
            "description": "",
            "optional": true
          }
        ]
      },
      {
        "name": "updateState",
        "signature": "updateState(threadId: string, values: Record<string, unknown>, _signal: AbortSignal, options: object): Promise<void>",
        "description": "Update server-side thread state, e.g. to remove messages for regenerate rollback.",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "values",
            "type": "Record<string, unknown>",
            "description": "",
            "optional": false
          },
          {
            "name": "_signal",
            "type": "AbortSignal",
            "description": "",
            "optional": false
          },
          {
            "name": "options",
            "type": "object",
            "description": "",
            "optional": true
          }
        ]
      }
    ]
  },
  {
    "name": "LangGraphThreadsAdapter",
    "kind": "class",
    "description": "SDK-backed thread store. Wraps `client.threads.*` and maps SDK\nthreads to the framework's Thread type for direct use with\n`<chat-thread-list>` / `<chat-sidenav>`.\n\nConsumers wire the framework's `ThreadActionAdapter` to instance\nmethods (rename/delete/archive/pin/...) so the right-click menu\nround-trips through the LangGraph SDK without per-app boilerplate.",
    "params": [],
    "examples": [
      "```ts\nconst svc = inject(LangGraphThreadsAdapter);\nconst actions: ThreadActionAdapter = {\n  rename: (id, t) => svc.rename(id, t),\n  delete: (id) => svc.delete(id),\n};\n```"
    ],
    "properties": [
      {
        "name": "archivedThreads",
        "type": "Signal<Thread[]>",
        "description": "Threads whose `metadata.archived === true`.",
        "optional": false
      },
      {
        "name": "threads",
        "type": "Signal<Thread[]>",
        "description": "Active (non-archived) threads, sorted with pinned first.",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "archive",
        "signature": "archive(threadId: string): Promise<void>",
        "description": "",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "create",
        "signature": "create(metadata: Record<string, unknown>): Promise<string | null>",
        "description": "",
        "params": [
          {
            "name": "metadata",
            "type": "Record<string, unknown>",
            "description": "",
            "optional": true
          }
        ]
      },
      {
        "name": "delete",
        "signature": "delete(threadId: string): Promise<void>",
        "description": "",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "getThread",
        "signature": "getThread(threadId: string): Promise<Thread | null>",
        "description": "Fetch a single thread by id. Returns `null` when the server\n returns 404 (thread doesn't exist) so callers can distinguish\n \"missing\" from \"couldn't reach the server\" — genuine network\n errors rethrow. Used by URL-based thread routing to validate a\n pasted/shared thread id before activating it.",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "moveToProject",
        "signature": "moveToProject(threadId: string, projectId: string | null): Promise<void>",
        "description": "",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "projectId",
            "type": "string | null",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "pin",
        "signature": "pin(threadId: string): Promise<void>",
        "description": "",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "refresh",
        "signature": "refresh(): Promise<void>",
        "description": "Fetch the latest thread list from the server. Failures are\n logged via `console.error` (not swallowed silently — silent\n catches have masked prod issues in the past).\n\n Invocation and resolution are logged at `console.debug` so prod\n inspection can distinguish \"never called\" from \"called but\n resolved empty\" from \"called and threw.\" This was prompted by a\n demo.threadplane.ai cold-load bug where the sidenav stayed empty\n with no visible signal. Tighten the log volume if it becomes\n noisy.",
        "params": []
      },
      {
        "name": "rename",
        "signature": "rename(threadId: string, newTitle: string): Promise<void>",
        "description": "",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "newTitle",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "reorderPinned",
        "signature": "reorderPinned(threadId: string, beforeId: string | null): Promise<void>",
        "description": "Re-stamp `metadata.pinnedOrder = 0,1,2,...` for the pinned slice\n to reflect the new ordering.",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "beforeId",
            "type": "string | null",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "unarchive",
        "signature": "unarchive(threadId: string): Promise<void>",
        "description": "",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "unpin",
        "signature": "unpin(threadId: string): Promise<void>",
        "description": "",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      }
    ]
  },
  {
    "name": "MockAgentTransport",
    "kind": "class",
    "description": "Test transport for deterministic agent testing without a real LangGraph server.\n\nScript event batches upfront, then emit them manually or step through them\nin your test specs. Supports error injection and close control.",
    "params": [
      {
        "name": "script",
        "type": "StreamEvent[][]",
        "description": "Array of event batches. Each batch is emitted as a group.",
        "optional": true
      }
    ],
    "examples": [
      "```typescript\nconst transport = new MockAgentTransport([\n  [{ type: 'values', messages: [aiMsg('Hello')] }],\n  [{ type: 'values', messages: [aiMsg('Done')] }],\n]);\n```"
    ],
    "properties": [
      {
        "name": "cancelledRuns",
        "type": "object[]",
        "description": "",
        "optional": false
      },
      {
        "name": "createdQueuedRuns",
        "type": "AgentQueueEntry<unknown>[]",
        "description": "",
        "optional": false
      },
      {
        "name": "history",
        "type": "ThreadState<DefaultValues>[]",
        "description": "",
        "optional": false
      },
      {
        "name": "historyCalls",
        "type": "string[]",
        "description": "",
        "optional": false
      },
      {
        "name": "joinedRuns",
        "type": "object[]",
        "description": "",
        "optional": false
      },
      {
        "name": "streams",
        "type": "object[]",
        "description": "",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "cancelRun",
        "signature": "cancelRun(threadId: string, runId: string, signal: AbortSignal): Promise<void>",
        "description": "Optional: cancel a server-side run.",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "runId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "signal",
            "type": "AbortSignal",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "close",
        "signature": "close(): void",
        "description": "Close the stream. Remaining queued events are drained before completion.",
        "params": []
      },
      {
        "name": "createQueuedRun",
        "signature": "createQueuedRun(_assistantId: string, threadId: string, payload: unknown, signal: AbortSignal, options: LangGraphSubmitOptions): Promise<AgentQueueEntry<unknown>>",
        "description": "Optional: create a server-side queued run without joining it immediately.",
        "params": [
          {
            "name": "_assistantId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "payload",
            "type": "unknown",
            "description": "",
            "optional": false
          },
          {
            "name": "signal",
            "type": "AbortSignal",
            "description": "",
            "optional": false
          },
          {
            "name": "options",
            "type": "LangGraphSubmitOptions",
            "description": "",
            "optional": true
          }
        ]
      },
      {
        "name": "emit",
        "signature": "emit(events: StreamEvent[]): void",
        "description": "Manually emit events into the stream.",
        "params": [
          {
            "name": "events",
            "type": "StreamEvent[]",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "emitError",
        "signature": "emitError(err: Error): void",
        "description": "Inject an error into the stream.",
        "params": [
          {
            "name": "err",
            "type": "Error",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "getHistory",
        "signature": "getHistory(threadId: string, signal: AbortSignal): Promise<ThreadState<DefaultValues>[]>",
        "description": "Optional: load persisted checkpoint history for a thread.",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "signal",
            "type": "AbortSignal",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "isStreaming",
        "signature": "isStreaming(): boolean",
        "description": "Returns true if a stream is currently active.",
        "params": []
      },
      {
        "name": "joinStream",
        "signature": "joinStream(threadId: string, runId: string, lastEventId: string | undefined, signal: AbortSignal): AsyncIterable<StreamEvent>",
        "description": "Optional: join an already-started run without creating a new one.",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "runId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "lastEventId",
            "type": "string | undefined",
            "description": "",
            "optional": false
          },
          {
            "name": "signal",
            "type": "AbortSignal",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "nextBatch",
        "signature": "nextBatch(): StreamEvent[]",
        "description": "Advance to the next scripted batch. Pass the returned events to `emit()`.",
        "params": []
      },
      {
        "name": "stream",
        "signature": "stream(_assistantId: string, _threadId: string | null, _payload: unknown, signal: AbortSignal, options: LangGraphSubmitOptions): AsyncIterable<StreamEvent>",
        "description": "Open a streaming connection to an agent and yield events.",
        "params": [
          {
            "name": "_assistantId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "_threadId",
            "type": "string | null",
            "description": "",
            "optional": false
          },
          {
            "name": "_payload",
            "type": "unknown",
            "description": "",
            "optional": false
          },
          {
            "name": "signal",
            "type": "AbortSignal",
            "description": "",
            "optional": false
          },
          {
            "name": "options",
            "type": "LangGraphSubmitOptions",
            "description": "",
            "optional": true
          }
        ]
      }
    ]
  },
  {
    "name": "AgentBranchTree",
    "kind": "interface",
    "description": "Tree representation of LangGraph checkpoint history for time-travel UIs.",
    "properties": [
      {
        "name": "items",
        "type": "AgentBranchTreeNode<T> | AgentBranchTreeFork<T>[]",
        "description": "",
        "optional": false
      },
      {
        "name": "type",
        "type": "\"sequence\"",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "AgentBranchTreeFork",
    "kind": "interface",
    "description": "A branch fork where each item is an alternate checkpoint sequence.",
    "properties": [
      {
        "name": "items",
        "type": "AgentBranchTree<T>[]",
        "description": "",
        "optional": false
      },
      {
        "name": "type",
        "type": "\"fork\"",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "AgentBranchTreeNode",
    "kind": "interface",
    "description": "A checkpoint entry in the experimental branch tree.",
    "properties": [
      {
        "name": "path",
        "type": "string[]",
        "description": "",
        "optional": false
      },
      {
        "name": "type",
        "type": "\"node\"",
        "description": "",
        "optional": false
      },
      {
        "name": "value",
        "type": "ThreadState<T>",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "AgentConfig",
    "kind": "interface",
    "description": "Configuration for an agent instance.\nCombines connection defaults with per-component options so the\nagent can be constructed once at provider time and injected\neverywhere it is needed.",
    "properties": [
      {
        "name": "apiUrl",
        "type": "string",
        "description": "Base URL of the LangGraph Platform API (e.g., `'http://localhost:2024'`).",
        "optional": true
      },
      {
        "name": "assistantId",
        "type": "string",
        "description": "Agent or graph identifier on the LangGraph platform.",
        "optional": true
      },
      {
        "name": "clientOptions",
        "type": "LangGraphClientOptions",
        "description": "Tuning options for the default transport's LangGraph SDK client (e.g. retry budget).",
        "optional": true
      },
      {
        "name": "initialValues",
        "type": "Partial<T>",
        "description": "Initial state values before the first stream response arrives.",
        "optional": true
      },
      {
        "name": "onThreadId",
        "type": "(id: string) => void",
        "description": "Called when a new thread is auto-created by the transport.",
        "optional": true
      },
      {
        "name": "subagentToolNames",
        "type": "string[]",
        "description": "Tool names that indicate a subagent invocation.",
        "optional": true
      },
      {
        "name": "telemetry",
        "type": "false | AgentRuntimeTelemetrySink",
        "description": "Omit to enable automatic development-only collection. Set `false` to disable.\nAn app-owned sink replaces the automatic destination and receives the\nexisting runtime lifecycle callbacks.",
        "optional": true
      },
      {
        "name": "threadId",
        "type": "string | Signal<string | null> | null",
        "description": "Thread ID to connect to. Pass a Signal for reactive thread switching.",
        "optional": true
      },
      {
        "name": "throttle",
        "type": "number | false",
        "description": "Throttle signal updates in milliseconds. `false` to disable.",
        "optional": true
      },
      {
        "name": "toMessage",
        "type": "(msg: unknown) => BaseMessage<>",
        "description": "Custom message deserializer for non-standard message formats.",
        "optional": true
      },
      {
        "name": "transcriptNodeNames",
        "type": "string[]",
        "description": "LangGraph node names whose `messages-tuple` LLM chunks should be projected\ninto the main chat transcript. Omit to accept all top-level message chunks.\nChild-graph (namespaced) chunks never reach the transcript regardless of\nthis option — they belong to their child stream in `subagents()`.",
        "optional": true
      },
      {
        "name": "transport",
        "type": "AgentTransport",
        "description": "Custom transport. Defaults to FetchStreamTransport.\n\nA custom transport owns its own thread creation, so the runtime cannot\nobserve it directly: report every thread id the transport creates through\nAgentConfig.onThreadId or through the `threadId` signal, otherwise\nthe runtime keeps sending `null` and a new thread is created on each submit.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "AgentLifecycle",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "interruptReceivedAt",
        "type": "Signal<number | null>",
        "description": "Epoch ms of the first interrupt$ non-null in this stream. Resets on switchThread().",
        "optional": false
      },
      {
        "name": "interruptResolvedAt",
        "type": "Signal<number | null>",
        "description": "Epoch ms of the most recent submit({ resume }) call. Resets on switchThread().",
        "optional": false
      },
      {
        "name": "streamErrorAt",
        "type": "Signal<object | null>",
        "description": "Epoch ms + classification of the most recent stream error. Resets on switchThread().",
        "optional": false
      },
      {
        "name": "streamStartedAt",
        "type": "Signal<number | null>",
        "description": "Epoch ms of the first stream chunk arrival. Resets on switchThread().",
        "optional": false
      },
      {
        "name": "threadCreatedAt",
        "type": "Signal<number | null>",
        "description": "Epoch ms when the agent's \"create new thread\" branch fired. Resets on switchThread().",
        "optional": false
      },
      {
        "name": "threadPersistedAt",
        "type": "Signal<number | null>",
        "description": "Epoch ms when an existing thread was restored from server (proves persistence). Resets on switchThread().",
        "optional": false
      },
      {
        "name": "toolCallCompletedAt",
        "type": "Signal<number | null>",
        "description": "Epoch ms of the first tool call result transition. Resets on switchThread().",
        "optional": false
      },
      {
        "name": "toolCallStartedAt",
        "type": "Signal<number | null>",
        "description": "Epoch ms of the first tool call append. Resets on switchThread().",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "AgentOptions",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "a2uiClientCapabilities",
        "type": "object",
        "description": "A2UI client capabilities (catalog negotiation) to advertise to the graph.\nWhen set, every plain-object run payload carries them under the\n`a2ui_client_capabilities` state key — mirroring how `client_tools`\nrides the payload. Read server-side via threadplane-middleware's\n`a2ui_client_capabilities(state)`. Use `@threadplane/chat`'s\n`a2uiClientCapabilities()` for the renderer's standard value.",
        "optional": true
      },
      {
        "name": "apiUrl",
        "type": "string",
        "description": "Base URL of the LangGraph Platform API. Defaults to `provideAgent({ apiUrl })` when omitted.",
        "optional": true
      },
      {
        "name": "assistantId",
        "type": "string",
        "description": "Agent or graph identifier on the LangGraph platform.",
        "optional": false
      },
      {
        "name": "clientOptions",
        "type": "LangGraphClientOptions",
        "description": "Tuning options for the default transport's LangGraph SDK client (e.g. retry budget).",
        "optional": true
      },
      {
        "name": "initialValues",
        "type": "Partial<T>",
        "description": "Initial state values before the first stream response arrives.",
        "optional": true
      },
      {
        "name": "onThreadId",
        "type": "(id: string) => void",
        "description": "Called when a new thread is auto-created by the transport.",
        "optional": true
      },
      {
        "name": "subagentToolNames",
        "type": "string[]",
        "description": "Tool names that indicate a subagent invocation.",
        "optional": true
      },
      {
        "name": "telemetry",
        "type": "false | AgentRuntimeTelemetrySink",
        "description": "Omit to enable automatic development-only collection. Set `false` to disable.\nAn app-owned sink replaces the automatic destination and receives the\nexisting runtime lifecycle callbacks.",
        "optional": true
      },
      {
        "name": "threadId",
        "type": "string | Signal<string | null> | null",
        "description": "Thread ID to connect to. Pass a Signal for reactive thread switching.",
        "optional": true
      },
      {
        "name": "throttle",
        "type": "number | false",
        "description": "Throttle signal updates in milliseconds. `false` to disable.",
        "optional": true
      },
      {
        "name": "toMessage",
        "type": "(msg: unknown) => BaseMessage<>",
        "description": "Custom message deserializer for non-standard message formats.",
        "optional": true
      },
      {
        "name": "transcriptNodeNames",
        "type": "string[]",
        "description": "LangGraph node names whose `messages-tuple` LLM chunks should be projected\ninto the main chat transcript. Omit to accept all top-level message chunks.\nChild-graph (namespaced) chunks never reach the transcript regardless of\nthis option — they belong to their child stream in `subagents()`.\n\nUse this when a graph has side-effect LLM nodes, such as title generation,\nwhose streamed model output should not render as assistant chat content.",
        "optional": true
      },
      {
        "name": "transport",
        "type": "AgentTransport",
        "description": "Custom transport. Defaults to FetchStreamTransport.\n\nA custom transport owns its own thread creation, so the runtime cannot\nobserve it directly: report every thread id the transport creates through\nthis config's AgentOptions.onThreadId or through the `threadId`\nsignal, otherwise the runtime keeps sending `null` and a new thread is\ncreated on each submit.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "AgentQueue",
    "kind": "interface",
    "description": "Public queue surface for pending server-side LangGraph runs.",
    "properties": [
      {
        "name": "cancel",
        "type": "(id: string) => Promise<boolean>",
        "description": "Cancel a specific pending run by server run ID.",
        "optional": false
      },
      {
        "name": "clear",
        "type": "() => Promise<void>",
        "description": "Cancel all pending runs and clear the queue.",
        "optional": false
      },
      {
        "name": "entries",
        "type": "readonly AgentQueueEntry<T>[]",
        "description": "Read-only pending queue entries.",
        "optional": false
      },
      {
        "name": "size",
        "type": "number",
        "description": "Number of pending queue entries.",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "AgentQueueEntry",
    "kind": "interface",
    "description": "A queued server-side LangGraph run.",
    "properties": [
      {
        "name": "createdAt",
        "type": "Date",
        "description": "Timestamp when the queued run was registered locally.",
        "optional": false
      },
      {
        "name": "id",
        "type": "string",
        "description": "Server-side run ID.",
        "optional": false
      },
      {
        "name": "options",
        "type": "LangGraphSubmitOptions",
        "description": "Submit options used when the queued run was created.",
        "optional": true
      },
      {
        "name": "threadId",
        "type": "string",
        "description": "Thread that owns the queued run.",
        "optional": false
      },
      {
        "name": "values",
        "type": "T | null | undefined",
        "description": "Values submitted for the queued run.",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "AgentTransport",
    "kind": "interface",
    "description": "Transport interface for connecting to a LangGraph agent.",
    "properties": [],
    "methods": [
      {
        "name": "cancelRun",
        "signature": "cancelRun(threadId: string, runId: string, signal: AbortSignal): Promise<void>",
        "description": "Optional: cancel a server-side run.",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "runId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "signal",
            "type": "AbortSignal",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "createQueuedRun",
        "signature": "createQueuedRun(assistantId: string, threadId: string, payload: unknown, signal: AbortSignal, options: LangGraphSubmitOptions): Promise<AgentQueueEntry<unknown>>",
        "description": "Optional: create a server-side queued run without joining it immediately.",
        "params": [
          {
            "name": "assistantId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "payload",
            "type": "unknown",
            "description": "",
            "optional": false
          },
          {
            "name": "signal",
            "type": "AbortSignal",
            "description": "",
            "optional": false
          },
          {
            "name": "options",
            "type": "LangGraphSubmitOptions",
            "description": "",
            "optional": true
          }
        ]
      },
      {
        "name": "getHistory",
        "signature": "getHistory(threadId: string, signal: AbortSignal): Promise<ThreadState<DefaultValues>[]>",
        "description": "Optional: load persisted checkpoint history for a thread.",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "signal",
            "type": "AbortSignal",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "joinStream",
        "signature": "joinStream(threadId: string, runId: string, lastEventId: string | undefined, signal: AbortSignal): AsyncIterable<StreamEvent>",
        "description": "Optional: join an already-started run without creating a new one.",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "runId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "lastEventId",
            "type": "string | undefined",
            "description": "",
            "optional": false
          },
          {
            "name": "signal",
            "type": "AbortSignal",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "stream",
        "signature": "stream(assistantId: string, threadId: string | null, payload: unknown, signal: AbortSignal, options: LangGraphSubmitOptions): AsyncIterable<StreamEvent>",
        "description": "Open a streaming connection to an agent and yield events.",
        "params": [
          {
            "name": "assistantId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "threadId",
            "type": "string | null",
            "description": "",
            "optional": false
          },
          {
            "name": "payload",
            "type": "unknown",
            "description": "",
            "optional": false
          },
          {
            "name": "signal",
            "type": "AbortSignal",
            "description": "",
            "optional": false
          },
          {
            "name": "options",
            "type": "LangGraphSubmitOptions",
            "description": "",
            "optional": true
          }
        ]
      },
      {
        "name": "updateState",
        "signature": "updateState(threadId: string, values: Record<string, unknown>, signal: AbortSignal, options: object): Promise<void>",
        "description": "Optional: update server-side thread state (e.g. to emit RemoveMessage\nentries for regenerate rollback). Forwards to the LangGraph\n`threads.updateState` API.\n\n`options.asNode` corresponds to LangGraph's `as_node` parameter — the\nserver treats the update as if that node had just produced the values,\nwhich determines what the next pull resumes. `regenerate()` passes\n`asNode: '__start__'` so the next `submit(null)` resumes at the entry\nnode and re-runs `generate` against the rolled-back state.",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "values",
            "type": "Record<string, unknown>",
            "description": "",
            "optional": false
          },
          {
            "name": "signal",
            "type": "AbortSignal",
            "description": "",
            "optional": false
          },
          {
            "name": "options",
            "type": "object",
            "description": "",
            "optional": true
          }
        ]
      }
    ],
    "examples": []
  },
  {
    "name": "CustomStreamEvent",
    "kind": "interface",
    "description": "A custom event emitted by the LangGraph backend via adispatch_custom_event().",
    "properties": [
      {
        "name": "data",
        "type": "unknown",
        "description": "Arbitrary payload from the backend.",
        "optional": false
      },
      {
        "name": "name",
        "type": "string",
        "description": "Event name set by the backend (e.g., 'state_update').",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "Interrupt",
    "kind": "interface",
    "description": "An interrupt thrown inside a thread.",
    "properties": [
      {
        "name": "id",
        "type": "string",
        "description": "The ID of the interrupt.",
        "optional": true
      },
      {
        "name": "namespace",
        "type": "string[]",
        "description": "Protocol namespace tuple for resume targeting (`[]` at root).\nPopulated for nested subgraph / subagent interrupts so\n`respond({ interruptId })` can resume without a separate\n`getThread()?.interrupts` lookup.",
        "optional": true
      },
      {
        "name": "ns",
        "type": "string[]",
        "description": "The namespace of the interrupt.",
        "optional": true
      },
      {
        "name": "resumable",
        "type": "boolean",
        "description": "Whether the interrupt can be resumed.",
        "optional": true
      },
      {
        "name": "value",
        "type": "TValue",
        "description": "The value of the interrupt.",
        "optional": true
      },
      {
        "name": "when",
        "type": "string & {} | \"during\"",
        "description": "Will be deprecated in the future.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "LangGraphAgent",
    "kind": "interface",
    "description": "Unified LangGraph agent surface returned by `injectAgent()`.\n\nExtends the runtime-neutral `AgentWithHistory` contract (chat-consumable)\nwith the full LangGraph-specific API. One object drives both `<chat>` and\nany LangGraph-specific demo. Raw LangGraph signals are prefixed with\n`langGraph` to avoid collision with the runtime-neutral names.",
    "properties": [
      {
        "name": "activeSubagents",
        "type": "Signal<SubagentStreamRef[]>",
        "description": "Filtered list of subagents with status 'running'.",
        "optional": false
      },
      {
        "name": "branch",
        "type": "Signal<string>",
        "description": "Current branch identifier for time-travel navigation.",
        "optional": false
      },
      {
        "name": "clientTools",
        "type": "ClientToolsCapability",
        "description": "Client-declared, client-executed tools. Call setCatalog() to register\ntool specs; the catalog is automatically shipped with every run via\n`input.client_tools`. Pending tool calls appear in pending() after\nthe run ends; resolve() returns a result and continues the run.",
        "optional": false
      },
      {
        "name": "customEvents",
        "type": "Signal<CustomStreamEvent[]>",
        "description": "Raw custom events stream (signal of array). The runtime-neutral\n `events$` Observable is derived from this.",
        "optional": false
      },
      {
        "name": "error",
        "type": "Signal<AgentError<> | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "events$",
        "type": "Observable<AgentEvent>",
        "description": "",
        "optional": false
      },
      {
        "name": "experimentalBranchTree",
        "type": "Signal<AgentBranchTree<T>>",
        "description": "Experimental branch tree derived from LangGraph checkpoint history.",
        "optional": false
      },
      {
        "name": "getMessagesMetadata",
        "type": "(msg: BaseMessage<>, idx: number) => MessageMetadata<Record<string, unknown>> | undefined",
        "description": "Get metadata for a specific message by index.",
        "optional": false
      },
      {
        "name": "getSubagent",
        "type": "(toolCallId: string) => SubagentStreamRef | undefined",
        "description": "Get a subagent stream by the tool call ID that spawned it.",
        "optional": false
      },
      {
        "name": "getSubagentsByMessage",
        "type": "(msg: AIMessage<>) => SubagentStreamRef[]",
        "description": "Get subagent streams spawned by the tool calls on a specific AI message.",
        "optional": false
      },
      {
        "name": "getSubagentsByType",
        "type": "(type: string) => SubagentStreamRef[]",
        "description": "Get subagent streams by their configured subagent type/name.",
        "optional": false
      },
      {
        "name": "getToolCalls",
        "type": "(msg: AIMessage<>) => ToolCallWithResult<>[]",
        "description": "Get tool call results associated with an AI message (LangGraph types).",
        "optional": false
      },
      {
        "name": "hasValue",
        "type": "Signal<boolean>",
        "description": "True once at least one value or message has been received.",
        "optional": false
      },
      {
        "name": "history",
        "type": "Signal<AgentCheckpoint[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "interrupt",
        "type": "Signal<AgentInterrupt | undefined>",
        "description": "",
        "optional": true
      },
      {
        "name": "isLoading",
        "type": "Signal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "isThreadLoading",
        "type": "Signal<boolean>",
        "description": "True while a thread switch is loading state from the server.",
        "optional": false
      },
      {
        "name": "joinStream",
        "type": "(runId: string, lastEventId: string) => Promise<void>",
        "description": "Join an already-running stream by run ID.",
        "optional": false
      },
      {
        "name": "langGraphHistory",
        "type": "Signal<ThreadState<T>[]>",
        "description": "Raw LangGraph history (ThreadState[]). Use `history` for AgentCheckpoint[].",
        "optional": false
      },
      {
        "name": "langGraphInterrupts",
        "type": "Signal<Interrupt<ResolvedBag[\"InterruptType\"]>[]>",
        "description": "All interrupts received during the current run (raw LangGraph shape).",
        "optional": false
      },
      {
        "name": "langGraphMessages",
        "type": "Signal<BaseMessage<MessageStructure<MessageToolSet>, MessageType>[]>",
        "description": "Raw LangChain BaseMessage list. Use `messages` for chat rendering.",
        "optional": false
      },
      {
        "name": "langGraphToolCalls",
        "type": "Signal<ToolCallWithResult<>[]>",
        "description": "Raw LangGraph tool calls (with run-state). Use `toolCalls` for chat rendering.",
        "optional": false
      },
      {
        "name": "lifecycle",
        "type": "AgentLifecycle",
        "description": "Lifecycle signals for observability/telemetry. Eight read-only signals\ncapture key transitions (first stream chunk, first interrupt, tool\ncall start/complete, thread create/persist, errors). All reset on\n`switchThread()`. See AgentLifecycle.",
        "optional": false
      },
      {
        "name": "messageCheckpoints",
        "type": "Signal<ReadonlyMap<string, string>>",
        "description": "Optional reactive map of `messageId → checkpointId`, computed by\nwalking history once: for each checkpoint, find the most recent\nassistant message present in its `values.messages` and pair them.\nUIs use this to anchor inline checkpoint markers on each assistant\nturn. Missing on adapters that don't compute it.",
        "optional": true
      },
      {
        "name": "messages",
        "type": "Signal<Message[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "queue",
        "type": "Signal<AgentQueue<unknown>>",
        "description": "Pending server-side runs created via `multitaskStrategy: 'enqueue'`.",
        "optional": false
      },
      {
        "name": "regenerate",
        "type": "(assistantMessageIndex: number) => Promise<void>",
        "description": "Discards the assistant message at the given index AND all messages after\nit, then re-runs the agent against the trimmed conversation tail. The\npreceding user message (at index - 1) is preserved and re-submitted as\nthe agent's input. No new user message is added to the history.\n\nThrows if the message at `index` is not 'assistant' role, or if the\nagent is currently loading another response.",
        "optional": false
      },
      {
        "name": "reload",
        "type": "() => void",
        "description": "Re-submit the last input to restart the stream.",
        "optional": false
      },
      {
        "name": "retry",
        "type": "() => Promise<void>",
        "description": "Re-run the last submitted input after a failure. No-op if a run is already\n in flight or there is nothing to retry. Clears `error` and sets loading.",
        "optional": false
      },
      {
        "name": "setBranch",
        "type": "(branch: string) => void",
        "description": "Set the active branch for time-travel navigation.",
        "optional": false
      },
      {
        "name": "state",
        "type": "Signal<T>",
        "description": "",
        "optional": false
      },
      {
        "name": "status",
        "type": "Signal<AgentStatus>",
        "description": "",
        "optional": false
      },
      {
        "name": "stop",
        "type": "() => Promise<void>",
        "description": "",
        "optional": false
      },
      {
        "name": "subagents",
        "type": "Signal<Map<string, Subagent>>",
        "description": "",
        "optional": true
      },
      {
        "name": "submit",
        "type": "(input: AgentSubmitInput | null | undefined, opts: AgentSubmitOptions & LangGraphSubmitOptions) => Promise<void>",
        "description": "Submit input, resume commands, checkpoint forks, or other LangGraph run options.",
        "optional": false
      },
      {
        "name": "switchThread",
        "type": "(threadId: string | null) => void",
        "description": "Switch to a different thread, resetting derived state.",
        "optional": false
      },
      {
        "name": "toolCalls",
        "type": "Signal<ToolCall[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "toolProgress",
        "type": "Signal<ToolProgress[]>",
        "description": "Progress updates for currently executing tools.",
        "optional": false
      },
      {
        "name": "value",
        "type": "Signal<T>",
        "description": "Current agent state values (raw, typed per the type parameter T).",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "LangGraphClientOptions",
    "kind": "interface",
    "description": "Tuning options for the underlying LangGraph SDK `Client` constructed by the\ndefault FetchStreamTransport. Ignored when a custom `transport` is\nsupplied (the transport owns its own client).",
    "properties": [
      {
        "name": "apiKey",
        "type": "string | null",
        "description": "API key passed directly to the LangGraph SDK client. `null` preserves the\nSDK's explicit no-key behavior; omission leaves the SDK default unchanged.",
        "optional": true
      },
      {
        "name": "maxRetries",
        "type": "number",
        "description": "How many times a failed request — including the initial stream connect —\nis retried with exponential backoff before the error surfaces. Maps to the\nSDK's `callerOptions.maxRetries`. Omitted → the SDK default (currently 4).\n\nSet `0` to fail fast: useful for e2e tests that force a connection failure\nand assert the error surfaces promptly, rather than after the full\nmulti-second backoff window.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "LangGraphSubmitOptions",
    "kind": "interface",
    "description": "Options accepted by LangGraph-backed submit calls.",
    "properties": [
      {
        "name": "afterSeconds",
        "type": "number",
        "description": "",
        "optional": true
      },
      {
        "name": "checkpoint",
        "type": "Omit<Checkpoint, \"thread_id\"> | null",
        "description": "",
        "optional": true
      },
      {
        "name": "checkpointDuring",
        "type": "boolean",
        "description": "",
        "optional": true
      },
      {
        "name": "checkpointId",
        "type": "string",
        "description": "",
        "optional": true
      },
      {
        "name": "command",
        "type": "Command",
        "description": "",
        "optional": true
      },
      {
        "name": "config",
        "type": "Config",
        "description": "",
        "optional": true
      },
      {
        "name": "context",
        "type": "unknown",
        "description": "",
        "optional": true
      },
      {
        "name": "durability",
        "type": "LangGraphDurability",
        "description": "",
        "optional": true
      },
      {
        "name": "feedbackKeys",
        "type": "string[]",
        "description": "",
        "optional": true
      },
      {
        "name": "ifNotExists",
        "type": "\"create\" | \"reject\"",
        "description": "",
        "optional": true
      },
      {
        "name": "interruptAfter",
        "type": "string[] | \"*\"",
        "description": "",
        "optional": true
      },
      {
        "name": "interruptBefore",
        "type": "string[] | \"*\"",
        "description": "",
        "optional": true
      },
      {
        "name": "metadata",
        "type": "Metadata",
        "description": "",
        "optional": true
      },
      {
        "name": "multitaskStrategy",
        "type": "LangGraphMultitaskStrategy",
        "description": "Strategy for handling concurrent runs on the same thread.",
        "optional": true
      },
      {
        "name": "onCompletion",
        "type": "LangGraphOnCompletion",
        "description": "",
        "optional": true
      },
      {
        "name": "onDisconnect",
        "type": "LangGraphOnDisconnect",
        "description": "",
        "optional": true
      },
      {
        "name": "onRunCreated",
        "type": "(params: object) => void",
        "description": "",
        "optional": true
      },
      {
        "name": "resume",
        "type": "unknown",
        "description": "Convenience alias normalized to `command.resume` before invoking LangGraph.",
        "optional": true
      },
      {
        "name": "signal",
        "type": "AbortSignal",
        "description": "",
        "optional": true
      },
      {
        "name": "streamMode",
        "type": "StreamMode[]",
        "description": "",
        "optional": true
      },
      {
        "name": "streamResumable",
        "type": "boolean",
        "description": "",
        "optional": true
      },
      {
        "name": "streamSubgraphs",
        "type": "boolean",
        "description": "",
        "optional": true
      },
      {
        "name": "webhook",
        "type": "string",
        "description": "",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "LangGraphThreadsConfig",
    "kind": "interface",
    "description": "Configuration consumed by LangGraphThreadsAdapter. Provide\nvia LANGGRAPH_THREADS_CONFIG (typically in app.config.ts):\n\n```ts\nproviders: [\n  { provide: LANGGRAPH_THREADS_CONFIG, useValue: {\n      apiUrl: environment.langGraphApiUrl,\n  }},\n],\n```\n\nThe adapter expects backends to write the thread title to\n`metadata.title`. Spec 2026-05-19-llm-generated-labels-design.md\noriginally proposed `metadata.thread_title` for cockpit caps but\nwe converged on `title` to match the canonical demo and avoid a\nper-cap configuration knob.",
    "properties": [
      {
        "name": "apiUrl",
        "type": "string",
        "description": "Base URL for the LangGraph Platform API. Accepts both absolute\n URLs and relative `/api`-style paths.",
        "optional": false
      },
      {
        "name": "titleFallback",
        "type": "string",
        "description": "Fallback label for threads whose title hasn't been written yet\n (e.g. created but never sent). Defaults to `'Untitled'`.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "MockLangGraphAgent",
    "kind": "interface",
    "description": "A LangGraphAgent mock with writable signals for easy test control.\n\nBuilds on the runtime-neutral MockAgent from `@threadplane/chat`\n(which supplies the neutral `Agent`-contract writable signals plus\n`submit`/`stop`/`regenerate` call tracking) and layers the LangGraph-specific\nwritable signals on top.\n\nCast the result of `mockLangGraphAgent()` to this type to access\nwritable signals without unsafe casts in test files.",
    "properties": [
      {
        "name": "_internal",
        "type": "object",
        "description": "",
        "optional": false
      },
      {
        "name": "activeSubagents",
        "type": "WritableSignal<SubagentStreamRef[]>",
        "description": "Filtered list of subagents with status 'running'.",
        "optional": false
      },
      {
        "name": "branch",
        "type": "WritableSignal<string>",
        "description": "Current branch identifier for time-travel navigation.",
        "optional": false
      },
      {
        "name": "clientTools",
        "type": "ClientToolsCapability",
        "description": "Client-declared, client-executed tools. Call setCatalog() to register\ntool specs; the catalog is automatically shipped with every run via\n`input.client_tools`. Pending tool calls appear in pending() after\nthe run ends; resolve() returns a result and continues the run.",
        "optional": false
      },
      {
        "name": "customEvents",
        "type": "WritableSignal<CustomStreamEvent[]>",
        "description": "Raw custom events stream (signal of array). The runtime-neutral\n `events$` Observable is derived from this.",
        "optional": false
      },
      {
        "name": "error",
        "type": "WritableSignal<AgentError<> | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "events$",
        "type": "Observable<AgentEvent>",
        "description": "",
        "optional": false
      },
      {
        "name": "experimentalBranchTree",
        "type": "WritableSignal<AgentBranchTree<any>>",
        "description": "Experimental branch tree derived from LangGraph checkpoint history.",
        "optional": false
      },
      {
        "name": "getMessagesMetadata",
        "type": "(msg: BaseMessage<>, idx: number) => MessageMetadata<Record<string, unknown>> | undefined",
        "description": "Get metadata for a specific message by index.",
        "optional": false
      },
      {
        "name": "getSubagent",
        "type": "(toolCallId: string) => SubagentStreamRef | undefined",
        "description": "Get a subagent stream by the tool call ID that spawned it.",
        "optional": false
      },
      {
        "name": "getSubagentsByMessage",
        "type": "(msg: AIMessage<>) => SubagentStreamRef[]",
        "description": "Get subagent streams spawned by the tool calls on a specific AI message.",
        "optional": false
      },
      {
        "name": "getSubagentsByType",
        "type": "(type: string) => SubagentStreamRef[]",
        "description": "Get subagent streams by their configured subagent type/name.",
        "optional": false
      },
      {
        "name": "getToolCalls",
        "type": "(msg: AIMessage<>) => ToolCallWithResult<>[]",
        "description": "Get tool call results associated with an AI message (LangGraph types).",
        "optional": false
      },
      {
        "name": "hasValue",
        "type": "WritableSignal<boolean>",
        "description": "True once at least one value or message has been received.",
        "optional": false
      },
      {
        "name": "history",
        "type": "WritableSignal<AgentCheckpoint[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "interrupt",
        "type": "WritableSignal<AgentInterrupt | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "isLoading",
        "type": "WritableSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "isThreadLoading",
        "type": "WritableSignal<boolean>",
        "description": "True while a thread switch is loading state from the server.",
        "optional": false
      },
      {
        "name": "joinStream",
        "type": "(runId: string, lastEventId: string) => Promise<void>",
        "description": "Join an already-running stream by run ID.",
        "optional": false
      },
      {
        "name": "langGraphHistory",
        "type": "WritableSignal<ThreadState<any>[]>",
        "description": "Raw LangGraph history (ThreadState[]). Use `history` for AgentCheckpoint[].",
        "optional": false
      },
      {
        "name": "langGraphInterrupts",
        "type": "WritableSignal<Interrupt<any>[]>",
        "description": "All interrupts received during the current run (raw LangGraph shape).",
        "optional": false
      },
      {
        "name": "langGraphMessages",
        "type": "WritableSignal<BaseMessage<MessageStructure<MessageToolSet>, MessageType>[]>",
        "description": "Raw LangChain BaseMessage list. Use `messages` for chat rendering.",
        "optional": false
      },
      {
        "name": "langGraphToolCalls",
        "type": "WritableSignal<ToolCallWithResult<>[]>",
        "description": "Raw LangGraph tool calls (with run-state). Use `toolCalls` for chat rendering.",
        "optional": false
      },
      {
        "name": "lifecycle",
        "type": "AgentLifecycle",
        "description": "Lifecycle signals for observability/telemetry. Eight read-only signals\ncapture key transitions (first stream chunk, first interrupt, tool\ncall start/complete, thread create/persist, errors). All reset on\n`switchThread()`. See AgentLifecycle.",
        "optional": false
      },
      {
        "name": "messageCheckpoints",
        "type": "Signal<ReadonlyMap<string, string>>",
        "description": "Optional reactive map of `messageId → checkpointId`, computed by\nwalking history once: for each checkpoint, find the most recent\nassistant message present in its `values.messages` and pair them.\nUIs use this to anchor inline checkpoint markers on each assistant\nturn. Missing on adapters that don't compute it.",
        "optional": true
      },
      {
        "name": "messages",
        "type": "WritableSignal<Message[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "queue",
        "type": "WritableSignal<AgentQueue<unknown>>",
        "description": "Pending server-side runs created via `multitaskStrategy: 'enqueue'`.",
        "optional": false
      },
      {
        "name": "regenerate",
        "type": "(assistantMessageIndex: number) => Promise<void>",
        "description": "Discards the assistant message at the given index AND all messages after\nit, then re-runs the agent against the trimmed conversation tail. The\npreceding user message (at index - 1) is preserved and re-submitted as\nthe agent's input. No new user message is added to the history.\n\nThrows if the message at `index` is not 'assistant' role, or if the\nagent is currently loading another response.",
        "optional": false
      },
      {
        "name": "reload",
        "type": "() => void",
        "description": "Re-submit the last input to restart the stream.",
        "optional": false
      },
      {
        "name": "retry",
        "type": "() => Promise<void>",
        "description": "Re-run the last submitted input after a failure. No-op if a run is already\n in flight or there is nothing to retry. Clears `error` and sets loading.",
        "optional": false
      },
      {
        "name": "setBranch",
        "type": "(branch: string) => void",
        "description": "Set the active branch for time-travel navigation.",
        "optional": false
      },
      {
        "name": "state",
        "type": "Signal<any>",
        "description": "",
        "optional": false
      },
      {
        "name": "status",
        "type": "WritableSignal<AgentStatus>",
        "description": "",
        "optional": false
      },
      {
        "name": "stop",
        "type": "() => Promise<void>",
        "description": "",
        "optional": false
      },
      {
        "name": "stopCount",
        "type": "number",
        "description": "",
        "optional": false
      },
      {
        "name": "subagents",
        "type": "WritableSignal<Map<string, Subagent>>",
        "description": "",
        "optional": false
      },
      {
        "name": "submit",
        "type": "(input: AgentSubmitInput | null | undefined, opts: AgentSubmitOptions & LangGraphSubmitOptions) => Promise<void>",
        "description": "Submit input, resume commands, checkpoint forks, or other LangGraph run options.",
        "optional": false
      },
      {
        "name": "submitCalls",
        "type": "object[]",
        "description": "",
        "optional": false
      },
      {
        "name": "switchThread",
        "type": "(threadId: string | null) => void",
        "description": "Switch to a different thread, resetting derived state.",
        "optional": false
      },
      {
        "name": "toolCalls",
        "type": "WritableSignal<ToolCall[]>",
        "description": "",
        "optional": false
      },
      {
        "name": "toolProgress",
        "type": "WritableSignal<ToolProgress[]>",
        "description": "Progress updates for currently executing tools.",
        "optional": false
      },
      {
        "name": "value",
        "type": "WritableSignal<any>",
        "description": "Current agent state values (raw, typed per the type parameter T).",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "StreamEvent",
    "kind": "interface",
    "description": "An event emitted by a LangGraph stream.",
    "properties": [
      {
        "name": "messageMetadata",
        "type": "Record<string, unknown>",
        "description": "",
        "optional": true
      },
      {
        "name": "messages",
        "type": "unknown[]",
        "description": "",
        "optional": true
      },
      {
        "name": "namespace",
        "type": "string[]",
        "description": "",
        "optional": true
      },
      {
        "name": "type",
        "type": "\"error\" | \"values\" | \"messages\" | \"updates\" | \"events\" | \"debug\" | \"tasks\" | \"checkpoints\" | \"custom\" | \"tools\" | \"interrupt\" | `values|${string}` | `messages|${string}` | `messages/${string}` | `messages/${string}|${string}` | `updates|${string}` | `tools|${string}` | `custom|${string}` | `error|${string}` | \"metadata\" | `checkpoints|${string}` | `tasks|${string}` | `debug|${string}` | `events|${string}` | \"interrupts\"",
        "description": "Event type identifier (e.g., 'values', 'messages', 'error', 'interrupt').",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "SubagentStreamRef",
    "kind": "interface",
    "description": "Reference to a subagent's streaming state.",
    "properties": [
      {
        "name": "messages",
        "type": "Signal<BaseMessage<MessageStructure<MessageToolSet>, MessageType>[]>",
        "description": "Messages from the subagent conversation.",
        "optional": false
      },
      {
        "name": "name",
        "type": "string",
        "description": "Optional human-readable subagent type/name.",
        "optional": true
      },
      {
        "name": "status",
        "type": "Signal<\"running\" | \"error\" | \"complete\" | \"pending\">",
        "description": "Current execution status of the subagent.",
        "optional": false
      },
      {
        "name": "toolCallId",
        "type": "string",
        "description": "The tool call ID that spawned this subagent.",
        "optional": false
      },
      {
        "name": "values",
        "type": "Signal<Record<string, unknown>>",
        "description": "Current state values from the subagent.",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "SubmitOptions",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "checkpoint",
        "type": "Omit<Checkpoint, \"thread_id\"> | null",
        "description": "",
        "optional": true
      },
      {
        "name": "command",
        "type": "Command",
        "description": "",
        "optional": true
      },
      {
        "name": "config",
        "type": "ConfigWithConfigurable<ContextType>",
        "description": "",
        "optional": true
      },
      {
        "name": "context",
        "type": "ContextType",
        "description": "",
        "optional": true
      },
      {
        "name": "durability",
        "type": "Durability",
        "description": "Whether to checkpoint during the run (or only at the end/interruption).\n- `\"async\"`: Save checkpoint asynchronously while the next step executes (default).\n- `\"sync\"`: Save checkpoint synchronously before the next step starts.\n- `\"exit\"`: Save checkpoint only when the graph exits.",
        "optional": true
      },
      {
        "name": "feedbackKeys",
        "type": "string[]",
        "description": "",
        "optional": true
      },
      {
        "name": "interruptAfter",
        "type": "string[] | \"*\"",
        "description": "",
        "optional": true
      },
      {
        "name": "interruptBefore",
        "type": "string[] | \"*\"",
        "description": "",
        "optional": true
      },
      {
        "name": "metadata",
        "type": "Metadata",
        "description": "",
        "optional": true
      },
      {
        "name": "multitaskStrategy",
        "type": "MultitaskStrategy",
        "description": "",
        "optional": true
      },
      {
        "name": "onCompletion",
        "type": "OnCompletionBehavior",
        "description": "",
        "optional": true
      },
      {
        "name": "onDisconnect",
        "type": "DisconnectMode",
        "description": "",
        "optional": true
      },
      {
        "name": "onError",
        "type": "(error: unknown, run: RunCallbackMeta | undefined) => void",
        "description": "Callback that is called when an error occurs during this specific submit call.\nUnlike the hook-level `onError`, this allows handling errors on a per-submit basis,\ne.g. to show a retry button or a specific error message to the user.",
        "optional": true
      },
      {
        "name": "optimisticValues",
        "type": "Partial<StateType> | (prev: StateType) => Partial<StateType>",
        "description": "",
        "optional": true
      },
      {
        "name": "runId",
        "type": "string",
        "description": "",
        "optional": true
      },
      {
        "name": "streamMode",
        "type": "StreamMode[]",
        "description": "",
        "optional": true
      },
      {
        "name": "streamResumable",
        "type": "boolean",
        "description": "Mark the stream as resumable. All events emitted during the run will be temporarily persisted\nin order to be re-emitted if the stream is re-joined.",
        "optional": true
      },
      {
        "name": "streamSubgraphs",
        "type": "boolean",
        "description": "Whether or not to stream the nodes of any subgraphs called\nby the assistant.",
        "optional": true
      },
      {
        "name": "threadId",
        "type": "string",
        "description": "The ID to use when creating a new thread. When provided, this ID will be used\nfor thread creation when threadId is `null` or `undefined`.\nThis enables optimistic UI updates where you know the thread ID\nbefore the thread is actually created.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "ThreadState",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "checkpoint",
        "type": "Checkpoint",
        "description": "Checkpoint of the thread state",
        "optional": false
      },
      {
        "name": "created_at",
        "type": "Optional<string>",
        "description": "Time of state creation",
        "optional": false
      },
      {
        "name": "metadata",
        "type": "Metadata",
        "description": "Metadata for this state",
        "optional": false
      },
      {
        "name": "next",
        "type": "string[]",
        "description": "The next nodes to execute. If empty, the thread is done until new input is received",
        "optional": false
      },
      {
        "name": "parent_checkpoint",
        "type": "Optional<Checkpoint>",
        "description": "The parent checkpoint. If missing, this is the root checkpoint",
        "optional": false
      },
      {
        "name": "tasks",
        "type": "ThreadTask<DefaultValues, unknown>[]",
        "description": "Tasks to execute in this step. If already attempted, may contain an error",
        "optional": false
      },
      {
        "name": "values",
        "type": "ValuesType",
        "description": "The state values",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "BagTemplate",
    "kind": "type",
    "description": "Template for the bag type.",
    "signature": "unknown",
    "examples": []
  },
  {
    "name": "InferBag",
    "kind": "type",
    "description": "Infer the Bag type from an agent, defaulting to the provided Bag.\n\nCurrently returns the provided Bag for all types.\nCan be extended in the future to extract Bag from agent types.",
    "signature": "T extends { ~agentTypes: unknown } ? BagTemplate : B",
    "examples": []
  },
  {
    "name": "LangGraphMultitaskStrategy",
    "kind": "type",
    "description": "Strategy for handling concurrent LangGraph runs on the same thread.",
    "signature": "\"reject\" | \"interrupt\" | \"rollback\" | \"enqueue\"",
    "examples": []
  },
  {
    "name": "ResourceStatus",
    "kind": "type",
    "description": "Runtime constant mirroring Angular's ResourceStatus string-union type.\nAngular 21 ships ResourceStatus as a pure string-union type (no runtime value),\nso we provide a const-object shim for code that needs runtime comparisons.",
    "signature": "NgResourceStatus",
    "examples": []
  },
  {
    "name": "AGENT_LIFECYCLE",
    "kind": "const",
    "description": "",
    "signature": "InjectionToken<AgentLifecycle>",
    "examples": []
  },
  {
    "name": "LANGGRAPH_CLIENT",
    "kind": "const",
    "description": "Optional adapter clients can pass an explicit Client (e.g. for\n testing). When omitted, the adapter constructs one via\n createLangGraphClient.",
    "signature": "InjectionToken<Client<DefaultValues, DefaultValues, unknown>>",
    "examples": []
  },
  {
    "name": "LANGGRAPH_CLIENT_OPTIONS",
    "kind": "const",
    "description": "App-wide LangGraph SDK client tuning (e.g. `maxRetries`). Provide once at the\napp root; both the agent's default FetchStreamTransport and the\nLangGraphThreadsAdapter read it so the retry budget is configured in\none place. A call-site `agent({ clientOptions })` or per-agent\n`provideAgent({ clientOptions })` overrides it for that agent.\nAbsent → the SDK default.",
    "signature": "InjectionToken<LangGraphClientOptions>",
    "examples": []
  },
  {
    "name": "LANGGRAPH_THREADS_CONFIG",
    "kind": "const",
    "description": "",
    "signature": "InjectionToken<LangGraphThreadsConfig>",
    "examples": []
  },
  {
    "name": "ResourceStatus",
    "kind": "const",
    "description": "Runtime constant mirroring Angular's ResourceStatus string-union type.\nAngular 21 ships ResourceStatus as a pure string-union type (no runtime value),\nso we provide a const-object shim for code that needs runtime comparisons.",
    "signature": "object",
    "examples": []
  },
  {
    "name": "createLangGraphClient",
    "kind": "function",
    "description": "Construct a LangGraph SDK Client that accepts both absolute URLs\n(`http://localhost:2024`) and relative `/api`-style paths that get\nproxied by middleware in production. The SDK itself rejects\nrelative URLs, so this helper rewrites them against\n`window.location.origin` when running in the browser.\n\nSingle source of truth for the absolute-URL rewrite — the streaming\ntransport (`fetch-stream.transport.ts`) and the threads adapter\n(`LangGraphThreadsAdapter`) both go through here.\n\n`clientOptions.maxRetries` maps to the SDK's `callerOptions.maxRetries`,\nwhich governs how many times a failed request (including the initial\nstream connect) is retried with exponential backoff before the error\nsurfaces. Omitted → the SDK default (currently 4). Apps under test set\n`0` so a forced connection failure surfaces immediately instead of after\nthe full backoff window.",
    "signature": "createLangGraphClient(apiUrl: string, clientOptions: LangGraphClientOptions): Client<>",
    "params": [
      {
        "name": "apiUrl",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "clientOptions",
        "type": "LangGraphClientOptions",
        "description": "",
        "optional": true
      }
    ],
    "returns": {
      "type": "Client<>",
      "description": ""
    },
    "examples": [
      "```ts\nconst client = createLangGraphClient(environment.langGraphApiUrl);\nconst threads = await client.threads.search({ limit: 50 });\n```"
    ]
  },
  {
    "name": "extractCitations",
    "kind": "function",
    "description": "Normalize Citations out of a message's `additional_kwargs` (reading\n`citations` or `sources`). Exposed for advanced consumers building custom\nadapters or bridging non-LangGraph message shapes into the neutral\n`Citation[]` form.",
    "signature": "extractCitations(msg: KwargsLike): Citation[] | undefined",
    "params": [
      {
        "name": "msg",
        "type": "KwargsLike",
        "description": "Any object with an `additional_kwargs` bag (e.g. a LangChain message).",
        "optional": false
      }
    ],
    "returns": {
      "type": "Citation[] | undefined",
      "description": ""
    },
    "examples": [
      "```ts\nconst citations = extractCitations(lcMessage);\n```"
    ]
  },
  {
    "name": "injectAgent",
    "kind": "function",
    "description": "Retrieve the LangGraph-backed Agent from the current Angular injection context.\n\nMirrors `@threadplane/ag-ui`'s `injectAgent()` so consumer code is identical\nregardless of which adapter is wired in `app.config.ts`. The agent is a\nsingleton scoped to the injector that called `provideAgent()` — re-provide\nin a child component's `providers: []` to scope a different agent to that\nsubtree (Angular's hierarchical DI handles the rest).\n\n**Typed state via AgentRef.** Pass the same ref that was supplied to\n`provideAgent(ref, …)` to carry the state type through DI without repeating\nthe generic at every call site. The no-arg form defaults to\n`LangGraphAgent<Record<string, unknown>>`.",
    "signature": "injectAgent(): LangGraphAgent<Record<string, unknown>>",
    "params": [],
    "returns": {
      "type": "LangGraphAgent<Record<string, unknown>>",
      "description": ""
    },
    "examples": [
      "```ts\nconst agent = injectAgent(TRIP); // LangGraphAgent<TripState>\n```"
    ]
  },
  {
    "name": "mockLangGraphAgent",
    "kind": "function",
    "description": "Creates a mock LangGraphAgent with writable signals for testing.\nControl state by writing to the returned writable signals directly.\n\nNeutral `Agent`-contract signals come from mockAgent; LangGraph-specific\nsignals are declared here and layered on top.",
    "signature": "mockLangGraphAgent(initial: MockAgentOptions & { hasValue?: boolean; isThreadLoading?: boolean; langGraphMessages?: BaseMessage<MessageStructure<MessageToolSet>, MessageType>[] }): MockLangGraphAgent<>",
    "params": [
      {
        "name": "initial",
        "type": "MockAgentOptions & { hasValue?: boolean; isThreadLoading?: boolean; langGraphMessages?: BaseMessage<MessageStructure<MessageToolSet>, MessageType>[] }",
        "description": "",
        "optional": true
      }
    ],
    "returns": {
      "type": "MockLangGraphAgent<>",
      "description": ""
    },
    "examples": [
      "```ts\nconst agent = mockLangGraphAgent({ isThreadLoading: true });\nagent.messages.set([{ id: '1', role: 'assistant', content: 'Hi' }]);\n```"
    ]
  },
  {
    "name": "provideAgent",
    "kind": "function",
    "description": "Wire the LangGraph adapter into Angular's dependency injection.\n\nRegisters a singleton `LangGraphAgent` constructed from `config`. Retrieve it\nin any component with `injectAgent()`. Provide this at the application root\n(`app.config.ts`) for an app-wide agent.\n\nTo use a different agent in a component subtree, re-provide\n`provideAgent({...})` in that component's `providers: []` array —\nAngular's hierarchical DI scopes the singleton accordingly.\n\n**Static vs factory config.** Pass a plain `AgentConfig` object when the\nconfig is known up front. Pass a `() => AgentConfig` factory when the config\ndepends on runtime/DI state — the factory runs inside an Angular injection\ncontext, so it may call `inject()` to read services, route params, or\ncomponent-scoped signals.\n\n**Typed state via AgentRef.** Pass a typed ref as the first argument to flow\nthe state shape from `provideAgent` to `injectAgent` without repeating the\ngeneric at every call site.\n\n**Several agents at one injector level.** Each `provideAgent(ref, …)` call\nbuilds its own agent from its own config, so two (or more) refs may be\nprovided side by side in a single `providers` array and `injectAgent(refA)`\n/ `injectAgent(refB)` return distinct agents. The ref-less `injectAgent()`\nresolves a single shared token, which can only point at one of them: when\nmore than one ref is provided at the same level the **last** call wins.\nAlways inject by ref when an injector provides more than one agent.",
    "signature": "provideAgent(ref: AgentRef<T>, configOrFactory: AgentConfig<T, BagTemplate> | () => AgentConfig<T>): Provider[]",
    "params": [
      {
        "name": "ref",
        "type": "AgentRef<T>",
        "description": "",
        "optional": false
      },
      {
        "name": "configOrFactory",
        "type": "AgentConfig<T, BagTemplate> | () => AgentConfig<T>",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "Provider[]",
      "description": ""
    },
    "examples": [
      "```ts\nexport const LIVE = createAgentRef<ChatState>('live');\nexport const REPLAY = createAgentRef<ChatState>('replay');\nproviders: [\n  provideAgent(LIVE, { assistantId: 'chat' }),\n  provideAgent(REPLAY, { assistantId: 'chat', transport: replayTransport }),\n];\n// component: injectAgent(LIVE) !== injectAgent(REPLAY)\n```",
      "```ts\nproviders: [\n  provideAgent(() => {\n    const route = inject(ActivatedRoute);\n    return { assistantId: 'chat', threadId: toSignal(route.paramMap) };\n  }),\n];\n```",
      "```ts\nexport const TRIP = createAgentRef<TripState>('trip');\n// app.config.ts:\nproviders: [provideAgent(TRIP, { assistantId: 'trip-graph' })]\n// component:\nconst agent = injectAgent(TRIP); // LangGraphAgent<TripState>\n```"
    ]
  },
  {
    "name": "provideFakeAgent",
    "kind": "function",
    "description": "Wire an in-process fake LangGraph agent into Angular DI.\n\nStreams a canned assistant reply (see FakeAgentConfig) with no backend —\nthe symmetric counterpart to @threadplane/ag-ui's provideFakeAgent(). For\nadvanced manual scripting (tool calls, interrupts, multi-batch), provide\nthe agent yourself with\n`provideAgent({ assistantId, transport: new MockAgentTransport(...) })`.",
    "signature": "provideFakeAgent(config: FakeAgentConfig): Provider[]",
    "params": [
      {
        "name": "config",
        "type": "FakeAgentConfig",
        "description": "",
        "optional": true
      }
    ],
    "returns": {
      "type": "Provider[]",
      "description": ""
    },
    "examples": [
      "```ts\nTestBed.configureTestingModule({\n  providers: [provideFakeAgent({ tokens: ['Hi from the fake LangGraph agent'] })],\n});\n```"
    ]
  },
  {
    "name": "refreshOnRunEnd",
    "kind": "function",
    "description": "Call `fn` whenever the agent's status transitions out of `'running'`\n(i.e. when a run completes — success, error, or interrupt). Useful\nfor refreshing thread lists, telemetry, or any other state that\nlags the agent.\n\nMust be called within an injection context (constructor or\n`runInInjectionContext`) — uses Angular's `effect` under the hood.",
    "signature": "refreshOnRunEnd(agent: LangGraphAgent<>, fn: () => void | Promise<void>): void",
    "params": [
      {
        "name": "agent",
        "type": "LangGraphAgent<>",
        "description": "",
        "optional": false
      },
      {
        "name": "fn",
        "type": "() => void | Promise<void>",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "void",
      "description": ""
    },
    "examples": [
      "```ts\nconstructor() {\n  refreshOnRunEnd(this.agent, () => this.threads.refresh());\n}\n```"
    ]
  },
  {
    "name": "refreshOnTransition",
    "kind": "function",
    "description": "Call `fn` whenever any of the watched signals transitions from a\ntruthy \"active\" value to a non-active value. Generic version of\nrefreshOnRunEnd for callers tracking custom state machines.\n\nMust be called within an injection context.",
    "signature": "refreshOnTransition(watch: Signal<T>, isActive: (v: T) => boolean, fn: () => void | Promise<void>): void",
    "params": [
      {
        "name": "watch",
        "type": "Signal<T>",
        "description": "",
        "optional": false
      },
      {
        "name": "isActive",
        "type": "(v: T) => boolean",
        "description": "",
        "optional": false
      },
      {
        "name": "fn",
        "type": "() => void | Promise<void>",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "void",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "toAbsoluteApiUrl",
    "kind": "function",
    "description": "Exported separately so non-Client callers (e.g. raw fetch) can\n share the same normalization logic.",
    "signature": "toAbsoluteApiUrl(apiUrl: string): string",
    "params": [
      {
        "name": "apiUrl",
        "type": "string",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "string",
      "description": ""
    },
    "examples": []
  }
]

### middleware

[
  {
    "name": "BaseMessage",
    "kind": "interface",
    "description": "Base class for all types of messages in a conversation. It includes\nproperties like `content`, `name`, and `additional_kwargs`. It also\nincludes methods like `toDict()` and `_getType()`.",
    "properties": [
      {
        "name": "additional_kwargs",
        "type": "object",
        "description": "",
        "optional": false
      },
      {
        "name": "content",
        "type": "$InferMessageContent<TStructure, TRole>",
        "description": "Array of content blocks that make up the message content",
        "optional": false
      },
      {
        "name": "id",
        "type": "string",
        "description": "Unique identifier for this message",
        "optional": true
      },
      {
        "name": "lc_kwargs",
        "type": "SerializedFields",
        "description": "",
        "optional": false
      },
      {
        "name": "lc_namespace",
        "type": "string[]",
        "description": "A path to the module that contains the class, eg. [\"langchain\", \"llms\"]\nUsually should be the same as the entrypoint the class is exported from.",
        "optional": false
      },
      {
        "name": "lc_serializable",
        "type": "boolean",
        "description": "",
        "optional": false
      },
      {
        "name": "name",
        "type": "string",
        "description": "",
        "optional": true
      },
      {
        "name": "response_metadata",
        "type": "NonNullable<BaseMessageFields<TStructure, TRole>[\"response_metadata\"]>",
        "description": "Metadata about the message",
        "optional": false
      },
      {
        "name": "type",
        "type": "TRole",
        "description": "The message type/role",
        "optional": false
      },
      {
        "name": "_printableFields",
        "type": "unknown",
        "description": "",
        "optional": false
      },
      {
        "name": "[toStringTag]",
        "type": "unknown",
        "description": "",
        "optional": false
      },
      {
        "name": "contentBlocks",
        "type": "unknown",
        "description": "",
        "optional": false
      },
      {
        "name": "lc_aliases",
        "type": "unknown",
        "description": "",
        "optional": false
      },
      {
        "name": "lc_attributes",
        "type": "unknown",
        "description": "",
        "optional": false
      },
      {
        "name": "lc_id",
        "type": "unknown",
        "description": "",
        "optional": false
      },
      {
        "name": "lc_secrets",
        "type": "unknown",
        "description": "",
        "optional": false
      },
      {
        "name": "lc_serializable_keys",
        "type": "unknown",
        "description": "",
        "optional": false
      },
      {
        "name": "text",
        "type": "unknown",
        "description": "",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "_getType",
        "signature": "_getType(): MessageType",
        "description": "",
        "params": []
      },
      {
        "name": "_updateId",
        "signature": "_updateId(value: string | undefined): void",
        "description": "",
        "params": [
          {
            "name": "value",
            "type": "string | undefined",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "getType",
        "signature": "getType(): MessageType",
        "description": "",
        "params": []
      },
      {
        "name": "toDict",
        "signature": "toDict(): StoredMessage",
        "description": "",
        "params": []
      },
      {
        "name": "toFormattedString",
        "signature": "toFormattedString(format: \"pretty\"): string",
        "description": "",
        "params": [
          {
            "name": "format",
            "type": "\"pretty\"",
            "description": "",
            "optional": true
          }
        ]
      },
      {
        "name": "toJSON",
        "signature": "toJSON(): Serialized",
        "description": "",
        "params": []
      },
      {
        "name": "toJSONNotImplemented",
        "signature": "toJSONNotImplemented(): SerializedNotImplemented<>",
        "description": "",
        "params": []
      }
    ],
    "examples": []
  },
  {
    "name": "BindableModel",
    "kind": "interface",
    "description": "A chat model that can bind tools (the LangChain `Runnable.bindTools` surface).",
    "properties": [],
    "methods": [
      {
        "name": "bindTools",
        "signature": "bindTools(tools: unknown[], kwargs: unknown): unknown",
        "description": "",
        "params": [
          {
            "name": "tools",
            "type": "unknown[]",
            "description": "",
            "optional": false
          },
          {
            "name": "kwargs",
            "type": "unknown",
            "description": "",
            "optional": true
          }
        ]
      }
    ],
    "examples": []
  },
  {
    "name": "ClientToolExecutionKey",
    "kind": "interface",
    "description": "Durable identity for one client-tool execution on one thread.",
    "properties": [
      {
        "name": "threadId",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "toolCallId",
        "type": "string",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "ClientToolExecutionStore",
    "kind": "interface",
    "description": "Backend-authoritative store for client-tool execution deduplication.",
    "properties": [],
    "methods": [
      {
        "name": "claim",
        "signature": "claim(key: ClientToolExecutionKey): Promise<\"claimed\" | ClientToolExecutionRecord>",
        "description": "Atomically claim a tool-call execution. Returns prior state when present.",
        "params": [
          {
            "name": "key",
            "type": "ClientToolExecutionKey",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "lookup",
        "signature": "lookup(threadId: string, toolCallIds: readonly string[]): Promise<Record<string, ClientToolExecutionRecord>>",
        "description": "Reload reconciliation: statuses/results for selected tool calls on a thread.",
        "params": [
          {
            "name": "threadId",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "toolCallIds",
            "type": "readonly string[]",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "record",
        "signature": "record(key: ClientToolExecutionKey, result: ClientToolResult): Promise<void>",
        "description": "Record the final client-tool result for a claimed or first-seen execution.",
        "params": [
          {
            "name": "key",
            "type": "ClientToolExecutionKey",
            "description": "",
            "optional": false
          },
          {
            "name": "result",
            "type": "ClientToolResult",
            "description": "",
            "optional": false
          }
        ]
      }
    ],
    "examples": []
  },
  {
    "name": "ClientToolResultMessage",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "result",
        "type": "ClientToolResult",
        "description": "",
        "optional": false
      },
      {
        "name": "toolCallId",
        "type": "string",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "ClientToolSpec",
    "kind": "interface",
    "description": "A frontend-declared client tool: name + description + JSON-Schema parameters.",
    "properties": [
      {
        "name": "description",
        "type": "string",
        "description": "",
        "optional": true
      },
      {
        "name": "name",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "parameters",
        "type": "Record<string, unknown>",
        "description": "",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "ClientToolsState",
    "kind": "interface",
    "description": "The slice of graph state this middleware reads.",
    "properties": [
      {
        "name": "client_tools",
        "type": "ClientToolSpec[]",
        "description": "Fallback channel — the raw run input key.",
        "optional": true
      },
      {
        "name": "messages",
        "type": "BaseMessage<MessageStructure<MessageToolSet>, MessageType>[]",
        "description": "",
        "optional": false
      },
      {
        "name": "tools",
        "type": "ClientToolSpec[]",
        "description": "Primary channel — AG-UI/LangGraph merges RunAgentInput.tools here.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "OpenAIFunctionTool",
    "kind": "interface",
    "description": "The explicit OpenAI function-tool shape accepted by ChatModel.bindTools across versions.",
    "properties": [
      {
        "name": "function",
        "type": "object",
        "description": "",
        "optional": false
      },
      {
        "name": "type",
        "type": "\"function\"",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "PostgresClientToolExecutionStoreOptions",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "tenantId",
        "type": "string | null",
        "description": "Tenant scope for every read and write. Defaults to `''` (the single-tenant scope).",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "RecordClientToolResultsInput",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "messages",
        "type": "readonly BaseMessage<MessageStructure<MessageToolSet>, MessageType>[]",
        "description": "",
        "optional": false
      },
      {
        "name": "store",
        "type": "ClientToolExecutionStore",
        "description": "",
        "optional": false
      },
      {
        "name": "threadId",
        "type": "string",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "RecordClientToolResultsResult",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "duplicateToolCallIds",
        "type": "string[]",
        "description": "",
        "optional": false
      },
      {
        "name": "recordedToolCallIds",
        "type": "string[]",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "ClientToolExecutionRecord",
    "kind": "type",
    "description": "",
    "signature": "object | object | object",
    "examples": []
  },
  {
    "name": "ClientToolExecutionStatus",
    "kind": "type",
    "description": "",
    "signature": "\"executing\" | \"done\" | \"failed\"",
    "examples": []
  },
  {
    "name": "ClientToolResult",
    "kind": "type",
    "description": "Serialized result for a browser-executed client tool.",
    "signature": "object | object",
    "examples": []
  },
  {
    "name": "PostgresRow",
    "kind": "type",
    "description": "",
    "signature": "Record<string, unknown>",
    "examples": []
  },
  {
    "name": "PostgresTaggedSql",
    "kind": "type",
    "description": "",
    "signature": "(strings: TemplateStringsArray, ...values: unknown[]) => Promise<readonly PostgresRow[]>",
    "examples": []
  },
  {
    "name": "THREADPLANE_CLIENT_TOOL_EXECUTIONS_SCHEMA",
    "kind": "const",
    "description": "",
    "signature": "\"\\nCREATE TABLE IF NOT EXISTS threadplane_client_tool_executions (\\n  tenant_id     text        NOT NULL DEFAULT '',\\n  thread_id     text        NOT NULL,\\n  tool_call_id  text        NOT NULL,\\n  status        text        NOT NULL,\\n  result        jsonb,\\n  created_at    timestamptz NOT NULL DEFAULT now(),\\n  updated_at    timestamptz NOT NULL DEFAULT now(),\\n  PRIMARY KEY (tenant_id, thread_id, tool_call_id)\\n);\\n\"",
    "examples": []
  },
  {
    "name": "bindClientTools",
    "kind": "function",
    "description": "Bind server tools + the client catalog stubs onto `llm`. Call this INSIDE the\nagent node (per-run) — the client catalog arrives in state and may differ per run.",
    "signature": "bindClientTools(llm: M, serverTools: unknown[], state: ClientToolsState): ReturnType<M[\"bindTools\"]>",
    "params": [
      {
        "name": "llm",
        "type": "M",
        "description": "",
        "optional": false
      },
      {
        "name": "serverTools",
        "type": "unknown[]",
        "description": "",
        "optional": false
      },
      {
        "name": "state",
        "type": "ClientToolsState",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "ReturnType<M[\"bindTools\"]>",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "clientToolNames",
    "kind": "function",
    "description": "The set of tool names declared by the client in this run.",
    "signature": "clientToolNames(state: ClientToolsState): Set<string>",
    "params": [
      {
        "name": "state",
        "type": "ClientToolsState",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "Set<string>",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "clientToolsChannel",
    "kind": "function",
    "description": "State channels for the client-tools catalog. Spread into Annotation.Root so a graph\ndeclares the `tools` (primary) and `client_tools` (fallback) slices in one line:\n\n  const State = Annotation.Root({ ...MessagesAnnotation.spec, ...clientToolsChannel() });\n\nBoth are last-value-wins channels (the catalog is replaced per run, not accumulated).",
    "signature": "clientToolsChannel(): object",
    "params": [],
    "returns": {
      "type": "object",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "clientToolSpecs",
    "kind": "function",
    "description": "The client catalog as OpenAI function-tool dicts for `model.bindTools`.",
    "signature": "clientToolSpecs(state: ClientToolsState): OpenAIFunctionTool[]",
    "params": [
      {
        "name": "state",
        "type": "ClientToolsState",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "OpenAIFunctionTool[]",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "clientToolsRouter",
    "kind": "function",
    "description": "A prebuilt conditional-edge callback. serverToolNames is bound once at construction;\nthe returned function takes only state.\n\n  graph.addConditionalEdges('agent', clientToolsRouter([]), ['tools', END]);",
    "signature": "clientToolsRouter(serverToolNames: Iterable<string>, opts: object): (state: ClientToolsState) => string",
    "params": [
      {
        "name": "serverToolNames",
        "type": "Iterable<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "opts",
        "type": "object",
        "description": "",
        "optional": true
      }
    ],
    "returns": {
      "type": "(state: ClientToolsState) => string",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "createInMemoryClientToolExecutionStore",
    "kind": "function",
    "description": "Non-persistent store useful for tests and Tier-0/Tier-1 local backends.",
    "signature": "createInMemoryClientToolExecutionStore(): ClientToolExecutionStore",
    "params": [],
    "returns": {
      "type": "ClientToolExecutionStore",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "createPostgresClientToolExecutionStore",
    "kind": "function",
    "description": "Create a Postgres-backed client-tool execution store from a supplied SQL tag.",
    "signature": "createPostgresClientToolExecutionStore(sql: PostgresTaggedSql, opts: PostgresClientToolExecutionStoreOptions): ClientToolExecutionStore",
    "params": [
      {
        "name": "sql",
        "type": "PostgresTaggedSql",
        "description": "",
        "optional": false
      },
      {
        "name": "opts",
        "type": "PostgresClientToolExecutionStoreOptions",
        "description": "",
        "optional": true
      }
    ],
    "returns": {
      "type": "ClientToolExecutionStore",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "extractClientToolResultMessages",
    "kind": "function",
    "description": "Extract serialized client-tool results from LangGraph ToolMessages.",
    "signature": "extractClientToolResultMessages(messages: readonly BaseMessage<MessageStructure<MessageToolSet>, MessageType>[]): ClientToolResultMessage[]",
    "params": [
      {
        "name": "messages",
        "type": "readonly BaseMessage<MessageStructure<MessageToolSet>, MessageType>[]",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "ClientToolResultMessage[]",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "filterDuplicateClientToolResultMessages",
    "kind": "function",
    "description": "Remove duplicate client-tool result messages before server continuation logic sees them.",
    "signature": "filterDuplicateClientToolResultMessages(input: object): BaseMessage<MessageStructure<MessageToolSet>, MessageType>[]",
    "params": [
      {
        "name": "input",
        "type": "object",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "BaseMessage<MessageStructure<MessageToolSet>, MessageType>[]",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "hasClientToolCall",
    "kind": "function",
    "description": "True if the last message calls at least one client tool.",
    "signature": "hasClientToolCall(state: ClientToolsState): boolean",
    "params": [
      {
        "name": "state",
        "type": "ClientToolsState",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "boolean",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "hasServerToolCall",
    "kind": "function",
    "description": "True if the last message calls at least one server (non-client) tool.\nA call is server-side when its name is in serverToolNames OR is not a known\nclient tool (unknown tools are assumed server-side).",
    "signature": "hasServerToolCall(state: ClientToolsState, serverToolNames: Iterable<string>): boolean",
    "params": [
      {
        "name": "state",
        "type": "ClientToolsState",
        "description": "",
        "optional": false
      },
      {
        "name": "serverToolNames",
        "type": "Iterable<string>",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "boolean",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "lastMessage",
    "kind": "function",
    "description": "The last message from state.messages, or undefined.",
    "signature": "lastMessage(state: ClientToolsState): BaseMessage<MessageStructure<MessageToolSet>, MessageType> | undefined",
    "params": [
      {
        "name": "state",
        "type": "ClientToolsState",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "BaseMessage<MessageStructure<MessageToolSet>, MessageType> | undefined",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "lookupClientToolExecutions",
    "kind": "function",
    "description": "Lookup prior client-tool executions for reload reconciliation.",
    "signature": "lookupClientToolExecutions(input: object): Promise<Record<string, ClientToolExecutionRecord>>",
    "params": [
      {
        "name": "input",
        "type": "object",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "Promise<Record<string, ClientToolExecutionRecord>>",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "recordClientToolResults",
    "kind": "function",
    "description": "Record first-seen client-tool results and identify duplicate redeliveries.",
    "signature": "recordClientToolResults(input: RecordClientToolResultsInput): Promise<RecordClientToolResultsResult>",
    "params": [
      {
        "name": "input",
        "type": "RecordClientToolResultsInput",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "Promise<RecordClientToolResultsResult>",
      "description": ""
    },
    "examples": []
  },
  {
    "name": "routeAfterAgent",
    "kind": "function",
    "description": "Routing helper for a LangGraph conditional edge. Returns `toolsNode` when the last\nmessage has a server tool call (dispatch to the server ToolNode); otherwise `end`\n(client-only calls — the browser executes them — and no-tool-call turns both end).",
    "signature": "routeAfterAgent(state: ClientToolsState, serverToolNames: Iterable<string>, opts: object): string",
    "params": [
      {
        "name": "state",
        "type": "ClientToolsState",
        "description": "",
        "optional": false
      },
      {
        "name": "serverToolNames",
        "type": "Iterable<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "opts",
        "type": "object",
        "description": "",
        "optional": true
      }
    ],
    "returns": {
      "type": "string",
      "description": ""
    },
    "examples": []
  }
]

### render

[
  {
    "name": "DefaultFallbackComponent",
    "kind": "class",
    "description": "",
    "params": [],
    "examples": [],
    "properties": [],
    "methods": []
  },
  {
    "name": "RenderElementComponent",
    "kind": "class",
    "description": "Recursive element renderer.\n\nFor each element key it:\n1. Looks up the UIElement from spec.elements\n2. Resolves the component class from the registry\n3. Evaluates visibility\n4. Resolves prop expressions and bindings\n5. Renders via NgComponentOutlet with resolved inputs\n\nFor elements with `repeat`, it iterates over the state array,\ncreating a child Injector with RepeatScope for each item.",
    "params": [],
    "examples": [],
    "properties": [
      {
        "name": "componentClass",
        "type": "Signal<AngularComponentRenderer | null>",
        "description": "The Angular component class for this element type.",
        "optional": false
      },
      {
        "name": "element",
        "type": "Signal<UIElement<string, Record<string, unknown>> | undefined>",
        "description": "The UIElement definition from the spec. Only propagates when reference changes.",
        "optional": false
      },
      {
        "name": "elementKey",
        "type": "InputSignal<string>",
        "description": "",
        "optional": false
      },
      {
        "name": "entry",
        "type": "Signal<NormalizedEntry | undefined>",
        "description": "The full normalized registry entry for this element type.",
        "optional": false
      },
      {
        "name": "filteredRepeatInputs",
        "type": "Signal<Record<string, unknown>[]>",
        "description": "`repeatInputs` filtered per-item to declared component inputs.",
        "optional": false
      },
      {
        "name": "filteredResolvedInputs",
        "type": "Signal<Record<string, unknown>>",
        "description": "`resolvedInputs` filtered down to keys the target component actually\ndeclares — silences NG0303 dev-mode warnings from framework-only\ninputs (bindings/emit/loading/childKeys/spec) passed to simple view\ncomponents that don't declare them.",
        "optional": false
      },
      {
        "name": "host",
        "type": "RenderHost",
        "description": "Element-scoped host injected by mounted view components via\ninjectRenderHost(). `set` writes the store; `emit` routes element\nhandlers; `result` surfaces a RenderResultEvent for this element.",
        "optional": false
      },
      {
        "name": "mountClass",
        "type": "Signal<AngularComponentRenderer | null>",
        "description": "Picks fallback or real based on notReady. The mountedReal latch is\n driven by a constructor effect (not this computed) — Angular forbids\n signal writes inside computed.",
        "optional": false
      },
      {
        "name": "notReady",
        "type": "Signal<boolean>",
        "description": "True when the element is not yet ready to mount the real component.\n Delegates to `isElementReady` which checks:\n 1. Any undefined-valued resolved prop (state binding still loading).\n 2. A sync Standard-Schema gate if the registry entry declares a schema.\n Framework-injected keys (bindings, emit, loading, childKeys, spec) are\n excluded — only consumer-resolved props matter for readiness.",
        "optional": false
      },
      {
        "name": "parentInjector",
        "type": "Injector<>",
        "description": "",
        "optional": false
      },
      {
        "name": "repeatInjectors",
        "type": "Signal<DestroyableInjector<>[]>",
        "description": "One child Injector per repeat item, providing RepeatScope.",
        "optional": false
      },
      {
        "name": "repeatInputs",
        "type": "Signal<object[]>",
        "description": "Resolved inputs for each repeat item.",
        "optional": false
      },
      {
        "name": "resolvedInputs",
        "type": "Signal<object>",
        "description": "Resolved inputs for non-repeat elements.",
        "optional": false
      },
      {
        "name": "spec",
        "type": "InputSignal<Spec>",
        "description": "",
        "optional": false
      },
      {
        "name": "visible",
        "type": "Signal<boolean>",
        "description": "Whether the element is visible (non-repeat path).",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "ngOnInit",
        "signature": "ngOnInit(): void",
        "description": "A callback method that is invoked immediately after the\ndefault change detector has checked the directive's\ndata-bound properties for the first time,\nand before any of the view or content children have been checked.\nIt is invoked only once when the directive is instantiated.",
        "params": []
      }
    ]
  },
  {
    "name": "RenderSpecComponent",
    "kind": "class",
    "description": "Top-level entry point for rendering a json-render spec.\n\nAccepts the spec, registry, store, functions, handlers, and loading\nas inputs. Provides `RENDER_CONTEXT` to child `RenderElementComponent`\ninstances via `viewProviders`.\n\nFalls back to `RENDER_CONFIG` (from `provideRender()`) for registry\nand store defaults when inputs are not provided.",
    "params": [],
    "examples": [
      "```html\n<render-spec [spec]=\"spec()\" [registry]=\"registry\" [store]=\"store\" />\n```"
    ],
    "properties": [
      {
        "name": "_context",
        "type": "Signal<RenderContext>",
        "description": "The RenderContext provided to children via viewProviders.",
        "optional": false
      },
      {
        "name": "events",
        "type": "OutputEmitterRef<RenderEvent>",
        "description": "",
        "optional": false
      },
      {
        "name": "functions",
        "type": "InputSignal<Record<string, ComputedFunction> | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "handlers",
        "type": "InputSignal<Record<string, (params: Record<string, unknown>) => unknown> | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "loading",
        "type": "InputSignal<boolean>",
        "description": "",
        "optional": false
      },
      {
        "name": "registry",
        "type": "InputSignal<AngularRegistry | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "spec",
        "type": "InputSignal<Spec | null>",
        "description": "",
        "optional": false
      },
      {
        "name": "store",
        "type": "InputSignal<StateStore | undefined>",
        "description": "",
        "optional": false
      },
      {
        "name": "telemetry",
        "type": "InputSignal<boolean | undefined>",
        "description": "Disable automatic development collection for this render tree.",
        "optional": false
      }
    ],
    "methods": [
      {
        "name": "ngOnInit",
        "signature": "ngOnInit(): void",
        "description": "A callback method that is invoked immediately after the\ndefault change detector has checked the directive's\ndata-bound properties for the first time,\nand before any of the view or content children have been checked.\nIt is invoked only once when the directive is instantiated.",
        "params": []
      }
    ]
  },
  {
    "name": "AngularComponentInputs",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "bindings",
        "type": "Record<string, string>",
        "description": "Two-way binding paths: prop name → absolute state path",
        "optional": true
      },
      {
        "name": "childKeys",
        "type": "string[]",
        "description": "Child element keys for recursive rendering",
        "optional": false
      },
      {
        "name": "emit",
        "type": "(event: string) => void",
        "description": "Emit a named event",
        "optional": false
      },
      {
        "name": "loading",
        "type": "boolean",
        "description": "Whether the spec is currently streaming",
        "optional": true
      },
      {
        "name": "spec",
        "type": "Spec",
        "description": "The full spec (for child resolution)",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "AngularRegistry",
    "kind": "interface",
    "description": "",
    "properties": [],
    "methods": [
      {
        "name": "getEntry",
        "signature": "getEntry(name: string): NormalizedEntry | undefined",
        "description": "The full normalized entry for a registered name, or undefined. The single\naccessor — component, fallback, schema, and description all hang off it.",
        "params": [
          {
            "name": "name",
            "type": "string",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "names",
        "signature": "names(): string[]",
        "description": "",
        "params": []
      }
    ],
    "examples": []
  },
  {
    "name": "RenderConfig",
    "kind": "interface",
    "description": "Options for provideRender — the registry, state, computed functions,\nand action handlers the render engine uses to turn a spec into live Angular\ncomponents. Every field is optional.",
    "properties": [
      {
        "name": "functions",
        "type": "Record<string, ComputedFunction>",
        "description": "Named computed functions a spec can reference (e.g. via `$compute`) to derive values from state.",
        "optional": true
      },
      {
        "name": "handlers",
        "type": "Record<string, (params: Record<string, unknown>) => unknown>",
        "description": "Named action handlers invoked when interactive elements fire (e.g. a Button's `onClick`).",
        "optional": true
      },
      {
        "name": "registry",
        "type": "AngularRegistry",
        "description": "Component registry mapping spec element `type`s to Angular components.",
        "optional": true
      },
      {
        "name": "store",
        "type": "StateStore",
        "description": "Backing state store that `$bindState` paths read from and interactive elements write to.",
        "optional": true
      },
      {
        "name": "telemetry",
        "type": "boolean",
        "description": "Set false to disable automatic development browser collection for this render tree.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "RenderContext",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "emitEvent",
        "type": "(event: RenderEvent) => void",
        "description": "",
        "optional": true
      },
      {
        "name": "functions",
        "type": "Record<string, ComputedFunction>",
        "description": "",
        "optional": true
      },
      {
        "name": "handlers",
        "type": "Record<string, (params: Record<string, unknown>) => unknown>",
        "description": "",
        "optional": true
      },
      {
        "name": "loading",
        "type": "boolean",
        "description": "",
        "optional": true
      },
      {
        "name": "registry",
        "type": "AngularRegistry",
        "description": "",
        "optional": false
      },
      {
        "name": "store",
        "type": "StateStore",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "RenderHandlerEvent",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "action",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "params",
        "type": "Record<string, unknown>",
        "description": "",
        "optional": false
      },
      {
        "name": "result",
        "type": "unknown",
        "description": "",
        "optional": true
      },
      {
        "name": "type",
        "type": "\"handler\"",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "RenderHost",
    "kind": "interface",
    "description": "The element-scoped host a mounted view component talks back through.\nAgent-agnostic: `result(value)` just means \"this component produced a\nvalue\"; the render lib surfaces it as a RenderResultEvent and never\ninterprets it. Provided per-element by RenderElementComponent.",
    "properties": [],
    "methods": [
      {
        "name": "emit",
        "signature": "emit(event: string, payload: Record<string, unknown>): void",
        "description": "Fire a named event; routed to the element's `on[event]` handlers.",
        "params": [
          {
            "name": "event",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "payload",
            "type": "Record<string, unknown>",
            "description": "",
            "optional": true
          }
        ]
      },
      {
        "name": "result",
        "signature": "result(value: unknown): void",
        "description": "Announce this component's result value (e.g. a HITL submission).",
        "params": [
          {
            "name": "value",
            "type": "unknown",
            "description": "",
            "optional": false
          }
        ]
      },
      {
        "name": "set",
        "signature": "set(path: string, value: unknown): void",
        "description": "Write a value to the render state store at a JSON-Pointer path.",
        "params": [
          {
            "name": "path",
            "type": "string",
            "description": "",
            "optional": false
          },
          {
            "name": "value",
            "type": "unknown",
            "description": "",
            "optional": false
          }
        ]
      }
    ],
    "examples": []
  },
  {
    "name": "RenderLifecycle",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "firstMountAt",
        "type": "Signal<object | null>",
        "description": "First mount event in this render context. Sticky — does not reset.",
        "optional": false
      },
      {
        "name": "lastHandlerInvokedAt",
        "type": "Signal<object | null>",
        "description": "Most recent handler invocation.",
        "optional": false
      },
      {
        "name": "lastMountAt",
        "type": "Signal<number | null>",
        "description": "Epoch ms of the most recent mount event.",
        "optional": false
      },
      {
        "name": "lastStateChangeAt",
        "type": "Signal<number | null>",
        "description": "Epoch ms of the most recent state-change event.",
        "optional": false
      },
      {
        "name": "mountCount",
        "type": "Signal<number>",
        "description": "Total mount count since render context started.",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "RenderLifecycleEvent",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "elementKey",
        "type": "string",
        "description": "",
        "optional": true
      },
      {
        "name": "elementType",
        "type": "string",
        "description": "",
        "optional": true
      },
      {
        "name": "event",
        "type": "\"mounted\" | \"destroyed\"",
        "description": "",
        "optional": false
      },
      {
        "name": "scope",
        "type": "\"spec\" | \"element\"",
        "description": "",
        "optional": false
      },
      {
        "name": "type",
        "type": "\"lifecycle\"",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "RenderResultEvent",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "elementKey",
        "type": "string",
        "description": "",
        "optional": true
      },
      {
        "name": "type",
        "type": "\"result\"",
        "description": "",
        "optional": false
      },
      {
        "name": "value",
        "type": "unknown",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "RenderStateChangeEvent",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "path",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "snapshot",
        "type": "Record<string, unknown>",
        "description": "",
        "optional": false
      },
      {
        "name": "type",
        "type": "\"stateChange\"",
        "description": "",
        "optional": false
      },
      {
        "name": "value",
        "type": "unknown",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "RenderViewEntry",
    "kind": "interface",
    "description": "A view registry entry. Bare `Type` form is the legacy shape; the\nobject form lets consumers attach a per-component fallback that\nmounts while any state-bound prop on the element is still\nunresolved. The fallback is monotonic per element instance: once\nthe real component mounts, subsequent re-renders never revert to\nfallback even if a prop later resolves to undefined.",
    "properties": [
      {
        "name": "component",
        "type": "Type<unknown>",
        "description": "",
        "optional": false
      },
      {
        "name": "description",
        "type": "string",
        "description": "Optional human/model-facing description of what this component renders.",
        "optional": true
      },
      {
        "name": "fallback",
        "type": "Type<unknown>",
        "description": "",
        "optional": true
      },
      {
        "name": "schema",
        "type": "StandardSchemaV1<unknown, unknown>",
        "description": "Optional props contract for this component (Zod/Valibot/ArkType via\nStandard Schema). Enforced as a MOUNT-READINESS GATE: while a streaming\ntool call's props do not yet validate against this schema, the element's\nfallback is shown instead of the real component (sync validation only).\nConsumers (e.g. client-tools) also read it to advertise the component\nto a model and to validate incoming props.",
        "optional": true
      }
    ],
    "examples": []
  },
  {
    "name": "RepeatScope",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "basePath",
        "type": "string",
        "description": "",
        "optional": false
      },
      {
        "name": "index",
        "type": "number",
        "description": "",
        "optional": false
      },
      {
        "name": "item",
        "type": "unknown",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "StandardSchemaV1",
    "kind": "interface",
    "description": "",
    "properties": [
      {
        "name": "~standard",
        "type": "StandardSchemaProps<Input, Output>",
        "description": "",
        "optional": false
      }
    ],
    "examples": []
  },
  {
    "name": "AngularComponentRenderer",
    "kind": "type",
    "description": "",
    "signature": "Type<unknown>",
    "examples": []
  },
  {
    "name": "RenderEvent",
    "kind": "type",
    "description": "",
    "signature": "RenderHandlerEvent | RenderStateChangeEvent | RenderLifecycleEvent | RenderResultEvent",
    "examples": []
  },
  {
    "name": "StandardSchemaInferInput",
    "kind": "type",
    "description": "",
    "signature": "NonNullable<Schema[\"~standard\"][\"types\"]>[\"input\"]",
    "examples": []
  },
  {
    "name": "StandardSchemaInferOutput",
    "kind": "type",
    "description": "",
    "signature": "NonNullable<Schema[\"~standard\"][\"types\"]>[\"output\"]",
    "examples": []
  },
  {
    "name": "ViewRegistry",
    "kind": "type",
    "description": "A registry of view components available for generative UI rendering.\nEach entry is either a bare component Type (legacy shape) or a\n`RenderViewEntry` { component, fallback? }.",
    "signature": "Readonly<Record<string, Type<unknown> | RenderViewEntry>>",
    "examples": []
  },
  {
    "name": "RENDER_CONFIG",
    "kind": "const",
    "description": "",
    "signature": "InjectionToken<RenderConfig>",
    "examples": []
  },
  {
    "name": "RENDER_CONTEXT",
    "kind": "const",
    "description": "",
    "signature": "InjectionToken<RenderContext>",
    "examples": []
  },
  {
    "name": "RENDER_HOST",
    "kind": "const",
    "description": "",
    "signature": "InjectionToken<RenderHost>",
    "examples": []
  },
  {
    "name": "RENDER_LIFECYCLE",
    "kind": "const",
    "description": "",
    "signature": "InjectionToken<RenderLifecycle>",
    "examples": []
  },
  {
    "name": "REPEAT_SCOPE",
    "kind": "const",
    "description": "",
    "signature": "InjectionToken<RepeatScope>",
    "examples": []
  },
  {
    "name": "VIEW_REGISTRY",
    "kind": "const",
    "description": "",
    "signature": "InjectionToken<Readonly<Record<string, Type<unknown> | RenderViewEntry>>>",
    "examples": []
  },
  {
    "name": "defineAngularRegistry",
    "kind": "function",
    "description": "Build an AngularRegistry from a plain object mapping tool-call names\nto Angular components (or fully specified RenderViewEntry objects).\n\nThe returned registry is consumed by both `provideRender` (to drive\ndynamic component rendering) and `provideChat` (via `renderRegistry`) so\nthat a single `defineAngularRegistry` call wires both layers.\n\n**Entry forms**\n- Bare `Type<unknown>` — the component is paired with the built-in\n  `DefaultFallbackComponent` while its props are still streaming.\n- `RenderViewEntry` object — lets you supply a custom `fallback` component,\n  an optional Standard Schema (`schema`) used as a mount-readiness gate, and\n  an optional `description` for model-facing tool registration.\n\n**Registry accessor**\nThe returned object exposes a single `getEntry(name: string)` accessor that\nreturns the fully-normalized NormalizedEntry (component + fallback +\noptional schema + optional description) or `undefined` when the name is not\nregistered. Use `names()` to enumerate all registered names.",
    "signature": "defineAngularRegistry(componentMap: RegistryInput): AngularRegistry",
    "params": [
      {
        "name": "componentMap",
        "type": "RegistryInput",
        "description": "Object whose keys are tool-call names and whose values\n  are either bare Angular component classes or RenderViewEntry objects.",
        "optional": false
      }
    ],
    "returns": {
      "type": "AngularRegistry",
      "description": ""
    },
    "examples": [
      "```ts\nimport { defineAngularRegistry } from '@threadplane/render';\nimport { DayCardComponent } from './day-card.component';\nimport { LoadingSpinnerComponent } from './loading-spinner.component';\nimport { z } from 'zod';\n\nexport const registry = defineAngularRegistry({\n  // Bare component — uses DefaultFallbackComponent while streaming.\n  summary_card: SummaryCardComponent,\n\n  // Full entry — custom fallback + schema-gated mounting.\n  day_card: {\n    component: DayCardComponent,\n    fallback: LoadingSpinnerComponent,\n    schema: z.object({ label: z.string(), day: z.number() }),\n    description: 'Renders a single itinerary day card.',\n  },\n});\n\n// Look up a registered entry at runtime:\nconst entry = registry.getEntry('day_card'); // NormalizedEntry | undefined\n```"
    ]
  },
  {
    "name": "injectRenderHost",
    "kind": "function",
    "description": "Obtain the element-scoped RenderHost from inside a mounted view\ncomponent — use it to write state, emit events, or announce a result back to\nthe render engine.",
    "signature": "injectRenderHost(): RenderHost",
    "params": [],
    "returns": {
      "type": "RenderHost",
      "description": ""
    },
    "examples": [
      "```ts\n\\@Component({ ... })\nclass ApproveButton {\n  private host = injectRenderHost();\n  approve() { this.host.result('approved'); }\n}\n```"
    ]
  },
  {
    "name": "overrideViews",
    "kind": "function",
    "description": "Replaces views in a registry. Keys in `overrides` win over `base`.\nUse this to swap an existing renderer; use `withViews` to add NEW\nnode types without touching existing entries.",
    "signature": "overrideViews(base: ViewRegistry, overrides: Record<string, Type<unknown> | RenderViewEntry>): ViewRegistry",
    "params": [
      {
        "name": "base",
        "type": "ViewRegistry",
        "description": "",
        "optional": false
      },
      {
        "name": "overrides",
        "type": "Record<string, Type<unknown> | RenderViewEntry>",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "ViewRegistry",
      "description": ""
    },
    "examples": [
      "```ts\nconst themed = overrideViews(a2uiBasicCatalog(), { Card: MyCardComponent });\n```"
    ]
  },
  {
    "name": "provideRender",
    "kind": "function",
    "description": "Bootstrap `@threadplane/render` in an Angular application or standalone\ncomponent tree.\n\nRegisters the shared RenderConfig token and the internal\n`RenderLifecycleService` that coordinates mount/unmount events across\ndynamically rendered components. Call this once alongside `provideChat` in\n`bootstrapApplication` (or the root `ApplicationConfig`).",
    "signature": "provideRender(config: RenderConfig): EnvironmentProviders",
    "params": [
      {
        "name": "config",
        "type": "RenderConfig",
        "description": "Options bag that controls the render feature set:\n  - `registry` — component registry returned by defineAngularRegistry;\n    maps tool-call names to Angular components.\n  - `store` — optional `StateStore` for `\\@json-render/core` state binding.\n  - `functions` — optional map of computed functions available inside specs.\n  - `handlers` — optional map of event handlers triggered by spec actions.",
        "optional": false
      }
    ],
    "returns": {
      "type": "EnvironmentProviders",
      "description": ""
    },
    "examples": [
      "```ts\n// main.ts\nimport { bootstrapApplication } from '@angular/platform-browser';\nimport { defineAngularRegistry, provideRender } from '@threadplane/render';\nimport { provideChat } from '@threadplane/chat';\nimport { DayCardComponent } from './day-card.component';\n\nconst registry = defineAngularRegistry({ day_card: DayCardComponent });\n\nbootstrapApplication(AppComponent, {\n  providers: [\n    provideRender({ registry }),\n    provideChat({ renderRegistry: registry }),\n  ],\n});\n```"
    ]
  },
  {
    "name": "provideViews",
    "kind": "function",
    "description": "Register a ViewRegistry for the render engine so generative-UI specs\ncan resolve element `type`s to Angular components. Provide at the application\n(or a feature route's) environment injector.",
    "signature": "provideViews(registry: ViewRegistry): EnvironmentProviders",
    "params": [
      {
        "name": "registry",
        "type": "ViewRegistry",
        "description": "Map of spec element types to the components that render them,\n  typically built with `views()` / `withViews()`.",
        "optional": false
      }
    ],
    "returns": {
      "type": "EnvironmentProviders",
      "description": ""
    },
    "examples": [
      "```ts\nbootstrapApplication(App, {\n  providers: [provideViews(views({ metric: MetricCardComponent }))],\n});\n```"
    ]
  },
  {
    "name": "signalStateStore",
    "kind": "function",
    "description": "Create a signal-backed StateStore for a generative-UI surface —\nholds the bound state that spec `$bindState` paths read and interactive\nelements write, with path-addressable get/set and change subscriptions.",
    "signature": "signalStateStore(initialState: StateModel): StateStore",
    "params": [
      {
        "name": "initialState",
        "type": "StateModel",
        "description": "Optional starting state object.",
        "optional": true
      }
    ],
    "returns": {
      "type": "StateStore",
      "description": ""
    },
    "examples": [
      "```ts\nconst store = signalStateStore({ count: 0 });\nstore.set('count', 1);\n```"
    ]
  },
  {
    "name": "toRenderRegistry",
    "kind": "function",
    "description": "Converts a ViewRegistry to an AngularRegistry for use with RenderSpecComponent.",
    "signature": "toRenderRegistry(registry: ViewRegistry): AngularRegistry",
    "params": [
      {
        "name": "registry",
        "type": "ViewRegistry",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "AngularRegistry",
      "description": ""
    },
    "examples": [
      "```ts\nconst registry = toRenderRegistry(views({ metric: MetricCardComponent }));\n```"
    ]
  },
  {
    "name": "views",
    "kind": "function",
    "description": "Creates a view registry from a name → component map.",
    "signature": "views(map: Record<string, Type<unknown> | RenderViewEntry>): ViewRegistry",
    "params": [
      {
        "name": "map",
        "type": "Record<string, Type<unknown> | RenderViewEntry>",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "ViewRegistry",
      "description": ""
    },
    "examples": [
      "```ts\nconst registry = views({ metric: MetricCardComponent, chart: ChartComponent });\n// providers: [provideViews(registry)]\n```"
    ]
  },
  {
    "name": "withoutViews",
    "kind": "function",
    "description": "Removes views from a registry by name.",
    "signature": "withoutViews(base: ViewRegistry, ...names: string[]): ViewRegistry",
    "params": [
      {
        "name": "base",
        "type": "ViewRegistry",
        "description": "",
        "optional": false
      },
      {
        "name": "...names",
        "type": "string[]",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "ViewRegistry",
      "description": ""
    },
    "examples": [
      "```ts\nconst trimmed = withoutViews(a2uiBasicCatalog(), 'Video', 'AudioPlayer');\n```"
    ]
  },
  {
    "name": "withViews",
    "kind": "function",
    "description": "Adds views to a registry without overwriting existing entries.\nNew keys are added; keys that already exist in `base` are preserved.",
    "signature": "withViews(base: ViewRegistry, additions: Record<string, Type<unknown> | RenderViewEntry>): ViewRegistry",
    "params": [
      {
        "name": "base",
        "type": "ViewRegistry",
        "description": "",
        "optional": false
      },
      {
        "name": "additions",
        "type": "Record<string, Type<unknown> | RenderViewEntry>",
        "description": "",
        "optional": false
      }
    ],
    "returns": {
      "type": "ViewRegistry",
      "description": ""
    },
    "examples": [
      "```ts\nconst extended = withViews(a2uiBasicCatalog(), { MyWidget: MyWidgetComponent });\n```"
    ]
  }
]

---

## Prompt Recipes

## Prompt: configuration

Configure angular globally and per-component in my Angular application.

Global config:
In app.config.ts, call provideAgent({ apiUrl: 'https://my-langgraph-server.com', assistantId: 'my-agent' }) in the providers array. Import provideAgent from '@threadplane/langgraph'.

Scoped override for one component subtree:
Add providers: [provideAgent({ apiUrl: 'https://other-server.com', assistantId: 'other-agent' })] on that component. Components under that subtree call injectAgent() and receive the scoped singleton.

Custom transport (for auth headers, logging, or testing):
Implement the AgentTransport interface from @threadplane/langgraph. Its required method is stream(assistantId, threadId, payload, signal, options), and optional methods cover queued runs, cancellation, history, and updateState. Pass an AgentTransport instance as transport: myTransport to provideAgent(). FetchStreamTransport is the default.

To pass per-run LangGraph config, pass it when submitting:
chat.submit({ message }, { config: { configurable: { system_prompt: 'You are a helpful assistant.' } } })

---

## Prompt: getting-started

Add angular to my Angular 20–22 application.

Install: npm install @threadplane/chat @threadplane/langgraph @langchain/core @langchain/langgraph-sdk marked

1. In app.config.ts, add provideAgent({ apiUrl: 'http://localhost:2024', assistantId: 'chat' }) to the providers array. Import it from '@threadplane/langgraph'.

2. Create a component that imports ChatComponent from '@threadplane/chat' and calls injectAgent() in the constructor or as a field initializer. injectAgent() MUST be called inside an Angular injection context — constructor or field initializer is correct; ngOnInit is not.

3. The component template can start with <chat [agent]="chat" />. For custom layouts, loop over chat.messages() with @for and call chat.submit({ message: inputValue }) from your input.

4. In app.config.ts provideAgent call, the apiUrl should point to the LangGraph server. For local dev this is http://localhost:2024. For production use the LangGraph Platform URL from environment.ts.

The library is framework-integrated: no subscriptions, no async pipe needed — chat.messages() is an Angular Signal that updates token by token as the LLM responds.

---

## Prompt: streaming

Configure token-by-token streaming in my Angular component that uses angular.

The component already has injectAgent() set up from a configured provideAgent() provider. Now:

1. In the template, bind to chat.messages() with @for — each runtime-neutral Message has role and content fields. The template re-renders automatically as tokens arrive because messages() is a Signal.

2. Show a loading indicator while streaming: use chat.isLoading() in an @if block.

3. To throttle rapid re-renders (if performance is a concern), pass throttle: 50 to provideAgent() config — this throttles Signal updates to at most one per 50ms while preserving the final value.

4. To show the stream status more precisely, bind to chat.status() which returns 'idle' | 'running' | 'error'. Use chat.isLoading() for loading UI.

Do not use async pipe or subscribe() — the signals update automatically.

---

## Prompt: testing

Write unit tests for my Angular component that uses angular, without hitting a real LangGraph server.

Use MockAgentTransport from '@threadplane/langgraph'. It implements AgentTransport and lets you script exactly what events the stream emits.

Test setup:
const transport = new MockAgentTransport();
providers: [provideAgent({ transport, assistantId: 'test', apiUrl: '' })]
const chat = injectAgent();

In Angular tests, put the provider in TestBed.configureTestingModule({ providers: [...] }) or the component's providers array, then read chat with injectAgent() from an Angular injection context.

To emit a streaming response:
transport.emit([
  { type: 'values', values: { messages: [] } },
  { type: 'messages', messages: [[{ type: 'ai', content: 'Hello' }, { id: '1' }]] },
]);

Assertions after emit:
expect(chat.messages()).toHaveLength(1);
expect(chat.messages()[0].content).toBe('Hello');

To test error state:
transport.emitError(new Error('Network failure'));
expect(chat.status()).toBe('error');
expect(chat.error()).toBeInstanceOf(Error);

Never mock injectAgent() itself — always use MockAgentTransport and test through the real provider.

---

## Prompt: thread-persistence

Add thread persistence to my Angular component that uses angular, so conversations survive page refresh.

1. Put thread persistence in an injectable service so provider config can read it from Angular DI.

2. In that service, create a signal from storage: threadId = signal<string | null>(localStorage.getItem('chat-thread-id')).

3. Configure the agent with a provider factory: provideAgent(() => { const memory = inject(ThreadMemory); return { assistantId: 'chat', threadId: memory.threadId, onThreadId: (id) => memory.remember(id) }; }).

4. The onThreadId callback fires once when the server creates a new thread. After that, the same thread ID is reused and the full conversation history is restored from the LangGraph server.

5. To start a new conversation, call memory.threadId.set(null) and clear storage — this causes the injected agent to create a fresh thread on the next submit.

No changes to the template are needed.

---

## Common Gotchas

injectAgent() MUST be called inside an Angular injection context.
Do not call it in ngOnInit — use constructor or field initializer.
Do not mock injectAgent() in tests — use MockAgentTransport via provideAgent({ transport: new MockAgentTransport(...) }).
RxJS is an internal implementation detail — do not import rxjs in consumer code.