/*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 */

// Generated from Rust runtime schemas. Run npm run schema:generate -w @maka-agent/plugin-sdk.
import type { Contract } from './generated/runtime.js';

export const contracts = {
  markdown: {
    name: 'maka.ui.Markdown',
    version: 1,
    transport: 'local',
    interface: {
      kind: 'component',
      props: {
        $schema: 'https://json-schema.org/draft/2020-12/schema',
        title: 'MarkdownProps',
        type: 'object',
        properties: {
          ascii: {
            type: 'boolean',
            default: false,
          },
          animate: {
            type: 'boolean',
            default: false,
          },
          source: {
            type: 'string',
          },
          appearance: {
            $ref: '#/$defs/MarkdownAppearance',
          },
          selectable: {
            type: 'boolean',
          },
          disabled: {
            type: 'boolean',
          },
          focusOnPointer: {
            description: 'Whether pointer selection also moves keyboard focus to this document.',
            type: 'boolean',
            default: true,
          },
          openWebLinks: {
            description: 'The committed document decides native URL opening before guest work.',
            type: 'boolean',
            default: true,
          },
          bubbleLinks: {
            type: 'boolean',
            default: true,
          },
        },
        additionalProperties: false,
        required: ['source', 'appearance', 'selectable', 'disabled'],
        $defs: {
          MarkdownAppearance: {
            type: 'object',
            properties: {
              terminal: {
                anyOf: [
                  {
                    $ref: '#/$defs/TerminalPalette',
                  },
                  {
                    type: 'null',
                  },
                ],
                default: null,
              },
              body: {
                $ref: '#/$defs/TextAppearance',
              },
              code: {
                $ref: '#/$defs/TextAppearance',
              },
              headings: {
                description: 'Typography for heading levels 1 through 6, in source order.',
                type: 'array',
                items: {
                  $ref: '#/$defs/TextAppearance',
                },
                minItems: 6,
                maxItems: 6,
              },
              muted: {
                $ref: '#/$defs/Color',
              },
              link: {
                $ref: '#/$defs/Color',
              },
              selection: {
                $ref: '#/$defs/Color',
              },
              codeBackground: {
                $ref: '#/$defs/Color',
              },
              tableBackground: {
                $ref: '#/$defs/Color',
              },
              border: {
                $ref: '#/$defs/Color',
              },
              dark: {
                type: 'boolean',
              },
              paragraphGap: {
                description: 'Paragraph spacing in logical pixels.',
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 128,
              },
            },
            additionalProperties: false,
            required: [
              'body',
              'code',
              'headings',
              'muted',
              'link',
              'selection',
              'codeBackground',
              'tableBackground',
              'border',
              'dark',
              'paragraphGap',
            ],
          },
          TerminalPalette: {
            description:
              'Semantic terminal colors for rich text and editors, supplied by the product.',
            type: 'object',
            properties: {
              background: {
                $ref: '#/$defs/TerminalColor',
              },
              foreground: {
                $ref: '#/$defs/TerminalColor',
              },
              surface: {
                $ref: '#/$defs/TerminalColor',
              },
              accent: {
                $ref: '#/$defs/TerminalColor',
              },
              thinking: {
                $ref: '#/$defs/TerminalColor',
              },
              success: {
                $ref: '#/$defs/TerminalColor',
              },
              warning: {
                $ref: '#/$defs/TerminalColor',
              },
              error: {
                $ref: '#/$defs/TerminalColor',
              },
              muted: {
                $ref: '#/$defs/TerminalColor',
              },
              subtle: {
                $ref: '#/$defs/TerminalColor',
              },
              border: {
                $ref: '#/$defs/TerminalColor',
              },
              scrollbar: {
                $ref: '#/$defs/TerminalColor',
              },
              selection: {
                $ref: '#/$defs/TerminalColor',
              },
              selectionText: {
                $ref: '#/$defs/TerminalColor',
              },
              search: {
                $ref: '#/$defs/TerminalColor',
              },
              searchActive: {
                $ref: '#/$defs/TerminalColor',
              },
              searchText: {
                $ref: '#/$defs/TerminalColor',
              },
              syntax: {
                type: 'array',
                items: {
                  $ref: '#/$defs/TerminalColor',
                },
                minItems: 7,
                maxItems: 7,
              },
              terminal: {
                type: 'boolean',
              },
            },
            additionalProperties: false,
            required: [
              'background',
              'foreground',
              'surface',
              'accent',
              'thinking',
              'success',
              'warning',
              'error',
              'muted',
              'subtle',
              'border',
              'scrollbar',
              'selection',
              'selectionText',
              'search',
              'searchActive',
              'searchText',
              'syntax',
              'terminal',
            ],
          },
          TerminalColor: {
            description:
              "Terminal colors retain the user's ANSI palette and default background.\nNumeric values are RGB; named values are emitted as terminal attributes.",
            anyOf: [
              {
                type: 'integer',
                format: 'uint32',
                minimum: 0,
                maximum: 16777215,
              },
              {
                $ref: '#/$defs/TerminalNamedColor',
              },
            ],
          },
          TerminalNamedColor: {
            type: 'string',
            enum: [
              'reset',
              'black',
              'red',
              'green',
              'yellow',
              'blue',
              'magenta',
              'cyan',
              'gray',
              'dark_gray',
              'light_red',
              'light_green',
              'light_yellow',
              'light_blue',
              'light_magenta',
              'light_cyan',
              'white',
            ],
          },
          TextAppearance: {
            type: 'object',
            properties: {
              font: {
                $ref: '#/$defs/FontAppearance',
              },
              foreground: {
                $ref: '#/$defs/Color',
              },
            },
            additionalProperties: false,
            required: ['font', 'foreground'],
          },
          FontAppearance: {
            type: 'object',
            properties: {
              family: {
                $ref: '#/$defs/FontFamily',
              },
              fallbacks: {
                type: 'array',
                items: {
                  $ref: '#/$defs/FontFamily',
                },
              },
              size: {
                type: 'number',
                format: 'float',
                minimum: 6,
                maximum: 96,
              },
              lineHeight: {
                description: 'Line height relative to this font size.',
                type: 'number',
                format: 'float',
                minimum: 1,
                maximum: 3,
              },
              weight: {
                type: 'integer',
                format: 'uint16',
                minimum: 1,
                maximum: 1000,
              },
            },
            additionalProperties: false,
            required: ['family', 'fallbacks', 'size', 'lineHeight', 'weight'],
          },
          FontFamily: {
            type: 'string',
            minLength: 1,
          },
          Color: {
            description: 'Packed RGBA, including explicit alpha zero.',
            type: 'integer',
            format: 'uint32',
            minimum: 0,
          },
        },
      },
      events: {
        link: {
          $schema: 'https://json-schema.org/draft/2020-12/schema',
          title: 'MarkdownLink',
          type: 'object',
          properties: {
            url: {
              type: 'string',
            },
          },
          additionalProperties: false,
          required: ['url'],
        },
      },
      captures: {},
    },
  },
  markdownText: {
    name: 'maka.text.Markdown',
    version: 1,
    transport: 'local',
    interface: {
      kind: 'service',
      methods: {
        plain: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'MarkdownTextInput',
            description:
              "Complete source-to-readable-text conversion using the presenter's Markdown semantics.",
            type: 'object',
            properties: {
              source: {
                type: 'string',
              },
            },
            additionalProperties: false,
            required: ['source'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'MarkdownTextResult',
            oneOf: [
              {
                type: 'object',
                properties: {
                  text: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'ready',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'text'],
              },
            ],
          },
          resources: {},
        },
      },
    },
  },
  diff: {
    name: 'maka.ui.Diff',
    version: 1,
    transport: 'local',
    interface: {
      kind: 'component',
      props: {
        $schema: 'https://json-schema.org/draft/2020-12/schema',
        title: 'DiffProps',
        type: 'object',
        properties: {
          content: {
            $ref: '#/$defs/DiffContent',
          },
          appearance: {
            $ref: '#/$defs/DiffAppearance',
          },
          ascii: {
            type: 'boolean',
          },
          disabled: {
            type: 'boolean',
          },
          focusOnPointer: {
            type: 'boolean',
          },
        },
        additionalProperties: false,
        required: ['content', 'appearance', 'ascii', 'disabled', 'focusOnPointer'],
        $defs: {
          DiffContent: {
            description: 'Complete comparisons and structured patches reuse native parsers.',
            oneOf: [
              {
                type: 'object',
                properties: {
                  source: {
                    type: 'string',
                  },
                  rows: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/DiffRow',
                    },
                  },
                  kind: {
                    type: 'string',
                    const: 'annotated',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'source', 'rows'],
              },
              {
                description: 'Comparisons use complete UTF-8 text without NUL.',
                type: 'object',
                properties: {
                  before: {
                    type: 'string',
                  },
                  after: {
                    type: 'string',
                  },
                  language: {
                    type: ['string', 'null'],
                  },
                  kind: {
                    type: 'string',
                    const: 'comparison',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'before', 'after'],
              },
              {
                description:
                  'Invalid, binary or oversized patches display literally, without diff gutters.',
                type: 'object',
                properties: {
                  source: {
                    type: 'string',
                  },
                  operation: {
                    $ref: '#/$defs/DiffPatch',
                  },
                  language: {
                    type: ['string', 'null'],
                  },
                  kind: {
                    type: 'string',
                    const: 'patch',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'source', 'operation'],
              },
            ],
          },
          DiffRow: {
            type: 'object',
            properties: {
              start: {
                description: 'Half-open UTF-8 byte range in source. Rows are ordered and disjoint.',
                type: 'integer',
                format: 'uint32',
                minimum: 0,
              },
              end: {
                type: 'integer',
                format: 'uint32',
                minimum: 0,
              },
              kind: {
                $ref: '#/$defs/DiffKind',
              },
              language: {
                type: ['string', 'null'],
              },
            },
            additionalProperties: false,
            required: ['start', 'end', 'kind'],
          },
          DiffKind: {
            type: 'string',
            enum: ['removed', 'added', 'context', 'content'],
          },
          DiffPatch: {
            type: 'string',
            enum: ['create', 'update'],
          },
          DiffAppearance: {
            type: 'object',
            properties: {
              terminal: {
                anyOf: [
                  {
                    $ref: '#/$defs/TerminalPalette',
                  },
                  {
                    type: 'null',
                  },
                ],
                default: null,
              },
              text: {
                $ref: '#/$defs/TextAppearance',
              },
              background: {
                $ref: '#/$defs/Color',
              },
              added: {
                $ref: '#/$defs/Color',
              },
              removed: {
                $ref: '#/$defs/Color',
              },
              selection: {
                $ref: '#/$defs/Color',
              },
              dark: {
                type: 'boolean',
              },
            },
            additionalProperties: false,
            required: ['text', 'background', 'added', 'removed', 'selection', 'dark'],
          },
          TerminalPalette: {
            description:
              'Semantic terminal colors for rich text and editors, supplied by the product.',
            type: 'object',
            properties: {
              background: {
                $ref: '#/$defs/TerminalColor',
              },
              foreground: {
                $ref: '#/$defs/TerminalColor',
              },
              surface: {
                $ref: '#/$defs/TerminalColor',
              },
              accent: {
                $ref: '#/$defs/TerminalColor',
              },
              thinking: {
                $ref: '#/$defs/TerminalColor',
              },
              success: {
                $ref: '#/$defs/TerminalColor',
              },
              warning: {
                $ref: '#/$defs/TerminalColor',
              },
              error: {
                $ref: '#/$defs/TerminalColor',
              },
              muted: {
                $ref: '#/$defs/TerminalColor',
              },
              subtle: {
                $ref: '#/$defs/TerminalColor',
              },
              border: {
                $ref: '#/$defs/TerminalColor',
              },
              scrollbar: {
                $ref: '#/$defs/TerminalColor',
              },
              selection: {
                $ref: '#/$defs/TerminalColor',
              },
              selectionText: {
                $ref: '#/$defs/TerminalColor',
              },
              search: {
                $ref: '#/$defs/TerminalColor',
              },
              searchActive: {
                $ref: '#/$defs/TerminalColor',
              },
              searchText: {
                $ref: '#/$defs/TerminalColor',
              },
              syntax: {
                type: 'array',
                items: {
                  $ref: '#/$defs/TerminalColor',
                },
                minItems: 7,
                maxItems: 7,
              },
              terminal: {
                type: 'boolean',
              },
            },
            additionalProperties: false,
            required: [
              'background',
              'foreground',
              'surface',
              'accent',
              'thinking',
              'success',
              'warning',
              'error',
              'muted',
              'subtle',
              'border',
              'scrollbar',
              'selection',
              'selectionText',
              'search',
              'searchActive',
              'searchText',
              'syntax',
              'terminal',
            ],
          },
          TerminalColor: {
            description:
              "Terminal colors retain the user's ANSI palette and default background.\nNumeric values are RGB; named values are emitted as terminal attributes.",
            anyOf: [
              {
                type: 'integer',
                format: 'uint32',
                minimum: 0,
                maximum: 16777215,
              },
              {
                $ref: '#/$defs/TerminalNamedColor',
              },
            ],
          },
          TerminalNamedColor: {
            type: 'string',
            enum: [
              'reset',
              'black',
              'red',
              'green',
              'yellow',
              'blue',
              'magenta',
              'cyan',
              'gray',
              'dark_gray',
              'light_red',
              'light_green',
              'light_yellow',
              'light_blue',
              'light_magenta',
              'light_cyan',
              'white',
            ],
          },
          TextAppearance: {
            type: 'object',
            properties: {
              font: {
                $ref: '#/$defs/FontAppearance',
              },
              foreground: {
                $ref: '#/$defs/Color',
              },
            },
            additionalProperties: false,
            required: ['font', 'foreground'],
          },
          FontAppearance: {
            type: 'object',
            properties: {
              family: {
                $ref: '#/$defs/FontFamily',
              },
              fallbacks: {
                type: 'array',
                items: {
                  $ref: '#/$defs/FontFamily',
                },
              },
              size: {
                type: 'number',
                format: 'float',
                minimum: 6,
                maximum: 96,
              },
              lineHeight: {
                description: 'Line height relative to this font size.',
                type: 'number',
                format: 'float',
                minimum: 1,
                maximum: 3,
              },
              weight: {
                type: 'integer',
                format: 'uint16',
                minimum: 1,
                maximum: 1000,
              },
            },
            additionalProperties: false,
            required: ['family', 'fallbacks', 'size', 'lineHeight', 'weight'],
          },
          FontFamily: {
            type: 'string',
            minLength: 1,
          },
          Color: {
            description: 'Packed RGBA, including explicit alpha zero.',
            type: 'integer',
            format: 'uint32',
            minimum: 0,
          },
        },
      },
      events: {},
      captures: {},
    },
  },
  filePicker: {
    name: 'maka.ui.FilePicker',
    version: 1,
    transport: 'local',
    interface: {
      kind: 'component',
      props: {
        $schema: 'https://json-schema.org/draft/2020-12/schema',
        title: 'FilePickerProps',
        type: 'object',
        properties: {
          appearance: {
            $ref: '#/$defs/InputAppearance',
          },
          label: {
            type: 'string',
            minLength: 1,
          },
          pathLabel: {
            type: 'string',
            minLength: 1,
          },
          browseLabel: {
            type: 'string',
            minLength: 1,
          },
          parentLabel: {
            type: 'string',
            minLength: 1,
          },
          emptyLabel: {
            type: 'string',
            minLength: 1,
          },
          truncatedLabel: {
            type: 'string',
            minLength: 1,
          },
          placeholder: {
            type: 'string',
          },
          disabled: {
            type: 'boolean',
          },
          tabIndex: {
            type: 'integer',
            format: 'int16',
            minimum: -1,
            maximum: 32767,
          },
        },
        additionalProperties: false,
        required: [
          'appearance',
          'label',
          'pathLabel',
          'browseLabel',
          'parentLabel',
          'emptyLabel',
          'truncatedLabel',
          'placeholder',
          'disabled',
          'tabIndex',
        ],
        $defs: {
          InputAppearance: {
            type: 'object',
            properties: {
              ascii: {
                type: 'boolean',
                default: false,
              },
              terminal: {
                anyOf: [
                  {
                    $ref: '#/$defs/TerminalPalette',
                  },
                  {
                    type: 'null',
                  },
                ],
                default: null,
              },
              text: {
                $ref: '#/$defs/TextAppearance',
              },
              mutedForeground: {
                $ref: '#/$defs/Color',
              },
              background: {
                $ref: '#/$defs/Color',
              },
              selection: {
                $ref: '#/$defs/Color',
              },
              caret: {
                $ref: '#/$defs/Color',
              },
              border: {
                $ref: '#/$defs/Color',
              },
              focusedBorder: {
                $ref: '#/$defs/Color',
              },
              borderWidth: {
                description:
                  'In TUI inputs, a positive width draws a one-cell border; zero has no inset.',
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 8,
              },
              radius: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 64,
              },
              padding: {
                $ref: '#/$defs/Insets',
              },
            },
            additionalProperties: false,
            required: [
              'text',
              'mutedForeground',
              'background',
              'selection',
              'caret',
              'border',
              'focusedBorder',
              'borderWidth',
              'radius',
              'padding',
            ],
          },
          TerminalPalette: {
            description:
              'Semantic terminal colors for rich text and editors, supplied by the product.',
            type: 'object',
            properties: {
              background: {
                $ref: '#/$defs/TerminalColor',
              },
              foreground: {
                $ref: '#/$defs/TerminalColor',
              },
              surface: {
                $ref: '#/$defs/TerminalColor',
              },
              accent: {
                $ref: '#/$defs/TerminalColor',
              },
              thinking: {
                $ref: '#/$defs/TerminalColor',
              },
              success: {
                $ref: '#/$defs/TerminalColor',
              },
              warning: {
                $ref: '#/$defs/TerminalColor',
              },
              error: {
                $ref: '#/$defs/TerminalColor',
              },
              muted: {
                $ref: '#/$defs/TerminalColor',
              },
              subtle: {
                $ref: '#/$defs/TerminalColor',
              },
              border: {
                $ref: '#/$defs/TerminalColor',
              },
              scrollbar: {
                $ref: '#/$defs/TerminalColor',
              },
              selection: {
                $ref: '#/$defs/TerminalColor',
              },
              selectionText: {
                $ref: '#/$defs/TerminalColor',
              },
              search: {
                $ref: '#/$defs/TerminalColor',
              },
              searchActive: {
                $ref: '#/$defs/TerminalColor',
              },
              searchText: {
                $ref: '#/$defs/TerminalColor',
              },
              syntax: {
                type: 'array',
                items: {
                  $ref: '#/$defs/TerminalColor',
                },
                minItems: 7,
                maxItems: 7,
              },
              terminal: {
                type: 'boolean',
              },
            },
            additionalProperties: false,
            required: [
              'background',
              'foreground',
              'surface',
              'accent',
              'thinking',
              'success',
              'warning',
              'error',
              'muted',
              'subtle',
              'border',
              'scrollbar',
              'selection',
              'selectionText',
              'search',
              'searchActive',
              'searchText',
              'syntax',
              'terminal',
            ],
          },
          TerminalColor: {
            description:
              "Terminal colors retain the user's ANSI palette and default background.\nNumeric values are RGB; named values are emitted as terminal attributes.",
            anyOf: [
              {
                type: 'integer',
                format: 'uint32',
                minimum: 0,
                maximum: 16777215,
              },
              {
                $ref: '#/$defs/TerminalNamedColor',
              },
            ],
          },
          TerminalNamedColor: {
            type: 'string',
            enum: [
              'reset',
              'black',
              'red',
              'green',
              'yellow',
              'blue',
              'magenta',
              'cyan',
              'gray',
              'dark_gray',
              'light_red',
              'light_green',
              'light_yellow',
              'light_blue',
              'light_magenta',
              'light_cyan',
              'white',
            ],
          },
          TextAppearance: {
            type: 'object',
            properties: {
              font: {
                $ref: '#/$defs/FontAppearance',
              },
              foreground: {
                $ref: '#/$defs/Color',
              },
            },
            additionalProperties: false,
            required: ['font', 'foreground'],
          },
          FontAppearance: {
            type: 'object',
            properties: {
              family: {
                $ref: '#/$defs/FontFamily',
              },
              fallbacks: {
                type: 'array',
                items: {
                  $ref: '#/$defs/FontFamily',
                },
              },
              size: {
                type: 'number',
                format: 'float',
                minimum: 6,
                maximum: 96,
              },
              lineHeight: {
                description: 'Line height relative to this font size.',
                type: 'number',
                format: 'float',
                minimum: 1,
                maximum: 3,
              },
              weight: {
                type: 'integer',
                format: 'uint16',
                minimum: 1,
                maximum: 1000,
              },
            },
            additionalProperties: false,
            required: ['family', 'fallbacks', 'size', 'lineHeight', 'weight'],
          },
          FontFamily: {
            type: 'string',
            minLength: 1,
          },
          Color: {
            description: 'Packed RGBA, including explicit alpha zero.',
            type: 'integer',
            format: 'uint32',
            minimum: 0,
          },
          Insets: {
            type: 'object',
            properties: {
              top: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 128,
              },
              right: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 128,
              },
              bottom: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 128,
              },
              left: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 128,
              },
            },
            additionalProperties: false,
            required: ['top', 'right', 'bottom', 'left'],
          },
        },
      },
      events: {
        changed: {
          $schema: 'https://json-schema.org/draft/2020-12/schema',
          title: 'FileObservation',
          type: 'object',
          properties: {
            owner: {
              type: 'string',
              minLength: 1,
            },
            revision: {
              type: 'integer',
              format: 'uint64',
              minimum: 0,
            },
            phase: {
              $ref: '#/$defs/FilePhase',
            },
            file: {
              anyOf: [
                {
                  $ref: '#/$defs/FileDescriptor',
                },
                {
                  type: 'null',
                },
              ],
            },
            error: {
              anyOf: [
                {
                  $ref: '#/$defs/FileError',
                },
                {
                  type: 'null',
                },
              ],
            },
          },
          additionalProperties: false,
          required: ['owner', 'revision', 'phase'],
          $defs: {
            FilePhase: {
              type: 'string',
              enum: ['empty', 'choosing', 'ready', 'failed'],
            },
            FileDescriptor: {
              type: 'object',
              properties: {
                name: {
                  type: 'string',
                },
                bytes: {
                  type: 'integer',
                  format: 'uint',
                  minimum: 0,
                },
                digest: {
                  type: 'string',
                  minLength: 71,
                  maxLength: 71,
                },
              },
              additionalProperties: false,
              required: ['name', 'bytes', 'digest'],
            },
            FileError: {
              type: 'string',
              enum: [
                'invalid_file',
                'read_failed',
                'limit_exceeded',
                'budget_exhausted',
                'worker_failed',
                'clipboard_unavailable',
                'paste_rejected',
              ],
            },
          },
        },
      },
      captures: {
        snapshot: {
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'FileCapture',
            type: 'object',
            properties: {
              owner: {
                type: 'string',
                minLength: 1,
              },
              revision: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
            },
            additionalProperties: false,
            required: ['owner', 'revision'],
          },
          output: {
            kind: 'resource',
            resource: {
              name: 'maka.bytes',
              version: 1,
            },
          },
        },
      },
    },
  },
  sourceText: {
    name: 'maka.ui.SourceText',
    version: 1,
    transport: 'local',
    interface: {
      kind: 'component',
      props: {
        $schema: 'https://json-schema.org/draft/2020-12/schema',
        title: 'SourceTextProps',
        type: 'object',
        properties: {
          animate: {
            type: 'boolean',
            default: false,
          },
          terminal: {
            anyOf: [
              {
                $ref: '#/$defs/TerminalPalette',
              },
              {
                type: 'null',
              },
            ],
            default: null,
          },
          source: {
            type: 'string',
          },
          appearance: {
            $ref: '#/$defs/TextAppearance',
          },
          selection: {
            $ref: '#/$defs/Color',
          },
          disabled: {
            type: 'boolean',
          },
          focusOnPointer: {
            description: 'Whether pointer selection also moves keyboard focus to this source.',
            type: 'boolean',
            default: true,
          },
        },
        additionalProperties: false,
        required: ['source', 'appearance', 'selection', 'disabled'],
        $defs: {
          TerminalPalette: {
            description:
              'Semantic terminal colors for rich text and editors, supplied by the product.',
            type: 'object',
            properties: {
              background: {
                $ref: '#/$defs/TerminalColor',
              },
              foreground: {
                $ref: '#/$defs/TerminalColor',
              },
              surface: {
                $ref: '#/$defs/TerminalColor',
              },
              accent: {
                $ref: '#/$defs/TerminalColor',
              },
              thinking: {
                $ref: '#/$defs/TerminalColor',
              },
              success: {
                $ref: '#/$defs/TerminalColor',
              },
              warning: {
                $ref: '#/$defs/TerminalColor',
              },
              error: {
                $ref: '#/$defs/TerminalColor',
              },
              muted: {
                $ref: '#/$defs/TerminalColor',
              },
              subtle: {
                $ref: '#/$defs/TerminalColor',
              },
              border: {
                $ref: '#/$defs/TerminalColor',
              },
              scrollbar: {
                $ref: '#/$defs/TerminalColor',
              },
              selection: {
                $ref: '#/$defs/TerminalColor',
              },
              selectionText: {
                $ref: '#/$defs/TerminalColor',
              },
              search: {
                $ref: '#/$defs/TerminalColor',
              },
              searchActive: {
                $ref: '#/$defs/TerminalColor',
              },
              searchText: {
                $ref: '#/$defs/TerminalColor',
              },
              syntax: {
                type: 'array',
                items: {
                  $ref: '#/$defs/TerminalColor',
                },
                minItems: 7,
                maxItems: 7,
              },
              terminal: {
                type: 'boolean',
              },
            },
            additionalProperties: false,
            required: [
              'background',
              'foreground',
              'surface',
              'accent',
              'thinking',
              'success',
              'warning',
              'error',
              'muted',
              'subtle',
              'border',
              'scrollbar',
              'selection',
              'selectionText',
              'search',
              'searchActive',
              'searchText',
              'syntax',
              'terminal',
            ],
          },
          TerminalColor: {
            description:
              "Terminal colors retain the user's ANSI palette and default background.\nNumeric values are RGB; named values are emitted as terminal attributes.",
            anyOf: [
              {
                type: 'integer',
                format: 'uint32',
                minimum: 0,
                maximum: 16777215,
              },
              {
                $ref: '#/$defs/TerminalNamedColor',
              },
            ],
          },
          TerminalNamedColor: {
            type: 'string',
            enum: [
              'reset',
              'black',
              'red',
              'green',
              'yellow',
              'blue',
              'magenta',
              'cyan',
              'gray',
              'dark_gray',
              'light_red',
              'light_green',
              'light_yellow',
              'light_blue',
              'light_magenta',
              'light_cyan',
              'white',
            ],
          },
          TextAppearance: {
            type: 'object',
            properties: {
              font: {
                $ref: '#/$defs/FontAppearance',
              },
              foreground: {
                $ref: '#/$defs/Color',
              },
            },
            additionalProperties: false,
            required: ['font', 'foreground'],
          },
          FontAppearance: {
            type: 'object',
            properties: {
              family: {
                $ref: '#/$defs/FontFamily',
              },
              fallbacks: {
                type: 'array',
                items: {
                  $ref: '#/$defs/FontFamily',
                },
              },
              size: {
                type: 'number',
                format: 'float',
                minimum: 6,
                maximum: 96,
              },
              lineHeight: {
                description: 'Line height relative to this font size.',
                type: 'number',
                format: 'float',
                minimum: 1,
                maximum: 3,
              },
              weight: {
                type: 'integer',
                format: 'uint16',
                minimum: 1,
                maximum: 1000,
              },
            },
            additionalProperties: false,
            required: ['family', 'fallbacks', 'size', 'lineHeight', 'weight'],
          },
          FontFamily: {
            type: 'string',
            minLength: 1,
          },
          Color: {
            description: 'Packed RGBA, including explicit alpha zero.',
            type: 'integer',
            format: 'uint32',
            minimum: 0,
          },
        },
      },
      events: {},
      captures: {},
    },
  },
  terminalView: {
    name: 'maka.ui.TerminalView',
    version: 1,
    transport: 'local',
    interface: {
      kind: 'component',
      props: {
        type: 'object',
        additionalProperties: false,
        properties: {
          source: {
            type: 'string',
            description:
              'Changed when the selected canonical resource changes, including read-only views.',
            minLength: 1,
          },
          accessibilityLabel: {
            type: 'string',
            minLength: 1,
          },
          output: {
            anyOf: [
              {
                $ref: '#/$defs/ShellOutput',
              },
              {
                type: 'null',
              },
            ],
          },
          controller: {
            type: ['string', 'null'],
            format: 'uuid',
          },
          acknowledgement: {
            anyOf: [
              {
                $ref: '#/$defs/TerminalInputAcknowledgement',
              },
              {
                type: 'null',
              },
            ],
          },
          appearance: {
            $ref: '#/$defs/TextAppearance',
          },
          background: {
            $ref: '#/$defs/Color',
          },
          caret: {
            $ref: '#/$defs/Color',
          },
          rows: {
            type: 'integer',
            format: 'uint16',
            minimum: 1,
            maximum: 65535,
          },
          tabIndex: {
            type: 'integer',
            format: 'int16',
            minimum: -1,
            maximum: 32767,
          },
        },
        required: [
          'source',
          'accessibilityLabel',
          'appearance',
          'background',
          'caret',
          'rows',
          'tabIndex',
        ],
        title: 'TerminalViewProps',
        $schema: 'https://json-schema.org/draft/2020-12/schema',
        $defs: {
          ShellOutput: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  stdout: {
                    type: 'string',
                  },
                  stderr: {
                    type: 'string',
                  },
                  latestStream: {
                    $ref: '#/$defs/PipeStream',
                  },
                  stdoutTruncated: {
                    type: 'boolean',
                  },
                  stderrTruncated: {
                    type: 'boolean',
                  },
                  redacted: {
                    type: 'boolean',
                  },
                  mode: {
                    type: 'string',
                    const: 'pipes',
                  },
                },
                required: [
                  'mode',
                  'stdout',
                  'stderr',
                  'stdoutTruncated',
                  'stderrTruncated',
                  'redacted',
                ],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  screen: {
                    type: 'string',
                  },
                  scrollback: {
                    type: 'string',
                  },
                  lastAlternateScreen: {
                    type: 'string',
                  },
                  cols: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 0,
                    maximum: 65535,
                  },
                  rows: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 0,
                    maximum: 65535,
                  },
                  cursor: {
                    $ref: '#/$defs/TerminalCursor',
                  },
                  alternateScreen: {
                    type: 'boolean',
                  },
                  truncated: {
                    type: 'boolean',
                  },
                  redacted: {
                    type: 'boolean',
                  },
                  mode: {
                    type: 'string',
                    const: 'pty',
                  },
                },
                required: [
                  'mode',
                  'screen',
                  'scrollback',
                  'cols',
                  'rows',
                  'cursor',
                  'alternateScreen',
                  'truncated',
                  'redacted',
                ],
              },
            ],
          },
          PipeStream: {
            type: 'string',
            enum: ['stdout', 'stderr'],
          },
          TerminalCursor: {
            type: 'object',
            additionalProperties: false,
            properties: {
              x: {
                type: 'integer',
                format: 'uint16',
                minimum: 0,
                maximum: 65535,
              },
              y: {
                type: 'integer',
                format: 'uint16',
                minimum: 0,
                maximum: 65535,
              },
              visible: {
                type: 'boolean',
              },
            },
            required: ['x', 'y', 'visible'],
          },
          TerminalInputAcknowledgement: {
            type: 'object',
            additionalProperties: false,
            properties: {
              owner: {
                type: 'string',
                format: 'uuid',
              },
              controller: {
                type: 'string',
                format: 'uuid',
              },
              sequence: {
                type: 'integer',
                format: 'uint64',
                minimum: 1,
                maximum: 9007199254740991,
              },
              accepted: {
                type: 'boolean',
                description: 'True only after the exact original mutation has a successful result.',
              },
            },
            required: ['owner', 'controller', 'sequence', 'accepted'],
          },
          TextAppearance: {
            type: 'object',
            additionalProperties: false,
            properties: {
              font: {
                $ref: '#/$defs/FontAppearance',
              },
              foreground: {
                $ref: '#/$defs/Color',
              },
            },
            required: ['font', 'foreground'],
          },
          FontAppearance: {
            type: 'object',
            additionalProperties: false,
            properties: {
              family: {
                $ref: '#/$defs/FontFamily',
              },
              fallbacks: {
                type: 'array',
                items: {
                  $ref: '#/$defs/FontFamily',
                },
              },
              size: {
                type: 'number',
                format: 'float',
                minimum: 6,
                maximum: 96,
              },
              lineHeight: {
                type: 'number',
                format: 'float',
                description: 'Line height relative to this font size.',
                minimum: 1,
                maximum: 3,
              },
              weight: {
                type: 'integer',
                format: 'uint16',
                minimum: 1,
                maximum: 1000,
              },
            },
            required: ['family', 'fallbacks', 'size', 'lineHeight', 'weight'],
          },
          FontFamily: {
            type: 'string',
            minLength: 1,
          },
          Color: {
            type: 'integer',
            format: 'uint32',
            minimum: 0,
            description: 'Packed RGBA, including explicit alpha zero.',
          },
        },
      },
      events: {
        observed: {
          type: 'object',
          additionalProperties: false,
          properties: {
            owner: {
              type: 'string',
              format: 'uuid',
            },
            revision: {
              type: 'integer',
              format: 'uint64',
              minimum: 0,
            },
            source: {
              type: 'string',
            },
            controller: {
              type: ['string', 'null'],
              format: 'uuid',
            },
            captured: {
              type: 'boolean',
            },
            batch: {
              anyOf: [
                {
                  $ref: '#/$defs/TerminalInputBatch',
                },
                {
                  type: 'null',
                },
              ],
            },
            error: {
              anyOf: [
                {
                  $ref: '#/$defs/TerminalViewError',
                },
                {
                  type: 'null',
                },
              ],
            },
          },
          required: ['owner', 'revision', 'source', 'captured'],
          title: 'TerminalViewObservation',
          $schema: 'https://json-schema.org/draft/2020-12/schema',
          $defs: {
            TerminalInputBatch: {
              type: 'object',
              additionalProperties: false,
              properties: {
                controller: {
                  type: 'string',
                  format: 'uuid',
                },
                sequence: {
                  type: 'integer',
                  format: 'uint64',
                  minimum: 1,
                  maximum: 9007199254740991,
                },
                actions: {
                  type: 'array',
                  items: {
                    $ref: '#/$defs/RawAction',
                  },
                  maxItems: 64,
                },
                size: {
                  anyOf: [
                    {
                      $ref: '#/$defs/TerminalSize',
                    },
                    {
                      type: 'null',
                    },
                  ],
                },
              },
              required: ['controller', 'sequence', 'actions'],
            },
            RawAction: {
              oneOf: [
                {
                  type: 'object',
                  additionalProperties: false,
                  properties: {
                    text: {
                      type: 'string',
                      minLength: 1,
                      pattern: '^[^\\x00-\\x1f\\x7f-\\x9f]+$',
                    },
                    type: {
                      type: 'string',
                      const: 'text',
                    },
                  },
                  required: ['type', 'text'],
                },
                {
                  type: 'object',
                  additionalProperties: false,
                  properties: {
                    text: {
                      type: 'string',
                      minLength: 1,
                      pattern: '^[^\\x00-\\x08\\x0b\\x0c\\x0e-\\x1f\\x7f-\\x9f]+$',
                    },
                    type: {
                      type: 'string',
                      const: 'paste',
                    },
                  },
                  required: ['type', 'text'],
                },
                {
                  type: 'object',
                  additionalProperties: false,
                  properties: {
                    key: {
                      type: 'string',
                      pattern:
                        '^(?:[ -~]|enter|escape|tab|backspace|arrow_(?:up|down|left|right)|home|end|insert|delete|page_(?:up|down)|f(?:[1-9]|1[0-2]))$',
                    },
                    modifiers: {
                      $ref: '#/$defs/TerminalModifiers',
                      default: [],
                    },
                    type: {
                      type: 'string',
                      const: 'key',
                    },
                  },
                  required: ['type', 'key'],
                },
                {
                  type: 'object',
                  additionalProperties: false,
                  properties: {
                    event: {
                      $ref: '#/$defs/RawEvent',
                    },
                    x: {
                      type: 'integer',
                      format: 'uint64',
                      minimum: 0,
                      maximum: 9007199254740991,
                    },
                    y: {
                      type: 'integer',
                      format: 'uint64',
                      minimum: 0,
                      maximum: 9007199254740991,
                    },
                    button: {
                      $ref: '#/$defs/MouseButton',
                      default: null,
                    },
                    direction: {
                      $ref: '#/$defs/ScrollDirection',
                      default: null,
                    },
                    modifiers: {
                      $ref: '#/$defs/TerminalModifiers',
                      default: [],
                    },
                    type: {
                      type: 'string',
                      const: 'mouse',
                    },
                  },
                  required: ['type', 'event', 'x', 'y'],
                },
              ],
            },
            TerminalModifiers: {
              type: 'array',
              items: {
                $ref: '#/$defs/Modifier',
              },
              uniqueItems: true,
              maxItems: 3,
            },
            Modifier: {
              type: 'string',
              enum: ['ctrl', 'alt', 'shift'],
            },
            RawEvent: {
              type: 'string',
              enum: ['click', 'press', 'release', 'move', 'scroll'],
            },
            MouseButton: {
              type: 'string',
              enum: ['left', 'middle', 'right'],
            },
            ScrollDirection: {
              type: 'string',
              enum: ['up', 'down'],
            },
            TerminalSize: {
              type: 'object',
              additionalProperties: false,
              properties: {
                cols: {
                  type: 'integer',
                  format: 'uint16',
                  minimum: 2,
                  maximum: 1024,
                },
                rows: {
                  type: 'integer',
                  format: 'uint16',
                  minimum: 1,
                  maximum: 1024,
                },
              },
              required: ['cols', 'rows'],
              description:
                'Shared by native PTY allocation, input validation and screen rendering.',
            },
            TerminalViewError: {
              type: 'string',
              enum: ['input_full', 'input_failed', 'budget_exhausted'],
            },
          },
        },
      },
      captures: {},
    },
  },
  selectionMenu: {
    name: 'maka.ui.SelectionMenu',
    version: 1,
    transport: 'local',
    interface: {
      kind: 'component',
      props: {
        $schema: 'https://json-schema.org/draft/2020-12/schema',
        title: 'SelectionMenuProps',
        type: 'object',
        properties: {
          appearance: {
            $ref: '#/$defs/MenuAppearance',
          },
          labels: {
            $ref: '#/$defs/SelectionMenuLabels',
          },
          disabled: {
            type: 'boolean',
          },
        },
        additionalProperties: false,
        required: ['appearance', 'labels', 'disabled'],
        $defs: {
          MenuAppearance: {
            type: 'object',
            properties: {
              text: {
                $ref: '#/$defs/TextAppearance',
              },
              background: {
                $ref: '#/$defs/Color',
              },
              border: {
                $ref: '#/$defs/Color',
              },
              activeBackground: {
                $ref: '#/$defs/Color',
              },
              activeForeground: {
                $ref: '#/$defs/Color',
              },
              disabledForeground: {
                $ref: '#/$defs/Color',
              },
              borderWidth: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 8,
              },
              radius: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 64,
              },
              padding: {
                $ref: '#/$defs/Insets',
              },
              rowPadding: {
                $ref: '#/$defs/Insets',
              },
              width: {
                type: 'number',
                format: 'float',
                minimum: 32,
                maximum: 1024,
              },
              windowMargin: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 128,
              },
            },
            additionalProperties: false,
            required: [
              'text',
              'background',
              'border',
              'activeBackground',
              'activeForeground',
              'disabledForeground',
              'borderWidth',
              'radius',
              'padding',
              'rowPadding',
              'width',
              'windowMargin',
            ],
          },
          TextAppearance: {
            type: 'object',
            properties: {
              font: {
                $ref: '#/$defs/FontAppearance',
              },
              foreground: {
                $ref: '#/$defs/Color',
              },
            },
            additionalProperties: false,
            required: ['font', 'foreground'],
          },
          FontAppearance: {
            type: 'object',
            properties: {
              family: {
                $ref: '#/$defs/FontFamily',
              },
              fallbacks: {
                type: 'array',
                items: {
                  $ref: '#/$defs/FontFamily',
                },
              },
              size: {
                type: 'number',
                format: 'float',
                minimum: 6,
                maximum: 96,
              },
              lineHeight: {
                description: 'Line height relative to this font size.',
                type: 'number',
                format: 'float',
                minimum: 1,
                maximum: 3,
              },
              weight: {
                type: 'integer',
                format: 'uint16',
                minimum: 1,
                maximum: 1000,
              },
            },
            additionalProperties: false,
            required: ['family', 'fallbacks', 'size', 'lineHeight', 'weight'],
          },
          FontFamily: {
            type: 'string',
            minLength: 1,
          },
          Color: {
            description: 'Packed RGBA, including explicit alpha zero.',
            type: 'integer',
            format: 'uint32',
            minimum: 0,
          },
          Insets: {
            type: 'object',
            properties: {
              top: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 128,
              },
              right: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 128,
              },
              bottom: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 128,
              },
              left: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 128,
              },
            },
            additionalProperties: false,
            required: ['top', 'right', 'bottom', 'left'],
          },
          SelectionMenuLabels: {
            type: 'object',
            properties: {
              title: {
                type: 'string',
                minLength: 1,
              },
              copy: {
                type: 'string',
                minLength: 1,
              },
              selectAll: {
                type: 'string',
                minLength: 1,
              },
            },
            additionalProperties: false,
            required: ['title', 'copy', 'selectAll'],
          },
        },
      },
      events: {},
      captures: {},
    },
  },
  rows: {
    name: 'maka.ui.Rows',
    version: 1,
    transport: 'local',
    interface: {
      kind: 'component',
      props: {
        $schema: 'https://json-schema.org/draft/2020-12/schema',
        title: 'RowsProps',
        type: 'object',
        properties: {
          terminal: {
            anyOf: [
              {
                $ref: '#/$defs/TerminalPalette',
              },
              {
                type: 'null',
              },
            ],
            default: null,
          },
          revision: {
            type: 'integer',
            format: 'uint64',
            minimum: 0,
          },
          entry: {
            description:
              'Select this row on keyboard entry. None retains the current selection,\nor selects the first row when there is no current selection.',
            type: ['string', 'null'],
          },
          rows: {
            type: 'array',
            items: {
              $ref: '#/$defs/Row',
            },
          },
          shortcuts: {
            type: 'array',
            items: {
              $ref: '#/$defs/Shortcut',
            },
          },
          maxRows: {
            type: 'integer',
            format: 'uint16',
            minimum: 1,
            maximum: 65535,
          },
          compactBelow: {
            description:
              "Optional smaller row cap below the nearest declared layout viewport's\nheight, in cells; defaults to the surface when no viewport is declared.",
            anyOf: [
              {
                $ref: '#/$defs/CompactRows',
              },
              {
                type: 'null',
              },
            ],
            default: null,
          },
          tabIndex: {
            type: 'integer',
            format: 'int16',
            minimum: -1,
            maximum: 32767,
          },
          foreground: {
            $ref: '#/$defs/Color',
          },
          muted: {
            $ref: '#/$defs/Color',
          },
          selected: {
            $ref: '#/$defs/Color',
          },
          hovered: {
            $ref: '#/$defs/Color',
          },
          scrollbar: {
            $ref: '#/$defs/RowScrollbar',
          },
        },
        additionalProperties: false,
        required: [
          'revision',
          'rows',
          'shortcuts',
          'maxRows',
          'tabIndex',
          'foreground',
          'muted',
          'selected',
          'hovered',
          'scrollbar',
        ],
        $defs: {
          TerminalPalette: {
            description:
              'Semantic terminal colors for rich text and editors, supplied by the product.',
            type: 'object',
            properties: {
              background: {
                $ref: '#/$defs/TerminalColor',
              },
              foreground: {
                $ref: '#/$defs/TerminalColor',
              },
              surface: {
                $ref: '#/$defs/TerminalColor',
              },
              accent: {
                $ref: '#/$defs/TerminalColor',
              },
              thinking: {
                $ref: '#/$defs/TerminalColor',
              },
              success: {
                $ref: '#/$defs/TerminalColor',
              },
              warning: {
                $ref: '#/$defs/TerminalColor',
              },
              error: {
                $ref: '#/$defs/TerminalColor',
              },
              muted: {
                $ref: '#/$defs/TerminalColor',
              },
              subtle: {
                $ref: '#/$defs/TerminalColor',
              },
              border: {
                $ref: '#/$defs/TerminalColor',
              },
              scrollbar: {
                $ref: '#/$defs/TerminalColor',
              },
              selection: {
                $ref: '#/$defs/TerminalColor',
              },
              selectionText: {
                $ref: '#/$defs/TerminalColor',
              },
              search: {
                $ref: '#/$defs/TerminalColor',
              },
              searchActive: {
                $ref: '#/$defs/TerminalColor',
              },
              searchText: {
                $ref: '#/$defs/TerminalColor',
              },
              syntax: {
                type: 'array',
                items: {
                  $ref: '#/$defs/TerminalColor',
                },
                minItems: 7,
                maxItems: 7,
              },
              terminal: {
                type: 'boolean',
              },
            },
            additionalProperties: false,
            required: [
              'background',
              'foreground',
              'surface',
              'accent',
              'thinking',
              'success',
              'warning',
              'error',
              'muted',
              'subtle',
              'border',
              'scrollbar',
              'selection',
              'selectionText',
              'search',
              'searchActive',
              'searchText',
              'syntax',
              'terminal',
            ],
          },
          TerminalColor: {
            description:
              "Terminal colors retain the user's ANSI palette and default background.\nNumeric values are RGB; named values are emitted as terminal attributes.",
            anyOf: [
              {
                type: 'integer',
                format: 'uint32',
                minimum: 0,
                maximum: 16777215,
              },
              {
                $ref: '#/$defs/TerminalNamedColor',
              },
            ],
          },
          TerminalNamedColor: {
            type: 'string',
            enum: [
              'reset',
              'black',
              'red',
              'green',
              'yellow',
              'blue',
              'magenta',
              'cyan',
              'gray',
              'dark_gray',
              'light_red',
              'light_green',
              'light_yellow',
              'light_blue',
              'light_magenta',
              'light_cyan',
              'white',
            ],
          },
          Row: {
            type: 'object',
            properties: {
              key: {
                type: 'string',
                minLength: 1,
              },
              text: {
                type: 'string',
              },
              actions: {
                type: 'array',
                items: {
                  $ref: '#/$defs/RowAction',
                },
              },
            },
            additionalProperties: false,
            required: ['key', 'text', 'actions'],
          },
          RowAction: {
            type: 'object',
            properties: {
              key: {
                type: 'string',
                minLength: 1,
              },
              label: {
                type: 'string',
              },
              enabled: {
                type: 'boolean',
              },
            },
            additionalProperties: false,
            required: ['key', 'label', 'enabled'],
          },
          Shortcut: {
            type: 'object',
            properties: {
              key: {
                type: 'string',
                pattern:
                  '^([a-z0-9]|escape|enter|tab|delete|space|up|down|left|right|home|end|pageup|pagedown|f([1-9]|1[0-2]))$',
              },
              modifiers: {
                type: 'array',
                items: {
                  $ref: '#/$defs/Modifier',
                },
                maxItems: 4,
              },
              input: {
                type: 'string',
                minLength: 1,
              },
              enabled: {
                type: 'boolean',
              },
            },
            additionalProperties: false,
            required: ['key', 'modifiers', 'input', 'enabled'],
          },
          Modifier: {
            type: 'string',
            enum: ['control', 'primary', 'alt', 'shift', 'super'],
          },
          CompactRows: {
            type: 'object',
            properties: {
              height: {
                type: 'integer',
                format: 'uint16',
                minimum: 1,
                maximum: 65535,
              },
              maxRows: {
                type: 'integer',
                format: 'uint16',
                minimum: 1,
                maximum: 65535,
              },
            },
            additionalProperties: false,
            required: ['height', 'maxRows'],
          },
          Color: {
            description: 'Packed RGBA, including explicit alpha zero.',
            type: 'integer',
            format: 'uint32',
            minimum: 0,
          },
          RowScrollbar: {
            type: 'object',
            properties: {
              thumb: {
                type: 'string',
                minLength: 1,
                maxLength: 1,
              },
              track: {
                type: 'string',
                minLength: 1,
                maxLength: 1,
              },
              thumbColor: {
                $ref: '#/$defs/Color',
              },
              trackColor: {
                $ref: '#/$defs/Color',
              },
            },
            additionalProperties: false,
            required: ['thumb', 'track', 'thumbColor', 'trackColor'],
          },
        },
      },
      events: {
        activated: {
          $schema: 'https://json-schema.org/draft/2020-12/schema',
          title: 'RowActivated',
          type: 'object',
          properties: {
            revision: {
              type: 'integer',
              format: 'uint64',
              minimum: 0,
            },
            row: {
              type: 'string',
            },
            action: {
              type: 'string',
            },
          },
          additionalProperties: false,
          required: ['revision', 'row', 'action'],
        },
      },
      captures: {},
    },
  },
  valueCheckpoint: {
    name: 'maka.ui.ValueCheckpoint',
    version: 1,
    transport: 'local',
    interface: {
      kind: 'component',
      props: {
        $schema: 'https://json-schema.org/draft/2020-12/schema',
        title: 'ValueCheckpointProps',
        type: 'object',
        properties: {
          key: {
            type: 'string',
            minLength: 1,
          },
          format: {
            type: 'string',
            minLength: 1,
          },
          command: {
            anyOf: [
              {
                $ref: '#/$defs/ValueCheckpointCommand',
              },
              {
                type: 'null',
              },
            ],
          },
        },
        additionalProperties: false,
        required: ['key', 'format'],
        $defs: {
          ValueCheckpointCommand: {
            oneOf: [
              {
                type: 'object',
                properties: {
                  sequence: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'read',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'sequence'],
              },
              {
                type: 'object',
                properties: {
                  sequence: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  expectedRevision: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  value: true,
                  kind: {
                    type: 'string',
                    const: 'write',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'sequence', 'value'],
              },
            ],
          },
        },
      },
      events: {
        changed: {
          $schema: 'https://json-schema.org/draft/2020-12/schema',
          title: 'ValueCheckpointObservation',
          type: 'object',
          properties: {
            sequence: {
              type: 'integer',
              format: 'uint64',
              minimum: 0,
            },
            state: {
              $ref: '#/$defs/ValueCheckpointState',
            },
          },
          additionalProperties: false,
          required: ['sequence', 'state'],
          $defs: {
            ValueCheckpointState: {
              oneOf: [
                {
                  type: 'object',
                  properties: {
                    kind: {
                      type: 'string',
                      const: 'loading',
                    },
                  },
                  required: ['kind'],
                  additionalProperties: false,
                },
                {
                  type: 'object',
                  properties: {
                    kind: {
                      type: 'string',
                      const: 'saving',
                    },
                  },
                  required: ['kind'],
                  additionalProperties: false,
                },
                {
                  type: 'object',
                  properties: {
                    revision: {
                      type: ['integer', 'null'],
                      format: 'uint64',
                      minimum: 0,
                    },
                    value: true,
                    kind: {
                      type: 'string',
                      const: 'ready',
                    },
                  },
                  additionalProperties: false,
                  required: ['kind'],
                },
                {
                  type: 'object',
                  properties: {
                    diagnostic: {
                      type: 'string',
                    },
                    kind: {
                      type: 'string',
                      const: 'failed',
                    },
                  },
                  additionalProperties: false,
                  required: ['kind', 'diagnostic'],
                },
              ],
            },
          },
        },
      },
      captures: {},
    },
  },
  locale: {
    name: 'maka.ui.Locale',
    version: 1,
    transport: 'local',
    interface: {
      kind: 'value',
      schema: {
        type: 'string',
        minLength: 1,
      },
    },
  },
  textFile: {
    name: 'maka.ui.TextFile',
    version: 1,
    transport: 'local',
    interface: {
      kind: 'component',
      props: {
        $schema: 'https://json-schema.org/draft/2020-12/schema',
        title: 'TextFileProps',
        type: 'object',
        properties: {
          command: {
            anyOf: [
              {
                $ref: '#/$defs/TextFileCommand',
              },
              {
                type: 'null',
              },
            ],
          },
        },
        additionalProperties: false,
        $defs: {
          TextFileCommand: {
            type: 'object',
            properties: {
              owner: {
                type: 'string',
              },
              sequence: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
              operation: {
                $ref: '#/$defs/TextFileOperation',
              },
            },
            additionalProperties: false,
            required: ['owner', 'sequence', 'operation'],
          },
          TextFileOperation: {
            oneOf: [
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'read',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  expectedDigest: {
                    type: ['string', 'null'],
                  },
                  text: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'write',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'text'],
              },
            ],
          },
        },
      },
      events: {
        changed: {
          $schema: 'https://json-schema.org/draft/2020-12/schema',
          title: 'TextFileObservation',
          type: 'object',
          properties: {
            owner: {
              type: 'string',
            },
            path: {
              type: ['string', 'null'],
            },
            sequence: {
              type: 'integer',
              format: 'uint64',
              minimum: 0,
            },
            state: {
              $ref: '#/$defs/TextFileState',
            },
          },
          additionalProperties: false,
          required: ['owner', 'sequence', 'state'],
          $defs: {
            TextFileState: {
              oneOf: [
                {
                  type: 'object',
                  properties: {
                    kind: {
                      type: 'string',
                      const: 'unavailable',
                    },
                  },
                  required: ['kind'],
                  additionalProperties: false,
                },
                {
                  type: 'object',
                  properties: {
                    kind: {
                      type: 'string',
                      const: 'idle',
                    },
                  },
                  required: ['kind'],
                  additionalProperties: false,
                },
                {
                  type: 'object',
                  properties: {
                    kind: {
                      type: 'string',
                      const: 'loading',
                    },
                  },
                  required: ['kind'],
                  additionalProperties: false,
                },
                {
                  type: 'object',
                  properties: {
                    kind: {
                      type: 'string',
                      const: 'saving',
                    },
                  },
                  required: ['kind'],
                  additionalProperties: false,
                },
                {
                  type: 'object',
                  properties: {
                    digest: {
                      type: ['string', 'null'],
                    },
                    text: {
                      type: ['string', 'null'],
                    },
                    kind: {
                      type: 'string',
                      const: 'ready',
                    },
                  },
                  additionalProperties: false,
                  required: ['kind'],
                },
                {
                  type: 'object',
                  properties: {
                    error: {
                      $ref: '#/$defs/TextFileError',
                    },
                    kind: {
                      type: 'string',
                      const: 'failed',
                    },
                  },
                  additionalProperties: false,
                  required: ['kind', 'error'],
                },
              ],
            },
            TextFileError: {
              type: 'string',
              enum: [
                'read_failed',
                'write_failed',
                'invalid_file',
                'invalid_utf8',
                'conflict',
                'worker_failed',
              ],
            },
          },
        },
      },
      captures: {},
    },
  },
  morphMark: {
    name: 'maka.ui.MorphMark',
    version: 1,
    transport: 'local',
    interface: {
      kind: 'component',
      props: {
        $schema: 'https://json-schema.org/draft/2020-12/schema',
        title: 'MorphMarkProps',
        type: 'object',
        properties: {
          background: {
            $ref: '#/$defs/TerminalColor',
          },
          foreground: {
            $ref: '#/$defs/TerminalColor',
          },
          motion: {
            type: 'boolean',
          },
          ascii: {
            type: 'boolean',
          },
        },
        additionalProperties: false,
        required: ['background', 'foreground', 'motion', 'ascii'],
        $defs: {
          TerminalColor: {
            description:
              "Terminal colors retain the user's ANSI palette and default background.\nNumeric values are RGB; named values are emitted as terminal attributes.",
            anyOf: [
              {
                type: 'integer',
                format: 'uint32',
                minimum: 0,
                maximum: 16777215,
              },
              {
                $ref: '#/$defs/TerminalNamedColor',
              },
            ],
          },
          TerminalNamedColor: {
            type: 'string',
            enum: [
              'reset',
              'black',
              'red',
              'green',
              'yellow',
              'blue',
              'magenta',
              'cyan',
              'gray',
              'dark_gray',
              'light_red',
              'light_green',
              'light_yellow',
              'light_blue',
              'light_magenta',
              'light_cyan',
              'white',
            ],
          },
        },
      },
      events: {},
      captures: {},
    },
  },
  readingArea: {
    name: 'maka.ui.ReadingArea',
    version: 1,
    transport: 'local',
    interface: {
      kind: 'component',
      props: {
        $schema: 'https://json-schema.org/draft/2020-12/schema',
        title: 'ReadingProps',
        type: 'object',
        properties: {
          content: {
            description:
              "The presenter's scene language; each requires a scrolling column Stack.\nIts scroll policy and layout are the only presentation authority.",
          },
          command: {
            description:
              'Omission retains an accepted command; numbers increase per original mount.',
            anyOf: [
              {
                $ref: '#/$defs/ReadingCommand',
              },
              {
                type: 'null',
              },
            ],
          },
        },
        additionalProperties: false,
        required: ['content'],
        $defs: {
          ReadingCommand: {
            type: 'object',
            properties: {
              sequence: {
                type: 'integer',
                format: 'uint64',
                minimum: 1,
              },
              target: {
                $ref: '#/$defs/ReadingTarget',
              },
            },
            additionalProperties: false,
            required: ['sequence', 'target'],
          },
          ReadingTarget: {
            oneOf: [
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'start',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'end',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                description:
                  'Find over native readable descendants, including folded slots. SourceText uses\noriginal literal bytes; Markdown uses its width-independent rendered text.',
                type: 'object',
                properties: {
                  query: {
                    type: 'string',
                  },
                  step: {
                    $ref: '#/$defs/FindStep',
                  },
                  kind: {
                    type: 'string',
                    const: 'find',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'query', 'step'],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'clear_find',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                description: 'Move the original terminal viewport by physical rows.',
                type: 'object',
                properties: {
                  rows: {
                    type: 'integer',
                    format: 'int32',
                  },
                  kind: {
                    type: 'string',
                    const: 'scroll_rows',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'rows'],
              },
              {
                description:
                  "Reveal a UTF-8 byte in the descendant's native readable text, as returned by Find.",
                type: 'object',
                properties: {
                  path: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                    minItems: 1,
                  },
                  offset: {
                    type: 'integer',
                    format: 'uint32',
                    minimum: 0,
                  },
                  find_sequence: {
                    description:
                      'If supplied, reveal only while this accepted find retains its original physical intent.',
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                    default: null,
                  },
                  kind: {
                    type: 'string',
                    const: 'reveal_source',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'path', 'offset'],
              },
              {
                description:
                  'TUI: focus and minimally reveal an enabled scene Item. Settlement waits\nfor its successful presentation; this never submits the item.',
                type: 'object',
                properties: {
                  key: {
                    type: 'string',
                    minLength: 1,
                  },
                  kind: {
                    type: 'string',
                    const: 'focus_item',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'key'],
              },
              {
                type: 'object',
                properties: {
                  key: {
                    type: 'string',
                    minLength: 1,
                  },
                  kind: {
                    type: 'string',
                    const: 'reveal_child',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'key'],
              },
            ],
          },
          FindStep: {
            type: 'string',
            enum: ['first', 'next', 'previous'],
          },
        },
      },
      events: {
        input: {
          $schema: 'https://json-schema.org/draft/2020-12/schema',
          title: 'ComponentInput',
          description:
            'Input origin is assigned by the application, never by plugin event payloads.',
          oneOf: [
            {
              type: 'object',
              properties: {
                key: {
                  type: 'string',
                },
                event: true,
                kind: {
                  type: 'string',
                  const: 'raw',
                },
              },
              additionalProperties: false,
              required: ['kind', 'key', 'event'],
            },
            {
              type: 'object',
              properties: {
                key: {
                  type: 'string',
                },
                event: true,
                kind: {
                  type: 'string',
                  const: 'action',
                },
              },
              additionalProperties: false,
              required: ['kind', 'key', 'event'],
            },
            {
              type: 'object',
              properties: {
                key: {
                  type: 'string',
                },
                child: {
                  type: 'string',
                },
                name: {
                  type: 'string',
                },
                event: true,
                kind: {
                  type: 'string',
                  const: 'component',
                },
              },
              additionalProperties: false,
              required: ['kind', 'key', 'child', 'name', 'event'],
            },
          ],
        },
        observed: {
          $schema: 'https://json-schema.org/draft/2020-12/schema',
          title: 'ReadingObservation',
          type: 'object',
          properties: {
            readingRevision: {
              description: 'Immediate native intent; can be newer than the painted viewport.',
              type: 'integer',
              format: 'uint64',
              minimum: 0,
            },
            viewport: {
              anyOf: [
                {
                  $ref: '#/$defs/ReadingViewport',
                },
                {
                  type: 'null',
                },
              ],
            },
            scroll: {
              anyOf: [
                {
                  $ref: '#/$defs/ReadingScroll',
                },
                {
                  type: 'null',
                },
              ],
              default: null,
            },
            selectedChildKey: {
              description:
                'Direct content child containing the native selection focus. Renderers\nwithout this observation return null. This key conveys no read authority.',
              type: ['string', 'null'],
            },
            pendingCommand: {
              type: ['integer', 'null'],
              format: 'uint64',
              minimum: 0,
            },
            receipt: {
              description: 'Only the most recently settled command is retained, without a ledger.',
              anyOf: [
                {
                  $ref: '#/$defs/ReadingReceipt',
                },
                {
                  type: 'null',
                },
              ],
            },
            find: {
              anyOf: [
                {
                  $ref: '#/$defs/ReadingFind',
                },
                {
                  type: 'null',
                },
              ],
            },
          },
          additionalProperties: false,
          required: ['readingRevision'],
          $defs: {
            ReadingViewport: {
              type: 'object',
              properties: {
                readingRevision: {
                  description: 'Explicit reading intent used by the actually painted children.',
                  type: 'integer',
                  format: 'uint64',
                  minimum: 0,
                },
                atStart: {
                  type: 'boolean',
                  default: false,
                },
                atEnd: {
                  type: 'boolean',
                },
                visibleChildKeys: {
                  type: 'array',
                  items: {
                    type: 'string',
                  },
                },
              },
              additionalProperties: false,
              required: ['readingRevision', 'atEnd', 'visibleChildKeys'],
            },
            ReadingScroll: {
              description:
                'Most recent physical scroll. Layout changes and programmatic landings do not\ncreate a new request, so a product can load adjacent content without loops.',
              type: 'object',
              properties: {
                readingRevision: {
                  type: 'integer',
                  format: 'uint64',
                  minimum: 0,
                },
                direction: {
                  $ref: '#/$defs/ReadingScrollDirection',
                },
              },
              additionalProperties: false,
              required: ['readingRevision', 'direction'],
            },
            ReadingScrollDirection: {
              type: 'string',
              enum: ['up', 'down'],
            },
            ReadingReceipt: {
              type: 'object',
              properties: {
                sequence: {
                  type: 'integer',
                  format: 'uint64',
                  minimum: 0,
                },
                status: {
                  $ref: '#/$defs/ReadingStatus',
                },
              },
              additionalProperties: false,
              required: ['sequence', 'status'],
            },
            ReadingStatus: {
              type: 'string',
              enum: ['applied', 'cancelled', 'rejected'],
            },
            ReadingFind: {
              type: 'object',
              properties: {
                sequence: {
                  type: 'integer',
                  format: 'uint64',
                  minimum: 0,
                },
                count: {
                  type: 'integer',
                  format: 'uint32',
                  minimum: 0,
                },
                limited: {
                  type: 'boolean',
                },
                index: {
                  description: 'One-based current match, or null when no match remains.',
                  type: ['integer', 'null'],
                  format: 'uint32',
                  minimum: 0,
                },
                active: {
                  anyOf: [
                    {
                      $ref: '#/$defs/ReadingMatch',
                    },
                    {
                      type: 'null',
                    },
                  ],
                },
              },
              additionalProperties: false,
              required: ['sequence', 'count', 'limited'],
            },
            ReadingMatch: {
              type: 'object',
              properties: {
                path: {
                  type: 'array',
                  items: {
                    type: 'string',
                  },
                  minItems: 1,
                },
                offset: {
                  type: 'integer',
                  format: 'uint32',
                  minimum: 0,
                },
              },
              additionalProperties: false,
              required: ['path', 'offset'],
            },
          },
        },
      },
      captures: {
        tail: {
          input: {
            type: 'null',
          },
          output: {
            kind: 'continuation',
          },
        },
      },
    },
  },
  label: {
    name: 'maka.ui.Label',
    version: 1,
    transport: 'local',
    interface: {
      kind: 'component',
      props: {
        $schema: 'https://json-schema.org/draft/2020-12/schema',
        title: 'LabelProps',
        type: 'object',
        properties: {
          text: {
            type: 'string',
          },
          appearance: {
            $ref: '#/$defs/TextAppearance',
          },
          terminalForeground: {
            anyOf: [
              {
                $ref: '#/$defs/TerminalColor',
              },
              {
                type: 'null',
              },
            ],
            default: null,
          },
          elapsed: {
            anyOf: [
              {
                $ref: '#/$defs/Elapsed',
              },
              {
                type: 'null',
              },
            ],
            default: null,
          },
        },
        additionalProperties: false,
        required: ['text', 'appearance'],
        $defs: {
          TextAppearance: {
            type: 'object',
            properties: {
              font: {
                $ref: '#/$defs/FontAppearance',
              },
              foreground: {
                $ref: '#/$defs/Color',
              },
            },
            additionalProperties: false,
            required: ['font', 'foreground'],
          },
          FontAppearance: {
            type: 'object',
            properties: {
              family: {
                $ref: '#/$defs/FontFamily',
              },
              fallbacks: {
                type: 'array',
                items: {
                  $ref: '#/$defs/FontFamily',
                },
              },
              size: {
                type: 'number',
                format: 'float',
                minimum: 6,
                maximum: 96,
              },
              lineHeight: {
                description: 'Line height relative to this font size.',
                type: 'number',
                format: 'float',
                minimum: 1,
                maximum: 3,
              },
              weight: {
                type: 'integer',
                format: 'uint16',
                minimum: 1,
                maximum: 1000,
              },
            },
            additionalProperties: false,
            required: ['family', 'fallbacks', 'size', 'lineHeight', 'weight'],
          },
          FontFamily: {
            type: 'string',
            minLength: 1,
          },
          Color: {
            description: 'Packed RGBA, including explicit alpha zero.',
            type: 'integer',
            format: 'uint32',
            minimum: 0,
          },
          TerminalColor: {
            description:
              "Terminal colors retain the user's ANSI palette and default background.\nNumeric values are RGB; named values are emitted as terminal attributes.",
            anyOf: [
              {
                type: 'integer',
                format: 'uint32',
                minimum: 0,
                maximum: 16777215,
              },
              {
                $ref: '#/$defs/TerminalNamedColor',
              },
            ],
          },
          TerminalNamedColor: {
            type: 'string',
            enum: [
              'reset',
              'black',
              'red',
              'green',
              'yellow',
              'blue',
              'magenta',
              'cyan',
              'gray',
              'dark_gray',
              'light_red',
              'light_green',
              'light_yellow',
              'light_blue',
              'light_magenta',
              'light_cyan',
              'white',
            ],
          },
          Elapsed: {
            type: 'object',
            properties: {
              from: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
                maximum: 9007199254740991,
              },
              to: {
                type: ['integer', 'null'],
                format: 'uint64',
                minimum: 0,
              },
            },
            additionalProperties: false,
            required: ['from', 'to'],
          },
        },
      },
      events: {},
      captures: {},
    },
  },
  textarea: {
    name: 'maka.ui.Textarea',
    version: 1,
    transport: 'local',
    interface: {
      kind: 'component',
      props: {
        $schema: 'https://json-schema.org/draft/2020-12/schema',
        title: 'TextareaProps',
        type: 'object',
        properties: {
          appearance: {
            $ref: '#/$defs/TextareaAppearance',
          },
          inlineTokens: {
            description:
              'Exact whitespace-delimited literals rendered and edited as atomic inline tokens.',
            type: 'array',
            items: {
              type: 'string',
              minLength: 1,
              pattern: '^\\S+$',
            },
            default: [],
          },
          menu: {
            anyOf: [
              {
                $ref: '#/$defs/TextareaMenu',
              },
              {
                type: 'null',
              },
            ],
            default: null,
          },
          accessibilityLabel: {
            type: 'string',
            minLength: 1,
          },
          readOnly: {
            type: 'boolean',
          },
          disabled: {
            type: 'boolean',
          },
          softWrap: {
            type: 'boolean',
          },
          terminalRows: {
            description:
              'Preferred terminal text rows, excluding native padding. A constrained\nviewport may shrink further.',
            $ref: '#/$defs/TerminalTextareaRows',
            default: {
              min: 3,
              max: 8,
              resizable: false,
              maxViewportFraction: null,
            },
          },
          submit: {
            description: 'None preserves native multiline editing without a submit shortcut.',
            anyOf: [
              {
                $ref: '#/$defs/SubmitKey',
              },
              {
                type: 'null',
              },
            ],
            default: null,
          },
          navigation: {
            description: 'Yield suggestion navigation only for the original observed editor state.',
            anyOf: [
              {
                $ref: '#/$defs/EditorNavigation',
              },
              {
                type: 'null',
              },
            ],
            default: null,
          },
          tabIndex: {
            type: 'integer',
            format: 'int16',
            minimum: -1,
            maximum: 32767,
          },
          autoFocus: {
            description:
              'Offer native focus once when this original input becomes visible and\nenabled. Stable updates and viewport scrolling do not repeat the offer.',
            type: 'boolean',
            default: false,
          },
          initialText: {
            type: 'string',
            default: '',
          },
          placeholder: {
            type: 'string',
            default: '',
          },
          command: {
            description:
              'None issues no new command; an accepted command remains pending until\nits matching receipt commits. Clearing props is not cancellation.',
            anyOf: [
              {
                $ref: '#/$defs/EditorCommand',
              },
              {
                type: 'null',
              },
            ],
            default: null,
          },
          filePaste: {
            description:
              'Opt-in local file-path paste. The context is returned unchanged; it is\ncorrelation, never a filesystem path or an authorization grant.',
            anyOf: [
              {
                $ref: '#/$defs/FilePastePolicy',
              },
              {
                type: 'null',
              },
            ],
            default: null,
          },
          fileCommand: {
            anyOf: [
              {
                $ref: '#/$defs/FilePasteCommand',
              },
              {
                type: 'null',
              },
            ],
            default: null,
          },
          persistence: {
            anyOf: [
              {
                $ref: '#/$defs/EditorPersistence',
              },
              {
                type: 'null',
              },
            ],
            default: null,
          },
        },
        additionalProperties: false,
        required: [
          'appearance',
          'accessibilityLabel',
          'readOnly',
          'disabled',
          'softWrap',
          'tabIndex',
        ],
        $defs: {
          TextareaAppearance: {
            type: 'object',
            properties: {
              ascii: {
                type: 'boolean',
                default: false,
              },
              terminal: {
                anyOf: [
                  {
                    $ref: '#/$defs/TerminalPalette',
                  },
                  {
                    type: 'null',
                  },
                ],
                default: null,
              },
              text: {
                $ref: '#/$defs/TextAppearance',
              },
              mutedForeground: {
                $ref: '#/$defs/Color',
              },
              background: {
                $ref: '#/$defs/Color',
              },
              selection: {
                $ref: '#/$defs/Color',
              },
              caret: {
                $ref: '#/$defs/Color',
              },
              border: {
                $ref: '#/$defs/Color',
              },
              focusedBorder: {
                $ref: '#/$defs/Color',
              },
              borderWidth: {
                description:
                  'In TUI inputs, a positive width draws a one-cell border; zero has no inset.',
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 8,
              },
              radius: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 64,
              },
              padding: {
                $ref: '#/$defs/Insets',
              },
              scrollbar: {
                $ref: '#/$defs/ScrollbarAppearance',
              },
            },
            additionalProperties: false,
            required: [
              'text',
              'mutedForeground',
              'background',
              'selection',
              'caret',
              'border',
              'focusedBorder',
              'borderWidth',
              'radius',
              'padding',
              'scrollbar',
            ],
          },
          TerminalPalette: {
            description:
              'Semantic terminal colors for rich text and editors, supplied by the product.',
            type: 'object',
            properties: {
              background: {
                $ref: '#/$defs/TerminalColor',
              },
              foreground: {
                $ref: '#/$defs/TerminalColor',
              },
              surface: {
                $ref: '#/$defs/TerminalColor',
              },
              accent: {
                $ref: '#/$defs/TerminalColor',
              },
              thinking: {
                $ref: '#/$defs/TerminalColor',
              },
              success: {
                $ref: '#/$defs/TerminalColor',
              },
              warning: {
                $ref: '#/$defs/TerminalColor',
              },
              error: {
                $ref: '#/$defs/TerminalColor',
              },
              muted: {
                $ref: '#/$defs/TerminalColor',
              },
              subtle: {
                $ref: '#/$defs/TerminalColor',
              },
              border: {
                $ref: '#/$defs/TerminalColor',
              },
              scrollbar: {
                $ref: '#/$defs/TerminalColor',
              },
              selection: {
                $ref: '#/$defs/TerminalColor',
              },
              selectionText: {
                $ref: '#/$defs/TerminalColor',
              },
              search: {
                $ref: '#/$defs/TerminalColor',
              },
              searchActive: {
                $ref: '#/$defs/TerminalColor',
              },
              searchText: {
                $ref: '#/$defs/TerminalColor',
              },
              syntax: {
                type: 'array',
                items: {
                  $ref: '#/$defs/TerminalColor',
                },
                minItems: 7,
                maxItems: 7,
              },
              terminal: {
                type: 'boolean',
              },
            },
            additionalProperties: false,
            required: [
              'background',
              'foreground',
              'surface',
              'accent',
              'thinking',
              'success',
              'warning',
              'error',
              'muted',
              'subtle',
              'border',
              'scrollbar',
              'selection',
              'selectionText',
              'search',
              'searchActive',
              'searchText',
              'syntax',
              'terminal',
            ],
          },
          TerminalColor: {
            description:
              "Terminal colors retain the user's ANSI palette and default background.\nNumeric values are RGB; named values are emitted as terminal attributes.",
            anyOf: [
              {
                type: 'integer',
                format: 'uint32',
                minimum: 0,
                maximum: 16777215,
              },
              {
                $ref: '#/$defs/TerminalNamedColor',
              },
            ],
          },
          TerminalNamedColor: {
            type: 'string',
            enum: [
              'reset',
              'black',
              'red',
              'green',
              'yellow',
              'blue',
              'magenta',
              'cyan',
              'gray',
              'dark_gray',
              'light_red',
              'light_green',
              'light_yellow',
              'light_blue',
              'light_magenta',
              'light_cyan',
              'white',
            ],
          },
          TextAppearance: {
            type: 'object',
            properties: {
              font: {
                $ref: '#/$defs/FontAppearance',
              },
              foreground: {
                $ref: '#/$defs/Color',
              },
            },
            additionalProperties: false,
            required: ['font', 'foreground'],
          },
          FontAppearance: {
            type: 'object',
            properties: {
              family: {
                $ref: '#/$defs/FontFamily',
              },
              fallbacks: {
                type: 'array',
                items: {
                  $ref: '#/$defs/FontFamily',
                },
              },
              size: {
                type: 'number',
                format: 'float',
                minimum: 6,
                maximum: 96,
              },
              lineHeight: {
                description: 'Line height relative to this font size.',
                type: 'number',
                format: 'float',
                minimum: 1,
                maximum: 3,
              },
              weight: {
                type: 'integer',
                format: 'uint16',
                minimum: 1,
                maximum: 1000,
              },
            },
            additionalProperties: false,
            required: ['family', 'fallbacks', 'size', 'lineHeight', 'weight'],
          },
          FontFamily: {
            type: 'string',
            minLength: 1,
          },
          Color: {
            description: 'Packed RGBA, including explicit alpha zero.',
            type: 'integer',
            format: 'uint32',
            minimum: 0,
          },
          Insets: {
            type: 'object',
            properties: {
              top: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 128,
              },
              right: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 128,
              },
              bottom: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 128,
              },
              left: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 128,
              },
            },
            additionalProperties: false,
            required: ['top', 'right', 'bottom', 'left'],
          },
          ScrollbarAppearance: {
            type: 'object',
            properties: {
              mode: {
                $ref: '#/$defs/ScrollbarMode',
              },
              entrance: {
                $ref: '#/$defs/ScrollbarEntrance',
              },
              idleMillis: {
                type: 'integer',
                format: 'uint32',
                minimum: 0,
                maximum: 60000,
              },
              enterMillis: {
                type: 'integer',
                format: 'uint32',
                minimum: 0,
                maximum: 1000,
              },
              exitMillis: {
                type: 'integer',
                format: 'uint32',
                minimum: 0,
                maximum: 1000,
              },
              expandMillis: {
                type: 'integer',
                format: 'uint32',
                minimum: 0,
                maximum: 1000,
              },
              trackWidth: {
                type: 'number',
                format: 'float',
                minimum: 1,
                maximum: 64,
              },
              track: {
                $ref: '#/$defs/Color',
              },
              trackHover: {
                $ref: '#/$defs/Color',
              },
              trackActive: {
                $ref: '#/$defs/Color',
              },
              thumb: {
                $ref: '#/$defs/ScrollbarThumb',
              },
              thumbHover: {
                $ref: '#/$defs/ScrollbarThumb',
              },
              thumbActive: {
                $ref: '#/$defs/ScrollbarThumb',
              },
            },
            additionalProperties: false,
            required: [
              'mode',
              'entrance',
              'idleMillis',
              'enterMillis',
              'exitMillis',
              'expandMillis',
              'trackWidth',
              'track',
              'trackHover',
              'trackActive',
              'thumb',
              'thumbHover',
              'thumbActive',
            ],
          },
          ScrollbarMode: {
            type: 'string',
            enum: ['scrolling', 'hover', 'always'],
          },
          ScrollbarEntrance: {
            type: 'string',
            enum: ['fade', 'slide_and_fade'],
          },
          ScrollbarThumb: {
            type: 'object',
            properties: {
              color: {
                $ref: '#/$defs/Color',
              },
              width: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 64,
              },
              inset: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 64,
              },
              radius: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 32,
              },
              minLength: {
                type: 'number',
                format: 'float',
                minimum: 1,
                maximum: 4096,
              },
            },
            additionalProperties: false,
            required: ['color', 'width', 'inset', 'radius', 'minLength'],
          },
          TextareaMenu: {
            description:
              'Local presentation for user-initiated native editing actions. This is not\na command interface: clipboard access still requires native activation.',
            type: 'object',
            properties: {
              appearance: {
                $ref: '#/$defs/MenuAppearance',
              },
              labels: {
                $ref: '#/$defs/TextareaMenuLabels',
              },
            },
            additionalProperties: false,
            required: ['appearance', 'labels'],
          },
          MenuAppearance: {
            type: 'object',
            properties: {
              text: {
                $ref: '#/$defs/TextAppearance',
              },
              background: {
                $ref: '#/$defs/Color',
              },
              border: {
                $ref: '#/$defs/Color',
              },
              activeBackground: {
                $ref: '#/$defs/Color',
              },
              activeForeground: {
                $ref: '#/$defs/Color',
              },
              disabledForeground: {
                $ref: '#/$defs/Color',
              },
              borderWidth: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 8,
              },
              radius: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 64,
              },
              padding: {
                $ref: '#/$defs/Insets',
              },
              rowPadding: {
                $ref: '#/$defs/Insets',
              },
              width: {
                type: 'number',
                format: 'float',
                minimum: 32,
                maximum: 1024,
              },
              windowMargin: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 128,
              },
            },
            additionalProperties: false,
            required: [
              'text',
              'background',
              'border',
              'activeBackground',
              'activeForeground',
              'disabledForeground',
              'borderWidth',
              'radius',
              'padding',
              'rowPadding',
              'width',
              'windowMargin',
            ],
          },
          TextareaMenuLabels: {
            type: 'object',
            properties: {
              title: {
                type: 'string',
                minLength: 1,
              },
              undo: {
                type: 'string',
                minLength: 1,
              },
              redo: {
                type: 'string',
                minLength: 1,
              },
              cut: {
                type: 'string',
                minLength: 1,
              },
              copy: {
                type: 'string',
                minLength: 1,
              },
              paste: {
                type: 'string',
                minLength: 1,
              },
              selectAll: {
                type: 'string',
                minLength: 1,
              },
            },
            additionalProperties: false,
            required: ['title', 'undo', 'redo', 'cut', 'copy', 'paste', 'selectAll'],
          },
          TerminalTextareaRows: {
            type: 'object',
            properties: {
              min: {
                type: 'integer',
                format: 'uint16',
                minimum: 1,
                maximum: 65535,
              },
              max: {
                type: 'integer',
                format: 'uint16',
                minimum: 1,
                maximum: 65535,
              },
              resizable: {
                description:
                  'Allow dragging the lower-right grip to override preferred rows, up to\nthe containing viewport height. The minimum still applies.',
                type: 'boolean',
                default: false,
              },
              maxViewportFraction: {
                description:
                  "Optional cap relative to the nearest declared layout viewport's height,\nor the surface when none is declared. The minimum still applies.",
                type: ['number', 'null'],
                format: 'double',
                minimum: 0,
                maximum: 1,
                default: null,
              },
            },
            additionalProperties: false,
            required: ['min', 'max'],
          },
          SubmitKey: {
            description:
              'Product-selected native submit gesture. PrimaryEnter uses the platform\nControl+Enter gesture in a terminal.',
            type: 'string',
            enum: ['enter', 'primary_enter', 'control_enter'],
          },
          EditorNavigation: {
            type: 'object',
            properties: {
              owner: {
                type: 'string',
                minLength: 1,
              },
              basedOn: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
                maximum: 9007199254740991,
              },
            },
            additionalProperties: false,
            required: ['owner', 'basedOn'],
          },
          EditorCommand: {
            type: 'object',
            properties: {
              owner: {
                description: 'Correlation with the original native editor, never a resource grant.',
                type: 'string',
                minLength: 1,
              },
              sequence: {
                type: 'integer',
                format: 'uint64',
                minimum: 1,
                maximum: 9007199254740991,
              },
              basedOn: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
                maximum: 9007199254740991,
              },
              edit: {
                $ref: '#/$defs/EditorEdit',
              },
            },
            additionalProperties: false,
            required: ['owner', 'sequence', 'basedOn', 'edit'],
          },
          EditorEdit: {
            oneOf: [
              {
                description:
                  'Replace a UTF-16 range in the current revision, preserving its suffix.',
                type: 'object',
                properties: {
                  range: {
                    $ref: '#/$defs/TextRange',
                  },
                  text: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'replace_range',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'range', 'text'],
              },
              {
                type: 'object',
                properties: {
                  text: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'replace',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'text'],
              },
              {
                type: 'object',
                properties: {
                  text: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'reset',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'text'],
              },
              {
                description:
                  'Continue initialization after Reset, without creating undo history.\nThe same native owner retains the complete buffer.',
                type: 'object',
                properties: {
                  text: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'append',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'text'],
              },
            ],
          },
          TextRange: {
            description: 'Ordered UTF-16 code-unit offsets, shared by selections and range edits.',
            type: 'object',
            properties: {
              start: {
                type: 'integer',
                format: 'uint',
                minimum: 0,
              },
              end: {
                type: 'integer',
                format: 'uint',
                minimum: 0,
              },
            },
            additionalProperties: false,
            required: ['start', 'end'],
          },
          FilePastePolicy: {
            type: 'object',
            properties: {
              context: {
                type: 'string',
                minLength: 1,
              },
              allowFiles: {
                description: 'Clipboard text remains available when file attachments are disabled.',
                type: 'boolean',
              },
            },
            additionalProperties: false,
            required: ['context', 'allowFiles'],
          },
          FilePasteCommand: {
            type: 'object',
            properties: {
              selection: {
                $ref: '#/$defs/FileCapture',
              },
              action: {
                $ref: '#/$defs/FilePasteAction',
              },
            },
            additionalProperties: false,
            required: ['selection', 'action'],
          },
          FileCapture: {
            type: 'object',
            properties: {
              owner: {
                type: 'string',
                minLength: 1,
              },
              revision: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
            },
            additionalProperties: false,
            required: ['owner', 'revision'],
          },
          FilePasteAction: {
            oneOf: [
              {
                description:
                  'Release this ready/failed item and continue the original physical paste.',
                type: 'string',
                const: 'next',
              },
              {
                description: 'Retry the original failed path, without a new path from the guest.',
                type: 'string',
                const: 'retry',
              },
              {
                description:
                  'Discard this batch; already captured resources retain their own custody.',
                type: 'string',
                const: 'cancel',
              },
            ],
          },
          EditorPersistence: {
            type: 'object',
            properties: {
              key: {
                type: 'string',
                minLength: 1,
              },
              format: {
                type: 'string',
                minLength: 1,
              },
              dataSource: true,
              metadata: true,
              restore: {
                anyOf: [
                  {
                    $ref: '#/$defs/EditorRestoration',
                  },
                  {
                    type: 'null',
                  },
                ],
                default: null,
              },
              retry: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
                maximum: 9007199254740991,
                default: 0,
              },
            },
            additionalProperties: false,
            required: ['key', 'format', 'dataSource', 'metadata'],
          },
          EditorRestoration: {
            type: 'object',
            properties: {
              owner: {
                type: 'string',
                minLength: 1,
              },
              version: {
                type: 'integer',
                format: 'uint64',
                minimum: 1,
                maximum: 9007199254740991,
              },
              clearText: {
                type: 'boolean',
              },
            },
            additionalProperties: false,
            required: ['owner', 'version', 'clearText'],
          },
        },
      },
      events: {
        changed: {
          $schema: 'https://json-schema.org/draft/2020-12/schema',
          title: 'EditorObservation',
          type: 'object',
          properties: {
            revision: {
              type: 'integer',
              format: 'uint64',
              minimum: 0,
            },
            snapshot: {
              $ref: '#/$defs/EditorSnapshot',
            },
            receipt: {
              anyOf: [
                {
                  $ref: '#/$defs/EditorReceipt',
                },
                {
                  type: 'null',
                },
              ],
            },
          },
          additionalProperties: false,
          required: ['revision', 'snapshot', 'receipt'],
          $defs: {
            EditorSnapshot: {
              type: 'object',
              properties: {
                text: {
                  $ref: '#/$defs/EditorTextRef',
                },
                selection: {
                  $ref: '#/$defs/TextRange',
                },
                reversed: {
                  type: 'boolean',
                },
                marked: {
                  anyOf: [
                    {
                      $ref: '#/$defs/TextRange',
                    },
                    {
                      type: 'null',
                    },
                  ],
                },
              },
              additionalProperties: false,
              required: ['text', 'selection', 'reversed', 'marked'],
            },
            EditorTextRef: {
              type: 'object',
              properties: {
                owner: {
                  type: 'string',
                },
                revision: {
                  type: 'integer',
                  format: 'uint64',
                  minimum: 0,
                },
                bytes: {
                  type: 'integer',
                  format: 'uint',
                  minimum: 0,
                },
              },
              additionalProperties: false,
              required: ['owner', 'revision', 'bytes'],
            },
            TextRange: {
              description:
                'Ordered UTF-16 code-unit offsets, shared by selections and range edits.',
              type: 'object',
              properties: {
                start: {
                  type: 'integer',
                  format: 'uint',
                  minimum: 0,
                },
                end: {
                  type: 'integer',
                  format: 'uint',
                  minimum: 0,
                },
              },
              additionalProperties: false,
              required: ['start', 'end'],
            },
            EditorReceipt: {
              type: 'object',
              properties: {
                owner: {
                  type: 'string',
                },
                sequence: {
                  type: 'integer',
                  format: 'uint64',
                  minimum: 0,
                },
                revision: {
                  type: 'integer',
                  format: 'uint64',
                  minimum: 0,
                },
                outcome: {
                  $ref: '#/$defs/EditorOutcome',
                },
              },
              additionalProperties: false,
              required: ['owner', 'sequence', 'revision', 'outcome'],
            },
            EditorOutcome: {
              oneOf: [
                {
                  type: 'object',
                  properties: {
                    status: {
                      type: 'string',
                      const: 'applied',
                    },
                  },
                  required: ['status'],
                  additionalProperties: false,
                },
                {
                  type: 'object',
                  properties: {
                    reason: {
                      $ref: '#/$defs/EditorConflict',
                    },
                    status: {
                      type: 'string',
                      const: 'conflict',
                    },
                  },
                  additionalProperties: false,
                  required: ['status', 'reason'],
                },
              ],
            },
            EditorConflict: {
              type: 'string',
              enum: [
                'persistence',
                'owner',
                'representation',
                'revision',
                'composition',
                'sequence',
              ],
            },
          },
        },
        checkpoint: {
          $schema: 'https://json-schema.org/draft/2020-12/schema',
          title: 'EditorCheckpointObservation',
          type: 'object',
          properties: {
            owner: {
              type: 'string',
            },
            state: {
              $ref: '#/$defs/EditorCheckpointState',
            },
          },
          additionalProperties: false,
          required: ['owner', 'state'],
          $defs: {
            EditorCheckpointState: {
              oneOf: [
                {
                  type: 'object',
                  properties: {
                    kind: {
                      type: 'string',
                      const: 'loading',
                    },
                  },
                  required: ['kind'],
                  additionalProperties: false,
                },
                {
                  type: 'object',
                  properties: {
                    version: {
                      type: 'integer',
                      format: 'uint64',
                      minimum: 0,
                    },
                    snapshot: {
                      $ref: '#/$defs/EditorSnapshot',
                    },
                    metadata: true,
                    kind: {
                      type: 'string',
                      const: 'restore',
                    },
                  },
                  additionalProperties: false,
                  required: ['kind', 'version', 'snapshot', 'metadata'],
                },
                {
                  type: 'object',
                  properties: {
                    saved: {
                      type: 'boolean',
                    },
                    initialized: {
                      type: 'boolean',
                    },
                    kind: {
                      type: 'string',
                      const: 'ready',
                    },
                  },
                  additionalProperties: false,
                  required: ['kind', 'saved', 'initialized'],
                },
                {
                  type: 'object',
                  properties: {
                    diagnostic: {
                      type: 'string',
                    },
                    kind: {
                      type: 'string',
                      const: 'failed',
                    },
                  },
                  additionalProperties: false,
                  required: ['kind', 'diagnostic'],
                },
              ],
            },
            EditorSnapshot: {
              type: 'object',
              properties: {
                text: {
                  $ref: '#/$defs/EditorTextRef',
                },
                selection: {
                  $ref: '#/$defs/TextRange',
                },
                reversed: {
                  type: 'boolean',
                },
                marked: {
                  anyOf: [
                    {
                      $ref: '#/$defs/TextRange',
                    },
                    {
                      type: 'null',
                    },
                  ],
                },
              },
              additionalProperties: false,
              required: ['text', 'selection', 'reversed', 'marked'],
            },
            EditorTextRef: {
              type: 'object',
              properties: {
                owner: {
                  type: 'string',
                },
                revision: {
                  type: 'integer',
                  format: 'uint64',
                  minimum: 0,
                },
                bytes: {
                  type: 'integer',
                  format: 'uint',
                  minimum: 0,
                },
              },
              additionalProperties: false,
              required: ['owner', 'revision', 'bytes'],
            },
            TextRange: {
              description:
                'Ordered UTF-16 code-unit offsets, shared by selections and range edits.',
              type: 'object',
              properties: {
                start: {
                  type: 'integer',
                  format: 'uint',
                  minimum: 0,
                },
                end: {
                  type: 'integer',
                  format: 'uint',
                  minimum: 0,
                },
              },
              additionalProperties: false,
              required: ['start', 'end'],
            },
          },
        },
        files: {
          $schema: 'https://json-schema.org/draft/2020-12/schema',
          title: 'FilePasteObservation',
          type: 'object',
          properties: {
            context: {
              type: 'string',
              minLength: 1,
            },
            selection: {
              $ref: '#/$defs/FileObservation',
            },
            remaining: {
              description: 'Includes the currently reading, ready or failed item.',
              type: 'integer',
              format: 'uint',
              minimum: 0,
            },
            retryable: {
              description:
                'A failed original path can be reread. Clipboard reads require a new gesture.',
              type: 'boolean',
            },
          },
          additionalProperties: false,
          required: ['context', 'selection', 'remaining', 'retryable'],
          $defs: {
            FileObservation: {
              type: 'object',
              properties: {
                owner: {
                  type: 'string',
                  minLength: 1,
                },
                revision: {
                  type: 'integer',
                  format: 'uint64',
                  minimum: 0,
                },
                phase: {
                  $ref: '#/$defs/FilePhase',
                },
                file: {
                  anyOf: [
                    {
                      $ref: '#/$defs/FileDescriptor',
                    },
                    {
                      type: 'null',
                    },
                  ],
                },
                error: {
                  anyOf: [
                    {
                      $ref: '#/$defs/FileError',
                    },
                    {
                      type: 'null',
                    },
                  ],
                },
              },
              additionalProperties: false,
              required: ['owner', 'revision', 'phase'],
            },
            FilePhase: {
              type: 'string',
              enum: ['empty', 'choosing', 'ready', 'failed'],
            },
            FileDescriptor: {
              type: 'object',
              properties: {
                name: {
                  type: 'string',
                },
                bytes: {
                  type: 'integer',
                  format: 'uint',
                  minimum: 0,
                },
                digest: {
                  type: 'string',
                  minLength: 71,
                  maxLength: 71,
                },
              },
              additionalProperties: false,
              required: ['name', 'bytes', 'digest'],
            },
            FileError: {
              type: 'string',
              enum: [
                'invalid_file',
                'read_failed',
                'limit_exceeded',
                'budget_exhausted',
                'worker_failed',
                'clipboard_unavailable',
                'paste_rejected',
              ],
            },
          },
        },
        navigated: {
          $schema: 'https://json-schema.org/draft/2020-12/schema',
          title: 'EditorNavigated',
          type: 'object',
          properties: {
            key: {
              $ref: '#/$defs/EditorNavigationKey',
            },
            observation: {
              $ref: '#/$defs/EditorObservation',
            },
          },
          additionalProperties: false,
          required: ['key', 'observation'],
          $defs: {
            EditorNavigationKey: {
              type: 'string',
              enum: ['up', 'down', 'enter', 'tab', 'escape'],
            },
            EditorObservation: {
              type: 'object',
              properties: {
                revision: {
                  type: 'integer',
                  format: 'uint64',
                  minimum: 0,
                },
                snapshot: {
                  $ref: '#/$defs/EditorSnapshot',
                },
                receipt: {
                  anyOf: [
                    {
                      $ref: '#/$defs/EditorReceipt',
                    },
                    {
                      type: 'null',
                    },
                  ],
                },
              },
              additionalProperties: false,
              required: ['revision', 'snapshot', 'receipt'],
            },
            EditorSnapshot: {
              type: 'object',
              properties: {
                text: {
                  $ref: '#/$defs/EditorTextRef',
                },
                selection: {
                  $ref: '#/$defs/TextRange',
                },
                reversed: {
                  type: 'boolean',
                },
                marked: {
                  anyOf: [
                    {
                      $ref: '#/$defs/TextRange',
                    },
                    {
                      type: 'null',
                    },
                  ],
                },
              },
              additionalProperties: false,
              required: ['text', 'selection', 'reversed', 'marked'],
            },
            EditorTextRef: {
              type: 'object',
              properties: {
                owner: {
                  type: 'string',
                },
                revision: {
                  type: 'integer',
                  format: 'uint64',
                  minimum: 0,
                },
                bytes: {
                  type: 'integer',
                  format: 'uint',
                  minimum: 0,
                },
              },
              additionalProperties: false,
              required: ['owner', 'revision', 'bytes'],
            },
            TextRange: {
              description:
                'Ordered UTF-16 code-unit offsets, shared by selections and range edits.',
              type: 'object',
              properties: {
                start: {
                  type: 'integer',
                  format: 'uint',
                  minimum: 0,
                },
                end: {
                  type: 'integer',
                  format: 'uint',
                  minimum: 0,
                },
              },
              additionalProperties: false,
              required: ['start', 'end'],
            },
            EditorReceipt: {
              type: 'object',
              properties: {
                owner: {
                  type: 'string',
                },
                sequence: {
                  type: 'integer',
                  format: 'uint64',
                  minimum: 0,
                },
                revision: {
                  type: 'integer',
                  format: 'uint64',
                  minimum: 0,
                },
                outcome: {
                  $ref: '#/$defs/EditorOutcome',
                },
              },
              additionalProperties: false,
              required: ['owner', 'sequence', 'revision', 'outcome'],
            },
            EditorOutcome: {
              oneOf: [
                {
                  type: 'object',
                  properties: {
                    status: {
                      type: 'string',
                      const: 'applied',
                    },
                  },
                  required: ['status'],
                  additionalProperties: false,
                },
                {
                  type: 'object',
                  properties: {
                    reason: {
                      $ref: '#/$defs/EditorConflict',
                    },
                    status: {
                      type: 'string',
                      const: 'conflict',
                    },
                  },
                  additionalProperties: false,
                  required: ['status', 'reason'],
                },
              ],
            },
            EditorConflict: {
              type: 'string',
              enum: [
                'persistence',
                'owner',
                'representation',
                'revision',
                'composition',
                'sequence',
              ],
            },
          },
        },
        submitted: {
          $schema: 'https://json-schema.org/draft/2020-12/schema',
          title: 'EditorObservation',
          type: 'object',
          properties: {
            revision: {
              type: 'integer',
              format: 'uint64',
              minimum: 0,
            },
            snapshot: {
              $ref: '#/$defs/EditorSnapshot',
            },
            receipt: {
              anyOf: [
                {
                  $ref: '#/$defs/EditorReceipt',
                },
                {
                  type: 'null',
                },
              ],
            },
          },
          additionalProperties: false,
          required: ['revision', 'snapshot', 'receipt'],
          $defs: {
            EditorSnapshot: {
              type: 'object',
              properties: {
                text: {
                  $ref: '#/$defs/EditorTextRef',
                },
                selection: {
                  $ref: '#/$defs/TextRange',
                },
                reversed: {
                  type: 'boolean',
                },
                marked: {
                  anyOf: [
                    {
                      $ref: '#/$defs/TextRange',
                    },
                    {
                      type: 'null',
                    },
                  ],
                },
              },
              additionalProperties: false,
              required: ['text', 'selection', 'reversed', 'marked'],
            },
            EditorTextRef: {
              type: 'object',
              properties: {
                owner: {
                  type: 'string',
                },
                revision: {
                  type: 'integer',
                  format: 'uint64',
                  minimum: 0,
                },
                bytes: {
                  type: 'integer',
                  format: 'uint',
                  minimum: 0,
                },
              },
              additionalProperties: false,
              required: ['owner', 'revision', 'bytes'],
            },
            TextRange: {
              description:
                'Ordered UTF-16 code-unit offsets, shared by selections and range edits.',
              type: 'object',
              properties: {
                start: {
                  type: 'integer',
                  format: 'uint',
                  minimum: 0,
                },
                end: {
                  type: 'integer',
                  format: 'uint',
                  minimum: 0,
                },
              },
              additionalProperties: false,
              required: ['start', 'end'],
            },
            EditorReceipt: {
              type: 'object',
              properties: {
                owner: {
                  type: 'string',
                },
                sequence: {
                  type: 'integer',
                  format: 'uint64',
                  minimum: 0,
                },
                revision: {
                  type: 'integer',
                  format: 'uint64',
                  minimum: 0,
                },
                outcome: {
                  $ref: '#/$defs/EditorOutcome',
                },
              },
              additionalProperties: false,
              required: ['owner', 'sequence', 'revision', 'outcome'],
            },
            EditorOutcome: {
              oneOf: [
                {
                  type: 'object',
                  properties: {
                    status: {
                      type: 'string',
                      const: 'applied',
                    },
                  },
                  required: ['status'],
                  additionalProperties: false,
                },
                {
                  type: 'object',
                  properties: {
                    reason: {
                      $ref: '#/$defs/EditorConflict',
                    },
                    status: {
                      type: 'string',
                      const: 'conflict',
                    },
                  },
                  additionalProperties: false,
                  required: ['status', 'reason'],
                },
              ],
            },
            EditorConflict: {
              type: 'string',
              enum: [
                'persistence',
                'owner',
                'representation',
                'revision',
                'composition',
                'sequence',
              ],
            },
          },
        },
      },
      captures: {
        file: {
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'FileCapture',
            type: 'object',
            properties: {
              owner: {
                type: 'string',
                minLength: 1,
              },
              revision: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
            },
            additionalProperties: false,
            required: ['owner', 'revision'],
          },
          output: {
            kind: 'resource',
            resource: {
              name: 'maka.bytes',
              version: 1,
            },
          },
        },
        snapshot: {
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'EditorCapture',
            oneOf: [
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'current',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  owner: {
                    type: 'string',
                    minLength: 1,
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'at_revision',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'owner', 'revision'],
              },
            ],
          },
          output: {
            kind: 'resource',
            resource: {
              name: 'maka.text.utf8',
              version: 1,
            },
          },
        },
      },
    },
  },
  textInput: {
    name: 'maka.ui.TextInput',
    version: 1,
    transport: 'local',
    interface: {
      kind: 'component',
      props: {
        $schema: 'https://json-schema.org/draft/2020-12/schema',
        title: 'InputProps',
        type: 'object',
        properties: {
          appearance: {
            $ref: '#/$defs/InputAppearance',
          },
          menu: {
            anyOf: [
              {
                $ref: '#/$defs/TextareaMenu',
              },
              {
                type: 'null',
              },
            ],
            default: null,
          },
          accessibilityLabel: {
            type: 'string',
            minLength: 1,
          },
          readOnly: {
            type: 'boolean',
          },
          disabled: {
            type: 'boolean',
          },
          tabIndex: {
            type: 'integer',
            format: 'int16',
            minimum: -1,
            maximum: 32767,
          },
          autoFocus: {
            description:
              'Offer native focus once when this original input becomes visible and\nenabled. Stable updates and viewport scrolling do not repeat the offer.',
            type: 'boolean',
            default: false,
          },
          maxBytes: {
            description: 'UTF-8 byte capacity, fixed for this original native editor mount.',
            type: 'integer',
            format: 'uint32',
            minimum: 1,
            default: 65536,
          },
          terminalPaste: {
            description: 'Terminal bracketed-paste policy. Other native insertion remains literal.',
            $ref: '#/$defs/TerminalPaste',
            default: 'reject_controls',
          },
          placeholder: {
            type: 'string',
            default: '',
          },
          command: {
            anyOf: [
              {
                $ref: '#/$defs/EditorCommand',
              },
              {
                type: 'null',
              },
            ],
            default: null,
          },
          submitCopy: {
            description:
              'Clipboard default for physical Enter at this original editor revision.\nProgrammatic submitted events never execute this native default.',
            anyOf: [
              {
                $ref: '#/$defs/SubmitCopy',
              },
              {
                type: 'null',
              },
            ],
            default: null,
          },
        },
        additionalProperties: false,
        required: ['appearance', 'accessibilityLabel', 'readOnly', 'disabled', 'tabIndex'],
        $defs: {
          InputAppearance: {
            type: 'object',
            properties: {
              ascii: {
                type: 'boolean',
                default: false,
              },
              terminal: {
                anyOf: [
                  {
                    $ref: '#/$defs/TerminalPalette',
                  },
                  {
                    type: 'null',
                  },
                ],
                default: null,
              },
              text: {
                $ref: '#/$defs/TextAppearance',
              },
              mutedForeground: {
                $ref: '#/$defs/Color',
              },
              background: {
                $ref: '#/$defs/Color',
              },
              selection: {
                $ref: '#/$defs/Color',
              },
              caret: {
                $ref: '#/$defs/Color',
              },
              border: {
                $ref: '#/$defs/Color',
              },
              focusedBorder: {
                $ref: '#/$defs/Color',
              },
              borderWidth: {
                description:
                  'In TUI inputs, a positive width draws a one-cell border; zero has no inset.',
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 8,
              },
              radius: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 64,
              },
              padding: {
                $ref: '#/$defs/Insets',
              },
            },
            additionalProperties: false,
            required: [
              'text',
              'mutedForeground',
              'background',
              'selection',
              'caret',
              'border',
              'focusedBorder',
              'borderWidth',
              'radius',
              'padding',
            ],
          },
          TerminalPalette: {
            description:
              'Semantic terminal colors for rich text and editors, supplied by the product.',
            type: 'object',
            properties: {
              background: {
                $ref: '#/$defs/TerminalColor',
              },
              foreground: {
                $ref: '#/$defs/TerminalColor',
              },
              surface: {
                $ref: '#/$defs/TerminalColor',
              },
              accent: {
                $ref: '#/$defs/TerminalColor',
              },
              thinking: {
                $ref: '#/$defs/TerminalColor',
              },
              success: {
                $ref: '#/$defs/TerminalColor',
              },
              warning: {
                $ref: '#/$defs/TerminalColor',
              },
              error: {
                $ref: '#/$defs/TerminalColor',
              },
              muted: {
                $ref: '#/$defs/TerminalColor',
              },
              subtle: {
                $ref: '#/$defs/TerminalColor',
              },
              border: {
                $ref: '#/$defs/TerminalColor',
              },
              scrollbar: {
                $ref: '#/$defs/TerminalColor',
              },
              selection: {
                $ref: '#/$defs/TerminalColor',
              },
              selectionText: {
                $ref: '#/$defs/TerminalColor',
              },
              search: {
                $ref: '#/$defs/TerminalColor',
              },
              searchActive: {
                $ref: '#/$defs/TerminalColor',
              },
              searchText: {
                $ref: '#/$defs/TerminalColor',
              },
              syntax: {
                type: 'array',
                items: {
                  $ref: '#/$defs/TerminalColor',
                },
                minItems: 7,
                maxItems: 7,
              },
              terminal: {
                type: 'boolean',
              },
            },
            additionalProperties: false,
            required: [
              'background',
              'foreground',
              'surface',
              'accent',
              'thinking',
              'success',
              'warning',
              'error',
              'muted',
              'subtle',
              'border',
              'scrollbar',
              'selection',
              'selectionText',
              'search',
              'searchActive',
              'searchText',
              'syntax',
              'terminal',
            ],
          },
          TerminalColor: {
            description:
              "Terminal colors retain the user's ANSI palette and default background.\nNumeric values are RGB; named values are emitted as terminal attributes.",
            anyOf: [
              {
                type: 'integer',
                format: 'uint32',
                minimum: 0,
                maximum: 16777215,
              },
              {
                $ref: '#/$defs/TerminalNamedColor',
              },
            ],
          },
          TerminalNamedColor: {
            type: 'string',
            enum: [
              'reset',
              'black',
              'red',
              'green',
              'yellow',
              'blue',
              'magenta',
              'cyan',
              'gray',
              'dark_gray',
              'light_red',
              'light_green',
              'light_yellow',
              'light_blue',
              'light_magenta',
              'light_cyan',
              'white',
            ],
          },
          TextAppearance: {
            type: 'object',
            properties: {
              font: {
                $ref: '#/$defs/FontAppearance',
              },
              foreground: {
                $ref: '#/$defs/Color',
              },
            },
            additionalProperties: false,
            required: ['font', 'foreground'],
          },
          FontAppearance: {
            type: 'object',
            properties: {
              family: {
                $ref: '#/$defs/FontFamily',
              },
              fallbacks: {
                type: 'array',
                items: {
                  $ref: '#/$defs/FontFamily',
                },
              },
              size: {
                type: 'number',
                format: 'float',
                minimum: 6,
                maximum: 96,
              },
              lineHeight: {
                description: 'Line height relative to this font size.',
                type: 'number',
                format: 'float',
                minimum: 1,
                maximum: 3,
              },
              weight: {
                type: 'integer',
                format: 'uint16',
                minimum: 1,
                maximum: 1000,
              },
            },
            additionalProperties: false,
            required: ['family', 'fallbacks', 'size', 'lineHeight', 'weight'],
          },
          FontFamily: {
            type: 'string',
            minLength: 1,
          },
          Color: {
            description: 'Packed RGBA, including explicit alpha zero.',
            type: 'integer',
            format: 'uint32',
            minimum: 0,
          },
          Insets: {
            type: 'object',
            properties: {
              top: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 128,
              },
              right: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 128,
              },
              bottom: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 128,
              },
              left: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 128,
              },
            },
            additionalProperties: false,
            required: ['top', 'right', 'bottom', 'left'],
          },
          TextareaMenu: {
            description:
              'Local presentation for user-initiated native editing actions. This is not\na command interface: clipboard access still requires native activation.',
            type: 'object',
            properties: {
              appearance: {
                $ref: '#/$defs/MenuAppearance',
              },
              labels: {
                $ref: '#/$defs/TextareaMenuLabels',
              },
            },
            additionalProperties: false,
            required: ['appearance', 'labels'],
          },
          MenuAppearance: {
            type: 'object',
            properties: {
              text: {
                $ref: '#/$defs/TextAppearance',
              },
              background: {
                $ref: '#/$defs/Color',
              },
              border: {
                $ref: '#/$defs/Color',
              },
              activeBackground: {
                $ref: '#/$defs/Color',
              },
              activeForeground: {
                $ref: '#/$defs/Color',
              },
              disabledForeground: {
                $ref: '#/$defs/Color',
              },
              borderWidth: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 8,
              },
              radius: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 64,
              },
              padding: {
                $ref: '#/$defs/Insets',
              },
              rowPadding: {
                $ref: '#/$defs/Insets',
              },
              width: {
                type: 'number',
                format: 'float',
                minimum: 32,
                maximum: 1024,
              },
              windowMargin: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 128,
              },
            },
            additionalProperties: false,
            required: [
              'text',
              'background',
              'border',
              'activeBackground',
              'activeForeground',
              'disabledForeground',
              'borderWidth',
              'radius',
              'padding',
              'rowPadding',
              'width',
              'windowMargin',
            ],
          },
          TextareaMenuLabels: {
            type: 'object',
            properties: {
              title: {
                type: 'string',
                minLength: 1,
              },
              undo: {
                type: 'string',
                minLength: 1,
              },
              redo: {
                type: 'string',
                minLength: 1,
              },
              cut: {
                type: 'string',
                minLength: 1,
              },
              copy: {
                type: 'string',
                minLength: 1,
              },
              paste: {
                type: 'string',
                minLength: 1,
              },
              selectAll: {
                type: 'string',
                minLength: 1,
              },
            },
            additionalProperties: false,
            required: ['title', 'undo', 'redo', 'cut', 'copy', 'paste', 'selectAll'],
          },
          TerminalPaste: {
            type: 'string',
            enum: ['reject_controls', 'spaces'],
          },
          EditorCommand: {
            type: 'object',
            properties: {
              owner: {
                description: 'Correlation with the original native editor, never a resource grant.',
                type: 'string',
                minLength: 1,
              },
              sequence: {
                type: 'integer',
                format: 'uint64',
                minimum: 1,
                maximum: 9007199254740991,
              },
              basedOn: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
                maximum: 9007199254740991,
              },
              edit: {
                $ref: '#/$defs/EditorEdit',
              },
            },
            additionalProperties: false,
            required: ['owner', 'sequence', 'basedOn', 'edit'],
          },
          EditorEdit: {
            oneOf: [
              {
                description:
                  'Replace a UTF-16 range in the current revision, preserving its suffix.',
                type: 'object',
                properties: {
                  range: {
                    $ref: '#/$defs/TextRange',
                  },
                  text: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'replace_range',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'range', 'text'],
              },
              {
                type: 'object',
                properties: {
                  text: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'replace',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'text'],
              },
              {
                type: 'object',
                properties: {
                  text: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'reset',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'text'],
              },
              {
                description:
                  'Continue initialization after Reset, without creating undo history.\nThe same native owner retains the complete buffer.',
                type: 'object',
                properties: {
                  text: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'append',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'text'],
              },
            ],
          },
          TextRange: {
            description: 'Ordered UTF-16 code-unit offsets, shared by selections and range edits.',
            type: 'object',
            properties: {
              start: {
                type: 'integer',
                format: 'uint',
                minimum: 0,
              },
              end: {
                type: 'integer',
                format: 'uint',
                minimum: 0,
              },
            },
            additionalProperties: false,
            required: ['start', 'end'],
          },
          SubmitCopy: {
            type: 'object',
            properties: {
              basis: {
                $ref: '#/$defs/EditorTextRef',
              },
              text: {
                type: 'string',
                minLength: 1,
              },
            },
            additionalProperties: false,
            required: ['basis', 'text'],
          },
          EditorTextRef: {
            type: 'object',
            properties: {
              owner: {
                type: 'string',
              },
              revision: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
              bytes: {
                type: 'integer',
                format: 'uint',
                minimum: 0,
              },
            },
            additionalProperties: false,
            required: ['owner', 'revision', 'bytes'],
          },
        },
      },
      events: {
        changed: {
          $schema: 'https://json-schema.org/draft/2020-12/schema',
          title: 'EditorObservation',
          type: 'object',
          properties: {
            revision: {
              type: 'integer',
              format: 'uint64',
              minimum: 0,
            },
            snapshot: {
              $ref: '#/$defs/EditorSnapshot',
            },
            receipt: {
              anyOf: [
                {
                  $ref: '#/$defs/EditorReceipt',
                },
                {
                  type: 'null',
                },
              ],
            },
          },
          additionalProperties: false,
          required: ['revision', 'snapshot', 'receipt'],
          $defs: {
            EditorSnapshot: {
              type: 'object',
              properties: {
                text: {
                  $ref: '#/$defs/EditorTextRef',
                },
                selection: {
                  $ref: '#/$defs/TextRange',
                },
                reversed: {
                  type: 'boolean',
                },
                marked: {
                  anyOf: [
                    {
                      $ref: '#/$defs/TextRange',
                    },
                    {
                      type: 'null',
                    },
                  ],
                },
              },
              additionalProperties: false,
              required: ['text', 'selection', 'reversed', 'marked'],
            },
            EditorTextRef: {
              type: 'object',
              properties: {
                owner: {
                  type: 'string',
                },
                revision: {
                  type: 'integer',
                  format: 'uint64',
                  minimum: 0,
                },
                bytes: {
                  type: 'integer',
                  format: 'uint',
                  minimum: 0,
                },
              },
              additionalProperties: false,
              required: ['owner', 'revision', 'bytes'],
            },
            TextRange: {
              description:
                'Ordered UTF-16 code-unit offsets, shared by selections and range edits.',
              type: 'object',
              properties: {
                start: {
                  type: 'integer',
                  format: 'uint',
                  minimum: 0,
                },
                end: {
                  type: 'integer',
                  format: 'uint',
                  minimum: 0,
                },
              },
              additionalProperties: false,
              required: ['start', 'end'],
            },
            EditorReceipt: {
              type: 'object',
              properties: {
                owner: {
                  type: 'string',
                },
                sequence: {
                  type: 'integer',
                  format: 'uint64',
                  minimum: 0,
                },
                revision: {
                  type: 'integer',
                  format: 'uint64',
                  minimum: 0,
                },
                outcome: {
                  $ref: '#/$defs/EditorOutcome',
                },
              },
              additionalProperties: false,
              required: ['owner', 'sequence', 'revision', 'outcome'],
            },
            EditorOutcome: {
              oneOf: [
                {
                  type: 'object',
                  properties: {
                    status: {
                      type: 'string',
                      const: 'applied',
                    },
                  },
                  required: ['status'],
                  additionalProperties: false,
                },
                {
                  type: 'object',
                  properties: {
                    reason: {
                      $ref: '#/$defs/EditorConflict',
                    },
                    status: {
                      type: 'string',
                      const: 'conflict',
                    },
                  },
                  additionalProperties: false,
                  required: ['status', 'reason'],
                },
              ],
            },
            EditorConflict: {
              type: 'string',
              enum: [
                'persistence',
                'owner',
                'representation',
                'revision',
                'composition',
                'sequence',
              ],
            },
          },
        },
        submitted: {
          type: 'object',
          additionalProperties: false,
          properties: {},
        },
      },
      captures: {
        snapshot: {
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'EditorCapture',
            oneOf: [
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'current',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  owner: {
                    type: 'string',
                    minLength: 1,
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'at_revision',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'owner', 'revision'],
              },
            ],
          },
          output: {
            kind: 'resource',
            resource: {
              name: 'maka.text.utf8',
              version: 1,
            },
          },
        },
      },
    },
  },
  secretInput: {
    name: 'maka.ui.SecretInput',
    version: 1,
    transport: 'local',
    interface: {
      kind: 'component',
      props: {
        $schema: 'https://json-schema.org/draft/2020-12/schema',
        title: 'InputProps',
        type: 'object',
        properties: {
          appearance: {
            $ref: '#/$defs/InputAppearance',
          },
          menu: {
            anyOf: [
              {
                $ref: '#/$defs/TextareaMenu',
              },
              {
                type: 'null',
              },
            ],
            default: null,
          },
          accessibilityLabel: {
            type: 'string',
            minLength: 1,
          },
          readOnly: {
            type: 'boolean',
          },
          disabled: {
            type: 'boolean',
          },
          tabIndex: {
            type: 'integer',
            format: 'int16',
            minimum: -1,
            maximum: 32767,
          },
          autoFocus: {
            description:
              'Offer native focus once when this original input becomes visible and\nenabled. Stable updates and viewport scrolling do not repeat the offer.',
            type: 'boolean',
            default: false,
          },
          maxBytes: {
            description: 'UTF-8 byte capacity, fixed for this original native editor mount.',
            type: 'integer',
            format: 'uint32',
            minimum: 1,
            default: 65536,
          },
          terminalPaste: {
            description: 'Terminal bracketed-paste policy. Other native insertion remains literal.',
            $ref: '#/$defs/TerminalPaste',
            default: 'reject_controls',
          },
          placeholder: {
            type: 'string',
            default: '',
          },
          command: {
            anyOf: [
              {
                $ref: '#/$defs/EditorCommand',
              },
              {
                type: 'null',
              },
            ],
            default: null,
          },
          submitCopy: {
            description:
              'Clipboard default for physical Enter at this original editor revision.\nProgrammatic submitted events never execute this native default.',
            anyOf: [
              {
                $ref: '#/$defs/SubmitCopy',
              },
              {
                type: 'null',
              },
            ],
            default: null,
          },
        },
        additionalProperties: false,
        required: ['appearance', 'accessibilityLabel', 'readOnly', 'disabled', 'tabIndex'],
        $defs: {
          InputAppearance: {
            type: 'object',
            properties: {
              ascii: {
                type: 'boolean',
                default: false,
              },
              terminal: {
                anyOf: [
                  {
                    $ref: '#/$defs/TerminalPalette',
                  },
                  {
                    type: 'null',
                  },
                ],
                default: null,
              },
              text: {
                $ref: '#/$defs/TextAppearance',
              },
              mutedForeground: {
                $ref: '#/$defs/Color',
              },
              background: {
                $ref: '#/$defs/Color',
              },
              selection: {
                $ref: '#/$defs/Color',
              },
              caret: {
                $ref: '#/$defs/Color',
              },
              border: {
                $ref: '#/$defs/Color',
              },
              focusedBorder: {
                $ref: '#/$defs/Color',
              },
              borderWidth: {
                description:
                  'In TUI inputs, a positive width draws a one-cell border; zero has no inset.',
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 8,
              },
              radius: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 64,
              },
              padding: {
                $ref: '#/$defs/Insets',
              },
            },
            additionalProperties: false,
            required: [
              'text',
              'mutedForeground',
              'background',
              'selection',
              'caret',
              'border',
              'focusedBorder',
              'borderWidth',
              'radius',
              'padding',
            ],
          },
          TerminalPalette: {
            description:
              'Semantic terminal colors for rich text and editors, supplied by the product.',
            type: 'object',
            properties: {
              background: {
                $ref: '#/$defs/TerminalColor',
              },
              foreground: {
                $ref: '#/$defs/TerminalColor',
              },
              surface: {
                $ref: '#/$defs/TerminalColor',
              },
              accent: {
                $ref: '#/$defs/TerminalColor',
              },
              thinking: {
                $ref: '#/$defs/TerminalColor',
              },
              success: {
                $ref: '#/$defs/TerminalColor',
              },
              warning: {
                $ref: '#/$defs/TerminalColor',
              },
              error: {
                $ref: '#/$defs/TerminalColor',
              },
              muted: {
                $ref: '#/$defs/TerminalColor',
              },
              subtle: {
                $ref: '#/$defs/TerminalColor',
              },
              border: {
                $ref: '#/$defs/TerminalColor',
              },
              scrollbar: {
                $ref: '#/$defs/TerminalColor',
              },
              selection: {
                $ref: '#/$defs/TerminalColor',
              },
              selectionText: {
                $ref: '#/$defs/TerminalColor',
              },
              search: {
                $ref: '#/$defs/TerminalColor',
              },
              searchActive: {
                $ref: '#/$defs/TerminalColor',
              },
              searchText: {
                $ref: '#/$defs/TerminalColor',
              },
              syntax: {
                type: 'array',
                items: {
                  $ref: '#/$defs/TerminalColor',
                },
                minItems: 7,
                maxItems: 7,
              },
              terminal: {
                type: 'boolean',
              },
            },
            additionalProperties: false,
            required: [
              'background',
              'foreground',
              'surface',
              'accent',
              'thinking',
              'success',
              'warning',
              'error',
              'muted',
              'subtle',
              'border',
              'scrollbar',
              'selection',
              'selectionText',
              'search',
              'searchActive',
              'searchText',
              'syntax',
              'terminal',
            ],
          },
          TerminalColor: {
            description:
              "Terminal colors retain the user's ANSI palette and default background.\nNumeric values are RGB; named values are emitted as terminal attributes.",
            anyOf: [
              {
                type: 'integer',
                format: 'uint32',
                minimum: 0,
                maximum: 16777215,
              },
              {
                $ref: '#/$defs/TerminalNamedColor',
              },
            ],
          },
          TerminalNamedColor: {
            type: 'string',
            enum: [
              'reset',
              'black',
              'red',
              'green',
              'yellow',
              'blue',
              'magenta',
              'cyan',
              'gray',
              'dark_gray',
              'light_red',
              'light_green',
              'light_yellow',
              'light_blue',
              'light_magenta',
              'light_cyan',
              'white',
            ],
          },
          TextAppearance: {
            type: 'object',
            properties: {
              font: {
                $ref: '#/$defs/FontAppearance',
              },
              foreground: {
                $ref: '#/$defs/Color',
              },
            },
            additionalProperties: false,
            required: ['font', 'foreground'],
          },
          FontAppearance: {
            type: 'object',
            properties: {
              family: {
                $ref: '#/$defs/FontFamily',
              },
              fallbacks: {
                type: 'array',
                items: {
                  $ref: '#/$defs/FontFamily',
                },
              },
              size: {
                type: 'number',
                format: 'float',
                minimum: 6,
                maximum: 96,
              },
              lineHeight: {
                description: 'Line height relative to this font size.',
                type: 'number',
                format: 'float',
                minimum: 1,
                maximum: 3,
              },
              weight: {
                type: 'integer',
                format: 'uint16',
                minimum: 1,
                maximum: 1000,
              },
            },
            additionalProperties: false,
            required: ['family', 'fallbacks', 'size', 'lineHeight', 'weight'],
          },
          FontFamily: {
            type: 'string',
            minLength: 1,
          },
          Color: {
            description: 'Packed RGBA, including explicit alpha zero.',
            type: 'integer',
            format: 'uint32',
            minimum: 0,
          },
          Insets: {
            type: 'object',
            properties: {
              top: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 128,
              },
              right: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 128,
              },
              bottom: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 128,
              },
              left: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 128,
              },
            },
            additionalProperties: false,
            required: ['top', 'right', 'bottom', 'left'],
          },
          TextareaMenu: {
            description:
              'Local presentation for user-initiated native editing actions. This is not\na command interface: clipboard access still requires native activation.',
            type: 'object',
            properties: {
              appearance: {
                $ref: '#/$defs/MenuAppearance',
              },
              labels: {
                $ref: '#/$defs/TextareaMenuLabels',
              },
            },
            additionalProperties: false,
            required: ['appearance', 'labels'],
          },
          MenuAppearance: {
            type: 'object',
            properties: {
              text: {
                $ref: '#/$defs/TextAppearance',
              },
              background: {
                $ref: '#/$defs/Color',
              },
              border: {
                $ref: '#/$defs/Color',
              },
              activeBackground: {
                $ref: '#/$defs/Color',
              },
              activeForeground: {
                $ref: '#/$defs/Color',
              },
              disabledForeground: {
                $ref: '#/$defs/Color',
              },
              borderWidth: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 8,
              },
              radius: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 64,
              },
              padding: {
                $ref: '#/$defs/Insets',
              },
              rowPadding: {
                $ref: '#/$defs/Insets',
              },
              width: {
                type: 'number',
                format: 'float',
                minimum: 32,
                maximum: 1024,
              },
              windowMargin: {
                type: 'number',
                format: 'float',
                minimum: 0,
                maximum: 128,
              },
            },
            additionalProperties: false,
            required: [
              'text',
              'background',
              'border',
              'activeBackground',
              'activeForeground',
              'disabledForeground',
              'borderWidth',
              'radius',
              'padding',
              'rowPadding',
              'width',
              'windowMargin',
            ],
          },
          TextareaMenuLabels: {
            type: 'object',
            properties: {
              title: {
                type: 'string',
                minLength: 1,
              },
              undo: {
                type: 'string',
                minLength: 1,
              },
              redo: {
                type: 'string',
                minLength: 1,
              },
              cut: {
                type: 'string',
                minLength: 1,
              },
              copy: {
                type: 'string',
                minLength: 1,
              },
              paste: {
                type: 'string',
                minLength: 1,
              },
              selectAll: {
                type: 'string',
                minLength: 1,
              },
            },
            additionalProperties: false,
            required: ['title', 'undo', 'redo', 'cut', 'copy', 'paste', 'selectAll'],
          },
          TerminalPaste: {
            type: 'string',
            enum: ['reject_controls', 'spaces'],
          },
          EditorCommand: {
            type: 'object',
            properties: {
              owner: {
                description: 'Correlation with the original native editor, never a resource grant.',
                type: 'string',
                minLength: 1,
              },
              sequence: {
                type: 'integer',
                format: 'uint64',
                minimum: 1,
                maximum: 9007199254740991,
              },
              basedOn: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
                maximum: 9007199254740991,
              },
              edit: {
                $ref: '#/$defs/EditorEdit',
              },
            },
            additionalProperties: false,
            required: ['owner', 'sequence', 'basedOn', 'edit'],
          },
          EditorEdit: {
            oneOf: [
              {
                description:
                  'Replace a UTF-16 range in the current revision, preserving its suffix.',
                type: 'object',
                properties: {
                  range: {
                    $ref: '#/$defs/TextRange',
                  },
                  text: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'replace_range',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'range', 'text'],
              },
              {
                type: 'object',
                properties: {
                  text: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'replace',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'text'],
              },
              {
                type: 'object',
                properties: {
                  text: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'reset',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'text'],
              },
              {
                description:
                  'Continue initialization after Reset, without creating undo history.\nThe same native owner retains the complete buffer.',
                type: 'object',
                properties: {
                  text: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'append',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'text'],
              },
            ],
          },
          TextRange: {
            description: 'Ordered UTF-16 code-unit offsets, shared by selections and range edits.',
            type: 'object',
            properties: {
              start: {
                type: 'integer',
                format: 'uint',
                minimum: 0,
              },
              end: {
                type: 'integer',
                format: 'uint',
                minimum: 0,
              },
            },
            additionalProperties: false,
            required: ['start', 'end'],
          },
          SubmitCopy: {
            type: 'object',
            properties: {
              basis: {
                $ref: '#/$defs/EditorTextRef',
              },
              text: {
                type: 'string',
                minLength: 1,
              },
            },
            additionalProperties: false,
            required: ['basis', 'text'],
          },
          EditorTextRef: {
            type: 'object',
            properties: {
              owner: {
                type: 'string',
              },
              revision: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
              bytes: {
                type: 'integer',
                format: 'uint',
                minimum: 0,
              },
            },
            additionalProperties: false,
            required: ['owner', 'revision', 'bytes'],
          },
        },
      },
      events: {
        changed: {
          $schema: 'https://json-schema.org/draft/2020-12/schema',
          title: 'EditorObservation',
          type: 'object',
          properties: {
            revision: {
              type: 'integer',
              format: 'uint64',
              minimum: 0,
            },
            snapshot: {
              $ref: '#/$defs/EditorSnapshot',
            },
            receipt: {
              anyOf: [
                {
                  $ref: '#/$defs/EditorReceipt',
                },
                {
                  type: 'null',
                },
              ],
            },
          },
          additionalProperties: false,
          required: ['revision', 'snapshot', 'receipt'],
          $defs: {
            EditorSnapshot: {
              type: 'object',
              properties: {
                text: {
                  $ref: '#/$defs/EditorTextRef',
                },
                selection: {
                  $ref: '#/$defs/TextRange',
                },
                reversed: {
                  type: 'boolean',
                },
                marked: {
                  anyOf: [
                    {
                      $ref: '#/$defs/TextRange',
                    },
                    {
                      type: 'null',
                    },
                  ],
                },
              },
              additionalProperties: false,
              required: ['text', 'selection', 'reversed', 'marked'],
            },
            EditorTextRef: {
              type: 'object',
              properties: {
                owner: {
                  type: 'string',
                },
                revision: {
                  type: 'integer',
                  format: 'uint64',
                  minimum: 0,
                },
                bytes: {
                  type: 'integer',
                  format: 'uint',
                  minimum: 0,
                },
              },
              additionalProperties: false,
              required: ['owner', 'revision', 'bytes'],
            },
            TextRange: {
              description:
                'Ordered UTF-16 code-unit offsets, shared by selections and range edits.',
              type: 'object',
              properties: {
                start: {
                  type: 'integer',
                  format: 'uint',
                  minimum: 0,
                },
                end: {
                  type: 'integer',
                  format: 'uint',
                  minimum: 0,
                },
              },
              additionalProperties: false,
              required: ['start', 'end'],
            },
            EditorReceipt: {
              type: 'object',
              properties: {
                owner: {
                  type: 'string',
                },
                sequence: {
                  type: 'integer',
                  format: 'uint64',
                  minimum: 0,
                },
                revision: {
                  type: 'integer',
                  format: 'uint64',
                  minimum: 0,
                },
                outcome: {
                  $ref: '#/$defs/EditorOutcome',
                },
              },
              additionalProperties: false,
              required: ['owner', 'sequence', 'revision', 'outcome'],
            },
            EditorOutcome: {
              oneOf: [
                {
                  type: 'object',
                  properties: {
                    status: {
                      type: 'string',
                      const: 'applied',
                    },
                  },
                  required: ['status'],
                  additionalProperties: false,
                },
                {
                  type: 'object',
                  properties: {
                    reason: {
                      $ref: '#/$defs/EditorConflict',
                    },
                    status: {
                      type: 'string',
                      const: 'conflict',
                    },
                  },
                  additionalProperties: false,
                  required: ['status', 'reason'],
                },
              ],
            },
            EditorConflict: {
              type: 'string',
              enum: [
                'persistence',
                'owner',
                'representation',
                'revision',
                'composition',
                'sequence',
              ],
            },
          },
        },
        submitted: {
          type: 'object',
          additionalProperties: false,
          properties: {},
        },
      },
      captures: {
        snapshot: {
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'EditorCapture',
            oneOf: [
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'current',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  owner: {
                    type: 'string',
                    minLength: 1,
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'at_revision',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'owner', 'revision'],
              },
            ],
          },
          output: {
            kind: 'resource',
            resource: {
              name: 'maka.text.utf8',
              version: 1,
            },
          },
        },
      },
    },
  },
  agent: {
    name: 'maka.agent.Agent',
    version: 1,
    transport: 'remote',
    interface: {
      kind: 'service',
      methods: {
        attachmentImage: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentAttachmentImageRead',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
              source: {
                $ref: '#/$defs/AgentAttachmentImageSource',
              },
              offset: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
                maximum: 9007199254740991,
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'source', 'offset'],
            $defs: {
              AgentAttachmentImageSource: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      id: {
                        type: 'string',
                        minLength: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'uploaded',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'id'],
                  },
                  {
                    type: 'object',
                    properties: {
                      through: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                        maximum: 9007199254740991,
                      },
                      position: {
                        $ref: '#/$defs/HistoryRowPosition',
                      },
                      attachmentIndex: {
                        type: 'integer',
                        format: 'uint32',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'history',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'through', 'position', 'attachmentIndex'],
                  },
                ],
              },
              HistoryRowPosition: {
                description:
                  'Disposable presentation locator, never authority or a canonical execution fact.\nThe source is the original emitting fact; the index precedes UI filtering.',
                type: 'object',
                properties: {
                  sourceSequence: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  itemIndex: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                },
                additionalProperties: false,
                required: ['sourceSequence', 'itemIndex'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentAttachmentImagePage',
            oneOf: [
              {
                type: 'object',
                properties: {
                  source: {
                    $ref: '#/$defs/AgentAttachmentImageSource',
                  },
                  offset: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  totalBytes: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  mimeType: {
                    type: 'string',
                    pattern: '^image/(png|jpeg|gif|webp|avif)$',
                  },
                  digest: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  data: {
                    description: 'Standard padded Base64 of at most 32KiB of encoded image bytes.',
                    type: 'string',
                    maxLength: 43692,
                    pattern: '^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$',
                  },
                  kind: {
                    type: 'string',
                    const: 'ready',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'source', 'offset', 'totalBytes', 'mimeType', 'digest', 'data'],
              },
            ],
            $defs: {
              AgentAttachmentImageSource: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      id: {
                        type: 'string',
                        minLength: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'uploaded',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'id'],
                  },
                  {
                    type: 'object',
                    properties: {
                      through: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                        maximum: 9007199254740991,
                      },
                      position: {
                        $ref: '#/$defs/HistoryRowPosition',
                      },
                      attachmentIndex: {
                        type: 'integer',
                        format: 'uint32',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'history',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'through', 'position', 'attachmentIndex'],
                  },
                ],
              },
              HistoryRowPosition: {
                description:
                  'Disposable presentation locator, never authority or a canonical execution fact.\nThe source is the original emitting fact; the index precedes UI filtering.',
                type: 'object',
                properties: {
                  sourceSequence: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  itemIndex: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                },
                additionalProperties: false,
                required: ['sourceSequence', 'itemIndex'],
              },
            },
          },
          resources: {},
        },
        catalog: {
          mode: 'subscription',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentList',
            type: 'object',
            properties: {
              filter: {
                $ref: '#/$defs/AgentSessionFilter',
              },
              position: {
                $ref: '#/$defs/AgentSessionPosition',
              },
              scope: {
                $ref: '#/$defs/AgentSessionListScope',
                default: {
                  kind: 'all',
                },
              },
              titleQuery: {
                description:
                  'Literal, case-sensitive title substring; an empty query matches all titles.',
                type: 'string',
                default: '',
              },
            },
            additionalProperties: false,
            required: ['filter', 'position'],
            $defs: {
              AgentSessionFilter: {
                type: 'string',
                enum: ['all', 'archived', 'needs_you'],
              },
              AgentSessionPosition: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'start',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      cursor: {
                        type: 'string',
                        minLength: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'at',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'cursor'],
                  },
                  {
                    type: 'object',
                    properties: {
                      revision: {
                        type: 'string',
                      },
                      cursor: {
                        type: 'string',
                        minLength: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'after',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'revision', 'cursor'],
                  },
                  {
                    type: 'object',
                    properties: {
                      revision: {
                        type: 'string',
                      },
                      cursor: {
                        type: 'string',
                        minLength: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'before',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'revision', 'cursor'],
                  },
                ],
              },
              AgentSessionListScope: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'all',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      projectId: {
                        type: 'string',
                        format: 'uuid',
                      },
                      kind: {
                        type: 'string',
                        const: 'project',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'projectId'],
                  },
                  {
                    description:
                      'Resolve the exact workspace from an owned session, never a caller path.',
                    type: 'object',
                    properties: {
                      sessionId: {
                        type: 'string',
                        minLength: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'workspace',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'sessionId'],
                  },
                ],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentSessionPage',
            type: 'object',
            properties: {
              revision: {
                type: 'string',
              },
              needsYouCount: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
              sessions: {
                type: 'array',
                items: {
                  $ref: '#/$defs/AgentSession',
                },
                maxItems: 32,
              },
              before: {
                type: ['string', 'null'],
              },
              after: {
                type: ['string', 'null'],
              },
            },
            additionalProperties: false,
            required: ['revision', 'needsYouCount', 'sessions', 'before', 'after'],
            $defs: {
              AgentSession: {
                type: 'object',
                properties: {
                  branch: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentSessionBranch',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  backend: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentBackendPreference',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  collaborationMode: {
                    $ref: '#/$defs/CollaborationMode',
                    default: 'agent',
                  },
                  tools: {
                    type: ['array', 'null'],
                    items: {
                      type: 'string',
                    },
                  },
                  dataSource: {
                    $ref: '#/$defs/AgentDataSource',
                  },
                  permissions: {
                    $ref: '#/$defs/AgentWorkspacePermissions',
                  },
                  boundaryRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  id: {
                    type: 'string',
                  },
                  title: {
                    type: 'string',
                  },
                  labels: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  workspace: {
                    $ref: '#/$defs/AgentWorkspace',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  updatedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  archived: {
                    type: 'boolean',
                  },
                  hasUnread: {
                    type: 'boolean',
                  },
                  activity: {
                    $ref: '#/$defs/AgentSessionActivity',
                  },
                },
                additionalProperties: false,
                required: [
                  'branch',
                  'dataSource',
                  'permissions',
                  'boundaryRevision',
                  'id',
                  'title',
                  'labels',
                  'workspace',
                  'revision',
                  'updatedAt',
                  'archived',
                  'hasUnread',
                  'activity',
                ],
              },
              AgentSessionBranch: {
                description:
                  'Frozen conversation ancestry for presentation, not authority over the source.',
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                    minLength: 1,
                  },
                  turnId: {
                    type: ['string', 'null'],
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['sessionId', 'turnId'],
              },
              AgentBackendPreference: {
                description:
                  "The next turn's choice, independent of an already admitted execution.\nModel revisions are resolved afresh; preferences never grant execution authority.",
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      connectionId: {
                        type: 'string',
                        minLength: 1,
                      },
                      modelId: {
                        type: 'string',
                        minLength: 1,
                      },
                      thinkingLevel: {
                        anyOf: [
                          {
                            $ref: '#/$defs/ThinkingLevel',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'model',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'connectionId', 'modelId'],
                  },
                  {
                    type: 'object',
                    properties: {
                      selection: {
                        $ref: '#/$defs/AgentExecutorSelection',
                      },
                      kind: {
                        type: 'string',
                        const: 'executor',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'selection'],
                  },
                ],
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
              AgentExecutorSelection: {
                type: 'object',
                properties: {
                  executor: {
                    type: 'string',
                    minLength: 1,
                  },
                  settings: {
                    $ref: '#/$defs/ExecutorSettings',
                  },
                },
                additionalProperties: false,
                required: ['executor', 'settings'],
              },
              ExecutorSettings: {
                description:
                  'Executor-owned model selection, independent of Host model connections.',
                type: 'object',
                properties: {
                  model: {
                    type: ['string', 'null'],
                  },
                  thinkingLevel: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ThinkingLevel',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
              },
              CollaborationMode: {
                type: 'string',
                enum: ['agent', 'plan'],
              },
              AgentDataSource: {
                description:
                  'Stable business-data origin, independent of package or activation revisions.',
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  namespace: {
                    $ref: '#/$defs/InstanceId',
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'namespace'],
              },
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
              AgentWorkspacePermissions: {
                type: 'object',
                properties: {
                  access: {
                    $ref: '#/$defs/AgentWorkspaceAccess',
                  },
                  requestPermissions: {
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: ['access', 'requestPermissions'],
              },
              AgentWorkspaceAccess: {
                description:
                  'Session sandbox policy. Full access explicitly disables filesystem and process isolation.',
                type: 'string',
                enum: ['read_only', 'workspace_write', 'danger_full_access'],
              },
              AgentWorkspace: {
                type: 'object',
                properties: {
                  worktree: {
                    description:
                      'Native owner allocation; never accepted from a caller as workspace authority.',
                    anyOf: [
                      {
                        $ref: '#/$defs/Binding',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  projectId: {
                    description: "Optional membership in this Agent's canonical Project catalog.",
                    type: ['string', 'null'],
                    format: 'uuid',
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  identity: {
                    type: 'string',
                    pattern: '^workspace:v1:[A-Fa-f0-9-]{36}$',
                  },
                },
                additionalProperties: false,
                required: ['path', 'directoryIdentity', 'identity'],
              },
              Binding: {
                description: 'Immutable allocation intent, not the current child branch or HEAD.',
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  common_dir: {
                    type: 'string',
                  },
                  source: {
                    type: 'string',
                  },
                  source_identity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  base_commit: {
                    type: 'string',
                  },
                  directory: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: [
                  'id',
                  'common_dir',
                  'source',
                  'source_identity',
                  'base_commit',
                  'directory',
                ],
              },
              AgentSessionActivity: {
                type: 'string',
                enum: ['idle', 'working', 'waiting'],
              },
            },
          },
          resources: {},
        },
        changeGoal: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentGoalChange',
            oneOf: [
              {
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  objective: {
                    type: 'string',
                  },
                  maxIterations: {
                    type: 'integer',
                    format: 'uint32',
                    minimum: 0,
                  },
                  tokenBudget: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  start: {
                    type: 'boolean',
                  },
                  approval: {
                    $ref: '#/$defs/AgentGoalApproval',
                  },
                  kind: {
                    type: 'string',
                    const: 'create',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'sessionId', 'objective', 'maxIterations', 'start', 'approval'],
              },
              {
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  goalId: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  action: {
                    $ref: '#/$defs/GoalControl',
                  },
                  approval: {
                    description:
                      'Explicit renewed model and session authority, only for Resume without a pending iteration.',
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentGoalApproval',
                      },
                      {
                        type: 'null',
                      },
                    ],
                    default: null,
                  },
                  kind: {
                    type: 'string',
                    const: 'control',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'sessionId', 'goalId', 'revision', 'action'],
              },
            ],
            $defs: {
              AgentGoalApproval: {
                type: 'object',
                properties: {
                  target: {
                    $ref: '#/$defs/AgentScheduledTarget',
                  },
                  model: {
                    $ref: '#/$defs/ModelSelection',
                  },
                  thinkingLevel: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ThinkingLevel',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
                required: ['target', 'model'],
              },
              AgentScheduledTarget: {
                description:
                  'Exact observed source boundary. This data is checked against the original\nSession; passing it never grants execution by itself.',
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  workspace: {
                    $ref: '#/$defs/AgentWorkspace',
                  },
                  permissions: {
                    $ref: '#/$defs/AgentWorkspacePermissions',
                  },
                  boundaryRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['sessionId', 'workspace', 'permissions', 'boundaryRevision'],
              },
              AgentWorkspace: {
                type: 'object',
                properties: {
                  worktree: {
                    description:
                      'Native owner allocation; never accepted from a caller as workspace authority.',
                    anyOf: [
                      {
                        $ref: '#/$defs/Binding',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  projectId: {
                    description: "Optional membership in this Agent's canonical Project catalog.",
                    type: ['string', 'null'],
                    format: 'uuid',
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  identity: {
                    type: 'string',
                    pattern: '^workspace:v1:[A-Fa-f0-9-]{36}$',
                  },
                },
                additionalProperties: false,
                required: ['path', 'directoryIdentity', 'identity'],
              },
              Binding: {
                description: 'Immutable allocation intent, not the current child branch or HEAD.',
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  common_dir: {
                    type: 'string',
                  },
                  source: {
                    type: 'string',
                  },
                  source_identity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  base_commit: {
                    type: 'string',
                  },
                  directory: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: [
                  'id',
                  'common_dir',
                  'source',
                  'source_identity',
                  'base_commit',
                  'directory',
                ],
              },
              AgentWorkspacePermissions: {
                type: 'object',
                properties: {
                  access: {
                    $ref: '#/$defs/AgentWorkspaceAccess',
                  },
                  requestPermissions: {
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: ['access', 'requestPermissions'],
              },
              AgentWorkspaceAccess: {
                description:
                  'Session sandbox policy. Full access explicitly disables filesystem and process isolation.',
                type: 'string',
                enum: ['read_only', 'workspace_write', 'danger_full_access'],
              },
              ModelSelection: {
                description:
                  'Exact public selection observed by a caller, checked once at run admission.',
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                    minLength: 1,
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  modelId: {
                    type: 'string',
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'revision', 'modelId'],
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
              GoalControl: {
                type: 'string',
                enum: ['pause', 'resume', 'cancel', 'complete'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentGoalResult',
            oneOf: [
              {
                type: 'object',
                properties: {
                  goalId: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'committed',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'goalId', 'revision'],
              },
              {
                type: 'object',
                properties: {
                  actual: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'conflict',
                  },
                },
                additionalProperties: false,
                required: ['kind'],
              },
              {
                type: 'object',
                properties: {
                  reason: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'reason'],
              },
            ],
          },
          resources: {},
        },
        changePlan: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentPlanChange',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
              },
              revision: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
              action: {
                $ref: '#/$defs/AgentPlanAction',
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'revision', 'action'],
            $defs: {
              AgentPlanAction: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      proposalId: {
                        type: 'string',
                      },
                      proposalRevision: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      approval: {
                        $ref: '#/$defs/AgentPlanApproval',
                      },
                      kind: {
                        type: 'string',
                        const: 'approve',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'proposalId', 'proposalRevision', 'approval'],
                  },
                  {
                    type: 'object',
                    properties: {
                      proposalId: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'revise',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'proposalId'],
                  },
                  {
                    type: 'object',
                    properties: {
                      proposalId: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'abandon',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'proposalId'],
                  },
                  {
                    type: 'object',
                    properties: {
                      executionId: {
                        type: 'string',
                      },
                      approval: {
                        $ref: '#/$defs/AgentPlanApproval',
                      },
                      kind: {
                        type: 'string',
                        const: 'resume',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'executionId', 'approval'],
                  },
                  {
                    type: 'object',
                    properties: {
                      executionId: {
                        type: 'string',
                      },
                      reason: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'cancel',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'executionId', 'reason'],
                  },
                ],
              },
              AgentPlanApproval: {
                type: 'object',
                properties: {
                  target: {
                    $ref: '#/$defs/AgentScheduledTarget',
                  },
                  model: {
                    $ref: '#/$defs/ModelSelection',
                  },
                  thinkingLevel: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ThinkingLevel',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
                required: ['target', 'model'],
              },
              AgentScheduledTarget: {
                description:
                  'Exact observed source boundary. This data is checked against the original\nSession; passing it never grants execution by itself.',
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  workspace: {
                    $ref: '#/$defs/AgentWorkspace',
                  },
                  permissions: {
                    $ref: '#/$defs/AgentWorkspacePermissions',
                  },
                  boundaryRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['sessionId', 'workspace', 'permissions', 'boundaryRevision'],
              },
              AgentWorkspace: {
                type: 'object',
                properties: {
                  worktree: {
                    description:
                      'Native owner allocation; never accepted from a caller as workspace authority.',
                    anyOf: [
                      {
                        $ref: '#/$defs/Binding',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  projectId: {
                    description: "Optional membership in this Agent's canonical Project catalog.",
                    type: ['string', 'null'],
                    format: 'uuid',
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  identity: {
                    type: 'string',
                    pattern: '^workspace:v1:[A-Fa-f0-9-]{36}$',
                  },
                },
                additionalProperties: false,
                required: ['path', 'directoryIdentity', 'identity'],
              },
              Binding: {
                description: 'Immutable allocation intent, not the current child branch or HEAD.',
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  common_dir: {
                    type: 'string',
                  },
                  source: {
                    type: 'string',
                  },
                  source_identity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  base_commit: {
                    type: 'string',
                  },
                  directory: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: [
                  'id',
                  'common_dir',
                  'source',
                  'source_identity',
                  'base_commit',
                  'directory',
                ],
              },
              AgentWorkspacePermissions: {
                type: 'object',
                properties: {
                  access: {
                    $ref: '#/$defs/AgentWorkspaceAccess',
                  },
                  requestPermissions: {
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: ['access', 'requestPermissions'],
              },
              AgentWorkspaceAccess: {
                description:
                  'Session sandbox policy. Full access explicitly disables filesystem and process isolation.',
                type: 'string',
                enum: ['read_only', 'workspace_write', 'danger_full_access'],
              },
              ModelSelection: {
                description:
                  'Exact public selection observed by a caller, checked once at run admission.',
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                    minLength: 1,
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  modelId: {
                    type: 'string',
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'revision', 'modelId'],
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentPlanResult',
            oneOf: [
              {
                type: 'object',
                properties: {
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'committed',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'revision'],
              },
              {
                type: 'object',
                properties: {
                  actual: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'conflict',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'actual'],
              },
              {
                type: 'object',
                properties: {
                  reason: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'reason'],
              },
            ],
          },
          resources: {},
        },
        changeSession: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentChangeSession',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
              },
              expectedRevision: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
              action: {
                $ref: '#/$defs/AgentSessionAction',
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'expectedRevision', 'action'],
            $defs: {
              AgentSessionAction: {
                type: 'string',
                enum: ['archive', 'restore', 'remove'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentSessionChanged',
            oneOf: [
              {
                type: 'object',
                properties: {
                  session: {
                    $ref: '#/$defs/AgentSession',
                  },
                  kind: {
                    type: 'string',
                    const: 'changed',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'session'],
              },
              {
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'removed',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'sessionId'],
              },
              {
                type: 'object',
                properties: {
                  expected: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  actual: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'revision_conflict',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'expected', 'actual'],
              },
              {
                type: 'object',
                properties: {
                  reason: {
                    $ref: '#/$defs/AgentRejection',
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'reason'],
              },
            ],
            $defs: {
              AgentSession: {
                type: 'object',
                properties: {
                  branch: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentSessionBranch',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  backend: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentBackendPreference',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  collaborationMode: {
                    $ref: '#/$defs/CollaborationMode',
                    default: 'agent',
                  },
                  tools: {
                    type: ['array', 'null'],
                    items: {
                      type: 'string',
                    },
                  },
                  dataSource: {
                    $ref: '#/$defs/AgentDataSource',
                  },
                  permissions: {
                    $ref: '#/$defs/AgentWorkspacePermissions',
                  },
                  boundaryRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  id: {
                    type: 'string',
                  },
                  title: {
                    type: 'string',
                  },
                  labels: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  workspace: {
                    $ref: '#/$defs/AgentWorkspace',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  updatedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  archived: {
                    type: 'boolean',
                  },
                  hasUnread: {
                    type: 'boolean',
                  },
                  activity: {
                    $ref: '#/$defs/AgentSessionActivity',
                  },
                },
                additionalProperties: false,
                required: [
                  'branch',
                  'dataSource',
                  'permissions',
                  'boundaryRevision',
                  'id',
                  'title',
                  'labels',
                  'workspace',
                  'revision',
                  'updatedAt',
                  'archived',
                  'hasUnread',
                  'activity',
                ],
              },
              AgentSessionBranch: {
                description:
                  'Frozen conversation ancestry for presentation, not authority over the source.',
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                    minLength: 1,
                  },
                  turnId: {
                    type: ['string', 'null'],
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['sessionId', 'turnId'],
              },
              AgentBackendPreference: {
                description:
                  "The next turn's choice, independent of an already admitted execution.\nModel revisions are resolved afresh; preferences never grant execution authority.",
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      connectionId: {
                        type: 'string',
                        minLength: 1,
                      },
                      modelId: {
                        type: 'string',
                        minLength: 1,
                      },
                      thinkingLevel: {
                        anyOf: [
                          {
                            $ref: '#/$defs/ThinkingLevel',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'model',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'connectionId', 'modelId'],
                  },
                  {
                    type: 'object',
                    properties: {
                      selection: {
                        $ref: '#/$defs/AgentExecutorSelection',
                      },
                      kind: {
                        type: 'string',
                        const: 'executor',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'selection'],
                  },
                ],
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
              AgentExecutorSelection: {
                type: 'object',
                properties: {
                  executor: {
                    type: 'string',
                    minLength: 1,
                  },
                  settings: {
                    $ref: '#/$defs/ExecutorSettings',
                  },
                },
                additionalProperties: false,
                required: ['executor', 'settings'],
              },
              ExecutorSettings: {
                description:
                  'Executor-owned model selection, independent of Host model connections.',
                type: 'object',
                properties: {
                  model: {
                    type: ['string', 'null'],
                  },
                  thinkingLevel: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ThinkingLevel',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
              },
              CollaborationMode: {
                type: 'string',
                enum: ['agent', 'plan'],
              },
              AgentDataSource: {
                description:
                  'Stable business-data origin, independent of package or activation revisions.',
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  namespace: {
                    $ref: '#/$defs/InstanceId',
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'namespace'],
              },
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
              AgentWorkspacePermissions: {
                type: 'object',
                properties: {
                  access: {
                    $ref: '#/$defs/AgentWorkspaceAccess',
                  },
                  requestPermissions: {
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: ['access', 'requestPermissions'],
              },
              AgentWorkspaceAccess: {
                description:
                  'Session sandbox policy. Full access explicitly disables filesystem and process isolation.',
                type: 'string',
                enum: ['read_only', 'workspace_write', 'danger_full_access'],
              },
              AgentWorkspace: {
                type: 'object',
                properties: {
                  worktree: {
                    description:
                      'Native owner allocation; never accepted from a caller as workspace authority.',
                    anyOf: [
                      {
                        $ref: '#/$defs/Binding',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  projectId: {
                    description: "Optional membership in this Agent's canonical Project catalog.",
                    type: ['string', 'null'],
                    format: 'uuid',
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  identity: {
                    type: 'string',
                    pattern: '^workspace:v1:[A-Fa-f0-9-]{36}$',
                  },
                },
                additionalProperties: false,
                required: ['path', 'directoryIdentity', 'identity'],
              },
              Binding: {
                description: 'Immutable allocation intent, not the current child branch or HEAD.',
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  common_dir: {
                    type: 'string',
                  },
                  source: {
                    type: 'string',
                  },
                  source_identity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  base_commit: {
                    type: 'string',
                  },
                  directory: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: [
                  'id',
                  'common_dir',
                  'source',
                  'source_identity',
                  'base_commit',
                  'directory',
                ],
              },
              AgentSessionActivity: {
                type: 'string',
                enum: ['idle', 'working', 'waiting'],
              },
              AgentRejection: {
                type: 'string',
                enum: [
                  'title_invalid',
                  'labels_invalid',
                  'tools_unavailable',
                  'busy',
                  'workspace_unavailable',
                  'session_unavailable',
                  'history_unavailable',
                  'managed_session',
                  'closed',
                ],
              },
            },
          },
          resources: {},
        },
        checklist: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentChecklistRead',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
              },
              offset: {
                type: 'integer',
                format: 'uint',
                minimum: 0,
                default: 0,
              },
            },
            additionalProperties: false,
            required: ['sessionId'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentChecklist',
            type: 'object',
            properties: {
              enabled: {
                type: 'boolean',
              },
              revision: {
                type: ['integer', 'null'],
                format: 'uint64',
                minimum: 0,
              },
              total: {
                type: 'integer',
                format: 'uint',
                minimum: 0,
              },
              completed: {
                type: 'integer',
                format: 'uint',
                minimum: 0,
              },
              current: {
                anyOf: [
                  {
                    $ref: '#/$defs/AgentTodoItem',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              offset: {
                type: 'integer',
                format: 'uint',
                minimum: 0,
              },
              items: {
                type: 'array',
                items: {
                  $ref: '#/$defs/AgentTodoItem',
                },
                maxItems: 20,
              },
              nextOffset: {
                type: ['integer', 'null'],
                format: 'uint',
                minimum: 0,
              },
            },
            additionalProperties: false,
            required: ['enabled', 'total', 'completed', 'offset', 'items'],
            $defs: {
              AgentTodoItem: {
                type: 'object',
                properties: {
                  content: {
                    type: 'string',
                    minLength: 1,
                  },
                  status: {
                    $ref: '#/$defs/AgentTodoStatus',
                  },
                },
                additionalProperties: false,
                required: ['content', 'status'],
              },
              AgentTodoStatus: {
                type: 'string',
                enum: ['pending', 'in_progress', 'completed'],
              },
            },
          },
          resources: {},
        },
        compact: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentCompact',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
              model: {
                $ref: '#/$defs/ModelSelection',
              },
              thinkingLevel: {
                anyOf: [
                  {
                    $ref: '#/$defs/ThinkingLevel',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              prompt: {
                description: 'One invocation only; omission uses the global preference.',
                type: ['string', 'null'],
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'model'],
            $defs: {
              ModelSelection: {
                description:
                  'Exact public selection observed by a caller, checked once at run admission.',
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                    minLength: 1,
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  modelId: {
                    type: 'string',
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'revision', 'modelId'],
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentCompactResult',
            oneOf: [
              {
                type: 'object',
                properties: {
                  execution: {
                    $ref: '#/$defs/AgentExecution',
                  },
                  kind: {
                    type: 'string',
                    const: 'started',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'execution'],
              },
              {
                type: 'object',
                properties: {
                  reason: {
                    $ref: '#/$defs/AgentCompactRejection',
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'reason'],
              },
            ],
            $defs: {
              AgentExecution: {
                description:
                  'Canonical physical execution receipt, independent of the current Session tip.',
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  turnId: {
                    type: 'string',
                  },
                  runId: {
                    type: 'string',
                  },
                  invocationId: {
                    type: 'string',
                  },
                  highWater: {
                    description: 'Run-local event count, not the root-global transcript cursor.',
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  state: {
                    $ref: '#/$defs/AgentExecutionState',
                  },
                },
                additionalProperties: false,
                required: ['sessionId', 'turnId', 'runId', 'invocationId', 'highWater', 'state'],
              },
              AgentExecutionState: {
                type: 'string',
                enum: [
                  'admitted',
                  'running',
                  'waiting',
                  'paused',
                  'completed',
                  'failed',
                  'cancelled',
                ],
              },
              AgentCompactRejection: {
                type: 'string',
                enum: ['busy', 'closed', 'archived', 'backend_unavailable', 'workspace_changed'],
              },
            },
          },
          resources: {},
        },
        compactionPrompt: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentSessionRead',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
            },
            additionalProperties: false,
            required: ['sessionId'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentCompactionPrompt',
            type: 'object',
            properties: {
              compactionPrompt: {
                type: 'string',
              },
              defaultCompactionPrompt: {
                type: 'string',
              },
            },
            additionalProperties: false,
            required: ['compactionPrompt', 'defaultCompactionPrompt'],
          },
          resources: {},
        },
        context: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentContextRead',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
              },
              through: {
                description:
                  'Null captures the committed head; a supplied fence must not exceed it.',
                type: ['integer', 'null'],
                format: 'uint64',
                minimum: 0,
                maximum: 9007199254740991,
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'through'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentContextReport',
            type: 'object',
            properties: {
              through: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
                maximum: 9007199254740991,
              },
              request: {
                description:
                  'Latest Main request made by this Session, excluding copied source requests.',
                anyOf: [
                  {
                    $ref: '#/$defs/AgentContextRequest',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
            },
            additionalProperties: false,
            required: ['through', 'request'],
            $defs: {
              AgentContextRequest: {
                type: 'object',
                properties: {
                  invocationId: {
                    type: 'string',
                  },
                  stepId: {
                    type: 'string',
                  },
                  sequence: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  recordedAt: {
                    description: 'Original request timestamp in milliseconds since the Unix epoch.',
                    type: 'number',
                    format: 'double',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                  sourceThrough: {
                    description: 'Original input history fence, before this request was recorded.',
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                  modelId: {
                    type: 'string',
                  },
                  contextWindow: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  inputLimit: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  state: {
                    $ref: '#/$defs/AgentContextRequestState',
                  },
                  breakdown: {
                    description:
                      'Original Host prepared-input measurements, not provider wire sizes or exact tokenization.',
                    anyOf: [
                      {
                        $ref: '#/$defs/PreparedContextBreakdown',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  reportedInputTokens: {
                    description:
                      'Provider-reported input tokens from this exact completed step, if available.',
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                },
                additionalProperties: false,
                required: [
                  'invocationId',
                  'stepId',
                  'sequence',
                  'recordedAt',
                  'sourceThrough',
                  'modelId',
                  'contextWindow',
                  'inputLimit',
                  'state',
                  'breakdown',
                  'reportedInputTokens',
                ],
              },
              AgentContextRequestState: {
                type: 'string',
                enum: ['requested', 'completed', 'interrupted'],
              },
              PreparedContextBreakdown: {
                description:
                  'Host-prepared adapter input, not provider tokenization or HTTP wire bytes.',
                type: 'object',
                properties: {
                  system: {
                    $ref: '#/$defs/ContextBucket',
                  },
                  user: {
                    $ref: '#/$defs/ContextBucket',
                  },
                  assistant: {
                    $ref: '#/$defs/ContextBucket',
                  },
                  tool: {
                    description:
                      'Messages with the tool role; assistant-embedded results stay in assistant.',
                    $ref: '#/$defs/ContextBucket',
                  },
                  toolSchemas: {
                    $ref: '#/$defs/ContextBucket',
                  },
                  counts: {
                    $ref: '#/$defs/ContextCounts',
                  },
                },
                additionalProperties: false,
                required: ['system', 'user', 'assistant', 'tool', 'toolSchemas', 'counts'],
              },
              ContextBucket: {
                type: 'object',
                properties: {
                  contentBytes: {
                    description:
                      'UTF-8 text and compact JSON payload bytes counted by the Host heuristic.\nExcludes file encodings, message metadata, request-level provider options\nand synthetic framing overhead. Tool definitions are counted in full.',
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                  estimatedTokens: {
                    description:
                      'Heuristic: separately rounded text/JSON bytes / 3, plus message/tool\nframing and 1024 per media part. Never provider-measured tokens.',
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                },
                additionalProperties: false,
                required: ['contentBytes', 'estimatedTokens'],
              },
              ContextCounts: {
                type: 'object',
                properties: {
                  messages: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                  media: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                  toolCalls: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                  toolResults: {
                    description: 'Result parts across both tool and assistant roles.',
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                  tools: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                },
                additionalProperties: false,
                required: ['messages', 'media', 'toolCalls', 'toolResults', 'tools'],
              },
            },
          },
          resources: {},
        },
        create: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentCreate',
            type: 'object',
            properties: {
              automaticTitle: {
                description:
                  'Treat title as a placeholder for one title derived from the first user message.',
                type: 'boolean',
                default: false,
              },
              tools: {
                description:
                  "Immutable narrowing of this Agent's installed tools. None uses the installation;\nan empty list permits no model tools. External executors cannot enforce this.",
                type: ['array', 'null'],
                items: {
                  type: 'string',
                },
                default: null,
                uniqueItems: true,
              },
              title: {
                type: 'string',
                minLength: 1,
              },
              labels: {
                type: 'array',
                items: {
                  type: 'string',
                },
              },
              workspace: {
                $ref: '#/$defs/AgentWorkspaceSelection',
              },
            },
            additionalProperties: false,
            required: ['title', 'labels', 'workspace'],
            $defs: {
              AgentWorkspaceSelection: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      selection: {
                        $ref: '#/$defs/AgentDirectorySelection',
                      },
                      kind: {
                        type: 'string',
                        const: 'isolated_git',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'selection'],
                  },
                  {
                    type: 'object',
                    properties: {
                      project: {
                        $ref: '#/$defs/AgentProjectRef',
                      },
                      selection: {
                        $ref: '#/$defs/AgentDirectorySelection',
                      },
                      kind: {
                        type: 'string',
                        const: 'project',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'project', 'selection'],
                  },
                  {
                    type: 'object',
                    properties: {
                      selection: {
                        $ref: '#/$defs/AgentDirectorySelection',
                      },
                      kind: {
                        type: 'string',
                        const: 'directory',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'selection'],
                  },
                  {
                    type: 'object',
                    properties: {
                      sessionId: {
                        type: 'string',
                        minLength: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'session',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'sessionId'],
                  },
                ],
              },
              AgentDirectorySelection: {
                type: 'object',
                properties: {
                  rootId: {
                    type: 'string',
                    minLength: 1,
                  },
                  segments: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                },
                additionalProperties: false,
                required: ['rootId', 'segments', 'directoryIdentity'],
              },
              AgentProjectRef: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'string',
                    pattern: '^[a-f0-9]{64}$',
                  },
                },
                additionalProperties: false,
                required: ['id', 'revision'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentCreated',
            oneOf: [
              {
                type: 'object',
                properties: {
                  session: {
                    $ref: '#/$defs/AgentSession',
                  },
                  kind: {
                    type: 'string',
                    const: 'created',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'session'],
              },
              {
                type: 'object',
                properties: {
                  reason: {
                    $ref: '#/$defs/AgentRejection',
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'reason'],
              },
            ],
            $defs: {
              AgentSession: {
                type: 'object',
                properties: {
                  branch: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentSessionBranch',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  backend: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentBackendPreference',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  collaborationMode: {
                    $ref: '#/$defs/CollaborationMode',
                    default: 'agent',
                  },
                  tools: {
                    type: ['array', 'null'],
                    items: {
                      type: 'string',
                    },
                  },
                  dataSource: {
                    $ref: '#/$defs/AgentDataSource',
                  },
                  permissions: {
                    $ref: '#/$defs/AgentWorkspacePermissions',
                  },
                  boundaryRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  id: {
                    type: 'string',
                  },
                  title: {
                    type: 'string',
                  },
                  labels: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  workspace: {
                    $ref: '#/$defs/AgentWorkspace',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  updatedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  archived: {
                    type: 'boolean',
                  },
                  hasUnread: {
                    type: 'boolean',
                  },
                  activity: {
                    $ref: '#/$defs/AgentSessionActivity',
                  },
                },
                additionalProperties: false,
                required: [
                  'branch',
                  'dataSource',
                  'permissions',
                  'boundaryRevision',
                  'id',
                  'title',
                  'labels',
                  'workspace',
                  'revision',
                  'updatedAt',
                  'archived',
                  'hasUnread',
                  'activity',
                ],
              },
              AgentSessionBranch: {
                description:
                  'Frozen conversation ancestry for presentation, not authority over the source.',
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                    minLength: 1,
                  },
                  turnId: {
                    type: ['string', 'null'],
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['sessionId', 'turnId'],
              },
              AgentBackendPreference: {
                description:
                  "The next turn's choice, independent of an already admitted execution.\nModel revisions are resolved afresh; preferences never grant execution authority.",
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      connectionId: {
                        type: 'string',
                        minLength: 1,
                      },
                      modelId: {
                        type: 'string',
                        minLength: 1,
                      },
                      thinkingLevel: {
                        anyOf: [
                          {
                            $ref: '#/$defs/ThinkingLevel',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'model',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'connectionId', 'modelId'],
                  },
                  {
                    type: 'object',
                    properties: {
                      selection: {
                        $ref: '#/$defs/AgentExecutorSelection',
                      },
                      kind: {
                        type: 'string',
                        const: 'executor',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'selection'],
                  },
                ],
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
              AgentExecutorSelection: {
                type: 'object',
                properties: {
                  executor: {
                    type: 'string',
                    minLength: 1,
                  },
                  settings: {
                    $ref: '#/$defs/ExecutorSettings',
                  },
                },
                additionalProperties: false,
                required: ['executor', 'settings'],
              },
              ExecutorSettings: {
                description:
                  'Executor-owned model selection, independent of Host model connections.',
                type: 'object',
                properties: {
                  model: {
                    type: ['string', 'null'],
                  },
                  thinkingLevel: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ThinkingLevel',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
              },
              CollaborationMode: {
                type: 'string',
                enum: ['agent', 'plan'],
              },
              AgentDataSource: {
                description:
                  'Stable business-data origin, independent of package or activation revisions.',
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  namespace: {
                    $ref: '#/$defs/InstanceId',
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'namespace'],
              },
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
              AgentWorkspacePermissions: {
                type: 'object',
                properties: {
                  access: {
                    $ref: '#/$defs/AgentWorkspaceAccess',
                  },
                  requestPermissions: {
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: ['access', 'requestPermissions'],
              },
              AgentWorkspaceAccess: {
                description:
                  'Session sandbox policy. Full access explicitly disables filesystem and process isolation.',
                type: 'string',
                enum: ['read_only', 'workspace_write', 'danger_full_access'],
              },
              AgentWorkspace: {
                type: 'object',
                properties: {
                  worktree: {
                    description:
                      'Native owner allocation; never accepted from a caller as workspace authority.',
                    anyOf: [
                      {
                        $ref: '#/$defs/Binding',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  projectId: {
                    description: "Optional membership in this Agent's canonical Project catalog.",
                    type: ['string', 'null'],
                    format: 'uuid',
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  identity: {
                    type: 'string',
                    pattern: '^workspace:v1:[A-Fa-f0-9-]{36}$',
                  },
                },
                additionalProperties: false,
                required: ['path', 'directoryIdentity', 'identity'],
              },
              Binding: {
                description: 'Immutable allocation intent, not the current child branch or HEAD.',
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  common_dir: {
                    type: 'string',
                  },
                  source: {
                    type: 'string',
                  },
                  source_identity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  base_commit: {
                    type: 'string',
                  },
                  directory: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: [
                  'id',
                  'common_dir',
                  'source',
                  'source_identity',
                  'base_commit',
                  'directory',
                ],
              },
              AgentSessionActivity: {
                type: 'string',
                enum: ['idle', 'working', 'waiting'],
              },
              AgentRejection: {
                type: 'string',
                enum: [
                  'title_invalid',
                  'labels_invalid',
                  'tools_unavailable',
                  'busy',
                  'workspace_unavailable',
                  'session_unavailable',
                  'history_unavailable',
                  'managed_session',
                  'closed',
                ],
              },
            },
          },
          resources: {},
        },
        diagnostics: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentDiagnostics',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
              position: {
                $ref: '#/$defs/AgentDiagnosticPosition',
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'position'],
            $defs: {
              AgentDiagnosticPosition: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'latest',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      through: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                        maximum: 9007199254740991,
                      },
                      sequence: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 1,
                        maximum: 9007199254740991,
                      },
                      kind: {
                        type: 'string',
                        const: 'before',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'through', 'sequence'],
                  },
                ],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentDiagnosticPage',
            type: 'object',
            properties: {
              through: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
              entries: {
                type: 'array',
                items: {
                  $ref: '#/$defs/AgentDiagnostic',
                },
              },
              nextBefore: {
                type: ['integer', 'null'],
                format: 'uint64',
                minimum: 0,
              },
            },
            additionalProperties: false,
            required: ['through', 'entries'],
            $defs: {
              AgentDiagnostic: {
                type: 'object',
                properties: {
                  sequence: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  eventId: {
                    type: 'string',
                  },
                  recordedAt: {
                    type: 'number',
                    format: 'double',
                  },
                  detail: {
                    $ref: '#/$defs/DiagnosticDetail',
                  },
                },
                additionalProperties: false,
                required: ['sequence', 'eventId', 'recordedAt', 'detail'],
              },
              DiagnosticDetail: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      invocation: {
                        $ref: '#/$defs/Invocation',
                      },
                      reason: {
                        $ref: '#/$defs/ExecutionFailureReason',
                      },
                      modelFailure: {
                        anyOf: [
                          {
                            $ref: '#/$defs/ModelFailureCause',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'execution',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'invocation', 'reason'],
                  },
                  {
                    type: 'object',
                    properties: {
                      invocation: {
                        $ref: '#/$defs/Invocation',
                      },
                      stepId: {
                        type: 'string',
                      },
                      status: {
                        $ref: '#/$defs/ModelInterruption',
                      },
                      modelFailure: {
                        anyOf: [
                          {
                            $ref: '#/$defs/ModelFailureCause',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'model_step',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'invocation', 'stepId', 'status'],
                  },
                  {
                    type: 'object',
                    properties: {
                      invocation: {
                        $ref: '#/$defs/Invocation',
                      },
                      cause: {
                        $ref: '#/$defs/TitleFailureCause',
                      },
                      kind: {
                        type: 'string',
                        const: 'session_title',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'invocation', 'cause'],
                  },
                ],
              },
              Invocation: {
                type: 'object',
                properties: {
                  session_id: {
                    type: 'string',
                  },
                  turn_id: {
                    type: 'string',
                  },
                  run_id: {
                    type: 'string',
                  },
                  invocation_id: {
                    type: 'string',
                  },
                },
                required: ['session_id', 'turn_id', 'run_id', 'invocation_id'],
              },
              ExecutionFailureReason: {
                type: 'string',
                enum: [
                  'session_busy',
                  'continuation_changed',
                  'reconciliation_required',
                  'invalid_input',
                  'cancelled',
                  'model_incomplete',
                  'event_commit',
                  'event_store',
                  'model_timeout',
                  'model_http',
                  'model_adapter',
                  'model_provider',
                  'context_overflow',
                  'tool_execution',
                  'runtime_internal',
                  'cleanup_unconfirmed',
                  'executor',
                  'message_preparation_failed',
                  'host_interrupted',
                  'outcome_unknown',
                  'execution_failed',
                ],
              },
              ModelFailureCause: {
                description: 'Safe failure evidence, separate from provider-owned diagnostic text.',
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      status: {
                        type: 'integer',
                        format: 'uint16',
                        minimum: 100,
                        maximum: 599,
                      },
                      kind: {
                        type: 'string',
                        const: 'http',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'status'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'timed_out',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'context_overflow',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      reason: {
                        $ref: '#/$defs/ProviderFailureReason',
                      },
                      kind: {
                        type: 'string',
                        const: 'provider',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'reason'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'adapter',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                ],
              },
              ProviderFailureReason: {
                type: 'string',
                enum: [
                  'network',
                  'timed_out',
                  'rate_limit',
                  'provider_unavailable',
                  'stream_truncated',
                ],
              },
              ModelInterruption: {
                oneOf: [
                  {
                    type: 'string',
                    enum: ['cancelled', 'timed_out', 'failed'],
                  },
                  {
                    description:
                      'Trusted ingress permits retry: legacy steps can discard observations;\nitem-accepting steps must retain completed items and settle their tools.\nThis records safety evidence, not an instruction to retry.',
                    type: 'string',
                    const: 'retryable_failure',
                  },
                ],
              },
              TitleFailureCause: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'preparation',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      cause: {
                        $ref: '#/$defs/ModelFailureCause',
                      },
                      kind: {
                        type: 'string',
                        const: 'model',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'cause'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'invalid_output',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'output_limit',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'empty_output',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                ],
              },
            },
          },
          resources: {},
        },
        directories: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentDirectories',
            oneOf: [
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'roots',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  selection: {
                    $ref: '#/$defs/AgentDirectorySelection',
                  },
                  after: {
                    type: ['string', 'null'],
                  },
                  kind: {
                    type: 'string',
                    const: 'children',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'selection', 'after'],
              },
            ],
            $defs: {
              AgentDirectorySelection: {
                type: 'object',
                properties: {
                  rootId: {
                    type: 'string',
                    minLength: 1,
                  },
                  segments: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                },
                additionalProperties: false,
                required: ['rootId', 'segments', 'directoryIdentity'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentDirectoryPage',
            oneOf: [
              {
                type: 'object',
                properties: {
                  roots: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/AgentDirectory',
                    },
                  },
                  kind: {
                    type: 'string',
                    const: 'roots',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'roots'],
              },
              {
                type: 'object',
                properties: {
                  directory: {
                    $ref: '#/$defs/AgentDirectory',
                  },
                  children: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/AgentDirectory',
                    },
                    maxItems: 32,
                  },
                  after: {
                    type: ['string', 'null'],
                  },
                  kind: {
                    type: 'string',
                    const: 'children',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'directory', 'children', 'after'],
              },
            ],
            $defs: {
              AgentDirectory: {
                type: 'object',
                properties: {
                  name: {
                    type: 'string',
                  },
                  path: {
                    type: 'string',
                  },
                  selection: {
                    $ref: '#/$defs/AgentDirectorySelection',
                  },
                },
                additionalProperties: false,
                required: ['name', 'path', 'selection'],
              },
              AgentDirectorySelection: {
                type: 'object',
                properties: {
                  rootId: {
                    type: 'string',
                    minLength: 1,
                  },
                  segments: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                },
                additionalProperties: false,
                required: ['rootId', 'segments', 'directoryIdentity'],
              },
            },
          },
          resources: {},
        },
        editQueue: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentQueueMutation',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
              expectedRevision: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
                maximum: 9007199254740991,
              },
              edit: {
                $ref: '#/$defs/AgentQueueAction',
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'expectedRevision', 'edit'],
            $defs: {
              AgentQueueAction: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      messageId: {
                        type: 'string',
                        minLength: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'retract',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'messageId'],
                  },
                  {
                    type: 'object',
                    properties: {
                      messageId: {
                        type: 'string',
                        minLength: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'promote',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'messageId'],
                  },
                  {
                    type: 'object',
                    properties: {
                      messageId: {
                        type: 'string',
                        minLength: 1,
                      },
                      message: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'update',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'messageId', 'message'],
                  },
                  {
                    type: 'object',
                    properties: {
                      messageIds: {
                        type: 'array',
                        items: {
                          type: 'string',
                        },
                        minItems: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'reorder',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'messageIds'],
                  },
                ],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentQueueMutationResult',
            oneOf: [
              {
                type: 'object',
                properties: {
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'committed',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'revision'],
              },
              {
                type: 'object',
                properties: {
                  expected: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  actual: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'revision_conflict',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'expected', 'actual'],
              },
              {
                type: 'object',
                properties: {
                  reason: {
                    $ref: '#/$defs/AgentQueueRejection',
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'reason'],
              },
            ],
            $defs: {
              AgentQueueRejection: {
                type: 'string',
                enum: [
                  'closed',
                  'missing',
                  'in_flight',
                  'invalid_edit',
                  'execution_changed',
                  'not_running',
                ],
              },
            },
          },
          resources: {},
        },
        execute: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentExecute',
            type: 'object',
            properties: {
              attachments: {
                description:
                  'IDs of immutable user uploads in this Session, resolved by the Agent owner.',
                type: 'array',
                items: {
                  type: 'string',
                },
                default: [],
              },
              sessionId: {
                type: 'string',
                minLength: 1,
              },
              message: {
                type: 'string',
              },
              executor: {
                $ref: '#/$defs/AgentExecutorSelection',
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'message', 'executor'],
            $defs: {
              AgentExecutorSelection: {
                type: 'object',
                properties: {
                  executor: {
                    type: 'string',
                    minLength: 1,
                  },
                  settings: {
                    $ref: '#/$defs/ExecutorSettings',
                  },
                },
                additionalProperties: false,
                required: ['executor', 'settings'],
              },
              ExecutorSettings: {
                description:
                  'Executor-owned model selection, independent of Host model connections.',
                type: 'object',
                properties: {
                  model: {
                    type: ['string', 'null'],
                  },
                  thinkingLevel: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ThinkingLevel',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentSendResult',
            oneOf: [
              {
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  reason: {
                    $ref: '#/$defs/AgentSkillInputRejection',
                  },
                  skills: {
                    anyOf: [
                      {
                        $ref: '#/$defs/SkillInvocationResult',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'sessionId', 'reason'],
              },
              {
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  invocationId: {
                    type: 'string',
                  },
                  messageId: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'started',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'sessionId', 'invocationId', 'messageId'],
              },
              {
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  messageId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'queued',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'sessionId', 'messageId', 'revision'],
              },
            ],
            $defs: {
              AgentSkillInputRejection: {
                type: 'string',
                enum: ['skills_unavailable'],
              },
              SkillInvocationResult: {
                type: 'object',
                properties: {
                  loaded: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/LoadedSkill',
                    },
                  },
                  failed: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/SkillInvocationFailure',
                    },
                  },
                  receipts: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/SkillInvocationReceipt',
                    },
                  },
                },
                additionalProperties: false,
                required: ['loaded', 'failed', 'receipts'],
              },
              LoadedSkill: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  name: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['id', 'name'],
              },
              SkillInvocationFailure: {
                anyOf: [
                  {
                    $ref: '#/$defs/SkillRequestFailure',
                  },
                ],
              },
              SkillRequestFailure: {
                type: 'object',
                properties: {
                  request: {
                    type: 'string',
                  },
                  reason: {
                    $ref: '#/$defs/SkillFailureReason',
                  },
                },
                additionalProperties: false,
                required: ['request', 'reason'],
              },
              SkillFailureReason: {
                type: 'string',
                enum: [
                  'invalid_name',
                  'not_found',
                  'disabled',
                  'host_incompatible',
                  'resolution_failed',
                ],
              },
              SkillInvocationReceipt: {
                description:
                  'Boolean wire discriminants are validated here, not retained as mutable\nbusiness fields beside a contradictory enum variant.',
                anyOf: [
                  {
                    type: 'object',
                    properties: {
                      invocation: {
                        $ref: '#/$defs/SkillInvocationMode',
                      },
                      request: {
                        type: 'string',
                      },
                      success: {
                        const: true,
                      },
                      ref: {
                        type: 'string',
                      },
                      id: {
                        type: 'string',
                      },
                      name: {
                        type: 'string',
                      },
                      scope: {
                        $ref: '#/$defs/SkillScope',
                      },
                      source: {
                        $ref: '#/$defs/SkillSource',
                      },
                      truncated: {
                        type: 'boolean',
                      },
                    },
                    additionalProperties: false,
                    required: [
                      'invocation',
                      'request',
                      'success',
                      'ref',
                      'id',
                      'name',
                      'scope',
                      'source',
                      'truncated',
                    ],
                  },
                  {
                    type: 'object',
                    properties: {
                      invocation: {
                        $ref: '#/$defs/SkillInvocationMode',
                      },
                      request: {
                        type: 'string',
                      },
                      success: {
                        const: false,
                      },
                      reason: {
                        $ref: '#/$defs/SkillFailureReason',
                      },
                    },
                    additionalProperties: false,
                    required: ['invocation', 'request', 'success', 'reason'],
                  },
                ],
              },
              SkillInvocationMode: {
                type: 'string',
                enum: ['explicit', 'model_tool'],
              },
              SkillScope: {
                type: 'string',
                enum: ['project', 'workspace', 'user', 'custom'],
              },
              SkillSource: {
                type: 'string',
                enum: ['maka', 'agents', 'legacy', 'custom'],
              },
            },
          },
          resources: {},
        },
        execution: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentExecutionRead',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
              invocationId: {
                type: 'string',
                minLength: 1,
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'invocationId'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentExecutionResult',
            oneOf: [
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'missing',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  execution: {
                    $ref: '#/$defs/AgentExecution',
                  },
                  kind: {
                    type: 'string',
                    const: 'found',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'execution'],
              },
            ],
            $defs: {
              AgentExecution: {
                description:
                  'Canonical physical execution receipt, independent of the current Session tip.',
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  turnId: {
                    type: 'string',
                  },
                  runId: {
                    type: 'string',
                  },
                  invocationId: {
                    type: 'string',
                  },
                  highWater: {
                    description: 'Run-local event count, not the root-global transcript cursor.',
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  state: {
                    $ref: '#/$defs/AgentExecutionState',
                  },
                },
                additionalProperties: false,
                required: ['sessionId', 'turnId', 'runId', 'invocationId', 'highWater', 'state'],
              },
              AgentExecutionState: {
                type: 'string',
                enum: [
                  'admitted',
                  'running',
                  'waiting',
                  'paused',
                  'completed',
                  'failed',
                  'cancelled',
                ],
              },
            },
          },
          resources: {},
        },
        executorSetup: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              executor: {
                type: 'string',
                minLength: 1,
              },
              action: {
                $ref: '#/$defs/ExecutorSetupAction',
              },
            },
            required: ['executor', 'action'],
            title: 'AgentExecutorSetup',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              ExecutorSetupAction: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'check',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      methodId: {
                        type: 'string',
                        minLength: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'authenticate',
                      },
                    },
                    required: ['kind', 'methodId'],
                  },
                ],
              },
            },
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  info: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ExecutorSetupInfo',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  methods: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/ExecutorAuthenticationMethod',
                    },
                  },
                  kind: {
                    type: 'string',
                    const: 'checked',
                  },
                },
                required: ['kind', 'methods'],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'authenticated',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  diagnostic: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'unresolved',
                  },
                },
                required: ['kind', 'diagnostic'],
                description:
                  'No authentication confirmation was observed; never automatically replay it.',
              },
            ],
            title: 'ExecutorSetupResult',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              ExecutorSetupInfo: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  title: {
                    type: ['string', 'null'],
                  },
                  name: {
                    type: 'string',
                  },
                  version: {
                    type: 'string',
                  },
                },
                required: ['name', 'version'],
              },
              ExecutorAuthenticationMethod: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  id: {
                    type: 'string',
                    minLength: 1,
                  },
                  name: {
                    type: 'string',
                    minLength: 1,
                  },
                  description: {
                    type: ['string', 'null'],
                  },
                  supported: {
                    type: 'boolean',
                  },
                },
                required: ['id', 'name', 'supported'],
              },
            },
          },
          progress: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  url: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'authorization_url',
                  },
                },
                required: ['kind', 'url'],
              },
            ],
            title: 'ExecutorSetupProgress',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          resources: {},
        },
        executors: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentExecutorsRead',
            type: 'object',
            additionalProperties: false,
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentExecutors',
            type: 'object',
            properties: {
              executors: {
                type: 'array',
                items: {
                  type: 'string',
                },
              },
              setup: {
                type: 'array',
                items: {
                  type: 'string',
                },
              },
            },
            additionalProperties: false,
            required: ['executors', 'setup'],
          },
          resources: {},
        },
        fork: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentFork',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
              expectedRevision: {
                type: 'integer',
                format: 'uint64',
                minimum: 1,
                maximum: 9007199254740991,
              },
              turnId: {
                description:
                  'Include history through a complete logical Turn, or all current history when null.',
                type: ['string', 'null'],
                minLength: 1,
              },
              title: {
                type: 'string',
                minLength: 1,
              },
              labels: {
                type: 'array',
                items: {
                  type: 'string',
                },
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'expectedRevision', 'turnId', 'title', 'labels'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentForkResult',
            oneOf: [
              {
                type: 'object',
                properties: {
                  session: {
                    $ref: '#/$defs/AgentSession',
                  },
                  kind: {
                    type: 'string',
                    const: 'forked',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'session'],
              },
              {
                type: 'object',
                properties: {
                  expected: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  actual: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'revision_conflict',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'expected', 'actual'],
              },
              {
                type: 'object',
                properties: {
                  reason: {
                    $ref: '#/$defs/AgentRejection',
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'reason'],
              },
            ],
            $defs: {
              AgentSession: {
                type: 'object',
                properties: {
                  branch: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentSessionBranch',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  backend: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentBackendPreference',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  collaborationMode: {
                    $ref: '#/$defs/CollaborationMode',
                    default: 'agent',
                  },
                  tools: {
                    type: ['array', 'null'],
                    items: {
                      type: 'string',
                    },
                  },
                  dataSource: {
                    $ref: '#/$defs/AgentDataSource',
                  },
                  permissions: {
                    $ref: '#/$defs/AgentWorkspacePermissions',
                  },
                  boundaryRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  id: {
                    type: 'string',
                  },
                  title: {
                    type: 'string',
                  },
                  labels: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  workspace: {
                    $ref: '#/$defs/AgentWorkspace',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  updatedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  archived: {
                    type: 'boolean',
                  },
                  hasUnread: {
                    type: 'boolean',
                  },
                  activity: {
                    $ref: '#/$defs/AgentSessionActivity',
                  },
                },
                additionalProperties: false,
                required: [
                  'branch',
                  'dataSource',
                  'permissions',
                  'boundaryRevision',
                  'id',
                  'title',
                  'labels',
                  'workspace',
                  'revision',
                  'updatedAt',
                  'archived',
                  'hasUnread',
                  'activity',
                ],
              },
              AgentSessionBranch: {
                description:
                  'Frozen conversation ancestry for presentation, not authority over the source.',
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                    minLength: 1,
                  },
                  turnId: {
                    type: ['string', 'null'],
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['sessionId', 'turnId'],
              },
              AgentBackendPreference: {
                description:
                  "The next turn's choice, independent of an already admitted execution.\nModel revisions are resolved afresh; preferences never grant execution authority.",
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      connectionId: {
                        type: 'string',
                        minLength: 1,
                      },
                      modelId: {
                        type: 'string',
                        minLength: 1,
                      },
                      thinkingLevel: {
                        anyOf: [
                          {
                            $ref: '#/$defs/ThinkingLevel',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'model',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'connectionId', 'modelId'],
                  },
                  {
                    type: 'object',
                    properties: {
                      selection: {
                        $ref: '#/$defs/AgentExecutorSelection',
                      },
                      kind: {
                        type: 'string',
                        const: 'executor',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'selection'],
                  },
                ],
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
              AgentExecutorSelection: {
                type: 'object',
                properties: {
                  executor: {
                    type: 'string',
                    minLength: 1,
                  },
                  settings: {
                    $ref: '#/$defs/ExecutorSettings',
                  },
                },
                additionalProperties: false,
                required: ['executor', 'settings'],
              },
              ExecutorSettings: {
                description:
                  'Executor-owned model selection, independent of Host model connections.',
                type: 'object',
                properties: {
                  model: {
                    type: ['string', 'null'],
                  },
                  thinkingLevel: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ThinkingLevel',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
              },
              CollaborationMode: {
                type: 'string',
                enum: ['agent', 'plan'],
              },
              AgentDataSource: {
                description:
                  'Stable business-data origin, independent of package or activation revisions.',
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  namespace: {
                    $ref: '#/$defs/InstanceId',
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'namespace'],
              },
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
              AgentWorkspacePermissions: {
                type: 'object',
                properties: {
                  access: {
                    $ref: '#/$defs/AgentWorkspaceAccess',
                  },
                  requestPermissions: {
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: ['access', 'requestPermissions'],
              },
              AgentWorkspaceAccess: {
                description:
                  'Session sandbox policy. Full access explicitly disables filesystem and process isolation.',
                type: 'string',
                enum: ['read_only', 'workspace_write', 'danger_full_access'],
              },
              AgentWorkspace: {
                type: 'object',
                properties: {
                  worktree: {
                    description:
                      'Native owner allocation; never accepted from a caller as workspace authority.',
                    anyOf: [
                      {
                        $ref: '#/$defs/Binding',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  projectId: {
                    description: "Optional membership in this Agent's canonical Project catalog.",
                    type: ['string', 'null'],
                    format: 'uuid',
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  identity: {
                    type: 'string',
                    pattern: '^workspace:v1:[A-Fa-f0-9-]{36}$',
                  },
                },
                additionalProperties: false,
                required: ['path', 'directoryIdentity', 'identity'],
              },
              Binding: {
                description: 'Immutable allocation intent, not the current child branch or HEAD.',
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  common_dir: {
                    type: 'string',
                  },
                  source: {
                    type: 'string',
                  },
                  source_identity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  base_commit: {
                    type: 'string',
                  },
                  directory: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: [
                  'id',
                  'common_dir',
                  'source',
                  'source_identity',
                  'base_commit',
                  'directory',
                ],
              },
              AgentSessionActivity: {
                type: 'string',
                enum: ['idle', 'working', 'waiting'],
              },
              AgentRejection: {
                type: 'string',
                enum: [
                  'title_invalid',
                  'labels_invalid',
                  'tools_unavailable',
                  'busy',
                  'workspace_unavailable',
                  'session_unavailable',
                  'history_unavailable',
                  'managed_session',
                  'closed',
                ],
              },
            },
          },
          resources: {},
        },
        forkReceipt: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentForkReceipt',
            type: 'object',
            properties: {
              reference: {
                description:
                  'The complete original fork operation reference, including its fingerprint.',
                $ref: '#/$defs/RecoveryRef',
              },
            },
            additionalProperties: false,
            required: ['reference'],
            $defs: {
              RecoveryRef: {
                type: 'object',
                properties: {
                  source: {
                    $ref: '#/$defs/DeploymentRef',
                  },
                  namespace: {
                    $ref: '#/$defs/InstanceId',
                  },
                  export: {
                    type: 'string',
                  },
                  method: {
                    type: 'string',
                  },
                  operation: {
                    type: 'string',
                    format: 'uuid',
                  },
                  fingerprint: {
                    type: 'string',
                  },
                  contract: {
                    $ref: '#/$defs/RecoveryContract',
                  },
                  recovery: {
                    $ref: '#/$defs/RecoveryProtocol',
                  },
                },
                additionalProperties: false,
                required: [
                  'source',
                  'namespace',
                  'export',
                  'method',
                  'operation',
                  'fingerprint',
                  'contract',
                  'recovery',
                ],
              },
              DeploymentRef: {
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'revision'],
              },
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
              RecoveryContract: {
                description:
                  'Contract identity for a journal lookup. The original request retains the\ncomplete contract; a receipt carries only its digest.',
                type: 'object',
                properties: {
                  name: {
                    type: 'string',
                  },
                  version: {
                    type: 'integer',
                    format: 'uint32',
                    minimum: 0,
                  },
                  transport: {
                    $ref: '#/$defs/Transport',
                  },
                  digest: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['name', 'version', 'transport', 'digest'],
              },
              Transport: {
                type: 'string',
                enum: ['local', 'remote'],
              },
              RecoveryProtocol: {
                type: 'string',
                enum: ['journal_v1'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentForkReceiptResult',
            type: 'object',
            properties: {
              session: {
                description:
                  'A currently readable published fork. Null neither proves no effect nor\nauthorizes replacing or redispatching the original operation.',
                anyOf: [
                  {
                    $ref: '#/$defs/AgentSession',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
            },
            additionalProperties: false,
            required: ['session'],
            $defs: {
              AgentSession: {
                type: 'object',
                properties: {
                  branch: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentSessionBranch',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  backend: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentBackendPreference',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  collaborationMode: {
                    $ref: '#/$defs/CollaborationMode',
                    default: 'agent',
                  },
                  tools: {
                    type: ['array', 'null'],
                    items: {
                      type: 'string',
                    },
                  },
                  dataSource: {
                    $ref: '#/$defs/AgentDataSource',
                  },
                  permissions: {
                    $ref: '#/$defs/AgentWorkspacePermissions',
                  },
                  boundaryRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  id: {
                    type: 'string',
                  },
                  title: {
                    type: 'string',
                  },
                  labels: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  workspace: {
                    $ref: '#/$defs/AgentWorkspace',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  updatedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  archived: {
                    type: 'boolean',
                  },
                  hasUnread: {
                    type: 'boolean',
                  },
                  activity: {
                    $ref: '#/$defs/AgentSessionActivity',
                  },
                },
                additionalProperties: false,
                required: [
                  'branch',
                  'dataSource',
                  'permissions',
                  'boundaryRevision',
                  'id',
                  'title',
                  'labels',
                  'workspace',
                  'revision',
                  'updatedAt',
                  'archived',
                  'hasUnread',
                  'activity',
                ],
              },
              AgentSessionBranch: {
                description:
                  'Frozen conversation ancestry for presentation, not authority over the source.',
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                    minLength: 1,
                  },
                  turnId: {
                    type: ['string', 'null'],
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['sessionId', 'turnId'],
              },
              AgentBackendPreference: {
                description:
                  "The next turn's choice, independent of an already admitted execution.\nModel revisions are resolved afresh; preferences never grant execution authority.",
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      connectionId: {
                        type: 'string',
                        minLength: 1,
                      },
                      modelId: {
                        type: 'string',
                        minLength: 1,
                      },
                      thinkingLevel: {
                        anyOf: [
                          {
                            $ref: '#/$defs/ThinkingLevel',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'model',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'connectionId', 'modelId'],
                  },
                  {
                    type: 'object',
                    properties: {
                      selection: {
                        $ref: '#/$defs/AgentExecutorSelection',
                      },
                      kind: {
                        type: 'string',
                        const: 'executor',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'selection'],
                  },
                ],
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
              AgentExecutorSelection: {
                type: 'object',
                properties: {
                  executor: {
                    type: 'string',
                    minLength: 1,
                  },
                  settings: {
                    $ref: '#/$defs/ExecutorSettings',
                  },
                },
                additionalProperties: false,
                required: ['executor', 'settings'],
              },
              ExecutorSettings: {
                description:
                  'Executor-owned model selection, independent of Host model connections.',
                type: 'object',
                properties: {
                  model: {
                    type: ['string', 'null'],
                  },
                  thinkingLevel: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ThinkingLevel',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
              },
              CollaborationMode: {
                type: 'string',
                enum: ['agent', 'plan'],
              },
              AgentDataSource: {
                description:
                  'Stable business-data origin, independent of package or activation revisions.',
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  namespace: {
                    $ref: '#/$defs/InstanceId',
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'namespace'],
              },
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
              AgentWorkspacePermissions: {
                type: 'object',
                properties: {
                  access: {
                    $ref: '#/$defs/AgentWorkspaceAccess',
                  },
                  requestPermissions: {
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: ['access', 'requestPermissions'],
              },
              AgentWorkspaceAccess: {
                description:
                  'Session sandbox policy. Full access explicitly disables filesystem and process isolation.',
                type: 'string',
                enum: ['read_only', 'workspace_write', 'danger_full_access'],
              },
              AgentWorkspace: {
                type: 'object',
                properties: {
                  worktree: {
                    description:
                      'Native owner allocation; never accepted from a caller as workspace authority.',
                    anyOf: [
                      {
                        $ref: '#/$defs/Binding',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  projectId: {
                    description: "Optional membership in this Agent's canonical Project catalog.",
                    type: ['string', 'null'],
                    format: 'uuid',
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  identity: {
                    type: 'string',
                    pattern: '^workspace:v1:[A-Fa-f0-9-]{36}$',
                  },
                },
                additionalProperties: false,
                required: ['path', 'directoryIdentity', 'identity'],
              },
              Binding: {
                description: 'Immutable allocation intent, not the current child branch or HEAD.',
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  common_dir: {
                    type: 'string',
                  },
                  source: {
                    type: 'string',
                  },
                  source_identity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  base_commit: {
                    type: 'string',
                  },
                  directory: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: [
                  'id',
                  'common_dir',
                  'source',
                  'source_identity',
                  'base_commit',
                  'directory',
                ],
              },
              AgentSessionActivity: {
                type: 'string',
                enum: ['idle', 'working', 'waiting'],
              },
            },
          },
          resources: {},
        },
        generateRecap: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentRecapGenerate',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
              },
              model: {
                $ref: '#/$defs/ModelSelection',
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'model'],
            $defs: {
              ModelSelection: {
                description:
                  'Exact public selection observed by a caller, checked once at run admission.',
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                    minLength: 1,
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  modelId: {
                    type: 'string',
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'revision', 'modelId'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentRecapReceipt',
            oneOf: [
              {
                type: 'object',
                properties: {
                  operationId: {
                    type: 'string',
                    format: 'uuid',
                  },
                  through: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'pending',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'operationId', 'through'],
              },
              {
                type: 'object',
                properties: {
                  operationId: {
                    type: 'string',
                    format: 'uuid',
                  },
                  through: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  text: {
                    type: 'string',
                  },
                  modelId: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'ready',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'operationId', 'through', 'text', 'modelId'],
              },
              {
                type: 'object',
                properties: {
                  operationId: {
                    type: 'string',
                    format: 'uuid',
                  },
                  through: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  reason: {
                    $ref: '#/$defs/AgentRecapFailure',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'operationId', 'through', 'reason'],
              },
            ],
            $defs: {
              AgentRecapFailure: {
                type: 'string',
                enum: ['empty_or_oversized_output', 'incomplete_output', 'model_unavailable'],
              },
            },
          },
          resources: {},
        },
        gitDiff: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentGitDiffRead',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
              },
              area: {
                $ref: '#/$defs/GitArea',
              },
              path: {
                $ref: '#/$defs/WorkspacePath',
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'area', 'path'],
            $defs: {
              GitArea: {
                type: 'string',
                enum: ['staged', 'worktree', 'untracked'],
              },
              WorkspacePath: {
                type: 'object',
                properties: {
                  bytesBase64: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['bytesBase64'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'Nullable_GitDiff',
            anyOf: [
              {
                $ref: '#/$defs/GitDiff',
              },
              {
                type: 'null',
              },
            ],
            $defs: {
              GitDiff: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      patch: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'text',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'patch'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'binary',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'unchanged',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'unsupported',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                ],
              },
            },
          },
          resources: {},
        },
        gitStatus: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentSessionRead',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
            },
            additionalProperties: false,
            required: ['sessionId'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'Nullable_GitStatus',
            anyOf: [
              {
                $ref: '#/$defs/GitStatus',
              },
              {
                type: 'null',
              },
            ],
            $defs: {
              GitStatus: {
                type: 'object',
                properties: {
                  head: {
                    type: ['string', 'null'],
                  },
                  entries: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/GitStatusEntry',
                    },
                  },
                },
                additionalProperties: false,
                required: ['head', 'entries'],
              },
              GitStatusEntry: {
                type: 'object',
                properties: {
                  area: {
                    $ref: '#/$defs/GitArea',
                  },
                  path: {
                    $ref: '#/$defs/WorkspacePath',
                  },
                  kind: {
                    $ref: '#/$defs/GitChangeKind',
                  },
                },
                additionalProperties: false,
                required: ['area', 'path', 'kind'],
              },
              GitArea: {
                type: 'string',
                enum: ['staged', 'worktree', 'untracked'],
              },
              WorkspacePath: {
                type: 'object',
                properties: {
                  bytesBase64: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['bytesBase64'],
              },
              GitChangeKind: {
                type: 'string',
                enum: ['added', 'modified', 'deleted', 'type_changed', 'conflicted'],
              },
            },
          },
          resources: {},
        },
        globalInstructions: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentGlobalInstructionsRead',
            type: 'object',
            additionalProperties: false,
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentGlobalInstructionsView',
            oneOf: [
              {
                type: 'object',
                properties: {
                  source: {
                    $ref: '#/$defs/AgentGlobalInstructionSource',
                  },
                  path: {
                    type: 'string',
                  },
                  revision: {
                    type: 'string',
                  },
                  content: {
                    type: 'string',
                  },
                  exists: {
                    type: 'boolean',
                  },
                  kind: {
                    type: 'string',
                    const: 'available',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'source', 'path', 'revision', 'content', 'exists'],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'unavailable',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
            ],
            $defs: {
              AgentGlobalInstructionSource: {
                type: 'string',
                enum: ['maka', 'agents'],
              },
            },
          },
          resources: {},
        },
        goal: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentGoalRead',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
              },
            },
            additionalProperties: false,
            required: ['sessionId'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentGoalView',
            type: 'object',
            properties: {
              enabled: {
                type: 'boolean',
              },
              current: {
                anyOf: [
                  {
                    $ref: '#/$defs/AgentGoalDetail',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
            },
            additionalProperties: false,
            required: ['enabled'],
            $defs: {
              AgentGoalDetail: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  objective: {
                    type: 'string',
                  },
                  status: {
                    $ref: '#/$defs/GoalStatus',
                  },
                  iterations: {
                    type: 'integer',
                    format: 'uint32',
                    minimum: 0,
                  },
                  maxIterations: {
                    type: 'integer',
                    format: 'uint32',
                    minimum: 0,
                  },
                  tokenBudget: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  consumed: {
                    $ref: '#/$defs/GoalMeter',
                  },
                  pending: {
                    type: 'boolean',
                  },
                  report: {
                    anyOf: [
                      {
                        $ref: '#/$defs/GoalReport',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  note: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: [
                  'id',
                  'revision',
                  'objective',
                  'status',
                  'iterations',
                  'maxIterations',
                  'consumed',
                  'pending',
                  'note',
                ],
              },
              GoalStatus: {
                type: 'string',
                enum: [
                  'armed',
                  'active',
                  'paused',
                  'waiting',
                  'achieved',
                  'impossible',
                  'cancelled',
                  'cancellation_unknown',
                  'max_iterations',
                  'budget_limited',
                  'budget_unknown',
                  'blocked',
                ],
              },
              GoalMeter: {
                type: 'object',
                properties: {
                  known: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  missing: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                required: ['known', 'missing'],
              },
              GoalReport: {
                type: 'object',
                properties: {
                  status: {
                    $ref: '#/$defs/GoalReportKind',
                  },
                  note: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['status', 'note'],
              },
              GoalReportKind: {
                type: 'string',
                enum: ['progress', 'achieved', 'waiting', 'impossible'],
              },
            },
          },
          resources: {},
        },
        goalReceipt: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentGoalReceiptRead',
            type: 'object',
            properties: {
              reference: {
                $ref: '#/$defs/RecoveryRef',
              },
            },
            additionalProperties: false,
            required: ['reference'],
            $defs: {
              RecoveryRef: {
                type: 'object',
                properties: {
                  source: {
                    $ref: '#/$defs/DeploymentRef',
                  },
                  namespace: {
                    $ref: '#/$defs/InstanceId',
                  },
                  export: {
                    type: 'string',
                  },
                  method: {
                    type: 'string',
                  },
                  operation: {
                    type: 'string',
                    format: 'uuid',
                  },
                  fingerprint: {
                    type: 'string',
                  },
                  contract: {
                    $ref: '#/$defs/RecoveryContract',
                  },
                  recovery: {
                    $ref: '#/$defs/RecoveryProtocol',
                  },
                },
                additionalProperties: false,
                required: [
                  'source',
                  'namespace',
                  'export',
                  'method',
                  'operation',
                  'fingerprint',
                  'contract',
                  'recovery',
                ],
              },
              DeploymentRef: {
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'revision'],
              },
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
              RecoveryContract: {
                description:
                  'Contract identity for a journal lookup. The original request retains the\ncomplete contract; a receipt carries only its digest.',
                type: 'object',
                properties: {
                  name: {
                    type: 'string',
                  },
                  version: {
                    type: 'integer',
                    format: 'uint32',
                    minimum: 0,
                  },
                  transport: {
                    $ref: '#/$defs/Transport',
                  },
                  digest: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['name', 'version', 'transport', 'digest'],
              },
              Transport: {
                type: 'string',
                enum: ['local', 'remote'],
              },
              RecoveryProtocol: {
                type: 'string',
                enum: ['journal_v1'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'Nullable_AgentGoalResult',
            anyOf: [
              {
                $ref: '#/$defs/AgentGoalResult',
              },
              {
                type: 'null',
              },
            ],
            $defs: {
              AgentGoalResult: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      goalId: {
                        type: 'string',
                        format: 'uuid',
                      },
                      revision: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'committed',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'goalId', 'revision'],
                  },
                  {
                    type: 'object',
                    properties: {
                      actual: {
                        type: ['integer', 'null'],
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'conflict',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind'],
                  },
                  {
                    type: 'object',
                    properties: {
                      reason: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'rejected',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'reason'],
                  },
                ],
              },
            },
          },
          resources: {},
        },
        history: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentHistoryRead',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
              through: {
                type: ['integer', 'null'],
                format: 'uint64',
                minimum: 0,
                maximum: 9007199254740991,
              },
              position: {
                $ref: '#/$defs/HistoryPosition',
              },
              includeThinking: {
                type: 'boolean',
                default: false,
              },
              view: {
                $ref: '#/$defs/HistoryView',
                default: 'text',
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'position'],
            $defs: {
              HistoryPosition: {
                description:
                  'Row reveals an exact field; Before/After continue at byte boundaries and\nEvent addresses the raw event log. Returned chunks retain ascending source\norder, including a reverse window.',
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'start',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'tail',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    description:
                      'Reveal this exact row field from its beginning, including empty tool rows.',
                    type: 'object',
                    properties: {
                      position: {
                        $ref: '#/$defs/HistoryRowPosition',
                      },
                      field: {
                        $ref: '#/$defs/HistoryField',
                      },
                      kind: {
                        type: 'string',
                        const: 'row',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'position', 'field'],
                  },
                  {
                    type: 'object',
                    properties: {
                      cursor: {
                        $ref: '#/$defs/Cursor',
                      },
                      kind: {
                        type: 'string',
                        const: 'before',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'cursor'],
                  },
                  {
                    type: 'object',
                    properties: {
                      cursor: {
                        $ref: '#/$defs/Cursor',
                      },
                      kind: {
                        type: 'string',
                        const: 'after',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'cursor'],
                  },
                  {
                    description:
                      'Locate canonical output at an execution event, including sparse rows.',
                    type: 'object',
                    properties: {
                      sequence: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 1,
                        maximum: 9007199254740991,
                      },
                      kind: {
                        type: 'string',
                        const: 'event',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'sequence'],
                  },
                ],
              },
              HistoryRowPosition: {
                description:
                  'Disposable presentation locator, never authority or a canonical execution fact.\nThe source is the original emitting fact; the index precedes UI filtering.',
                type: 'object',
                properties: {
                  sourceSequence: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  itemIndex: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                },
                additionalProperties: false,
                required: ['sourceSequence', 'itemIndex'],
              },
              HistoryField: {
                description: 'A readable field in a conversation window, in presentation order.',
                type: 'string',
                enum: ['thinking', 'body'],
              },
              Cursor: {
                description:
                  "Byte offset in one message field's UTF-8 text, not a bearer capability.",
                type: 'object',
                properties: {
                  field: {
                    $ref: '#/$defs/HistoryField',
                    default: 'body',
                  },
                  position: {
                    $ref: '#/$defs/HistoryRowPosition',
                  },
                  offset: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                },
                additionalProperties: false,
                required: ['position', 'offset'],
              },
              HistoryView: {
                description:
                  'Tool output is available through source reads in both views. Conversation\nwindows carry tool metadata only, keeping large results out of chat paging.',
                type: 'string',
                enum: ['text', 'conversation'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentHistoryPage',
            oneOf: [
              {
                type: 'object',
                properties: {
                  through: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  chunks: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/AgentHistoryChunk',
                    },
                  },
                  before: {
                    anyOf: [
                      {
                        $ref: '#/$defs/Cursor',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  after: {
                    anyOf: [
                      {
                        $ref: '#/$defs/Cursor',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  kind: {
                    type: 'string',
                    const: 'ready',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'through', 'chunks', 'before', 'after'],
              },
            ],
            $defs: {
              AgentHistoryChunk: {
                type: 'object',
                properties: {
                  finalOutput: {
                    description:
                      "Part of the successfully completed native Turn's final output at `through`.\nIncludes all body parts and source citations; never a Thinking field.",
                    type: 'boolean',
                  },
                  model: {
                    anyOf: [
                      {
                        $ref: '#/$defs/HistoryModel',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  origin: {
                    anyOf: [
                      {
                        $ref: '#/$defs/MessageOrigin',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  compaction: {
                    anyOf: [
                      {
                        $ref: '#/$defs/HistoryCompaction',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  attachments: {
                    description:
                      'Display metadata only, on the first user-message fragment; no storage capability.',
                    type: 'array',
                    items: {
                      $ref: '#/$defs/AgentHistoryAttachment',
                    },
                  },
                  timing: {
                    anyOf: [
                      {
                        $ref: '#/$defs/HistoryTurnTiming',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  field: {
                    $ref: '#/$defs/HistoryField',
                  },
                  messageId: {
                    type: 'string',
                  },
                  turnId: {
                    type: 'string',
                  },
                  timestamp: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  role: {
                    $ref: '#/$defs/Role',
                  },
                  position: {
                    $ref: '#/$defs/HistoryRowPosition',
                  },
                  offset: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  totalBytes: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  text: {
                    type: 'string',
                  },
                  tool: {
                    anyOf: [
                      {
                        $ref: '#/$defs/HistoryTool',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
                required: [
                  'field',
                  'messageId',
                  'turnId',
                  'timestamp',
                  'role',
                  'position',
                  'offset',
                  'totalBytes',
                  'text',
                  'tool',
                ],
              },
              HistoryModel: {
                description: 'Model identity recorded for the exact historical assistant step.',
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      requestedModelId: {
                        type: 'string',
                      },
                      reportedModelId: {
                        type: ['string', 'null'],
                      },
                      kind: {
                        type: 'string',
                        const: 'native',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'requestedModelId', 'reportedModelId'],
                  },
                  {
                    type: 'object',
                    properties: {
                      modelId: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'imported',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'modelId'],
                  },
                ],
              },
              MessageOrigin: {
                description:
                  'Trusted producer attribution, preserved independently of editable content.',
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      taskId: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'workhub_task',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'taskId'],
                  },
                  {
                    type: 'object',
                    properties: {
                      graphId: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'workhub_graph',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'graphId'],
                  },
                ],
              },
              HistoryCompaction: {
                description:
                  'Duration of a successfully adopted context checkpoint, in recorded milliseconds.',
                type: 'object',
                properties: {
                  durationMs: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                },
                additionalProperties: false,
                required: ['durationMs'],
              },
              AgentHistoryAttachment: {
                type: 'object',
                properties: {
                  name: {
                    type: 'string',
                  },
                  mimeType: {
                    type: 'string',
                  },
                  bytes: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    $ref: '#/$defs/AttachmentKind',
                  },
                },
                additionalProperties: false,
                required: ['name', 'mimeType', 'bytes', 'kind'],
              },
              AttachmentKind: {
                type: 'string',
                enum: ['image', 'pdf', 'doc', 'code', 'other'],
              },
              HistoryTurnTiming: {
                description:
                  'Recorded logical Turn boundaries at the same history fence. An unfinished\nhistorical boundary alone does not establish that execution is still live.',
                type: 'object',
                properties: {
                  startedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                  finished: {
                    anyOf: [
                      {
                        $ref: '#/$defs/HistoryTurnFinished',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
                required: ['startedAt', 'finished'],
              },
              HistoryTurnFinished: {
                type: 'object',
                properties: {
                  at: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                  outcome: {
                    $ref: '#/$defs/HistoryTurnOutcome',
                  },
                },
                additionalProperties: false,
                required: ['at', 'outcome'],
              },
              HistoryTurnOutcome: {
                type: 'string',
                enum: ['completed', 'failed', 'aborted'],
              },
              HistoryField: {
                description: 'A readable field in a conversation window, in presentation order.',
                type: 'string',
                enum: ['thinking', 'body'],
              },
              Role: {
                description:
                  'Canonical message author/kind; the field identifies body versus thinking.\nTool body JSON contributes string values, never its keys.',
                type: 'string',
                enum: ['compaction', 'failure', 'user', 'assistant', 'tool_call', 'tool_result'],
              },
              HistoryRowPosition: {
                description:
                  'Disposable presentation locator, never authority or a canonical execution fact.\nThe source is the original emitting fact; the index precedes UI filtering.',
                type: 'object',
                properties: {
                  sourceSequence: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  itemIndex: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                },
                additionalProperties: false,
                required: ['sourceSequence', 'itemIndex'],
              },
              HistoryTool: {
                description:
                  'Canonical references at the requested fence, never execution authority.\nBoth references are present only for a unique same-Turn call/result pair\nwith matching origin and parentage. An unpaired row retains its own reference.',
                type: 'object',
                properties: {
                  toolUseId: {
                    type: 'string',
                  },
                  call: {
                    anyOf: [
                      {
                        $ref: '#/$defs/HistoryToolCall',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  result: {
                    anyOf: [
                      {
                        $ref: '#/$defs/HistoryToolResult',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
                required: ['toolUseId', 'call', 'result'],
              },
              HistoryToolCall: {
                type: 'object',
                properties: {
                  ancestorToolUseIds: {
                    description:
                      'Recorded ancestors in this Turn, nearest first; display references only.',
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  presentation: {
                    description:
                      'Opaque display contract captured at dispatch; no execution authority.',
                    type: ['string', 'null'],
                    default: null,
                  },
                  position: {
                    $ref: '#/$defs/HistoryRowPosition',
                  },
                  name: {
                    type: 'string',
                  },
                  title: {
                    anyOf: [
                      {
                        $ref: '#/$defs/DisplayText',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  pending: {
                    description:
                      'This native Turn is still open at the history fence; not execution authority.',
                    type: 'boolean',
                  },
                  dispatched: {
                    description:
                      'A unique original Host dispatch is recorded at this fence; not liveness.',
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: [
                  'ancestorToolUseIds',
                  'position',
                  'name',
                  'title',
                  'pending',
                  'dispatched',
                ],
              },
              DisplayText: {
                description:
                  'Presentation text is distinct from the stable identity used for navigation.',
                type: 'object',
                properties: {
                  fallback: {
                    type: 'string',
                  },
                  translations: {
                    type: 'object',
                    additionalProperties: {
                      type: 'string',
                    },
                    default: {},
                  },
                },
                additionalProperties: false,
                required: ['fallback'],
              },
              HistoryToolResult: {
                type: 'object',
                properties: {
                  settlement: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ToolSettlement',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  position: {
                    $ref: '#/$defs/HistoryRowPosition',
                  },
                  isError: {
                    description: 'Does not distinguish failed from unknown effects.',
                    type: 'boolean',
                  },
                  image: {
                    description:
                      'Canonical content is an image; this does not grant artifact reads.',
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: ['settlement', 'position', 'isError', 'image'],
              },
              ToolSettlement: {
                description:
                  'Recorded Host settlement for presentation; returned is not business success.\nForeign/provider results do not establish this Host evidence.',
                type: 'string',
                enum: ['returned', 'failed', 'unknown', 'rejected'],
              },
              Cursor: {
                description:
                  "Byte offset in one message field's UTF-8 text, not a bearer capability.",
                type: 'object',
                properties: {
                  field: {
                    $ref: '#/$defs/HistoryField',
                    default: 'body',
                  },
                  position: {
                    $ref: '#/$defs/HistoryRowPosition',
                  },
                  offset: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                },
                additionalProperties: false,
                required: ['position', 'offset'],
              },
            },
          },
          resources: {},
        },
        historyLandmarks: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentHistoryLandmarksRead',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
              through: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
                maximum: 9007199254740991,
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'through'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentHistoryLandmarks',
            description:
              'Sampled canonical display positions, not a complete Turn outline or an\nexecution grant.',
            type: 'object',
            properties: {
              through: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
                maximum: 9007199254740991,
              },
              landmarks: {
                type: 'array',
                items: {
                  $ref: '#/$defs/AgentHistoryLandmark',
                },
                maxItems: 64,
              },
            },
            additionalProperties: false,
            required: ['through', 'landmarks'],
            $defs: {
              AgentHistoryLandmark: {
                type: 'object',
                properties: {
                  turnId: {
                    type: 'string',
                    minLength: 1,
                  },
                  position: {
                    $ref: '#/$defs/HistoryRowPosition',
                  },
                  lastPosition: {
                    $ref: '#/$defs/HistoryRowPosition',
                  },
                  label: {
                    type: 'string',
                    maxLength: 96,
                  },
                },
                additionalProperties: false,
                required: ['turnId', 'position', 'lastPosition', 'label'],
              },
              HistoryRowPosition: {
                description:
                  'Disposable presentation locator, never authority or a canonical execution fact.\nThe source is the original emitting fact; the index precedes UI filtering.',
                type: 'object',
                properties: {
                  sourceSequence: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  itemIndex: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                },
                additionalProperties: false,
                required: ['sourceSequence', 'itemIndex'],
              },
            },
          },
          resources: {},
        },
        historyPrompt: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentHistoryPromptRead',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
              through: {
                type: 'integer',
                format: 'uint64',
                minimum: 1,
                maximum: 9007199254740991,
              },
              position: {
                $ref: '#/$defs/HistoryRowPosition',
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'through', 'position'],
            $defs: {
              HistoryRowPosition: {
                description:
                  'Disposable presentation locator, never authority or a canonical execution fact.\nThe source is the original emitting fact; the index precedes UI filtering.',
                type: 'object',
                properties: {
                  sourceSequence: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  itemIndex: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                },
                additionalProperties: false,
                required: ['sourceSequence', 'itemIndex'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'Nullable_AgentHistoryPrompt',
            anyOf: [
              {
                $ref: '#/$defs/AgentHistoryPrompt',
              },
              {
                type: 'null',
              },
            ],
            $defs: {
              AgentHistoryPrompt: {
                description:
                  'A bounded presentation preview; the original message remains in history.',
                type: 'object',
                properties: {
                  position: {
                    $ref: '#/$defs/HistoryRowPosition',
                  },
                  text: {
                    type: 'string',
                    maxLength: 4096,
                  },
                },
                additionalProperties: false,
                required: ['position', 'text'],
              },
              HistoryRowPosition: {
                description:
                  'Disposable presentation locator, never authority or a canonical execution fact.\nThe source is the original emitting fact; the index precedes UI filtering.',
                type: 'object',
                properties: {
                  sourceSequence: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  itemIndex: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                },
                additionalProperties: false,
                required: ['sourceSequence', 'itemIndex'],
              },
            },
          },
          resources: {},
        },
        import: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentImportChange',
            oneOf: [
              {
                type: 'object',
                properties: {
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                  id: {
                    type: ['string', 'null'],
                    format: 'uuid',
                  },
                  name: {
                    type: 'string',
                    minLength: 1,
                  },
                  location: {
                    $ref: '#/$defs/AgentImportLocation',
                  },
                  kind: {
                    type: 'string',
                    const: 'save_source',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'revision', 'id', 'name', 'location'],
              },
              {
                type: 'object',
                properties: {
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                  id: {
                    type: 'string',
                    format: 'uuid',
                  },
                  kind: {
                    type: 'string',
                    const: 'remove_source',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'revision', 'id'],
              },
              {
                type: 'object',
                properties: {
                  selection: {
                    $ref: '#/$defs/AgentImportSelection',
                  },
                  directory: {
                    $ref: '#/$defs/AgentDirectorySelection',
                  },
                  title: {
                    type: 'string',
                    minLength: 1,
                  },
                  kind: {
                    type: 'string',
                    const: 'copy',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'selection', 'directory', 'title'],
              },
            ],
            $defs: {
              AgentImportLocation: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      directory: {
                        $ref: '#/$defs/AgentDirectorySelection',
                      },
                      kind: {
                        type: 'string',
                        const: 'codex',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'directory'],
                  },
                  {
                    type: 'object',
                    properties: {
                      directory: {
                        $ref: '#/$defs/AgentDirectorySelection',
                      },
                      kind: {
                        type: 'string',
                        const: 'claude_code',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'directory'],
                  },
                  {
                    type: 'object',
                    properties: {
                      directory: {
                        $ref: '#/$defs/AgentDirectorySelection',
                      },
                      database: {
                        type: 'string',
                        minLength: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'open_code',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'directory', 'database'],
                  },
                ],
              },
              AgentDirectorySelection: {
                type: 'object',
                properties: {
                  rootId: {
                    type: 'string',
                    minLength: 1,
                  },
                  segments: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                },
                additionalProperties: false,
                required: ['rootId', 'segments', 'directoryIdentity'],
              },
              AgentImportSelection: {
                type: 'object',
                properties: {
                  source: {
                    $ref: '#/$defs/AgentImportSourceRef',
                  },
                  entry: {
                    $ref: '#/$defs/AgentImportEntryRef',
                  },
                  digest: {
                    type: 'string',
                    pattern: '^[a-f0-9]{64}$',
                  },
                },
                additionalProperties: false,
                required: ['source', 'entry', 'digest'],
              },
              AgentImportSourceRef: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                },
                additionalProperties: false,
                required: ['id', 'revision'],
              },
              AgentImportEntryRef: {
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                    minLength: 1,
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['sessionId', 'path'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentImportResult',
            oneOf: [
              {
                type: 'object',
                properties: {
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  sources: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/AgentImportSource',
                    },
                  },
                  kind: {
                    type: 'string',
                    const: 'sources',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'revision', 'sources'],
              },
              {
                type: 'object',
                properties: {
                  session: {
                    $ref: '#/$defs/AgentSession',
                  },
                  kind: {
                    type: 'string',
                    const: 'imported',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'session'],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'changed',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'unavailable',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'invalid',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'limit',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
            ],
            $defs: {
              AgentImportSource: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                    format: 'uuid',
                  },
                  name: {
                    type: 'string',
                    minLength: 1,
                  },
                  location: {
                    $ref: '#/$defs/AgentImportLocation',
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['id', 'name', 'location', 'path'],
              },
              AgentImportLocation: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      directory: {
                        $ref: '#/$defs/AgentDirectorySelection',
                      },
                      kind: {
                        type: 'string',
                        const: 'codex',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'directory'],
                  },
                  {
                    type: 'object',
                    properties: {
                      directory: {
                        $ref: '#/$defs/AgentDirectorySelection',
                      },
                      kind: {
                        type: 'string',
                        const: 'claude_code',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'directory'],
                  },
                  {
                    type: 'object',
                    properties: {
                      directory: {
                        $ref: '#/$defs/AgentDirectorySelection',
                      },
                      database: {
                        type: 'string',
                        minLength: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'open_code',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'directory', 'database'],
                  },
                ],
              },
              AgentDirectorySelection: {
                type: 'object',
                properties: {
                  rootId: {
                    type: 'string',
                    minLength: 1,
                  },
                  segments: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                },
                additionalProperties: false,
                required: ['rootId', 'segments', 'directoryIdentity'],
              },
              AgentSession: {
                type: 'object',
                properties: {
                  branch: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentSessionBranch',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  backend: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentBackendPreference',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  collaborationMode: {
                    $ref: '#/$defs/CollaborationMode',
                    default: 'agent',
                  },
                  tools: {
                    type: ['array', 'null'],
                    items: {
                      type: 'string',
                    },
                  },
                  dataSource: {
                    $ref: '#/$defs/AgentDataSource',
                  },
                  permissions: {
                    $ref: '#/$defs/AgentWorkspacePermissions',
                  },
                  boundaryRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  id: {
                    type: 'string',
                  },
                  title: {
                    type: 'string',
                  },
                  labels: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  workspace: {
                    $ref: '#/$defs/AgentWorkspace',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  updatedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  archived: {
                    type: 'boolean',
                  },
                  hasUnread: {
                    type: 'boolean',
                  },
                  activity: {
                    $ref: '#/$defs/AgentSessionActivity',
                  },
                },
                additionalProperties: false,
                required: [
                  'branch',
                  'dataSource',
                  'permissions',
                  'boundaryRevision',
                  'id',
                  'title',
                  'labels',
                  'workspace',
                  'revision',
                  'updatedAt',
                  'archived',
                  'hasUnread',
                  'activity',
                ],
              },
              AgentSessionBranch: {
                description:
                  'Frozen conversation ancestry for presentation, not authority over the source.',
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                    minLength: 1,
                  },
                  turnId: {
                    type: ['string', 'null'],
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['sessionId', 'turnId'],
              },
              AgentBackendPreference: {
                description:
                  "The next turn's choice, independent of an already admitted execution.\nModel revisions are resolved afresh; preferences never grant execution authority.",
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      connectionId: {
                        type: 'string',
                        minLength: 1,
                      },
                      modelId: {
                        type: 'string',
                        minLength: 1,
                      },
                      thinkingLevel: {
                        anyOf: [
                          {
                            $ref: '#/$defs/ThinkingLevel',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'model',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'connectionId', 'modelId'],
                  },
                  {
                    type: 'object',
                    properties: {
                      selection: {
                        $ref: '#/$defs/AgentExecutorSelection',
                      },
                      kind: {
                        type: 'string',
                        const: 'executor',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'selection'],
                  },
                ],
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
              AgentExecutorSelection: {
                type: 'object',
                properties: {
                  executor: {
                    type: 'string',
                    minLength: 1,
                  },
                  settings: {
                    $ref: '#/$defs/ExecutorSettings',
                  },
                },
                additionalProperties: false,
                required: ['executor', 'settings'],
              },
              ExecutorSettings: {
                description:
                  'Executor-owned model selection, independent of Host model connections.',
                type: 'object',
                properties: {
                  model: {
                    type: ['string', 'null'],
                  },
                  thinkingLevel: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ThinkingLevel',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
              },
              CollaborationMode: {
                type: 'string',
                enum: ['agent', 'plan'],
              },
              AgentDataSource: {
                description:
                  'Stable business-data origin, independent of package or activation revisions.',
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  namespace: {
                    $ref: '#/$defs/InstanceId',
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'namespace'],
              },
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
              AgentWorkspacePermissions: {
                type: 'object',
                properties: {
                  access: {
                    $ref: '#/$defs/AgentWorkspaceAccess',
                  },
                  requestPermissions: {
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: ['access', 'requestPermissions'],
              },
              AgentWorkspaceAccess: {
                description:
                  'Session sandbox policy. Full access explicitly disables filesystem and process isolation.',
                type: 'string',
                enum: ['read_only', 'workspace_write', 'danger_full_access'],
              },
              AgentWorkspace: {
                type: 'object',
                properties: {
                  worktree: {
                    description:
                      'Native owner allocation; never accepted from a caller as workspace authority.',
                    anyOf: [
                      {
                        $ref: '#/$defs/Binding',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  projectId: {
                    description: "Optional membership in this Agent's canonical Project catalog.",
                    type: ['string', 'null'],
                    format: 'uuid',
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  identity: {
                    type: 'string',
                    pattern: '^workspace:v1:[A-Fa-f0-9-]{36}$',
                  },
                },
                additionalProperties: false,
                required: ['path', 'directoryIdentity', 'identity'],
              },
              Binding: {
                description: 'Immutable allocation intent, not the current child branch or HEAD.',
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  common_dir: {
                    type: 'string',
                  },
                  source: {
                    type: 'string',
                  },
                  source_identity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  base_commit: {
                    type: 'string',
                  },
                  directory: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: [
                  'id',
                  'common_dir',
                  'source',
                  'source_identity',
                  'base_commit',
                  'directory',
                ],
              },
              AgentSessionActivity: {
                type: 'string',
                enum: ['idle', 'working', 'waiting'],
              },
            },
          },
          resources: {},
        },
        importDirectories: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentDirectories',
            oneOf: [
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'roots',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  selection: {
                    $ref: '#/$defs/AgentDirectorySelection',
                  },
                  after: {
                    type: ['string', 'null'],
                  },
                  kind: {
                    type: 'string',
                    const: 'children',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'selection', 'after'],
              },
            ],
            $defs: {
              AgentDirectorySelection: {
                type: 'object',
                properties: {
                  rootId: {
                    type: 'string',
                    minLength: 1,
                  },
                  segments: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                },
                additionalProperties: false,
                required: ['rootId', 'segments', 'directoryIdentity'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentDirectoryPage',
            oneOf: [
              {
                type: 'object',
                properties: {
                  roots: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/AgentDirectory',
                    },
                  },
                  kind: {
                    type: 'string',
                    const: 'roots',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'roots'],
              },
              {
                type: 'object',
                properties: {
                  directory: {
                    $ref: '#/$defs/AgentDirectory',
                  },
                  children: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/AgentDirectory',
                    },
                    maxItems: 32,
                  },
                  after: {
                    type: ['string', 'null'],
                  },
                  kind: {
                    type: 'string',
                    const: 'children',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'directory', 'children', 'after'],
              },
            ],
            $defs: {
              AgentDirectory: {
                type: 'object',
                properties: {
                  name: {
                    type: 'string',
                  },
                  path: {
                    type: 'string',
                  },
                  selection: {
                    $ref: '#/$defs/AgentDirectorySelection',
                  },
                },
                additionalProperties: false,
                required: ['name', 'path', 'selection'],
              },
              AgentDirectorySelection: {
                type: 'object',
                properties: {
                  rootId: {
                    type: 'string',
                    minLength: 1,
                  },
                  segments: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                },
                additionalProperties: false,
                required: ['rootId', 'segments', 'directoryIdentity'],
              },
            },
          },
          resources: {},
        },
        imports: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentImportsRead',
            oneOf: [
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'sources',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  source: {
                    $ref: '#/$defs/AgentImportSourceRef',
                  },
                  query: {
                    $ref: '#/$defs/AgentImportQuery',
                  },
                  kind: {
                    type: 'string',
                    const: 'catalog',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'source', 'query'],
              },
              {
                type: 'object',
                properties: {
                  source: {
                    $ref: '#/$defs/AgentImportSourceRef',
                  },
                  entry: {
                    $ref: '#/$defs/AgentImportEntryRef',
                  },
                  digest: {
                    type: ['string', 'null'],
                  },
                  after: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                  kind: {
                    type: 'string',
                    const: 'preview',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'source', 'entry', 'digest', 'after'],
              },
              {
                type: 'object',
                properties: {
                  after: {
                    type: ['string', 'null'],
                  },
                  kind: {
                    type: 'string',
                    const: 'copies',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'after'],
              },
            ],
            $defs: {
              AgentImportSourceRef: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                },
                additionalProperties: false,
                required: ['id', 'revision'],
              },
              AgentImportQuery: {
                type: 'object',
                properties: {
                  text: {
                    type: 'string',
                  },
                  includeArchived: {
                    type: 'boolean',
                  },
                  cursor: {
                    type: ['string', 'null'],
                  },
                },
                additionalProperties: false,
                required: ['text', 'includeArchived', 'cursor'],
              },
              AgentImportEntryRef: {
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                    minLength: 1,
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['sessionId', 'path'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentImportsPage',
            oneOf: [
              {
                type: 'object',
                properties: {
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  sources: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/AgentImportSource',
                    },
                  },
                  kind: {
                    type: 'string',
                    const: 'sources',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'revision', 'sources'],
              },
              {
                type: 'object',
                properties: {
                  source: {
                    $ref: '#/$defs/AgentImportSourceRef',
                  },
                  entries: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/AgentImportEntry',
                    },
                    maxItems: 16,
                  },
                  next: {
                    type: ['string', 'null'],
                  },
                  kind: {
                    type: 'string',
                    const: 'catalog',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'source', 'entries', 'next'],
              },
              {
                type: 'object',
                properties: {
                  preview: {
                    $ref: '#/$defs/AgentImportPreview',
                  },
                  kind: {
                    type: 'string',
                    const: 'preview',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'preview'],
              },
              {
                type: 'object',
                properties: {
                  sessions: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/AgentSession',
                    },
                    maxItems: 16,
                  },
                  next: {
                    type: ['string', 'null'],
                  },
                  kind: {
                    type: 'string',
                    const: 'copies',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'sessions', 'next'],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'changed',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'unavailable',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'invalid',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'limit',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
            ],
            $defs: {
              AgentImportSource: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                    format: 'uuid',
                  },
                  name: {
                    type: 'string',
                    minLength: 1,
                  },
                  location: {
                    $ref: '#/$defs/AgentImportLocation',
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['id', 'name', 'location', 'path'],
              },
              AgentImportLocation: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      directory: {
                        $ref: '#/$defs/AgentDirectorySelection',
                      },
                      kind: {
                        type: 'string',
                        const: 'codex',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'directory'],
                  },
                  {
                    type: 'object',
                    properties: {
                      directory: {
                        $ref: '#/$defs/AgentDirectorySelection',
                      },
                      kind: {
                        type: 'string',
                        const: 'claude_code',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'directory'],
                  },
                  {
                    type: 'object',
                    properties: {
                      directory: {
                        $ref: '#/$defs/AgentDirectorySelection',
                      },
                      database: {
                        type: 'string',
                        minLength: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'open_code',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'directory', 'database'],
                  },
                ],
              },
              AgentDirectorySelection: {
                type: 'object',
                properties: {
                  rootId: {
                    type: 'string',
                    minLength: 1,
                  },
                  segments: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                },
                additionalProperties: false,
                required: ['rootId', 'segments', 'directoryIdentity'],
              },
              AgentImportSourceRef: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                },
                additionalProperties: false,
                required: ['id', 'revision'],
              },
              AgentImportEntry: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  path: {
                    type: 'string',
                  },
                  title: {
                    type: 'string',
                  },
                  cwd: {
                    type: ['string', 'null'],
                  },
                  updatedAt: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  archived: {
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: ['id', 'path', 'title', 'cwd', 'updatedAt', 'archived'],
              },
              AgentImportPreview: {
                type: 'object',
                properties: {
                  selection: {
                    $ref: '#/$defs/AgentImportSelection',
                  },
                  title: {
                    type: 'string',
                  },
                  cwd: {
                    type: ['string', 'null'],
                  },
                  records: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  bytes: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  incompleteTail: {
                    type: 'boolean',
                  },
                  items: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/AgentImportPreviewItem',
                    },
                    maxItems: 8,
                  },
                  next: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: [
                  'selection',
                  'title',
                  'cwd',
                  'records',
                  'bytes',
                  'incompleteTail',
                  'items',
                  'next',
                ],
              },
              AgentImportSelection: {
                type: 'object',
                properties: {
                  source: {
                    $ref: '#/$defs/AgentImportSourceRef',
                  },
                  entry: {
                    $ref: '#/$defs/AgentImportEntryRef',
                  },
                  digest: {
                    type: 'string',
                    pattern: '^[a-f0-9]{64}$',
                  },
                },
                additionalProperties: false,
                required: ['source', 'entry', 'digest'],
              },
              AgentImportEntryRef: {
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                    minLength: 1,
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['sessionId', 'path'],
              },
              AgentImportPreviewItem: {
                type: 'object',
                properties: {
                  index: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    $ref: '#/$defs/AgentImportRecordKind',
                  },
                  text: {
                    type: 'string',
                    maxLength: 4096,
                  },
                  truncated: {
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: ['index', 'kind', 'text', 'truncated'],
              },
              AgentImportRecordKind: {
                type: 'string',
                enum: ['user', 'assistant', 'tool_call', 'tool_result', 'note'],
              },
              AgentSession: {
                type: 'object',
                properties: {
                  branch: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentSessionBranch',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  backend: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentBackendPreference',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  collaborationMode: {
                    $ref: '#/$defs/CollaborationMode',
                    default: 'agent',
                  },
                  tools: {
                    type: ['array', 'null'],
                    items: {
                      type: 'string',
                    },
                  },
                  dataSource: {
                    $ref: '#/$defs/AgentDataSource',
                  },
                  permissions: {
                    $ref: '#/$defs/AgentWorkspacePermissions',
                  },
                  boundaryRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  id: {
                    type: 'string',
                  },
                  title: {
                    type: 'string',
                  },
                  labels: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  workspace: {
                    $ref: '#/$defs/AgentWorkspace',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  updatedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  archived: {
                    type: 'boolean',
                  },
                  hasUnread: {
                    type: 'boolean',
                  },
                  activity: {
                    $ref: '#/$defs/AgentSessionActivity',
                  },
                },
                additionalProperties: false,
                required: [
                  'branch',
                  'dataSource',
                  'permissions',
                  'boundaryRevision',
                  'id',
                  'title',
                  'labels',
                  'workspace',
                  'revision',
                  'updatedAt',
                  'archived',
                  'hasUnread',
                  'activity',
                ],
              },
              AgentSessionBranch: {
                description:
                  'Frozen conversation ancestry for presentation, not authority over the source.',
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                    minLength: 1,
                  },
                  turnId: {
                    type: ['string', 'null'],
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['sessionId', 'turnId'],
              },
              AgentBackendPreference: {
                description:
                  "The next turn's choice, independent of an already admitted execution.\nModel revisions are resolved afresh; preferences never grant execution authority.",
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      connectionId: {
                        type: 'string',
                        minLength: 1,
                      },
                      modelId: {
                        type: 'string',
                        minLength: 1,
                      },
                      thinkingLevel: {
                        anyOf: [
                          {
                            $ref: '#/$defs/ThinkingLevel',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'model',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'connectionId', 'modelId'],
                  },
                  {
                    type: 'object',
                    properties: {
                      selection: {
                        $ref: '#/$defs/AgentExecutorSelection',
                      },
                      kind: {
                        type: 'string',
                        const: 'executor',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'selection'],
                  },
                ],
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
              AgentExecutorSelection: {
                type: 'object',
                properties: {
                  executor: {
                    type: 'string',
                    minLength: 1,
                  },
                  settings: {
                    $ref: '#/$defs/ExecutorSettings',
                  },
                },
                additionalProperties: false,
                required: ['executor', 'settings'],
              },
              ExecutorSettings: {
                description:
                  'Executor-owned model selection, independent of Host model connections.',
                type: 'object',
                properties: {
                  model: {
                    type: ['string', 'null'],
                  },
                  thinkingLevel: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ThinkingLevel',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
              },
              CollaborationMode: {
                type: 'string',
                enum: ['agent', 'plan'],
              },
              AgentDataSource: {
                description:
                  'Stable business-data origin, independent of package or activation revisions.',
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  namespace: {
                    $ref: '#/$defs/InstanceId',
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'namespace'],
              },
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
              AgentWorkspacePermissions: {
                type: 'object',
                properties: {
                  access: {
                    $ref: '#/$defs/AgentWorkspaceAccess',
                  },
                  requestPermissions: {
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: ['access', 'requestPermissions'],
              },
              AgentWorkspaceAccess: {
                description:
                  'Session sandbox policy. Full access explicitly disables filesystem and process isolation.',
                type: 'string',
                enum: ['read_only', 'workspace_write', 'danger_full_access'],
              },
              AgentWorkspace: {
                type: 'object',
                properties: {
                  worktree: {
                    description:
                      'Native owner allocation; never accepted from a caller as workspace authority.',
                    anyOf: [
                      {
                        $ref: '#/$defs/Binding',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  projectId: {
                    description: "Optional membership in this Agent's canonical Project catalog.",
                    type: ['string', 'null'],
                    format: 'uuid',
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  identity: {
                    type: 'string',
                    pattern: '^workspace:v1:[A-Fa-f0-9-]{36}$',
                  },
                },
                additionalProperties: false,
                required: ['path', 'directoryIdentity', 'identity'],
              },
              Binding: {
                description: 'Immutable allocation intent, not the current child branch or HEAD.',
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  common_dir: {
                    type: 'string',
                  },
                  source: {
                    type: 'string',
                  },
                  source_identity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  base_commit: {
                    type: 'string',
                  },
                  directory: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: [
                  'id',
                  'common_dir',
                  'source',
                  'source_identity',
                  'base_commit',
                  'directory',
                ],
              },
              AgentSessionActivity: {
                type: 'string',
                enum: ['idle', 'working', 'waiting'],
              },
            },
          },
          resources: {},
        },
        interaction: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentInteractionRead',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
              requestId: {
                type: 'string',
                minLength: 1,
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'requestId'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'InteractionRecord',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
              },
              turnId: {
                type: 'string',
              },
              runId: {
                type: 'string',
              },
              requestId: {
                type: 'string',
              },
              createdAt: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
              request: {
                $ref: '#/$defs/InteractionRequest',
              },
              outcome: {
                anyOf: [
                  {
                    $ref: '#/$defs/InteractionOutcome',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
            },
            additionalProperties: false,
            required: [
              'sessionId',
              'turnId',
              'runId',
              'requestId',
              'createdAt',
              'request',
              'outcome',
            ],
            $defs: {
              InteractionRequest: {
                oneOf: [
                  {
                    description:
                      'Consent for one already journaled service call; never a service grant.',
                    type: 'object',
                    properties: {
                      toolUseId: {
                        type: 'string',
                      },
                      toolName: {
                        type: 'string',
                      },
                      service: {
                        type: 'string',
                      },
                      method: {
                        type: 'string',
                      },
                      binding: {
                        type: 'string',
                      },
                      through: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'service_approval',
                      },
                    },
                    additionalProperties: false,
                    required: [
                      'kind',
                      'toolUseId',
                      'toolName',
                      'service',
                      'method',
                      'binding',
                      'through',
                    ],
                  },
                  {
                    type: 'object',
                    properties: {
                      toolUseId: {
                        type: ['string', 'null'],
                      },
                      baseRevision: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      request: {
                        $ref: '#/$defs/PermissionRequest',
                      },
                      kind: {
                        type: 'string',
                        const: 'permissions',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'toolUseId', 'baseRevision', 'request'],
                  },
                  {
                    type: 'object',
                    properties: {
                      toolUseId: {
                        type: 'string',
                      },
                      questions: {
                        type: 'array',
                        items: {
                          $ref: '#/$defs/InteractionQuestion',
                        },
                      },
                      kind: {
                        type: 'string',
                        const: 'question',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'toolUseId', 'questions'],
                  },
                  {
                    type: 'object',
                    properties: {
                      toolUseId: {
                        type: 'string',
                      },
                      message: {
                        type: 'string',
                      },
                      requester: {
                        $ref: '#/$defs/FormRequester',
                      },
                      fields: {
                        type: 'array',
                        items: {
                          $ref: '#/$defs/FormField',
                        },
                      },
                      kind: {
                        type: 'string',
                        const: 'form',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'toolUseId', 'message', 'requester', 'fields'],
                  },
                  {
                    type: 'object',
                    properties: {
                      toolUseId: {
                        type: 'string',
                      },
                      target: {
                        $ref: '#/$defs/GrantTarget',
                      },
                      baseRevision: {
                        description:
                          'Agent-owned approvals expire with this original permission boundary.\nOlder capability records without a boundary remain readable.',
                        type: ['integer', 'null'],
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'client_capability',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'toolUseId', 'target'],
                  },
                ],
              },
              PermissionRequest: {
                description:
                  'The Host supplies the real operation description; it is display information,\nnot authority inferred from a command string or a plugin-supplied Session ID.',
                type: 'object',
                properties: {
                  reason: {
                    type: 'string',
                  },
                  command: {
                    anyOf: [
                      {
                        $ref: '#/$defs/PermissionCommand',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  permissions: {
                    $ref: '#/$defs/Permissions',
                  },
                },
                additionalProperties: false,
                required: ['reason', 'permissions'],
              },
              PermissionCommand: {
                type: 'object',
                properties: {
                  command: {
                    type: 'string',
                  },
                  cwd: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['command', 'cwd'],
              },
              Permissions: {
                type: 'object',
                properties: {
                  filesystem: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/Rule',
                    },
                  },
                  network: {
                    $ref: '#/$defs/Network',
                  },
                },
                additionalProperties: false,
                required: ['filesystem', 'network'],
              },
              Rule: {
                description:
                  'Paths have executor-native meaning. Validate and materialize them on the\nexecution host, never on a remote Desktop. This document alone grants nothing.',
                type: 'object',
                properties: {
                  path: {
                    type: 'string',
                  },
                  scope: {
                    $ref: '#/$defs/Scope',
                  },
                  access: {
                    $ref: '#/$defs/Access',
                  },
                },
                additionalProperties: false,
                required: ['path', 'scope', 'access'],
              },
              Scope: {
                type: 'string',
                enum: ['subtree', 'exact'],
              },
              Access: {
                description:
                  'Equal-path conflict priority is different from authority breadth: deny wins.',
                type: 'string',
                enum: ['read', 'write', 'deny'],
              },
              Network: {
                oneOf: [
                  {
                    type: 'string',
                    enum: ['denied', 'allowed'],
                  },
                  {
                    type: 'object',
                    properties: {
                      restricted: {
                        type: 'object',
                        properties: {
                          destinations: {
                            type: 'array',
                            uniqueItems: true,
                            items: {
                              $ref: '#/$defs/Destination',
                            },
                          },
                        },
                        additionalProperties: false,
                        required: ['destinations'],
                      },
                    },
                    required: ['restricted'],
                    additionalProperties: false,
                  },
                ],
              },
              Destination: {
                description:
                  'Destination authority, independent of the upstream proxy used to reach it.\nA domain grant does not authorize its subdomains or other ports.',
                type: 'object',
                properties: {
                  host: {
                    type: 'string',
                    minLength: 1,
                    maxLength: 253,
                  },
                  port: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 1,
                    maximum: 65535,
                  },
                },
                additionalProperties: false,
                required: ['host', 'port'],
              },
              InteractionQuestion: {
                type: 'object',
                properties: {
                  question: {
                    type: 'string',
                    minLength: 1,
                  },
                  options: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/QuestionOption',
                    },
                    minItems: 2,
                    maxItems: 3,
                  },
                },
                additionalProperties: false,
                required: ['question', 'options'],
              },
              QuestionOption: {
                type: 'object',
                properties: {
                  label: {
                    type: 'string',
                    minLength: 1,
                  },
                  description: {
                    type: 'string',
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['label'],
              },
              FormRequester: {
                type: 'object',
                properties: {
                  name: {
                    type: 'string',
                  },
                  source: {
                    type: ['string', 'null'],
                  },
                },
                additionalProperties: false,
                required: ['name'],
              },
              FormField: {
                type: 'object',
                properties: {
                  name: {
                    type: 'string',
                  },
                  label: {
                    type: 'string',
                  },
                  required: {
                    type: 'boolean',
                  },
                  description: {
                    type: ['string', 'null'],
                  },
                },
                required: ['name', 'label', 'required'],
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      default: {
                        type: ['string', 'null'],
                      },
                      minLength: {
                        type: ['integer', 'null'],
                        format: 'uint',
                        minimum: 0,
                      },
                      maxLength: {
                        type: ['integer', 'null'],
                        format: 'uint',
                        minimum: 0,
                      },
                      format: {
                        anyOf: [
                          {
                            $ref: '#/$defs/FormFormat',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'string',
                      },
                    },
                    required: ['kind'],
                  },
                  {
                    type: 'object',
                    properties: {
                      default: {
                        type: ['number', 'null'],
                        format: 'double',
                      },
                      minimum: {
                        type: ['number', 'null'],
                        format: 'double',
                      },
                      maximum: {
                        type: ['number', 'null'],
                        format: 'double',
                      },
                      kind: {
                        type: 'string',
                        const: 'number',
                      },
                    },
                    required: ['kind'],
                  },
                  {
                    type: 'object',
                    properties: {
                      default: {
                        type: ['number', 'null'],
                        format: 'double',
                      },
                      minimum: {
                        type: ['number', 'null'],
                        format: 'double',
                      },
                      maximum: {
                        type: ['number', 'null'],
                        format: 'double',
                      },
                      kind: {
                        type: 'string',
                        const: 'integer',
                      },
                    },
                    required: ['kind'],
                  },
                  {
                    type: 'object',
                    properties: {
                      default: {
                        type: ['boolean', 'null'],
                      },
                      kind: {
                        type: 'string',
                        const: 'boolean',
                      },
                    },
                    required: ['kind'],
                  },
                  {
                    type: 'object',
                    properties: {
                      options: {
                        type: 'array',
                        items: {
                          $ref: '#/$defs/FormOption',
                        },
                      },
                      default: {
                        type: ['string', 'null'],
                      },
                      kind: {
                        type: 'string',
                        const: 'single_select',
                      },
                    },
                    required: ['kind', 'options'],
                  },
                  {
                    type: 'object',
                    properties: {
                      options: {
                        type: 'array',
                        items: {
                          $ref: '#/$defs/FormOption',
                        },
                      },
                      default: {
                        type: ['array', 'null'],
                        items: {
                          type: 'string',
                        },
                      },
                      minItems: {
                        type: ['integer', 'null'],
                        format: 'uint',
                        minimum: 0,
                      },
                      maxItems: {
                        type: ['integer', 'null'],
                        format: 'uint',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'multi_select',
                      },
                    },
                    required: ['kind', 'options'],
                  },
                ],
              },
              FormFormat: {
                type: 'string',
                enum: ['email', 'uri', 'date', 'date-time'],
              },
              FormOption: {
                type: 'object',
                properties: {
                  value: {
                    type: 'string',
                  },
                  label: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['value', 'label'],
              },
              GrantTarget: {
                type: 'object',
                properties: {
                  providerId: {
                    type: 'string',
                  },
                  contractId: {
                    type: 'string',
                  },
                  serverId: {
                    type: 'string',
                  },
                  toolName: {
                    type: 'string',
                  },
                  capability: {
                    $ref: '#/$defs/GrantCapability',
                  },
                  scope: {
                    $ref: '#/$defs/GrantScope',
                  },
                },
                required: [
                  'providerId',
                  'contractId',
                  'serverId',
                  'toolName',
                  'capability',
                  'scope',
                ],
              },
              GrantCapability: {
                type: 'string',
                enum: ['browser', 'computer_use', 'desktop_mcp', 'mcp'],
              },
              GrantScope: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      origin: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'browser_origin',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'origin'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'capability',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind'],
                  },
                  {
                    type: 'object',
                    properties: {
                      serverId: {
                        type: 'string',
                      },
                      toolName: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'mcp_tool',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'serverId', 'toolName'],
                  },
                ],
              },
              InteractionOutcome: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      decision: {
                        $ref: '#/$defs/Decision',
                      },
                      committedAt: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'service_approval_decision',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'decision', 'committedAt'],
                  },
                  {
                    type: 'object',
                    properties: {
                      decision: {
                        $ref: '#/$defs/Decision2',
                      },
                      committedAt: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'permissions_decision',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'decision', 'committedAt'],
                  },
                  {
                    type: 'object',
                    properties: {
                      answers: {
                        type: 'array',
                        items: {
                          type: ['string', 'null'],
                        },
                      },
                      committedAt: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'question_answer',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'answers', 'committedAt'],
                  },
                  {
                    type: 'object',
                    properties: {
                      committedAt: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'form_answer',
                      },
                    },
                    unevaluatedProperties: false,
                    oneOf: [
                      {
                        type: 'object',
                        properties: {
                          values: {
                            type: 'object',
                            additionalProperties: {
                              $ref: '#/$defs/FormValue',
                            },
                          },
                          action: {
                            type: 'string',
                            const: 'accept',
                          },
                        },
                        required: ['action', 'values'],
                      },
                      {
                        type: 'object',
                        properties: {
                          action: {
                            type: 'string',
                            const: 'decline',
                          },
                        },
                        required: ['action'],
                      },
                      {
                        type: 'object',
                        properties: {
                          action: {
                            type: 'string',
                            const: 'cancel',
                          },
                        },
                        required: ['action'],
                      },
                    ],
                    required: ['kind', 'committedAt'],
                  },
                  {
                    type: 'object',
                    properties: {
                      decision: {
                        $ref: '#/$defs/Decision',
                      },
                      committedAt: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'client_capability_decision',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'decision', 'committedAt'],
                  },
                  {
                    type: 'object',
                    properties: {
                      reason: {
                        $ref: '#/$defs/ClosureReason',
                      },
                      committedAt: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'closure',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'reason', 'committedAt'],
                  },
                ],
              },
              Decision: {
                type: 'string',
                enum: ['allow', 'deny'],
              },
              Decision2: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      decision: {
                        type: 'string',
                        const: 'deny',
                      },
                    },
                    required: ['decision'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      permissions: {
                        $ref: '#/$defs/Permissions',
                      },
                      scope: {
                        $ref: '#/$defs/Scope2',
                      },
                      decision: {
                        type: 'string',
                        const: 'allow',
                      },
                    },
                    additionalProperties: false,
                    required: ['decision', 'permissions', 'scope'],
                  },
                ],
              },
              Scope2: {
                type: 'string',
                enum: ['once', 'turn', 'session'],
              },
              FormValue: {
                anyOf: [
                  {
                    type: 'string',
                  },
                  {
                    type: 'number',
                    format: 'double',
                  },
                  {
                    type: 'boolean',
                  },
                  {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                ],
              },
              ClosureReason: {
                type: 'string',
                enum: [
                  'turn_stopped',
                  'turn_terminal',
                  'producer_cancelled',
                  'timed_out',
                  'host_restarted',
                  'provider_disconnected',
                ],
              },
            },
          },
          resources: {},
        },
        list: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentList',
            type: 'object',
            properties: {
              filter: {
                $ref: '#/$defs/AgentSessionFilter',
              },
              position: {
                $ref: '#/$defs/AgentSessionPosition',
              },
              scope: {
                $ref: '#/$defs/AgentSessionListScope',
                default: {
                  kind: 'all',
                },
              },
              titleQuery: {
                description:
                  'Literal, case-sensitive title substring; an empty query matches all titles.',
                type: 'string',
                default: '',
              },
            },
            additionalProperties: false,
            required: ['filter', 'position'],
            $defs: {
              AgentSessionFilter: {
                type: 'string',
                enum: ['all', 'archived', 'needs_you'],
              },
              AgentSessionPosition: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'start',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      cursor: {
                        type: 'string',
                        minLength: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'at',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'cursor'],
                  },
                  {
                    type: 'object',
                    properties: {
                      revision: {
                        type: 'string',
                      },
                      cursor: {
                        type: 'string',
                        minLength: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'after',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'revision', 'cursor'],
                  },
                  {
                    type: 'object',
                    properties: {
                      revision: {
                        type: 'string',
                      },
                      cursor: {
                        type: 'string',
                        minLength: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'before',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'revision', 'cursor'],
                  },
                ],
              },
              AgentSessionListScope: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'all',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      projectId: {
                        type: 'string',
                        format: 'uuid',
                      },
                      kind: {
                        type: 'string',
                        const: 'project',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'projectId'],
                  },
                  {
                    description:
                      'Resolve the exact workspace from an owned session, never a caller path.',
                    type: 'object',
                    properties: {
                      sessionId: {
                        type: 'string',
                        minLength: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'workspace',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'sessionId'],
                  },
                ],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentSessionPage',
            type: 'object',
            properties: {
              revision: {
                type: 'string',
              },
              needsYouCount: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
              sessions: {
                type: 'array',
                items: {
                  $ref: '#/$defs/AgentSession',
                },
                maxItems: 32,
              },
              before: {
                type: ['string', 'null'],
              },
              after: {
                type: ['string', 'null'],
              },
            },
            additionalProperties: false,
            required: ['revision', 'needsYouCount', 'sessions', 'before', 'after'],
            $defs: {
              AgentSession: {
                type: 'object',
                properties: {
                  branch: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentSessionBranch',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  backend: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentBackendPreference',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  collaborationMode: {
                    $ref: '#/$defs/CollaborationMode',
                    default: 'agent',
                  },
                  tools: {
                    type: ['array', 'null'],
                    items: {
                      type: 'string',
                    },
                  },
                  dataSource: {
                    $ref: '#/$defs/AgentDataSource',
                  },
                  permissions: {
                    $ref: '#/$defs/AgentWorkspacePermissions',
                  },
                  boundaryRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  id: {
                    type: 'string',
                  },
                  title: {
                    type: 'string',
                  },
                  labels: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  workspace: {
                    $ref: '#/$defs/AgentWorkspace',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  updatedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  archived: {
                    type: 'boolean',
                  },
                  hasUnread: {
                    type: 'boolean',
                  },
                  activity: {
                    $ref: '#/$defs/AgentSessionActivity',
                  },
                },
                additionalProperties: false,
                required: [
                  'branch',
                  'dataSource',
                  'permissions',
                  'boundaryRevision',
                  'id',
                  'title',
                  'labels',
                  'workspace',
                  'revision',
                  'updatedAt',
                  'archived',
                  'hasUnread',
                  'activity',
                ],
              },
              AgentSessionBranch: {
                description:
                  'Frozen conversation ancestry for presentation, not authority over the source.',
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                    minLength: 1,
                  },
                  turnId: {
                    type: ['string', 'null'],
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['sessionId', 'turnId'],
              },
              AgentBackendPreference: {
                description:
                  "The next turn's choice, independent of an already admitted execution.\nModel revisions are resolved afresh; preferences never grant execution authority.",
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      connectionId: {
                        type: 'string',
                        minLength: 1,
                      },
                      modelId: {
                        type: 'string',
                        minLength: 1,
                      },
                      thinkingLevel: {
                        anyOf: [
                          {
                            $ref: '#/$defs/ThinkingLevel',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'model',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'connectionId', 'modelId'],
                  },
                  {
                    type: 'object',
                    properties: {
                      selection: {
                        $ref: '#/$defs/AgentExecutorSelection',
                      },
                      kind: {
                        type: 'string',
                        const: 'executor',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'selection'],
                  },
                ],
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
              AgentExecutorSelection: {
                type: 'object',
                properties: {
                  executor: {
                    type: 'string',
                    minLength: 1,
                  },
                  settings: {
                    $ref: '#/$defs/ExecutorSettings',
                  },
                },
                additionalProperties: false,
                required: ['executor', 'settings'],
              },
              ExecutorSettings: {
                description:
                  'Executor-owned model selection, independent of Host model connections.',
                type: 'object',
                properties: {
                  model: {
                    type: ['string', 'null'],
                  },
                  thinkingLevel: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ThinkingLevel',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
              },
              CollaborationMode: {
                type: 'string',
                enum: ['agent', 'plan'],
              },
              AgentDataSource: {
                description:
                  'Stable business-data origin, independent of package or activation revisions.',
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  namespace: {
                    $ref: '#/$defs/InstanceId',
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'namespace'],
              },
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
              AgentWorkspacePermissions: {
                type: 'object',
                properties: {
                  access: {
                    $ref: '#/$defs/AgentWorkspaceAccess',
                  },
                  requestPermissions: {
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: ['access', 'requestPermissions'],
              },
              AgentWorkspaceAccess: {
                description:
                  'Session sandbox policy. Full access explicitly disables filesystem and process isolation.',
                type: 'string',
                enum: ['read_only', 'workspace_write', 'danger_full_access'],
              },
              AgentWorkspace: {
                type: 'object',
                properties: {
                  worktree: {
                    description:
                      'Native owner allocation; never accepted from a caller as workspace authority.',
                    anyOf: [
                      {
                        $ref: '#/$defs/Binding',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  projectId: {
                    description: "Optional membership in this Agent's canonical Project catalog.",
                    type: ['string', 'null'],
                    format: 'uuid',
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  identity: {
                    type: 'string',
                    pattern: '^workspace:v1:[A-Fa-f0-9-]{36}$',
                  },
                },
                additionalProperties: false,
                required: ['path', 'directoryIdentity', 'identity'],
              },
              Binding: {
                description: 'Immutable allocation intent, not the current child branch or HEAD.',
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  common_dir: {
                    type: 'string',
                  },
                  source: {
                    type: 'string',
                  },
                  source_identity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  base_commit: {
                    type: 'string',
                  },
                  directory: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: [
                  'id',
                  'common_dir',
                  'source',
                  'source_identity',
                  'base_commit',
                  'directory',
                ],
              },
              AgentSessionActivity: {
                type: 'string',
                enum: ['idle', 'working', 'waiting'],
              },
            },
          },
          resources: {},
        },
        listFiles: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentFileListRead',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
              },
              path: {
                anyOf: [
                  {
                    $ref: '#/$defs/WorkspacePath',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              after: {
                anyOf: [
                  {
                    $ref: '#/$defs/AgentFileCursor',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'path', 'after'],
            $defs: {
              WorkspacePath: {
                type: 'object',
                properties: {
                  bytesBase64: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['bytesBase64'],
              },
              AgentFileCursor: {
                type: 'object',
                properties: {
                  directoryIdentity: {
                    type: 'string',
                  },
                  after: {
                    $ref: '#/$defs/WorkspacePath',
                  },
                },
                additionalProperties: false,
                required: ['directoryIdentity', 'after'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentFilePage',
            type: 'object',
            properties: {
              directoryIdentity: {
                type: 'string',
              },
              entries: {
                type: 'array',
                items: {
                  $ref: '#/$defs/AgentFileEntry',
                },
              },
              next: {
                anyOf: [
                  {
                    $ref: '#/$defs/AgentFileCursor',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
            },
            additionalProperties: false,
            required: ['directoryIdentity', 'entries', 'next'],
            $defs: {
              AgentFileEntry: {
                type: 'object',
                properties: {
                  path: {
                    $ref: '#/$defs/WorkspacePath',
                  },
                  kind: {
                    $ref: '#/$defs/AgentFileKind',
                  },
                },
                additionalProperties: false,
                required: ['path', 'kind'],
              },
              WorkspacePath: {
                type: 'object',
                properties: {
                  bytesBase64: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['bytesBase64'],
              },
              AgentFileKind: {
                type: 'string',
                enum: ['file', 'directory', 'symlink', 'other'],
              },
              AgentFileCursor: {
                type: 'object',
                properties: {
                  directoryIdentity: {
                    type: 'string',
                  },
                  after: {
                    $ref: '#/$defs/WorkspacePath',
                  },
                },
                additionalProperties: false,
                required: ['directoryIdentity', 'after'],
              },
            },
          },
          resources: {},
        },
        markRead: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentMarkRead',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
              messageId: {
                type: 'string',
                minLength: 1,
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'messageId'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentMarkReadResult',
            oneOf: [
              {
                type: 'object',
                properties: {
                  session: {
                    $ref: '#/$defs/AgentSession',
                  },
                  kind: {
                    type: 'string',
                    const: 'observed',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'session'],
              },
              {
                type: 'object',
                properties: {
                  reason: {
                    $ref: '#/$defs/AgentRejection',
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'reason'],
              },
            ],
            $defs: {
              AgentSession: {
                type: 'object',
                properties: {
                  branch: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentSessionBranch',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  backend: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentBackendPreference',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  collaborationMode: {
                    $ref: '#/$defs/CollaborationMode',
                    default: 'agent',
                  },
                  tools: {
                    type: ['array', 'null'],
                    items: {
                      type: 'string',
                    },
                  },
                  dataSource: {
                    $ref: '#/$defs/AgentDataSource',
                  },
                  permissions: {
                    $ref: '#/$defs/AgentWorkspacePermissions',
                  },
                  boundaryRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  id: {
                    type: 'string',
                  },
                  title: {
                    type: 'string',
                  },
                  labels: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  workspace: {
                    $ref: '#/$defs/AgentWorkspace',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  updatedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  archived: {
                    type: 'boolean',
                  },
                  hasUnread: {
                    type: 'boolean',
                  },
                  activity: {
                    $ref: '#/$defs/AgentSessionActivity',
                  },
                },
                additionalProperties: false,
                required: [
                  'branch',
                  'dataSource',
                  'permissions',
                  'boundaryRevision',
                  'id',
                  'title',
                  'labels',
                  'workspace',
                  'revision',
                  'updatedAt',
                  'archived',
                  'hasUnread',
                  'activity',
                ],
              },
              AgentSessionBranch: {
                description:
                  'Frozen conversation ancestry for presentation, not authority over the source.',
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                    minLength: 1,
                  },
                  turnId: {
                    type: ['string', 'null'],
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['sessionId', 'turnId'],
              },
              AgentBackendPreference: {
                description:
                  "The next turn's choice, independent of an already admitted execution.\nModel revisions are resolved afresh; preferences never grant execution authority.",
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      connectionId: {
                        type: 'string',
                        minLength: 1,
                      },
                      modelId: {
                        type: 'string',
                        minLength: 1,
                      },
                      thinkingLevel: {
                        anyOf: [
                          {
                            $ref: '#/$defs/ThinkingLevel',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'model',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'connectionId', 'modelId'],
                  },
                  {
                    type: 'object',
                    properties: {
                      selection: {
                        $ref: '#/$defs/AgentExecutorSelection',
                      },
                      kind: {
                        type: 'string',
                        const: 'executor',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'selection'],
                  },
                ],
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
              AgentExecutorSelection: {
                type: 'object',
                properties: {
                  executor: {
                    type: 'string',
                    minLength: 1,
                  },
                  settings: {
                    $ref: '#/$defs/ExecutorSettings',
                  },
                },
                additionalProperties: false,
                required: ['executor', 'settings'],
              },
              ExecutorSettings: {
                description:
                  'Executor-owned model selection, independent of Host model connections.',
                type: 'object',
                properties: {
                  model: {
                    type: ['string', 'null'],
                  },
                  thinkingLevel: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ThinkingLevel',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
              },
              CollaborationMode: {
                type: 'string',
                enum: ['agent', 'plan'],
              },
              AgentDataSource: {
                description:
                  'Stable business-data origin, independent of package or activation revisions.',
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  namespace: {
                    $ref: '#/$defs/InstanceId',
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'namespace'],
              },
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
              AgentWorkspacePermissions: {
                type: 'object',
                properties: {
                  access: {
                    $ref: '#/$defs/AgentWorkspaceAccess',
                  },
                  requestPermissions: {
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: ['access', 'requestPermissions'],
              },
              AgentWorkspaceAccess: {
                description:
                  'Session sandbox policy. Full access explicitly disables filesystem and process isolation.',
                type: 'string',
                enum: ['read_only', 'workspace_write', 'danger_full_access'],
              },
              AgentWorkspace: {
                type: 'object',
                properties: {
                  worktree: {
                    description:
                      'Native owner allocation; never accepted from a caller as workspace authority.',
                    anyOf: [
                      {
                        $ref: '#/$defs/Binding',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  projectId: {
                    description: "Optional membership in this Agent's canonical Project catalog.",
                    type: ['string', 'null'],
                    format: 'uuid',
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  identity: {
                    type: 'string',
                    pattern: '^workspace:v1:[A-Fa-f0-9-]{36}$',
                  },
                },
                additionalProperties: false,
                required: ['path', 'directoryIdentity', 'identity'],
              },
              Binding: {
                description: 'Immutable allocation intent, not the current child branch or HEAD.',
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  common_dir: {
                    type: 'string',
                  },
                  source: {
                    type: 'string',
                  },
                  source_identity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  base_commit: {
                    type: 'string',
                  },
                  directory: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: [
                  'id',
                  'common_dir',
                  'source',
                  'source_identity',
                  'base_commit',
                  'directory',
                ],
              },
              AgentSessionActivity: {
                type: 'string',
                enum: ['idle', 'working', 'waiting'],
              },
              AgentRejection: {
                type: 'string',
                enum: [
                  'title_invalid',
                  'labels_invalid',
                  'tools_unavailable',
                  'busy',
                  'workspace_unavailable',
                  'session_unavailable',
                  'history_unavailable',
                  'managed_session',
                  'closed',
                ],
              },
            },
          },
          resources: {},
        },
        metadata: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentMetadata',
            type: 'object',
            properties: {
              collaborationMode: {
                description: 'Changing collaboration is only allowed while the Session is idle.',
                anyOf: [
                  {
                    $ref: '#/$defs/CollaborationMode',
                  },
                  {
                    type: 'null',
                  },
                ],
                default: null,
              },
              permissions: {
                description: 'Omission leaves the permission boundary and its approvals unchanged.',
                anyOf: [
                  {
                    $ref: '#/$defs/AgentPermissionChange',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              sessionId: {
                type: 'string',
                minLength: 1,
              },
              expectedRevision: {
                type: 'integer',
                format: 'uint64',
                minimum: 1,
                maximum: 9007199254740991,
              },
              title: {
                type: 'string',
                minLength: 1,
              },
              labels: {
                type: 'array',
                items: {
                  type: 'string',
                },
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'expectedRevision', 'title', 'labels'],
            $defs: {
              CollaborationMode: {
                type: 'string',
                enum: ['agent', 'plan'],
              },
              AgentPermissionChange: {
                type: 'object',
                properties: {
                  settings: {
                    $ref: '#/$defs/AgentWorkspacePermissions',
                  },
                  revokeGrants: {
                    description:
                      'Invalidate additive approvals even when the base policy is unchanged.',
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: ['settings', 'revokeGrants'],
              },
              AgentWorkspacePermissions: {
                type: 'object',
                properties: {
                  access: {
                    $ref: '#/$defs/AgentWorkspaceAccess',
                  },
                  requestPermissions: {
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: ['access', 'requestPermissions'],
              },
              AgentWorkspaceAccess: {
                description:
                  'Session sandbox policy. Full access explicitly disables filesystem and process isolation.',
                type: 'string',
                enum: ['read_only', 'workspace_write', 'danger_full_access'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentMetadataResult',
            oneOf: [
              {
                type: 'object',
                properties: {
                  session: {
                    $ref: '#/$defs/AgentSession',
                  },
                  kind: {
                    type: 'string',
                    const: 'committed',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'session'],
              },
              {
                type: 'object',
                properties: {
                  expected: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  actual: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'revision_conflict',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'expected', 'actual'],
              },
              {
                type: 'object',
                properties: {
                  reason: {
                    $ref: '#/$defs/AgentRejection',
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'reason'],
              },
            ],
            $defs: {
              AgentSession: {
                type: 'object',
                properties: {
                  branch: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentSessionBranch',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  backend: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentBackendPreference',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  collaborationMode: {
                    $ref: '#/$defs/CollaborationMode',
                    default: 'agent',
                  },
                  tools: {
                    type: ['array', 'null'],
                    items: {
                      type: 'string',
                    },
                  },
                  dataSource: {
                    $ref: '#/$defs/AgentDataSource',
                  },
                  permissions: {
                    $ref: '#/$defs/AgentWorkspacePermissions',
                  },
                  boundaryRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  id: {
                    type: 'string',
                  },
                  title: {
                    type: 'string',
                  },
                  labels: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  workspace: {
                    $ref: '#/$defs/AgentWorkspace',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  updatedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  archived: {
                    type: 'boolean',
                  },
                  hasUnread: {
                    type: 'boolean',
                  },
                  activity: {
                    $ref: '#/$defs/AgentSessionActivity',
                  },
                },
                additionalProperties: false,
                required: [
                  'branch',
                  'dataSource',
                  'permissions',
                  'boundaryRevision',
                  'id',
                  'title',
                  'labels',
                  'workspace',
                  'revision',
                  'updatedAt',
                  'archived',
                  'hasUnread',
                  'activity',
                ],
              },
              AgentSessionBranch: {
                description:
                  'Frozen conversation ancestry for presentation, not authority over the source.',
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                    minLength: 1,
                  },
                  turnId: {
                    type: ['string', 'null'],
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['sessionId', 'turnId'],
              },
              AgentBackendPreference: {
                description:
                  "The next turn's choice, independent of an already admitted execution.\nModel revisions are resolved afresh; preferences never grant execution authority.",
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      connectionId: {
                        type: 'string',
                        minLength: 1,
                      },
                      modelId: {
                        type: 'string',
                        minLength: 1,
                      },
                      thinkingLevel: {
                        anyOf: [
                          {
                            $ref: '#/$defs/ThinkingLevel',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'model',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'connectionId', 'modelId'],
                  },
                  {
                    type: 'object',
                    properties: {
                      selection: {
                        $ref: '#/$defs/AgentExecutorSelection',
                      },
                      kind: {
                        type: 'string',
                        const: 'executor',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'selection'],
                  },
                ],
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
              AgentExecutorSelection: {
                type: 'object',
                properties: {
                  executor: {
                    type: 'string',
                    minLength: 1,
                  },
                  settings: {
                    $ref: '#/$defs/ExecutorSettings',
                  },
                },
                additionalProperties: false,
                required: ['executor', 'settings'],
              },
              ExecutorSettings: {
                description:
                  'Executor-owned model selection, independent of Host model connections.',
                type: 'object',
                properties: {
                  model: {
                    type: ['string', 'null'],
                  },
                  thinkingLevel: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ThinkingLevel',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
              },
              CollaborationMode: {
                type: 'string',
                enum: ['agent', 'plan'],
              },
              AgentDataSource: {
                description:
                  'Stable business-data origin, independent of package or activation revisions.',
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  namespace: {
                    $ref: '#/$defs/InstanceId',
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'namespace'],
              },
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
              AgentWorkspacePermissions: {
                type: 'object',
                properties: {
                  access: {
                    $ref: '#/$defs/AgentWorkspaceAccess',
                  },
                  requestPermissions: {
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: ['access', 'requestPermissions'],
              },
              AgentWorkspaceAccess: {
                description:
                  'Session sandbox policy. Full access explicitly disables filesystem and process isolation.',
                type: 'string',
                enum: ['read_only', 'workspace_write', 'danger_full_access'],
              },
              AgentWorkspace: {
                type: 'object',
                properties: {
                  worktree: {
                    description:
                      'Native owner allocation; never accepted from a caller as workspace authority.',
                    anyOf: [
                      {
                        $ref: '#/$defs/Binding',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  projectId: {
                    description: "Optional membership in this Agent's canonical Project catalog.",
                    type: ['string', 'null'],
                    format: 'uuid',
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  identity: {
                    type: 'string',
                    pattern: '^workspace:v1:[A-Fa-f0-9-]{36}$',
                  },
                },
                additionalProperties: false,
                required: ['path', 'directoryIdentity', 'identity'],
              },
              Binding: {
                description: 'Immutable allocation intent, not the current child branch or HEAD.',
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  common_dir: {
                    type: 'string',
                  },
                  source: {
                    type: 'string',
                  },
                  source_identity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  base_commit: {
                    type: 'string',
                  },
                  directory: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: [
                  'id',
                  'common_dir',
                  'source',
                  'source_identity',
                  'base_commit',
                  'directory',
                ],
              },
              AgentSessionActivity: {
                type: 'string',
                enum: ['idle', 'working', 'waiting'],
              },
              AgentRejection: {
                type: 'string',
                enum: [
                  'title_invalid',
                  'labels_invalid',
                  'tools_unavailable',
                  'busy',
                  'workspace_unavailable',
                  'session_unavailable',
                  'history_unavailable',
                  'managed_session',
                  'closed',
                ],
              },
            },
          },
          resources: {},
        },
        observe: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentSessionRead',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
            },
            additionalProperties: false,
            required: ['sessionId'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentObservation',
            type: 'object',
            properties: {
              session: {
                $ref: '#/$defs/AgentSession',
              },
              compacting: {
                type: 'boolean',
              },
              rememberedBackend: {
                anyOf: [
                  {
                    $ref: '#/$defs/AgentBackendPreference',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              metrics: {
                anyOf: [
                  {
                    $ref: '#/$defs/AgentSessionMetrics',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              through: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
              run: {
                anyOf: [
                  {
                    $ref: '#/$defs/AgentRun',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              parts: {
                type: 'array',
                items: {
                  $ref: '#/$defs/AgentPart',
                },
              },
              toolSeeds: {
                description:
                  'Replay starts for active tool display, read at the same fence as the run.',
                type: 'array',
                items: {
                  $ref: '#/$defs/AgentToolSeed',
                },
              },
            },
            additionalProperties: false,
            required: ['session', 'through', 'parts', 'toolSeeds'],
            $defs: {
              AgentSession: {
                type: 'object',
                properties: {
                  branch: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentSessionBranch',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  backend: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentBackendPreference',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  collaborationMode: {
                    $ref: '#/$defs/CollaborationMode',
                    default: 'agent',
                  },
                  tools: {
                    type: ['array', 'null'],
                    items: {
                      type: 'string',
                    },
                  },
                  dataSource: {
                    $ref: '#/$defs/AgentDataSource',
                  },
                  permissions: {
                    $ref: '#/$defs/AgentWorkspacePermissions',
                  },
                  boundaryRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  id: {
                    type: 'string',
                  },
                  title: {
                    type: 'string',
                  },
                  labels: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  workspace: {
                    $ref: '#/$defs/AgentWorkspace',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  updatedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  archived: {
                    type: 'boolean',
                  },
                  hasUnread: {
                    type: 'boolean',
                  },
                  activity: {
                    $ref: '#/$defs/AgentSessionActivity',
                  },
                },
                additionalProperties: false,
                required: [
                  'branch',
                  'dataSource',
                  'permissions',
                  'boundaryRevision',
                  'id',
                  'title',
                  'labels',
                  'workspace',
                  'revision',
                  'updatedAt',
                  'archived',
                  'hasUnread',
                  'activity',
                ],
              },
              AgentSessionBranch: {
                description:
                  'Frozen conversation ancestry for presentation, not authority over the source.',
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                    minLength: 1,
                  },
                  turnId: {
                    type: ['string', 'null'],
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['sessionId', 'turnId'],
              },
              AgentBackendPreference: {
                description:
                  "The next turn's choice, independent of an already admitted execution.\nModel revisions are resolved afresh; preferences never grant execution authority.",
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      connectionId: {
                        type: 'string',
                        minLength: 1,
                      },
                      modelId: {
                        type: 'string',
                        minLength: 1,
                      },
                      thinkingLevel: {
                        anyOf: [
                          {
                            $ref: '#/$defs/ThinkingLevel',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'model',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'connectionId', 'modelId'],
                  },
                  {
                    type: 'object',
                    properties: {
                      selection: {
                        $ref: '#/$defs/AgentExecutorSelection',
                      },
                      kind: {
                        type: 'string',
                        const: 'executor',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'selection'],
                  },
                ],
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
              AgentExecutorSelection: {
                type: 'object',
                properties: {
                  executor: {
                    type: 'string',
                    minLength: 1,
                  },
                  settings: {
                    $ref: '#/$defs/ExecutorSettings',
                  },
                },
                additionalProperties: false,
                required: ['executor', 'settings'],
              },
              ExecutorSettings: {
                description:
                  'Executor-owned model selection, independent of Host model connections.',
                type: 'object',
                properties: {
                  model: {
                    type: ['string', 'null'],
                  },
                  thinkingLevel: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ThinkingLevel',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
              },
              CollaborationMode: {
                type: 'string',
                enum: ['agent', 'plan'],
              },
              AgentDataSource: {
                description:
                  'Stable business-data origin, independent of package or activation revisions.',
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  namespace: {
                    $ref: '#/$defs/InstanceId',
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'namespace'],
              },
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
              AgentWorkspacePermissions: {
                type: 'object',
                properties: {
                  access: {
                    $ref: '#/$defs/AgentWorkspaceAccess',
                  },
                  requestPermissions: {
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: ['access', 'requestPermissions'],
              },
              AgentWorkspaceAccess: {
                description:
                  'Session sandbox policy. Full access explicitly disables filesystem and process isolation.',
                type: 'string',
                enum: ['read_only', 'workspace_write', 'danger_full_access'],
              },
              AgentWorkspace: {
                type: 'object',
                properties: {
                  worktree: {
                    description:
                      'Native owner allocation; never accepted from a caller as workspace authority.',
                    anyOf: [
                      {
                        $ref: '#/$defs/Binding',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  projectId: {
                    description: "Optional membership in this Agent's canonical Project catalog.",
                    type: ['string', 'null'],
                    format: 'uuid',
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  identity: {
                    type: 'string',
                    pattern: '^workspace:v1:[A-Fa-f0-9-]{36}$',
                  },
                },
                additionalProperties: false,
                required: ['path', 'directoryIdentity', 'identity'],
              },
              Binding: {
                description: 'Immutable allocation intent, not the current child branch or HEAD.',
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  common_dir: {
                    type: 'string',
                  },
                  source: {
                    type: 'string',
                  },
                  source_identity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  base_commit: {
                    type: 'string',
                  },
                  directory: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: [
                  'id',
                  'common_dir',
                  'source',
                  'source_identity',
                  'base_commit',
                  'directory',
                ],
              },
              AgentSessionActivity: {
                type: 'string',
                enum: ['idle', 'working', 'waiting'],
              },
              AgentSessionMetrics: {
                description: 'Display-only readings from the latest completed main-model request.',
                type: 'object',
                properties: {
                  modelId: {
                    type: 'string',
                  },
                  connectionId: {
                    type: ['string', 'null'],
                  },
                  contextTokens: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  contextWindow: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  approximate: {
                    type: 'boolean',
                  },
                  contextLastKnown: {
                    description:
                      "The context count is the last completed request's baseline; newer additions are unknown.",
                    type: 'boolean',
                  },
                  outputTokensPerSecond: {
                    description:
                      "Provider output tokens divided by the model request's wall time.\nIncludes reasoning and time to first token; excludes tool/user waits.",
                    type: ['number', 'null'],
                    format: 'double',
                  },
                },
                additionalProperties: false,
                required: ['modelId', 'approximate', 'contextLastKnown'],
              },
              AgentRun: {
                type: 'object',
                properties: {
                  invocationId: {
                    type: 'string',
                  },
                  turnId: {
                    type: 'string',
                  },
                  state: {
                    $ref: '#/$defs/AgentRunState',
                  },
                },
                additionalProperties: false,
                required: ['invocationId', 'turnId', 'state'],
              },
              AgentRunState: {
                type: 'string',
                enum: ['admitted', 'running', 'waiting_for_user'],
              },
              AgentPart: {
                type: 'object',
                properties: {
                  startSequence: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  messageId: {
                    type: 'string',
                  },
                  stepId: {
                    type: 'string',
                  },
                  partId: {
                    type: 'string',
                  },
                  textKind: {
                    $ref: '#/$defs/AgentContentKind',
                  },
                },
                additionalProperties: false,
                required: ['startSequence', 'messageId', 'stepId', 'partId', 'textKind'],
              },
              AgentContentKind: {
                type: 'string',
                enum: ['text', 'thinking'],
              },
              AgentToolSeed: {
                type: 'object',
                properties: {
                  toolUseId: {
                    type: 'string',
                  },
                  startSequence: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['toolUseId', 'startSequence'],
              },
            },
          },
          resources: {},
        },
        pendingInteractions: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentSessionRead',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
            },
            additionalProperties: false,
            required: ['sessionId'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentPendingInteractions',
            type: 'object',
            properties: {
              revision: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
              entries: {
                type: 'array',
                items: {
                  $ref: '#/$defs/AgentInteractionSummary',
                },
              },
            },
            additionalProperties: false,
            required: ['revision', 'entries'],
            $defs: {
              AgentInteractionSummary: {
                type: 'object',
                properties: {
                  requestId: {
                    type: 'string',
                  },
                  kind: {
                    $ref: '#/$defs/AgentInteractionKind',
                  },
                  toolUseId: {
                    type: ['string', 'null'],
                  },
                },
                additionalProperties: false,
                required: ['requestId', 'kind', 'toolUseId'],
              },
              AgentInteractionKind: {
                type: 'string',
                enum: ['service_approval', 'question', 'permissions', 'form', 'client_capability'],
              },
            },
          },
          resources: {},
        },
        plan: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentPlanRead',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
              },
            },
            additionalProperties: false,
            required: ['sessionId'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentPlanView',
            type: 'object',
            properties: {
              enabled: {
                type: 'boolean',
              },
              current: {
                $ref: '#/$defs/AgentPlanSnapshot',
              },
            },
            additionalProperties: false,
            required: ['enabled', 'current'],
            $defs: {
              AgentPlanSnapshot: {
                description:
                  'Public business data only; frozen execution authority remains with the owner.',
                type: 'object',
                properties: {
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  proposal: {
                    anyOf: [
                      {
                        $ref: '#/$defs/PlanProposal',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  execution: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentPlanExecution',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
                required: ['revision'],
              },
              PlanProposal: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  planId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  turnId: {
                    type: 'string',
                  },
                  artifact: {
                    $ref: '#/$defs/PlanArtifact',
                  },
                  status: {
                    $ref: '#/$defs/PlanProposalStatus',
                  },
                  supersedes: {
                    type: ['string', 'null'],
                  },
                  sourceExecutionId: {
                    type: ['string', 'null'],
                  },
                  submittedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: [
                  'id',
                  'planId',
                  'revision',
                  'turnId',
                  'artifact',
                  'status',
                  'submittedAt',
                ],
              },
              PlanArtifact: {
                type: 'object',
                properties: {
                  title: {
                    type: 'string',
                  },
                  overview: {
                    type: ['string', 'null'],
                  },
                  steps: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/PlanStep',
                    },
                    minItems: 1,
                  },
                  risks: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                    default: [],
                  },
                },
                additionalProperties: false,
                required: ['title', 'steps'],
              },
              PlanStep: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                    minLength: 1,
                    pattern: '^[A-Za-z0-9_-]+$',
                  },
                  title: {
                    type: 'string',
                    minLength: 1,
                  },
                  description: {
                    type: 'string',
                  },
                  files: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                    default: [],
                  },
                  complexity: {
                    anyOf: [
                      {
                        $ref: '#/$defs/PlanComplexity',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
                required: ['id', 'title', 'description'],
              },
              PlanComplexity: {
                type: 'string',
                enum: ['low', 'medium', 'high'],
              },
              PlanProposalStatus: {
                type: 'string',
                enum: ['pending_approval', 'revision_requested', 'abandoned', 'approved'],
              },
              AgentPlanExecution: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  proposalId: {
                    type: 'string',
                  },
                  artifact: {
                    $ref: '#/$defs/PlanArtifact',
                  },
                  steps: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/PlanProgress',
                    },
                  },
                  phase: {
                    $ref: '#/$defs/AgentPlanPhase',
                  },
                  invocation: {
                    anyOf: [
                      {
                        $ref: '#/$defs/Invocation',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  reason: {
                    type: ['string', 'null'],
                  },
                  cancellation: {
                    type: ['string', 'null'],
                  },
                  updatedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['id', 'proposalId', 'artifact', 'steps', 'phase', 'updatedAt'],
              },
              PlanProgress: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  status: {
                    $ref: '#/$defs/PlanStepStatus',
                  },
                  note: {
                    type: ['string', 'null'],
                  },
                },
                additionalProperties: false,
                required: ['id', 'status'],
              },
              PlanStepStatus: {
                type: 'string',
                enum: ['pending', 'in_progress', 'completed', 'skipped'],
              },
              AgentPlanPhase: {
                type: 'string',
                enum: ['awaiting_admission', 'active', 'interrupted', 'completed', 'cancelled'],
              },
              Invocation: {
                type: 'object',
                properties: {
                  session_id: {
                    type: 'string',
                  },
                  turn_id: {
                    type: 'string',
                  },
                  run_id: {
                    type: 'string',
                  },
                  invocation_id: {
                    type: 'string',
                  },
                },
                required: ['session_id', 'turn_id', 'run_id', 'invocation_id'],
              },
            },
          },
          resources: {},
        },
        planHistory: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentPlanHistoryRead',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
              },
              throughRevision: {
                type: ['integer', 'null'],
                format: 'uint64',
                minimum: 0,
              },
              after: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
                default: 0,
              },
            },
            additionalProperties: false,
            required: ['sessionId'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentPlanHistory',
            type: 'object',
            properties: {
              throughRevision: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
              snapshots: {
                type: 'array',
                items: {
                  $ref: '#/$defs/AgentPlanSnapshot',
                },
              },
              nextAfter: {
                type: ['integer', 'null'],
                format: 'uint64',
                minimum: 0,
              },
            },
            additionalProperties: false,
            required: ['throughRevision', 'snapshots'],
            $defs: {
              AgentPlanSnapshot: {
                description:
                  'Public business data only; frozen execution authority remains with the owner.',
                type: 'object',
                properties: {
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  proposal: {
                    anyOf: [
                      {
                        $ref: '#/$defs/PlanProposal',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  execution: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentPlanExecution',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
                required: ['revision'],
              },
              PlanProposal: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  planId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  turnId: {
                    type: 'string',
                  },
                  artifact: {
                    $ref: '#/$defs/PlanArtifact',
                  },
                  status: {
                    $ref: '#/$defs/PlanProposalStatus',
                  },
                  supersedes: {
                    type: ['string', 'null'],
                  },
                  sourceExecutionId: {
                    type: ['string', 'null'],
                  },
                  submittedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: [
                  'id',
                  'planId',
                  'revision',
                  'turnId',
                  'artifact',
                  'status',
                  'submittedAt',
                ],
              },
              PlanArtifact: {
                type: 'object',
                properties: {
                  title: {
                    type: 'string',
                  },
                  overview: {
                    type: ['string', 'null'],
                  },
                  steps: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/PlanStep',
                    },
                    minItems: 1,
                  },
                  risks: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                    default: [],
                  },
                },
                additionalProperties: false,
                required: ['title', 'steps'],
              },
              PlanStep: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                    minLength: 1,
                    pattern: '^[A-Za-z0-9_-]+$',
                  },
                  title: {
                    type: 'string',
                    minLength: 1,
                  },
                  description: {
                    type: 'string',
                  },
                  files: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                    default: [],
                  },
                  complexity: {
                    anyOf: [
                      {
                        $ref: '#/$defs/PlanComplexity',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
                required: ['id', 'title', 'description'],
              },
              PlanComplexity: {
                type: 'string',
                enum: ['low', 'medium', 'high'],
              },
              PlanProposalStatus: {
                type: 'string',
                enum: ['pending_approval', 'revision_requested', 'abandoned', 'approved'],
              },
              AgentPlanExecution: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  proposalId: {
                    type: 'string',
                  },
                  artifact: {
                    $ref: '#/$defs/PlanArtifact',
                  },
                  steps: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/PlanProgress',
                    },
                  },
                  phase: {
                    $ref: '#/$defs/AgentPlanPhase',
                  },
                  invocation: {
                    anyOf: [
                      {
                        $ref: '#/$defs/Invocation',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  reason: {
                    type: ['string', 'null'],
                  },
                  cancellation: {
                    type: ['string', 'null'],
                  },
                  updatedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['id', 'proposalId', 'artifact', 'steps', 'phase', 'updatedAt'],
              },
              PlanProgress: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  status: {
                    $ref: '#/$defs/PlanStepStatus',
                  },
                  note: {
                    type: ['string', 'null'],
                  },
                },
                additionalProperties: false,
                required: ['id', 'status'],
              },
              PlanStepStatus: {
                type: 'string',
                enum: ['pending', 'in_progress', 'completed', 'skipped'],
              },
              AgentPlanPhase: {
                type: 'string',
                enum: ['awaiting_admission', 'active', 'interrupted', 'completed', 'cancelled'],
              },
              Invocation: {
                type: 'object',
                properties: {
                  session_id: {
                    type: 'string',
                  },
                  turn_id: {
                    type: 'string',
                  },
                  run_id: {
                    type: 'string',
                  },
                  invocation_id: {
                    type: 'string',
                  },
                },
                required: ['session_id', 'turn_id', 'run_id', 'invocation_id'],
              },
            },
          },
          resources: {},
        },
        planReceipt: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentPlanReceiptRead',
            type: 'object',
            properties: {
              reference: {
                $ref: '#/$defs/RecoveryRef',
              },
            },
            additionalProperties: false,
            required: ['reference'],
            $defs: {
              RecoveryRef: {
                type: 'object',
                properties: {
                  source: {
                    $ref: '#/$defs/DeploymentRef',
                  },
                  namespace: {
                    $ref: '#/$defs/InstanceId',
                  },
                  export: {
                    type: 'string',
                  },
                  method: {
                    type: 'string',
                  },
                  operation: {
                    type: 'string',
                    format: 'uuid',
                  },
                  fingerprint: {
                    type: 'string',
                  },
                  contract: {
                    $ref: '#/$defs/RecoveryContract',
                  },
                  recovery: {
                    $ref: '#/$defs/RecoveryProtocol',
                  },
                },
                additionalProperties: false,
                required: [
                  'source',
                  'namespace',
                  'export',
                  'method',
                  'operation',
                  'fingerprint',
                  'contract',
                  'recovery',
                ],
              },
              DeploymentRef: {
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'revision'],
              },
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
              RecoveryContract: {
                description:
                  'Contract identity for a journal lookup. The original request retains the\ncomplete contract; a receipt carries only its digest.',
                type: 'object',
                properties: {
                  name: {
                    type: 'string',
                  },
                  version: {
                    type: 'integer',
                    format: 'uint32',
                    minimum: 0,
                  },
                  transport: {
                    $ref: '#/$defs/Transport',
                  },
                  digest: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['name', 'version', 'transport', 'digest'],
              },
              Transport: {
                type: 'string',
                enum: ['local', 'remote'],
              },
              RecoveryProtocol: {
                type: 'string',
                enum: ['journal_v1'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'Nullable_AgentPlanResult',
            anyOf: [
              {
                $ref: '#/$defs/AgentPlanResult',
              },
              {
                type: 'null',
              },
            ],
            $defs: {
              AgentPlanResult: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      revision: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'committed',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'revision'],
                  },
                  {
                    type: 'object',
                    properties: {
                      actual: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'conflict',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'actual'],
                  },
                  {
                    type: 'object',
                    properties: {
                      reason: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'rejected',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'reason'],
                  },
                ],
              },
            },
          },
          resources: {},
        },
        project: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentProjectChange',
            oneOf: [
              {
                type: 'object',
                properties: {
                  selection: {
                    $ref: '#/$defs/AgentDirectorySelection',
                  },
                  expected: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentProjectRef',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  kind: {
                    type: 'string',
                    const: 'register',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'selection', 'expected'],
              },
              {
                type: 'object',
                properties: {
                  project: {
                    $ref: '#/$defs/AgentProjectRef',
                  },
                  name: {
                    type: 'string',
                    minLength: 1,
                  },
                  kind: {
                    type: 'string',
                    const: 'rename',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'project', 'name'],
              },
              {
                type: 'object',
                properties: {
                  project: {
                    $ref: '#/$defs/AgentProjectRef',
                  },
                  kind: {
                    type: 'string',
                    const: 'archive',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'project'],
              },
              {
                type: 'object',
                properties: {
                  project: {
                    $ref: '#/$defs/AgentProjectRef',
                  },
                  kind: {
                    type: 'string',
                    const: 'restore',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'project'],
              },
              {
                type: 'object',
                properties: {
                  project: {
                    $ref: '#/$defs/AgentProjectRef',
                  },
                  selection: {
                    $ref: '#/$defs/AgentDirectorySelection',
                  },
                  destination: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentProjectRef',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  kind: {
                    type: 'string',
                    const: 'relocate',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'project', 'selection', 'destination'],
              },
            ],
            $defs: {
              AgentDirectorySelection: {
                type: 'object',
                properties: {
                  rootId: {
                    type: 'string',
                    minLength: 1,
                  },
                  segments: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                },
                additionalProperties: false,
                required: ['rootId', 'segments', 'directoryIdentity'],
              },
              AgentProjectRef: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'string',
                    pattern: '^[a-f0-9]{64}$',
                  },
                },
                additionalProperties: false,
                required: ['id', 'revision'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentProjectResult',
            oneOf: [
              {
                type: 'object',
                properties: {
                  project: {
                    $ref: '#/$defs/AgentProject',
                  },
                  kind: {
                    type: 'string',
                    const: 'committed',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'project'],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'changed',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'unavailable',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'busy',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'invalid',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
            ],
            $defs: {
              AgentProject: {
                type: 'object',
                properties: {
                  reference: {
                    $ref: '#/$defs/AgentProjectRef',
                  },
                  name: {
                    type: 'string',
                    minLength: 1,
                  },
                  archived: {
                    type: 'boolean',
                  },
                  available: {
                    type: 'boolean',
                  },
                  selection: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentDirectorySelection',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  path: {
                    type: ['string', 'null'],
                  },
                },
                additionalProperties: false,
                required: ['reference', 'name', 'archived', 'available', 'selection', 'path'],
              },
              AgentProjectRef: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'string',
                    pattern: '^[a-f0-9]{64}$',
                  },
                },
                additionalProperties: false,
                required: ['id', 'revision'],
              },
              AgentDirectorySelection: {
                type: 'object',
                properties: {
                  rootId: {
                    type: 'string',
                    minLength: 1,
                  },
                  segments: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                },
                additionalProperties: false,
                required: ['rootId', 'segments', 'directoryIdentity'],
              },
            },
          },
          resources: {},
        },
        projects: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentProjectsRead',
            oneOf: [
              {
                type: 'object',
                properties: {
                  cursor: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentProjectCursor',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  kind: {
                    type: 'string',
                    const: 'list',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'cursor'],
              },
              {
                type: 'object',
                properties: {
                  selection: {
                    $ref: '#/$defs/AgentDirectorySelection',
                  },
                  kind: {
                    type: 'string',
                    const: 'directory',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'selection'],
              },
            ],
            $defs: {
              AgentProjectCursor: {
                type: 'object',
                properties: {
                  revision: {
                    type: 'string',
                    pattern: '^[a-f0-9]{64}$',
                  },
                  after: {
                    type: 'string',
                    format: 'uuid',
                  },
                },
                additionalProperties: false,
                required: ['revision', 'after'],
              },
              AgentDirectorySelection: {
                type: 'object',
                properties: {
                  rootId: {
                    type: 'string',
                    minLength: 1,
                  },
                  segments: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                },
                additionalProperties: false,
                required: ['rootId', 'segments', 'directoryIdentity'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentProjectsPage',
            oneOf: [
              {
                type: 'object',
                properties: {
                  revision: {
                    type: 'string',
                    pattern: '^[a-f0-9]{64}$',
                  },
                  projects: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/AgentProject',
                    },
                    maxItems: 16,
                  },
                  next: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentProjectCursor',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  kind: {
                    type: 'string',
                    const: 'projects',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'revision', 'projects', 'next'],
              },
              {
                type: 'object',
                properties: {
                  location: {
                    $ref: '#/$defs/AgentProjectLocation',
                  },
                  kind: {
                    type: 'string',
                    const: 'directory',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'location'],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'changed',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'unavailable',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
            ],
            $defs: {
              AgentProject: {
                type: 'object',
                properties: {
                  reference: {
                    $ref: '#/$defs/AgentProjectRef',
                  },
                  name: {
                    type: 'string',
                    minLength: 1,
                  },
                  archived: {
                    type: 'boolean',
                  },
                  available: {
                    type: 'boolean',
                  },
                  selection: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentDirectorySelection',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  path: {
                    type: ['string', 'null'],
                  },
                },
                additionalProperties: false,
                required: ['reference', 'name', 'archived', 'available', 'selection', 'path'],
              },
              AgentProjectRef: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'string',
                    pattern: '^[a-f0-9]{64}$',
                  },
                },
                additionalProperties: false,
                required: ['id', 'revision'],
              },
              AgentDirectorySelection: {
                type: 'object',
                properties: {
                  rootId: {
                    type: 'string',
                    minLength: 1,
                  },
                  segments: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                },
                additionalProperties: false,
                required: ['rootId', 'segments', 'directoryIdentity'],
              },
              AgentProjectCursor: {
                type: 'object',
                properties: {
                  revision: {
                    type: 'string',
                    pattern: '^[a-f0-9]{64}$',
                  },
                  after: {
                    type: 'string',
                    format: 'uuid',
                  },
                },
                additionalProperties: false,
                required: ['revision', 'after'],
              },
              AgentProjectLocation: {
                type: 'object',
                properties: {
                  selection: {
                    $ref: '#/$defs/AgentDirectorySelection',
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                  name: {
                    type: 'string',
                    minLength: 1,
                  },
                  project: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentProject',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
                required: ['selection', 'path', 'name', 'project'],
              },
            },
          },
          resources: {},
        },
        queue: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentSessionRead',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
            },
            additionalProperties: false,
            required: ['sessionId'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentQueue',
            type: 'object',
            properties: {
              revision: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
              entries: {
                type: 'array',
                items: {
                  $ref: '#/$defs/AgentQueueEntry',
                },
              },
            },
            additionalProperties: false,
            required: ['revision', 'entries'],
            $defs: {
              AgentQueueEntry: {
                type: 'object',
                properties: {
                  origin: {
                    anyOf: [
                      {
                        $ref: '#/$defs/MessageOrigin',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  messageId: {
                    type: 'string',
                  },
                  kind: {
                    $ref: '#/$defs/AgentQueueKind',
                  },
                  preview: {
                    type: 'string',
                    maxLength: 80,
                  },
                },
                additionalProperties: false,
                required: ['messageId', 'kind', 'preview'],
              },
              MessageOrigin: {
                description:
                  'Trusted producer attribution, preserved independently of editable content.',
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      taskId: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'workhub_task',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'taskId'],
                  },
                  {
                    type: 'object',
                    properties: {
                      graphId: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'workhub_graph',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'graphId'],
                  },
                ],
              },
              AgentQueueKind: {
                type: 'string',
                enum: ['in_flight', 'steering', 'followup'],
              },
            },
          },
          resources: {},
        },
        queueMessage: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentQueueMessage',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
              messageId: {
                type: 'string',
                minLength: 1,
              },
              expectedRevision: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
                maximum: 9007199254740991,
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'messageId', 'expectedRevision'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentQueueMessageResult',
            oneOf: [
              {
                type: 'object',
                properties: {
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  hasAttachments: {
                    type: 'boolean',
                  },
                  message: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'ready',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'revision', 'hasAttachments', 'message'],
              },
              {
                type: 'object',
                properties: {
                  expected: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  actual: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'revision_conflict',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'expected', 'actual'],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'missing',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
            ],
          },
          resources: {},
        },
        readFile: {
          mode: 'subscription',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentFileRead',
            description:
              'One bounded current-file capture. A version is a precondition, never read authority.',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
              },
              path: {
                $ref: '#/$defs/WorkspacePath',
              },
              expectedVersion: {
                type: ['string', 'null'],
                minLength: 71,
                maxLength: 71,
                pattern: '^sha256:[a-f0-9]{64}$',
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'path'],
            $defs: {
              WorkspacePath: {
                type: 'object',
                properties: {
                  bytesBase64: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['bytesBase64'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'Nullable_AgentFileReadPart',
            anyOf: [
              {
                $ref: '#/$defs/AgentFileReadPart',
              },
              {
                type: 'null',
              },
            ],
            $defs: {
              AgentFileReadPart: {
                description:
                  'All parts are subscription items; only End admits a complete preview.\nOffsets and byte counts refer to original bytes, not Base64 or UTF-16 lengths.',
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      version: {
                        type: 'string',
                      },
                      digest: {
                        type: 'string',
                      },
                      bytes: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      content: {
                        $ref: '#/$defs/AgentFileContent',
                      },
                      kind: {
                        type: 'string',
                        const: 'begin',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'version', 'digest', 'bytes', 'content'],
                  },
                  {
                    type: 'object',
                    properties: {
                      offset: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      data: {
                        type: 'string',
                        maxLength: 43692,
                      },
                      kind: {
                        type: 'string',
                        const: 'chunk',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'offset', 'data'],
                  },
                  {
                    type: 'object',
                    properties: {
                      version: {
                        type: 'string',
                      },
                      digest: {
                        type: 'string',
                      },
                      bytes: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'end',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'version', 'digest', 'bytes'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'absent',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'changed',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      bytes: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'binary',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'bytes'],
                  },
                  {
                    type: 'object',
                    properties: {
                      fileKind: {
                        $ref: '#/$defs/AgentFileKind',
                      },
                      kind: {
                        type: 'string',
                        const: 'unsupported',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'fileKind'],
                  },
                ],
              },
              AgentFileContent: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'text',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      mimeType: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'image',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'mimeType'],
                  },
                ],
              },
              AgentFileKind: {
                type: 'string',
                enum: ['file', 'directory', 'symlink', 'other'],
              },
            },
          },
          resources: {},
        },
        readPatch: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentPatchRead',
            type: 'object',
            properties: {
              execution: {
                $ref: '#/$defs/AgentExecutionRead',
              },
              offset: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
                maximum: 9007199254740991,
              },
            },
            additionalProperties: false,
            required: ['execution', 'offset'],
            $defs: {
              AgentExecutionRead: {
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                    minLength: 1,
                  },
                  invocationId: {
                    type: 'string',
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['sessionId', 'invocationId'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentPatchPage',
            oneOf: [
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'unavailable',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  patch: {
                    $ref: '#/$defs/AgentWorkspacePatch',
                  },
                  offset: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  next: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  text: {
                    type: 'string',
                    maxLength: 8192,
                  },
                  kind: {
                    type: 'string',
                    const: 'ready',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'patch', 'offset', 'next', 'text'],
              },
            ],
            $defs: {
              AgentWorkspacePatch: {
                type: 'object',
                properties: {
                  artifactId: {
                    type: 'string',
                  },
                  sessionId: {
                    type: 'string',
                  },
                  turnId: {
                    type: 'string',
                  },
                  baseCommit: {
                    type: 'string',
                  },
                  bytes: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['artifactId', 'sessionId', 'turnId', 'baseCommit', 'bytes'],
              },
            },
          },
          resources: {},
        },
        recall: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'RecallQuery',
            type: 'object',
            properties: {
              terms: {
                type: 'array',
                items: {
                  type: 'string',
                  minLength: 1,
                },
                minItems: 1,
              },
              question: {
                type: ['string', 'null'],
                minLength: 1,
              },
              limit: {
                type: ['integer', 'null'],
                format: 'uint',
                minimum: 1,
              },
              session_id: {
                type: ['string', 'null'],
                minLength: 1,
              },
              since: {
                type: ['integer', 'null'],
                format: 'uint64',
                minimum: 0,
              },
              until: {
                type: ['integer', 'null'],
                format: 'uint64',
                minimum: 0,
              },
            },
            additionalProperties: false,
            required: ['terms'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentRecallPage',
            type: 'object',
            properties: {
              titles: {
                type: 'array',
                items: {
                  $ref: '#/$defs/AgentSession',
                },
              },
              passages: {
                type: 'array',
                items: {
                  $ref: '#/$defs/AgentRecallPassage',
                },
              },
              complete: {
                type: 'boolean',
              },
              gaps: {
                type: 'array',
                items: {
                  type: 'string',
                },
              },
            },
            additionalProperties: false,
            required: ['titles', 'passages', 'complete', 'gaps'],
            $defs: {
              AgentSession: {
                type: 'object',
                properties: {
                  branch: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentSessionBranch',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  backend: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentBackendPreference',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  collaborationMode: {
                    $ref: '#/$defs/CollaborationMode',
                    default: 'agent',
                  },
                  tools: {
                    type: ['array', 'null'],
                    items: {
                      type: 'string',
                    },
                  },
                  dataSource: {
                    $ref: '#/$defs/AgentDataSource',
                  },
                  permissions: {
                    $ref: '#/$defs/AgentWorkspacePermissions',
                  },
                  boundaryRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  id: {
                    type: 'string',
                  },
                  title: {
                    type: 'string',
                  },
                  labels: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  workspace: {
                    $ref: '#/$defs/AgentWorkspace',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  updatedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  archived: {
                    type: 'boolean',
                  },
                  hasUnread: {
                    type: 'boolean',
                  },
                  activity: {
                    $ref: '#/$defs/AgentSessionActivity',
                  },
                },
                additionalProperties: false,
                required: [
                  'branch',
                  'dataSource',
                  'permissions',
                  'boundaryRevision',
                  'id',
                  'title',
                  'labels',
                  'workspace',
                  'revision',
                  'updatedAt',
                  'archived',
                  'hasUnread',
                  'activity',
                ],
              },
              AgentSessionBranch: {
                description:
                  'Frozen conversation ancestry for presentation, not authority over the source.',
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                    minLength: 1,
                  },
                  turnId: {
                    type: ['string', 'null'],
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['sessionId', 'turnId'],
              },
              AgentBackendPreference: {
                description:
                  "The next turn's choice, independent of an already admitted execution.\nModel revisions are resolved afresh; preferences never grant execution authority.",
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      connectionId: {
                        type: 'string',
                        minLength: 1,
                      },
                      modelId: {
                        type: 'string',
                        minLength: 1,
                      },
                      thinkingLevel: {
                        anyOf: [
                          {
                            $ref: '#/$defs/ThinkingLevel',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'model',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'connectionId', 'modelId'],
                  },
                  {
                    type: 'object',
                    properties: {
                      selection: {
                        $ref: '#/$defs/AgentExecutorSelection',
                      },
                      kind: {
                        type: 'string',
                        const: 'executor',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'selection'],
                  },
                ],
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
              AgentExecutorSelection: {
                type: 'object',
                properties: {
                  executor: {
                    type: 'string',
                    minLength: 1,
                  },
                  settings: {
                    $ref: '#/$defs/ExecutorSettings',
                  },
                },
                additionalProperties: false,
                required: ['executor', 'settings'],
              },
              ExecutorSettings: {
                description:
                  'Executor-owned model selection, independent of Host model connections.',
                type: 'object',
                properties: {
                  model: {
                    type: ['string', 'null'],
                  },
                  thinkingLevel: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ThinkingLevel',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
              },
              CollaborationMode: {
                type: 'string',
                enum: ['agent', 'plan'],
              },
              AgentDataSource: {
                description:
                  'Stable business-data origin, independent of package or activation revisions.',
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  namespace: {
                    $ref: '#/$defs/InstanceId',
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'namespace'],
              },
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
              AgentWorkspacePermissions: {
                type: 'object',
                properties: {
                  access: {
                    $ref: '#/$defs/AgentWorkspaceAccess',
                  },
                  requestPermissions: {
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: ['access', 'requestPermissions'],
              },
              AgentWorkspaceAccess: {
                description:
                  'Session sandbox policy. Full access explicitly disables filesystem and process isolation.',
                type: 'string',
                enum: ['read_only', 'workspace_write', 'danger_full_access'],
              },
              AgentWorkspace: {
                type: 'object',
                properties: {
                  worktree: {
                    description:
                      'Native owner allocation; never accepted from a caller as workspace authority.',
                    anyOf: [
                      {
                        $ref: '#/$defs/Binding',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  projectId: {
                    description: "Optional membership in this Agent's canonical Project catalog.",
                    type: ['string', 'null'],
                    format: 'uuid',
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  identity: {
                    type: 'string',
                    pattern: '^workspace:v1:[A-Fa-f0-9-]{36}$',
                  },
                },
                additionalProperties: false,
                required: ['path', 'directoryIdentity', 'identity'],
              },
              Binding: {
                description: 'Immutable allocation intent, not the current child branch or HEAD.',
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  common_dir: {
                    type: 'string',
                  },
                  source: {
                    type: 'string',
                  },
                  source_identity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  base_commit: {
                    type: 'string',
                  },
                  directory: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: [
                  'id',
                  'common_dir',
                  'source',
                  'source_identity',
                  'base_commit',
                  'directory',
                ],
              },
              AgentSessionActivity: {
                type: 'string',
                enum: ['idle', 'working', 'waiting'],
              },
              AgentRecallPassage: {
                type: 'object',
                properties: {
                  session: {
                    $ref: '#/$defs/AgentSession',
                  },
                  anchorMessageId: {
                    type: 'string',
                  },
                  anchorPosition: {
                    $ref: '#/$defs/HistoryRowPosition',
                  },
                  excerpt: {
                    type: 'string',
                  },
                  matchedTerms: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                },
                additionalProperties: false,
                required: [
                  'session',
                  'anchorMessageId',
                  'anchorPosition',
                  'excerpt',
                  'matchedTerms',
                ],
              },
              HistoryRowPosition: {
                description:
                  'Disposable presentation locator, never authority or a canonical execution fact.\nThe source is the original emitting fact; the index precedes UI filtering.',
                type: 'object',
                properties: {
                  sourceSequence: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  itemIndex: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                },
                additionalProperties: false,
                required: ['sourceSequence', 'itemIndex'],
              },
            },
          },
          resources: {},
        },
        recap: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentRecapRead',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
              },
              operationId: {
                type: ['string', 'null'],
                format: 'uuid',
                default: null,
              },
            },
            additionalProperties: false,
            required: ['sessionId'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'Nullable_AgentRecapReceipt',
            anyOf: [
              {
                $ref: '#/$defs/AgentRecapReceipt',
              },
              {
                type: 'null',
              },
            ],
            $defs: {
              AgentRecapReceipt: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      operationId: {
                        type: 'string',
                        format: 'uuid',
                      },
                      through: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'pending',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'operationId', 'through'],
                  },
                  {
                    type: 'object',
                    properties: {
                      operationId: {
                        type: 'string',
                        format: 'uuid',
                      },
                      through: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      text: {
                        type: 'string',
                      },
                      modelId: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'ready',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'operationId', 'through', 'text', 'modelId'],
                  },
                  {
                    type: 'object',
                    properties: {
                      operationId: {
                        type: 'string',
                        format: 'uuid',
                      },
                      through: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      reason: {
                        $ref: '#/$defs/AgentRecapFailure',
                      },
                      kind: {
                        type: 'string',
                        const: 'failed',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'operationId', 'through', 'reason'],
                  },
                ],
              },
              AgentRecapFailure: {
                type: 'string',
                enum: ['empty_or_oversized_output', 'incomplete_output', 'model_unavailable'],
              },
            },
          },
          resources: {},
        },
        respond: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentInteractionRespond',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
              requestId: {
                type: 'string',
                minLength: 1,
              },
              answer: {
                $ref: '#/$defs/InteractionAnswer',
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'requestId', 'answer'],
            $defs: {
              InteractionAnswer: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      decision: {
                        $ref: '#/$defs/Decision',
                      },
                      kind: {
                        type: 'string',
                        const: 'service_approval',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'decision'],
                  },
                  {
                    type: 'object',
                    properties: {
                      decision: {
                        $ref: '#/$defs/Decision2',
                      },
                      kind: {
                        type: 'string',
                        const: 'permissions',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'decision'],
                  },
                  {
                    type: 'object',
                    properties: {
                      answers: {
                        type: 'array',
                        items: {
                          type: ['string', 'null'],
                        },
                      },
                      kind: {
                        type: 'string',
                        const: 'question',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'answers'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'form',
                      },
                    },
                    unevaluatedProperties: false,
                    oneOf: [
                      {
                        type: 'object',
                        properties: {
                          values: {
                            type: 'object',
                            additionalProperties: {
                              $ref: '#/$defs/FormValue',
                            },
                          },
                          action: {
                            type: 'string',
                            const: 'accept',
                          },
                        },
                        required: ['action', 'values'],
                      },
                      {
                        type: 'object',
                        properties: {
                          action: {
                            type: 'string',
                            const: 'decline',
                          },
                        },
                        required: ['action'],
                      },
                      {
                        type: 'object',
                        properties: {
                          action: {
                            type: 'string',
                            const: 'cancel',
                          },
                        },
                        required: ['action'],
                      },
                    ],
                    required: ['kind'],
                  },
                  {
                    type: 'object',
                    properties: {
                      decision: {
                        $ref: '#/$defs/Decision',
                      },
                      kind: {
                        type: 'string',
                        const: 'client_capability',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'decision'],
                  },
                ],
              },
              Decision: {
                type: 'string',
                enum: ['allow', 'deny'],
              },
              Decision2: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      decision: {
                        type: 'string',
                        const: 'deny',
                      },
                    },
                    required: ['decision'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      permissions: {
                        $ref: '#/$defs/Permissions',
                      },
                      scope: {
                        $ref: '#/$defs/Scope2',
                      },
                      decision: {
                        type: 'string',
                        const: 'allow',
                      },
                    },
                    additionalProperties: false,
                    required: ['decision', 'permissions', 'scope'],
                  },
                ],
              },
              Permissions: {
                type: 'object',
                properties: {
                  filesystem: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/Rule',
                    },
                  },
                  network: {
                    $ref: '#/$defs/Network',
                  },
                },
                additionalProperties: false,
                required: ['filesystem', 'network'],
              },
              Rule: {
                description:
                  'Paths have executor-native meaning. Validate and materialize them on the\nexecution host, never on a remote Desktop. This document alone grants nothing.',
                type: 'object',
                properties: {
                  path: {
                    type: 'string',
                  },
                  scope: {
                    $ref: '#/$defs/Scope',
                  },
                  access: {
                    $ref: '#/$defs/Access',
                  },
                },
                additionalProperties: false,
                required: ['path', 'scope', 'access'],
              },
              Scope: {
                type: 'string',
                enum: ['subtree', 'exact'],
              },
              Access: {
                description:
                  'Equal-path conflict priority is different from authority breadth: deny wins.',
                type: 'string',
                enum: ['read', 'write', 'deny'],
              },
              Network: {
                oneOf: [
                  {
                    type: 'string',
                    enum: ['denied', 'allowed'],
                  },
                  {
                    type: 'object',
                    properties: {
                      restricted: {
                        type: 'object',
                        properties: {
                          destinations: {
                            type: 'array',
                            uniqueItems: true,
                            items: {
                              $ref: '#/$defs/Destination',
                            },
                          },
                        },
                        additionalProperties: false,
                        required: ['destinations'],
                      },
                    },
                    required: ['restricted'],
                    additionalProperties: false,
                  },
                ],
              },
              Destination: {
                description:
                  'Destination authority, independent of the upstream proxy used to reach it.\nA domain grant does not authorize its subdomains or other ports.',
                type: 'object',
                properties: {
                  host: {
                    type: 'string',
                    minLength: 1,
                    maxLength: 253,
                  },
                  port: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 1,
                    maximum: 65535,
                  },
                },
                additionalProperties: false,
                required: ['host', 'port'],
              },
              Scope2: {
                type: 'string',
                enum: ['once', 'turn', 'session'],
              },
              FormValue: {
                anyOf: [
                  {
                    type: 'string',
                  },
                  {
                    type: 'number',
                    format: 'double',
                  },
                  {
                    type: 'boolean',
                  },
                  {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                ],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentInteractionResult',
            oneOf: [
              {
                description:
                  'Includes a concurrent winner. Consumers inspect the canonical outcome.',
                type: 'object',
                properties: {
                  record: {
                    $ref: '#/$defs/InteractionRecord',
                  },
                  kind: {
                    type: 'string',
                    const: 'recorded',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'record'],
              },
              {
                type: 'object',
                properties: {
                  reason: {
                    $ref: '#/$defs/AgentInteractionRejection',
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'reason'],
              },
            ],
            $defs: {
              InteractionRecord: {
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  turnId: {
                    type: 'string',
                  },
                  runId: {
                    type: 'string',
                  },
                  requestId: {
                    type: 'string',
                  },
                  createdAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  request: {
                    $ref: '#/$defs/InteractionRequest',
                  },
                  outcome: {
                    anyOf: [
                      {
                        $ref: '#/$defs/InteractionOutcome',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
                required: [
                  'sessionId',
                  'turnId',
                  'runId',
                  'requestId',
                  'createdAt',
                  'request',
                  'outcome',
                ],
              },
              InteractionRequest: {
                oneOf: [
                  {
                    description:
                      'Consent for one already journaled service call; never a service grant.',
                    type: 'object',
                    properties: {
                      toolUseId: {
                        type: 'string',
                      },
                      toolName: {
                        type: 'string',
                      },
                      service: {
                        type: 'string',
                      },
                      method: {
                        type: 'string',
                      },
                      binding: {
                        type: 'string',
                      },
                      through: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'service_approval',
                      },
                    },
                    additionalProperties: false,
                    required: [
                      'kind',
                      'toolUseId',
                      'toolName',
                      'service',
                      'method',
                      'binding',
                      'through',
                    ],
                  },
                  {
                    type: 'object',
                    properties: {
                      toolUseId: {
                        type: ['string', 'null'],
                      },
                      baseRevision: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      request: {
                        $ref: '#/$defs/PermissionRequest',
                      },
                      kind: {
                        type: 'string',
                        const: 'permissions',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'toolUseId', 'baseRevision', 'request'],
                  },
                  {
                    type: 'object',
                    properties: {
                      toolUseId: {
                        type: 'string',
                      },
                      questions: {
                        type: 'array',
                        items: {
                          $ref: '#/$defs/InteractionQuestion',
                        },
                      },
                      kind: {
                        type: 'string',
                        const: 'question',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'toolUseId', 'questions'],
                  },
                  {
                    type: 'object',
                    properties: {
                      toolUseId: {
                        type: 'string',
                      },
                      message: {
                        type: 'string',
                      },
                      requester: {
                        $ref: '#/$defs/FormRequester',
                      },
                      fields: {
                        type: 'array',
                        items: {
                          $ref: '#/$defs/FormField',
                        },
                      },
                      kind: {
                        type: 'string',
                        const: 'form',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'toolUseId', 'message', 'requester', 'fields'],
                  },
                  {
                    type: 'object',
                    properties: {
                      toolUseId: {
                        type: 'string',
                      },
                      target: {
                        $ref: '#/$defs/GrantTarget',
                      },
                      baseRevision: {
                        description:
                          'Agent-owned approvals expire with this original permission boundary.\nOlder capability records without a boundary remain readable.',
                        type: ['integer', 'null'],
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'client_capability',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'toolUseId', 'target'],
                  },
                ],
              },
              PermissionRequest: {
                description:
                  'The Host supplies the real operation description; it is display information,\nnot authority inferred from a command string or a plugin-supplied Session ID.',
                type: 'object',
                properties: {
                  reason: {
                    type: 'string',
                  },
                  command: {
                    anyOf: [
                      {
                        $ref: '#/$defs/PermissionCommand',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  permissions: {
                    $ref: '#/$defs/Permissions',
                  },
                },
                additionalProperties: false,
                required: ['reason', 'permissions'],
              },
              PermissionCommand: {
                type: 'object',
                properties: {
                  command: {
                    type: 'string',
                  },
                  cwd: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['command', 'cwd'],
              },
              Permissions: {
                type: 'object',
                properties: {
                  filesystem: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/Rule',
                    },
                  },
                  network: {
                    $ref: '#/$defs/Network',
                  },
                },
                additionalProperties: false,
                required: ['filesystem', 'network'],
              },
              Rule: {
                description:
                  'Paths have executor-native meaning. Validate and materialize them on the\nexecution host, never on a remote Desktop. This document alone grants nothing.',
                type: 'object',
                properties: {
                  path: {
                    type: 'string',
                  },
                  scope: {
                    $ref: '#/$defs/Scope',
                  },
                  access: {
                    $ref: '#/$defs/Access',
                  },
                },
                additionalProperties: false,
                required: ['path', 'scope', 'access'],
              },
              Scope: {
                type: 'string',
                enum: ['subtree', 'exact'],
              },
              Access: {
                description:
                  'Equal-path conflict priority is different from authority breadth: deny wins.',
                type: 'string',
                enum: ['read', 'write', 'deny'],
              },
              Network: {
                oneOf: [
                  {
                    type: 'string',
                    enum: ['denied', 'allowed'],
                  },
                  {
                    type: 'object',
                    properties: {
                      restricted: {
                        type: 'object',
                        properties: {
                          destinations: {
                            type: 'array',
                            uniqueItems: true,
                            items: {
                              $ref: '#/$defs/Destination',
                            },
                          },
                        },
                        additionalProperties: false,
                        required: ['destinations'],
                      },
                    },
                    required: ['restricted'],
                    additionalProperties: false,
                  },
                ],
              },
              Destination: {
                description:
                  'Destination authority, independent of the upstream proxy used to reach it.\nA domain grant does not authorize its subdomains or other ports.',
                type: 'object',
                properties: {
                  host: {
                    type: 'string',
                    minLength: 1,
                    maxLength: 253,
                  },
                  port: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 1,
                    maximum: 65535,
                  },
                },
                additionalProperties: false,
                required: ['host', 'port'],
              },
              InteractionQuestion: {
                type: 'object',
                properties: {
                  question: {
                    type: 'string',
                    minLength: 1,
                  },
                  options: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/QuestionOption',
                    },
                    minItems: 2,
                    maxItems: 3,
                  },
                },
                additionalProperties: false,
                required: ['question', 'options'],
              },
              QuestionOption: {
                type: 'object',
                properties: {
                  label: {
                    type: 'string',
                    minLength: 1,
                  },
                  description: {
                    type: 'string',
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['label'],
              },
              FormRequester: {
                type: 'object',
                properties: {
                  name: {
                    type: 'string',
                  },
                  source: {
                    type: ['string', 'null'],
                  },
                },
                additionalProperties: false,
                required: ['name'],
              },
              FormField: {
                type: 'object',
                properties: {
                  name: {
                    type: 'string',
                  },
                  label: {
                    type: 'string',
                  },
                  required: {
                    type: 'boolean',
                  },
                  description: {
                    type: ['string', 'null'],
                  },
                },
                required: ['name', 'label', 'required'],
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      default: {
                        type: ['string', 'null'],
                      },
                      minLength: {
                        type: ['integer', 'null'],
                        format: 'uint',
                        minimum: 0,
                      },
                      maxLength: {
                        type: ['integer', 'null'],
                        format: 'uint',
                        minimum: 0,
                      },
                      format: {
                        anyOf: [
                          {
                            $ref: '#/$defs/FormFormat',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'string',
                      },
                    },
                    required: ['kind'],
                  },
                  {
                    type: 'object',
                    properties: {
                      default: {
                        type: ['number', 'null'],
                        format: 'double',
                      },
                      minimum: {
                        type: ['number', 'null'],
                        format: 'double',
                      },
                      maximum: {
                        type: ['number', 'null'],
                        format: 'double',
                      },
                      kind: {
                        type: 'string',
                        const: 'number',
                      },
                    },
                    required: ['kind'],
                  },
                  {
                    type: 'object',
                    properties: {
                      default: {
                        type: ['number', 'null'],
                        format: 'double',
                      },
                      minimum: {
                        type: ['number', 'null'],
                        format: 'double',
                      },
                      maximum: {
                        type: ['number', 'null'],
                        format: 'double',
                      },
                      kind: {
                        type: 'string',
                        const: 'integer',
                      },
                    },
                    required: ['kind'],
                  },
                  {
                    type: 'object',
                    properties: {
                      default: {
                        type: ['boolean', 'null'],
                      },
                      kind: {
                        type: 'string',
                        const: 'boolean',
                      },
                    },
                    required: ['kind'],
                  },
                  {
                    type: 'object',
                    properties: {
                      options: {
                        type: 'array',
                        items: {
                          $ref: '#/$defs/FormOption',
                        },
                      },
                      default: {
                        type: ['string', 'null'],
                      },
                      kind: {
                        type: 'string',
                        const: 'single_select',
                      },
                    },
                    required: ['kind', 'options'],
                  },
                  {
                    type: 'object',
                    properties: {
                      options: {
                        type: 'array',
                        items: {
                          $ref: '#/$defs/FormOption',
                        },
                      },
                      default: {
                        type: ['array', 'null'],
                        items: {
                          type: 'string',
                        },
                      },
                      minItems: {
                        type: ['integer', 'null'],
                        format: 'uint',
                        minimum: 0,
                      },
                      maxItems: {
                        type: ['integer', 'null'],
                        format: 'uint',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'multi_select',
                      },
                    },
                    required: ['kind', 'options'],
                  },
                ],
              },
              FormFormat: {
                type: 'string',
                enum: ['email', 'uri', 'date', 'date-time'],
              },
              FormOption: {
                type: 'object',
                properties: {
                  value: {
                    type: 'string',
                  },
                  label: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['value', 'label'],
              },
              GrantTarget: {
                type: 'object',
                properties: {
                  providerId: {
                    type: 'string',
                  },
                  contractId: {
                    type: 'string',
                  },
                  serverId: {
                    type: 'string',
                  },
                  toolName: {
                    type: 'string',
                  },
                  capability: {
                    $ref: '#/$defs/GrantCapability',
                  },
                  scope: {
                    $ref: '#/$defs/GrantScope',
                  },
                },
                required: [
                  'providerId',
                  'contractId',
                  'serverId',
                  'toolName',
                  'capability',
                  'scope',
                ],
              },
              GrantCapability: {
                type: 'string',
                enum: ['browser', 'computer_use', 'desktop_mcp', 'mcp'],
              },
              GrantScope: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      origin: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'browser_origin',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'origin'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'capability',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind'],
                  },
                  {
                    type: 'object',
                    properties: {
                      serverId: {
                        type: 'string',
                      },
                      toolName: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'mcp_tool',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'serverId', 'toolName'],
                  },
                ],
              },
              InteractionOutcome: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      decision: {
                        $ref: '#/$defs/Decision',
                      },
                      committedAt: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'service_approval_decision',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'decision', 'committedAt'],
                  },
                  {
                    type: 'object',
                    properties: {
                      decision: {
                        $ref: '#/$defs/Decision2',
                      },
                      committedAt: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'permissions_decision',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'decision', 'committedAt'],
                  },
                  {
                    type: 'object',
                    properties: {
                      answers: {
                        type: 'array',
                        items: {
                          type: ['string', 'null'],
                        },
                      },
                      committedAt: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'question_answer',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'answers', 'committedAt'],
                  },
                  {
                    type: 'object',
                    properties: {
                      committedAt: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'form_answer',
                      },
                    },
                    unevaluatedProperties: false,
                    oneOf: [
                      {
                        type: 'object',
                        properties: {
                          values: {
                            type: 'object',
                            additionalProperties: {
                              $ref: '#/$defs/FormValue',
                            },
                          },
                          action: {
                            type: 'string',
                            const: 'accept',
                          },
                        },
                        required: ['action', 'values'],
                      },
                      {
                        type: 'object',
                        properties: {
                          action: {
                            type: 'string',
                            const: 'decline',
                          },
                        },
                        required: ['action'],
                      },
                      {
                        type: 'object',
                        properties: {
                          action: {
                            type: 'string',
                            const: 'cancel',
                          },
                        },
                        required: ['action'],
                      },
                    ],
                    required: ['kind', 'committedAt'],
                  },
                  {
                    type: 'object',
                    properties: {
                      decision: {
                        $ref: '#/$defs/Decision',
                      },
                      committedAt: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'client_capability_decision',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'decision', 'committedAt'],
                  },
                  {
                    type: 'object',
                    properties: {
                      reason: {
                        $ref: '#/$defs/ClosureReason',
                      },
                      committedAt: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'closure',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'reason', 'committedAt'],
                  },
                ],
              },
              Decision: {
                type: 'string',
                enum: ['allow', 'deny'],
              },
              Decision2: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      decision: {
                        type: 'string',
                        const: 'deny',
                      },
                    },
                    required: ['decision'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      permissions: {
                        $ref: '#/$defs/Permissions',
                      },
                      scope: {
                        $ref: '#/$defs/Scope2',
                      },
                      decision: {
                        type: 'string',
                        const: 'allow',
                      },
                    },
                    additionalProperties: false,
                    required: ['decision', 'permissions', 'scope'],
                  },
                ],
              },
              Scope2: {
                type: 'string',
                enum: ['once', 'turn', 'session'],
              },
              FormValue: {
                anyOf: [
                  {
                    type: 'string',
                  },
                  {
                    type: 'number',
                    format: 'double',
                  },
                  {
                    type: 'boolean',
                  },
                  {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                ],
              },
              ClosureReason: {
                type: 'string',
                enum: [
                  'turn_stopped',
                  'turn_terminal',
                  'producer_cancelled',
                  'timed_out',
                  'host_restarted',
                  'provider_disconnected',
                ],
              },
              AgentInteractionRejection: {
                type: 'string',
                enum: ['closed', 'unavailable', 'invalid_answer', 'unsupported'],
              },
            },
          },
          resources: {},
        },
        resume: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentResume',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
              sourceInvocationId: {
                type: 'string',
                minLength: 1,
              },
              sourceHighWater: {
                description: 'Exact Run-local count returned by execution.',
                type: 'integer',
                format: 'uint64',
                minimum: 1,
                maximum: 9007199254740991,
              },
              model: {
                description:
                  'Explicit model selection for this new continuation; original input is replayed.',
                $ref: '#/$defs/ModelSelection',
              },
              thinkingLevel: {
                anyOf: [
                  {
                    $ref: '#/$defs/ThinkingLevel',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'sourceInvocationId', 'sourceHighWater', 'model'],
            $defs: {
              ModelSelection: {
                description:
                  'Exact public selection observed by a caller, checked once at run admission.',
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                    minLength: 1,
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  modelId: {
                    type: 'string',
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'revision', 'modelId'],
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentResumeResult',
            oneOf: [
              {
                type: 'object',
                properties: {
                  execution: {
                    $ref: '#/$defs/AgentExecution',
                  },
                  kind: {
                    type: 'string',
                    const: 'started',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'execution'],
              },
              {
                type: 'object',
                properties: {
                  reason: {
                    $ref: '#/$defs/AgentResumeParkReason',
                  },
                  kind: {
                    type: 'string',
                    const: 'parked',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'reason'],
              },
            ],
            $defs: {
              AgentExecution: {
                description:
                  'Canonical physical execution receipt, independent of the current Session tip.',
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  turnId: {
                    type: 'string',
                  },
                  runId: {
                    type: 'string',
                  },
                  invocationId: {
                    type: 'string',
                  },
                  highWater: {
                    description: 'Run-local event count, not the root-global transcript cursor.',
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  state: {
                    $ref: '#/$defs/AgentExecutionState',
                  },
                },
                additionalProperties: false,
                required: ['sessionId', 'turnId', 'runId', 'invocationId', 'highWater', 'state'],
              },
              AgentExecutionState: {
                type: 'string',
                enum: [
                  'admitted',
                  'running',
                  'waiting',
                  'paused',
                  'completed',
                  'failed',
                  'cancelled',
                ],
              },
              AgentResumeParkReason: {
                type: 'string',
                enum: [
                  'closed',
                  'archived',
                  'busy',
                  'source_missing',
                  'source_changed',
                  'source_not_resumable',
                  'already_continued',
                  'workspace_changed',
                  'safety_check_failed',
                ],
              },
            },
          },
          resources: {},
        },
        schedule: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentScheduleChange',
            oneOf: [
              {
                type: 'object',
                properties: {
                  input: {
                    $ref: '#/$defs/AgentScheduledInput',
                  },
                  kind: {
                    type: 'string',
                    const: 'create',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'input'],
              },
              {
                type: 'object',
                properties: {
                  taskId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  input: {
                    $ref: '#/$defs/AgentScheduledInput',
                  },
                  kind: {
                    type: 'string',
                    const: 'update',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'taskId', 'revision', 'input'],
              },
              {
                type: 'object',
                properties: {
                  taskId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'approve',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'taskId', 'revision'],
              },
              {
                type: 'object',
                properties: {
                  taskId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'pause',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'taskId', 'revision'],
              },
              {
                type: 'object',
                properties: {
                  taskId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'resume',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'taskId', 'revision'],
              },
              {
                type: 'object',
                properties: {
                  taskId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'trigger_now',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'taskId', 'revision'],
              },
              {
                type: 'object',
                properties: {
                  taskId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  delayMs: {
                    type: 'integer',
                    format: 'int64',
                  },
                  kind: {
                    type: 'string',
                    const: 'snooze',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'taskId', 'revision', 'delayMs'],
              },
              {
                type: 'object',
                properties: {
                  taskId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  fireId: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'acknowledge',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'taskId', 'revision', 'fireId'],
              },
              {
                type: 'object',
                properties: {
                  taskId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'clear_history',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'taskId', 'revision'],
              },
              {
                type: 'object',
                properties: {
                  taskId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'delete',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'taskId', 'revision'],
              },
            ],
            $defs: {
              AgentScheduledInput: {
                type: 'object',
                properties: {
                  task: {
                    $ref: '#/$defs/Create',
                  },
                  timezone: {
                    type: 'string',
                  },
                  misfire: {
                    $ref: '#/$defs/Misfire',
                  },
                },
                additionalProperties: false,
                required: ['task', 'timezone', 'misfire'],
              },
              Create: {
                type: 'object',
                properties: {
                  title: {
                    type: 'string',
                  },
                  intentBody: {
                    type: 'string',
                  },
                  schedule: {
                    $ref: '#/$defs/Schedule',
                  },
                  effect: {
                    $ref: '#/$defs/AgentScheduledEffect',
                  },
                  maxFires: {
                    type: ['integer', 'null'],
                    format: 'uint32',
                    minimum: 0,
                    default: null,
                  },
                  expiresAt: {
                    type: ['integer', 'null'],
                    format: 'int64',
                    default: null,
                  },
                },
                additionalProperties: false,
                required: ['title', 'intentBody', 'schedule', 'effect'],
              },
              Schedule: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      runAt: {
                        type: 'integer',
                        format: 'int64',
                      },
                      kind: {
                        type: 'string',
                        const: 'once',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'runAt'],
                  },
                  {
                    type: 'object',
                    properties: {
                      everySeconds: {
                        type: 'integer',
                        format: 'uint32',
                        minimum: 0,
                      },
                      startAt: {
                        type: 'integer',
                        format: 'int64',
                      },
                      kind: {
                        type: 'string',
                        const: 'interval',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'everySeconds', 'startAt'],
                  },
                  {
                    type: 'object',
                    properties: {
                      recurrence: {
                        $ref: '#/$defs/Recurrence',
                      },
                      anchorAt: {
                        type: 'integer',
                        format: 'int64',
                      },
                      kind: {
                        type: 'string',
                        const: 'calendar',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'recurrence', 'anchorAt'],
                  },
                  {
                    type: 'object',
                    properties: {
                      expression: {
                        type: 'string',
                      },
                      startAt: {
                        type: 'integer',
                        format: 'int64',
                      },
                      kind: {
                        type: 'string',
                        const: 'cron',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'expression', 'startAt'],
                  },
                ],
              },
              Recurrence: {
                type: 'string',
                enum: ['daily', 'weekly', 'monthly'],
              },
              AgentScheduledEffect: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'reminder',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      target: {
                        $ref: '#/$defs/AgentScheduledTarget',
                      },
                      model: {
                        $ref: '#/$defs/ModelSelection',
                      },
                      thinkingLevel: {
                        anyOf: [
                          {
                            $ref: '#/$defs/ThinkingLevel',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'session',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'target', 'model'],
                  },
                  {
                    type: 'object',
                    properties: {
                      target: {
                        $ref: '#/$defs/AgentScheduledTarget',
                      },
                      model: {
                        $ref: '#/$defs/ModelSelection',
                      },
                      thinkingLevel: {
                        anyOf: [
                          {
                            $ref: '#/$defs/ThinkingLevel',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'agent_run',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'target', 'model'],
                  },
                ],
              },
              AgentScheduledTarget: {
                description:
                  'Exact observed source boundary. This data is checked against the original\nSession; passing it never grants execution by itself.',
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  workspace: {
                    $ref: '#/$defs/AgentWorkspace',
                  },
                  permissions: {
                    $ref: '#/$defs/AgentWorkspacePermissions',
                  },
                  boundaryRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['sessionId', 'workspace', 'permissions', 'boundaryRevision'],
              },
              AgentWorkspace: {
                type: 'object',
                properties: {
                  worktree: {
                    description:
                      'Native owner allocation; never accepted from a caller as workspace authority.',
                    anyOf: [
                      {
                        $ref: '#/$defs/Binding',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  projectId: {
                    description: "Optional membership in this Agent's canonical Project catalog.",
                    type: ['string', 'null'],
                    format: 'uuid',
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  identity: {
                    type: 'string',
                    pattern: '^workspace:v1:[A-Fa-f0-9-]{36}$',
                  },
                },
                additionalProperties: false,
                required: ['path', 'directoryIdentity', 'identity'],
              },
              Binding: {
                description: 'Immutable allocation intent, not the current child branch or HEAD.',
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  common_dir: {
                    type: 'string',
                  },
                  source: {
                    type: 'string',
                  },
                  source_identity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  base_commit: {
                    type: 'string',
                  },
                  directory: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: [
                  'id',
                  'common_dir',
                  'source',
                  'source_identity',
                  'base_commit',
                  'directory',
                ],
              },
              AgentWorkspacePermissions: {
                type: 'object',
                properties: {
                  access: {
                    $ref: '#/$defs/AgentWorkspaceAccess',
                  },
                  requestPermissions: {
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: ['access', 'requestPermissions'],
              },
              AgentWorkspaceAccess: {
                description:
                  'Session sandbox policy. Full access explicitly disables filesystem and process isolation.',
                type: 'string',
                enum: ['read_only', 'workspace_write', 'danger_full_access'],
              },
              ModelSelection: {
                description:
                  'Exact public selection observed by a caller, checked once at run admission.',
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                    minLength: 1,
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  modelId: {
                    type: 'string',
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'revision', 'modelId'],
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
              Misfire: {
                type: 'string',
                enum: ['skip', 'latest'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentScheduleResult',
            oneOf: [
              {
                type: 'object',
                properties: {
                  taskId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'committed',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'taskId', 'revision'],
              },
              {
                type: 'object',
                properties: {
                  actual: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'conflict',
                  },
                },
                additionalProperties: false,
                required: ['kind'],
              },
              {
                type: 'object',
                properties: {
                  reason: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'reason'],
              },
            ],
          },
          resources: {},
        },
        scheduleAlerts: {
          mode: 'subscription',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentScheduleAlertsRead',
            type: 'object',
            additionalProperties: false,
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentScheduleAlerts',
            type: 'object',
            properties: {
              pending: {
                type: 'integer',
                format: 'uint32',
                minimum: 0,
              },
              reminders: {
                type: 'array',
                items: {
                  $ref: '#/$defs/AgentScheduledReminder',
                },
              },
            },
            additionalProperties: false,
            required: ['pending', 'reminders'],
            $defs: {
              AgentScheduledReminder: {
                type: 'object',
                properties: {
                  taskId: {
                    type: 'string',
                  },
                  fireId: {
                    type: 'string',
                  },
                  title: {
                    type: 'string',
                  },
                  body: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['taskId', 'fireId', 'title', 'body'],
              },
            },
          },
          resources: {},
        },
        schedules: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentScheduleRead',
            oneOf: [
              {
                type: 'object',
                properties: {
                  cursor: {
                    type: ['string', 'null'],
                  },
                  expectedRevision: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'list',
                  },
                },
                additionalProperties: false,
                required: ['kind'],
              },
              {
                type: 'object',
                properties: {
                  taskId: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'get',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'taskId'],
              },
              {
                type: 'object',
                properties: {
                  reference: {
                    $ref: '#/$defs/RecoveryRef',
                  },
                  kind: {
                    type: 'string',
                    const: 'receipt',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'reference'],
              },
            ],
            $defs: {
              RecoveryRef: {
                type: 'object',
                properties: {
                  source: {
                    $ref: '#/$defs/DeploymentRef',
                  },
                  namespace: {
                    $ref: '#/$defs/InstanceId',
                  },
                  export: {
                    type: 'string',
                  },
                  method: {
                    type: 'string',
                  },
                  operation: {
                    type: 'string',
                    format: 'uuid',
                  },
                  fingerprint: {
                    type: 'string',
                  },
                  contract: {
                    $ref: '#/$defs/RecoveryContract',
                  },
                  recovery: {
                    $ref: '#/$defs/RecoveryProtocol',
                  },
                },
                additionalProperties: false,
                required: [
                  'source',
                  'namespace',
                  'export',
                  'method',
                  'operation',
                  'fingerprint',
                  'contract',
                  'recovery',
                ],
              },
              DeploymentRef: {
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'revision'],
              },
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
              RecoveryContract: {
                description:
                  'Contract identity for a journal lookup. The original request retains the\ncomplete contract; a receipt carries only its digest.',
                type: 'object',
                properties: {
                  name: {
                    type: 'string',
                  },
                  version: {
                    type: 'integer',
                    format: 'uint32',
                    minimum: 0,
                  },
                  transport: {
                    $ref: '#/$defs/Transport',
                  },
                  digest: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['name', 'version', 'transport', 'digest'],
              },
              Transport: {
                type: 'string',
                enum: ['local', 'remote'],
              },
              RecoveryProtocol: {
                type: 'string',
                enum: ['journal_v1'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentSchedules',
            oneOf: [
              {
                type: 'object',
                properties: {
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  tasks: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/AgentScheduledSummary',
                    },
                  },
                  nextCursor: {
                    type: ['string', 'null'],
                  },
                  kind: {
                    type: 'string',
                    const: 'page',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'revision', 'tasks'],
              },
              {
                type: 'object',
                properties: {
                  detail: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentScheduledDetail',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  kind: {
                    type: 'string',
                    const: 'task',
                  },
                },
                additionalProperties: false,
                required: ['kind'],
              },
              {
                type: 'object',
                properties: {
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'changed',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'revision'],
              },
              {
                type: 'object',
                properties: {
                  result: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentScheduleResult',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  kind: {
                    type: 'string',
                    const: 'receipt',
                  },
                },
                additionalProperties: false,
                required: ['kind'],
              },
            ],
            $defs: {
              AgentScheduledSummary: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  title: {
                    type: 'string',
                  },
                  status: {
                    $ref: '#/$defs/Status',
                  },
                  approved: {
                    type: 'boolean',
                  },
                  nextFireAt: {
                    type: ['integer', 'null'],
                    format: 'int64',
                  },
                  pendingFire: {
                    type: ['string', 'null'],
                  },
                  reminder: {
                    type: 'boolean',
                  },
                  lastError: {
                    type: ['string', 'null'],
                  },
                },
                additionalProperties: false,
                required: ['id', 'revision', 'title', 'status', 'approved', 'reminder'],
              },
              Status: {
                type: 'string',
                enum: ['active', 'paused', 'completed', 'expired'],
              },
              AgentScheduledDetail: {
                type: 'object',
                properties: {
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  task: {
                    $ref: '#/$defs/Task',
                  },
                  timezone: {
                    type: 'string',
                  },
                  misfire: {
                    $ref: '#/$defs/Misfire',
                  },
                  approved: {
                    type: 'boolean',
                  },
                  pendingFire: {
                    type: ['string', 'null'],
                  },
                },
                additionalProperties: false,
                required: ['revision', 'task', 'timezone', 'misfire', 'approved'],
              },
              Task: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  title: {
                    type: 'string',
                  },
                  intent: {
                    $ref: '#/$defs/Intent',
                  },
                  schedule: {
                    $ref: '#/$defs/Schedule',
                  },
                  effect: {
                    $ref: '#/$defs/AgentScheduledEffect',
                  },
                  status: {
                    $ref: '#/$defs/Status',
                  },
                  nextFireAt: {
                    type: ['integer', 'null'],
                    format: 'int64',
                  },
                  lastFireAt: {
                    type: ['integer', 'null'],
                    format: 'int64',
                  },
                  fireCount: {
                    type: 'integer',
                    format: 'uint32',
                    minimum: 0,
                  },
                  maxFires: {
                    type: ['integer', 'null'],
                    format: 'uint32',
                    minimum: 0,
                  },
                  expiresAt: {
                    type: ['integer', 'null'],
                    format: 'int64',
                  },
                  createdBy: {
                    $ref: '#/$defs/Creator',
                  },
                  createdAt: {
                    type: 'integer',
                    format: 'int64',
                  },
                  updatedAt: {
                    type: 'integer',
                    format: 'int64',
                  },
                  runs: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/Run',
                    },
                  },
                  lastError: {
                    type: ['string', 'null'],
                  },
                },
                additionalProperties: false,
                required: [
                  'id',
                  'title',
                  'intent',
                  'schedule',
                  'effect',
                  'status',
                  'fireCount',
                  'createdBy',
                  'createdAt',
                  'updatedAt',
                  'runs',
                ],
              },
              Intent: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      body: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'text',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'body'],
                  },
                ],
              },
              Schedule: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      runAt: {
                        type: 'integer',
                        format: 'int64',
                      },
                      kind: {
                        type: 'string',
                        const: 'once',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'runAt'],
                  },
                  {
                    type: 'object',
                    properties: {
                      everySeconds: {
                        type: 'integer',
                        format: 'uint32',
                        minimum: 0,
                      },
                      startAt: {
                        type: 'integer',
                        format: 'int64',
                      },
                      kind: {
                        type: 'string',
                        const: 'interval',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'everySeconds', 'startAt'],
                  },
                  {
                    type: 'object',
                    properties: {
                      recurrence: {
                        $ref: '#/$defs/Recurrence',
                      },
                      anchorAt: {
                        type: 'integer',
                        format: 'int64',
                      },
                      kind: {
                        type: 'string',
                        const: 'calendar',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'recurrence', 'anchorAt'],
                  },
                  {
                    type: 'object',
                    properties: {
                      expression: {
                        type: 'string',
                      },
                      startAt: {
                        type: 'integer',
                        format: 'int64',
                      },
                      kind: {
                        type: 'string',
                        const: 'cron',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'expression', 'startAt'],
                  },
                ],
              },
              Recurrence: {
                type: 'string',
                enum: ['daily', 'weekly', 'monthly'],
              },
              AgentScheduledEffect: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'reminder',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      target: {
                        $ref: '#/$defs/AgentScheduledTarget',
                      },
                      model: {
                        $ref: '#/$defs/ModelSelection',
                      },
                      thinkingLevel: {
                        anyOf: [
                          {
                            $ref: '#/$defs/ThinkingLevel',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'session',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'target', 'model'],
                  },
                  {
                    type: 'object',
                    properties: {
                      target: {
                        $ref: '#/$defs/AgentScheduledTarget',
                      },
                      model: {
                        $ref: '#/$defs/ModelSelection',
                      },
                      thinkingLevel: {
                        anyOf: [
                          {
                            $ref: '#/$defs/ThinkingLevel',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'agent_run',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'target', 'model'],
                  },
                ],
              },
              AgentScheduledTarget: {
                description:
                  'Exact observed source boundary. This data is checked against the original\nSession; passing it never grants execution by itself.',
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  workspace: {
                    $ref: '#/$defs/AgentWorkspace',
                  },
                  permissions: {
                    $ref: '#/$defs/AgentWorkspacePermissions',
                  },
                  boundaryRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['sessionId', 'workspace', 'permissions', 'boundaryRevision'],
              },
              AgentWorkspace: {
                type: 'object',
                properties: {
                  worktree: {
                    description:
                      'Native owner allocation; never accepted from a caller as workspace authority.',
                    anyOf: [
                      {
                        $ref: '#/$defs/Binding',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  projectId: {
                    description: "Optional membership in this Agent's canonical Project catalog.",
                    type: ['string', 'null'],
                    format: 'uuid',
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  identity: {
                    type: 'string',
                    pattern: '^workspace:v1:[A-Fa-f0-9-]{36}$',
                  },
                },
                additionalProperties: false,
                required: ['path', 'directoryIdentity', 'identity'],
              },
              Binding: {
                description: 'Immutable allocation intent, not the current child branch or HEAD.',
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  common_dir: {
                    type: 'string',
                  },
                  source: {
                    type: 'string',
                  },
                  source_identity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  base_commit: {
                    type: 'string',
                  },
                  directory: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: [
                  'id',
                  'common_dir',
                  'source',
                  'source_identity',
                  'base_commit',
                  'directory',
                ],
              },
              AgentWorkspacePermissions: {
                type: 'object',
                properties: {
                  access: {
                    $ref: '#/$defs/AgentWorkspaceAccess',
                  },
                  requestPermissions: {
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: ['access', 'requestPermissions'],
              },
              AgentWorkspaceAccess: {
                description:
                  'Session sandbox policy. Full access explicitly disables filesystem and process isolation.',
                type: 'string',
                enum: ['read_only', 'workspace_write', 'danger_full_access'],
              },
              ModelSelection: {
                description:
                  'Exact public selection observed by a caller, checked once at run admission.',
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                    minLength: 1,
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  modelId: {
                    type: 'string',
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'revision', 'modelId'],
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
              Creator: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'user',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      sessionId: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'agent',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'sessionId'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'system',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                ],
              },
              Run: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  at: {
                    type: 'integer',
                    format: 'int64',
                  },
                  outcome: {
                    $ref: '#/$defs/Outcome',
                  },
                  message: {
                    type: 'string',
                  },
                  sessionId: {
                    type: ['string', 'null'],
                  },
                  runId: {
                    type: ['string', 'null'],
                  },
                },
                additionalProperties: false,
                required: ['id', 'at', 'outcome', 'message'],
              },
              Outcome: {
                type: 'string',
                enum: ['ok', 'failed', 'blocked'],
              },
              Misfire: {
                type: 'string',
                enum: ['skip', 'latest'],
              },
              AgentScheduleResult: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      taskId: {
                        type: 'string',
                      },
                      revision: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'committed',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'taskId', 'revision'],
                  },
                  {
                    type: 'object',
                    properties: {
                      actual: {
                        type: ['integer', 'null'],
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'conflict',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind'],
                  },
                  {
                    type: 'object',
                    properties: {
                      reason: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'rejected',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'reason'],
                  },
                ],
              },
            },
          },
          resources: {},
        },
        search: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentHistorySearch',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
              through: {
                description: 'Original raw-event fence, shared with history reads.',
                type: 'integer',
                format: 'uint64',
                minimum: 0,
                maximum: 9007199254740991,
              },
              after: {
                description: 'Exclusive transcript-row position; null starts a scan.',
                anyOf: [
                  {
                    $ref: '#/$defs/HistoryRowPosition',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              query: {
                description: 'Literal query; no normalization.',
                type: 'string',
                minLength: 1,
              },
              caseSensitive: {
                description:
                  'False uses Unicode simple case folding, without locale or multi-character folding.',
                type: 'boolean',
              },
              wholeWord: {
                description:
                  'Require no adjacent Unicode word character (Alphabetic, marks, decimal\ndigits, connector punctuation or join controls); not dictionary segmentation.',
                type: 'boolean',
              },
              includeInternal: {
                type: 'boolean',
              },
            },
            additionalProperties: false,
            required: [
              'sessionId',
              'through',
              'query',
              'caseSensitive',
              'wholeWord',
              'includeInternal',
            ],
            $defs: {
              HistoryRowPosition: {
                description:
                  'Disposable presentation locator, never authority or a canonical execution fact.\nThe source is the original emitting fact; the index precedes UI filtering.',
                type: 'object',
                properties: {
                  sourceSequence: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  itemIndex: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                },
                additionalProperties: false,
                required: ['sourceSequence', 'itemIndex'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentHistorySearchPage',
            oneOf: [
              {
                type: 'object',
                properties: {
                  through: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  matches: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/AgentHistoryMatch',
                    },
                    maxItems: 16,
                  },
                  nextAfter: {
                    description:
                      'Continue even when this batch has no matches. Null is the end of the scan.',
                    anyOf: [
                      {
                        $ref: '#/$defs/HistoryRowPosition',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  kind: {
                    type: 'string',
                    const: 'ready',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'through', 'matches', 'nextAfter'],
              },
            ],
            $defs: {
              AgentHistoryMatch: {
                type: 'object',
                properties: {
                  field: {
                    description:
                      'Exact canonical field to read through the source query; history body may omit it.',
                    $ref: '#/$defs/SourceField',
                  },
                  position: {
                    description:
                      'Exact transcript row. Open with HistoryPosition::Row at the same raw-event\nfence: Thinking for a thinking match, Body for every other source field.',
                    $ref: '#/$defs/HistoryRowPosition',
                  },
                  preview: {
                    type: 'string',
                    maxLength: 384,
                  },
                },
                additionalProperties: false,
                required: ['field', 'position', 'preview'],
              },
              SourceField: {
                description:
                  'An explicitly selected canonical transcript field, never an execution grant.',
                oneOf: [
                  {
                    type: 'string',
                    enum: [
                      'body',
                      'thinking',
                      'tool_name',
                      'failure_message',
                      'error_class',
                      'arguments',
                      'result',
                    ],
                  },
                  {
                    description:
                      'The original service operation observation, separate from its returned value.',
                    type: 'string',
                    const: 'receipt',
                  },
                ],
              },
              HistoryRowPosition: {
                description:
                  'Disposable presentation locator, never authority or a canonical execution fact.\nThe source is the original emitting fact; the index precedes UI filtering.',
                type: 'object',
                properties: {
                  sourceSequence: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  itemIndex: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                },
                additionalProperties: false,
                required: ['sourceSequence', 'itemIndex'],
              },
            },
          },
          resources: {},
        },
        selectBackend: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentSelectBackend',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
              },
              backend: {
                $ref: '#/$defs/AgentBackendPreference',
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'backend'],
            $defs: {
              AgentBackendPreference: {
                description:
                  "The next turn's choice, independent of an already admitted execution.\nModel revisions are resolved afresh; preferences never grant execution authority.",
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      connectionId: {
                        type: 'string',
                        minLength: 1,
                      },
                      modelId: {
                        type: 'string',
                        minLength: 1,
                      },
                      thinkingLevel: {
                        anyOf: [
                          {
                            $ref: '#/$defs/ThinkingLevel',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'model',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'connectionId', 'modelId'],
                  },
                  {
                    type: 'object',
                    properties: {
                      selection: {
                        $ref: '#/$defs/AgentExecutorSelection',
                      },
                      kind: {
                        type: 'string',
                        const: 'executor',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'selection'],
                  },
                ],
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
              AgentExecutorSelection: {
                type: 'object',
                properties: {
                  executor: {
                    type: 'string',
                    minLength: 1,
                  },
                  settings: {
                    $ref: '#/$defs/ExecutorSettings',
                  },
                },
                additionalProperties: false,
                required: ['executor', 'settings'],
              },
              ExecutorSettings: {
                description:
                  'Executor-owned model selection, independent of Host model connections.',
                type: 'object',
                properties: {
                  model: {
                    type: ['string', 'null'],
                  },
                  thinkingLevel: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ThinkingLevel',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentMetadataResult',
            oneOf: [
              {
                type: 'object',
                properties: {
                  session: {
                    $ref: '#/$defs/AgentSession',
                  },
                  kind: {
                    type: 'string',
                    const: 'committed',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'session'],
              },
              {
                type: 'object',
                properties: {
                  expected: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  actual: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'revision_conflict',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'expected', 'actual'],
              },
              {
                type: 'object',
                properties: {
                  reason: {
                    $ref: '#/$defs/AgentRejection',
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'reason'],
              },
            ],
            $defs: {
              AgentSession: {
                type: 'object',
                properties: {
                  branch: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentSessionBranch',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  backend: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentBackendPreference',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  collaborationMode: {
                    $ref: '#/$defs/CollaborationMode',
                    default: 'agent',
                  },
                  tools: {
                    type: ['array', 'null'],
                    items: {
                      type: 'string',
                    },
                  },
                  dataSource: {
                    $ref: '#/$defs/AgentDataSource',
                  },
                  permissions: {
                    $ref: '#/$defs/AgentWorkspacePermissions',
                  },
                  boundaryRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  id: {
                    type: 'string',
                  },
                  title: {
                    type: 'string',
                  },
                  labels: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  workspace: {
                    $ref: '#/$defs/AgentWorkspace',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  updatedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  archived: {
                    type: 'boolean',
                  },
                  hasUnread: {
                    type: 'boolean',
                  },
                  activity: {
                    $ref: '#/$defs/AgentSessionActivity',
                  },
                },
                additionalProperties: false,
                required: [
                  'branch',
                  'dataSource',
                  'permissions',
                  'boundaryRevision',
                  'id',
                  'title',
                  'labels',
                  'workspace',
                  'revision',
                  'updatedAt',
                  'archived',
                  'hasUnread',
                  'activity',
                ],
              },
              AgentSessionBranch: {
                description:
                  'Frozen conversation ancestry for presentation, not authority over the source.',
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                    minLength: 1,
                  },
                  turnId: {
                    type: ['string', 'null'],
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['sessionId', 'turnId'],
              },
              AgentBackendPreference: {
                description:
                  "The next turn's choice, independent of an already admitted execution.\nModel revisions are resolved afresh; preferences never grant execution authority.",
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      connectionId: {
                        type: 'string',
                        minLength: 1,
                      },
                      modelId: {
                        type: 'string',
                        minLength: 1,
                      },
                      thinkingLevel: {
                        anyOf: [
                          {
                            $ref: '#/$defs/ThinkingLevel',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'model',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'connectionId', 'modelId'],
                  },
                  {
                    type: 'object',
                    properties: {
                      selection: {
                        $ref: '#/$defs/AgentExecutorSelection',
                      },
                      kind: {
                        type: 'string',
                        const: 'executor',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'selection'],
                  },
                ],
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
              AgentExecutorSelection: {
                type: 'object',
                properties: {
                  executor: {
                    type: 'string',
                    minLength: 1,
                  },
                  settings: {
                    $ref: '#/$defs/ExecutorSettings',
                  },
                },
                additionalProperties: false,
                required: ['executor', 'settings'],
              },
              ExecutorSettings: {
                description:
                  'Executor-owned model selection, independent of Host model connections.',
                type: 'object',
                properties: {
                  model: {
                    type: ['string', 'null'],
                  },
                  thinkingLevel: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ThinkingLevel',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
              },
              CollaborationMode: {
                type: 'string',
                enum: ['agent', 'plan'],
              },
              AgentDataSource: {
                description:
                  'Stable business-data origin, independent of package or activation revisions.',
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  namespace: {
                    $ref: '#/$defs/InstanceId',
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'namespace'],
              },
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
              AgentWorkspacePermissions: {
                type: 'object',
                properties: {
                  access: {
                    $ref: '#/$defs/AgentWorkspaceAccess',
                  },
                  requestPermissions: {
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: ['access', 'requestPermissions'],
              },
              AgentWorkspaceAccess: {
                description:
                  'Session sandbox policy. Full access explicitly disables filesystem and process isolation.',
                type: 'string',
                enum: ['read_only', 'workspace_write', 'danger_full_access'],
              },
              AgentWorkspace: {
                type: 'object',
                properties: {
                  worktree: {
                    description:
                      'Native owner allocation; never accepted from a caller as workspace authority.',
                    anyOf: [
                      {
                        $ref: '#/$defs/Binding',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  projectId: {
                    description: "Optional membership in this Agent's canonical Project catalog.",
                    type: ['string', 'null'],
                    format: 'uuid',
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  identity: {
                    type: 'string',
                    pattern: '^workspace:v1:[A-Fa-f0-9-]{36}$',
                  },
                },
                additionalProperties: false,
                required: ['path', 'directoryIdentity', 'identity'],
              },
              Binding: {
                description: 'Immutable allocation intent, not the current child branch or HEAD.',
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  common_dir: {
                    type: 'string',
                  },
                  source: {
                    type: 'string',
                  },
                  source_identity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  base_commit: {
                    type: 'string',
                  },
                  directory: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: [
                  'id',
                  'common_dir',
                  'source',
                  'source_identity',
                  'base_commit',
                  'directory',
                ],
              },
              AgentSessionActivity: {
                type: 'string',
                enum: ['idle', 'working', 'waiting'],
              },
              AgentRejection: {
                type: 'string',
                enum: [
                  'title_invalid',
                  'labels_invalid',
                  'tools_unavailable',
                  'busy',
                  'workspace_unavailable',
                  'session_unavailable',
                  'history_unavailable',
                  'managed_session',
                  'closed',
                ],
              },
            },
          },
          resources: {},
        },
        send: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentSend',
            type: 'object',
            properties: {
              attachments: {
                description:
                  'IDs of immutable user uploads in this Session; metadata is resolved by the owner.',
                type: 'array',
                items: {
                  type: 'string',
                },
                default: [],
              },
              model: {
                $ref: '#/$defs/ModelSelection',
              },
              thinkingLevel: {
                description: 'Omission/null uses the configured model default; `off` is explicit.',
                anyOf: [
                  {
                    $ref: '#/$defs/ThinkingLevel',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              sessionId: {
                type: 'string',
                minLength: 1,
              },
              message: {
                type: 'string',
              },
            },
            additionalProperties: false,
            required: ['model', 'sessionId', 'message'],
            $defs: {
              ModelSelection: {
                description:
                  'Exact public selection observed by a caller, checked once at run admission.',
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                    minLength: 1,
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  modelId: {
                    type: 'string',
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'revision', 'modelId'],
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentSendResult',
            oneOf: [
              {
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  reason: {
                    $ref: '#/$defs/AgentSkillInputRejection',
                  },
                  skills: {
                    anyOf: [
                      {
                        $ref: '#/$defs/SkillInvocationResult',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'sessionId', 'reason'],
              },
              {
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  invocationId: {
                    type: 'string',
                  },
                  messageId: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'started',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'sessionId', 'invocationId', 'messageId'],
              },
              {
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  messageId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'queued',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'sessionId', 'messageId', 'revision'],
              },
            ],
            $defs: {
              AgentSkillInputRejection: {
                type: 'string',
                enum: ['skills_unavailable'],
              },
              SkillInvocationResult: {
                type: 'object',
                properties: {
                  loaded: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/LoadedSkill',
                    },
                  },
                  failed: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/SkillInvocationFailure',
                    },
                  },
                  receipts: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/SkillInvocationReceipt',
                    },
                  },
                },
                additionalProperties: false,
                required: ['loaded', 'failed', 'receipts'],
              },
              LoadedSkill: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  name: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['id', 'name'],
              },
              SkillInvocationFailure: {
                anyOf: [
                  {
                    $ref: '#/$defs/SkillRequestFailure',
                  },
                ],
              },
              SkillRequestFailure: {
                type: 'object',
                properties: {
                  request: {
                    type: 'string',
                  },
                  reason: {
                    $ref: '#/$defs/SkillFailureReason',
                  },
                },
                additionalProperties: false,
                required: ['request', 'reason'],
              },
              SkillFailureReason: {
                type: 'string',
                enum: [
                  'invalid_name',
                  'not_found',
                  'disabled',
                  'host_incompatible',
                  'resolution_failed',
                ],
              },
              SkillInvocationReceipt: {
                description:
                  'Boolean wire discriminants are validated here, not retained as mutable\nbusiness fields beside a contradictory enum variant.',
                anyOf: [
                  {
                    type: 'object',
                    properties: {
                      invocation: {
                        $ref: '#/$defs/SkillInvocationMode',
                      },
                      request: {
                        type: 'string',
                      },
                      success: {
                        const: true,
                      },
                      ref: {
                        type: 'string',
                      },
                      id: {
                        type: 'string',
                      },
                      name: {
                        type: 'string',
                      },
                      scope: {
                        $ref: '#/$defs/SkillScope',
                      },
                      source: {
                        $ref: '#/$defs/SkillSource',
                      },
                      truncated: {
                        type: 'boolean',
                      },
                    },
                    additionalProperties: false,
                    required: [
                      'invocation',
                      'request',
                      'success',
                      'ref',
                      'id',
                      'name',
                      'scope',
                      'source',
                      'truncated',
                    ],
                  },
                  {
                    type: 'object',
                    properties: {
                      invocation: {
                        $ref: '#/$defs/SkillInvocationMode',
                      },
                      request: {
                        type: 'string',
                      },
                      success: {
                        const: false,
                      },
                      reason: {
                        $ref: '#/$defs/SkillFailureReason',
                      },
                    },
                    additionalProperties: false,
                    required: ['invocation', 'request', 'success', 'reason'],
                  },
                ],
              },
              SkillInvocationMode: {
                type: 'string',
                enum: ['explicit', 'model_tool'],
              },
              SkillScope: {
                type: 'string',
                enum: ['project', 'workspace', 'user', 'custom'],
              },
              SkillSource: {
                type: 'string',
                enum: ['maka', 'agents', 'legacy', 'custom'],
              },
            },
          },
          resources: {},
        },
        skillCandidates: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentSkillCandidatesRead',
            description:
              "Read-only suggestions resolved against the session's actual skill context.",
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
              },
              backend: {
                $ref: '#/$defs/AgentSkillCandidatesBackend',
              },
              query: {
                type: 'string',
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'backend', 'query'],
            $defs: {
              AgentSkillCandidatesBackend: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      model: {
                        $ref: '#/$defs/ModelSelection',
                      },
                      thinkingLevel: {
                        anyOf: [
                          {
                            $ref: '#/$defs/ThinkingLevel',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'model',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'model'],
                  },
                  {
                    type: 'object',
                    properties: {
                      selection: {
                        $ref: '#/$defs/AgentExecutorSelection',
                      },
                      kind: {
                        type: 'string',
                        const: 'executor',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'selection'],
                  },
                ],
              },
              ModelSelection: {
                description:
                  'Exact public selection observed by a caller, checked once at run admission.',
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                    minLength: 1,
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  modelId: {
                    type: 'string',
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'revision', 'modelId'],
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
              AgentExecutorSelection: {
                type: 'object',
                properties: {
                  executor: {
                    type: 'string',
                    minLength: 1,
                  },
                  settings: {
                    $ref: '#/$defs/ExecutorSettings',
                  },
                },
                additionalProperties: false,
                required: ['executor', 'settings'],
              },
              ExecutorSettings: {
                description:
                  'Executor-owned model selection, independent of Host model connections.',
                type: 'object',
                properties: {
                  model: {
                    type: ['string', 'null'],
                  },
                  thinkingLevel: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ThinkingLevel',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentSkillCandidates',
            type: 'object',
            properties: {
              revision: {
                type: ['string', 'null'],
              },
              skills: {
                type: 'array',
                items: {
                  $ref: '#/$defs/AgentSkillCandidate',
                },
              },
            },
            required: ['skills'],
            $defs: {
              AgentSkillCandidate: {
                type: 'object',
                properties: {
                  reference: {
                    type: 'string',
                  },
                  name: {
                    type: 'string',
                  },
                  description: {
                    type: 'string',
                  },
                  invocation: {
                    type: 'string',
                  },
                },
                required: ['reference', 'name', 'description', 'invocation'],
              },
            },
          },
          resources: {},
        },
        snapshotPatch: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentExecutionRead',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
              invocationId: {
                type: 'string',
                minLength: 1,
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'invocationId'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentPatchResult',
            oneOf: [
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'unavailable',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'busy',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'changed',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  patch: {
                    $ref: '#/$defs/AgentWorkspacePatch',
                  },
                  kind: {
                    type: 'string',
                    const: 'ready',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'patch'],
              },
            ],
            $defs: {
              AgentWorkspacePatch: {
                type: 'object',
                properties: {
                  artifactId: {
                    type: 'string',
                  },
                  sessionId: {
                    type: 'string',
                  },
                  turnId: {
                    type: 'string',
                  },
                  baseCommit: {
                    type: 'string',
                  },
                  bytes: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['artifactId', 'sessionId', 'turnId', 'baseCommit', 'bytes'],
              },
            },
          },
          resources: {},
        },
        source: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentHistorySourceRead',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
              through: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
                maximum: 9007199254740991,
              },
              source: {
                $ref: '#/$defs/AgentHistorySourceReference',
              },
              field: {
                $ref: '#/$defs/SourceField',
              },
              path: {
                description:
                  'Optional JSON keys/array indices within arguments, result or receipt.',
                type: ['array', 'null'],
                items: {
                  $ref: '#/$defs/HistorySourceSegment',
                },
                default: null,
              },
              position: {
                $ref: '#/$defs/SourcePosition',
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'through', 'source', 'field', 'position'],
            $defs: {
              AgentHistorySourceReference: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      position: {
                        $ref: '#/$defs/HistoryRowPosition',
                      },
                      kind: {
                        type: 'string',
                        const: 'row',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'position'],
                  },
                  {
                    type: 'object',
                    properties: {
                      toolUseId: {
                        type: 'string',
                        minLength: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'tool_use',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'toolUseId'],
                  },
                ],
              },
              HistoryRowPosition: {
                description:
                  'Disposable presentation locator, never authority or a canonical execution fact.\nThe source is the original emitting fact; the index precedes UI filtering.',
                type: 'object',
                properties: {
                  sourceSequence: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  itemIndex: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                },
                additionalProperties: false,
                required: ['sourceSequence', 'itemIndex'],
              },
              SourceField: {
                description:
                  'An explicitly selected canonical transcript field, never an execution grant.',
                oneOf: [
                  {
                    type: 'string',
                    enum: [
                      'body',
                      'thinking',
                      'tool_name',
                      'failure_message',
                      'error_class',
                      'arguments',
                      'result',
                    ],
                  },
                  {
                    description:
                      'The original service operation observation, separate from its returned value.',
                    type: 'string',
                    const: 'receipt',
                  },
                ],
              },
              HistorySourceSegment: {
                description:
                  'A structural selector into an original JSON field. Keys and array indices\nremain distinct; neither locates a filesystem resource nor grants access.',
                anyOf: [
                  {
                    type: 'string',
                  },
                  {
                    type: 'integer',
                    format: 'uint32',
                    minimum: 0,
                  },
                ],
              },
              SourcePosition: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'start',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'tail',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      offset: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                        maximum: 9007199254740991,
                      },
                      kind: {
                        type: 'string',
                        const: 'before',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'offset'],
                  },
                  {
                    type: 'object',
                    properties: {
                      offset: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                        maximum: 9007199254740991,
                      },
                      kind: {
                        type: 'string',
                        const: 'after',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'offset'],
                  },
                ],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentHistorySourcePage',
            oneOf: [
              {
                type: 'object',
                properties: {
                  through: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  source: {
                    $ref: '#/$defs/HistorySource',
                  },
                  filePath: {
                    description:
                      'Complete file-path evidence resolved on the Host for copying only.\nThis is display text, never a filesystem capability or open command.',
                    type: ['string', 'null'],
                  },
                  kind: {
                    type: 'string',
                    const: 'ready',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'through', 'source'],
              },
            ],
            $defs: {
              HistorySource: {
                description:
                  'One literal UTF-8 excerpt of an immutable field. JSON excerpts need not be\nstandalone JSON. Image descriptors carry no artifact read authorization.',
                type: 'object',
                properties: {
                  model: {
                    anyOf: [
                      {
                        $ref: '#/$defs/HistoryModel',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  origin: {
                    anyOf: [
                      {
                        $ref: '#/$defs/MessageOrigin',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  position: {
                    $ref: '#/$defs/HistoryRowPosition',
                  },
                  timestamp: {
                    description:
                      'Host-recorded milliseconds of this immutable row; not a client clock.',
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                  role: {
                    $ref: '#/$defs/HistorySourceRole',
                  },
                  fields: {
                    description:
                      'Readable canonical fields of this same immutable row, in display order.',
                    type: 'array',
                    items: {
                      $ref: '#/$defs/SourceField',
                    },
                    minItems: 1,
                    maxItems: 7,
                  },
                  field: {
                    $ref: '#/$defs/SourceField',
                  },
                  path: {
                    description:
                      'Omission reads the encoded field. A selected JSON string is literal text.',
                    type: ['array', 'null'],
                    items: {
                      $ref: '#/$defs/HistorySourceSegment',
                    },
                  },
                  format: {
                    $ref: '#/$defs/SourceFormat',
                  },
                  offset: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                  totalBytes: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                  text: {
                    type: 'string',
                  },
                  tool: {
                    anyOf: [
                      {
                        $ref: '#/$defs/HistoryTool',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
                required: [
                  'position',
                  'timestamp',
                  'role',
                  'fields',
                  'field',
                  'format',
                  'offset',
                  'totalBytes',
                  'text',
                  'tool',
                ],
              },
              HistoryModel: {
                description: 'Model identity recorded for the exact historical assistant step.',
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      requestedModelId: {
                        type: 'string',
                      },
                      reportedModelId: {
                        type: ['string', 'null'],
                      },
                      kind: {
                        type: 'string',
                        const: 'native',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'requestedModelId', 'reportedModelId'],
                  },
                  {
                    type: 'object',
                    properties: {
                      modelId: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'imported',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'modelId'],
                  },
                ],
              },
              MessageOrigin: {
                description:
                  'Trusted producer attribution, preserved independently of editable content.',
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      taskId: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'workhub_task',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'taskId'],
                  },
                  {
                    type: 'object',
                    properties: {
                      graphId: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'workhub_graph',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'graphId'],
                  },
                ],
              },
              HistoryRowPosition: {
                description:
                  'Disposable presentation locator, never authority or a canonical execution fact.\nThe source is the original emitting fact; the index precedes UI filtering.',
                type: 'object',
                properties: {
                  sourceSequence: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  itemIndex: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                },
                additionalProperties: false,
                required: ['sourceSequence', 'itemIndex'],
              },
              HistorySourceRole: {
                description:
                  'Presentation role of the exact row. This carries no execution authority.',
                type: 'string',
                enum: ['user', 'assistant', 'tool_call', 'tool_result', 'failure'],
              },
              SourceField: {
                description:
                  'An explicitly selected canonical transcript field, never an execution grant.',
                oneOf: [
                  {
                    type: 'string',
                    enum: [
                      'body',
                      'thinking',
                      'tool_name',
                      'failure_message',
                      'error_class',
                      'arguments',
                      'result',
                    ],
                  },
                  {
                    description:
                      'The original service operation observation, separate from its returned value.',
                    type: 'string',
                    const: 'receipt',
                  },
                ],
              },
              HistorySourceSegment: {
                description:
                  'A structural selector into an original JSON field. Keys and array indices\nremain distinct; neither locates a filesystem resource nor grants access.',
                anyOf: [
                  {
                    type: 'string',
                  },
                  {
                    type: 'integer',
                    format: 'uint32',
                    minimum: 0,
                  },
                ],
              },
              SourceFormat: {
                type: 'string',
                enum: ['text', 'json', 'image_descriptor'],
              },
              HistoryTool: {
                description:
                  'Canonical references at the requested fence, never execution authority.\nBoth references are present only for a unique same-Turn call/result pair\nwith matching origin and parentage. An unpaired row retains its own reference.',
                type: 'object',
                properties: {
                  toolUseId: {
                    type: 'string',
                  },
                  call: {
                    anyOf: [
                      {
                        $ref: '#/$defs/HistoryToolCall',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  result: {
                    anyOf: [
                      {
                        $ref: '#/$defs/HistoryToolResult',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
                required: ['toolUseId', 'call', 'result'],
              },
              HistoryToolCall: {
                type: 'object',
                properties: {
                  ancestorToolUseIds: {
                    description:
                      'Recorded ancestors in this Turn, nearest first; display references only.',
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  presentation: {
                    description:
                      'Opaque display contract captured at dispatch; no execution authority.',
                    type: ['string', 'null'],
                    default: null,
                  },
                  position: {
                    $ref: '#/$defs/HistoryRowPosition',
                  },
                  name: {
                    type: 'string',
                  },
                  title: {
                    anyOf: [
                      {
                        $ref: '#/$defs/DisplayText',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  pending: {
                    description:
                      'This native Turn is still open at the history fence; not execution authority.',
                    type: 'boolean',
                  },
                  dispatched: {
                    description:
                      'A unique original Host dispatch is recorded at this fence; not liveness.',
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: [
                  'ancestorToolUseIds',
                  'position',
                  'name',
                  'title',
                  'pending',
                  'dispatched',
                ],
              },
              DisplayText: {
                description:
                  'Presentation text is distinct from the stable identity used for navigation.',
                type: 'object',
                properties: {
                  fallback: {
                    type: 'string',
                  },
                  translations: {
                    type: 'object',
                    additionalProperties: {
                      type: 'string',
                    },
                    default: {},
                  },
                },
                additionalProperties: false,
                required: ['fallback'],
              },
              HistoryToolResult: {
                type: 'object',
                properties: {
                  settlement: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ToolSettlement',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  position: {
                    $ref: '#/$defs/HistoryRowPosition',
                  },
                  isError: {
                    description: 'Does not distinguish failed from unknown effects.',
                    type: 'boolean',
                  },
                  image: {
                    description:
                      'Canonical content is an image; this does not grant artifact reads.',
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: ['settlement', 'position', 'isError', 'image'],
              },
              ToolSettlement: {
                description:
                  'Recorded Host settlement for presentation; returned is not business success.\nForeign/provider results do not establish this Host evidence.',
                type: 'string',
                enum: ['returned', 'failed', 'unknown', 'rejected'],
              },
            },
          },
          resources: {},
        },
        stop: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentStop',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
              invocationId: {
                type: 'string',
                minLength: 1,
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'invocationId'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentStopped',
            type: 'object',
            properties: {
              requested: {
                type: 'boolean',
              },
            },
            additionalProperties: false,
            required: ['requested'],
          },
          resources: {},
        },
        toolImage: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentToolImageRead',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
              through: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
                maximum: 9007199254740991,
              },
              position: {
                $ref: '#/$defs/HistoryRowPosition',
              },
              offset: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
                maximum: 9007199254740991,
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'through', 'position', 'offset'],
            $defs: {
              HistoryRowPosition: {
                description:
                  'Disposable presentation locator, never authority or a canonical execution fact.\nThe source is the original emitting fact; the index precedes UI filtering.',
                type: 'object',
                properties: {
                  sourceSequence: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  itemIndex: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                },
                additionalProperties: false,
                required: ['sourceSequence', 'itemIndex'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentToolImagePage',
            oneOf: [
              {
                type: 'object',
                properties: {
                  through: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  position: {
                    $ref: '#/$defs/HistoryRowPosition',
                  },
                  offset: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  totalBytes: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  mimeType: {
                    type: 'string',
                    pattern: '^image/(png|jpeg|gif|webp|avif)$',
                  },
                  digest: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  data: {
                    description: 'Standard padded Base64 of at most 32KiB of encoded image bytes.',
                    type: 'string',
                    maxLength: 43692,
                    pattern: '^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$',
                  },
                  kind: {
                    type: 'string',
                    const: 'ready',
                  },
                },
                additionalProperties: false,
                required: [
                  'kind',
                  'through',
                  'position',
                  'offset',
                  'totalBytes',
                  'mimeType',
                  'digest',
                  'data',
                ],
              },
            ],
            $defs: {
              HistoryRowPosition: {
                description:
                  'Disposable presentation locator, never authority or a canonical execution fact.\nThe source is the original emitting fact; the index precedes UI filtering.',
                type: 'object',
                properties: {
                  sourceSequence: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  itemIndex: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                },
                additionalProperties: false,
                required: ['sourceSequence', 'itemIndex'],
              },
            },
          },
          resources: {},
        },
        tools: {
          mode: 'query',
          input: {
            type: 'object',
            properties: {},
            additionalProperties: false,
          },
          output: {
            type: 'object',
            additionalProperties: false,
            properties: {
              names: {
                type: 'array',
                items: {
                  type: 'string',
                },
              },
            },
            required: ['names'],
            title: 'AgentToolNames',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          resources: {},
        },
        updateGlobalInstructions: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentGlobalInstructionsUpdate',
            type: 'object',
            properties: {
              source: {
                $ref: '#/$defs/AgentGlobalInstructionSource',
              },
              revision: {
                type: 'string',
              },
              content: {
                type: 'string',
              },
            },
            additionalProperties: false,
            required: ['source', 'revision', 'content'],
            $defs: {
              AgentGlobalInstructionSource: {
                type: 'string',
                enum: ['maka', 'agents'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentGlobalInstructionsUpdated',
            oneOf: [
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'saved',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'changed',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'unavailable',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
            ],
          },
          resources: {},
        },
        uploadAttachment: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentUploadAttachment',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
              name: {
                type: 'string',
                minLength: 1,
              },
              bytes: {
                type: 'integer',
                format: 'uint',
                minimum: 0,
                maximum: 9007199254740991,
              },
              digest: {
                type: 'string',
                pattern: '^sha256:[a-f0-9]{64}$',
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'name', 'bytes', 'digest'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentAttachmentUploadResult',
            oneOf: [
              {
                type: 'object',
                properties: {
                  attachment: {
                    $ref: '#/$defs/AgentAttachment',
                  },
                  kind: {
                    type: 'string',
                    const: 'uploaded',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'attachment'],
              },
              {
                type: 'object',
                properties: {
                  reason: {
                    $ref: '#/$defs/AgentAttachmentRejection',
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'reason'],
              },
            ],
            $defs: {
              AgentAttachment: {
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  id: {
                    type: 'string',
                  },
                  name: {
                    type: 'string',
                  },
                  mimeType: {
                    type: 'string',
                  },
                  bytes: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['sessionId', 'id', 'name', 'mimeType', 'bytes'],
              },
              AgentAttachmentRejection: {
                type: 'string',
                enum: ['invalid_file', 'closed', 'archived'],
              },
            },
          },
          resources: {
            file: {
              type: {
                name: 'maka.bytes',
                version: 1,
              },
              optional: false,
            },
          },
        },
        watch: {
          mode: 'subscription',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentWatch',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
              after: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
                maximum: 9007199254740991,
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'after'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentDeliveryPage',
            oneOf: [
              {
                type: 'object',
                properties: {
                  through: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  nextAfter: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  events: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/AgentDelivery',
                    },
                  },
                  kind: {
                    type: 'string',
                    const: 'events',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'through', 'nextAfter', 'events'],
              },
              {
                type: 'object',
                properties: {
                  queue: {
                    $ref: '#/$defs/AgentQueue',
                  },
                  kind: {
                    type: 'string',
                    const: 'queue',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'queue'],
              },
              {
                type: 'object',
                properties: {
                  pending: {
                    $ref: '#/$defs/AgentPendingInteractions',
                  },
                  kind: {
                    type: 'string',
                    const: 'interactions',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'pending'],
              },
            ],
            $defs: {
              AgentDelivery: {
                type: 'object',
                properties: {
                  sequence: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  invocationId: {
                    type: 'string',
                  },
                  turnId: {
                    type: 'string',
                  },
                  fact: {
                    $ref: '#/$defs/AgentDeliveryFact',
                  },
                },
                additionalProperties: false,
                required: ['sequence', 'invocationId', 'turnId', 'fact'],
              },
              AgentDeliveryFact: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'opened',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    description:
                      'Both external text streams share the original ExecutorStarted message.',
                    type: 'object',
                    properties: {
                      messageId: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'executor_started',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'messageId'],
                  },
                  {
                    description:
                      'Canonical transcript facts changed; clients query bounded history.',
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'transcript_changed',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      stepId: {
                        type: 'string',
                      },
                      completed: {
                        description:
                          'The model/executor completed; this says nothing about tool business success.',
                        type: 'boolean',
                      },
                      kind: {
                        type: 'string',
                        const: 'step_ended',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'stepId', 'completed'],
                  },
                  {
                    type: 'object',
                    properties: {
                      messageId: {
                        type: 'string',
                      },
                      stepId: {
                        type: 'string',
                      },
                      partId: {
                        type: 'string',
                      },
                      textKind: {
                        $ref: '#/$defs/AgentContentKind',
                      },
                      kind: {
                        type: 'string',
                        const: 'part_started',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'messageId', 'stepId', 'partId', 'textKind'],
                  },
                  {
                    type: 'object',
                    properties: {
                      stepId: {
                        type: 'string',
                      },
                      partId: {
                        type: 'string',
                      },
                      text: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'delta',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'stepId', 'partId', 'text'],
                  },
                  {
                    type: 'object',
                    properties: {
                      stepId: {
                        type: 'string',
                      },
                      partId: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'part_finished',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'stepId', 'partId'],
                  },
                  {
                    description:
                      'Model input observations are display-only; they cannot authorize a tool effect.',
                    type: 'object',
                    properties: {
                      toolUseId: {
                        type: 'string',
                      },
                      stepId: {
                        type: 'string',
                      },
                      name: {
                        type: 'string',
                      },
                      providerExecuted: {
                        type: 'boolean',
                      },
                      kind: {
                        type: 'string',
                        const: 'tool_input_started',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'toolUseId', 'stepId', 'name', 'providerExecuted'],
                  },
                  {
                    type: 'object',
                    properties: {
                      toolUseId: {
                        type: 'string',
                      },
                      text: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'tool_input_delta',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'toolUseId', 'text'],
                  },
                  {
                    description:
                      'Complete model input was observed, not authorization to execute it.',
                    type: 'object',
                    properties: {
                      toolUseId: {
                        type: 'string',
                      },
                      stepId: {
                        type: 'string',
                      },
                      name: {
                        type: 'string',
                      },
                      providerExecuted: {
                        type: 'boolean',
                      },
                      kind: {
                        type: 'string',
                        const: 'tool_input_ready',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'toolUseId', 'stepId', 'name', 'providerExecuted'],
                  },
                  {
                    description:
                      'Original Host admission, not a claim that the effect is currently using CPU.',
                    type: 'object',
                    properties: {
                      toolUseId: {
                        type: 'string',
                      },
                      name: {
                        type: 'string',
                      },
                      title: {
                        anyOf: [
                          {
                            $ref: '#/$defs/DisplayText',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'tool_dispatched',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'toolUseId', 'name'],
                  },
                  {
                    type: 'object',
                    properties: {
                      toolUseId: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'tool_rejected',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'toolUseId'],
                  },
                  {
                    type: 'object',
                    properties: {
                      toolUseId: {
                        type: 'string',
                      },
                      settlement: {
                        $ref: '#/$defs/ToolSettlement',
                      },
                      kind: {
                        type: 'string',
                        const: 'tool_settled',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'toolUseId', 'settlement'],
                  },
                  {
                    description:
                      'Provider-reported completion, distinct from a Host effect settlement.',
                    type: 'object',
                    properties: {
                      toolUseId: {
                        type: 'string',
                      },
                      isError: {
                        type: 'boolean',
                      },
                      kind: {
                        type: 'string',
                        const: 'provider_tool_result',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'toolUseId', 'isError'],
                  },
                  {
                    type: 'object',
                    properties: {
                      toolUseId: {
                        type: 'string',
                      },
                      name: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'executor_tool_start',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'toolUseId', 'name'],
                  },
                  {
                    type: 'object',
                    properties: {
                      toolUseId: {
                        type: 'string',
                      },
                      text: {
                        description:
                          'The most recent at most 2048 codepoints of reported progress, not the complete result.',
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'executor_tool_progress',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'toolUseId', 'text'],
                  },
                  {
                    type: 'object',
                    properties: {
                      toolUseId: {
                        type: 'string',
                      },
                      isError: {
                        type: 'boolean',
                      },
                      kind: {
                        type: 'string',
                        const: 'executor_tool_result',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'toolUseId', 'isError'],
                  },
                  {
                    type: 'object',
                    properties: {
                      failed: {
                        type: 'boolean',
                      },
                      kind: {
                        type: 'string',
                        const: 'ended',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'failed'],
                  },
                ],
              },
              AgentContentKind: {
                type: 'string',
                enum: ['text', 'thinking'],
              },
              DisplayText: {
                description:
                  'Presentation text is distinct from the stable identity used for navigation.',
                type: 'object',
                properties: {
                  fallback: {
                    type: 'string',
                  },
                  translations: {
                    type: 'object',
                    additionalProperties: {
                      type: 'string',
                    },
                    default: {},
                  },
                },
                additionalProperties: false,
                required: ['fallback'],
              },
              ToolSettlement: {
                description:
                  'Recorded Host settlement for presentation; returned is not business success.\nForeign/provider results do not establish this Host evidence.',
                type: 'string',
                enum: ['returned', 'failed', 'unknown', 'rejected'],
              },
              AgentQueue: {
                type: 'object',
                properties: {
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  entries: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/AgentQueueEntry',
                    },
                  },
                },
                additionalProperties: false,
                required: ['revision', 'entries'],
              },
              AgentQueueEntry: {
                type: 'object',
                properties: {
                  origin: {
                    anyOf: [
                      {
                        $ref: '#/$defs/MessageOrigin',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  messageId: {
                    type: 'string',
                  },
                  kind: {
                    $ref: '#/$defs/AgentQueueKind',
                  },
                  preview: {
                    type: 'string',
                    maxLength: 80,
                  },
                },
                additionalProperties: false,
                required: ['messageId', 'kind', 'preview'],
              },
              MessageOrigin: {
                description:
                  'Trusted producer attribution, preserved independently of editable content.',
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      taskId: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'workhub_task',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'taskId'],
                  },
                  {
                    type: 'object',
                    properties: {
                      graphId: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'workhub_graph',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'graphId'],
                  },
                ],
              },
              AgentQueueKind: {
                type: 'string',
                enum: ['in_flight', 'steering', 'followup'],
              },
              AgentPendingInteractions: {
                type: 'object',
                properties: {
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  entries: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/AgentInteractionSummary',
                    },
                  },
                },
                additionalProperties: false,
                required: ['revision', 'entries'],
              },
              AgentInteractionSummary: {
                type: 'object',
                properties: {
                  requestId: {
                    type: 'string',
                  },
                  kind: {
                    $ref: '#/$defs/AgentInteractionKind',
                  },
                  toolUseId: {
                    type: ['string', 'null'],
                  },
                },
                additionalProperties: false,
                required: ['requestId', 'kind', 'toolUseId'],
              },
              AgentInteractionKind: {
                type: 'string',
                enum: ['service_approval', 'question', 'permissions', 'form', 'client_capability'],
              },
            },
          },
          resources: {},
        },
        watchChecklist: {
          mode: 'subscription',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentChecklistRead',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
              },
              offset: {
                type: 'integer',
                format: 'uint',
                minimum: 0,
                default: 0,
              },
            },
            additionalProperties: false,
            required: ['sessionId'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentChecklist',
            type: 'object',
            properties: {
              enabled: {
                type: 'boolean',
              },
              revision: {
                type: ['integer', 'null'],
                format: 'uint64',
                minimum: 0,
              },
              total: {
                type: 'integer',
                format: 'uint',
                minimum: 0,
              },
              completed: {
                type: 'integer',
                format: 'uint',
                minimum: 0,
              },
              current: {
                anyOf: [
                  {
                    $ref: '#/$defs/AgentTodoItem',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              offset: {
                type: 'integer',
                format: 'uint',
                minimum: 0,
              },
              items: {
                type: 'array',
                items: {
                  $ref: '#/$defs/AgentTodoItem',
                },
                maxItems: 20,
              },
              nextOffset: {
                type: ['integer', 'null'],
                format: 'uint',
                minimum: 0,
              },
            },
            additionalProperties: false,
            required: ['enabled', 'total', 'completed', 'offset', 'items'],
            $defs: {
              AgentTodoItem: {
                type: 'object',
                properties: {
                  content: {
                    type: 'string',
                    minLength: 1,
                  },
                  status: {
                    $ref: '#/$defs/AgentTodoStatus',
                  },
                },
                additionalProperties: false,
                required: ['content', 'status'],
              },
              AgentTodoStatus: {
                type: 'string',
                enum: ['pending', 'in_progress', 'completed'],
              },
            },
          },
          resources: {},
        },
        watchDiagnostics: {
          mode: 'subscription',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentSessionRead',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
            },
            additionalProperties: false,
            required: ['sessionId'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentDiagnosticChange',
            type: 'object',
            properties: {
              revision: {
                description:
                  'Latest diagnostic event sequence, independently of transcript progress.',
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
            },
            additionalProperties: false,
            required: ['revision'],
          },
          resources: {},
        },
        watchFiles: {
          mode: 'subscription',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentFileWatch',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
              },
              path: {
                anyOf: [
                  {
                    $ref: '#/$defs/WorkspacePath',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'path'],
            $defs: {
              WorkspacePath: {
                type: 'object',
                properties: {
                  bytesBase64: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['bytesBase64'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentFileChange',
            oneOf: [
              {
                type: 'object',
                properties: {
                  directoryIdentity: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'ready',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'directoryIdentity'],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'changed',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  reason: {
                    $ref: '#/$defs/AgentFileUnavailable',
                  },
                  kind: {
                    type: 'string',
                    const: 'unavailable',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'reason'],
              },
            ],
            $defs: {
              AgentFileUnavailable: {
                type: 'string',
                enum: ['directory_changed'],
              },
            },
          },
          resources: {},
        },
        watchGoal: {
          mode: 'subscription',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentGoalRead',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
              },
            },
            additionalProperties: false,
            required: ['sessionId'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentGoalView',
            type: 'object',
            properties: {
              enabled: {
                type: 'boolean',
              },
              current: {
                anyOf: [
                  {
                    $ref: '#/$defs/AgentGoalDetail',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
            },
            additionalProperties: false,
            required: ['enabled'],
            $defs: {
              AgentGoalDetail: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  objective: {
                    type: 'string',
                  },
                  status: {
                    $ref: '#/$defs/GoalStatus',
                  },
                  iterations: {
                    type: 'integer',
                    format: 'uint32',
                    minimum: 0,
                  },
                  maxIterations: {
                    type: 'integer',
                    format: 'uint32',
                    minimum: 0,
                  },
                  tokenBudget: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  consumed: {
                    $ref: '#/$defs/GoalMeter',
                  },
                  pending: {
                    type: 'boolean',
                  },
                  report: {
                    anyOf: [
                      {
                        $ref: '#/$defs/GoalReport',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  note: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: [
                  'id',
                  'revision',
                  'objective',
                  'status',
                  'iterations',
                  'maxIterations',
                  'consumed',
                  'pending',
                  'note',
                ],
              },
              GoalStatus: {
                type: 'string',
                enum: [
                  'armed',
                  'active',
                  'paused',
                  'waiting',
                  'achieved',
                  'impossible',
                  'cancelled',
                  'cancellation_unknown',
                  'max_iterations',
                  'budget_limited',
                  'budget_unknown',
                  'blocked',
                ],
              },
              GoalMeter: {
                type: 'object',
                properties: {
                  known: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  missing: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                required: ['known', 'missing'],
              },
              GoalReport: {
                type: 'object',
                properties: {
                  status: {
                    $ref: '#/$defs/GoalReportKind',
                  },
                  note: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['status', 'note'],
              },
              GoalReportKind: {
                type: 'string',
                enum: ['progress', 'achieved', 'waiting', 'impossible'],
              },
            },
          },
          resources: {},
        },
        watchPlan: {
          mode: 'subscription',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentPlanRead',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
              },
            },
            additionalProperties: false,
            required: ['sessionId'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentPlanView',
            type: 'object',
            properties: {
              enabled: {
                type: 'boolean',
              },
              current: {
                $ref: '#/$defs/AgentPlanSnapshot',
              },
            },
            additionalProperties: false,
            required: ['enabled', 'current'],
            $defs: {
              AgentPlanSnapshot: {
                description:
                  'Public business data only; frozen execution authority remains with the owner.',
                type: 'object',
                properties: {
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  proposal: {
                    anyOf: [
                      {
                        $ref: '#/$defs/PlanProposal',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  execution: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentPlanExecution',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
                required: ['revision'],
              },
              PlanProposal: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  planId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  turnId: {
                    type: 'string',
                  },
                  artifact: {
                    $ref: '#/$defs/PlanArtifact',
                  },
                  status: {
                    $ref: '#/$defs/PlanProposalStatus',
                  },
                  supersedes: {
                    type: ['string', 'null'],
                  },
                  sourceExecutionId: {
                    type: ['string', 'null'],
                  },
                  submittedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: [
                  'id',
                  'planId',
                  'revision',
                  'turnId',
                  'artifact',
                  'status',
                  'submittedAt',
                ],
              },
              PlanArtifact: {
                type: 'object',
                properties: {
                  title: {
                    type: 'string',
                  },
                  overview: {
                    type: ['string', 'null'],
                  },
                  steps: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/PlanStep',
                    },
                    minItems: 1,
                  },
                  risks: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                    default: [],
                  },
                },
                additionalProperties: false,
                required: ['title', 'steps'],
              },
              PlanStep: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                    minLength: 1,
                    pattern: '^[A-Za-z0-9_-]+$',
                  },
                  title: {
                    type: 'string',
                    minLength: 1,
                  },
                  description: {
                    type: 'string',
                  },
                  files: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                    default: [],
                  },
                  complexity: {
                    anyOf: [
                      {
                        $ref: '#/$defs/PlanComplexity',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
                required: ['id', 'title', 'description'],
              },
              PlanComplexity: {
                type: 'string',
                enum: ['low', 'medium', 'high'],
              },
              PlanProposalStatus: {
                type: 'string',
                enum: ['pending_approval', 'revision_requested', 'abandoned', 'approved'],
              },
              AgentPlanExecution: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  proposalId: {
                    type: 'string',
                  },
                  artifact: {
                    $ref: '#/$defs/PlanArtifact',
                  },
                  steps: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/PlanProgress',
                    },
                  },
                  phase: {
                    $ref: '#/$defs/AgentPlanPhase',
                  },
                  invocation: {
                    anyOf: [
                      {
                        $ref: '#/$defs/Invocation',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  reason: {
                    type: ['string', 'null'],
                  },
                  cancellation: {
                    type: ['string', 'null'],
                  },
                  updatedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['id', 'proposalId', 'artifact', 'steps', 'phase', 'updatedAt'],
              },
              PlanProgress: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  status: {
                    $ref: '#/$defs/PlanStepStatus',
                  },
                  note: {
                    type: ['string', 'null'],
                  },
                },
                additionalProperties: false,
                required: ['id', 'status'],
              },
              PlanStepStatus: {
                type: 'string',
                enum: ['pending', 'in_progress', 'completed', 'skipped'],
              },
              AgentPlanPhase: {
                type: 'string',
                enum: ['awaiting_admission', 'active', 'interrupted', 'completed', 'cancelled'],
              },
              Invocation: {
                type: 'object',
                properties: {
                  session_id: {
                    type: 'string',
                  },
                  turn_id: {
                    type: 'string',
                  },
                  run_id: {
                    type: 'string',
                  },
                  invocation_id: {
                    type: 'string',
                  },
                },
                required: ['session_id', 'turn_id', 'run_id', 'invocation_id'],
              },
            },
          },
          resources: {},
        },
        watchSchedules: {
          mode: 'subscription',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentScheduleRead',
            oneOf: [
              {
                type: 'object',
                properties: {
                  cursor: {
                    type: ['string', 'null'],
                  },
                  expectedRevision: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'list',
                  },
                },
                additionalProperties: false,
                required: ['kind'],
              },
              {
                type: 'object',
                properties: {
                  taskId: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'get',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'taskId'],
              },
              {
                type: 'object',
                properties: {
                  reference: {
                    $ref: '#/$defs/RecoveryRef',
                  },
                  kind: {
                    type: 'string',
                    const: 'receipt',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'reference'],
              },
            ],
            $defs: {
              RecoveryRef: {
                type: 'object',
                properties: {
                  source: {
                    $ref: '#/$defs/DeploymentRef',
                  },
                  namespace: {
                    $ref: '#/$defs/InstanceId',
                  },
                  export: {
                    type: 'string',
                  },
                  method: {
                    type: 'string',
                  },
                  operation: {
                    type: 'string',
                    format: 'uuid',
                  },
                  fingerprint: {
                    type: 'string',
                  },
                  contract: {
                    $ref: '#/$defs/RecoveryContract',
                  },
                  recovery: {
                    $ref: '#/$defs/RecoveryProtocol',
                  },
                },
                additionalProperties: false,
                required: [
                  'source',
                  'namespace',
                  'export',
                  'method',
                  'operation',
                  'fingerprint',
                  'contract',
                  'recovery',
                ],
              },
              DeploymentRef: {
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'revision'],
              },
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
              RecoveryContract: {
                description:
                  'Contract identity for a journal lookup. The original request retains the\ncomplete contract; a receipt carries only its digest.',
                type: 'object',
                properties: {
                  name: {
                    type: 'string',
                  },
                  version: {
                    type: 'integer',
                    format: 'uint32',
                    minimum: 0,
                  },
                  transport: {
                    $ref: '#/$defs/Transport',
                  },
                  digest: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['name', 'version', 'transport', 'digest'],
              },
              Transport: {
                type: 'string',
                enum: ['local', 'remote'],
              },
              RecoveryProtocol: {
                type: 'string',
                enum: ['journal_v1'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentSchedules',
            oneOf: [
              {
                type: 'object',
                properties: {
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  tasks: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/AgentScheduledSummary',
                    },
                  },
                  nextCursor: {
                    type: ['string', 'null'],
                  },
                  kind: {
                    type: 'string',
                    const: 'page',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'revision', 'tasks'],
              },
              {
                type: 'object',
                properties: {
                  detail: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentScheduledDetail',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  kind: {
                    type: 'string',
                    const: 'task',
                  },
                },
                additionalProperties: false,
                required: ['kind'],
              },
              {
                type: 'object',
                properties: {
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'changed',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'revision'],
              },
              {
                type: 'object',
                properties: {
                  result: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentScheduleResult',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  kind: {
                    type: 'string',
                    const: 'receipt',
                  },
                },
                additionalProperties: false,
                required: ['kind'],
              },
            ],
            $defs: {
              AgentScheduledSummary: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  title: {
                    type: 'string',
                  },
                  status: {
                    $ref: '#/$defs/Status',
                  },
                  approved: {
                    type: 'boolean',
                  },
                  nextFireAt: {
                    type: ['integer', 'null'],
                    format: 'int64',
                  },
                  pendingFire: {
                    type: ['string', 'null'],
                  },
                  reminder: {
                    type: 'boolean',
                  },
                  lastError: {
                    type: ['string', 'null'],
                  },
                },
                additionalProperties: false,
                required: ['id', 'revision', 'title', 'status', 'approved', 'reminder'],
              },
              Status: {
                type: 'string',
                enum: ['active', 'paused', 'completed', 'expired'],
              },
              AgentScheduledDetail: {
                type: 'object',
                properties: {
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  task: {
                    $ref: '#/$defs/Task',
                  },
                  timezone: {
                    type: 'string',
                  },
                  misfire: {
                    $ref: '#/$defs/Misfire',
                  },
                  approved: {
                    type: 'boolean',
                  },
                  pendingFire: {
                    type: ['string', 'null'],
                  },
                },
                additionalProperties: false,
                required: ['revision', 'task', 'timezone', 'misfire', 'approved'],
              },
              Task: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  title: {
                    type: 'string',
                  },
                  intent: {
                    $ref: '#/$defs/Intent',
                  },
                  schedule: {
                    $ref: '#/$defs/Schedule',
                  },
                  effect: {
                    $ref: '#/$defs/AgentScheduledEffect',
                  },
                  status: {
                    $ref: '#/$defs/Status',
                  },
                  nextFireAt: {
                    type: ['integer', 'null'],
                    format: 'int64',
                  },
                  lastFireAt: {
                    type: ['integer', 'null'],
                    format: 'int64',
                  },
                  fireCount: {
                    type: 'integer',
                    format: 'uint32',
                    minimum: 0,
                  },
                  maxFires: {
                    type: ['integer', 'null'],
                    format: 'uint32',
                    minimum: 0,
                  },
                  expiresAt: {
                    type: ['integer', 'null'],
                    format: 'int64',
                  },
                  createdBy: {
                    $ref: '#/$defs/Creator',
                  },
                  createdAt: {
                    type: 'integer',
                    format: 'int64',
                  },
                  updatedAt: {
                    type: 'integer',
                    format: 'int64',
                  },
                  runs: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/Run',
                    },
                  },
                  lastError: {
                    type: ['string', 'null'],
                  },
                },
                additionalProperties: false,
                required: [
                  'id',
                  'title',
                  'intent',
                  'schedule',
                  'effect',
                  'status',
                  'fireCount',
                  'createdBy',
                  'createdAt',
                  'updatedAt',
                  'runs',
                ],
              },
              Intent: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      body: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'text',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'body'],
                  },
                ],
              },
              Schedule: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      runAt: {
                        type: 'integer',
                        format: 'int64',
                      },
                      kind: {
                        type: 'string',
                        const: 'once',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'runAt'],
                  },
                  {
                    type: 'object',
                    properties: {
                      everySeconds: {
                        type: 'integer',
                        format: 'uint32',
                        minimum: 0,
                      },
                      startAt: {
                        type: 'integer',
                        format: 'int64',
                      },
                      kind: {
                        type: 'string',
                        const: 'interval',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'everySeconds', 'startAt'],
                  },
                  {
                    type: 'object',
                    properties: {
                      recurrence: {
                        $ref: '#/$defs/Recurrence',
                      },
                      anchorAt: {
                        type: 'integer',
                        format: 'int64',
                      },
                      kind: {
                        type: 'string',
                        const: 'calendar',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'recurrence', 'anchorAt'],
                  },
                  {
                    type: 'object',
                    properties: {
                      expression: {
                        type: 'string',
                      },
                      startAt: {
                        type: 'integer',
                        format: 'int64',
                      },
                      kind: {
                        type: 'string',
                        const: 'cron',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'expression', 'startAt'],
                  },
                ],
              },
              Recurrence: {
                type: 'string',
                enum: ['daily', 'weekly', 'monthly'],
              },
              AgentScheduledEffect: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'reminder',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      target: {
                        $ref: '#/$defs/AgentScheduledTarget',
                      },
                      model: {
                        $ref: '#/$defs/ModelSelection',
                      },
                      thinkingLevel: {
                        anyOf: [
                          {
                            $ref: '#/$defs/ThinkingLevel',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'session',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'target', 'model'],
                  },
                  {
                    type: 'object',
                    properties: {
                      target: {
                        $ref: '#/$defs/AgentScheduledTarget',
                      },
                      model: {
                        $ref: '#/$defs/ModelSelection',
                      },
                      thinkingLevel: {
                        anyOf: [
                          {
                            $ref: '#/$defs/ThinkingLevel',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'agent_run',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'target', 'model'],
                  },
                ],
              },
              AgentScheduledTarget: {
                description:
                  'Exact observed source boundary. This data is checked against the original\nSession; passing it never grants execution by itself.',
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  workspace: {
                    $ref: '#/$defs/AgentWorkspace',
                  },
                  permissions: {
                    $ref: '#/$defs/AgentWorkspacePermissions',
                  },
                  boundaryRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['sessionId', 'workspace', 'permissions', 'boundaryRevision'],
              },
              AgentWorkspace: {
                type: 'object',
                properties: {
                  worktree: {
                    description:
                      'Native owner allocation; never accepted from a caller as workspace authority.',
                    anyOf: [
                      {
                        $ref: '#/$defs/Binding',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  projectId: {
                    description: "Optional membership in this Agent's canonical Project catalog.",
                    type: ['string', 'null'],
                    format: 'uuid',
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  identity: {
                    type: 'string',
                    pattern: '^workspace:v1:[A-Fa-f0-9-]{36}$',
                  },
                },
                additionalProperties: false,
                required: ['path', 'directoryIdentity', 'identity'],
              },
              Binding: {
                description: 'Immutable allocation intent, not the current child branch or HEAD.',
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  common_dir: {
                    type: 'string',
                  },
                  source: {
                    type: 'string',
                  },
                  source_identity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  base_commit: {
                    type: 'string',
                  },
                  directory: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: [
                  'id',
                  'common_dir',
                  'source',
                  'source_identity',
                  'base_commit',
                  'directory',
                ],
              },
              AgentWorkspacePermissions: {
                type: 'object',
                properties: {
                  access: {
                    $ref: '#/$defs/AgentWorkspaceAccess',
                  },
                  requestPermissions: {
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: ['access', 'requestPermissions'],
              },
              AgentWorkspaceAccess: {
                description:
                  'Session sandbox policy. Full access explicitly disables filesystem and process isolation.',
                type: 'string',
                enum: ['read_only', 'workspace_write', 'danger_full_access'],
              },
              ModelSelection: {
                description:
                  'Exact public selection observed by a caller, checked once at run admission.',
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                    minLength: 1,
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  modelId: {
                    type: 'string',
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'revision', 'modelId'],
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
              Creator: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'user',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      sessionId: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'agent',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'sessionId'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'system',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                ],
              },
              Run: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  at: {
                    type: 'integer',
                    format: 'int64',
                  },
                  outcome: {
                    $ref: '#/$defs/Outcome',
                  },
                  message: {
                    type: 'string',
                  },
                  sessionId: {
                    type: ['string', 'null'],
                  },
                  runId: {
                    type: ['string', 'null'],
                  },
                },
                additionalProperties: false,
                required: ['id', 'at', 'outcome', 'message'],
              },
              Outcome: {
                type: 'string',
                enum: ['ok', 'failed', 'blocked'],
              },
              Misfire: {
                type: 'string',
                enum: ['skip', 'latest'],
              },
              AgentScheduleResult: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      taskId: {
                        type: 'string',
                      },
                      revision: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'committed',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'taskId', 'revision'],
                  },
                  {
                    type: 'object',
                    properties: {
                      actual: {
                        type: ['integer', 'null'],
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'conflict',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind'],
                  },
                  {
                    type: 'object',
                    properties: {
                      reason: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'rejected',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'reason'],
                  },
                ],
              },
            },
          },
          resources: {},
        },
        work: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentWorkRead',
            type: 'object',
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
              target: {
                $ref: '#/$defs/AgentWorkTarget',
              },
              cursor: {
                anyOf: [
                  {
                    $ref: '#/$defs/AgentAnswerCursor',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
            },
            additionalProperties: false,
            required: ['sessionId', 'target'],
            $defs: {
              AgentWorkTarget: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      invocationId: {
                        type: 'string',
                        minLength: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'invocation',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'invocationId'],
                  },
                  {
                    type: 'object',
                    properties: {
                      messageId: {
                        type: 'string',
                        minLength: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'message',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'messageId'],
                  },
                ],
              },
              AgentAnswerCursor: {
                type: 'object',
                properties: {
                  invocationId: {
                    type: 'string',
                    minLength: 1,
                  },
                  offset: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                },
                additionalProperties: false,
                required: ['invocationId', 'offset'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AgentWork',
            oneOf: [
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'missing',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'pending',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'cancelled',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'changed',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  shared: {
                    type: 'boolean',
                  },
                  execution: {
                    $ref: '#/$defs/AgentExecution',
                  },
                  answer: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentAnswerPage',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  pendingInteractions: {
                    description:
                      'Count for this exact Run; original Session interactions retain all authority.',
                    type: 'integer',
                    format: 'uint32',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'delivered',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'shared', 'execution', 'pendingInteractions'],
              },
            ],
            $defs: {
              AgentExecution: {
                description:
                  'Canonical physical execution receipt, independent of the current Session tip.',
                type: 'object',
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  turnId: {
                    type: 'string',
                  },
                  runId: {
                    type: 'string',
                  },
                  invocationId: {
                    type: 'string',
                  },
                  highWater: {
                    description: 'Run-local event count, not the root-global transcript cursor.',
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  state: {
                    $ref: '#/$defs/AgentExecutionState',
                  },
                },
                additionalProperties: false,
                required: ['sessionId', 'turnId', 'runId', 'invocationId', 'highWater', 'state'],
              },
              AgentExecutionState: {
                type: 'string',
                enum: [
                  'admitted',
                  'running',
                  'waiting',
                  'paused',
                  'completed',
                  'failed',
                  'cancelled',
                ],
              },
              AgentAnswerPage: {
                type: 'object',
                properties: {
                  text: {
                    type: 'string',
                  },
                  next: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentAnswerCursor',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
                required: ['text'],
              },
              AgentAnswerCursor: {
                type: 'object',
                properties: {
                  invocationId: {
                    type: 'string',
                    minLength: 1,
                  },
                  offset: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                },
                additionalProperties: false,
                required: ['invocationId', 'offset'],
              },
            },
          },
          resources: {},
        },
      },
    },
  },
  executor: {
    name: 'maka.agent.Executor',
    version: 1,
    transport: 'remote',
    interface: {
      kind: 'service',
      methods: {
        execute: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'ExecutorExecute',
            description:
              'Observations and text; immutable attachments travel in the actual request resources.\nNo path, invocation or conversation key is authority.',
            type: 'object',
            properties: {
              language: {
                $ref: '#/$defs/Language',
              },
              invocation: {
                $ref: '#/$defs/Invocation',
              },
              conversationKey: {
                type: 'string',
                minLength: 1,
              },
              message: {
                type: 'string',
              },
              cwd: {
                type: 'string',
                minLength: 1,
              },
              instructions: {
                type: ['string', 'null'],
              },
              settings: {
                $ref: '#/$defs/ExecutorSettings',
              },
            },
            additionalProperties: false,
            required: ['invocation', 'conversationKey', 'message', 'cwd', 'settings'],
            $defs: {
              Language: {
                type: 'string',
                enum: ['en', 'zh-CN', 'zh-TW'],
              },
              Invocation: {
                type: 'object',
                properties: {
                  session_id: {
                    type: 'string',
                  },
                  turn_id: {
                    type: 'string',
                  },
                  run_id: {
                    type: 'string',
                  },
                  invocation_id: {
                    type: 'string',
                  },
                },
                required: ['session_id', 'turn_id', 'run_id', 'invocation_id'],
              },
              ExecutorSettings: {
                description:
                  'Executor-owned model selection, independent of Host model connections.',
                type: 'object',
                properties: {
                  model: {
                    type: ['string', 'null'],
                  },
                  thinkingLevel: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ThinkingLevel',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'ExecutorOutcome',
            oneOf: [
              {
                type: 'object',
                properties: {
                  text: {
                    type: 'string',
                  },
                  status: {
                    type: 'string',
                    const: 'completed',
                  },
                },
                additionalProperties: false,
                required: ['status', 'text'],
              },
              {
                type: 'object',
                properties: {
                  reason: {
                    type: ['string', 'null'],
                  },
                  status: {
                    type: 'string',
                    const: 'cancelled',
                  },
                },
                additionalProperties: false,
                required: ['status'],
              },
              {
                type: 'object',
                properties: {
                  message: {
                    type: 'string',
                  },
                  code: {
                    type: ['string', 'null'],
                  },
                  recoverable: {
                    type: 'boolean',
                    default: false,
                  },
                  status: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                additionalProperties: false,
                required: ['status', 'message'],
              },
            ],
          },
          progress: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  text: {
                    type: 'string',
                  },
                  type: {
                    type: 'string',
                    const: 'output_delta',
                  },
                },
                required: ['type', 'text'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  text: {
                    type: 'string',
                  },
                  type: {
                    type: 'string',
                    const: 'thinking_delta',
                  },
                },
                required: ['type', 'text'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  toolCallId: {
                    type: 'string',
                  },
                  name: {
                    type: 'string',
                  },
                  input: true,
                  type: {
                    type: 'string',
                    const: 'tool_start',
                  },
                },
                required: ['type', 'toolCallId', 'name', 'input'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  toolCallId: {
                    type: 'string',
                  },
                  text: {
                    type: 'string',
                  },
                  type: {
                    type: 'string',
                    const: 'tool_progress',
                  },
                },
                required: ['type', 'toolCallId', 'text'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  toolCallId: {
                    type: 'string',
                  },
                  text: {
                    type: 'string',
                  },
                  isError: {
                    type: 'boolean',
                    default: false,
                  },
                  type: {
                    type: 'string',
                    const: 'tool_result',
                  },
                },
                required: ['type', 'toolCallId', 'text'],
              },
            ],
            description:
              'External tool activity is observation, never a request to dispatch a Host tool.',
            title: 'ExecutorOutput',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          resources: {
            attachments: {
              type: {
                name: 'maka.bytes',
                version: 1,
              },
              optional: true,
            },
          },
        },
      },
    },
  },
  workhubCoordinator: {
    name: 'maka.workhub.Coordinator',
    version: 1,
    transport: 'remote',
    interface: {
      kind: 'service',
      methods: {
        changeGraph: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
              expectedGraphId: {
                anyOf: [
                  {
                    $ref: '#/$defs/GraphId',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              action: {
                $ref: '#/$defs/WorkHubGraphAction',
              },
            },
            required: ['sessionId', 'action'],
            title: 'WorkHubGraphChange',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              GraphId: {
                type: 'string',
                minLength: 1,
              },
              WorkHubGraphAction: {
                oneOf: [
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      mode: {
                        $ref: '#/$defs/GraphMode',
                      },
                      kind: {
                        type: 'string',
                        const: 'start',
                      },
                    },
                    required: ['kind', 'mode'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'stop',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'leave',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                ],
              },
              GraphMode: {
                type: 'string',
                enum: ['graph', 'swarm'],
              },
            },
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  epoch: {
                    $ref: '#/$defs/GraphEpoch',
                  },
                  kind: {
                    type: 'string',
                    const: 'committed',
                  },
                },
                required: ['kind', 'epoch'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  current: {
                    anyOf: [
                      {
                        $ref: '#/$defs/GraphEpoch',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  kind: {
                    type: 'string',
                    const: 'conflict',
                  },
                },
                required: ['kind'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  reason: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                required: ['kind', 'reason'],
              },
            ],
            title: 'WorkHubGraphChanged',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              GraphEpoch: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  rootSessionId: {
                    type: 'string',
                  },
                  epoch: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  graphId: {
                    $ref: '#/$defs/GraphId',
                  },
                  createdAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  mode: {
                    $ref: '#/$defs/GraphMode',
                  },
                },
                required: ['rootSessionId', 'epoch', 'graphId', 'createdAt', 'mode'],
              },
              GraphId: {
                type: 'string',
                minLength: 1,
              },
              GraphMode: {
                type: 'string',
                enum: ['graph', 'swarm'],
              },
            },
          },
          resources: {},
        },
        control: {
          mode: 'query',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              controlId: {
                type: 'string',
                pattern: '^wc_[a-f0-9]{64}$',
              },
            },
            required: ['controlId'],
            title: 'WorkHubControlRead',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          output: {
            type: 'object',
            additionalProperties: false,
            properties: {
              taskId: {
                type: 'string',
              },
              controlId: {
                type: 'string',
              },
              operation: {
                type: 'string',
                format: 'uuid',
              },
              status: {
                $ref: '#/$defs/WorkHubControlStatus',
              },
            },
            required: ['taskId', 'controlId', 'operation', 'status'],
            title: 'WorkHubControl',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              WorkHubControlStatus: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'pending',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'unavailable',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'uncertain',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      outcome: {
                        $ref: '#/$defs/WorkHubControlOutcome',
                      },
                      kind: {
                        type: 'string',
                        const: 'returned',
                      },
                    },
                    required: ['kind', 'outcome'],
                  },
                ],
              },
              WorkHubControlOutcome: {
                oneOf: [
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      result: {
                        $ref: '#/$defs/AgentPatchResult',
                      },
                      kind: {
                        type: 'string',
                        const: 'patch',
                      },
                    },
                    required: ['kind', 'result'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      result: {
                        $ref: '#/$defs/AgentStopped',
                      },
                      kind: {
                        type: 'string',
                        const: 'stop',
                      },
                    },
                    required: ['kind', 'result'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      result: {
                        $ref: '#/$defs/AgentResumeResult',
                      },
                      kind: {
                        type: 'string',
                        const: 'resume',
                      },
                    },
                    required: ['kind', 'result'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      result: {
                        $ref: '#/$defs/AgentQueueMutationResult',
                      },
                      kind: {
                        type: 'string',
                        const: 'retract',
                      },
                    },
                    required: ['kind', 'result'],
                  },
                ],
              },
              AgentPatchResult: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'unavailable',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'busy',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'changed',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      patch: {
                        $ref: '#/$defs/AgentWorkspacePatch',
                      },
                      kind: {
                        type: 'string',
                        const: 'ready',
                      },
                    },
                    required: ['kind', 'patch'],
                  },
                ],
              },
              AgentWorkspacePatch: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  artifactId: {
                    type: 'string',
                  },
                  sessionId: {
                    type: 'string',
                  },
                  turnId: {
                    type: 'string',
                  },
                  baseCommit: {
                    type: 'string',
                  },
                  bytes: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                required: ['artifactId', 'sessionId', 'turnId', 'baseCommit', 'bytes'],
              },
              AgentStopped: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  requested: {
                    type: 'boolean',
                  },
                },
                required: ['requested'],
              },
              AgentResumeResult: {
                oneOf: [
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      execution: {
                        $ref: '#/$defs/AgentExecution',
                      },
                      kind: {
                        type: 'string',
                        const: 'started',
                      },
                    },
                    required: ['kind', 'execution'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      reason: {
                        $ref: '#/$defs/AgentResumeParkReason',
                      },
                      kind: {
                        type: 'string',
                        const: 'parked',
                      },
                    },
                    required: ['kind', 'reason'],
                  },
                ],
              },
              AgentExecution: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  turnId: {
                    type: 'string',
                  },
                  runId: {
                    type: 'string',
                  },
                  invocationId: {
                    type: 'string',
                  },
                  highWater: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    description: 'Run-local event count, not the root-global transcript cursor.',
                  },
                  state: {
                    $ref: '#/$defs/AgentExecutionState',
                  },
                },
                required: ['sessionId', 'turnId', 'runId', 'invocationId', 'highWater', 'state'],
                description:
                  'Canonical physical execution receipt, independent of the current Session tip.',
              },
              AgentExecutionState: {
                type: 'string',
                enum: [
                  'admitted',
                  'running',
                  'waiting',
                  'paused',
                  'completed',
                  'failed',
                  'cancelled',
                ],
              },
              AgentResumeParkReason: {
                type: 'string',
                enum: [
                  'closed',
                  'archived',
                  'busy',
                  'source_missing',
                  'source_changed',
                  'source_not_resumable',
                  'already_continued',
                  'workspace_changed',
                  'safety_check_failed',
                ],
              },
              AgentQueueMutationResult: {
                oneOf: [
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      revision: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'committed',
                      },
                    },
                    required: ['kind', 'revision'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      expected: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      actual: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'revision_conflict',
                      },
                    },
                    required: ['kind', 'expected', 'actual'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      reason: {
                        $ref: '#/$defs/AgentQueueRejection',
                      },
                      kind: {
                        type: 'string',
                        const: 'rejected',
                      },
                    },
                    required: ['kind', 'reason'],
                  },
                ],
              },
              AgentQueueRejection: {
                type: 'string',
                enum: [
                  'closed',
                  'missing',
                  'in_flight',
                  'invalid_edit',
                  'execution_changed',
                  'not_running',
                ],
              },
            },
          },
          resources: {},
        },
        controls: {
          mode: 'query',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              after: {
                type: ['string', 'null'],
              },
            },
            title: 'WorkHubControlsRead',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          output: {
            type: 'object',
            additionalProperties: false,
            properties: {
              entries: {
                type: 'array',
                items: {
                  $ref: '#/$defs/WorkHubControlEntry',
                },
                maxItems: 16,
              },
              after: {
                type: ['string', 'null'],
              },
            },
            required: ['entries'],
            title: 'WorkHubControls',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              WorkHubControlEntry: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  taskId: {
                    type: 'string',
                  },
                  controlId: {
                    type: 'string',
                  },
                },
                required: ['taskId', 'controlId'],
              },
            },
          },
          resources: {},
        },
        coordinator: {
          mode: 'query',
          input: {
            type: 'object',
            properties: {},
            additionalProperties: false,
          },
          output: {
            oneOf: [
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'missing',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  workspace: {
                    $ref: '#/$defs/AgentDirectorySelection',
                  },
                  kind: {
                    type: 'string',
                    const: 'pending',
                  },
                },
                required: ['kind', 'workspace'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  session: {
                    $ref: '#/$defs/AgentSession',
                  },
                  kind: {
                    type: 'string',
                    const: 'ready',
                  },
                },
                required: ['kind', 'session'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  reason: {
                    $ref: '#/$defs/AgentRejection',
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                required: ['kind', 'reason'],
              },
            ],
            title: 'WorkHubCoordinator',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              AgentDirectorySelection: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  rootId: {
                    type: 'string',
                    minLength: 1,
                  },
                  segments: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                },
                required: ['rootId', 'segments', 'directoryIdentity'],
              },
              AgentSession: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  branch: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentSessionBranch',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  backend: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentBackendPreference',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  collaborationMode: {
                    $ref: '#/$defs/CollaborationMode',
                    default: 'agent',
                  },
                  tools: {
                    type: ['array', 'null'],
                    items: {
                      type: 'string',
                    },
                  },
                  dataSource: {
                    $ref: '#/$defs/AgentDataSource',
                  },
                  permissions: {
                    $ref: '#/$defs/AgentWorkspacePermissions',
                  },
                  boundaryRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  id: {
                    type: 'string',
                  },
                  title: {
                    type: 'string',
                  },
                  labels: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  workspace: {
                    $ref: '#/$defs/AgentWorkspace',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  updatedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  archived: {
                    type: 'boolean',
                  },
                  hasUnread: {
                    type: 'boolean',
                  },
                  activity: {
                    $ref: '#/$defs/AgentSessionActivity',
                  },
                },
                required: [
                  'branch',
                  'dataSource',
                  'permissions',
                  'boundaryRevision',
                  'id',
                  'title',
                  'labels',
                  'workspace',
                  'revision',
                  'updatedAt',
                  'archived',
                  'hasUnread',
                  'activity',
                ],
              },
              AgentSessionBranch: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  sessionId: {
                    type: 'string',
                    minLength: 1,
                  },
                  turnId: {
                    type: ['string', 'null'],
                    minLength: 1,
                  },
                },
                required: ['sessionId', 'turnId'],
                description:
                  'Frozen conversation ancestry for presentation, not authority over the source.',
              },
              AgentBackendPreference: {
                oneOf: [
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      connectionId: {
                        type: 'string',
                        minLength: 1,
                      },
                      modelId: {
                        type: 'string',
                        minLength: 1,
                      },
                      thinkingLevel: {
                        anyOf: [
                          {
                            $ref: '#/$defs/ThinkingLevel',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'model',
                      },
                    },
                    required: ['kind', 'connectionId', 'modelId'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      selection: {
                        $ref: '#/$defs/AgentExecutorSelection',
                      },
                      kind: {
                        type: 'string',
                        const: 'executor',
                      },
                    },
                    required: ['kind', 'selection'],
                  },
                ],
                description:
                  "The next turn's choice, independent of an already admitted execution.\nModel revisions are resolved afresh; preferences never grant execution authority.",
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
              AgentExecutorSelection: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  executor: {
                    type: 'string',
                    minLength: 1,
                  },
                  settings: {
                    $ref: '#/$defs/ExecutorSettings',
                  },
                },
                required: ['executor', 'settings'],
              },
              ExecutorSettings: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  model: {
                    type: ['string', 'null'],
                  },
                  thinkingLevel: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ThinkingLevel',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                description:
                  'Executor-owned model selection, independent of Host model connections.',
              },
              CollaborationMode: {
                type: 'string',
                enum: ['agent', 'plan'],
              },
              AgentDataSource: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  namespace: {
                    $ref: '#/$defs/InstanceId',
                  },
                },
                required: ['stateDomain', 'deployment', 'namespace'],
                description:
                  'Stable business-data origin, independent of package or activation revisions.',
              },
              InstanceId: {
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
              },
              AgentWorkspacePermissions: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  access: {
                    $ref: '#/$defs/AgentWorkspaceAccess',
                  },
                  requestPermissions: {
                    type: 'boolean',
                  },
                },
                required: ['access', 'requestPermissions'],
              },
              AgentWorkspaceAccess: {
                type: 'string',
                enum: ['read_only', 'workspace_write', 'danger_full_access'],
                description:
                  'Session sandbox policy. Full access explicitly disables filesystem and process isolation.',
              },
              AgentWorkspace: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  worktree: {
                    anyOf: [
                      {
                        $ref: '#/$defs/Binding',
                      },
                      {
                        type: 'null',
                      },
                    ],
                    description:
                      'Native owner allocation; never accepted from a caller as workspace authority.',
                  },
                  projectId: {
                    type: ['string', 'null'],
                    format: 'uuid',
                    description: "Optional membership in this Agent's canonical Project catalog.",
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  identity: {
                    type: 'string',
                    pattern: '^workspace:v1:[A-Fa-f0-9-]{36}$',
                  },
                },
                required: ['path', 'directoryIdentity', 'identity'],
              },
              Binding: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  id: {
                    type: 'string',
                  },
                  common_dir: {
                    type: 'string',
                  },
                  source: {
                    type: 'string',
                  },
                  source_identity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  base_commit: {
                    type: 'string',
                  },
                  directory: {
                    type: 'string',
                  },
                },
                required: [
                  'id',
                  'common_dir',
                  'source',
                  'source_identity',
                  'base_commit',
                  'directory',
                ],
                description: 'Immutable allocation intent, not the current child branch or HEAD.',
              },
              AgentSessionActivity: {
                type: 'string',
                enum: ['idle', 'working', 'waiting'],
              },
              AgentRejection: {
                type: 'string',
                enum: [
                  'title_invalid',
                  'labels_invalid',
                  'tools_unavailable',
                  'busy',
                  'workspace_unavailable',
                  'session_unavailable',
                  'history_unavailable',
                  'managed_session',
                  'closed',
                ],
              },
            },
          },
          resources: {},
        },
        graph: {
          mode: 'query',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
              graphId: {
                anyOf: [
                  {
                    $ref: '#/$defs/GraphId',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              after: {
                anyOf: [
                  {
                    $ref: '#/$defs/WorkId',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
            },
            required: ['sessionId'],
            title: 'WorkHubGraphRead',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              GraphId: {
                type: 'string',
                minLength: 1,
              },
              WorkId: {
                type: 'string',
                minLength: 1,
              },
            },
          },
          output: {
            type: 'object',
            additionalProperties: false,
            properties: {
              enabled: {
                type: 'boolean',
              },
              currentEpoch: {
                anyOf: [
                  {
                    $ref: '#/$defs/GraphEpoch',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              selectedMode: {
                anyOf: [
                  {
                    $ref: '#/$defs/GraphMode',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              epoch: {
                anyOf: [
                  {
                    $ref: '#/$defs/GraphEpoch',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              revision: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
              status: {
                $ref: '#/$defs/GraphStatus',
              },
              quiescent: {
                type: 'boolean',
              },
              work: {
                type: 'array',
                items: {
                  $ref: '#/$defs/WorkHubGraphWork',
                },
                maxItems: 16,
              },
              after: {
                anyOf: [
                  {
                    $ref: '#/$defs/WorkId',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              finish: {
                anyOf: [
                  {
                    $ref: '#/$defs/GraphFinish',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
            },
            required: ['enabled', 'revision', 'status', 'quiescent', 'work'],
            title: 'WorkHubGraphView',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              GraphEpoch: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  rootSessionId: {
                    type: 'string',
                  },
                  epoch: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  graphId: {
                    $ref: '#/$defs/GraphId',
                  },
                  createdAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  mode: {
                    $ref: '#/$defs/GraphMode',
                  },
                },
                required: ['rootSessionId', 'epoch', 'graphId', 'createdAt', 'mode'],
              },
              GraphId: {
                type: 'string',
                minLength: 1,
              },
              GraphMode: {
                type: 'string',
                enum: ['graph', 'swarm'],
              },
              GraphStatus: {
                type: 'string',
                enum: ['empty', 'active', 'waiting', 'closing', 'stopped', 'completed', 'failed'],
              },
              WorkHubGraphWork: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  workId: {
                    $ref: '#/$defs/WorkId',
                  },
                  taskId: {
                    type: 'string',
                  },
                  target: {
                    $ref: '#/$defs/GraphTarget',
                  },
                  status: {
                    $ref: '#/$defs/GraphWorkState',
                  },
                  instructionExcerpt: {
                    type: 'string',
                  },
                  instructionTruncated: {
                    type: 'boolean',
                  },
                  resultId: {
                    type: ['string', 'null'],
                  },
                  failure: {
                    type: ['string', 'null'],
                  },
                },
                required: [
                  'workId',
                  'taskId',
                  'target',
                  'status',
                  'instructionExcerpt',
                  'instructionTruncated',
                ],
              },
              WorkId: {
                type: 'string',
                minLength: 1,
              },
              GraphTarget: {
                oneOf: [
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      agentId: {
                        type: 'string',
                        minLength: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'agent',
                      },
                    },
                    required: ['kind', 'agentId'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      presetId: {
                        type: 'string',
                        minLength: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'preset',
                      },
                    },
                    required: ['kind', 'presetId'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      executorId: {
                        type: 'string',
                        minLength: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'executor',
                      },
                    },
                    required: ['kind', 'executorId'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      operatorId: {
                        $ref: '#/$defs/OperatorId',
                      },
                      kind: {
                        type: 'string',
                        const: 'operator',
                      },
                    },
                    required: ['kind', 'operatorId'],
                  },
                ],
              },
              OperatorId: {
                type: 'string',
                minLength: 1,
              },
              GraphWorkState: {
                type: 'string',
                enum: [
                  'requested',
                  'waiting',
                  'running',
                  'blocked',
                  'completed',
                  'failed',
                  'cancelled',
                  'stopped',
                  'superseded',
                ],
              },
              GraphFinish: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  resultIds: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  reason: {
                    type: 'string',
                  },
                },
                required: ['resultIds', 'reason'],
              },
            },
          },
          resources: {},
        },
        graphHistory: {
          mode: 'query',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
              before: {
                type: ['integer', 'null'],
                format: 'uint64',
                minimum: 0,
              },
            },
            required: ['sessionId'],
            title: 'WorkHubGraphHistoryRead',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          output: {
            type: 'object',
            additionalProperties: false,
            properties: {
              epochs: {
                type: 'array',
                items: {
                  $ref: '#/$defs/GraphEpoch',
                },
                maxItems: 32,
              },
              currentEpoch: {
                type: ['integer', 'null'],
                format: 'uint64',
                minimum: 0,
              },
              nextBefore: {
                type: ['integer', 'null'],
                format: 'uint64',
                minimum: 0,
              },
            },
            required: ['epochs'],
            title: 'WorkHubGraphHistory',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              GraphEpoch: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  rootSessionId: {
                    type: 'string',
                  },
                  epoch: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  graphId: {
                    $ref: '#/$defs/GraphId',
                  },
                  createdAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  mode: {
                    $ref: '#/$defs/GraphMode',
                  },
                },
                required: ['rootSessionId', 'epoch', 'graphId', 'createdAt', 'mode'],
              },
              GraphId: {
                type: 'string',
                minLength: 1,
              },
              GraphMode: {
                type: 'string',
                enum: ['graph', 'swarm'],
              },
            },
          },
          resources: {},
        },
        graphReceipt: {
          mode: 'query',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              reference: {
                $ref: '#/$defs/RecoveryRef',
              },
            },
            required: ['reference'],
            title: 'WorkHubGraphReceiptRead',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              RecoveryRef: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  source: {
                    $ref: '#/$defs/DeploymentRef',
                  },
                  namespace: {
                    $ref: '#/$defs/InstanceId',
                  },
                  export: {
                    type: 'string',
                  },
                  method: {
                    type: 'string',
                  },
                  operation: {
                    type: 'string',
                    format: 'uuid',
                  },
                  fingerprint: {
                    type: 'string',
                  },
                  contract: {
                    $ref: '#/$defs/RecoveryContract',
                  },
                  recovery: {
                    $ref: '#/$defs/RecoveryProtocol',
                  },
                },
                required: [
                  'source',
                  'namespace',
                  'export',
                  'method',
                  'operation',
                  'fingerprint',
                  'contract',
                  'recovery',
                ],
              },
              DeploymentRef: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                required: ['stateDomain', 'deployment', 'revision'],
              },
              InstanceId: {
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
              },
              RecoveryContract: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  name: {
                    type: 'string',
                  },
                  version: {
                    type: 'integer',
                    format: 'uint32',
                    minimum: 0,
                  },
                  transport: {
                    $ref: '#/$defs/Transport',
                  },
                  digest: {
                    type: 'string',
                  },
                },
                required: ['name', 'version', 'transport', 'digest'],
                description:
                  'Contract identity for a journal lookup. The original request retains the\ncomplete contract; a receipt carries only its digest.',
              },
              Transport: {
                type: 'string',
                enum: ['local', 'remote'],
              },
              RecoveryProtocol: {
                type: 'string',
                enum: ['journal_v1'],
              },
            },
          },
          output: {
            anyOf: [
              {
                $ref: '#/$defs/WorkHubGraphChanged',
              },
              {
                type: 'null',
              },
            ],
            title: 'Nullable_WorkHubGraphChanged',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              WorkHubGraphChanged: {
                oneOf: [
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      epoch: {
                        $ref: '#/$defs/GraphEpoch',
                      },
                      kind: {
                        type: 'string',
                        const: 'committed',
                      },
                    },
                    required: ['kind', 'epoch'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      current: {
                        anyOf: [
                          {
                            $ref: '#/$defs/GraphEpoch',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'conflict',
                      },
                    },
                    required: ['kind'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      reason: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'rejected',
                      },
                    },
                    required: ['kind', 'reason'],
                  },
                ],
              },
              GraphEpoch: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  rootSessionId: {
                    type: 'string',
                  },
                  epoch: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  graphId: {
                    $ref: '#/$defs/GraphId',
                  },
                  createdAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  mode: {
                    $ref: '#/$defs/GraphMode',
                  },
                },
                required: ['rootSessionId', 'epoch', 'graphId', 'createdAt', 'mode'],
              },
              GraphId: {
                type: 'string',
                minLength: 1,
              },
              GraphMode: {
                type: 'string',
                enum: ['graph', 'swarm'],
              },
            },
          },
          resources: {},
        },
        graphResult: {
          mode: 'query',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
              graphId: {
                $ref: '#/$defs/GraphId',
              },
              workId: {
                $ref: '#/$defs/WorkId',
              },
              resultId: {
                type: 'string',
                minLength: 1,
              },
              offset: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
                maximum: 9007199254740991,
              },
            },
            required: ['sessionId', 'graphId', 'workId', 'resultId', 'offset'],
            title: 'WorkHubGraphResultRead',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              GraphId: {
                type: 'string',
                minLength: 1,
              },
              WorkId: {
                type: 'string',
                minLength: 1,
              },
            },
          },
          output: {
            type: 'object',
            additionalProperties: false,
            properties: {
              workId: {
                $ref: '#/$defs/WorkId',
              },
              resultId: {
                type: 'string',
              },
              execution: {
                $ref: '#/$defs/AgentExecution',
              },
              text: {
                type: 'string',
              },
              nextOffset: {
                type: ['integer', 'null'],
                format: 'uint64',
                minimum: 0,
              },
            },
            required: ['workId', 'resultId', 'execution', 'text'],
            title: 'WorkHubGraphResult',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              WorkId: {
                type: 'string',
                minLength: 1,
              },
              AgentExecution: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  turnId: {
                    type: 'string',
                  },
                  runId: {
                    type: 'string',
                  },
                  invocationId: {
                    type: 'string',
                  },
                  highWater: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    description: 'Run-local event count, not the root-global transcript cursor.',
                  },
                  state: {
                    $ref: '#/$defs/AgentExecutionState',
                  },
                },
                required: ['sessionId', 'turnId', 'runId', 'invocationId', 'highWater', 'state'],
                description:
                  'Canonical physical execution receipt, independent of the current Session tip.',
              },
              AgentExecutionState: {
                type: 'string',
                enum: [
                  'admitted',
                  'running',
                  'waiting',
                  'paused',
                  'completed',
                  'failed',
                  'cancelled',
                ],
              },
            },
          },
          resources: {},
        },
        graphWork: {
          mode: 'query',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
              graphId: {
                $ref: '#/$defs/GraphId',
              },
              workId: {
                $ref: '#/$defs/WorkId',
              },
            },
            required: ['sessionId', 'graphId', 'workId'],
            title: 'WorkHubGraphWorkRead',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              GraphId: {
                type: 'string',
                minLength: 1,
              },
              WorkId: {
                type: 'string',
                minLength: 1,
              },
            },
          },
          output: {
            type: 'object',
            additionalProperties: false,
            properties: {
              workId: {
                $ref: '#/$defs/WorkId',
              },
              target: {
                $ref: '#/$defs/GraphTarget',
              },
              instruction: {
                type: 'string',
              },
              inputIds: {
                type: 'array',
                items: {
                  type: 'string',
                },
              },
              selectedResultInputs: {
                type: 'array',
                items: {
                  $ref: '#/$defs/HistoricalInput',
                },
              },
              replaces: {
                type: ['string', 'null'],
              },
            },
            required: ['workId', 'target', 'instruction', 'inputIds'],
            title: 'GraphWorkDefinition',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              WorkId: {
                type: 'string',
                minLength: 1,
              },
              GraphTarget: {
                oneOf: [
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      agentId: {
                        type: 'string',
                        minLength: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'agent',
                      },
                    },
                    required: ['kind', 'agentId'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      presetId: {
                        type: 'string',
                        minLength: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'preset',
                      },
                    },
                    required: ['kind', 'presetId'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      executorId: {
                        type: 'string',
                        minLength: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'executor',
                      },
                    },
                    required: ['kind', 'executorId'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      operatorId: {
                        $ref: '#/$defs/OperatorId',
                      },
                      kind: {
                        type: 'string',
                        const: 'operator',
                      },
                    },
                    required: ['kind', 'operatorId'],
                  },
                ],
              },
              OperatorId: {
                type: 'string',
                minLength: 1,
              },
              HistoricalInput: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  sourceGraphId: {
                    $ref: '#/$defs/GraphId',
                  },
                  resultId: {
                    type: 'string',
                    minLength: 1,
                  },
                },
                required: ['sourceGraphId', 'resultId'],
              },
              GraphId: {
                type: 'string',
                minLength: 1,
              },
            },
          },
          resources: {},
        },
        presets: {
          mode: 'query',
          input: {
            type: 'object',
            properties: {},
            additionalProperties: false,
          },
          output: {
            type: 'object',
            additionalProperties: false,
            properties: {
              revision: {
                type: ['integer', 'null'],
                format: 'uint64',
                minimum: 0,
              },
              entries: {
                type: 'array',
                items: {
                  $ref: '#/$defs/WorkHubPreset',
                },
              },
            },
            required: ['revision', 'entries'],
            title: 'WorkHubPresets',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              WorkHubPreset: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  isolatedWorkspace: {
                    type: 'boolean',
                    default: false,
                  },
                  id: {
                    type: 'string',
                    minLength: 1,
                    pattern: '^[a-zA-Z0-9._:-]+$',
                  },
                  name: {
                    type: 'string',
                    minLength: 1,
                  },
                  description: {
                    type: 'string',
                  },
                  worker: {
                    type: 'string',
                    minLength: 1,
                  },
                  tools: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                    description:
                      'Exact installed names; an empty list permits reasoning without tools.',
                    uniqueItems: true,
                  },
                  model: {
                    $ref: '#/$defs/ConnectionTarget',
                  },
                  thinkingLevel: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ThinkingLevel',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  enabled: {
                    type: 'boolean',
                  },
                },
                required: ['id', 'name', 'description', 'worker', 'tools', 'model', 'enabled'],
              },
              ConnectionTarget: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  connectionId: {
                    type: 'string',
                  },
                  modelId: {
                    type: 'string',
                  },
                },
                required: ['connectionId', 'modelId'],
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
            },
          },
          resources: {},
        },
        resolve: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              workspace: {
                $ref: '#/$defs/AgentDirectorySelection',
                description: 'Used only when freezing the first coordinator creation intent.',
              },
            },
            required: ['workspace'],
            title: 'WorkHubResolve',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              AgentDirectorySelection: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  rootId: {
                    type: 'string',
                    minLength: 1,
                  },
                  segments: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                },
                required: ['rootId', 'segments', 'directoryIdentity'],
              },
            },
          },
          output: {
            oneOf: [
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'missing',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  workspace: {
                    $ref: '#/$defs/AgentDirectorySelection',
                  },
                  kind: {
                    type: 'string',
                    const: 'pending',
                  },
                },
                required: ['kind', 'workspace'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  session: {
                    $ref: '#/$defs/AgentSession',
                  },
                  kind: {
                    type: 'string',
                    const: 'ready',
                  },
                },
                required: ['kind', 'session'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  reason: {
                    $ref: '#/$defs/AgentRejection',
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                required: ['kind', 'reason'],
              },
            ],
            title: 'WorkHubCoordinator',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              AgentDirectorySelection: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  rootId: {
                    type: 'string',
                    minLength: 1,
                  },
                  segments: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                },
                required: ['rootId', 'segments', 'directoryIdentity'],
              },
              AgentSession: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  branch: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentSessionBranch',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  backend: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentBackendPreference',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  collaborationMode: {
                    $ref: '#/$defs/CollaborationMode',
                    default: 'agent',
                  },
                  tools: {
                    type: ['array', 'null'],
                    items: {
                      type: 'string',
                    },
                  },
                  dataSource: {
                    $ref: '#/$defs/AgentDataSource',
                  },
                  permissions: {
                    $ref: '#/$defs/AgentWorkspacePermissions',
                  },
                  boundaryRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  id: {
                    type: 'string',
                  },
                  title: {
                    type: 'string',
                  },
                  labels: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  workspace: {
                    $ref: '#/$defs/AgentWorkspace',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  updatedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  archived: {
                    type: 'boolean',
                  },
                  hasUnread: {
                    type: 'boolean',
                  },
                  activity: {
                    $ref: '#/$defs/AgentSessionActivity',
                  },
                },
                required: [
                  'branch',
                  'dataSource',
                  'permissions',
                  'boundaryRevision',
                  'id',
                  'title',
                  'labels',
                  'workspace',
                  'revision',
                  'updatedAt',
                  'archived',
                  'hasUnread',
                  'activity',
                ],
              },
              AgentSessionBranch: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  sessionId: {
                    type: 'string',
                    minLength: 1,
                  },
                  turnId: {
                    type: ['string', 'null'],
                    minLength: 1,
                  },
                },
                required: ['sessionId', 'turnId'],
                description:
                  'Frozen conversation ancestry for presentation, not authority over the source.',
              },
              AgentBackendPreference: {
                oneOf: [
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      connectionId: {
                        type: 'string',
                        minLength: 1,
                      },
                      modelId: {
                        type: 'string',
                        minLength: 1,
                      },
                      thinkingLevel: {
                        anyOf: [
                          {
                            $ref: '#/$defs/ThinkingLevel',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'model',
                      },
                    },
                    required: ['kind', 'connectionId', 'modelId'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      selection: {
                        $ref: '#/$defs/AgentExecutorSelection',
                      },
                      kind: {
                        type: 'string',
                        const: 'executor',
                      },
                    },
                    required: ['kind', 'selection'],
                  },
                ],
                description:
                  "The next turn's choice, independent of an already admitted execution.\nModel revisions are resolved afresh; preferences never grant execution authority.",
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
              AgentExecutorSelection: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  executor: {
                    type: 'string',
                    minLength: 1,
                  },
                  settings: {
                    $ref: '#/$defs/ExecutorSettings',
                  },
                },
                required: ['executor', 'settings'],
              },
              ExecutorSettings: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  model: {
                    type: ['string', 'null'],
                  },
                  thinkingLevel: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ThinkingLevel',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                description:
                  'Executor-owned model selection, independent of Host model connections.',
              },
              CollaborationMode: {
                type: 'string',
                enum: ['agent', 'plan'],
              },
              AgentDataSource: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  namespace: {
                    $ref: '#/$defs/InstanceId',
                  },
                },
                required: ['stateDomain', 'deployment', 'namespace'],
                description:
                  'Stable business-data origin, independent of package or activation revisions.',
              },
              InstanceId: {
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
              },
              AgentWorkspacePermissions: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  access: {
                    $ref: '#/$defs/AgentWorkspaceAccess',
                  },
                  requestPermissions: {
                    type: 'boolean',
                  },
                },
                required: ['access', 'requestPermissions'],
              },
              AgentWorkspaceAccess: {
                type: 'string',
                enum: ['read_only', 'workspace_write', 'danger_full_access'],
                description:
                  'Session sandbox policy. Full access explicitly disables filesystem and process isolation.',
              },
              AgentWorkspace: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  worktree: {
                    anyOf: [
                      {
                        $ref: '#/$defs/Binding',
                      },
                      {
                        type: 'null',
                      },
                    ],
                    description:
                      'Native owner allocation; never accepted from a caller as workspace authority.',
                  },
                  projectId: {
                    type: ['string', 'null'],
                    format: 'uuid',
                    description: "Optional membership in this Agent's canonical Project catalog.",
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  identity: {
                    type: 'string',
                    pattern: '^workspace:v1:[A-Fa-f0-9-]{36}$',
                  },
                },
                required: ['path', 'directoryIdentity', 'identity'],
              },
              Binding: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  id: {
                    type: 'string',
                  },
                  common_dir: {
                    type: 'string',
                  },
                  source: {
                    type: 'string',
                  },
                  source_identity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  base_commit: {
                    type: 'string',
                  },
                  directory: {
                    type: 'string',
                  },
                },
                required: [
                  'id',
                  'common_dir',
                  'source',
                  'source_identity',
                  'base_commit',
                  'directory',
                ],
                description: 'Immutable allocation intent, not the current child branch or HEAD.',
              },
              AgentSessionActivity: {
                type: 'string',
                enum: ['idle', 'working', 'waiting'],
              },
              AgentRejection: {
                type: 'string',
                enum: [
                  'title_invalid',
                  'labels_invalid',
                  'tools_unavailable',
                  'busy',
                  'workspace_unavailable',
                  'session_unavailable',
                  'history_unavailable',
                  'managed_session',
                  'closed',
                ],
              },
            },
          },
          resources: {},
        },
        savePresets: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              revision: {
                type: ['integer', 'null'],
                format: 'uint64',
                minimum: 0,
              },
              entries: {
                type: 'array',
                items: {
                  $ref: '#/$defs/WorkHubPreset',
                },
              },
            },
            required: ['revision', 'entries'],
            title: 'WorkHubPresets',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              WorkHubPreset: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  isolatedWorkspace: {
                    type: 'boolean',
                    default: false,
                  },
                  id: {
                    type: 'string',
                    minLength: 1,
                    pattern: '^[a-zA-Z0-9._:-]+$',
                  },
                  name: {
                    type: 'string',
                    minLength: 1,
                  },
                  description: {
                    type: 'string',
                  },
                  worker: {
                    type: 'string',
                    minLength: 1,
                  },
                  tools: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                    description:
                      'Exact installed names; an empty list permits reasoning without tools.',
                    uniqueItems: true,
                  },
                  model: {
                    $ref: '#/$defs/ConnectionTarget',
                  },
                  thinkingLevel: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ThinkingLevel',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  enabled: {
                    type: 'boolean',
                  },
                },
                required: ['id', 'name', 'description', 'worker', 'tools', 'model', 'enabled'],
              },
              ConnectionTarget: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  connectionId: {
                    type: 'string',
                  },
                  modelId: {
                    type: 'string',
                  },
                },
                required: ['connectionId', 'modelId'],
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
            },
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  snapshot: {
                    $ref: '#/$defs/WorkHubPresets',
                  },
                  kind: {
                    type: 'string',
                    const: 'saved',
                  },
                },
                required: ['kind', 'snapshot'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  snapshot: {
                    $ref: '#/$defs/WorkHubPresets',
                  },
                  kind: {
                    type: 'string',
                    const: 'conflict',
                  },
                },
                required: ['kind', 'snapshot'],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'invalid',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
            ],
            title: 'WorkHubPresetsResult',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              WorkHubPresets: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  revision: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  entries: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/WorkHubPreset',
                    },
                  },
                },
                required: ['revision', 'entries'],
              },
              WorkHubPreset: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  isolatedWorkspace: {
                    type: 'boolean',
                    default: false,
                  },
                  id: {
                    type: 'string',
                    minLength: 1,
                    pattern: '^[a-zA-Z0-9._:-]+$',
                  },
                  name: {
                    type: 'string',
                    minLength: 1,
                  },
                  description: {
                    type: 'string',
                  },
                  worker: {
                    type: 'string',
                    minLength: 1,
                  },
                  tools: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                    description:
                      'Exact installed names; an empty list permits reasoning without tools.',
                    uniqueItems: true,
                  },
                  model: {
                    $ref: '#/$defs/ConnectionTarget',
                  },
                  thinkingLevel: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ThinkingLevel',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  enabled: {
                    type: 'boolean',
                  },
                },
                required: ['id', 'name', 'description', 'worker', 'tools', 'model', 'enabled'],
              },
              ConnectionTarget: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  connectionId: {
                    type: 'string',
                  },
                  modelId: {
                    type: 'string',
                  },
                },
                required: ['connectionId', 'modelId'],
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
            },
          },
          resources: {},
        },
        task: {
          mode: 'query',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              taskId: {
                type: 'string',
                pattern: '^wt_[a-f0-9]{64}$',
              },
              cursor: {
                anyOf: [
                  {
                    $ref: '#/$defs/AgentAnswerCursor',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
            },
            required: ['taskId'],
            title: 'WorkHubTaskRead',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              AgentAnswerCursor: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  invocationId: {
                    type: 'string',
                    minLength: 1,
                  },
                  offset: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                },
                required: ['invocationId', 'offset'],
              },
            },
          },
          output: {
            type: 'object',
            additionalProperties: false,
            properties: {
              dependencies: {
                type: 'array',
                items: {
                  type: 'string',
                },
              },
              taskId: {
                type: 'string',
              },
              worker: {
                type: 'string',
              },
              title: {
                type: 'string',
              },
              acceptedAt: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
                description: 'Frozen task acceptance time in Unix milliseconds.',
                maximum: 9007199254740991,
              },
              operation: {
                type: 'string',
                format: 'uuid',
              },
              status: {
                $ref: '#/$defs/WorkHubTaskStatus',
              },
            },
            required: ['taskId', 'worker', 'title', 'acceptedAt', 'operation', 'status'],
            title: 'WorkHubTask',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              WorkHubTaskStatus: {
                oneOf: [
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      dependencies: {
                        type: 'array',
                        items: {
                          type: 'string',
                        },
                      },
                      kind: {
                        type: 'string',
                        const: 'blocked',
                      },
                    },
                    required: ['kind', 'dependencies'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'cancelled',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      stage: {
                        $ref: '#/$defs/WorkHubPreparationStage',
                      },
                      operation: {
                        type: 'string',
                        format: 'uuid',
                      },
                      sessionId: {
                        type: ['string', 'null'],
                      },
                      state: {
                        $ref: '#/$defs/WorkHubPreparationState',
                      },
                      kind: {
                        type: 'string',
                        const: 'preparing',
                      },
                    },
                    required: ['kind', 'stage', 'operation', 'state'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'pending',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'uncertain',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'unavailable',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      reason: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'rejected',
                      },
                    },
                    required: ['kind', 'reason'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      sessionId: {
                        type: 'string',
                      },
                      invocationId: {
                        type: 'string',
                      },
                      progress: {
                        anyOf: [
                          {
                            $ref: '#/$defs/AgentWork',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'started',
                      },
                    },
                    required: ['kind', 'sessionId', 'invocationId'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      sessionId: {
                        type: 'string',
                      },
                      messageId: {
                        type: 'string',
                      },
                      progress: {
                        anyOf: [
                          {
                            $ref: '#/$defs/AgentWork',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'queued',
                      },
                    },
                    required: ['kind', 'sessionId', 'messageId'],
                  },
                ],
              },
              WorkHubPreparationStage: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'create',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      index: {
                        type: 'integer',
                        format: 'uint',
                        minimum: 0,
                      },
                      total: {
                        type: 'integer',
                        format: 'uint',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'attachment',
                      },
                    },
                    required: ['kind', 'index', 'total'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'delivery',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                ],
              },
              WorkHubPreparationState: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'pending',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'unavailable',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'uncertain',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'original_capture_required',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                    description:
                      'The original resource-bearing call can only be observed, never recaptured.',
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      reason: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'rejected',
                      },
                    },
                    required: ['kind', 'reason'],
                  },
                ],
              },
              AgentWork: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'missing',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'pending',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'cancelled',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'changed',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      shared: {
                        type: 'boolean',
                      },
                      execution: {
                        $ref: '#/$defs/AgentExecution',
                      },
                      answer: {
                        anyOf: [
                          {
                            $ref: '#/$defs/AgentAnswerPage',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      pendingInteractions: {
                        type: 'integer',
                        format: 'uint32',
                        minimum: 0,
                        description:
                          'Count for this exact Run; original Session interactions retain all authority.',
                      },
                      kind: {
                        type: 'string',
                        const: 'delivered',
                      },
                    },
                    required: ['kind', 'shared', 'execution', 'pendingInteractions'],
                  },
                ],
              },
              AgentExecution: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  turnId: {
                    type: 'string',
                  },
                  runId: {
                    type: 'string',
                  },
                  invocationId: {
                    type: 'string',
                  },
                  highWater: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    description: 'Run-local event count, not the root-global transcript cursor.',
                  },
                  state: {
                    $ref: '#/$defs/AgentExecutionState',
                  },
                },
                required: ['sessionId', 'turnId', 'runId', 'invocationId', 'highWater', 'state'],
                description:
                  'Canonical physical execution receipt, independent of the current Session tip.',
              },
              AgentExecutionState: {
                type: 'string',
                enum: [
                  'admitted',
                  'running',
                  'waiting',
                  'paused',
                  'completed',
                  'failed',
                  'cancelled',
                ],
              },
              AgentAnswerPage: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  text: {
                    type: 'string',
                  },
                  next: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentAnswerCursor',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                required: ['text'],
              },
              AgentAnswerCursor: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  invocationId: {
                    type: 'string',
                    minLength: 1,
                  },
                  offset: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                },
                required: ['invocationId', 'offset'],
              },
            },
          },
          resources: {},
        },
        tasks: {
          mode: 'query',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              after: {
                type: ['string', 'null'],
                description:
                  'Opaque continuation for newest accepted tasks first, with stable identity ties.\nThis is live keyset pagination, not a frozen snapshot; pass it unchanged.',
              },
            },
            title: 'WorkHubTasksRead',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          output: {
            type: 'object',
            additionalProperties: false,
            properties: {
              entries: {
                type: 'array',
                items: {
                  $ref: '#/$defs/WorkHubTaskEntry',
                },
                maxItems: 16,
              },
              after: {
                type: ['string', 'null'],
                description:
                  'Opaque live continuation in accepted-time descending order. Null ends the page sequence.',
              },
            },
            required: ['entries'],
            title: 'WorkHubTasks',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              WorkHubTaskEntry: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  taskId: {
                    type: 'string',
                  },
                  worker: {
                    type: 'string',
                  },
                  title: {
                    type: 'string',
                  },
                  acceptedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    description: 'Frozen task acceptance time in Unix milliseconds.',
                    maximum: 9007199254740991,
                  },
                },
                required: ['taskId', 'worker', 'title', 'acceptedAt'],
              },
            },
          },
          resources: {},
        },
        watchGraph: {
          mode: 'subscription',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              sessionId: {
                type: 'string',
                minLength: 1,
              },
              graphId: {
                anyOf: [
                  {
                    $ref: '#/$defs/GraphId',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              after: {
                anyOf: [
                  {
                    $ref: '#/$defs/WorkId',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
            },
            required: ['sessionId'],
            title: 'WorkHubGraphRead',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              GraphId: {
                type: 'string',
                minLength: 1,
              },
              WorkId: {
                type: 'string',
                minLength: 1,
              },
            },
          },
          output: {
            type: 'object',
            additionalProperties: false,
            properties: {
              enabled: {
                type: 'boolean',
              },
              currentEpoch: {
                anyOf: [
                  {
                    $ref: '#/$defs/GraphEpoch',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              selectedMode: {
                anyOf: [
                  {
                    $ref: '#/$defs/GraphMode',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              epoch: {
                anyOf: [
                  {
                    $ref: '#/$defs/GraphEpoch',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              revision: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
              status: {
                $ref: '#/$defs/GraphStatus',
              },
              quiescent: {
                type: 'boolean',
              },
              work: {
                type: 'array',
                items: {
                  $ref: '#/$defs/WorkHubGraphWork',
                },
                maxItems: 16,
              },
              after: {
                anyOf: [
                  {
                    $ref: '#/$defs/WorkId',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              finish: {
                anyOf: [
                  {
                    $ref: '#/$defs/GraphFinish',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
            },
            required: ['enabled', 'revision', 'status', 'quiescent', 'work'],
            title: 'WorkHubGraphView',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              GraphEpoch: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  rootSessionId: {
                    type: 'string',
                  },
                  epoch: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  graphId: {
                    $ref: '#/$defs/GraphId',
                  },
                  createdAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  mode: {
                    $ref: '#/$defs/GraphMode',
                  },
                },
                required: ['rootSessionId', 'epoch', 'graphId', 'createdAt', 'mode'],
              },
              GraphId: {
                type: 'string',
                minLength: 1,
              },
              GraphMode: {
                type: 'string',
                enum: ['graph', 'swarm'],
              },
              GraphStatus: {
                type: 'string',
                enum: ['empty', 'active', 'waiting', 'closing', 'stopped', 'completed', 'failed'],
              },
              WorkHubGraphWork: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  workId: {
                    $ref: '#/$defs/WorkId',
                  },
                  taskId: {
                    type: 'string',
                  },
                  target: {
                    $ref: '#/$defs/GraphTarget',
                  },
                  status: {
                    $ref: '#/$defs/GraphWorkState',
                  },
                  instructionExcerpt: {
                    type: 'string',
                  },
                  instructionTruncated: {
                    type: 'boolean',
                  },
                  resultId: {
                    type: ['string', 'null'],
                  },
                  failure: {
                    type: ['string', 'null'],
                  },
                },
                required: [
                  'workId',
                  'taskId',
                  'target',
                  'status',
                  'instructionExcerpt',
                  'instructionTruncated',
                ],
              },
              WorkId: {
                type: 'string',
                minLength: 1,
              },
              GraphTarget: {
                oneOf: [
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      agentId: {
                        type: 'string',
                        minLength: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'agent',
                      },
                    },
                    required: ['kind', 'agentId'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      presetId: {
                        type: 'string',
                        minLength: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'preset',
                      },
                    },
                    required: ['kind', 'presetId'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      executorId: {
                        type: 'string',
                        minLength: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'executor',
                      },
                    },
                    required: ['kind', 'executorId'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      operatorId: {
                        $ref: '#/$defs/OperatorId',
                      },
                      kind: {
                        type: 'string',
                        const: 'operator',
                      },
                    },
                    required: ['kind', 'operatorId'],
                  },
                ],
              },
              OperatorId: {
                type: 'string',
                minLength: 1,
              },
              GraphWorkState: {
                type: 'string',
                enum: [
                  'requested',
                  'waiting',
                  'running',
                  'blocked',
                  'completed',
                  'failed',
                  'cancelled',
                  'stopped',
                  'superseded',
                ],
              },
              GraphFinish: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  resultIds: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  reason: {
                    type: 'string',
                  },
                },
                required: ['resultIds', 'reason'],
              },
            },
          },
          resources: {},
        },
        watchTask: {
          mode: 'subscription',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              taskId: {
                type: 'string',
                pattern: '^wt_[a-f0-9]{64}$',
              },
              cursor: {
                anyOf: [
                  {
                    $ref: '#/$defs/AgentAnswerCursor',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
            },
            required: ['taskId'],
            title: 'WorkHubTaskRead',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              AgentAnswerCursor: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  invocationId: {
                    type: 'string',
                    minLength: 1,
                  },
                  offset: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                },
                required: ['invocationId', 'offset'],
              },
            },
          },
          output: {
            type: 'object',
            additionalProperties: false,
            properties: {
              dependencies: {
                type: 'array',
                items: {
                  type: 'string',
                },
              },
              taskId: {
                type: 'string',
              },
              worker: {
                type: 'string',
              },
              title: {
                type: 'string',
              },
              acceptedAt: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
                description: 'Frozen task acceptance time in Unix milliseconds.',
                maximum: 9007199254740991,
              },
              operation: {
                type: 'string',
                format: 'uuid',
              },
              status: {
                $ref: '#/$defs/WorkHubTaskStatus',
              },
            },
            required: ['taskId', 'worker', 'title', 'acceptedAt', 'operation', 'status'],
            title: 'WorkHubTask',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              WorkHubTaskStatus: {
                oneOf: [
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      dependencies: {
                        type: 'array',
                        items: {
                          type: 'string',
                        },
                      },
                      kind: {
                        type: 'string',
                        const: 'blocked',
                      },
                    },
                    required: ['kind', 'dependencies'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'cancelled',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      stage: {
                        $ref: '#/$defs/WorkHubPreparationStage',
                      },
                      operation: {
                        type: 'string',
                        format: 'uuid',
                      },
                      sessionId: {
                        type: ['string', 'null'],
                      },
                      state: {
                        $ref: '#/$defs/WorkHubPreparationState',
                      },
                      kind: {
                        type: 'string',
                        const: 'preparing',
                      },
                    },
                    required: ['kind', 'stage', 'operation', 'state'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'pending',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'uncertain',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'unavailable',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      reason: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'rejected',
                      },
                    },
                    required: ['kind', 'reason'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      sessionId: {
                        type: 'string',
                      },
                      invocationId: {
                        type: 'string',
                      },
                      progress: {
                        anyOf: [
                          {
                            $ref: '#/$defs/AgentWork',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'started',
                      },
                    },
                    required: ['kind', 'sessionId', 'invocationId'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      sessionId: {
                        type: 'string',
                      },
                      messageId: {
                        type: 'string',
                      },
                      progress: {
                        anyOf: [
                          {
                            $ref: '#/$defs/AgentWork',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'queued',
                      },
                    },
                    required: ['kind', 'sessionId', 'messageId'],
                  },
                ],
              },
              WorkHubPreparationStage: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'create',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      index: {
                        type: 'integer',
                        format: 'uint',
                        minimum: 0,
                      },
                      total: {
                        type: 'integer',
                        format: 'uint',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'attachment',
                      },
                    },
                    required: ['kind', 'index', 'total'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'delivery',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                ],
              },
              WorkHubPreparationState: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'pending',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'unavailable',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'uncertain',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'original_capture_required',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                    description:
                      'The original resource-bearing call can only be observed, never recaptured.',
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      reason: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'rejected',
                      },
                    },
                    required: ['kind', 'reason'],
                  },
                ],
              },
              AgentWork: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'missing',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'pending',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'cancelled',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'changed',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      shared: {
                        type: 'boolean',
                      },
                      execution: {
                        $ref: '#/$defs/AgentExecution',
                      },
                      answer: {
                        anyOf: [
                          {
                            $ref: '#/$defs/AgentAnswerPage',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      pendingInteractions: {
                        type: 'integer',
                        format: 'uint32',
                        minimum: 0,
                        description:
                          'Count for this exact Run; original Session interactions retain all authority.',
                      },
                      kind: {
                        type: 'string',
                        const: 'delivered',
                      },
                    },
                    required: ['kind', 'shared', 'execution', 'pendingInteractions'],
                  },
                ],
              },
              AgentExecution: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  turnId: {
                    type: 'string',
                  },
                  runId: {
                    type: 'string',
                  },
                  invocationId: {
                    type: 'string',
                  },
                  highWater: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    description: 'Run-local event count, not the root-global transcript cursor.',
                  },
                  state: {
                    $ref: '#/$defs/AgentExecutionState',
                  },
                },
                required: ['sessionId', 'turnId', 'runId', 'invocationId', 'highWater', 'state'],
                description:
                  'Canonical physical execution receipt, independent of the current Session tip.',
              },
              AgentExecutionState: {
                type: 'string',
                enum: [
                  'admitted',
                  'running',
                  'waiting',
                  'paused',
                  'completed',
                  'failed',
                  'cancelled',
                ],
              },
              AgentAnswerPage: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  text: {
                    type: 'string',
                  },
                  next: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentAnswerCursor',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                required: ['text'],
              },
              AgentAnswerCursor: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  invocationId: {
                    type: 'string',
                    minLength: 1,
                  },
                  offset: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                },
                required: ['invocationId', 'offset'],
              },
            },
          },
          resources: {},
        },
        watchTasks: {
          mode: 'subscription',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              after: {
                type: ['string', 'null'],
                description:
                  'Opaque continuation for newest accepted tasks first, with stable identity ties.\nThis is live keyset pagination, not a frozen snapshot; pass it unchanged.',
              },
            },
            title: 'WorkHubTasksRead',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          output: {
            type: 'object',
            additionalProperties: false,
            properties: {
              entries: {
                type: 'array',
                items: {
                  $ref: '#/$defs/WorkHubTaskEntry',
                },
                maxItems: 16,
              },
              after: {
                type: ['string', 'null'],
                description:
                  'Opaque live continuation in accepted-time descending order. Null ends the page sequence.',
              },
            },
            required: ['entries'],
            title: 'WorkHubTasks',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              WorkHubTaskEntry: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  taskId: {
                    type: 'string',
                  },
                  worker: {
                    type: 'string',
                  },
                  title: {
                    type: 'string',
                  },
                  acceptedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    description: 'Frozen task acceptance time in Unix milliseconds.',
                    maximum: 9007199254740991,
                  },
                },
                required: ['taskId', 'worker', 'title', 'acceptedAt'],
              },
            },
          },
          resources: {},
        },
      },
    },
  },
  questions: {
    name: 'maka.interactions.Questions',
    version: 1,
    transport: 'remote',
    interface: {
      kind: 'service',
      methods: {
        ask: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              questions: {
                type: 'array',
                items: {
                  $ref: '#/$defs/InteractionQuestion',
                },
                minItems: 1,
                maxItems: 3,
              },
            },
            required: ['questions'],
            title: 'QuestionAsk',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              InteractionQuestion: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  question: {
                    type: 'string',
                    minLength: 1,
                  },
                  options: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/QuestionOption',
                    },
                    minItems: 2,
                    maxItems: 3,
                  },
                },
                required: ['question', 'options'],
              },
              QuestionOption: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  label: {
                    type: 'string',
                    minLength: 1,
                  },
                  description: {
                    type: 'string',
                    minLength: 1,
                  },
                },
                required: ['label'],
              },
            },
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  answers: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/QuestionResponse',
                    },
                  },
                  kind: {
                    type: 'string',
                    const: 'answered',
                  },
                },
                required: ['kind', 'answers'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  reason: {
                    $ref: '#/$defs/ClosureReason',
                  },
                  kind: {
                    type: 'string',
                    const: 'closed',
                  },
                },
                required: ['kind', 'reason'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  reason: {
                    $ref: '#/$defs/QuestionRejection',
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                required: ['kind', 'reason'],
              },
            ],
            title: 'QuestionResult',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              QuestionResponse: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  question: {
                    type: 'string',
                  },
                  answer: {
                    type: ['string', 'null'],
                  },
                },
                required: ['question', 'answer'],
              },
              ClosureReason: {
                type: 'string',
                enum: [
                  'turn_stopped',
                  'turn_terminal',
                  'producer_cancelled',
                  'timed_out',
                  'host_restarted',
                  'provider_disconnected',
                ],
              },
              QuestionRejection: {
                type: 'string',
                enum: ['invalid_input', 'unavailable'],
              },
            },
          },
          resources: {},
        },
      },
    },
  },
  forms: {
    name: 'maka.interactions.Forms',
    version: 1,
    transport: 'remote',
    interface: {
      kind: 'service',
      methods: {
        ask: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              message: {
                type: 'string',
                minLength: 1,
              },
              fields: {
                type: 'array',
                items: {
                  $ref: '#/$defs/FormField',
                },
              },
            },
            required: ['message', 'fields'],
            title: 'FormAsk',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              FormField: {
                type: 'object',
                properties: {
                  name: {
                    type: 'string',
                  },
                  label: {
                    type: 'string',
                  },
                  required: {
                    type: 'boolean',
                  },
                  description: {
                    type: ['string', 'null'],
                  },
                },
                required: ['name', 'label', 'required'],
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      default: {
                        type: ['string', 'null'],
                      },
                      minLength: {
                        type: ['integer', 'null'],
                        format: 'uint',
                        minimum: 0,
                      },
                      maxLength: {
                        type: ['integer', 'null'],
                        format: 'uint',
                        minimum: 0,
                      },
                      format: {
                        anyOf: [
                          {
                            $ref: '#/$defs/FormFormat',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'string',
                      },
                    },
                    required: ['kind'],
                  },
                  {
                    type: 'object',
                    properties: {
                      default: {
                        type: ['number', 'null'],
                        format: 'double',
                      },
                      minimum: {
                        type: ['number', 'null'],
                        format: 'double',
                      },
                      maximum: {
                        type: ['number', 'null'],
                        format: 'double',
                      },
                      kind: {
                        type: 'string',
                        const: 'number',
                      },
                    },
                    required: ['kind'],
                  },
                  {
                    type: 'object',
                    properties: {
                      default: {
                        type: ['number', 'null'],
                        format: 'double',
                      },
                      minimum: {
                        type: ['number', 'null'],
                        format: 'double',
                      },
                      maximum: {
                        type: ['number', 'null'],
                        format: 'double',
                      },
                      kind: {
                        type: 'string',
                        const: 'integer',
                      },
                    },
                    required: ['kind'],
                  },
                  {
                    type: 'object',
                    properties: {
                      default: {
                        type: ['boolean', 'null'],
                      },
                      kind: {
                        type: 'string',
                        const: 'boolean',
                      },
                    },
                    required: ['kind'],
                  },
                  {
                    type: 'object',
                    properties: {
                      options: {
                        type: 'array',
                        items: {
                          $ref: '#/$defs/FormOption',
                        },
                      },
                      default: {
                        type: ['string', 'null'],
                      },
                      kind: {
                        type: 'string',
                        const: 'single_select',
                      },
                    },
                    required: ['kind', 'options'],
                  },
                  {
                    type: 'object',
                    properties: {
                      options: {
                        type: 'array',
                        items: {
                          $ref: '#/$defs/FormOption',
                        },
                      },
                      default: {
                        type: ['array', 'null'],
                        items: {
                          type: 'string',
                        },
                      },
                      minItems: {
                        type: ['integer', 'null'],
                        format: 'uint',
                        minimum: 0,
                      },
                      maxItems: {
                        type: ['integer', 'null'],
                        format: 'uint',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'multi_select',
                      },
                    },
                    required: ['kind', 'options'],
                  },
                ],
              },
              FormFormat: {
                type: 'string',
                enum: ['email', 'uri', 'date', 'date-time'],
              },
              FormOption: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  value: {
                    type: 'string',
                  },
                  label: {
                    type: 'string',
                  },
                },
                required: ['value', 'label'],
              },
            },
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  result: {
                    $ref: '#/$defs/FormResult',
                  },
                  kind: {
                    type: 'string',
                    const: 'answered',
                  },
                },
                required: ['kind', 'result'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  reason: {
                    $ref: '#/$defs/ClosureReason',
                  },
                  kind: {
                    type: 'string',
                    const: 'closed',
                  },
                },
                required: ['kind', 'reason'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  reason: {
                    $ref: '#/$defs/QuestionRejection',
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                required: ['kind', 'reason'],
              },
            ],
            title: 'FormResponse',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              FormResult: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      values: {
                        type: 'object',
                        additionalProperties: {
                          $ref: '#/$defs/FormValue',
                        },
                      },
                      action: {
                        type: 'string',
                        const: 'accept',
                      },
                    },
                    required: ['action', 'values'],
                  },
                  {
                    type: 'object',
                    properties: {
                      action: {
                        type: 'string',
                        const: 'decline',
                      },
                    },
                    required: ['action'],
                  },
                  {
                    type: 'object',
                    properties: {
                      action: {
                        type: 'string',
                        const: 'cancel',
                      },
                    },
                    required: ['action'],
                  },
                ],
              },
              FormValue: {
                anyOf: [
                  {
                    type: 'string',
                  },
                  {
                    type: 'number',
                    format: 'double',
                  },
                  {
                    type: 'boolean',
                  },
                  {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                ],
              },
              ClosureReason: {
                type: 'string',
                enum: [
                  'turn_stopped',
                  'turn_terminal',
                  'producer_cancelled',
                  'timed_out',
                  'host_restarted',
                  'provider_disconnected',
                ],
              },
              QuestionRejection: {
                type: 'string',
                enum: ['invalid_input', 'unavailable'],
              },
            },
          },
          resources: {},
        },
      },
    },
  },
  skillLibrary: {
    name: 'maka.skills.Library',
    version: 1,
    transport: 'remote',
    interface: {
      kind: 'service',
      methods: {
        apply: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              change: {
                $ref: '#/$defs/SkillLibraryChange',
              },
              digest: {
                type: 'string',
                minLength: 71,
                maxLength: 71,
              },
            },
            required: ['change', 'digest'],
            title: 'SkillLibraryReview',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              SkillLibraryChange: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  workspace: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentWorkspace',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  kind: {
                    $ref: '#/$defs/SkillLibraryChangeKind',
                  },
                  reference: {
                    type: 'string',
                    minLength: 1,
                  },
                  revision: {
                    type: 'string',
                    minLength: 1,
                  },
                },
                required: ['kind', 'reference', 'revision'],
              },
              AgentWorkspace: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  worktree: {
                    anyOf: [
                      {
                        $ref: '#/$defs/Binding',
                      },
                      {
                        type: 'null',
                      },
                    ],
                    description:
                      'Native owner allocation; never accepted from a caller as workspace authority.',
                  },
                  projectId: {
                    type: ['string', 'null'],
                    format: 'uuid',
                    description: "Optional membership in this Agent's canonical Project catalog.",
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  identity: {
                    type: 'string',
                    pattern: '^workspace:v1:[A-Fa-f0-9-]{36}$',
                  },
                },
                required: ['path', 'directoryIdentity', 'identity'],
              },
              Binding: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  id: {
                    type: 'string',
                  },
                  common_dir: {
                    type: 'string',
                  },
                  source: {
                    type: 'string',
                  },
                  source_identity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  base_commit: {
                    type: 'string',
                  },
                  directory: {
                    type: 'string',
                  },
                },
                required: [
                  'id',
                  'common_dir',
                  'source',
                  'source_identity',
                  'base_commit',
                  'directory',
                ],
                description: 'Immutable allocation intent, not the current child branch or HEAD.',
              },
              SkillLibraryChangeKind: {
                type: 'string',
                enum: ['install', 'update', 'delete'],
              },
            },
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  reference: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'applied',
                  },
                },
                required: ['kind', 'reference'],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'changed',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  reason: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                required: ['kind', 'reason'],
              },
            ],
            title: 'SkillLibraryChangeResult',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          resources: {},
        },
        deleteSource: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              change: {
                $ref: '#/$defs/SkillLibraryChange',
              },
              digest: {
                type: 'string',
                minLength: 71,
                maxLength: 71,
              },
            },
            required: ['change', 'digest'],
            title: 'SkillLibraryReview',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              SkillLibraryChange: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  workspace: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentWorkspace',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  kind: {
                    $ref: '#/$defs/SkillLibraryChangeKind',
                  },
                  reference: {
                    type: 'string',
                    minLength: 1,
                  },
                  revision: {
                    type: 'string',
                    minLength: 1,
                  },
                },
                required: ['kind', 'reference', 'revision'],
              },
              AgentWorkspace: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  worktree: {
                    anyOf: [
                      {
                        $ref: '#/$defs/Binding',
                      },
                      {
                        type: 'null',
                      },
                    ],
                    description:
                      'Native owner allocation; never accepted from a caller as workspace authority.',
                  },
                  projectId: {
                    type: ['string', 'null'],
                    format: 'uuid',
                    description: "Optional membership in this Agent's canonical Project catalog.",
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  identity: {
                    type: 'string',
                    pattern: '^workspace:v1:[A-Fa-f0-9-]{36}$',
                  },
                },
                required: ['path', 'directoryIdentity', 'identity'],
              },
              Binding: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  id: {
                    type: 'string',
                  },
                  common_dir: {
                    type: 'string',
                  },
                  source: {
                    type: 'string',
                  },
                  source_identity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  base_commit: {
                    type: 'string',
                  },
                  directory: {
                    type: 'string',
                  },
                },
                required: [
                  'id',
                  'common_dir',
                  'source',
                  'source_identity',
                  'base_commit',
                  'directory',
                ],
                description: 'Immutable allocation intent, not the current child branch or HEAD.',
              },
              SkillLibraryChangeKind: {
                type: 'string',
                enum: ['install', 'update', 'delete'],
              },
            },
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  reference: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'applied',
                  },
                },
                required: ['kind', 'reference'],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'changed',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  reason: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                required: ['kind', 'reason'],
              },
            ],
            title: 'SkillLibraryChangeResult',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          resources: {},
        },
        importSource: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              bytes: {
                type: 'integer',
                format: 'uint',
                minimum: 1,
              },
              digest: {
                type: 'string',
                minLength: 71,
                maxLength: 71,
              },
            },
            required: ['bytes', 'digest'],
            title: 'SkillLibraryImportSource',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  reference: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'applied',
                  },
                },
                required: ['kind', 'reference'],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'changed',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  reason: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                required: ['kind', 'reason'],
              },
            ],
            title: 'SkillLibraryChangeResult',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          resources: {
            file: {
              type: {
                name: 'maka.bytes',
                version: 1,
              },
              optional: false,
            },
            id: {
              type: {
                name: 'maka.text.utf8',
                version: 1,
              },
              optional: false,
            },
          },
        },
        list: {
          mode: 'query',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              workspace: {
                anyOf: [
                  {
                    $ref: '#/$defs/AgentWorkspace',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              query: {
                type: 'string',
              },
              cursor: {
                anyOf: [
                  {
                    $ref: '#/$defs/SkillLibraryCursor',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
            },
            required: ['query'],
            title: 'SkillLibraryList',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              AgentWorkspace: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  worktree: {
                    anyOf: [
                      {
                        $ref: '#/$defs/Binding',
                      },
                      {
                        type: 'null',
                      },
                    ],
                    description:
                      'Native owner allocation; never accepted from a caller as workspace authority.',
                  },
                  projectId: {
                    type: ['string', 'null'],
                    format: 'uuid',
                    description: "Optional membership in this Agent's canonical Project catalog.",
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  identity: {
                    type: 'string',
                    pattern: '^workspace:v1:[A-Fa-f0-9-]{36}$',
                  },
                },
                required: ['path', 'directoryIdentity', 'identity'],
              },
              Binding: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  id: {
                    type: 'string',
                  },
                  common_dir: {
                    type: 'string',
                  },
                  source: {
                    type: 'string',
                  },
                  source_identity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  base_commit: {
                    type: 'string',
                  },
                  directory: {
                    type: 'string',
                  },
                },
                required: [
                  'id',
                  'common_dir',
                  'source',
                  'source_identity',
                  'base_commit',
                  'directory',
                ],
                description: 'Immutable allocation intent, not the current child branch or HEAD.',
              },
              SkillLibraryCursor: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  revision: {
                    type: 'string',
                    minLength: 1,
                  },
                  query: {
                    type: 'string',
                  },
                  offset: {
                    type: 'integer',
                    format: 'uint',
                    minimum: 0,
                  },
                },
                required: ['revision', 'query', 'offset'],
              },
            },
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  writable: {
                    type: 'boolean',
                  },
                  preferencesWritable: {
                    type: 'boolean',
                  },
                  preferenceRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  revision: {
                    type: 'string',
                  },
                  entries: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/SkillLibraryEntry',
                    },
                  },
                  after: {
                    anyOf: [
                      {
                        $ref: '#/$defs/SkillLibraryCursor',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  diagnostics: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  kind: {
                    type: 'string',
                    const: 'page',
                  },
                },
                required: [
                  'kind',
                  'writable',
                  'preferencesWritable',
                  'preferenceRevision',
                  'revision',
                  'entries',
                  'diagnostics',
                ],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'changed',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
            ],
            title: 'SkillLibraryPage',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              SkillLibraryEntry: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  bundled: {
                    type: 'boolean',
                  },
                  installed: {
                    type: 'boolean',
                  },
                  imported: {
                    type: 'boolean',
                    description:
                      'Imported authoring source; unavailable to the model until explicitly installed.',
                  },
                  preference: {
                    $ref: '#/$defs/SkillPreference',
                  },
                  reference: {
                    type: 'string',
                  },
                  source: {
                    type: 'string',
                  },
                  name: {
                    type: 'string',
                  },
                  description: {
                    type: 'string',
                  },
                  valid: {
                    type: 'boolean',
                  },
                  shadowedBy: {
                    type: ['string', 'null'],
                  },
                  metadataTruncated: {
                    type: 'boolean',
                  },
                  issues: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                },
                required: [
                  'bundled',
                  'installed',
                  'imported',
                  'preference',
                  'reference',
                  'source',
                  'name',
                  'description',
                  'valid',
                  'metadataTruncated',
                  'issues',
                ],
              },
              SkillPreference: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  enabled: {
                    type: 'boolean',
                  },
                  pinned: {
                    type: 'boolean',
                  },
                },
                required: ['enabled', 'pinned'],
              },
              SkillLibraryCursor: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  revision: {
                    type: 'string',
                    minLength: 1,
                  },
                  query: {
                    type: 'string',
                  },
                  offset: {
                    type: 'integer',
                    format: 'uint',
                    minimum: 0,
                  },
                },
                required: ['revision', 'query', 'offset'],
              },
            },
          },
          resources: {},
        },
        load: {
          mode: 'query',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              workspace: {
                anyOf: [
                  {
                    $ref: '#/$defs/AgentWorkspace',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              tools: {
                type: 'array',
                items: {
                  type: 'string',
                },
              },
              input: {
                $ref: '#/$defs/SkillModelLoad',
              },
            },
            required: ['tools', 'input'],
            description:
              'Actual Agent registrations are supplied outside model-controlled arguments.\nThese names describe compatibility and confer no execution authority.',
            title: 'SkillToolRequest',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              AgentWorkspace: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  worktree: {
                    anyOf: [
                      {
                        $ref: '#/$defs/Binding',
                      },
                      {
                        type: 'null',
                      },
                    ],
                    description:
                      'Native owner allocation; never accepted from a caller as workspace authority.',
                  },
                  projectId: {
                    type: ['string', 'null'],
                    format: 'uuid',
                    description: "Optional membership in this Agent's canonical Project catalog.",
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  identity: {
                    type: 'string',
                    pattern: '^workspace:v1:[A-Fa-f0-9-]{36}$',
                  },
                },
                required: ['path', 'directoryIdentity', 'identity'],
              },
              Binding: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  id: {
                    type: 'string',
                  },
                  common_dir: {
                    type: 'string',
                  },
                  source: {
                    type: 'string',
                  },
                  source_identity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  base_commit: {
                    type: 'string',
                  },
                  directory: {
                    type: 'string',
                  },
                },
                required: [
                  'id',
                  'common_dir',
                  'source',
                  'source_identity',
                  'base_commit',
                  'directory',
                ],
                description: 'Immutable allocation intent, not the current child branch or HEAD.',
              },
              SkillModelLoad: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  name: {
                    type: 'string',
                    description:
                      'Exact ref from search, or a skill id/name resolved before eligibility checks.',
                    minLength: 1,
                  },
                  revision: {
                    type: 'string',
                    description:
                      'Catalog revision from search or a previous load/resource response.',
                    minLength: 1,
                  },
                  resource: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ReadInput',
                      },
                      {
                        type: 'null',
                      },
                    ],
                    description:
                      'UTF-8 resource path relative to this skill, or its exact continuation.',
                  },
                  instructionOffset: {
                    type: ['integer', 'null'],
                    format: 'uint',
                    minimum: 0,
                    description:
                      'UTF-8 byte offset from a returned instruction continuation; omit initially.',
                  },
                },
                required: ['name', 'revision'],
              },
              ReadInput: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                  offset: {
                    type: 'integer',
                    format: 'uint',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                  limit: {
                    type: 'integer',
                    format: 'uint',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                },
                required: ['path'],
              },
            },
          },
          output: {
            oneOf: [
              {
                type: 'object',
                properties: {
                  revision: {
                    type: 'string',
                  },
                  metadata: {
                    $ref: '#/$defs/SkillMetadata',
                  },
                  instructions: {
                    type: 'string',
                  },
                  instructionOffset: {
                    type: 'integer',
                    format: 'uint',
                    minimum: 0,
                  },
                  next: {
                    anyOf: [
                      {
                        $ref: '#/$defs/SkillModelLoad',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  relativePath: {
                    type: 'string',
                  },
                  declaredTools: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  declaredToolsTruncated: {
                    type: 'boolean',
                  },
                  truncated: {
                    type: 'boolean',
                  },
                  receipt: {
                    $ref: '#/$defs/SkillInvocationReceipt',
                  },
                  kind: {
                    type: 'string',
                    const: 'loaded',
                  },
                },
                required: [
                  'kind',
                  'revision',
                  'metadata',
                  'instructions',
                  'instructionOffset',
                  'relativePath',
                  'declaredTools',
                  'declaredToolsTruncated',
                  'truncated',
                  'receipt',
                ],
                description:
                  'User-provided, lower-priority instructions. Declared tools are hints, not grants.',
              },
              {
                type: 'object',
                properties: {
                  revision: {
                    type: 'string',
                  },
                  reference: {
                    type: 'string',
                  },
                  path: {
                    type: 'string',
                  },
                  content: {
                    type: 'string',
                  },
                  offset: {
                    type: 'integer',
                    format: 'uint',
                    minimum: 0,
                  },
                  returnedLines: {
                    type: 'integer',
                    format: 'uint',
                    minimum: 0,
                  },
                  totalLines: {
                    type: 'integer',
                    format: 'uint',
                    minimum: 0,
                  },
                  partialLine: {
                    type: 'boolean',
                  },
                  next: {
                    anyOf: [
                      {
                        $ref: '#/$defs/SkillModelLoad',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  receipt: {
                    $ref: '#/$defs/SkillInvocationReceipt',
                  },
                  kind: {
                    type: 'string',
                    const: 'resource',
                  },
                },
                required: [
                  'kind',
                  'revision',
                  'reference',
                  'path',
                  'content',
                  'offset',
                  'returnedLines',
                  'totalLines',
                  'partialLine',
                  'receipt',
                ],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'changed',
                  },
                },
                required: ['kind'],
              },
              {
                type: 'object',
                properties: {
                  reason: {
                    $ref: '#/$defs/SkillFailureReason',
                  },
                  receipt: {
                    $ref: '#/$defs/SkillInvocationReceipt',
                  },
                  kind: {
                    type: 'string',
                    const: 'unavailable',
                  },
                },
                required: ['kind', 'reason', 'receipt'],
              },
              {
                type: 'object',
                properties: {
                  reason: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'resource_unavailable',
                  },
                },
                required: ['kind', 'reason'],
              },
            ],
            title: 'SkillModelLoadResult',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              SkillMetadata: {
                type: 'object',
                properties: {
                  ref: {
                    type: 'string',
                  },
                  id: {
                    type: 'string',
                  },
                  name: {
                    type: 'string',
                  },
                  description: {
                    type: 'string',
                  },
                  scope: {
                    $ref: '#/$defs/SkillScope',
                  },
                  source: {
                    $ref: '#/$defs/SkillSource',
                  },
                  metadataTruncated: {
                    type: 'boolean',
                  },
                },
                required: [
                  'ref',
                  'id',
                  'name',
                  'description',
                  'scope',
                  'source',
                  'metadataTruncated',
                ],
              },
              SkillScope: {
                type: 'string',
                enum: ['project', 'workspace', 'user', 'custom'],
              },
              SkillSource: {
                type: 'string',
                enum: ['maka', 'agents', 'legacy', 'custom'],
              },
              SkillModelLoad: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  name: {
                    type: 'string',
                    description:
                      'Exact ref from search, or a skill id/name resolved before eligibility checks.',
                    minLength: 1,
                  },
                  revision: {
                    type: 'string',
                    description:
                      'Catalog revision from search or a previous load/resource response.',
                    minLength: 1,
                  },
                  resource: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ReadInput',
                      },
                      {
                        type: 'null',
                      },
                    ],
                    description:
                      'UTF-8 resource path relative to this skill, or its exact continuation.',
                  },
                  instructionOffset: {
                    type: ['integer', 'null'],
                    format: 'uint',
                    minimum: 0,
                    description:
                      'UTF-8 byte offset from a returned instruction continuation; omit initially.',
                  },
                },
                required: ['name', 'revision'],
              },
              ReadInput: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                  offset: {
                    type: 'integer',
                    format: 'uint',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                  limit: {
                    type: 'integer',
                    format: 'uint',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                },
                required: ['path'],
              },
              SkillInvocationReceipt: {
                anyOf: [
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      invocation: {
                        $ref: '#/$defs/SkillInvocationMode',
                      },
                      request: {
                        type: 'string',
                      },
                      success: {
                        const: true,
                      },
                      ref: {
                        type: 'string',
                      },
                      id: {
                        type: 'string',
                      },
                      name: {
                        type: 'string',
                      },
                      scope: {
                        $ref: '#/$defs/SkillScope',
                      },
                      source: {
                        $ref: '#/$defs/SkillSource',
                      },
                      truncated: {
                        type: 'boolean',
                      },
                    },
                    required: [
                      'invocation',
                      'request',
                      'success',
                      'ref',
                      'id',
                      'name',
                      'scope',
                      'source',
                      'truncated',
                    ],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      invocation: {
                        $ref: '#/$defs/SkillInvocationMode',
                      },
                      request: {
                        type: 'string',
                      },
                      success: {
                        const: false,
                      },
                      reason: {
                        $ref: '#/$defs/SkillFailureReason',
                      },
                    },
                    required: ['invocation', 'request', 'success', 'reason'],
                  },
                ],
                description:
                  'Boolean wire discriminants are validated here, not retained as mutable\nbusiness fields beside a contradictory enum variant.',
              },
              SkillInvocationMode: {
                type: 'string',
                enum: ['explicit', 'model_tool'],
              },
              SkillFailureReason: {
                type: 'string',
                enum: [
                  'invalid_name',
                  'not_found',
                  'disabled',
                  'host_incompatible',
                  'resolution_failed',
                ],
              },
            },
          },
          resources: {},
        },
        prepare: {
          mode: 'query',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              workspace: {
                anyOf: [
                  {
                    $ref: '#/$defs/AgentWorkspace',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              tools: {
                type: 'array',
                items: {
                  type: 'string',
                },
              },
              input: {
                $ref: '#/$defs/SkillPrepare',
              },
            },
            required: ['tools', 'input'],
            description:
              'Actual Agent registrations are supplied outside model-controlled arguments.\nThese names describe compatibility and confer no execution authority.',
            title: 'SkillToolRequest',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              AgentWorkspace: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  worktree: {
                    anyOf: [
                      {
                        $ref: '#/$defs/Binding',
                      },
                      {
                        type: 'null',
                      },
                    ],
                    description:
                      'Native owner allocation; never accepted from a caller as workspace authority.',
                  },
                  projectId: {
                    type: ['string', 'null'],
                    format: 'uuid',
                    description: "Optional membership in this Agent's canonical Project catalog.",
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  identity: {
                    type: 'string',
                    pattern: '^workspace:v1:[A-Fa-f0-9-]{36}$',
                  },
                },
                required: ['path', 'directoryIdentity', 'identity'],
              },
              Binding: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  id: {
                    type: 'string',
                  },
                  common_dir: {
                    type: 'string',
                  },
                  source: {
                    type: 'string',
                  },
                  source_identity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  base_commit: {
                    type: 'string',
                  },
                  directory: {
                    type: 'string',
                  },
                },
                required: [
                  'id',
                  'common_dir',
                  'source',
                  'source_identity',
                  'base_commit',
                  'directory',
                ],
                description: 'Immutable allocation intent, not the current child branch or HEAD.',
              },
              SkillPrepare: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  language: {
                    $ref: '#/$defs/Language',
                  },
                  message: {
                    type: 'string',
                  },
                  loadTool: {
                    type: ['string', 'null'],
                    description:
                      'Actual selected tools bound to this Library; these names grant no access.',
                    minLength: 1,
                  },
                  searchTool: {
                    type: ['string', 'null'],
                    minLength: 1,
                  },
                },
                required: ['language', 'message'],
              },
              Language: {
                type: 'string',
                enum: ['en', 'zh-CN', 'zh-TW'],
              },
            },
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  text: {
                    type: ['string', 'null'],
                    description: 'None preserves the original message exactly.',
                  },
                  record: {
                    $ref: '#/$defs/SkillPreparationRecord',
                  },
                  requiredTools: {
                    type: 'array',
                    uniqueItems: true,
                    items: {
                      type: 'string',
                    },
                  },
                  kind: {
                    type: 'string',
                    const: 'ready',
                  },
                },
                required: ['kind', 'record', 'requiredTools'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  invocation: {
                    $ref: '#/$defs/SkillInvocationResult',
                  },
                  kind: {
                    type: 'string',
                    const: 'blocked',
                  },
                },
                required: ['kind', 'invocation'],
              },
            ],
            title: 'SkillPreparation',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              SkillPreparationRecord: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  revision: {
                    type: 'string',
                  },
                  metadataPrompt: {
                    type: 'string',
                  },
                  invocation: {
                    $ref: '#/$defs/SkillInvocationResult',
                  },
                },
                required: ['revision', 'metadataPrompt', 'invocation'],
              },
              SkillInvocationResult: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  loaded: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/LoadedSkill',
                    },
                  },
                  failed: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/SkillInvocationFailure',
                    },
                  },
                  receipts: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/SkillInvocationReceipt',
                    },
                  },
                },
                required: ['loaded', 'failed', 'receipts'],
              },
              LoadedSkill: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  id: {
                    type: 'string',
                  },
                  name: {
                    type: 'string',
                  },
                },
                required: ['id', 'name'],
              },
              SkillInvocationFailure: {
                anyOf: [
                  {
                    $ref: '#/$defs/SkillRequestFailure',
                  },
                ],
              },
              SkillRequestFailure: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  request: {
                    type: 'string',
                  },
                  reason: {
                    $ref: '#/$defs/SkillFailureReason',
                  },
                },
                required: ['request', 'reason'],
              },
              SkillFailureReason: {
                type: 'string',
                enum: [
                  'invalid_name',
                  'not_found',
                  'disabled',
                  'host_incompatible',
                  'resolution_failed',
                ],
              },
              SkillInvocationReceipt: {
                anyOf: [
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      invocation: {
                        $ref: '#/$defs/SkillInvocationMode',
                      },
                      request: {
                        type: 'string',
                      },
                      success: {
                        const: true,
                      },
                      ref: {
                        type: 'string',
                      },
                      id: {
                        type: 'string',
                      },
                      name: {
                        type: 'string',
                      },
                      scope: {
                        $ref: '#/$defs/SkillScope',
                      },
                      source: {
                        $ref: '#/$defs/SkillSource',
                      },
                      truncated: {
                        type: 'boolean',
                      },
                    },
                    required: [
                      'invocation',
                      'request',
                      'success',
                      'ref',
                      'id',
                      'name',
                      'scope',
                      'source',
                      'truncated',
                    ],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      invocation: {
                        $ref: '#/$defs/SkillInvocationMode',
                      },
                      request: {
                        type: 'string',
                      },
                      success: {
                        const: false,
                      },
                      reason: {
                        $ref: '#/$defs/SkillFailureReason',
                      },
                    },
                    required: ['invocation', 'request', 'success', 'reason'],
                  },
                ],
                description:
                  'Boolean wire discriminants are validated here, not retained as mutable\nbusiness fields beside a contradictory enum variant.',
              },
              SkillInvocationMode: {
                type: 'string',
                enum: ['explicit', 'model_tool'],
              },
              SkillScope: {
                type: 'string',
                enum: ['project', 'workspace', 'user', 'custom'],
              },
              SkillSource: {
                type: 'string',
                enum: ['maka', 'agents', 'legacy', 'custom'],
              },
            },
          },
          resources: {},
        },
        preview: {
          mode: 'query',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              workspace: {
                anyOf: [
                  {
                    $ref: '#/$defs/AgentWorkspace',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              kind: {
                $ref: '#/$defs/SkillLibraryChangeKind',
              },
              reference: {
                type: 'string',
                minLength: 1,
              },
              revision: {
                type: 'string',
                minLength: 1,
              },
            },
            required: ['kind', 'reference', 'revision'],
            title: 'SkillLibraryChange',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              AgentWorkspace: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  worktree: {
                    anyOf: [
                      {
                        $ref: '#/$defs/Binding',
                      },
                      {
                        type: 'null',
                      },
                    ],
                    description:
                      'Native owner allocation; never accepted from a caller as workspace authority.',
                  },
                  projectId: {
                    type: ['string', 'null'],
                    format: 'uuid',
                    description: "Optional membership in this Agent's canonical Project catalog.",
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  identity: {
                    type: 'string',
                    pattern: '^workspace:v1:[A-Fa-f0-9-]{36}$',
                  },
                },
                required: ['path', 'directoryIdentity', 'identity'],
              },
              Binding: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  id: {
                    type: 'string',
                  },
                  common_dir: {
                    type: 'string',
                  },
                  source: {
                    type: 'string',
                  },
                  source_identity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  base_commit: {
                    type: 'string',
                  },
                  directory: {
                    type: 'string',
                  },
                },
                required: [
                  'id',
                  'common_dir',
                  'source',
                  'source_identity',
                  'base_commit',
                  'directory',
                ],
                description: 'Immutable allocation intent, not the current child branch or HEAD.',
              },
              SkillLibraryChangeKind: {
                type: 'string',
                enum: ['install', 'update', 'delete'],
              },
            },
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  review: {
                    $ref: '#/$defs/SkillLibraryReview',
                  },
                  target: {
                    type: 'string',
                  },
                  entries: {
                    type: 'integer',
                    format: 'uint',
                    minimum: 0,
                  },
                  paths: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  pathsTruncated: {
                    type: 'boolean',
                  },
                  locallyModified: {
                    type: 'boolean',
                  },
                  kind: {
                    type: 'string',
                    const: 'ready',
                  },
                },
                required: [
                  'kind',
                  'review',
                  'target',
                  'entries',
                  'paths',
                  'pathsTruncated',
                  'locallyModified',
                ],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'changed',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  reason: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                required: ['kind', 'reason'],
              },
            ],
            title: 'SkillLibraryPreview',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              SkillLibraryReview: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  change: {
                    $ref: '#/$defs/SkillLibraryChange',
                  },
                  digest: {
                    type: 'string',
                    minLength: 71,
                    maxLength: 71,
                  },
                },
                required: ['change', 'digest'],
              },
              SkillLibraryChange: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  workspace: {
                    anyOf: [
                      {
                        $ref: '#/$defs/AgentWorkspace',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  kind: {
                    $ref: '#/$defs/SkillLibraryChangeKind',
                  },
                  reference: {
                    type: 'string',
                    minLength: 1,
                  },
                  revision: {
                    type: 'string',
                    minLength: 1,
                  },
                },
                required: ['kind', 'reference', 'revision'],
              },
              AgentWorkspace: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  worktree: {
                    anyOf: [
                      {
                        $ref: '#/$defs/Binding',
                      },
                      {
                        type: 'null',
                      },
                    ],
                    description:
                      'Native owner allocation; never accepted from a caller as workspace authority.',
                  },
                  projectId: {
                    type: ['string', 'null'],
                    format: 'uuid',
                    description: "Optional membership in this Agent's canonical Project catalog.",
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  identity: {
                    type: 'string',
                    pattern: '^workspace:v1:[A-Fa-f0-9-]{36}$',
                  },
                },
                required: ['path', 'directoryIdentity', 'identity'],
              },
              Binding: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  id: {
                    type: 'string',
                  },
                  common_dir: {
                    type: 'string',
                  },
                  source: {
                    type: 'string',
                  },
                  source_identity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  base_commit: {
                    type: 'string',
                  },
                  directory: {
                    type: 'string',
                  },
                },
                required: [
                  'id',
                  'common_dir',
                  'source',
                  'source_identity',
                  'base_commit',
                  'directory',
                ],
                description: 'Immutable allocation intent, not the current child branch or HEAD.',
              },
              SkillLibraryChangeKind: {
                type: 'string',
                enum: ['install', 'update', 'delete'],
              },
            },
          },
          resources: {},
        },
        read: {
          mode: 'query',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              workspace: {
                anyOf: [
                  {
                    $ref: '#/$defs/AgentWorkspace',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              reference: {
                type: 'string',
                minLength: 1,
              },
              revision: {
                type: 'string',
                description: 'Complete catalog revision from the list/read response.',
                minLength: 1,
              },
              offset: {
                type: 'integer',
                format: 'uint',
                minimum: 0,
              },
            },
            required: ['reference', 'revision', 'offset'],
            title: 'SkillLibraryRead',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              AgentWorkspace: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  worktree: {
                    anyOf: [
                      {
                        $ref: '#/$defs/Binding',
                      },
                      {
                        type: 'null',
                      },
                    ],
                    description:
                      'Native owner allocation; never accepted from a caller as workspace authority.',
                  },
                  projectId: {
                    type: ['string', 'null'],
                    format: 'uuid',
                    description: "Optional membership in this Agent's canonical Project catalog.",
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  identity: {
                    type: 'string',
                    pattern: '^workspace:v1:[A-Fa-f0-9-]{36}$',
                  },
                },
                required: ['path', 'directoryIdentity', 'identity'],
              },
              Binding: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  id: {
                    type: 'string',
                  },
                  common_dir: {
                    type: 'string',
                  },
                  source: {
                    type: 'string',
                  },
                  source_identity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  base_commit: {
                    type: 'string',
                  },
                  directory: {
                    type: 'string',
                  },
                },
                required: [
                  'id',
                  'common_dir',
                  'source',
                  'source_identity',
                  'base_commit',
                  'directory',
                ],
                description: 'Immutable allocation intent, not the current child branch or HEAD.',
              },
            },
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  writable: {
                    type: 'boolean',
                  },
                  preferencesWritable: {
                    type: 'boolean',
                  },
                  preferenceRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  entry: {
                    $ref: '#/$defs/SkillLibraryEntry',
                  },
                  revision: {
                    type: 'string',
                  },
                  text: {
                    type: 'string',
                  },
                  offset: {
                    type: 'integer',
                    format: 'uint',
                    minimum: 0,
                  },
                  before: {
                    type: ['integer', 'null'],
                    format: 'uint',
                    minimum: 0,
                  },
                  after: {
                    type: ['integer', 'null'],
                    format: 'uint',
                    minimum: 0,
                  },
                  totalBytes: {
                    type: 'integer',
                    format: 'uint',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'page',
                  },
                },
                required: [
                  'kind',
                  'writable',
                  'preferencesWritable',
                  'preferenceRevision',
                  'entry',
                  'revision',
                  'text',
                  'offset',
                  'totalBytes',
                ],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'changed',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'unavailable',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
            ],
            title: 'SkillLibraryDocument',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              SkillLibraryEntry: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  bundled: {
                    type: 'boolean',
                  },
                  installed: {
                    type: 'boolean',
                  },
                  imported: {
                    type: 'boolean',
                    description:
                      'Imported authoring source; unavailable to the model until explicitly installed.',
                  },
                  preference: {
                    $ref: '#/$defs/SkillPreference',
                  },
                  reference: {
                    type: 'string',
                  },
                  source: {
                    type: 'string',
                  },
                  name: {
                    type: 'string',
                  },
                  description: {
                    type: 'string',
                  },
                  valid: {
                    type: 'boolean',
                  },
                  shadowedBy: {
                    type: ['string', 'null'],
                  },
                  metadataTruncated: {
                    type: 'boolean',
                  },
                  issues: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                },
                required: [
                  'bundled',
                  'installed',
                  'imported',
                  'preference',
                  'reference',
                  'source',
                  'name',
                  'description',
                  'valid',
                  'metadataTruncated',
                  'issues',
                ],
              },
              SkillPreference: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  enabled: {
                    type: 'boolean',
                  },
                  pinned: {
                    type: 'boolean',
                  },
                },
                required: ['enabled', 'pinned'],
              },
            },
          },
          resources: {},
        },
        search: {
          mode: 'query',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              workspace: {
                anyOf: [
                  {
                    $ref: '#/$defs/AgentWorkspace',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              tools: {
                type: 'array',
                items: {
                  type: 'string',
                },
              },
              input: {
                $ref: '#/$defs/SkillModelSearch',
              },
            },
            required: ['tools', 'input'],
            description:
              'Actual Agent registrations are supplied outside model-controlled arguments.\nThese names describe compatibility and confer no execution authority.',
            title: 'SkillToolRequest',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              AgentWorkspace: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  worktree: {
                    anyOf: [
                      {
                        $ref: '#/$defs/Binding',
                      },
                      {
                        type: 'null',
                      },
                    ],
                    description:
                      'Native owner allocation; never accepted from a caller as workspace authority.',
                  },
                  projectId: {
                    type: ['string', 'null'],
                    format: 'uuid',
                    description: "Optional membership in this Agent's canonical Project catalog.",
                  },
                  path: {
                    type: 'string',
                    minLength: 1,
                  },
                  directoryIdentity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  identity: {
                    type: 'string',
                    pattern: '^workspace:v1:[A-Fa-f0-9-]{36}$',
                  },
                },
                required: ['path', 'directoryIdentity', 'identity'],
              },
              Binding: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  id: {
                    type: 'string',
                  },
                  common_dir: {
                    type: 'string',
                  },
                  source: {
                    type: 'string',
                  },
                  source_identity: {
                    type: 'string',
                    pattern: '^sha256:[a-f0-9]{64}$',
                  },
                  base_commit: {
                    type: 'string',
                  },
                  directory: {
                    type: 'string',
                  },
                },
                required: [
                  'id',
                  'common_dir',
                  'source',
                  'source_identity',
                  'base_commit',
                  'directory',
                ],
                description: 'Immutable allocation intent, not the current child branch or HEAD.',
              },
              SkillModelSearch: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  query: {
                    type: 'string',
                  },
                  limit: {
                    type: ['integer', 'null'],
                    format: 'uint',
                    minimum: 1,
                    maximum: 8,
                  },
                },
                required: ['query'],
              },
            },
          },
          output: {
            type: 'object',
            properties: {
              revision: {
                type: 'string',
              },
              query: {
                type: 'string',
              },
              queryTruncated: {
                type: 'boolean',
              },
              matches: {
                type: 'array',
                items: {
                  $ref: '#/$defs/SearchMatch',
                },
              },
              totalEligible: {
                type: 'integer',
                format: 'uint',
                minimum: 0,
              },
              matchedCount: {
                type: 'integer',
                format: 'uint',
                minimum: 0,
              },
              truncated: {
                type: 'boolean',
              },
            },
            required: [
              'revision',
              'query',
              'queryTruncated',
              'matches',
              'totalEligible',
              'matchedCount',
              'truncated',
            ],
            title: 'SkillModelSearchResult',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              SearchMatch: {
                type: 'object',
                properties: {
                  ref: {
                    type: 'string',
                  },
                  id: {
                    type: 'string',
                  },
                  name: {
                    type: 'string',
                  },
                  description: {
                    type: 'string',
                  },
                  scope: {
                    $ref: '#/$defs/SkillScope',
                  },
                  source: {
                    $ref: '#/$defs/SkillSource',
                  },
                  metadataTruncated: {
                    type: 'boolean',
                  },
                  score: {
                    type: 'integer',
                    format: 'uint32',
                    minimum: 0,
                  },
                },
                required: [
                  'ref',
                  'id',
                  'name',
                  'description',
                  'scope',
                  'source',
                  'metadataTruncated',
                  'score',
                ],
              },
              SkillScope: {
                type: 'string',
                enum: ['project', 'workspace', 'user', 'custom'],
              },
              SkillSource: {
                type: 'string',
                enum: ['maka', 'agents', 'legacy', 'custom'],
              },
            },
          },
          resources: {},
        },
        setPreference: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              reference: {
                type: 'string',
                minLength: 1,
              },
              revision: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
                maximum: 9007199254740991,
              },
              preference: {
                $ref: '#/$defs/SkillPreference',
              },
            },
            required: ['reference', 'revision', 'preference'],
            title: 'SkillLibrarySetPreference',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              SkillPreference: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  enabled: {
                    type: 'boolean',
                  },
                  pinned: {
                    type: 'boolean',
                  },
                },
                required: ['enabled', 'pinned'],
              },
            },
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'applied',
                  },
                },
                required: ['kind', 'revision'],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'changed',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  reason: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                required: ['kind', 'reason'],
              },
            ],
            title: 'SkillLibraryPreferenceResult',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          resources: {},
        },
      },
    },
  },
  skillOutcomes: {
    name: 'maka.skills.Outcomes',
    version: 1,
    transport: 'remote',
    interface: {
      kind: 'service',
      methods: {
        read: {
          mode: 'query',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              source: {
                $ref: '#/$defs/DeploymentRef',
              },
              namespace: {
                $ref: '#/$defs/InstanceId',
              },
              export: {
                type: 'string',
              },
              method: {
                type: 'string',
              },
              operation: {
                type: 'string',
                format: 'uuid',
              },
              fingerprint: {
                type: 'string',
              },
              contract: {
                $ref: '#/$defs/RecoveryContract',
              },
              recovery: {
                $ref: '#/$defs/RecoveryProtocol',
              },
            },
            required: [
              'source',
              'namespace',
              'export',
              'method',
              'operation',
              'fingerprint',
              'contract',
              'recovery',
            ],
            title: 'RecoveryRef',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              DeploymentRef: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                required: ['stateDomain', 'deployment', 'revision'],
              },
              InstanceId: {
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
              },
              RecoveryContract: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  name: {
                    type: 'string',
                  },
                  version: {
                    type: 'integer',
                    format: 'uint32',
                    minimum: 0,
                  },
                  transport: {
                    $ref: '#/$defs/Transport',
                  },
                  digest: {
                    type: 'string',
                  },
                },
                required: ['name', 'version', 'transport', 'digest'],
                description:
                  'Contract identity for a journal lookup. The original request retains the\ncomplete contract; a receipt carries only its digest.',
              },
              Transport: {
                type: 'string',
                enum: ['local', 'remote'],
              },
              RecoveryProtocol: {
                type: 'string',
                enum: ['journal_v1'],
              },
            },
          },
          output: {
            type: 'object',
            additionalProperties: false,
            properties: {
              original: {
                $ref: '#/$defs/OperationReply',
              },
              published: {
                anyOf: [
                  {
                    $ref: '#/$defs/SkillLibraryChangeResult',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
            },
            required: ['original'],
            description:
              'Canonical publication evidence alongside the unmodified original Host facts.',
            title: 'SkillLibraryOutcome',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              OperationReply: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  reference: {
                    $ref: '#/$defs/RecoveryRef',
                  },
                  receipt: {
                    $ref: '#/$defs/Receipt',
                  },
                },
                required: ['reference', 'receipt'],
              },
              RecoveryRef: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  source: {
                    $ref: '#/$defs/DeploymentRef',
                  },
                  namespace: {
                    $ref: '#/$defs/InstanceId',
                  },
                  export: {
                    type: 'string',
                  },
                  method: {
                    type: 'string',
                  },
                  operation: {
                    type: 'string',
                    format: 'uuid',
                  },
                  fingerprint: {
                    type: 'string',
                  },
                  contract: {
                    $ref: '#/$defs/RecoveryContract',
                  },
                  recovery: {
                    $ref: '#/$defs/RecoveryProtocol',
                  },
                },
                required: [
                  'source',
                  'namespace',
                  'export',
                  'method',
                  'operation',
                  'fingerprint',
                  'contract',
                  'recovery',
                ],
              },
              DeploymentRef: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                required: ['stateDomain', 'deployment', 'revision'],
              },
              InstanceId: {
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
              },
              RecoveryContract: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  name: {
                    type: 'string',
                  },
                  version: {
                    type: 'integer',
                    format: 'uint32',
                    minimum: 0,
                  },
                  transport: {
                    $ref: '#/$defs/Transport',
                  },
                  digest: {
                    type: 'string',
                  },
                },
                required: ['name', 'version', 'transport', 'digest'],
                description:
                  'Contract identity for a journal lookup. The original request retains the\ncomplete contract; a receipt carries only its digest.',
              },
              Transport: {
                type: 'string',
                enum: ['local', 'remote'],
              },
              RecoveryProtocol: {
                type: 'string',
                enum: ['journal_v1'],
              },
              Receipt: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'not_recorded',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                    description:
                      'An authorized lookup found no row at the exact original reference.',
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      outcome: {
                        $ref: '#/$defs/OperationOutcome',
                      },
                      cleanup: {
                        $ref: '#/$defs/OperationCleanup',
                      },
                      kind: {
                        type: 'string',
                        const: 'recorded',
                      },
                    },
                    required: ['kind', 'outcome', 'cleanup'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      diagnostic: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'unavailable',
                      },
                    },
                    required: ['kind', 'diagnostic'],
                  },
                ],
                description:
                  "A caller's receipt observation, never an execution grant. Unavailable makes\nno claim about the journal's contents or physical cleanup.",
              },
              OperationOutcome: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'unresolved',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      value: true,
                      kind: {
                        type: 'string',
                        const: 'returned',
                      },
                    },
                    required: ['kind', 'value'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      diagnostic: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'unknown',
                      },
                    },
                    required: ['kind', 'diagnostic'],
                  },
                ],
                description:
                  'Unresolved means no durable result is known, including after process loss.',
              },
              OperationCleanup: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'unconfirmed',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'confirmed',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      diagnostic: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'failed',
                      },
                    },
                    required: ['kind', 'diagnostic'],
                  },
                ],
              },
              SkillLibraryChangeResult: {
                oneOf: [
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      reference: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'applied',
                      },
                    },
                    required: ['kind', 'reference'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'changed',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      reason: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'rejected',
                      },
                    },
                    required: ['kind', 'reason'],
                  },
                ],
              },
            },
          },
          resources: {},
        },
      },
    },
  },
  workspaceFiles: {
    name: 'maka.workspace.Files',
    version: 1,
    transport: 'remote',
    interface: {
      kind: 'service',
      methods: {
        applyPatch: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              callId: {
                type: 'string',
                minLength: 1,
              },
              operation: {
                $ref: '#/$defs/NativeOperation',
              },
            },
            required: ['callId', 'operation'],
            title: 'NativeInput',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              NativeOperation: {
                oneOf: [
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      path: {
                        type: 'string',
                        minLength: 1,
                      },
                      diff: {
                        type: 'string',
                      },
                      type: {
                        type: 'string',
                        const: 'create_file',
                      },
                    },
                    required: ['type', 'path', 'diff'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      path: {
                        type: 'string',
                        minLength: 1,
                      },
                      diff: {
                        type: 'string',
                      },
                      type: {
                        type: 'string',
                        const: 'update_file',
                      },
                    },
                    required: ['type', 'path', 'diff'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      path: {
                        type: 'string',
                        minLength: 1,
                      },
                      type: {
                        type: 'string',
                        const: 'delete_file',
                      },
                    },
                    required: ['type', 'path'],
                  },
                ],
              },
            },
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  value: true,
                  kind: {
                    type: 'string',
                    const: 'completed',
                  },
                },
                required: ['kind', 'value'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  message: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                required: ['kind', 'message'],
                description:
                  'A known completed failure. Uncertain external effects use the original receipt.',
              },
            ],
            title: 'WorkspaceFileResult',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          resources: {},
        },
        edit: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              path: {
                type: 'string',
                minLength: 1,
              },
              old_string: {
                type: 'string',
                minLength: 1,
              },
              new_string: {
                type: 'string',
              },
            },
            required: ['path', 'old_string', 'new_string'],
            title: 'EditInput',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  value: true,
                  kind: {
                    type: 'string',
                    const: 'completed',
                  },
                },
                required: ['kind', 'value'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  message: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                required: ['kind', 'message'],
                description:
                  'A known completed failure. Uncertain external effects use the original receipt.',
              },
            ],
            title: 'WorkspaceFileResult',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          resources: {},
        },
        glob: {
          mode: 'query',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              pattern: {
                type: 'string',
                minLength: 1,
              },
              cwd: {
                type: 'string',
                minLength: 1,
                default: '.',
              },
            },
            required: ['pattern'],
            title: 'Input',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  value: true,
                  kind: {
                    type: 'string',
                    const: 'completed',
                  },
                },
                required: ['kind', 'value'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  message: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                required: ['kind', 'message'],
                description:
                  'A known completed failure. Uncertain external effects use the original receipt.',
              },
            ],
            title: 'WorkspaceFileResult',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          resources: {},
        },
        grep: {
          mode: 'query',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              pattern: {
                type: 'string',
              },
              path: {
                type: 'string',
                default: '.',
              },
              glob: {
                type: 'string',
              },
            },
            required: ['pattern'],
            title: 'Input',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  value: true,
                  kind: {
                    type: 'string',
                    const: 'completed',
                  },
                },
                required: ['kind', 'value'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  message: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                required: ['kind', 'message'],
                description:
                  'A known completed failure. Uncertain external effects use the original receipt.',
              },
            ],
            title: 'WorkspaceFileResult',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          resources: {},
        },
        readImage: {
          mode: 'subscription',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              path: {
                type: 'string',
                minLength: 1,
              },
              offset: {
                type: 'integer',
                format: 'uint',
                minimum: 0,
                maximum: 9007199254740991,
              },
              limit: {
                type: 'integer',
                format: 'uint',
                minimum: 1,
                maximum: 9007199254740991,
              },
            },
            required: ['path'],
            title: 'ReadInput',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  mimeType: {
                    type: 'string',
                    pattern: '^image/(png|jpeg|gif|webp)$',
                  },
                  totalBytes: {
                    type: 'integer',
                    format: 'uint',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  offset: {
                    type: 'integer',
                    format: 'uint',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                  data: {
                    type: 'string',
                    minLength: 1,
                    maxLength: 43692,
                  },
                  kind: {
                    type: 'string',
                    const: 'chunk',
                  },
                },
                required: ['kind', 'mimeType', 'totalBytes', 'offset', 'data'],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'complete',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
            ],
            description:
              'Bounded image bytes from a selected subscription. Complete is a producer\nreturn value, never an emitted item or an executor-cleanup acknowledgement.',
            title: 'AgentToolImageFrame',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          resources: {},
        },
        readText: {
          mode: 'query',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              path: {
                type: 'string',
                minLength: 1,
              },
              offset: {
                type: 'integer',
                format: 'uint',
                minimum: 0,
                maximum: 9007199254740991,
              },
              limit: {
                type: 'integer',
                format: 'uint',
                minimum: 1,
                maximum: 9007199254740991,
              },
            },
            required: ['path'],
            title: 'ReadInput',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  value: true,
                  kind: {
                    type: 'string',
                    const: 'completed',
                  },
                },
                required: ['kind', 'value'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  message: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                required: ['kind', 'message'],
                description:
                  'A known completed failure. Uncertain external effects use the original receipt.',
              },
            ],
            title: 'WorkspaceFileResult',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          resources: {},
        },
        write: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              path: {
                type: 'string',
                minLength: 1,
              },
              content: {
                type: 'string',
              },
            },
            required: ['path', 'content'],
            title: 'WriteInput',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  value: true,
                  kind: {
                    type: 'string',
                    const: 'completed',
                  },
                },
                required: ['kind', 'value'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  message: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                required: ['kind', 'message'],
                description:
                  'A known completed failure. Uncertain external effects use the original receipt.',
              },
            ],
            title: 'WorkspaceFileResult',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          resources: {},
        },
      },
    },
  },
  workspaceProcesses: {
    name: 'maka.workspace.Processes',
    version: 1,
    transport: 'remote',
    interface: {
      kind: 'service',
      methods: {
        execute: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              command: {
                type: 'string',
                minLength: 1,
              },
              login: {
                type: 'boolean',
                description: "Load the shell's login profile. Set false to skip it.",
                default: true,
              },
              timeout_ms: {
                type: ['integer', 'null'],
                format: 'uint64',
                minimum: 1,
              },
              run_in_background: {
                type: 'boolean',
                default: false,
              },
              pty: {
                type: 'boolean',
                description: 'Allocate a terminal; requires run_in_background=true.',
                default: false,
              },
              additional_permissions: {
                anyOf: [
                  {
                    $ref: '#/$defs/Permissions',
                  },
                  {
                    type: 'null',
                  },
                ],
                description:
                  'Request additional filesystem or network access before this command.\nOn Linux/Windows, request an existing parent directory when creating a new path.',
              },
              justification: {
                type: ['string', 'null'],
                description:
                  'Explain why the additional access is necessary. Required with additional_permissions.',
              },
            },
            required: ['command'],
            title: 'Execute',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              Permissions: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  filesystem: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/Rule',
                    },
                  },
                  network: {
                    $ref: '#/$defs/Network',
                  },
                },
                required: ['filesystem', 'network'],
              },
              Rule: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  path: {
                    type: 'string',
                  },
                  scope: {
                    $ref: '#/$defs/Scope',
                  },
                  access: {
                    $ref: '#/$defs/Access',
                  },
                },
                required: ['path', 'scope', 'access'],
                description:
                  'Paths have executor-native meaning. Validate and materialize them on the\nexecution host, never on a remote Desktop. This document alone grants nothing.',
              },
              Scope: {
                type: 'string',
                enum: ['subtree', 'exact'],
              },
              Access: {
                type: 'string',
                enum: ['read', 'write', 'deny'],
                description:
                  'Equal-path conflict priority is different from authority breadth: deny wins.',
              },
              Network: {
                oneOf: [
                  {
                    type: 'string',
                    enum: ['denied', 'allowed'],
                  },
                  {
                    type: 'object',
                    properties: {
                      restricted: {
                        type: 'object',
                        properties: {
                          destinations: {
                            type: 'array',
                            uniqueItems: true,
                            items: {
                              $ref: '#/$defs/Destination',
                            },
                          },
                        },
                        additionalProperties: false,
                        required: ['destinations'],
                      },
                    },
                    required: ['restricted'],
                    additionalProperties: false,
                  },
                ],
              },
              Destination: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  host: {
                    type: 'string',
                    minLength: 1,
                    maxLength: 253,
                  },
                  port: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 1,
                    maximum: 65535,
                  },
                },
                required: ['host', 'port'],
                description:
                  'Destination authority, independent of the upstream proxy used to reach it.\nA domain grant does not authorize its subdomains or other ports.',
              },
            },
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  value: true,
                  kind: {
                    type: 'string',
                    const: 'completed',
                  },
                },
                required: ['kind', 'value'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  message: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                required: ['kind', 'message'],
              },
            ],
            title: 'WorkspaceProcessResult',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          resources: {},
        },
        health: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              ref: {
                type: 'string',
              },
              include_logs: {
                type: 'boolean',
                default: false,
              },
              url: {
                type: ['string', 'null'],
              },
            },
            required: ['ref'],
            title: 'WorkspaceProcessHealth',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  value: true,
                  kind: {
                    type: 'string',
                    const: 'completed',
                  },
                },
                required: ['kind', 'value'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  message: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                required: ['kind', 'message'],
              },
            ],
            title: 'WorkspaceProcessResult',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          resources: {},
        },
        read: {
          mode: 'query',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              ref: {
                type: 'string',
              },
            },
            required: ['ref'],
            title: 'Reference',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  value: true,
                  kind: {
                    type: 'string',
                    const: 'completed',
                  },
                },
                required: ['kind', 'value'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  message: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                required: ['kind', 'message'],
              },
            ],
            title: 'WorkspaceProcessResult',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          resources: {},
        },
        stop: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              ref: {
                type: 'string',
              },
            },
            required: ['ref'],
            title: 'Reference',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  value: true,
                  kind: {
                    type: 'string',
                    const: 'completed',
                  },
                },
                required: ['kind', 'value'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  message: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                required: ['kind', 'message'],
              },
            ],
            title: 'WorkspaceProcessResult',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          resources: {},
        },
        writeStdin: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            required: ['ref'],
            properties: {
              ref: {
                type: 'string',
              },
              input: {
                type: 'string',
                description: 'Raw terminal input, exclusive with actions.',
              },
              actions: {
                type: ['array', 'null'],
                items: {
                  type: 'object',
                  additionalProperties: false,
                  required: ['type'],
                  properties: {
                    type: {
                      enum: ['text', 'key', 'mouse'],
                    },
                    text: {
                      type: ['string', 'number', 'null'],
                    },
                    key: {
                      type: ['string', 'number', 'null'],
                    },
                    event: {
                      type: ['string', 'number', 'null'],
                    },
                    x: {
                      type: ['number', 'string', 'null'],
                    },
                    y: {
                      type: ['number', 'string', 'null'],
                    },
                    button: {
                      type: ['string', 'number', 'null'],
                    },
                    direction: {
                      type: ['string', 'number', 'null'],
                    },
                    modifiers: {
                      type: ['array', 'null'],
                      items: {
                        enum: ['ctrl', 'alt', 'shift'],
                      },
                    },
                  },
                },
              },
              size: {
                type: ['object', 'null'],
                additionalProperties: false,
                properties: {
                  cols: {
                    type: ['number', 'null'],
                  },
                  rows: {
                    type: ['number', 'null'],
                  },
                },
              },
            },
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  value: true,
                  kind: {
                    type: 'string',
                    const: 'completed',
                  },
                },
                required: ['kind', 'value'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  message: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                required: ['kind', 'message'],
              },
            ],
            title: 'WorkspaceProcessResult',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          resources: {},
        },
      },
    },
  },
  protocolProcesses: {
    name: 'maka.workspace.ProtocolProcesses',
    version: 1,
    transport: 'remote',
    interface: {
      kind: 'service',
      methods: {
        input: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              id: {
                type: 'string',
                format: 'uuid',
              },
              additionalPermissions: {
                anyOf: [
                  {
                    $ref: '#/$defs/Permissions',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              justification: {
                type: ['string', 'null'],
                minLength: 1,
              },
              bytes: {
                type: ['array', 'null'],
                items: {
                  type: 'integer',
                  format: 'uint8',
                  minimum: 0,
                  maximum: 255,
                },
                description: 'Null closes stdin. Empty data is a successful zero-byte write.',
                maxItems: 8192,
              },
            },
            required: ['id'],
            title: 'ProtocolProcessInput',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              Permissions: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  filesystem: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/Rule',
                    },
                  },
                  network: {
                    $ref: '#/$defs/Network',
                  },
                },
                required: ['filesystem', 'network'],
              },
              Rule: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  path: {
                    type: 'string',
                  },
                  scope: {
                    $ref: '#/$defs/Scope',
                  },
                  access: {
                    $ref: '#/$defs/Access',
                  },
                },
                required: ['path', 'scope', 'access'],
                description:
                  'Paths have executor-native meaning. Validate and materialize them on the\nexecution host, never on a remote Desktop. This document alone grants nothing.',
              },
              Scope: {
                type: 'string',
                enum: ['subtree', 'exact'],
              },
              Access: {
                type: 'string',
                enum: ['read', 'write', 'deny'],
                description:
                  'Equal-path conflict priority is different from authority breadth: deny wins.',
              },
              Network: {
                oneOf: [
                  {
                    type: 'string',
                    enum: ['denied', 'allowed'],
                  },
                  {
                    type: 'object',
                    properties: {
                      restricted: {
                        type: 'object',
                        properties: {
                          destinations: {
                            type: 'array',
                            uniqueItems: true,
                            items: {
                              $ref: '#/$defs/Destination',
                            },
                          },
                        },
                        additionalProperties: false,
                        required: ['destinations'],
                      },
                    },
                    required: ['restricted'],
                    additionalProperties: false,
                  },
                ],
              },
              Destination: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  host: {
                    type: 'string',
                    minLength: 1,
                    maxLength: 253,
                  },
                  port: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 1,
                    maximum: 65535,
                  },
                },
                required: ['host', 'port'],
                description:
                  'Destination authority, independent of the upstream proxy used to reach it.\nA domain grant does not authorize its subdomains or other ports.',
              },
            },
          },
          output: {
            type: 'object',
            additionalProperties: false,
            properties: {
              bytes: {
                type: 'integer',
                format: 'uint',
                minimum: 0,
              },
              closed: {
                type: 'boolean',
              },
            },
            required: ['bytes', 'closed'],
            title: 'ProtocolProcessWritten',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          resources: {},
        },
        launch: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              executable: {
                type: 'string',
                minLength: 1,
              },
              args: {
                type: 'array',
                items: {
                  type: 'string',
                },
                default: [],
              },
              env: {
                type: 'object',
                additionalProperties: {
                  type: 'string',
                },
                default: {},
              },
            },
            required: ['executable'],
            title: 'ProtocolProcessLaunch',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  code: {
                    type: ['integer', 'null'],
                    format: 'int32',
                  },
                  success: {
                    type: 'boolean',
                  },
                  stopped: {
                    type: 'boolean',
                  },
                  error: {
                    type: ['string', 'null'],
                  },
                  kind: {
                    type: 'string',
                    const: 'exited',
                  },
                },
                required: ['kind', 'success', 'stopped'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  message: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                required: ['kind', 'message'],
              },
            ],
            title: 'ProtocolProcessCompletion',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          progress: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  id: {
                    type: 'string',
                    format: 'uuid',
                  },
                  kind: {
                    type: 'string',
                    const: 'started',
                  },
                },
                required: ['kind', 'id'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  stream: {
                    $ref: '#/$defs/ProtocolProcessStream',
                  },
                  bytes: {
                    type: 'array',
                    items: {
                      type: 'integer',
                      format: 'uint8',
                      minimum: 0,
                      maximum: 255,
                    },
                    maxItems: 8192,
                  },
                  kind: {
                    type: 'string',
                    const: 'output',
                  },
                },
                required: ['kind', 'stream', 'bytes'],
              },
            ],
            title: 'ProtocolProcessProgress',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              ProtocolProcessStream: {
                type: 'string',
                enum: ['stdout', 'stderr'],
              },
            },
          },
          resources: {},
        },
        run: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              executable: {
                type: 'string',
                minLength: 1,
              },
              args: {
                type: 'array',
                items: {
                  type: 'string',
                },
                default: [],
              },
              env: {
                type: 'object',
                additionalProperties: {
                  type: 'string',
                },
                default: {},
              },
              additionalPermissions: {
                anyOf: [
                  {
                    $ref: '#/$defs/Permissions',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              justification: {
                type: ['string', 'null'],
                minLength: 1,
              },
            },
            required: ['executable'],
            title: 'ProtocolProcessRun',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              Permissions: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  filesystem: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/Rule',
                    },
                  },
                  network: {
                    $ref: '#/$defs/Network',
                  },
                },
                required: ['filesystem', 'network'],
              },
              Rule: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  path: {
                    type: 'string',
                  },
                  scope: {
                    $ref: '#/$defs/Scope',
                  },
                  access: {
                    $ref: '#/$defs/Access',
                  },
                },
                required: ['path', 'scope', 'access'],
                description:
                  'Paths have executor-native meaning. Validate and materialize them on the\nexecution host, never on a remote Desktop. This document alone grants nothing.',
              },
              Scope: {
                type: 'string',
                enum: ['subtree', 'exact'],
              },
              Access: {
                type: 'string',
                enum: ['read', 'write', 'deny'],
                description:
                  'Equal-path conflict priority is different from authority breadth: deny wins.',
              },
              Network: {
                oneOf: [
                  {
                    type: 'string',
                    enum: ['denied', 'allowed'],
                  },
                  {
                    type: 'object',
                    properties: {
                      restricted: {
                        type: 'object',
                        properties: {
                          destinations: {
                            type: 'array',
                            uniqueItems: true,
                            items: {
                              $ref: '#/$defs/Destination',
                            },
                          },
                        },
                        additionalProperties: false,
                        required: ['destinations'],
                      },
                    },
                    required: ['restricted'],
                    additionalProperties: false,
                  },
                ],
              },
              Destination: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  host: {
                    type: 'string',
                    minLength: 1,
                    maxLength: 253,
                  },
                  port: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 1,
                    maximum: 65535,
                  },
                },
                required: ['host', 'port'],
                description:
                  'Destination authority, independent of the upstream proxy used to reach it.\nA domain grant does not authorize its subdomains or other ports.',
              },
            },
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  code: {
                    type: ['integer', 'null'],
                    format: 'int32',
                  },
                  success: {
                    type: 'boolean',
                  },
                  stopped: {
                    type: 'boolean',
                  },
                  error: {
                    type: ['string', 'null'],
                  },
                  kind: {
                    type: 'string',
                    const: 'exited',
                  },
                },
                required: ['kind', 'success', 'stopped'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  message: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                required: ['kind', 'message'],
              },
            ],
            title: 'ProtocolProcessCompletion',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          progress: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  id: {
                    type: 'string',
                    format: 'uuid',
                  },
                  kind: {
                    type: 'string',
                    const: 'started',
                  },
                },
                required: ['kind', 'id'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  stream: {
                    $ref: '#/$defs/ProtocolProcessStream',
                  },
                  bytes: {
                    type: 'array',
                    items: {
                      type: 'integer',
                      format: 'uint8',
                      minimum: 0,
                      maximum: 255,
                    },
                    maxItems: 8192,
                  },
                  kind: {
                    type: 'string',
                    const: 'output',
                  },
                },
                required: ['kind', 'stream', 'bytes'],
              },
            ],
            title: 'ProtocolProcessProgress',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              ProtocolProcessStream: {
                type: 'string',
                enum: ['stdout', 'stderr'],
              },
            },
          },
          resources: {},
        },
      },
    },
  },
  executorSetup: {
    name: 'maka.agent.ExecutorSetup',
    version: 1,
    transport: 'remote',
    interface: {
      kind: 'service',
      methods: {
        setup: {
          mode: 'mutation',
          input: {
            oneOf: [
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'check',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  methodId: {
                    type: 'string',
                    minLength: 1,
                  },
                  kind: {
                    type: 'string',
                    const: 'authenticate',
                  },
                },
                required: ['kind', 'methodId'],
              },
            ],
            title: 'ExecutorSetupAction',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  info: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ExecutorSetupInfo',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  methods: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/ExecutorAuthenticationMethod',
                    },
                  },
                  kind: {
                    type: 'string',
                    const: 'checked',
                  },
                },
                required: ['kind', 'methods'],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'authenticated',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  diagnostic: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'unresolved',
                  },
                },
                required: ['kind', 'diagnostic'],
                description:
                  'No authentication confirmation was observed; never automatically replay it.',
              },
            ],
            title: 'ExecutorSetupResult',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              ExecutorSetupInfo: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  title: {
                    type: ['string', 'null'],
                  },
                  name: {
                    type: 'string',
                  },
                  version: {
                    type: 'string',
                  },
                },
                required: ['name', 'version'],
              },
              ExecutorAuthenticationMethod: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  id: {
                    type: 'string',
                    minLength: 1,
                  },
                  name: {
                    type: 'string',
                    minLength: 1,
                  },
                  description: {
                    type: ['string', 'null'],
                  },
                  supported: {
                    type: 'boolean',
                  },
                },
                required: ['id', 'name', 'supported'],
              },
            },
          },
          progress: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  url: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'authorization_url',
                  },
                },
                required: ['kind', 'url'],
              },
            ],
            title: 'ExecutorSetupProgress',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          resources: {},
        },
      },
    },
  },
  terminal: {
    name: 'maka.workspace.Terminal',
    version: 1,
    transport: 'remote',
    interface: {
      kind: 'service',
      methods: {
        acquire: {
          mode: 'subscription',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              sessionId: {
                type: 'string',
              },
              ref: {
                type: 'string',
              },
            },
            required: ['sessionId', 'ref'],
            title: 'TerminalTarget',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  value: {
                    $ref: '#/$defs/TerminalLeaseUpdate',
                  },
                  kind: {
                    type: 'string',
                    const: 'completed',
                  },
                },
                required: ['kind', 'value'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  message: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                required: ['kind', 'message'],
              },
            ],
            title: 'TerminalOutcome_TerminalLeaseUpdate',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              TerminalLeaseUpdate: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  controllerId: {
                    type: 'string',
                    format: 'uuid',
                  },
                  nextSequence: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  held: {
                    type: 'boolean',
                  },
                  resource: {
                    $ref: '#/$defs/ResourceUpdate',
                  },
                },
                required: ['controllerId', 'held', 'resource'],
              },
              ResourceUpdate: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  ownership: {
                    $ref: '#/$defs/Ownership',
                  },
                  sourceTurnId: {
                    type: 'string',
                  },
                  sourceToolCallId: {
                    type: 'string',
                  },
                  result: {
                    $ref: '#/$defs/ShellSnapshot',
                  },
                },
                required: ['sessionId', 'ownership', 'sourceTurnId', 'sourceToolCallId', 'result'],
              },
              Ownership: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'local',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      sourceSessionId: {
                        type: 'string',
                      },
                      ownerSessionId: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'source_owned',
                      },
                    },
                    required: ['kind', 'sourceSessionId', 'ownerSessionId'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      sourceSessionId: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'source_unavailable',
                      },
                    },
                    required: ['kind', 'sourceSessionId'],
                  },
                ],
              },
              ShellSnapshot: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  kind: {
                    $ref: '#/$defs/SnapshotKind',
                  },
                  ref: {
                    type: 'string',
                  },
                  mode: {
                    $ref: '#/$defs/ShellMode',
                  },
                  status: {
                    $ref: '#/$defs/ShellStatus',
                  },
                  cwd: {
                    type: 'string',
                  },
                  cmd: {
                    type: 'string',
                  },
                  startedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  updatedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  completedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  timeoutMs: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  exitCode: {
                    type: 'integer',
                    format: 'int64',
                  },
                  failureMessage: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  output: {
                    $ref: '#/$defs/ShellOutput',
                  },
                },
                required: [
                  'kind',
                  'ref',
                  'mode',
                  'status',
                  'cwd',
                  'cmd',
                  'startedAt',
                  'updatedAt',
                  'revision',
                ],
              },
              SnapshotKind: {
                type: 'string',
                enum: ['shell_run'],
              },
              ShellMode: {
                type: 'string',
                enum: ['pipes', 'pty'],
              },
              ShellStatus: {
                type: 'string',
                enum: [
                  'starting',
                  'running',
                  'completed',
                  'failed',
                  'timed_out',
                  'cancelled',
                  'orphaned',
                ],
              },
              ShellOutput: {
                oneOf: [
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      stdout: {
                        type: 'string',
                      },
                      stderr: {
                        type: 'string',
                      },
                      latestStream: {
                        $ref: '#/$defs/PipeStream',
                      },
                      stdoutTruncated: {
                        type: 'boolean',
                      },
                      stderrTruncated: {
                        type: 'boolean',
                      },
                      redacted: {
                        type: 'boolean',
                      },
                      mode: {
                        type: 'string',
                        const: 'pipes',
                      },
                    },
                    required: [
                      'mode',
                      'stdout',
                      'stderr',
                      'stdoutTruncated',
                      'stderrTruncated',
                      'redacted',
                    ],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      screen: {
                        type: 'string',
                      },
                      scrollback: {
                        type: 'string',
                      },
                      lastAlternateScreen: {
                        type: 'string',
                      },
                      cols: {
                        type: 'integer',
                        format: 'uint16',
                        minimum: 0,
                        maximum: 65535,
                      },
                      rows: {
                        type: 'integer',
                        format: 'uint16',
                        minimum: 0,
                        maximum: 65535,
                      },
                      cursor: {
                        $ref: '#/$defs/TerminalCursor',
                      },
                      alternateScreen: {
                        type: 'boolean',
                      },
                      truncated: {
                        type: 'boolean',
                      },
                      redacted: {
                        type: 'boolean',
                      },
                      mode: {
                        type: 'string',
                        const: 'pty',
                      },
                    },
                    required: [
                      'mode',
                      'screen',
                      'scrollback',
                      'cols',
                      'rows',
                      'cursor',
                      'alternateScreen',
                      'truncated',
                      'redacted',
                    ],
                  },
                ],
              },
              PipeStream: {
                type: 'string',
                enum: ['stdout', 'stderr'],
              },
              TerminalCursor: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  x: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 0,
                    maximum: 65535,
                  },
                  y: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 0,
                    maximum: 65535,
                  },
                  visible: {
                    type: 'boolean',
                  },
                },
                required: ['x', 'y', 'visible'],
              },
            },
          },
          resources: {},
        },
        control: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              controller: {
                $ref: '#/$defs/TerminalController',
              },
              sequence: {
                type: 'integer',
                format: 'uint64',
                minimum: 1,
                maximum: 9007199254740991,
              },
              actions: {
                type: 'array',
                items: {
                  $ref: '#/$defs/RawAction',
                },
                default: [],
              },
              size: {
                anyOf: [
                  {
                    $ref: '#/$defs/TerminalSize',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
            },
            required: ['controller', 'sequence'],
            title: 'TerminalControl',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              TerminalController: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  target: {
                    $ref: '#/$defs/TerminalTarget',
                  },
                  controllerId: {
                    type: 'string',
                    format: 'uuid',
                  },
                },
                required: ['target', 'controllerId'],
              },
              TerminalTarget: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  ref: {
                    type: 'string',
                  },
                },
                required: ['sessionId', 'ref'],
              },
              RawAction: {
                oneOf: [
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      text: {
                        type: 'string',
                        minLength: 1,
                        pattern: '^[^\\x00-\\x1f\\x7f-\\x9f]+$',
                      },
                      type: {
                        type: 'string',
                        const: 'text',
                      },
                    },
                    required: ['type', 'text'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      text: {
                        type: 'string',
                        minLength: 1,
                        pattern: '^[^\\x00-\\x08\\x0b\\x0c\\x0e-\\x1f\\x7f-\\x9f]+$',
                      },
                      type: {
                        type: 'string',
                        const: 'paste',
                      },
                    },
                    required: ['type', 'text'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      key: {
                        type: 'string',
                        pattern:
                          '^(?:[ -~]|enter|escape|tab|backspace|arrow_(?:up|down|left|right)|home|end|insert|delete|page_(?:up|down)|f(?:[1-9]|1[0-2]))$',
                      },
                      modifiers: {
                        $ref: '#/$defs/TerminalModifiers',
                        default: [],
                      },
                      type: {
                        type: 'string',
                        const: 'key',
                      },
                    },
                    required: ['type', 'key'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      event: {
                        $ref: '#/$defs/RawEvent',
                      },
                      x: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                        maximum: 9007199254740991,
                      },
                      y: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                        maximum: 9007199254740991,
                      },
                      button: {
                        $ref: '#/$defs/MouseButton',
                        default: null,
                      },
                      direction: {
                        $ref: '#/$defs/ScrollDirection',
                        default: null,
                      },
                      modifiers: {
                        $ref: '#/$defs/TerminalModifiers',
                        default: [],
                      },
                      type: {
                        type: 'string',
                        const: 'mouse',
                      },
                    },
                    required: ['type', 'event', 'x', 'y'],
                  },
                ],
              },
              TerminalModifiers: {
                type: 'array',
                items: {
                  $ref: '#/$defs/Modifier',
                },
                uniqueItems: true,
                maxItems: 3,
              },
              Modifier: {
                type: 'string',
                enum: ['ctrl', 'alt', 'shift'],
              },
              RawEvent: {
                type: 'string',
                enum: ['click', 'press', 'release', 'move', 'scroll'],
              },
              MouseButton: {
                type: 'string',
                enum: ['left', 'middle', 'right'],
              },
              ScrollDirection: {
                type: 'string',
                enum: ['up', 'down'],
              },
              TerminalSize: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  cols: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 2,
                    maximum: 1024,
                  },
                  rows: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 1,
                    maximum: 1024,
                  },
                },
                required: ['cols', 'rows'],
                description:
                  'Shared by native PTY allocation, input validation and screen rendering.',
              },
            },
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  value: {
                    $ref: '#/$defs/TerminalControlReceipt',
                  },
                  kind: {
                    type: 'string',
                    const: 'completed',
                  },
                },
                required: ['kind', 'value'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  message: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                required: ['kind', 'message'],
              },
            ],
            title: 'TerminalOutcome_TerminalControlReceipt',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              TerminalControlReceipt: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  controllerId: {
                    type: 'string',
                    format: 'uuid',
                  },
                  sequence: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  acceptedBytes: {
                    type: 'integer',
                    format: 'uint',
                    minimum: 0,
                  },
                  resized: {
                    type: 'boolean',
                  },
                  resizeChanged: {
                    type: 'boolean',
                  },
                },
                required: ['controllerId', 'sequence', 'acceptedBytes', 'resized', 'resizeChanged'],
              },
            },
          },
          resources: {},
        },
        list: {
          mode: 'query',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              sessionId: {
                type: 'string',
              },
              offset: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
                maximum: 9007199254740991,
                default: 0,
              },
            },
            required: ['sessionId'],
            title: 'TerminalList',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  value: {
                    $ref: '#/$defs/TerminalPage',
                  },
                  kind: {
                    type: 'string',
                    const: 'completed',
                  },
                },
                required: ['kind', 'value'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  message: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                required: ['kind', 'message'],
              },
            ],
            title: 'TerminalOutcome_TerminalPage',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              TerminalPage: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  resources: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/ResourceUpdate',
                    },
                  },
                  revision: {
                    type: 'string',
                  },
                  total: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  nextOffset: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                required: ['resources', 'revision', 'total'],
              },
              ResourceUpdate: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  ownership: {
                    $ref: '#/$defs/Ownership',
                  },
                  sourceTurnId: {
                    type: 'string',
                  },
                  sourceToolCallId: {
                    type: 'string',
                  },
                  result: {
                    $ref: '#/$defs/ShellSnapshot',
                  },
                },
                required: ['sessionId', 'ownership', 'sourceTurnId', 'sourceToolCallId', 'result'],
              },
              Ownership: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'local',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      sourceSessionId: {
                        type: 'string',
                      },
                      ownerSessionId: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'source_owned',
                      },
                    },
                    required: ['kind', 'sourceSessionId', 'ownerSessionId'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      sourceSessionId: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'source_unavailable',
                      },
                    },
                    required: ['kind', 'sourceSessionId'],
                  },
                ],
              },
              ShellSnapshot: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  kind: {
                    $ref: '#/$defs/SnapshotKind',
                  },
                  ref: {
                    type: 'string',
                  },
                  mode: {
                    $ref: '#/$defs/ShellMode',
                  },
                  status: {
                    $ref: '#/$defs/ShellStatus',
                  },
                  cwd: {
                    type: 'string',
                  },
                  cmd: {
                    type: 'string',
                  },
                  startedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  updatedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  completedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  timeoutMs: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  exitCode: {
                    type: 'integer',
                    format: 'int64',
                  },
                  failureMessage: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  output: {
                    $ref: '#/$defs/ShellOutput',
                  },
                },
                required: [
                  'kind',
                  'ref',
                  'mode',
                  'status',
                  'cwd',
                  'cmd',
                  'startedAt',
                  'updatedAt',
                  'revision',
                ],
              },
              SnapshotKind: {
                type: 'string',
                enum: ['shell_run'],
              },
              ShellMode: {
                type: 'string',
                enum: ['pipes', 'pty'],
              },
              ShellStatus: {
                type: 'string',
                enum: [
                  'starting',
                  'running',
                  'completed',
                  'failed',
                  'timed_out',
                  'cancelled',
                  'orphaned',
                ],
              },
              ShellOutput: {
                oneOf: [
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      stdout: {
                        type: 'string',
                      },
                      stderr: {
                        type: 'string',
                      },
                      latestStream: {
                        $ref: '#/$defs/PipeStream',
                      },
                      stdoutTruncated: {
                        type: 'boolean',
                      },
                      stderrTruncated: {
                        type: 'boolean',
                      },
                      redacted: {
                        type: 'boolean',
                      },
                      mode: {
                        type: 'string',
                        const: 'pipes',
                      },
                    },
                    required: [
                      'mode',
                      'stdout',
                      'stderr',
                      'stdoutTruncated',
                      'stderrTruncated',
                      'redacted',
                    ],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      screen: {
                        type: 'string',
                      },
                      scrollback: {
                        type: 'string',
                      },
                      lastAlternateScreen: {
                        type: 'string',
                      },
                      cols: {
                        type: 'integer',
                        format: 'uint16',
                        minimum: 0,
                        maximum: 65535,
                      },
                      rows: {
                        type: 'integer',
                        format: 'uint16',
                        minimum: 0,
                        maximum: 65535,
                      },
                      cursor: {
                        $ref: '#/$defs/TerminalCursor',
                      },
                      alternateScreen: {
                        type: 'boolean',
                      },
                      truncated: {
                        type: 'boolean',
                      },
                      redacted: {
                        type: 'boolean',
                      },
                      mode: {
                        type: 'string',
                        const: 'pty',
                      },
                    },
                    required: [
                      'mode',
                      'screen',
                      'scrollback',
                      'cols',
                      'rows',
                      'cursor',
                      'alternateScreen',
                      'truncated',
                      'redacted',
                    ],
                  },
                ],
              },
              PipeStream: {
                type: 'string',
                enum: ['stdout', 'stderr'],
              },
              TerminalCursor: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  x: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 0,
                    maximum: 65535,
                  },
                  y: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 0,
                    maximum: 65535,
                  },
                  visible: {
                    type: 'boolean',
                  },
                },
                required: ['x', 'y', 'visible'],
              },
            },
          },
          resources: {},
        },
        read: {
          mode: 'query',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              sessionId: {
                type: 'string',
              },
              ref: {
                type: 'string',
              },
            },
            required: ['sessionId', 'ref'],
            title: 'TerminalTarget',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  value: {
                    $ref: '#/$defs/ResourceUpdate',
                  },
                  kind: {
                    type: 'string',
                    const: 'completed',
                  },
                },
                required: ['kind', 'value'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  message: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                required: ['kind', 'message'],
              },
            ],
            title: 'TerminalOutcome_ResourceUpdate',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              ResourceUpdate: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  ownership: {
                    $ref: '#/$defs/Ownership',
                  },
                  sourceTurnId: {
                    type: 'string',
                  },
                  sourceToolCallId: {
                    type: 'string',
                  },
                  result: {
                    $ref: '#/$defs/ShellSnapshot',
                  },
                },
                required: ['sessionId', 'ownership', 'sourceTurnId', 'sourceToolCallId', 'result'],
              },
              Ownership: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'local',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      sourceSessionId: {
                        type: 'string',
                      },
                      ownerSessionId: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'source_owned',
                      },
                    },
                    required: ['kind', 'sourceSessionId', 'ownerSessionId'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      sourceSessionId: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'source_unavailable',
                      },
                    },
                    required: ['kind', 'sourceSessionId'],
                  },
                ],
              },
              ShellSnapshot: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  kind: {
                    $ref: '#/$defs/SnapshotKind',
                  },
                  ref: {
                    type: 'string',
                  },
                  mode: {
                    $ref: '#/$defs/ShellMode',
                  },
                  status: {
                    $ref: '#/$defs/ShellStatus',
                  },
                  cwd: {
                    type: 'string',
                  },
                  cmd: {
                    type: 'string',
                  },
                  startedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  updatedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  completedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  timeoutMs: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  exitCode: {
                    type: 'integer',
                    format: 'int64',
                  },
                  failureMessage: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  output: {
                    $ref: '#/$defs/ShellOutput',
                  },
                },
                required: [
                  'kind',
                  'ref',
                  'mode',
                  'status',
                  'cwd',
                  'cmd',
                  'startedAt',
                  'updatedAt',
                  'revision',
                ],
              },
              SnapshotKind: {
                type: 'string',
                enum: ['shell_run'],
              },
              ShellMode: {
                type: 'string',
                enum: ['pipes', 'pty'],
              },
              ShellStatus: {
                type: 'string',
                enum: [
                  'starting',
                  'running',
                  'completed',
                  'failed',
                  'timed_out',
                  'cancelled',
                  'orphaned',
                ],
              },
              ShellOutput: {
                oneOf: [
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      stdout: {
                        type: 'string',
                      },
                      stderr: {
                        type: 'string',
                      },
                      latestStream: {
                        $ref: '#/$defs/PipeStream',
                      },
                      stdoutTruncated: {
                        type: 'boolean',
                      },
                      stderrTruncated: {
                        type: 'boolean',
                      },
                      redacted: {
                        type: 'boolean',
                      },
                      mode: {
                        type: 'string',
                        const: 'pipes',
                      },
                    },
                    required: [
                      'mode',
                      'stdout',
                      'stderr',
                      'stdoutTruncated',
                      'stderrTruncated',
                      'redacted',
                    ],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      screen: {
                        type: 'string',
                      },
                      scrollback: {
                        type: 'string',
                      },
                      lastAlternateScreen: {
                        type: 'string',
                      },
                      cols: {
                        type: 'integer',
                        format: 'uint16',
                        minimum: 0,
                        maximum: 65535,
                      },
                      rows: {
                        type: 'integer',
                        format: 'uint16',
                        minimum: 0,
                        maximum: 65535,
                      },
                      cursor: {
                        $ref: '#/$defs/TerminalCursor',
                      },
                      alternateScreen: {
                        type: 'boolean',
                      },
                      truncated: {
                        type: 'boolean',
                      },
                      redacted: {
                        type: 'boolean',
                      },
                      mode: {
                        type: 'string',
                        const: 'pty',
                      },
                    },
                    required: [
                      'mode',
                      'screen',
                      'scrollback',
                      'cols',
                      'rows',
                      'cursor',
                      'alternateScreen',
                      'truncated',
                      'redacted',
                    ],
                  },
                ],
              },
              PipeStream: {
                type: 'string',
                enum: ['stdout', 'stderr'],
              },
              TerminalCursor: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  x: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 0,
                    maximum: 65535,
                  },
                  y: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 0,
                    maximum: 65535,
                  },
                  visible: {
                    type: 'boolean',
                  },
                },
                required: ['x', 'y', 'visible'],
              },
            },
          },
          resources: {},
        },
        readDisplay: {
          mode: 'subscription',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              sessionId: {
                type: 'string',
              },
              ref: {
                type: 'string',
              },
            },
            required: ['sessionId', 'ref'],
            title: 'TerminalTarget',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  value: {
                    $ref: '#/$defs/TerminalDisplayPart',
                  },
                  kind: {
                    type: 'string',
                    const: 'completed',
                  },
                },
                required: ['kind', 'value'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  message: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                required: ['kind', 'message'],
              },
            ],
            title: 'TerminalOutcome_TerminalDisplayPart',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              TerminalDisplayPart: {
                oneOf: [
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      revision: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                        maximum: 9007199254740991,
                      },
                      metadata: {
                        $ref: '#/$defs/Metadata',
                      },
                      scrollbackRows: {
                        type: 'integer',
                        format: 'uint32',
                        minimum: 0,
                      },
                      lastAlternateSize: {
                        anyOf: [
                          {
                            $ref: '#/$defs/TerminalSize',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'begin',
                      },
                    },
                    required: ['kind', 'revision', 'metadata', 'scrollbackRows'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      parts: {
                        type: 'array',
                        items: {
                          $ref: '#/$defs/RowPart',
                        },
                      },
                      kind: {
                        type: 'string',
                        const: 'rows',
                      },
                    },
                    required: ['kind', 'parts'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'end',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                ],
                description:
                  'A finite transfer of one captured durable display. End installs it; these\nparts never claim an original-output cursor or a parser continuation point.',
              },
              Metadata: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  size: {
                    $ref: '#/$defs/TerminalSize',
                  },
                  cursor: {
                    $ref: '#/$defs/TerminalCursor',
                  },
                  cursorShape: {
                    $ref: '#/$defs/CursorShape',
                  },
                  cursorBlinking: {
                    type: 'boolean',
                  },
                  alternateScreen: {
                    type: 'boolean',
                  },
                  truncated: {
                    type: 'boolean',
                  },
                  input: {
                    $ref: '#/$defs/TerminalInputModes',
                  },
                  palette: {
                    type: 'array',
                    items: {
                      type: 'array',
                      prefixItems: [
                        {
                          type: 'integer',
                          format: 'uint16',
                          minimum: 0,
                          maximum: 65535,
                        },
                        {
                          type: 'array',
                          items: {
                            type: 'integer',
                            format: 'uint8',
                            minimum: 0,
                            maximum: 255,
                          },
                          minItems: 3,
                          maxItems: 3,
                        },
                      ],
                      minItems: 2,
                      maxItems: 2,
                    },
                    description:
                      "Palette overrides only; absence preserves the viewing client's theme.",
                  },
                },
                required: [
                  'size',
                  'cursor',
                  'cursorShape',
                  'cursorBlinking',
                  'alternateScreen',
                  'truncated',
                  'input',
                  'palette',
                ],
              },
              TerminalSize: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  cols: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 2,
                    maximum: 1024,
                  },
                  rows: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 1,
                    maximum: 1024,
                  },
                },
                required: ['cols', 'rows'],
                description:
                  'Shared by native PTY allocation, input validation and screen rendering.',
              },
              TerminalCursor: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  x: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 0,
                    maximum: 65535,
                  },
                  y: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 0,
                    maximum: 65535,
                  },
                  visible: {
                    type: 'boolean',
                  },
                },
                required: ['x', 'y', 'visible'],
              },
              CursorShape: {
                type: 'string',
                enum: ['block', 'underline', 'beam', 'hollow_block', 'hidden'],
              },
              TerminalInputModes: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  applicationCursorKeysMode: {
                    type: 'boolean',
                  },
                  mouseTrackingMode: {
                    $ref: '#/$defs/MouseTracking',
                  },
                  mouseEncoding: {
                    $ref: '#/$defs/MouseEncoding',
                  },
                },
                required: ['applicationCursorKeysMode', 'mouseTrackingMode', 'mouseEncoding'],
              },
              MouseTracking: {
                type: 'string',
                enum: ['none', 'x10', 'vt200', 'drag', 'any'],
              },
              MouseEncoding: {
                type: 'string',
                enum: ['default', 'sgr', 'sgr_pixels'],
              },
              RowPart: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  buffer: {
                    $ref: '#/$defs/Buffer',
                  },
                  row: {
                    type: 'integer',
                    format: 'uint32',
                    minimum: 0,
                  },
                  column: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 0,
                    maximum: 65535,
                  },
                  runs: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/Run',
                    },
                  },
                },
                required: ['buffer', 'row', 'column', 'runs'],
              },
              Buffer: {
                type: 'string',
                enum: ['scrollback', 'screen', 'last_alternate'],
              },
              Run: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  style: {
                    $ref: '#/$defs/Style',
                  },
                  text: {
                    type: 'string',
                  },
                  lengths: {
                    type: 'array',
                    items: {
                      type: 'integer',
                      format: 'uint8',
                      minimum: 0,
                      maximum: 255,
                    },
                  },
                },
                required: ['style', 'text'],
                description:
                  'Consecutive cells with the same style. `text` includes every blank and\ncombining character. Empty `lengths` means one Unicode scalar per cell;\notherwise each entry is the scalar count of one cell, including its base.',
              },
              Style: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  foreground: {
                    $ref: '#/$defs/Color',
                  },
                  background: {
                    $ref: '#/$defs/Color',
                  },
                  flags: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 0,
                    maximum: 65535,
                  },
                  underline: {
                    anyOf: [
                      {
                        $ref: '#/$defs/Color',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                required: ['foreground', 'background', 'flags'],
                description:
                  "Cell flags use the terminal's fixed bit layout: inverse=1, bold=2, italic=4,\nunderline=8, wrap=16, wide=32, wide spacer=64, dim=128, hidden=256,\nstrike=512, leading wide spacer=1024, double/curl/dotted/dashed underline\n=2048/4096/8192/16384. Geometry flags remain attached to their original cell.",
              },
              Color: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      named: {
                        type: 'integer',
                        format: 'uint16',
                        minimum: 0,
                        maximum: 65535,
                      },
                    },
                    required: ['named'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      indexed: {
                        type: 'integer',
                        format: 'uint8',
                        minimum: 0,
                        maximum: 255,
                      },
                    },
                    required: ['indexed'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      rgb: {
                        type: 'array',
                        items: {
                          type: 'integer',
                          format: 'uint8',
                          minimum: 0,
                          maximum: 255,
                        },
                        minItems: 3,
                        maxItems: 3,
                      },
                    },
                    required: ['rgb'],
                    additionalProperties: false,
                  },
                ],
                description:
                  'Named colors retain their ANSI role (including default foreground/background),\nwhile indexed colors retain their exact palette entry even under bold/dim.',
              },
            },
          },
          resources: {},
        },
        readOutput: {
          mode: 'query',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              target: {
                $ref: '#/$defs/TerminalTarget',
              },
              after: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
                maximum: 9007199254740991,
                default: 0,
              },
            },
            required: ['target'],
            description:
              "Exclusive cursor in this original target's native Data/Resize log. A Data\ndelivery can combine adjacent records; its sequence is the last consumed\nnative record. Any original cursor remains valid, including inside a batch.",
            title: 'TerminalOutputRequest',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              TerminalTarget: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  ref: {
                    type: 'string',
                  },
                },
                required: ['sessionId', 'ref'],
              },
            },
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  value: {
                    $ref: '#/$defs/TerminalOutputEvent',
                  },
                  kind: {
                    type: 'string',
                    const: 'completed',
                  },
                },
                required: ['kind', 'value'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  message: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                required: ['kind', 'message'],
              },
            ],
            title: 'TerminalOutcome_TerminalOutputEvent',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              TerminalOutputEvent: {
                oneOf: [
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      sequence: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 1,
                        maximum: 9007199254740991,
                      },
                      size: {
                        $ref: '#/$defs/TerminalSize',
                      },
                      initialSize: {
                        $ref: '#/$defs/TerminalSize',
                      },
                      dataBase64: {
                        type: 'string',
                        minLength: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'data',
                      },
                    },
                    required: ['kind', 'sequence', 'size', 'initialSize', 'dataBase64'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      sequence: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 1,
                        maximum: 9007199254740991,
                      },
                      size: {
                        $ref: '#/$defs/TerminalSize',
                      },
                      initialSize: {
                        $ref: '#/$defs/TerminalSize',
                      },
                      kind: {
                        type: 'string',
                        const: 'resize',
                      },
                    },
                    required: ['kind', 'sequence', 'size', 'initialSize'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      after: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                        maximum: 9007199254740991,
                      },
                      size: {
                        $ref: '#/$defs/TerminalSize',
                      },
                      initialSize: {
                        $ref: '#/$defs/TerminalSize',
                      },
                      kind: {
                        type: 'string',
                        const: 'pending',
                      },
                    },
                    required: ['kind', 'after', 'size', 'initialSize'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      after: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                        maximum: 9007199254740991,
                      },
                      size: {
                        $ref: '#/$defs/TerminalSize',
                      },
                      initialSize: {
                        $ref: '#/$defs/TerminalSize',
                      },
                      kind: {
                        type: 'string',
                        const: 'closed',
                      },
                    },
                    required: ['kind', 'after', 'size', 'initialSize'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      reason: {
                        $ref: '#/$defs/TerminalOutputUnavailable',
                      },
                      kind: {
                        type: 'string',
                        const: 'unavailable',
                      },
                    },
                    required: ['kind', 'reason'],
                  },
                ],
                description:
                  'Ephemeral output observation; Closed is not a process cleanup receipt.',
              },
              TerminalSize: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  cols: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 2,
                    maximum: 1024,
                  },
                  rows: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 1,
                    maximum: 1024,
                  },
                },
                required: ['cols', 'rows'],
                description:
                  'Shared by native PTY allocation, input validation and screen rendering.',
              },
              TerminalOutputUnavailable: {
                type: 'string',
                enum: ['not_retained'],
              },
            },
          },
          resources: {},
        },
        release: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              target: {
                $ref: '#/$defs/TerminalTarget',
              },
              controllerId: {
                type: 'string',
                format: 'uuid',
              },
            },
            required: ['target', 'controllerId'],
            title: 'TerminalController',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              TerminalTarget: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  ref: {
                    type: 'string',
                  },
                },
                required: ['sessionId', 'ref'],
              },
            },
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  value: {
                    $ref: '#/$defs/TerminalReleased',
                  },
                  kind: {
                    type: 'string',
                    const: 'completed',
                  },
                },
                required: ['kind', 'value'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  message: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                required: ['kind', 'message'],
              },
            ],
            title: 'TerminalOutcome_TerminalReleased',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              TerminalReleased: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  controllerId: {
                    type: 'string',
                    format: 'uuid',
                  },
                  released: {
                    type: 'boolean',
                  },
                },
                required: ['controllerId', 'released'],
              },
            },
          },
          resources: {},
        },
        start: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              sessionId: {
                type: 'string',
              },
              command: {
                type: ['string', 'null'],
                description:
                  'Omit for an interactive shell; an explicit command runs with bounded pipes.',
              },
              size: {
                anyOf: [
                  {
                    $ref: '#/$defs/TerminalSize',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
            },
            required: ['sessionId'],
            title: 'TerminalStart',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              TerminalSize: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  cols: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 2,
                    maximum: 1024,
                  },
                  rows: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 1,
                    maximum: 1024,
                  },
                },
                required: ['cols', 'rows'],
                description:
                  'Shared by native PTY allocation, input validation and screen rendering.',
              },
            },
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  value: {
                    $ref: '#/$defs/ResourceUpdate',
                  },
                  kind: {
                    type: 'string',
                    const: 'completed',
                  },
                },
                required: ['kind', 'value'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  message: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                required: ['kind', 'message'],
              },
            ],
            title: 'TerminalOutcome_ResourceUpdate',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              ResourceUpdate: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  ownership: {
                    $ref: '#/$defs/Ownership',
                  },
                  sourceTurnId: {
                    type: 'string',
                  },
                  sourceToolCallId: {
                    type: 'string',
                  },
                  result: {
                    $ref: '#/$defs/ShellSnapshot',
                  },
                },
                required: ['sessionId', 'ownership', 'sourceTurnId', 'sourceToolCallId', 'result'],
              },
              Ownership: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'local',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      sourceSessionId: {
                        type: 'string',
                      },
                      ownerSessionId: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'source_owned',
                      },
                    },
                    required: ['kind', 'sourceSessionId', 'ownerSessionId'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      sourceSessionId: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'source_unavailable',
                      },
                    },
                    required: ['kind', 'sourceSessionId'],
                  },
                ],
              },
              ShellSnapshot: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  kind: {
                    $ref: '#/$defs/SnapshotKind',
                  },
                  ref: {
                    type: 'string',
                  },
                  mode: {
                    $ref: '#/$defs/ShellMode',
                  },
                  status: {
                    $ref: '#/$defs/ShellStatus',
                  },
                  cwd: {
                    type: 'string',
                  },
                  cmd: {
                    type: 'string',
                  },
                  startedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  updatedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  completedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  timeoutMs: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  exitCode: {
                    type: 'integer',
                    format: 'int64',
                  },
                  failureMessage: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  output: {
                    $ref: '#/$defs/ShellOutput',
                  },
                },
                required: [
                  'kind',
                  'ref',
                  'mode',
                  'status',
                  'cwd',
                  'cmd',
                  'startedAt',
                  'updatedAt',
                  'revision',
                ],
              },
              SnapshotKind: {
                type: 'string',
                enum: ['shell_run'],
              },
              ShellMode: {
                type: 'string',
                enum: ['pipes', 'pty'],
              },
              ShellStatus: {
                type: 'string',
                enum: [
                  'starting',
                  'running',
                  'completed',
                  'failed',
                  'timed_out',
                  'cancelled',
                  'orphaned',
                ],
              },
              ShellOutput: {
                oneOf: [
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      stdout: {
                        type: 'string',
                      },
                      stderr: {
                        type: 'string',
                      },
                      latestStream: {
                        $ref: '#/$defs/PipeStream',
                      },
                      stdoutTruncated: {
                        type: 'boolean',
                      },
                      stderrTruncated: {
                        type: 'boolean',
                      },
                      redacted: {
                        type: 'boolean',
                      },
                      mode: {
                        type: 'string',
                        const: 'pipes',
                      },
                    },
                    required: [
                      'mode',
                      'stdout',
                      'stderr',
                      'stdoutTruncated',
                      'stderrTruncated',
                      'redacted',
                    ],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      screen: {
                        type: 'string',
                      },
                      scrollback: {
                        type: 'string',
                      },
                      lastAlternateScreen: {
                        type: 'string',
                      },
                      cols: {
                        type: 'integer',
                        format: 'uint16',
                        minimum: 0,
                        maximum: 65535,
                      },
                      rows: {
                        type: 'integer',
                        format: 'uint16',
                        minimum: 0,
                        maximum: 65535,
                      },
                      cursor: {
                        $ref: '#/$defs/TerminalCursor',
                      },
                      alternateScreen: {
                        type: 'boolean',
                      },
                      truncated: {
                        type: 'boolean',
                      },
                      redacted: {
                        type: 'boolean',
                      },
                      mode: {
                        type: 'string',
                        const: 'pty',
                      },
                    },
                    required: [
                      'mode',
                      'screen',
                      'scrollback',
                      'cols',
                      'rows',
                      'cursor',
                      'alternateScreen',
                      'truncated',
                      'redacted',
                    ],
                  },
                ],
              },
              PipeStream: {
                type: 'string',
                enum: ['stdout', 'stderr'],
              },
              TerminalCursor: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  x: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 0,
                    maximum: 65535,
                  },
                  y: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 0,
                    maximum: 65535,
                  },
                  visible: {
                    type: 'boolean',
                  },
                },
                required: ['x', 'y', 'visible'],
              },
            },
          },
          resources: {},
        },
        stop: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              sessionId: {
                type: 'string',
              },
              ref: {
                type: 'string',
              },
            },
            required: ['sessionId', 'ref'],
            title: 'TerminalTarget',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  value: {
                    $ref: '#/$defs/TerminalStopped',
                  },
                  kind: {
                    type: 'string',
                    const: 'completed',
                  },
                },
                required: ['kind', 'value'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  message: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                required: ['kind', 'message'],
              },
            ],
            title: 'TerminalOutcome_TerminalStopped',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              TerminalStopped: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  applied: {
                    type: 'boolean',
                  },
                  resource: {
                    $ref: '#/$defs/ResourceUpdate',
                  },
                },
                required: ['applied', 'resource'],
              },
              ResourceUpdate: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  ownership: {
                    $ref: '#/$defs/Ownership',
                  },
                  sourceTurnId: {
                    type: 'string',
                  },
                  sourceToolCallId: {
                    type: 'string',
                  },
                  result: {
                    $ref: '#/$defs/ShellSnapshot',
                  },
                },
                required: ['sessionId', 'ownership', 'sourceTurnId', 'sourceToolCallId', 'result'],
              },
              Ownership: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'local',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      sourceSessionId: {
                        type: 'string',
                      },
                      ownerSessionId: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'source_owned',
                      },
                    },
                    required: ['kind', 'sourceSessionId', 'ownerSessionId'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      sourceSessionId: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'source_unavailable',
                      },
                    },
                    required: ['kind', 'sourceSessionId'],
                  },
                ],
              },
              ShellSnapshot: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  kind: {
                    $ref: '#/$defs/SnapshotKind',
                  },
                  ref: {
                    type: 'string',
                  },
                  mode: {
                    $ref: '#/$defs/ShellMode',
                  },
                  status: {
                    $ref: '#/$defs/ShellStatus',
                  },
                  cwd: {
                    type: 'string',
                  },
                  cmd: {
                    type: 'string',
                  },
                  startedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  updatedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  completedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  timeoutMs: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  exitCode: {
                    type: 'integer',
                    format: 'int64',
                  },
                  failureMessage: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  output: {
                    $ref: '#/$defs/ShellOutput',
                  },
                },
                required: [
                  'kind',
                  'ref',
                  'mode',
                  'status',
                  'cwd',
                  'cmd',
                  'startedAt',
                  'updatedAt',
                  'revision',
                ],
              },
              SnapshotKind: {
                type: 'string',
                enum: ['shell_run'],
              },
              ShellMode: {
                type: 'string',
                enum: ['pipes', 'pty'],
              },
              ShellStatus: {
                type: 'string',
                enum: [
                  'starting',
                  'running',
                  'completed',
                  'failed',
                  'timed_out',
                  'cancelled',
                  'orphaned',
                ],
              },
              ShellOutput: {
                oneOf: [
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      stdout: {
                        type: 'string',
                      },
                      stderr: {
                        type: 'string',
                      },
                      latestStream: {
                        $ref: '#/$defs/PipeStream',
                      },
                      stdoutTruncated: {
                        type: 'boolean',
                      },
                      stderrTruncated: {
                        type: 'boolean',
                      },
                      redacted: {
                        type: 'boolean',
                      },
                      mode: {
                        type: 'string',
                        const: 'pipes',
                      },
                    },
                    required: [
                      'mode',
                      'stdout',
                      'stderr',
                      'stdoutTruncated',
                      'stderrTruncated',
                      'redacted',
                    ],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      screen: {
                        type: 'string',
                      },
                      scrollback: {
                        type: 'string',
                      },
                      lastAlternateScreen: {
                        type: 'string',
                      },
                      cols: {
                        type: 'integer',
                        format: 'uint16',
                        minimum: 0,
                        maximum: 65535,
                      },
                      rows: {
                        type: 'integer',
                        format: 'uint16',
                        minimum: 0,
                        maximum: 65535,
                      },
                      cursor: {
                        $ref: '#/$defs/TerminalCursor',
                      },
                      alternateScreen: {
                        type: 'boolean',
                      },
                      truncated: {
                        type: 'boolean',
                      },
                      redacted: {
                        type: 'boolean',
                      },
                      mode: {
                        type: 'string',
                        const: 'pty',
                      },
                    },
                    required: [
                      'mode',
                      'screen',
                      'scrollback',
                      'cols',
                      'rows',
                      'cursor',
                      'alternateScreen',
                      'truncated',
                      'redacted',
                    ],
                  },
                ],
              },
              PipeStream: {
                type: 'string',
                enum: ['stdout', 'stderr'],
              },
              TerminalCursor: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  x: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 0,
                    maximum: 65535,
                  },
                  y: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 0,
                    maximum: 65535,
                  },
                  visible: {
                    type: 'boolean',
                  },
                },
                required: ['x', 'y', 'visible'],
              },
            },
          },
          resources: {},
        },
        watch: {
          mode: 'subscription',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              sessionId: {
                type: 'string',
              },
              ref: {
                type: 'string',
              },
            },
            required: ['sessionId', 'ref'],
            title: 'TerminalTarget',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  value: {
                    $ref: '#/$defs/ResourceUpdate',
                  },
                  kind: {
                    type: 'string',
                    const: 'completed',
                  },
                },
                required: ['kind', 'value'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  message: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                required: ['kind', 'message'],
              },
            ],
            title: 'TerminalOutcome_ResourceUpdate',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              ResourceUpdate: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  ownership: {
                    $ref: '#/$defs/Ownership',
                  },
                  sourceTurnId: {
                    type: 'string',
                  },
                  sourceToolCallId: {
                    type: 'string',
                  },
                  result: {
                    $ref: '#/$defs/ShellSnapshot',
                  },
                },
                required: ['sessionId', 'ownership', 'sourceTurnId', 'sourceToolCallId', 'result'],
              },
              Ownership: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'local',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      sourceSessionId: {
                        type: 'string',
                      },
                      ownerSessionId: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'source_owned',
                      },
                    },
                    required: ['kind', 'sourceSessionId', 'ownerSessionId'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      sourceSessionId: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'source_unavailable',
                      },
                    },
                    required: ['kind', 'sourceSessionId'],
                  },
                ],
              },
              ShellSnapshot: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  kind: {
                    $ref: '#/$defs/SnapshotKind',
                  },
                  ref: {
                    type: 'string',
                  },
                  mode: {
                    $ref: '#/$defs/ShellMode',
                  },
                  status: {
                    $ref: '#/$defs/ShellStatus',
                  },
                  cwd: {
                    type: 'string',
                  },
                  cmd: {
                    type: 'string',
                  },
                  startedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  updatedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  completedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  timeoutMs: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  exitCode: {
                    type: 'integer',
                    format: 'int64',
                  },
                  failureMessage: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  output: {
                    $ref: '#/$defs/ShellOutput',
                  },
                },
                required: [
                  'kind',
                  'ref',
                  'mode',
                  'status',
                  'cwd',
                  'cmd',
                  'startedAt',
                  'updatedAt',
                  'revision',
                ],
              },
              SnapshotKind: {
                type: 'string',
                enum: ['shell_run'],
              },
              ShellMode: {
                type: 'string',
                enum: ['pipes', 'pty'],
              },
              ShellStatus: {
                type: 'string',
                enum: [
                  'starting',
                  'running',
                  'completed',
                  'failed',
                  'timed_out',
                  'cancelled',
                  'orphaned',
                ],
              },
              ShellOutput: {
                oneOf: [
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      stdout: {
                        type: 'string',
                      },
                      stderr: {
                        type: 'string',
                      },
                      latestStream: {
                        $ref: '#/$defs/PipeStream',
                      },
                      stdoutTruncated: {
                        type: 'boolean',
                      },
                      stderrTruncated: {
                        type: 'boolean',
                      },
                      redacted: {
                        type: 'boolean',
                      },
                      mode: {
                        type: 'string',
                        const: 'pipes',
                      },
                    },
                    required: [
                      'mode',
                      'stdout',
                      'stderr',
                      'stdoutTruncated',
                      'stderrTruncated',
                      'redacted',
                    ],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      screen: {
                        type: 'string',
                      },
                      scrollback: {
                        type: 'string',
                      },
                      lastAlternateScreen: {
                        type: 'string',
                      },
                      cols: {
                        type: 'integer',
                        format: 'uint16',
                        minimum: 0,
                        maximum: 65535,
                      },
                      rows: {
                        type: 'integer',
                        format: 'uint16',
                        minimum: 0,
                        maximum: 65535,
                      },
                      cursor: {
                        $ref: '#/$defs/TerminalCursor',
                      },
                      alternateScreen: {
                        type: 'boolean',
                      },
                      truncated: {
                        type: 'boolean',
                      },
                      redacted: {
                        type: 'boolean',
                      },
                      mode: {
                        type: 'string',
                        const: 'pty',
                      },
                    },
                    required: [
                      'mode',
                      'screen',
                      'scrollback',
                      'cols',
                      'rows',
                      'cursor',
                      'alternateScreen',
                      'truncated',
                      'redacted',
                    ],
                  },
                ],
              },
              PipeStream: {
                type: 'string',
                enum: ['stdout', 'stderr'],
              },
              TerminalCursor: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  x: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 0,
                    maximum: 65535,
                  },
                  y: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 0,
                    maximum: 65535,
                  },
                  visible: {
                    type: 'boolean',
                  },
                },
                required: ['x', 'y', 'visible'],
              },
            },
          },
          resources: {},
        },
        watchList: {
          mode: 'subscription',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              sessionId: {
                type: 'string',
              },
              offset: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
                maximum: 9007199254740991,
                default: 0,
              },
            },
            required: ['sessionId'],
            title: 'TerminalList',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  value: {
                    $ref: '#/$defs/TerminalPage',
                  },
                  kind: {
                    type: 'string',
                    const: 'completed',
                  },
                },
                required: ['kind', 'value'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  message: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                required: ['kind', 'message'],
              },
            ],
            title: 'TerminalOutcome_TerminalPage',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              TerminalPage: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  resources: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/ResourceUpdate',
                    },
                  },
                  revision: {
                    type: 'string',
                  },
                  total: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  nextOffset: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                required: ['resources', 'revision', 'total'],
              },
              ResourceUpdate: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  ownership: {
                    $ref: '#/$defs/Ownership',
                  },
                  sourceTurnId: {
                    type: 'string',
                  },
                  sourceToolCallId: {
                    type: 'string',
                  },
                  result: {
                    $ref: '#/$defs/ShellSnapshot',
                  },
                },
                required: ['sessionId', 'ownership', 'sourceTurnId', 'sourceToolCallId', 'result'],
              },
              Ownership: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'local',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      sourceSessionId: {
                        type: 'string',
                      },
                      ownerSessionId: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'source_owned',
                      },
                    },
                    required: ['kind', 'sourceSessionId', 'ownerSessionId'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      sourceSessionId: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'source_unavailable',
                      },
                    },
                    required: ['kind', 'sourceSessionId'],
                  },
                ],
              },
              ShellSnapshot: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  kind: {
                    $ref: '#/$defs/SnapshotKind',
                  },
                  ref: {
                    type: 'string',
                  },
                  mode: {
                    $ref: '#/$defs/ShellMode',
                  },
                  status: {
                    $ref: '#/$defs/ShellStatus',
                  },
                  cwd: {
                    type: 'string',
                  },
                  cmd: {
                    type: 'string',
                  },
                  startedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  updatedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  completedAt: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  timeoutMs: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  exitCode: {
                    type: 'integer',
                    format: 'int64',
                  },
                  failureMessage: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  output: {
                    $ref: '#/$defs/ShellOutput',
                  },
                },
                required: [
                  'kind',
                  'ref',
                  'mode',
                  'status',
                  'cwd',
                  'cmd',
                  'startedAt',
                  'updatedAt',
                  'revision',
                ],
              },
              SnapshotKind: {
                type: 'string',
                enum: ['shell_run'],
              },
              ShellMode: {
                type: 'string',
                enum: ['pipes', 'pty'],
              },
              ShellStatus: {
                type: 'string',
                enum: [
                  'starting',
                  'running',
                  'completed',
                  'failed',
                  'timed_out',
                  'cancelled',
                  'orphaned',
                ],
              },
              ShellOutput: {
                oneOf: [
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      stdout: {
                        type: 'string',
                      },
                      stderr: {
                        type: 'string',
                      },
                      latestStream: {
                        $ref: '#/$defs/PipeStream',
                      },
                      stdoutTruncated: {
                        type: 'boolean',
                      },
                      stderrTruncated: {
                        type: 'boolean',
                      },
                      redacted: {
                        type: 'boolean',
                      },
                      mode: {
                        type: 'string',
                        const: 'pipes',
                      },
                    },
                    required: [
                      'mode',
                      'stdout',
                      'stderr',
                      'stdoutTruncated',
                      'stderrTruncated',
                      'redacted',
                    ],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      screen: {
                        type: 'string',
                      },
                      scrollback: {
                        type: 'string',
                      },
                      lastAlternateScreen: {
                        type: 'string',
                      },
                      cols: {
                        type: 'integer',
                        format: 'uint16',
                        minimum: 0,
                        maximum: 65535,
                      },
                      rows: {
                        type: 'integer',
                        format: 'uint16',
                        minimum: 0,
                        maximum: 65535,
                      },
                      cursor: {
                        $ref: '#/$defs/TerminalCursor',
                      },
                      alternateScreen: {
                        type: 'boolean',
                      },
                      truncated: {
                        type: 'boolean',
                      },
                      redacted: {
                        type: 'boolean',
                      },
                      mode: {
                        type: 'string',
                        const: 'pty',
                      },
                    },
                    required: [
                      'mode',
                      'screen',
                      'scrollback',
                      'cols',
                      'rows',
                      'cursor',
                      'alternateScreen',
                      'truncated',
                      'redacted',
                    ],
                  },
                ],
              },
              PipeStream: {
                type: 'string',
                enum: ['stdout', 'stderr'],
              },
              TerminalCursor: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  x: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 0,
                    maximum: 65535,
                  },
                  y: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 0,
                    maximum: 65535,
                  },
                  visible: {
                    type: 'boolean',
                  },
                },
                required: ['x', 'y', 'visible'],
              },
            },
          },
          resources: {},
        },
        watchOutput: {
          mode: 'subscription',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              target: {
                $ref: '#/$defs/TerminalTarget',
              },
              after: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
                maximum: 9007199254740991,
                default: 0,
              },
            },
            required: ['target'],
            description:
              "Exclusive cursor in this original target's native Data/Resize log. A Data\ndelivery can combine adjacent records; its sequence is the last consumed\nnative record. Any original cursor remains valid, including inside a batch.",
            title: 'TerminalOutputRequest',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              TerminalTarget: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  sessionId: {
                    type: 'string',
                  },
                  ref: {
                    type: 'string',
                  },
                },
                required: ['sessionId', 'ref'],
              },
            },
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  value: {
                    $ref: '#/$defs/TerminalOutputEvent',
                  },
                  kind: {
                    type: 'string',
                    const: 'completed',
                  },
                },
                required: ['kind', 'value'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  message: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                required: ['kind', 'message'],
              },
            ],
            title: 'TerminalOutcome_TerminalOutputEvent',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              TerminalOutputEvent: {
                oneOf: [
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      sequence: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 1,
                        maximum: 9007199254740991,
                      },
                      size: {
                        $ref: '#/$defs/TerminalSize',
                      },
                      initialSize: {
                        $ref: '#/$defs/TerminalSize',
                      },
                      dataBase64: {
                        type: 'string',
                        minLength: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'data',
                      },
                    },
                    required: ['kind', 'sequence', 'size', 'initialSize', 'dataBase64'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      sequence: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 1,
                        maximum: 9007199254740991,
                      },
                      size: {
                        $ref: '#/$defs/TerminalSize',
                      },
                      initialSize: {
                        $ref: '#/$defs/TerminalSize',
                      },
                      kind: {
                        type: 'string',
                        const: 'resize',
                      },
                    },
                    required: ['kind', 'sequence', 'size', 'initialSize'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      after: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                        maximum: 9007199254740991,
                      },
                      size: {
                        $ref: '#/$defs/TerminalSize',
                      },
                      initialSize: {
                        $ref: '#/$defs/TerminalSize',
                      },
                      kind: {
                        type: 'string',
                        const: 'pending',
                      },
                    },
                    required: ['kind', 'after', 'size', 'initialSize'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      after: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                        maximum: 9007199254740991,
                      },
                      size: {
                        $ref: '#/$defs/TerminalSize',
                      },
                      initialSize: {
                        $ref: '#/$defs/TerminalSize',
                      },
                      kind: {
                        type: 'string',
                        const: 'closed',
                      },
                    },
                    required: ['kind', 'after', 'size', 'initialSize'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      reason: {
                        $ref: '#/$defs/TerminalOutputUnavailable',
                      },
                      kind: {
                        type: 'string',
                        const: 'unavailable',
                      },
                    },
                    required: ['kind', 'reason'],
                  },
                ],
                description:
                  'Ephemeral output observation; Closed is not a process cleanup receipt.',
              },
              TerminalSize: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  cols: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 2,
                    maximum: 1024,
                  },
                  rows: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 1,
                    maximum: 1024,
                  },
                },
                required: ['cols', 'rows'],
                description:
                  'Shared by native PTY allocation, input validation and screen rendering.',
              },
              TerminalOutputUnavailable: {
                type: 'string',
                enum: ['not_retained'],
              },
            },
          },
          resources: {},
        },
      },
    },
  },
  settings: {
    name: 'maka.settings.Settings',
    version: 1,
    transport: 'remote',
    interface: {
      kind: 'service',
      methods: {
        assistantPreferences: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'SettingsPreferencesRead',
            type: 'object',
            additionalProperties: false,
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'SettingsAssistantPreferences',
            type: 'object',
            properties: {
              language: {
                anyOf: [
                  {
                    $ref: '#/$defs/LanguagePreference',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              resolvedLanguage: {
                $ref: '#/$defs/Language',
              },
              compactionPrompt: {
                type: 'string',
              },
              defaultCompactionPrompt: {
                type: 'string',
              },
              revision: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
              displayName: {
                type: 'string',
              },
              workspaceInstructions: {
                type: 'boolean',
              },
              incognitoActive: {
                type: 'boolean',
              },
              shellTitles: {
                type: 'boolean',
              },
            },
            additionalProperties: false,
            required: [
              'language',
              'resolvedLanguage',
              'compactionPrompt',
              'defaultCompactionPrompt',
              'revision',
              'displayName',
              'workspaceInstructions',
              'incognitoActive',
              'shellTitles',
            ],
            $defs: {
              LanguagePreference: {
                type: 'string',
                enum: ['auto', 'en', 'zh-CN', 'zh-TW'],
              },
              Language: {
                type: 'string',
                enum: ['en', 'zh-CN', 'zh-TW'],
              },
            },
          },
          resources: {},
        },
        connection: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'SettingsConnectionRead',
            type: 'object',
            properties: {
              connectionId: {
                type: 'string',
              },
              revision: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
              includeEditingFacts: {
                description:
                  'Opt in to the complete editing projection; credential reads stay narrow.',
                type: 'boolean',
                default: false,
              },
            },
            additionalProperties: false,
            required: ['connectionId', 'revision'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'SettingsConnectionDetail',
            oneOf: [
              {
                type: 'object',
                properties: {
                  actual: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ConnectionVersionBasis',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  kind: {
                    type: 'string',
                    const: 'stale',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'actual'],
              },
              {
                type: 'object',
                properties: {
                  target: {
                    $ref: '#/$defs/ConnectionCredentialTarget',
                  },
                  name: {
                    type: 'string',
                  },
                  enabled: {
                    type: 'boolean',
                  },
                  enabledModelCount: {
                    type: 'integer',
                    format: 'uint',
                    minimum: 0,
                  },
                  editing: {
                    $ref: '#/$defs/SettingsConnectionEditingFacts',
                  },
                  kind: {
                    type: 'string',
                    const: 'ready',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'target', 'name', 'enabled', 'enabledModelCount'],
              },
            ],
            $defs: {
              ConnectionVersionBasis: {
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'revision'],
              },
              ConnectionCredentialTarget: {
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  slug: {
                    type: 'string',
                  },
                  provider: {
                    $ref: '#/$defs/Identity',
                  },
                  configuration: {
                    type: 'object',
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'revision', 'slug', 'provider', 'configuration'],
              },
              Identity: {
                description:
                  'Durable recipient, not a registration lease. Re-loading the same package can\nrestore it; another package, Entry or scope cannot inherit its credentials.',
                type: 'object',
                properties: {
                  packageId: {
                    type: 'string',
                  },
                  entryId: {
                    type: 'string',
                  },
                  scope: {
                    type: 'string',
                  },
                  name: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['packageId', 'entryId', 'scope', 'name'],
              },
              SettingsConnectionEditingFacts: {
                type: 'object',
                properties: {
                  enabledModelIds: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  modelOverrides: {
                    type: ['object', 'null'],
                    additionalProperties: {
                      $ref: '#/$defs/ModelOverride',
                    },
                  },
                  requestBodyOverlay: {
                    type: ['object', 'null'],
                    additionalProperties: true,
                  },
                },
                additionalProperties: false,
                required: ['enabledModelIds', 'modelOverrides', 'requestBodyOverlay'],
              },
              ModelOverride: {
                type: 'object',
                properties: {
                  adapter: {
                    description:
                      "Public adapter contribution name; omitted selects the wire's default.",
                    type: 'string',
                  },
                  codeMode: {
                    description:
                      'Omitted means model-specific defaults; false is an explicit opt-out.',
                    type: 'boolean',
                  },
                  codeModeLanguage: {
                    description: 'Code Mode interpreter; omitted selects JavaScript.',
                    $ref: '#/$defs/CodeLanguage',
                  },
                  applyPatch: {
                    description:
                      'Independent of Code Mode: select patch editing or structured Edit/Write.',
                    type: 'boolean',
                  },
                  thinkingLevels: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/ThinkingLevel',
                    },
                  },
                  defaultThinkingLevel: {
                    $ref: '#/$defs/ThinkingLevel',
                  },
                  vision: {
                    type: 'boolean',
                  },
                  contextWindow: {
                    description:
                      'Override total input-plus-output capacity, without subtracting a reply budget.',
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  compactionThreshold: {
                    description:
                      'Optional override of the automatic compaction threshold, in retained tokens.\nBy default Host uses 85% of the smaller total window/input ceiling.',
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  inputLimit: {
                    description:
                      'Independent input ceiling; also caps the default compaction input budget.',
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  maxOutputTokens: {
                    description:
                      'Requested per-step output budget, subject to provider and remaining-capacity caps.',
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  displayName: {
                    type: 'string',
                  },
                  description: {
                    type: 'string',
                  },
                  apiProtocol: {
                    $ref: '#/$defs/ApiProtocol',
                  },
                  knowledgeCutoff: {
                    type: 'string',
                  },
                  capabilities: {
                    $ref: '#/$defs/ModelOverrideCapabilities',
                  },
                  modalities: {
                    $ref: '#/$defs/ModelModalities',
                  },
                  serviceTier: {
                    $ref: '#/$defs/RelayServiceTier',
                  },
                },
                additionalProperties: false,
              },
              CodeLanguage: {
                description: 'Interpreter used only for model-facing Code Mode cells.',
                type: 'string',
                enum: ['javascript', 'python'],
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
              ApiProtocol: {
                type: 'string',
                enum: ['openai-chat-completions', 'openai-responses', 'anthropic-messages'],
              },
              ModelOverrideCapabilities: {
                description: 'Vision has one declaration owner: ModelOverride::vision.',
                type: 'object',
                properties: {
                  chat: {
                    type: 'boolean',
                  },
                  reasoning: {
                    type: 'boolean',
                  },
                  functionCalling: {
                    type: 'boolean',
                  },
                  parallelToolCalls: {
                    type: 'boolean',
                  },
                  imageGeneration: {
                    type: 'boolean',
                  },
                  webSearch: {
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
              },
              ModelModalities: {
                type: 'object',
                properties: {
                  input: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/ModelModality',
                    },
                  },
                  output: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/ModelModality',
                    },
                  },
                },
                additionalProperties: false,
                required: ['input', 'output'],
              },
              ModelModality: {
                type: 'string',
                enum: ['text', 'image', 'audio', 'pdf', 'video'],
              },
              RelayServiceTier: {
                type: 'string',
                enum: ['fast'],
              },
            },
          },
          resources: {},
        },
        connections: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'SettingsConnectionsRead',
            oneOf: [
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'start',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  offset: {
                    type: 'integer',
                    format: 'uint',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'continue',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'revision', 'offset'],
              },
            ],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'SettingsConnectionsPage',
            oneOf: [
              {
                type: 'object',
                properties: {
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'changed',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'revision'],
              },
              {
                type: 'object',
                properties: {
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  defaultTarget: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ConnectionTarget',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  connections: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/SettingsConnectionSummary',
                    },
                    maxItems: 16,
                  },
                  next: {
                    type: ['integer', 'null'],
                    format: 'uint',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'ready',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'revision', 'defaultTarget', 'connections', 'next'],
              },
            ],
            $defs: {
              ConnectionTarget: {
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                  },
                  modelId: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'modelId'],
              },
              SettingsConnectionSummary: {
                type: 'object',
                properties: {
                  editable: {
                    description:
                      'Editing controls implemented by this Settings service for the provider.',
                    type: 'boolean',
                  },
                  basis: {
                    $ref: '#/$defs/ConnectionVersionBasis',
                  },
                  slug: {
                    type: 'string',
                  },
                  name: {
                    type: 'string',
                  },
                  provider: {
                    $ref: '#/$defs/Identity',
                  },
                  enabled: {
                    type: 'boolean',
                  },
                  enabledModelCount: {
                    type: 'integer',
                    format: 'uint',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: [
                  'editable',
                  'basis',
                  'slug',
                  'name',
                  'provider',
                  'enabled',
                  'enabledModelCount',
                ],
              },
              ConnectionVersionBasis: {
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'revision'],
              },
              Identity: {
                description:
                  'Durable recipient, not a registration lease. Re-loading the same package can\nrestore it; another package, Entry or scope cannot inherit its credentials.',
                type: 'object',
                properties: {
                  packageId: {
                    type: 'string',
                  },
                  entryId: {
                    type: 'string',
                  },
                  scope: {
                    type: 'string',
                  },
                  name: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['packageId', 'entryId', 'scope', 'name'],
              },
            },
          },
          resources: {},
        },
        create: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'CreateCatalogConnectionInput',
            type: 'object',
            properties: {
              expectedCatalogRevision: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
              connection: {
                $ref: '#/$defs/ConnectionCatalogEntryDraft',
              },
            },
            additionalProperties: false,
            required: ['expectedCatalogRevision', 'connection'],
            $defs: {
              ConnectionCatalogEntryDraft: {
                type: 'object',
                properties: {
                  slug: {
                    type: 'string',
                  },
                  name: {
                    type: 'string',
                  },
                  provider: {
                    $ref: '#/$defs/Identity',
                  },
                  configuration: {
                    type: 'object',
                  },
                  enabled: {
                    type: 'boolean',
                  },
                  enabledModelIds: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  modelOverrides: {
                    type: 'object',
                    additionalProperties: {
                      $ref: '#/$defs/ModelOverride',
                    },
                  },
                  requestBodyOverlay: {
                    type: 'object',
                  },
                },
                additionalProperties: false,
                required: [
                  'slug',
                  'name',
                  'provider',
                  'configuration',
                  'enabled',
                  'enabledModelIds',
                ],
              },
              Identity: {
                description:
                  'Durable recipient, not a registration lease. Re-loading the same package can\nrestore it; another package, Entry or scope cannot inherit its credentials.',
                type: 'object',
                properties: {
                  packageId: {
                    type: 'string',
                  },
                  entryId: {
                    type: 'string',
                  },
                  scope: {
                    type: 'string',
                  },
                  name: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['packageId', 'entryId', 'scope', 'name'],
              },
              ModelOverride: {
                type: 'object',
                properties: {
                  adapter: {
                    description:
                      "Public adapter contribution name; omitted selects the wire's default.",
                    type: 'string',
                  },
                  codeMode: {
                    description:
                      'Omitted means model-specific defaults; false is an explicit opt-out.',
                    type: 'boolean',
                  },
                  codeModeLanguage: {
                    description: 'Code Mode interpreter; omitted selects JavaScript.',
                    $ref: '#/$defs/CodeLanguage',
                  },
                  applyPatch: {
                    description:
                      'Independent of Code Mode: select patch editing or structured Edit/Write.',
                    type: 'boolean',
                  },
                  thinkingLevels: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/ThinkingLevel',
                    },
                  },
                  defaultThinkingLevel: {
                    $ref: '#/$defs/ThinkingLevel',
                  },
                  vision: {
                    type: 'boolean',
                  },
                  contextWindow: {
                    description:
                      'Override total input-plus-output capacity, without subtracting a reply budget.',
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  compactionThreshold: {
                    description:
                      'Optional override of the automatic compaction threshold, in retained tokens.\nBy default Host uses 85% of the smaller total window/input ceiling.',
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  inputLimit: {
                    description:
                      'Independent input ceiling; also caps the default compaction input budget.',
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  maxOutputTokens: {
                    description:
                      'Requested per-step output budget, subject to provider and remaining-capacity caps.',
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  displayName: {
                    type: 'string',
                  },
                  description: {
                    type: 'string',
                  },
                  apiProtocol: {
                    $ref: '#/$defs/ApiProtocol',
                  },
                  knowledgeCutoff: {
                    type: 'string',
                  },
                  capabilities: {
                    $ref: '#/$defs/ModelOverrideCapabilities',
                  },
                  modalities: {
                    $ref: '#/$defs/ModelModalities',
                  },
                  serviceTier: {
                    $ref: '#/$defs/RelayServiceTier',
                  },
                },
                additionalProperties: false,
              },
              CodeLanguage: {
                description: 'Interpreter used only for model-facing Code Mode cells.',
                type: 'string',
                enum: ['javascript', 'python'],
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
              ApiProtocol: {
                type: 'string',
                enum: ['openai-chat-completions', 'openai-responses', 'anthropic-messages'],
              },
              ModelOverrideCapabilities: {
                description: 'Vision has one declaration owner: ModelOverride::vision.',
                type: 'object',
                properties: {
                  chat: {
                    type: 'boolean',
                  },
                  reasoning: {
                    type: 'boolean',
                  },
                  functionCalling: {
                    type: 'boolean',
                  },
                  parallelToolCalls: {
                    type: 'boolean',
                  },
                  imageGeneration: {
                    type: 'boolean',
                  },
                  webSearch: {
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
              },
              ModelModalities: {
                type: 'object',
                properties: {
                  input: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/ModelModality',
                    },
                  },
                  output: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/ModelModality',
                    },
                  },
                },
                additionalProperties: false,
                required: ['input', 'output'],
              },
              ModelModality: {
                type: 'string',
                enum: ['text', 'image', 'audio', 'pdf', 'video'],
              },
              RelayServiceTier: {
                type: 'string',
                enum: ['fast'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'CatalogMutationResult',
            oneOf: [
              {
                type: 'object',
                properties: {
                  reason: {
                    $ref: '#/$defs/ConfigurationRejection',
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'reason'],
              },
              {
                type: 'object',
                properties: {
                  catalogRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  connection: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ConnectionVersionBasis',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  kind: {
                    type: 'string',
                    const: 'committed',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'catalogRevision'],
              },
              {
                type: 'object',
                properties: {
                  expectedRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  actualRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'revision_conflict',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'expectedRevision', 'actualRevision'],
              },
              {
                type: 'object',
                properties: {
                  slug: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'connection_exists',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'slug'],
              },
              {
                type: 'object',
                properties: {
                  expected: {
                    $ref: '#/$defs/ConnectionVersionBasis',
                  },
                  actual: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ConnectionVersionBasis',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  kind: {
                    type: 'string',
                    const: 'connection_stale',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'expected', 'actual'],
              },
              {
                type: 'object',
                properties: {
                  target: {
                    $ref: '#/$defs/ConnectionTarget',
                  },
                  kind: {
                    type: 'string',
                    const: 'invalid_default_target',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'target'],
              },
            ],
            $defs: {
              ConfigurationRejection: {
                description:
                  'A confirmed rejection contains no provider diagnostics or user input.',
                type: 'string',
                enum: ['invalid_input', 'invalid_configuration', 'provider_unavailable'],
              },
              ConnectionVersionBasis: {
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'revision'],
              },
              ConnectionTarget: {
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                  },
                  modelId: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'modelId'],
              },
            },
          },
          resources: {},
        },
        credentialStatus: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'CredentialVaultQueryInput',
            type: 'object',
            properties: {
              locator: {
                $ref: '#/$defs/CredentialLocator',
              },
            },
            additionalProperties: false,
            required: ['locator'],
            $defs: {
              CredentialLocator: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      connectionId: {
                        type: 'string',
                      },
                      kind: {
                        $ref: '#/$defs/ConnectionCredentialKind',
                      },
                      scope: {
                        type: 'string',
                        const: 'connection',
                      },
                    },
                    additionalProperties: false,
                    required: ['scope', 'connectionId', 'kind'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        $ref: '#/$defs/PasswordKind',
                      },
                      scope: {
                        type: 'string',
                        const: 'network_proxy',
                      },
                    },
                    additionalProperties: false,
                    required: ['scope', 'kind'],
                  },
                ],
              },
              ConnectionCredentialKind: {
                type: 'string',
                enum: ['provider', 'request_headers'],
              },
              PasswordKind: {
                type: 'string',
                enum: ['password'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'CredentialVaultQueryResult',
            oneOf: [
              {
                type: 'object',
                properties: {
                  status: {
                    $ref: '#/$defs/CredentialStatus',
                  },
                  kind: {
                    type: 'string',
                    const: 'status',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'status'],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'connection_not_found',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
            ],
            $defs: {
              CredentialStatus: {
                type: 'object',
                properties: {
                  locator: {
                    $ref: '#/$defs/CredentialLocator',
                  },
                  configured: {
                    type: 'boolean',
                  },
                  credentialId: {
                    type: ['string', 'null'],
                  },
                  revision: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  updatedAt: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['locator', 'configured', 'credentialId', 'revision', 'updatedAt'],
              },
              CredentialLocator: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      connectionId: {
                        type: 'string',
                      },
                      kind: {
                        $ref: '#/$defs/ConnectionCredentialKind',
                      },
                      scope: {
                        type: 'string',
                        const: 'connection',
                      },
                    },
                    additionalProperties: false,
                    required: ['scope', 'connectionId', 'kind'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        $ref: '#/$defs/PasswordKind',
                      },
                      scope: {
                        type: 'string',
                        const: 'network_proxy',
                      },
                    },
                    additionalProperties: false,
                    required: ['scope', 'kind'],
                  },
                ],
              },
              ConnectionCredentialKind: {
                type: 'string',
                enum: ['provider', 'request_headers'],
              },
              PasswordKind: {
                type: 'string',
                enum: ['password'],
              },
            },
          },
          resources: {},
        },
        deleteCredential: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'DeleteCredentialInput',
            type: 'object',
            properties: {
              expected: {
                $ref: '#/$defs/CredentialVersionBasis',
              },
              expectedConnection: {
                description: 'Required for connection credentials; null for network credentials.',
                anyOf: [
                  {
                    $ref: '#/$defs/ConnectionCredentialTarget',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
            },
            additionalProperties: false,
            required: ['expected', 'expectedConnection'],
            $defs: {
              CredentialVersionBasis: {
                type: 'object',
                properties: {
                  locator: {
                    $ref: '#/$defs/CredentialLocator',
                  },
                  credentialId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['locator', 'credentialId', 'revision'],
              },
              CredentialLocator: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      connectionId: {
                        type: 'string',
                      },
                      kind: {
                        $ref: '#/$defs/ConnectionCredentialKind',
                      },
                      scope: {
                        type: 'string',
                        const: 'connection',
                      },
                    },
                    additionalProperties: false,
                    required: ['scope', 'connectionId', 'kind'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        $ref: '#/$defs/PasswordKind',
                      },
                      scope: {
                        type: 'string',
                        const: 'network_proxy',
                      },
                    },
                    additionalProperties: false,
                    required: ['scope', 'kind'],
                  },
                ],
              },
              ConnectionCredentialKind: {
                type: 'string',
                enum: ['provider', 'request_headers'],
              },
              PasswordKind: {
                type: 'string',
                enum: ['password'],
              },
              ConnectionCredentialTarget: {
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  slug: {
                    type: 'string',
                  },
                  provider: {
                    $ref: '#/$defs/Identity',
                  },
                  configuration: {
                    type: 'object',
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'revision', 'slug', 'provider', 'configuration'],
              },
              Identity: {
                description:
                  'Durable recipient, not a registration lease. Re-loading the same package can\nrestore it; another package, Entry or scope cannot inherit its credentials.',
                type: 'object',
                properties: {
                  packageId: {
                    type: 'string',
                  },
                  entryId: {
                    type: 'string',
                  },
                  scope: {
                    type: 'string',
                  },
                  name: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['packageId', 'entryId', 'scope', 'name'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'CredentialMutationResult',
            oneOf: [
              {
                type: 'object',
                properties: {
                  reason: {
                    $ref: '#/$defs/ConfigurationRejection',
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'reason'],
              },
              {
                type: 'object',
                properties: {
                  vaultRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  status: {
                    $ref: '#/$defs/CredentialStatus',
                  },
                  kind: {
                    type: 'string',
                    const: 'committed',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'vaultRevision', 'status'],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'connection_not_found',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  expected: {
                    $ref: '#/$defs/ConnectionVersionBasis',
                  },
                  actual: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ConnectionVersionBasis',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  kind: {
                    type: 'string',
                    const: 'connection_stale',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'expected', 'actual'],
              },
              {
                type: 'object',
                properties: {
                  expected: {
                    anyOf: [
                      {
                        $ref: '#/$defs/CredentialVersionBasis',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  actual: {
                    anyOf: [
                      {
                        $ref: '#/$defs/CredentialVersionBasis',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  kind: {
                    type: 'string',
                    const: 'credential_stale',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'expected', 'actual'],
              },
            ],
            $defs: {
              ConfigurationRejection: {
                description:
                  'A confirmed rejection contains no provider diagnostics or user input.',
                type: 'string',
                enum: ['invalid_input', 'invalid_configuration', 'provider_unavailable'],
              },
              CredentialStatus: {
                type: 'object',
                properties: {
                  locator: {
                    $ref: '#/$defs/CredentialLocator',
                  },
                  configured: {
                    type: 'boolean',
                  },
                  credentialId: {
                    type: ['string', 'null'],
                  },
                  revision: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  updatedAt: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['locator', 'configured', 'credentialId', 'revision', 'updatedAt'],
              },
              CredentialLocator: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      connectionId: {
                        type: 'string',
                      },
                      kind: {
                        $ref: '#/$defs/ConnectionCredentialKind',
                      },
                      scope: {
                        type: 'string',
                        const: 'connection',
                      },
                    },
                    additionalProperties: false,
                    required: ['scope', 'connectionId', 'kind'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        $ref: '#/$defs/PasswordKind',
                      },
                      scope: {
                        type: 'string',
                        const: 'network_proxy',
                      },
                    },
                    additionalProperties: false,
                    required: ['scope', 'kind'],
                  },
                ],
              },
              ConnectionCredentialKind: {
                type: 'string',
                enum: ['provider', 'request_headers'],
              },
              PasswordKind: {
                type: 'string',
                enum: ['password'],
              },
              ConnectionVersionBasis: {
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'revision'],
              },
              CredentialVersionBasis: {
                type: 'object',
                properties: {
                  locator: {
                    $ref: '#/$defs/CredentialLocator',
                  },
                  credentialId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['locator', 'credentialId', 'revision'],
              },
            },
          },
          resources: {},
        },
        models: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'SettingsModelsRead',
            oneOf: [
              {
                type: 'object',
                properties: {
                  query: {
                    type: 'string',
                    default: '',
                  },
                  kind: {
                    type: 'string',
                    const: 'start',
                  },
                },
                additionalProperties: false,
                required: ['kind'],
              },
              {
                type: 'object',
                properties: {
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                  cursor: {
                    $ref: '#/$defs/SettingsModelCursor',
                  },
                  kind: {
                    type: 'string',
                    const: 'continue',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'revision', 'cursor'],
              },
            ],
            $defs: {
              SettingsModelCursor: {
                type: 'object',
                properties: {
                  query: {
                    type: 'string',
                  },
                  connection: {
                    type: 'integer',
                    format: 'uint',
                    minimum: 0,
                  },
                  model: {
                    type: 'integer',
                    format: 'uint',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['query', 'connection', 'model'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'SettingsModelsPage',
            oneOf: [
              {
                type: 'object',
                properties: {
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'changed',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'revision'],
              },
              {
                type: 'object',
                properties: {
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  choices: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/SettingsModelChoice',
                    },
                    maxItems: 16,
                  },
                  defaultModel: {
                    $ref: '#/$defs/SettingsDefaultModel',
                  },
                  next: {
                    anyOf: [
                      {
                        $ref: '#/$defs/SettingsModelCursor',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  kind: {
                    type: 'string',
                    const: 'ready',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'revision', 'choices', 'defaultModel', 'next'],
              },
            ],
            $defs: {
              SettingsModelChoice: {
                type: 'object',
                properties: {
                  tools: {
                    anyOf: [
                      {
                        $ref: '#/$defs/SettingsModelToolPreferences',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  limits: {
                    anyOf: [
                      {
                        $ref: '#/$defs/SettingsModelLimitSettings',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  selection: {
                    $ref: '#/$defs/ModelSelection',
                  },
                  connectionName: {
                    type: 'string',
                  },
                  label: {
                    type: 'string',
                  },
                  thinkingLevels: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/ThinkingLevel',
                    },
                    maxItems: 8,
                  },
                  defaultThinkingLevel: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ThinkingLevel',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
                required: [
                  'selection',
                  'connectionName',
                  'label',
                  'thinkingLevels',
                  'defaultThinkingLevel',
                ],
              },
              SettingsModelToolPreferences: {
                type: 'object',
                properties: {
                  codeMode: {
                    type: ['boolean', 'null'],
                  },
                  codeModeLanguage: {
                    anyOf: [
                      {
                        $ref: '#/$defs/CodeLanguage',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  applyPatch: {
                    type: ['boolean', 'null'],
                  },
                },
                additionalProperties: false,
                required: ['codeMode', 'codeModeLanguage', 'applyPatch'],
              },
              CodeLanguage: {
                description: 'Interpreter used only for model-facing Code Mode cells.',
                type: 'string',
                enum: ['javascript', 'python'],
              },
              SettingsModelLimitSettings: {
                type: 'object',
                properties: {
                  overrides: {
                    $ref: '#/$defs/SettingsModelLimits',
                  },
                  contextWindow: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  inputLimit: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  maxOutputTokens: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['overrides', 'contextWindow', 'inputLimit', 'maxOutputTokens'],
              },
              SettingsModelLimits: {
                type: 'object',
                properties: {
                  contextWindow: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  inputLimit: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  maxOutputTokens: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  compactionThreshold: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['contextWindow', 'inputLimit', 'maxOutputTokens', 'compactionThreshold'],
              },
              ModelSelection: {
                description:
                  'Exact public selection observed by a caller, checked once at run admission.',
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                    minLength: 1,
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  modelId: {
                    type: 'string',
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'revision', 'modelId'],
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
              SettingsDefaultModel: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'none',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      target: {
                        $ref: '#/$defs/ConnectionTarget',
                      },
                      kind: {
                        type: 'string',
                        const: 'unavailable',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'target'],
                  },
                  {
                    type: 'object',
                    properties: {
                      choice: {
                        $ref: '#/$defs/SettingsModelChoice',
                      },
                      kind: {
                        type: 'string',
                        const: 'ready',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'choice'],
                  },
                ],
              },
              ConnectionTarget: {
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                  },
                  modelId: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'modelId'],
              },
              SettingsModelCursor: {
                type: 'object',
                properties: {
                  query: {
                    type: 'string',
                  },
                  connection: {
                    type: 'integer',
                    format: 'uint',
                    minimum: 0,
                  },
                  model: {
                    type: 'integer',
                    format: 'uint',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['query', 'connection', 'model'],
              },
            },
          },
          resources: {},
        },
        network: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'SettingsNetworkRead',
            type: 'object',
            additionalProperties: false,
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'SettingsNetworkSnapshot',
            type: 'object',
            properties: {
              revision: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
              proxy: {
                $ref: '#/$defs/NetworkProxy',
              },
              credential: {
                $ref: '#/$defs/CredentialStatus',
              },
              rootId: {
                type: 'string',
              },
              rootPath: {
                type: 'string',
              },
            },
            additionalProperties: false,
            required: ['revision', 'proxy', 'credential', 'rootId', 'rootPath'],
            $defs: {
              NetworkProxy: {
                type: 'object',
                properties: {
                  enabled: {
                    type: 'boolean',
                  },
                  protocol: {
                    $ref: '#/$defs/ProxyProtocol',
                  },
                  host: {
                    type: 'string',
                  },
                  port: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 0,
                    maximum: 65535,
                  },
                  authEnabled: {
                    type: 'boolean',
                  },
                  username: {
                    type: 'string',
                  },
                  bypassList: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  autoBypassDomains: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                },
                additionalProperties: false,
                required: [
                  'enabled',
                  'protocol',
                  'host',
                  'port',
                  'authEnabled',
                  'username',
                  'bypassList',
                  'autoBypassDomains',
                ],
              },
              ProxyProtocol: {
                type: 'string',
                enum: ['http', 'https', 'socks5'],
              },
              CredentialStatus: {
                type: 'object',
                properties: {
                  locator: {
                    $ref: '#/$defs/CredentialLocator',
                  },
                  configured: {
                    type: 'boolean',
                  },
                  credentialId: {
                    type: ['string', 'null'],
                  },
                  revision: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  updatedAt: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['locator', 'configured', 'credentialId', 'revision', 'updatedAt'],
              },
              CredentialLocator: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      connectionId: {
                        type: 'string',
                      },
                      kind: {
                        $ref: '#/$defs/ConnectionCredentialKind',
                      },
                      scope: {
                        type: 'string',
                        const: 'connection',
                      },
                    },
                    additionalProperties: false,
                    required: ['scope', 'connectionId', 'kind'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        $ref: '#/$defs/PasswordKind',
                      },
                      scope: {
                        type: 'string',
                        const: 'network_proxy',
                      },
                    },
                    additionalProperties: false,
                    required: ['scope', 'kind'],
                  },
                ],
              },
              ConnectionCredentialKind: {
                type: 'string',
                enum: ['provider', 'request_headers'],
              },
              PasswordKind: {
                type: 'string',
                enum: ['password'],
              },
            },
          },
          resources: {},
        },
        prices: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'PricingQuery',
            oneOf: [
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'start',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  offset: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'continue',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'revision', 'offset'],
              },
            ],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'PricingPage',
            oneOf: [
              {
                type: 'object',
                properties: {
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  offset: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  entries: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/PricingEntry',
                    },
                  },
                  nextOffset: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'page',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'revision', 'offset', 'entries', 'nextOffset'],
              },
              {
                type: 'object',
                properties: {
                  expectedRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  actualRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'revision_changed',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'expectedRevision', 'actualRevision'],
              },
            ],
            $defs: {
              PricingEntry: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      pricing: {
                        $ref: '#/$defs/Pricing',
                      },
                      source: {
                        type: 'string',
                        const: 'builtin',
                      },
                    },
                    additionalProperties: false,
                    required: ['source', 'pricing'],
                  },
                  {
                    type: 'object',
                    properties: {
                      pricing: {
                        $ref: '#/$defs/Pricing',
                      },
                      resetEffect: {
                        $ref: '#/$defs/PricingResetEffect',
                      },
                      source: {
                        type: 'string',
                        const: 'custom',
                      },
                    },
                    additionalProperties: false,
                    required: ['source', 'pricing', 'resetEffect'],
                  },
                ],
              },
              Pricing: {
                type: 'object',
                properties: {
                  modelKey: {
                    type: 'string',
                  },
                  inputUsdPer1M: {
                    type: 'number',
                    format: 'double',
                  },
                  outputUsdPer1M: {
                    type: 'number',
                    format: 'double',
                  },
                  cacheReadUsdPer1M: {
                    type: 'number',
                    format: 'double',
                  },
                  cacheWriteUsdPer1M: {
                    type: 'number',
                    format: 'double',
                  },
                },
                additionalProperties: false,
                required: ['modelKey', 'inputUsdPer1M', 'outputUsdPer1M'],
              },
              PricingResetEffect: {
                type: 'string',
                enum: ['restore_builtin', 'become_unpriced'],
              },
            },
          },
          resources: {},
        },
        providers: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'SettingsProvidersRead',
            type: 'object',
            properties: {
              offset: {
                type: 'integer',
                format: 'uint',
                minimum: 0,
              },
            },
            additionalProperties: false,
            required: ['offset'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'SettingsProvidersPage',
            type: 'object',
            properties: {
              providers: {
                type: 'array',
                items: {
                  $ref: '#/$defs/SettingsProviderSummary',
                },
              },
              next: {
                type: ['integer', 'null'],
                format: 'uint',
                minimum: 0,
              },
            },
            additionalProperties: false,
            required: ['providers', 'next'],
            $defs: {
              SettingsProviderSummary: {
                type: 'object',
                properties: {
                  identity: {
                    $ref: '#/$defs/Identity',
                  },
                  label: {
                    type: 'string',
                  },
                  authentication: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/SettingsProviderAuthenticationSummary',
                    },
                  },
                },
                additionalProperties: false,
                required: ['identity', 'label', 'authentication'],
              },
              Identity: {
                description:
                  'Durable recipient, not a registration lease. Re-loading the same package can\nrestore it; another package, Entry or scope cannot inherit its credentials.',
                type: 'object',
                properties: {
                  packageId: {
                    type: 'string',
                  },
                  entryId: {
                    type: 'string',
                  },
                  scope: {
                    type: 'string',
                  },
                  name: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['packageId', 'entryId', 'scope', 'name'],
              },
              SettingsProviderAuthenticationSummary: {
                type: 'object',
                properties: {
                  label: {
                    type: 'string',
                  },
                  interactive: {
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: ['label', 'interactive'],
              },
            },
          },
          resources: {},
        },
        remove: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'RemoveCatalogConnectionInput',
            type: 'object',
            properties: {
              expected: {
                $ref: '#/$defs/ConnectionVersionBasis',
              },
            },
            additionalProperties: false,
            required: ['expected'],
            $defs: {
              ConnectionVersionBasis: {
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'revision'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'CatalogMutationResult',
            oneOf: [
              {
                type: 'object',
                properties: {
                  reason: {
                    $ref: '#/$defs/ConfigurationRejection',
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'reason'],
              },
              {
                type: 'object',
                properties: {
                  catalogRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  connection: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ConnectionVersionBasis',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  kind: {
                    type: 'string',
                    const: 'committed',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'catalogRevision'],
              },
              {
                type: 'object',
                properties: {
                  expectedRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  actualRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'revision_conflict',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'expectedRevision', 'actualRevision'],
              },
              {
                type: 'object',
                properties: {
                  slug: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'connection_exists',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'slug'],
              },
              {
                type: 'object',
                properties: {
                  expected: {
                    $ref: '#/$defs/ConnectionVersionBasis',
                  },
                  actual: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ConnectionVersionBasis',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  kind: {
                    type: 'string',
                    const: 'connection_stale',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'expected', 'actual'],
              },
              {
                type: 'object',
                properties: {
                  target: {
                    $ref: '#/$defs/ConnectionTarget',
                  },
                  kind: {
                    type: 'string',
                    const: 'invalid_default_target',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'target'],
              },
            ],
            $defs: {
              ConfigurationRejection: {
                description:
                  'A confirmed rejection contains no provider diagnostics or user input.',
                type: 'string',
                enum: ['invalid_input', 'invalid_configuration', 'provider_unavailable'],
              },
              ConnectionVersionBasis: {
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'revision'],
              },
              ConnectionTarget: {
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                  },
                  modelId: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'modelId'],
              },
            },
          },
          resources: {},
        },
        resolveModel: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'ConnectionTarget',
            type: 'object',
            properties: {
              connectionId: {
                type: 'string',
              },
              modelId: {
                type: 'string',
              },
            },
            additionalProperties: false,
            required: ['connectionId', 'modelId'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'SettingsDefaultModel',
            oneOf: [
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'none',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  target: {
                    $ref: '#/$defs/ConnectionTarget',
                  },
                  kind: {
                    type: 'string',
                    const: 'unavailable',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'target'],
              },
              {
                type: 'object',
                properties: {
                  choice: {
                    $ref: '#/$defs/SettingsModelChoice',
                  },
                  kind: {
                    type: 'string',
                    const: 'ready',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'choice'],
              },
            ],
            $defs: {
              ConnectionTarget: {
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                  },
                  modelId: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'modelId'],
              },
              SettingsModelChoice: {
                type: 'object',
                properties: {
                  tools: {
                    anyOf: [
                      {
                        $ref: '#/$defs/SettingsModelToolPreferences',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  limits: {
                    anyOf: [
                      {
                        $ref: '#/$defs/SettingsModelLimitSettings',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  selection: {
                    $ref: '#/$defs/ModelSelection',
                  },
                  connectionName: {
                    type: 'string',
                  },
                  label: {
                    type: 'string',
                  },
                  thinkingLevels: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/ThinkingLevel',
                    },
                    maxItems: 8,
                  },
                  defaultThinkingLevel: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ThinkingLevel',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
                required: [
                  'selection',
                  'connectionName',
                  'label',
                  'thinkingLevels',
                  'defaultThinkingLevel',
                ],
              },
              SettingsModelToolPreferences: {
                type: 'object',
                properties: {
                  codeMode: {
                    type: ['boolean', 'null'],
                  },
                  codeModeLanguage: {
                    anyOf: [
                      {
                        $ref: '#/$defs/CodeLanguage',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  applyPatch: {
                    type: ['boolean', 'null'],
                  },
                },
                additionalProperties: false,
                required: ['codeMode', 'codeModeLanguage', 'applyPatch'],
              },
              CodeLanguage: {
                description: 'Interpreter used only for model-facing Code Mode cells.',
                type: 'string',
                enum: ['javascript', 'python'],
              },
              SettingsModelLimitSettings: {
                type: 'object',
                properties: {
                  overrides: {
                    $ref: '#/$defs/SettingsModelLimits',
                  },
                  contextWindow: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  inputLimit: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  maxOutputTokens: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['overrides', 'contextWindow', 'inputLimit', 'maxOutputTokens'],
              },
              SettingsModelLimits: {
                type: 'object',
                properties: {
                  contextWindow: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  inputLimit: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  maxOutputTokens: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  compactionThreshold: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['contextWindow', 'inputLimit', 'maxOutputTokens', 'compactionThreshold'],
              },
              ModelSelection: {
                description:
                  'Exact public selection observed by a caller, checked once at run admission.',
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                    minLength: 1,
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  modelId: {
                    type: 'string',
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'revision', 'modelId'],
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
            },
          },
          resources: {},
        },
        saveCredential: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'SettingsSaveCredential',
            type: 'object',
            properties: {
              expected: {
                $ref: '#/$defs/ConnectionCredentialTarget',
              },
              expectedCredential: {
                anyOf: [
                  {
                    $ref: '#/$defs/CredentialVersionBasis',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
            },
            additionalProperties: false,
            required: ['expected', 'expectedCredential'],
            $defs: {
              ConnectionCredentialTarget: {
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  slug: {
                    type: 'string',
                  },
                  provider: {
                    $ref: '#/$defs/Identity',
                  },
                  configuration: {
                    type: 'object',
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'revision', 'slug', 'provider', 'configuration'],
              },
              Identity: {
                description:
                  'Durable recipient, not a registration lease. Re-loading the same package can\nrestore it; another package, Entry or scope cannot inherit its credentials.',
                type: 'object',
                properties: {
                  packageId: {
                    type: 'string',
                  },
                  entryId: {
                    type: 'string',
                  },
                  scope: {
                    type: 'string',
                  },
                  name: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['packageId', 'entryId', 'scope', 'name'],
              },
              CredentialVersionBasis: {
                type: 'object',
                properties: {
                  locator: {
                    $ref: '#/$defs/CredentialLocator',
                  },
                  credentialId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['locator', 'credentialId', 'revision'],
              },
              CredentialLocator: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      connectionId: {
                        type: 'string',
                      },
                      kind: {
                        $ref: '#/$defs/ConnectionCredentialKind',
                      },
                      scope: {
                        type: 'string',
                        const: 'connection',
                      },
                    },
                    additionalProperties: false,
                    required: ['scope', 'connectionId', 'kind'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        $ref: '#/$defs/PasswordKind',
                      },
                      scope: {
                        type: 'string',
                        const: 'network_proxy',
                      },
                    },
                    additionalProperties: false,
                    required: ['scope', 'kind'],
                  },
                ],
              },
              ConnectionCredentialKind: {
                type: 'string',
                enum: ['provider', 'request_headers'],
              },
              PasswordKind: {
                type: 'string',
                enum: ['password'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'SettingsCredentialSaveResult',
            oneOf: [
              {
                type: 'object',
                properties: {
                  connection: {
                    $ref: '#/$defs/ConnectionIdentity',
                  },
                  kind: {
                    type: 'string',
                    const: 'saved',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'connection'],
              },
              {
                type: 'object',
                properties: {
                  reason: {
                    $ref: '#/$defs/SettingsCredentialRejection',
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'reason'],
              },
            ],
            $defs: {
              ConnectionIdentity: {
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                  },
                  slug: {
                    type: 'string',
                  },
                  provider: {
                    $ref: '#/$defs/Identity',
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'slug', 'provider'],
              },
              Identity: {
                description:
                  'Durable recipient, not a registration lease. Re-loading the same package can\nrestore it; another package, Entry or scope cannot inherit its credentials.',
                type: 'object',
                properties: {
                  packageId: {
                    type: 'string',
                  },
                  entryId: {
                    type: 'string',
                  },
                  scope: {
                    type: 'string',
                  },
                  name: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['packageId', 'entryId', 'scope', 'name'],
              },
              SettingsCredentialRejection: {
                type: 'string',
                enum: [
                  'invalid_input',
                  'invalid_secret',
                  'secret_unavailable',
                  'provider_unavailable',
                  'authentication_unavailable',
                  'attempt_conflict',
                  'connection_changed',
                  'credential_changed',
                  'slug_taken',
                  'authentication',
                ],
              },
            },
          },
          resources: {
            secret: {
              type: {
                name: 'maka.text.utf8',
                version: 1,
              },
              optional: false,
            },
          },
        },
        setDefault: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'SetDefaultConnectionTargetInput',
            type: 'object',
            properties: {
              expectedCatalogRevision: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
              target: {
                anyOf: [
                  {
                    $ref: '#/$defs/ConnectionTarget',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
            },
            additionalProperties: false,
            required: ['expectedCatalogRevision', 'target'],
            $defs: {
              ConnectionTarget: {
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                  },
                  modelId: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'modelId'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'CatalogMutationResult',
            oneOf: [
              {
                type: 'object',
                properties: {
                  reason: {
                    $ref: '#/$defs/ConfigurationRejection',
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'reason'],
              },
              {
                type: 'object',
                properties: {
                  catalogRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  connection: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ConnectionVersionBasis',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  kind: {
                    type: 'string',
                    const: 'committed',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'catalogRevision'],
              },
              {
                type: 'object',
                properties: {
                  expectedRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  actualRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'revision_conflict',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'expectedRevision', 'actualRevision'],
              },
              {
                type: 'object',
                properties: {
                  slug: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'connection_exists',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'slug'],
              },
              {
                type: 'object',
                properties: {
                  expected: {
                    $ref: '#/$defs/ConnectionVersionBasis',
                  },
                  actual: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ConnectionVersionBasis',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  kind: {
                    type: 'string',
                    const: 'connection_stale',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'expected', 'actual'],
              },
              {
                type: 'object',
                properties: {
                  target: {
                    $ref: '#/$defs/ConnectionTarget',
                  },
                  kind: {
                    type: 'string',
                    const: 'invalid_default_target',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'target'],
              },
            ],
            $defs: {
              ConfigurationRejection: {
                description:
                  'A confirmed rejection contains no provider diagnostics or user input.',
                type: 'string',
                enum: ['invalid_input', 'invalid_configuration', 'provider_unavailable'],
              },
              ConnectionVersionBasis: {
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'revision'],
              },
              ConnectionTarget: {
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                  },
                  modelId: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'modelId'],
              },
            },
          },
          resources: {},
        },
        update: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'UpdateCatalogConnectionInput',
            type: 'object',
            properties: {
              expected: {
                $ref: '#/$defs/ConnectionVersionBasis',
              },
              changes: {
                $ref: '#/$defs/ConnectionCatalogEntryUpdate',
              },
            },
            additionalProperties: false,
            required: ['expected', 'changes'],
            $defs: {
              ConnectionVersionBasis: {
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'revision'],
              },
              ConnectionCatalogEntryUpdate: {
                type: 'object',
                properties: {
                  name: {
                    type: 'string',
                  },
                  configuration: {
                    type: 'object',
                  },
                  enabled: {
                    type: 'boolean',
                  },
                  enabledModelIds: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  modelOverrides: {
                    $ref: '#/$defs/Nullable_Map_of_ModelOverride',
                  },
                  requestBodyOverlay: {
                    type: ['object', 'null'],
                  },
                },
                additionalProperties: false,
              },
              Nullable_Map_of_ModelOverride: {
                type: ['object', 'null'],
                additionalProperties: {
                  $ref: '#/$defs/ModelOverride',
                },
              },
              ModelOverride: {
                type: 'object',
                properties: {
                  adapter: {
                    description:
                      "Public adapter contribution name; omitted selects the wire's default.",
                    type: 'string',
                  },
                  codeMode: {
                    description:
                      'Omitted means model-specific defaults; false is an explicit opt-out.',
                    type: 'boolean',
                  },
                  codeModeLanguage: {
                    description: 'Code Mode interpreter; omitted selects JavaScript.',
                    $ref: '#/$defs/CodeLanguage',
                  },
                  applyPatch: {
                    description:
                      'Independent of Code Mode: select patch editing or structured Edit/Write.',
                    type: 'boolean',
                  },
                  thinkingLevels: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/ThinkingLevel',
                    },
                  },
                  defaultThinkingLevel: {
                    $ref: '#/$defs/ThinkingLevel',
                  },
                  vision: {
                    type: 'boolean',
                  },
                  contextWindow: {
                    description:
                      'Override total input-plus-output capacity, without subtracting a reply budget.',
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  compactionThreshold: {
                    description:
                      'Optional override of the automatic compaction threshold, in retained tokens.\nBy default Host uses 85% of the smaller total window/input ceiling.',
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  inputLimit: {
                    description:
                      'Independent input ceiling; also caps the default compaction input budget.',
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  maxOutputTokens: {
                    description:
                      'Requested per-step output budget, subject to provider and remaining-capacity caps.',
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  displayName: {
                    type: 'string',
                  },
                  description: {
                    type: 'string',
                  },
                  apiProtocol: {
                    $ref: '#/$defs/ApiProtocol',
                  },
                  knowledgeCutoff: {
                    type: 'string',
                  },
                  capabilities: {
                    $ref: '#/$defs/ModelOverrideCapabilities',
                  },
                  modalities: {
                    $ref: '#/$defs/ModelModalities',
                  },
                  serviceTier: {
                    $ref: '#/$defs/RelayServiceTier',
                  },
                },
                additionalProperties: false,
              },
              CodeLanguage: {
                description: 'Interpreter used only for model-facing Code Mode cells.',
                type: 'string',
                enum: ['javascript', 'python'],
              },
              ThinkingLevel: {
                type: 'string',
                enum: ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'],
              },
              ApiProtocol: {
                type: 'string',
                enum: ['openai-chat-completions', 'openai-responses', 'anthropic-messages'],
              },
              ModelOverrideCapabilities: {
                description: 'Vision has one declaration owner: ModelOverride::vision.',
                type: 'object',
                properties: {
                  chat: {
                    type: 'boolean',
                  },
                  reasoning: {
                    type: 'boolean',
                  },
                  functionCalling: {
                    type: 'boolean',
                  },
                  parallelToolCalls: {
                    type: 'boolean',
                  },
                  imageGeneration: {
                    type: 'boolean',
                  },
                  webSearch: {
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
              },
              ModelModalities: {
                type: 'object',
                properties: {
                  input: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/ModelModality',
                    },
                  },
                  output: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/ModelModality',
                    },
                  },
                },
                additionalProperties: false,
                required: ['input', 'output'],
              },
              ModelModality: {
                type: 'string',
                enum: ['text', 'image', 'audio', 'pdf', 'video'],
              },
              RelayServiceTier: {
                type: 'string',
                enum: ['fast'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'CatalogMutationResult',
            oneOf: [
              {
                type: 'object',
                properties: {
                  reason: {
                    $ref: '#/$defs/ConfigurationRejection',
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'reason'],
              },
              {
                type: 'object',
                properties: {
                  catalogRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  connection: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ConnectionVersionBasis',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  kind: {
                    type: 'string',
                    const: 'committed',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'catalogRevision'],
              },
              {
                type: 'object',
                properties: {
                  expectedRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  actualRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'revision_conflict',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'expectedRevision', 'actualRevision'],
              },
              {
                type: 'object',
                properties: {
                  slug: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'connection_exists',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'slug'],
              },
              {
                type: 'object',
                properties: {
                  expected: {
                    $ref: '#/$defs/ConnectionVersionBasis',
                  },
                  actual: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ConnectionVersionBasis',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  kind: {
                    type: 'string',
                    const: 'connection_stale',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'expected', 'actual'],
              },
              {
                type: 'object',
                properties: {
                  target: {
                    $ref: '#/$defs/ConnectionTarget',
                  },
                  kind: {
                    type: 'string',
                    const: 'invalid_default_target',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'target'],
              },
            ],
            $defs: {
              ConfigurationRejection: {
                description:
                  'A confirmed rejection contains no provider diagnostics or user input.',
                type: 'string',
                enum: ['invalid_input', 'invalid_configuration', 'provider_unavailable'],
              },
              ConnectionVersionBasis: {
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'revision'],
              },
              ConnectionTarget: {
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                  },
                  modelId: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'modelId'],
              },
            },
          },
          resources: {},
        },
        updateAssistantPreferences: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'SettingsPreferencesUpdate',
            type: 'object',
            properties: {
              expectedRevision: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
                maximum: 9007199254740991,
              },
              mutation: {
                $ref: '#/$defs/SettingsPreferencesMutation',
              },
            },
            additionalProperties: false,
            required: ['expectedRevision', 'mutation'],
            $defs: {
              SettingsPreferencesMutation: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      preference: {
                        $ref: '#/$defs/LanguagePreference',
                      },
                      kind: {
                        type: 'string',
                        const: 'language',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'preference'],
                  },
                  {
                    type: 'object',
                    properties: {
                      prompt: {
                        type: ['string', 'null'],
                      },
                      kind: {
                        type: 'string',
                        const: 'compaction_prompt',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind'],
                  },
                  {
                    type: 'object',
                    properties: {
                      displayName: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'personalization',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'displayName'],
                  },
                  {
                    type: 'object',
                    properties: {
                      enabled: {
                        type: 'boolean',
                      },
                      kind: {
                        type: 'string',
                        const: 'workspace_instructions',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'enabled'],
                  },
                  {
                    type: 'object',
                    properties: {
                      incognitoActive: {
                        type: 'boolean',
                      },
                      kind: {
                        type: 'string',
                        const: 'privacy',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'incognitoActive'],
                  },
                  {
                    type: 'object',
                    properties: {
                      enabled: {
                        type: 'boolean',
                      },
                      kind: {
                        type: 'string',
                        const: 'shell_titles',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'enabled'],
                  },
                ],
              },
              LanguagePreference: {
                type: 'string',
                enum: ['auto', 'en', 'zh-CN', 'zh-TW'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'SettingsPreferencesUpdated',
            oneOf: [
              {
                type: 'object',
                properties: {
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'committed',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'revision'],
              },
              {
                type: 'object',
                properties: {
                  expectedRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  actualRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'revision_conflict',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'expectedRevision', 'actualRevision'],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
            ],
          },
          resources: {},
        },
        updateModelSettings: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'SettingsUpdateModelSettings',
            type: 'object',
            properties: {
              selection: {
                $ref: '#/$defs/ModelSelection',
              },
              tools: {
                $ref: '#/$defs/SettingsModelToolPreferences',
              },
              limits: {
                $ref: '#/$defs/SettingsModelLimits',
              },
            },
            additionalProperties: false,
            required: ['selection', 'tools', 'limits'],
            $defs: {
              ModelSelection: {
                description:
                  'Exact public selection observed by a caller, checked once at run admission.',
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                    minLength: 1,
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740991,
                  },
                  modelId: {
                    type: 'string',
                    minLength: 1,
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'revision', 'modelId'],
              },
              SettingsModelToolPreferences: {
                type: 'object',
                properties: {
                  codeMode: {
                    type: ['boolean', 'null'],
                  },
                  codeModeLanguage: {
                    anyOf: [
                      {
                        $ref: '#/$defs/CodeLanguage',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  applyPatch: {
                    type: ['boolean', 'null'],
                  },
                },
                additionalProperties: false,
                required: ['codeMode', 'codeModeLanguage', 'applyPatch'],
              },
              CodeLanguage: {
                description: 'Interpreter used only for model-facing Code Mode cells.',
                type: 'string',
                enum: ['javascript', 'python'],
              },
              SettingsModelLimits: {
                type: 'object',
                properties: {
                  contextWindow: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  inputLimit: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  maxOutputTokens: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  compactionThreshold: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['contextWindow', 'inputLimit', 'maxOutputTokens', 'compactionThreshold'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'CatalogMutationResult',
            oneOf: [
              {
                type: 'object',
                properties: {
                  reason: {
                    $ref: '#/$defs/ConfigurationRejection',
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'reason'],
              },
              {
                type: 'object',
                properties: {
                  catalogRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  connection: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ConnectionVersionBasis',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  kind: {
                    type: 'string',
                    const: 'committed',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'catalogRevision'],
              },
              {
                type: 'object',
                properties: {
                  expectedRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  actualRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  kind: {
                    type: 'string',
                    const: 'revision_conflict',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'expectedRevision', 'actualRevision'],
              },
              {
                type: 'object',
                properties: {
                  slug: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'connection_exists',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'slug'],
              },
              {
                type: 'object',
                properties: {
                  expected: {
                    $ref: '#/$defs/ConnectionVersionBasis',
                  },
                  actual: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ConnectionVersionBasis',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  kind: {
                    type: 'string',
                    const: 'connection_stale',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'expected', 'actual'],
              },
              {
                type: 'object',
                properties: {
                  target: {
                    $ref: '#/$defs/ConnectionTarget',
                  },
                  kind: {
                    type: 'string',
                    const: 'invalid_default_target',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'target'],
              },
            ],
            $defs: {
              ConfigurationRejection: {
                description:
                  'A confirmed rejection contains no provider diagnostics or user input.',
                type: 'string',
                enum: ['invalid_input', 'invalid_configuration', 'provider_unavailable'],
              },
              ConnectionVersionBasis: {
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'revision'],
              },
              ConnectionTarget: {
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                  },
                  modelId: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'modelId'],
              },
            },
          },
          resources: {},
        },
        updateNetwork: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'SettingsNetworkUpdate',
            type: 'object',
            properties: {
              expectedPolicyRevision: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
              expectedCredential: {
                anyOf: [
                  {
                    $ref: '#/$defs/CredentialVersionBasis',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              networkProxy: {
                $ref: '#/$defs/NetworkProxy',
              },
              credential: {
                $ref: '#/$defs/SettingsNetworkCredentialAction',
              },
            },
            additionalProperties: false,
            required: [
              'expectedPolicyRevision',
              'expectedCredential',
              'networkProxy',
              'credential',
            ],
            $defs: {
              CredentialVersionBasis: {
                type: 'object',
                properties: {
                  locator: {
                    $ref: '#/$defs/CredentialLocator',
                  },
                  credentialId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['locator', 'credentialId', 'revision'],
              },
              CredentialLocator: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      connectionId: {
                        type: 'string',
                      },
                      kind: {
                        $ref: '#/$defs/ConnectionCredentialKind',
                      },
                      scope: {
                        type: 'string',
                        const: 'connection',
                      },
                    },
                    additionalProperties: false,
                    required: ['scope', 'connectionId', 'kind'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        $ref: '#/$defs/PasswordKind',
                      },
                      scope: {
                        type: 'string',
                        const: 'network_proxy',
                      },
                    },
                    additionalProperties: false,
                    required: ['scope', 'kind'],
                  },
                ],
              },
              ConnectionCredentialKind: {
                type: 'string',
                enum: ['provider', 'request_headers'],
              },
              PasswordKind: {
                type: 'string',
                enum: ['password'],
              },
              NetworkProxy: {
                type: 'object',
                properties: {
                  enabled: {
                    type: 'boolean',
                  },
                  protocol: {
                    $ref: '#/$defs/ProxyProtocol',
                  },
                  host: {
                    type: 'string',
                  },
                  port: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 0,
                    maximum: 65535,
                  },
                  authEnabled: {
                    type: 'boolean',
                  },
                  username: {
                    type: 'string',
                  },
                  bypassList: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  autoBypassDomains: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                },
                additionalProperties: false,
                required: [
                  'enabled',
                  'protocol',
                  'host',
                  'port',
                  'authEnabled',
                  'username',
                  'bypassList',
                  'autoBypassDomains',
                ],
              },
              ProxyProtocol: {
                type: 'string',
                enum: ['http', 'https', 'socks5'],
              },
              SettingsNetworkCredentialAction: {
                type: 'string',
                enum: ['keep', 'delete', 'replace'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'SettingsNetworkUpdated',
            oneOf: [
              {
                type: 'object',
                properties: {
                  result: {
                    $ref: '#/$defs/NetworkProxyUpdateResult',
                  },
                  kind: {
                    type: 'string',
                    const: 'applied',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'result'],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
            ],
            $defs: {
              NetworkProxyUpdateResult: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      revision: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      credentialStatus: {
                        $ref: '#/$defs/CredentialStatus',
                      },
                      kind: {
                        type: 'string',
                        const: 'committed',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'revision', 'credentialStatus'],
                  },
                  {
                    type: 'object',
                    properties: {
                      expectedRevision: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      actualRevision: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'revision_conflict',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'expectedRevision', 'actualRevision'],
                  },
                  {
                    type: 'object',
                    properties: {
                      expected: {
                        $ref: '#/$defs/CredentialTarget',
                      },
                      actual: {
                        $ref: '#/$defs/CredentialTarget',
                      },
                      kind: {
                        type: 'string',
                        const: 'proxy_target_mismatch',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'expected', 'actual'],
                  },
                  {
                    type: 'object',
                    properties: {
                      expected: {
                        anyOf: [
                          {
                            $ref: '#/$defs/CredentialVersionBasis',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      actual: {
                        anyOf: [
                          {
                            $ref: '#/$defs/CredentialVersionBasis',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'credential_stale',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'expected', 'actual'],
                  },
                ],
              },
              CredentialStatus: {
                type: 'object',
                properties: {
                  locator: {
                    $ref: '#/$defs/CredentialLocator',
                  },
                  configured: {
                    type: 'boolean',
                  },
                  credentialId: {
                    type: ['string', 'null'],
                  },
                  revision: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  updatedAt: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['locator', 'configured', 'credentialId', 'revision', 'updatedAt'],
              },
              CredentialLocator: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      connectionId: {
                        type: 'string',
                      },
                      kind: {
                        $ref: '#/$defs/ConnectionCredentialKind',
                      },
                      scope: {
                        type: 'string',
                        const: 'connection',
                      },
                    },
                    additionalProperties: false,
                    required: ['scope', 'connectionId', 'kind'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        $ref: '#/$defs/PasswordKind',
                      },
                      scope: {
                        type: 'string',
                        const: 'network_proxy',
                      },
                    },
                    additionalProperties: false,
                    required: ['scope', 'kind'],
                  },
                ],
              },
              ConnectionCredentialKind: {
                type: 'string',
                enum: ['provider', 'request_headers'],
              },
              PasswordKind: {
                type: 'string',
                enum: ['password'],
              },
              CredentialTarget: {
                type: 'object',
                properties: {
                  protocol: {
                    $ref: '#/$defs/ProxyProtocol',
                  },
                  host: {
                    type: 'string',
                  },
                  port: {
                    type: 'integer',
                    format: 'uint16',
                    minimum: 0,
                    maximum: 65535,
                  },
                  username: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['protocol', 'host', 'port', 'username'],
              },
              ProxyProtocol: {
                type: 'string',
                enum: ['http', 'https', 'socks5'],
              },
              CredentialVersionBasis: {
                type: 'object',
                properties: {
                  locator: {
                    $ref: '#/$defs/CredentialLocator',
                  },
                  credentialId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['locator', 'credentialId', 'revision'],
              },
            },
          },
          resources: {
            secret: {
              type: {
                name: 'maka.text.utf8',
                version: 1,
              },
              optional: true,
            },
          },
        },
        updatePrice: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'PricingUpdate',
            type: 'object',
            properties: {
              expectedRevision: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
              mutation: {
                $ref: '#/$defs/PricingMutation',
              },
            },
            additionalProperties: false,
            required: ['expectedRevision', 'mutation'],
            $defs: {
              PricingMutation: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      pricing: {
                        $ref: '#/$defs/Pricing',
                      },
                      kind: {
                        type: 'string',
                        const: 'upsert',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'pricing'],
                  },
                  {
                    type: 'object',
                    properties: {
                      modelKey: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'delete',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'modelKey'],
                  },
                ],
              },
              Pricing: {
                type: 'object',
                properties: {
                  modelKey: {
                    type: 'string',
                  },
                  inputUsdPer1M: {
                    type: 'number',
                    format: 'double',
                  },
                  outputUsdPer1M: {
                    type: 'number',
                    format: 'double',
                  },
                  cacheReadUsdPer1M: {
                    type: 'number',
                    format: 'double',
                  },
                  cacheWriteUsdPer1M: {
                    type: 'number',
                    format: 'double',
                  },
                },
                additionalProperties: false,
                required: ['modelKey', 'inputUsdPer1M', 'outputUsdPer1M'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'SettingsPricingResult',
            oneOf: [
              {
                type: 'object',
                properties: {
                  result: {
                    $ref: '#/$defs/PricingUpdated',
                  },
                  kind: {
                    type: 'string',
                    const: 'updated',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'result'],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
            ],
            $defs: {
              PricingUpdated: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      revision: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'committed',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'revision'],
                  },
                  {
                    type: 'object',
                    properties: {
                      revision: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'unchanged',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'revision'],
                  },
                  {
                    type: 'object',
                    properties: {
                      expectedRevision: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      actualRevision: {
                        type: 'integer',
                        format: 'uint64',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'revision_conflict',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'expectedRevision', 'actualRevision'],
                  },
                ],
              },
            },
          },
          resources: {},
        },
        usage: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'SettingsUsageRead',
            type: 'object',
            properties: {
              range: {
                $ref: '#/$defs/SettingsUsageRange',
              },
              selection: {
                $ref: '#/$defs/UsageSelection',
              },
              offset: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
                maximum: 9007199254740991,
              },
            },
            additionalProperties: false,
            required: ['range', 'selection', 'offset'],
            $defs: {
              SettingsUsageRange: {
                type: 'object',
                properties: {
                  from: {
                    type: 'number',
                    format: 'double',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                  to: {
                    type: 'number',
                    format: 'double',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                  sessionId: {
                    type: ['string', 'null'],
                  },
                  through: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['from', 'to', 'sessionId', 'through'],
              },
              UsageSelection: {
                description:
                  'Filters only the activity list, never headline accounting for the range.',
                type: 'object',
                properties: {
                  kind: {
                    anyOf: [
                      {
                        $ref: '#/$defs/UsageActivityKind',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  status: {
                    anyOf: [
                      {
                        $ref: '#/$defs/UsageActivityStatus',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  search: {
                    type: 'string',
                    default: '',
                  },
                },
                additionalProperties: false,
              },
              UsageActivityKind: {
                type: 'string',
                enum: ['model', 'tool'],
              },
              UsageActivityStatus: {
                type: 'string',
                enum: ['success', 'error', 'aborted', 'unknown', 'rejected'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'SettingsUsagePage',
            type: 'object',
            properties: {
              through: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
              attempts: {
                type: 'array',
                items: {
                  $ref: '#/$defs/UsageActivity',
                },
                maxItems: 32,
              },
              total: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
              nextOffset: {
                type: ['integer', 'null'],
                format: 'uint64',
                minimum: 0,
              },
            },
            additionalProperties: false,
            required: ['through', 'attempts', 'total', 'nextOffset'],
            $defs: {
              UsageActivity: {
                description:
                  'A physical model call or tool attempt, never copied conversation membership.',
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'model',
                      },
                      attempt: {
                        $ref: '#/$defs/UsageModelAttempt',
                      },
                    },
                    required: ['kind', 'attempt'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'tool',
                      },
                      attempt: {
                        $ref: '#/$defs/UsageToolAttempt',
                      },
                    },
                    required: ['kind', 'attempt'],
                  },
                ],
              },
              UsageModelAttempt: {
                type: 'object',
                properties: {
                  requestId: {
                    type: 'string',
                  },
                  origin: {
                    $ref: '#/$defs/UsageOrigin',
                  },
                  sessionId: {
                    type: ['string', 'null'],
                  },
                  binding: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ModelBinding',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  modelId: {
                    type: 'string',
                  },
                  startedAt: {
                    type: 'number',
                    format: 'double',
                  },
                  completedAt: {
                    type: 'number',
                    format: 'double',
                  },
                  outcome: {
                    $ref: '#/$defs/UsageOutcome',
                  },
                  usage: {
                    $ref: '#/$defs/ModelUsage',
                  },
                  quote: {
                    anyOf: [
                      {
                        $ref: '#/$defs/Quote',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  costUsd: {
                    type: ['number', 'null'],
                    format: 'double',
                  },
                },
                additionalProperties: false,
                required: [
                  'requestId',
                  'origin',
                  'sessionId',
                  'binding',
                  'modelId',
                  'startedAt',
                  'completedAt',
                  'outcome',
                  'usage',
                  'quote',
                  'costUsd',
                ],
              },
              UsageOrigin: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      invocation: {
                        $ref: '#/$defs/Invocation',
                      },
                      purpose: {
                        $ref: '#/$defs/ModelPurpose',
                      },
                      kind: {
                        type: 'string',
                        const: 'agent',
                      },
                    },
                    required: ['kind', 'invocation', 'purpose'],
                  },
                  {
                    type: 'object',
                    properties: {
                      source: {
                        $ref: '#/$defs/UsageAuxiliarySource',
                      },
                      kind: {
                        type: 'string',
                        const: 'auxiliary',
                      },
                    },
                    required: ['kind', 'source'],
                  },
                ],
              },
              Invocation: {
                type: 'object',
                properties: {
                  session_id: {
                    type: 'string',
                  },
                  turn_id: {
                    type: 'string',
                  },
                  run_id: {
                    type: 'string',
                  },
                  invocation_id: {
                    type: 'string',
                  },
                },
                required: ['session_id', 'turn_id', 'run_id', 'invocation_id'],
              },
              ModelPurpose: {
                type: 'string',
                enum: ['main', 'summary'],
              },
              UsageAuxiliarySource: {
                oneOf: [
                  {
                    description:
                      'One auxiliary request owned by an admitted native application mutation.',
                    type: 'object',
                    properties: {
                      source: {
                        $ref: '#/$defs/DeploymentRef',
                      },
                      namespace: {
                        $ref: '#/$defs/InstanceId',
                      },
                      operation: {
                        type: 'string',
                        format: 'uuid',
                      },
                      fingerprint: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'application_operation',
                      },
                    },
                    required: ['kind', 'source', 'namespace', 'operation', 'fingerprint'],
                  },
                  {
                    description:
                      'One Host-owned title request, authorized by the first committed user opening.\nIt may finish after that invocation ends and cannot execute tools.',
                    type: 'object',
                    properties: {
                      invocation: {
                        $ref: '#/$defs/Invocation',
                      },
                      kind: {
                        type: 'string',
                        const: 'session_title',
                      },
                    },
                    required: ['kind', 'invocation'],
                  },
                  {
                    type: 'object',
                    properties: {
                      invocation: {
                        $ref: '#/$defs/Invocation',
                      },
                      operation_id: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'agent',
                      },
                    },
                    required: ['kind', 'invocation', 'operation_id'],
                  },
                  {
                    type: 'object',
                    properties: {
                      id: {
                        type: 'string',
                        format: 'uuid',
                      },
                      kind: {
                        type: 'string',
                        const: 'host_effect',
                      },
                    },
                    required: ['kind', 'id'],
                  },
                ],
              },
              DeploymentRef: {
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'revision'],
              },
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
              ModelBinding: {
                description:
                  'Public model identity. Credentials and provider handles never belong here.',
                type: 'object',
                properties: {
                  connection_id: {
                    type: 'string',
                  },
                  connection_slug: {
                    type: 'string',
                  },
                  model: {
                    type: 'string',
                  },
                },
                required: ['connection_id', 'connection_slug', 'model'],
              },
              UsageOutcome: {
                oneOf: [
                  {
                    type: 'string',
                    enum: ['success', 'error', 'aborted'],
                  },
                  {
                    description: 'The admission ended without a recorded provider outcome.',
                    type: 'string',
                    const: 'unknown',
                  },
                ],
              },
              ModelUsage: {
                type: 'object',
                properties: {
                  input_tokens: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  output_tokens: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  cache_read_tokens: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  cache_write_tokens: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  reasoning_tokens: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                required: [
                  'input_tokens',
                  'output_tokens',
                  'cache_read_tokens',
                  'cache_write_tokens',
                  'reasoning_tokens',
                ],
              },
              Quote: {
                type: 'object',
                properties: {
                  providerId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  pricing: {
                    anyOf: [
                      {
                        $ref: '#/$defs/Pricing',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
                required: ['providerId', 'revision', 'pricing'],
              },
              Pricing: {
                type: 'object',
                properties: {
                  modelKey: {
                    type: 'string',
                  },
                  inputUsdPer1M: {
                    type: 'number',
                    format: 'double',
                  },
                  outputUsdPer1M: {
                    type: 'number',
                    format: 'double',
                  },
                  cacheReadUsdPer1M: {
                    type: 'number',
                    format: 'double',
                  },
                  cacheWriteUsdPer1M: {
                    type: 'number',
                    format: 'double',
                  },
                },
                additionalProperties: false,
                required: ['modelKey', 'inputUsdPer1M', 'outputUsdPer1M'],
              },
              UsageToolAttempt: {
                type: 'object',
                properties: {
                  requestId: {
                    type: 'string',
                  },
                  invocation: {
                    $ref: '#/$defs/Invocation',
                  },
                  call: {
                    $ref: '#/$defs/ToolCallIdentity',
                  },
                  name: {
                    type: 'string',
                  },
                  binding: {
                    anyOf: [
                      {
                        $ref: '#/$defs/ModelBinding',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  completedAt: {
                    type: 'number',
                    format: 'double',
                  },
                  result: {
                    $ref: '#/$defs/UsageToolResult',
                  },
                },
                additionalProperties: false,
                required: [
                  'requestId',
                  'invocation',
                  'call',
                  'name',
                  'binding',
                  'completedAt',
                  'result',
                ],
              },
              ToolCallIdentity: {
                description:
                  'A Tool Call is distinct from its durable host operation. Origin determines\nmodel visibility; it is not an independent flag that can contradict ancestry.',
                type: 'object',
                properties: {
                  tool_call_id: {
                    type: 'string',
                  },
                  origin: {
                    $ref: '#/$defs/ToolOrigin',
                  },
                },
                required: ['tool_call_id', 'origin'],
              },
              ToolOrigin: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      step_id: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'provider',
                      },
                    },
                    required: ['kind', 'step_id'],
                  },
                  {
                    type: 'object',
                    properties: {
                      parent_operation_id: {
                        type: 'string',
                      },
                      parent_tool_call_id: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'code_mode',
                      },
                    },
                    required: ['kind', 'parent_operation_id', 'parent_tool_call_id'],
                  },
                  {
                    description:
                      "An independently running cell accepted by an exec control call.\nIts parent may settle once startup/observation completes; its own nested\ntool effects must still drain before the cell's canonical settlement.",
                    type: 'object',
                    properties: {
                      parent_operation_id: {
                        type: 'string',
                      },
                      parent_tool_call_id: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'code_cell',
                      },
                    },
                    required: ['kind', 'parent_operation_id', 'parent_tool_call_id'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'standalone',
                      },
                    },
                    required: ['kind'],
                  },
                  {
                    description:
                      'Explicit Host SDK work, never dispatch inferred from executor observations.',
                    type: 'object',
                    properties: {
                      package_id: {
                        type: 'string',
                      },
                      entry_id: {
                        type: 'string',
                      },
                      activation: {
                        type: 'string',
                      },
                      parent_operation_id: {
                        type: ['string', 'null'],
                      },
                      kind: {
                        type: 'string',
                        const: 'host_sdk',
                      },
                    },
                    required: [
                      'kind',
                      'package_id',
                      'entry_id',
                      'activation',
                      'parent_operation_id',
                    ],
                  },
                ],
              },
              UsageToolResult: {
                oneOf: [
                  {
                    description: 'No effect was admitted, so no execution duration is reported.',
                    type: 'object',
                    properties: {
                      reason: {
                        $ref: '#/$defs/RejectionKind',
                      },
                      kind: {
                        type: 'string',
                        const: 'rejected',
                      },
                    },
                    required: ['kind', 'reason'],
                  },
                  {
                    type: 'object',
                    properties: {
                      startedAt: {
                        type: 'number',
                        format: 'double',
                      },
                      outcome: {
                        $ref: '#/$defs/UsageToolStatus',
                      },
                      kind: {
                        type: 'string',
                        const: 'settled',
                      },
                    },
                    required: ['kind', 'startedAt', 'outcome'],
                  },
                ],
              },
              RejectionKind: {
                description: 'Refusal category without input-derived explanation text.',
                type: 'string',
                enum: [
                  'unavailable',
                  'invalid_input',
                  'policy_denied',
                  'preparation_failed',
                  'exclusive_conflict',
                  'cancelled',
                ],
              },
              UsageToolStatus: {
                type: 'string',
                enum: ['success', 'error', 'unknown'],
              },
            },
          },
          resources: {},
        },
        usageSummary: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'SettingsUsageSummaryRead',
            type: 'object',
            properties: {
              range: {
                $ref: '#/$defs/SettingsUsageRange',
              },
              group: {
                $ref: '#/$defs/UsageGroup',
              },
              offset: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
                maximum: 9007199254740991,
              },
            },
            additionalProperties: false,
            required: ['range', 'group', 'offset'],
            $defs: {
              SettingsUsageRange: {
                type: 'object',
                properties: {
                  from: {
                    type: 'number',
                    format: 'double',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                  to: {
                    type: 'number',
                    format: 'double',
                    minimum: 0,
                    maximum: 9007199254740991,
                  },
                  sessionId: {
                    type: ['string', 'null'],
                  },
                  through: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['from', 'to', 'sessionId', 'through'],
              },
              UsageGroup: {
                description: 'Breakdown selected for a bounded summary page.',
                type: 'string',
                enum: ['byProvider', 'byModel', 'byTool'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'SettingsUsageSummary',
            type: 'object',
            properties: {
              through: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
              summary: {
                $ref: '#/$defs/SettingsUsageTotals',
              },
              nextOffset: {
                type: ['integer', 'null'],
                format: 'uint64',
                minimum: 0,
              },
            },
            additionalProperties: false,
            required: ['through', 'summary', 'nextOffset'],
            $defs: {
              SettingsUsageTotals: {
                type: 'object',
                properties: {
                  models: {
                    $ref: '#/$defs/UsageModelTotals',
                  },
                  tools: {
                    $ref: '#/$defs/UsageToolTotals',
                  },
                  pending: {
                    $ref: '#/$defs/UsagePending',
                  },
                  byProvider: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/UsageProviderSummary',
                    },
                    maxItems: 32,
                  },
                  byModel: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/UsageModelSummary',
                    },
                    maxItems: 32,
                  },
                  byTool: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/UsageToolSummary',
                    },
                    maxItems: 32,
                  },
                },
                additionalProperties: false,
                required: ['models', 'tools', 'pending', 'byProvider', 'byModel', 'byTool'],
              },
              UsageModelTotals: {
                type: 'object',
                properties: {
                  calls: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  success: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  error: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  aborted: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  unknown: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  durationMs: {
                    description:
                      'Sum of observed durations; unknown outcomes are excluded. Not wall-clock time.',
                    type: 'number',
                    format: 'double',
                  },
                  input: {
                    $ref: '#/$defs/UsageTokens',
                  },
                  output: {
                    $ref: '#/$defs/UsageTokens',
                  },
                  cacheRead: {
                    $ref: '#/$defs/UsageTokens',
                  },
                  cacheWrite: {
                    $ref: '#/$defs/UsageTokens',
                  },
                  reasoning: {
                    $ref: '#/$defs/UsageTokens',
                  },
                  cost: {
                    $ref: '#/$defs/UsageCost',
                  },
                },
                additionalProperties: false,
                required: [
                  'calls',
                  'success',
                  'error',
                  'aborted',
                  'unknown',
                  'durationMs',
                  'input',
                  'output',
                  'cacheRead',
                  'cacheWrite',
                  'reasoning',
                  'cost',
                ],
              },
              UsageTokens: {
                description:
                  'Sum of reported counters, qualified by calls that omitted this counter.',
                type: 'object',
                properties: {
                  known: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  missing: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['known', 'missing'],
              },
              UsageCost: {
                type: 'object',
                properties: {
                  knownUsd: {
                    type: 'number',
                    format: 'double',
                  },
                  unvalued: {
                    description: 'Calls without a persisted valuation; includes unpriced calls.',
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  unpriced: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['knownUsd', 'unvalued', 'unpriced'],
              },
              UsageToolTotals: {
                type: 'object',
                properties: {
                  calls: {
                    description:
                      'Includes pre-dispatch refusals, which are counted separately below.',
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  success: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  error: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  unknown: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  rejected: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  durationMs: {
                    description:
                      'Known success/error durations; refusals and unknown effects contribute no time.',
                    type: 'number',
                    format: 'double',
                  },
                  meanLatencyMs: {
                    description:
                      'Only known success/error settlements contribute to observed execution latency.',
                    type: ['number', 'null'],
                    format: 'double',
                  },
                },
                additionalProperties: false,
                required: [
                  'calls',
                  'success',
                  'error',
                  'unknown',
                  'rejected',
                  'durationMs',
                  'meanLatencyMs',
                ],
              },
              UsagePending: {
                type: 'object',
                properties: {
                  models: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  tools: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['models', 'tools'],
              },
              UsageProviderSummary: {
                type: 'object',
                properties: {
                  providerId: {
                    description:
                      'Unknown identity is not inferred from a transport protocol or current settings.',
                    type: ['string', 'null'],
                  },
                  totals: {
                    $ref: '#/$defs/UsageModelTotals',
                  },
                },
                additionalProperties: false,
                required: ['providerId', 'totals'],
              },
              UsageModelSummary: {
                type: 'object',
                properties: {
                  modelId: {
                    type: 'string',
                  },
                  totals: {
                    $ref: '#/$defs/UsageModelTotals',
                  },
                },
                additionalProperties: false,
                required: ['modelId', 'totals'],
              },
              UsageToolSummary: {
                type: 'object',
                properties: {
                  name: {
                    type: 'string',
                  },
                  totals: {
                    $ref: '#/$defs/UsageToolTotals',
                  },
                },
                additionalProperties: false,
                required: ['name', 'totals'],
              },
            },
          },
          resources: {},
        },
      },
    },
  },
  settingsAuthentication: {
    name: 'maka.settings.Authentication',
    version: 1,
    transport: 'remote',
    interface: {
      kind: 'service',
      methods: {
        loginCredential: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'SettingsCredentialLogin',
            type: 'object',
            properties: {
              expected: {
                $ref: '#/$defs/ConnectionCredentialTarget',
              },
              expectedCredential: {
                anyOf: [
                  {
                    $ref: '#/$defs/CredentialVersionBasis',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              method: {
                type: 'string',
              },
            },
            additionalProperties: false,
            required: ['expected', 'expectedCredential', 'method'],
            $defs: {
              ConnectionCredentialTarget: {
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  slug: {
                    type: 'string',
                  },
                  provider: {
                    $ref: '#/$defs/Identity',
                  },
                  configuration: {
                    type: 'object',
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'revision', 'slug', 'provider', 'configuration'],
              },
              Identity: {
                description:
                  'Durable recipient, not a registration lease. Re-loading the same package can\nrestore it; another package, Entry or scope cannot inherit its credentials.',
                type: 'object',
                properties: {
                  packageId: {
                    type: 'string',
                  },
                  entryId: {
                    type: 'string',
                  },
                  scope: {
                    type: 'string',
                  },
                  name: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['packageId', 'entryId', 'scope', 'name'],
              },
              CredentialVersionBasis: {
                type: 'object',
                properties: {
                  locator: {
                    $ref: '#/$defs/CredentialLocator',
                  },
                  credentialId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['locator', 'credentialId', 'revision'],
              },
              CredentialLocator: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      connectionId: {
                        type: 'string',
                      },
                      kind: {
                        $ref: '#/$defs/ConnectionCredentialKind',
                      },
                      scope: {
                        type: 'string',
                        const: 'connection',
                      },
                    },
                    additionalProperties: false,
                    required: ['scope', 'connectionId', 'kind'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        $ref: '#/$defs/PasswordKind',
                      },
                      scope: {
                        type: 'string',
                        const: 'network_proxy',
                      },
                    },
                    additionalProperties: false,
                    required: ['scope', 'kind'],
                  },
                ],
              },
              ConnectionCredentialKind: {
                type: 'string',
                enum: ['provider', 'request_headers'],
              },
              PasswordKind: {
                type: 'string',
                enum: ['password'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'SettingsCredentialLoginResult',
            oneOf: [
              {
                type: 'object',
                properties: {
                  connection: {
                    $ref: '#/$defs/ConnectionIdentity',
                  },
                  kind: {
                    type: 'string',
                    const: 'saved',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'connection'],
              },
              {
                type: 'object',
                properties: {
                  reason: {
                    $ref: '#/$defs/SettingsCredentialRejection',
                  },
                  kind: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'reason'],
              },
              {
                type: 'object',
                properties: {
                  reason: {
                    $ref: '#/$defs/SettingsLoginFailure',
                  },
                  message: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'reason', 'message'],
              },
            ],
            $defs: {
              ConnectionIdentity: {
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                  },
                  slug: {
                    type: 'string',
                  },
                  provider: {
                    $ref: '#/$defs/Identity',
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'slug', 'provider'],
              },
              Identity: {
                description:
                  'Durable recipient, not a registration lease. Re-loading the same package can\nrestore it; another package, Entry or scope cannot inherit its credentials.',
                type: 'object',
                properties: {
                  packageId: {
                    type: 'string',
                  },
                  entryId: {
                    type: 'string',
                  },
                  scope: {
                    type: 'string',
                  },
                  name: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['packageId', 'entryId', 'scope', 'name'],
              },
              SettingsCredentialRejection: {
                type: 'string',
                enum: [
                  'invalid_input',
                  'invalid_secret',
                  'secret_unavailable',
                  'provider_unavailable',
                  'authentication_unavailable',
                  'attempt_conflict',
                  'connection_changed',
                  'credential_changed',
                  'slug_taken',
                  'authentication',
                ],
              },
              SettingsLoginFailure: {
                type: 'string',
                enum: ['cancelled', 'expired', 'transport', 'authentication'],
              },
            },
          },
          progress: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'SettingsLoginPrompt',
            type: 'object',
            properties: {
              url: {
                type: 'string',
              },
              userCode: {
                type: 'string',
              },
            },
            additionalProperties: false,
            required: ['url', 'userCode'],
          },
          resources: {},
        },
        provider: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'Identity',
            description:
              'Durable recipient, not a registration lease. Re-loading the same package can\nrestore it; another package, Entry or scope cannot inherit its credentials.',
            type: 'object',
            properties: {
              packageId: {
                type: 'string',
              },
              entryId: {
                type: 'string',
              },
              scope: {
                type: 'string',
              },
              name: {
                type: 'string',
              },
            },
            additionalProperties: false,
            required: ['packageId', 'entryId', 'scope', 'name'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'SettingsProvider',
            type: 'object',
            properties: {
              identity: {
                $ref: '#/$defs/Identity',
              },
              descriptor: {
                $ref: '#/$defs/Descriptor',
              },
            },
            additionalProperties: false,
            required: ['identity', 'descriptor'],
            $defs: {
              Identity: {
                description:
                  'Durable recipient, not a registration lease. Re-loading the same package can\nrestore it; another package, Entry or scope cannot inherit its credentials.',
                type: 'object',
                properties: {
                  packageId: {
                    type: 'string',
                  },
                  entryId: {
                    type: 'string',
                  },
                  scope: {
                    type: 'string',
                  },
                  name: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['packageId', 'entryId', 'scope', 'name'],
              },
              Descriptor: {
                type: 'object',
                properties: {
                  label: {
                    type: 'string',
                  },
                  customEndpoint: {
                    description: 'Offers a user-selected endpoint instead of a named service.',
                    type: 'boolean',
                    default: false,
                  },
                  configurationSchema: true,
                  configurationDefaults: true,
                  authentication: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/Method',
                    },
                  },
                  anonymous: {
                    description:
                      "Whether the provider supports a connection without a stored credential.\nPresentation metadata; authorization remains the provider's decision.",
                    type: 'boolean',
                  },
                  discovery: {
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: [
                  'label',
                  'customEndpoint',
                  'configurationSchema',
                  'configurationDefaults',
                  'authentication',
                  'anonymous',
                  'discovery',
                ],
              },
              Method: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  label: {
                    type: 'string',
                  },
                  inputSchema: {
                    description:
                      'Secret-bearing form input never enters the connection configuration.',
                  },
                  interactive: {
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: ['id', 'label', 'inputSchema', 'interactive'],
              },
            },
          },
          resources: {},
        },
      },
    },
  },
  textReader: {
    name: 'maka.text.Reader',
    version: 1,
    transport: 'local',
    interface: {
      kind: 'service',
      methods: {
        read: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'ReadText',
            type: 'object',
            properties: {
              start: {
                type: 'integer',
                format: 'uint',
                minimum: 0,
              },
              end: {
                type: 'integer',
                format: 'uint',
                minimum: 0,
              },
            },
            additionalProperties: false,
            required: ['start', 'end'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'TextChunk',
            type: 'object',
            properties: {
              text: {
                type: 'string',
              },
              metadata: true,
            },
            additionalProperties: false,
            required: ['text', 'metadata'],
          },
          resources: {
            text: {
              type: {
                name: 'maka.text.utf8',
                version: 1,
              },
              optional: false,
            },
          },
        },
      },
    },
  },
  callerHistory: {
    name: 'maka.operations.CallerHistory',
    version: 1,
    transport: 'local',
    interface: {
      kind: 'service',
      methods: {
        page: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'CallerHistoryPage',
            type: 'object',
            properties: {
              after: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
                maximum: 9007199254740991,
              },
              limit: {
                type: 'integer',
                format: 'uint',
                minimum: 1,
                maximum: 128,
              },
            },
            additionalProperties: false,
            required: ['after', 'limit'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'Array_of_CallerIntent',
            type: 'array',
            items: {
              $ref: '#/$defs/CallerIntent',
            },
            $defs: {
              CallerIntent: {
                type: 'object',
                properties: {
                  cursor: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  caller: {
                    $ref: '#/$defs/DeploymentRef',
                  },
                  consumer: {
                    $ref: '#/$defs/InstanceId',
                  },
                  reference: {
                    $ref: '#/$defs/RecoveryRef',
                  },
                  recovery: true,
                },
                additionalProperties: false,
                required: ['cursor', 'caller', 'consumer', 'reference'],
              },
              DeploymentRef: {
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'revision'],
              },
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
              RecoveryRef: {
                type: 'object',
                properties: {
                  source: {
                    $ref: '#/$defs/DeploymentRef',
                  },
                  namespace: {
                    $ref: '#/$defs/InstanceId',
                  },
                  export: {
                    type: 'string',
                  },
                  method: {
                    type: 'string',
                  },
                  operation: {
                    type: 'string',
                    format: 'uuid',
                  },
                  fingerprint: {
                    type: 'string',
                  },
                  contract: {
                    $ref: '#/$defs/RecoveryContract',
                  },
                  recovery: {
                    $ref: '#/$defs/RecoveryProtocol',
                  },
                },
                additionalProperties: false,
                required: [
                  'source',
                  'namespace',
                  'export',
                  'method',
                  'operation',
                  'fingerprint',
                  'contract',
                  'recovery',
                ],
              },
              RecoveryContract: {
                description:
                  'Contract identity for a journal lookup. The original request retains the\ncomplete contract; a receipt carries only its digest.',
                type: 'object',
                properties: {
                  name: {
                    type: 'string',
                  },
                  version: {
                    type: 'integer',
                    format: 'uint32',
                    minimum: 0,
                  },
                  transport: {
                    $ref: '#/$defs/Transport',
                  },
                  digest: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['name', 'version', 'transport', 'digest'],
              },
              Transport: {
                type: 'string',
                enum: ['local', 'remote'],
              },
              RecoveryProtocol: {
                type: 'string',
                enum: ['journal_v1'],
              },
            },
          },
          resources: {},
        },
      },
    },
  },
  deploymentManager: {
    name: 'maka.application.DeploymentManager',
    version: 1,
    transport: 'remote',
    interface: {
      kind: 'service',
      methods: {
        bindingCandidates: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'BindingCandidatesRead',
            type: 'object',
            properties: {
              source: {
                anyOf: [
                  {
                    $ref: '#/$defs/DeploymentRef',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
              consumer: {
                $ref: '#/$defs/BindingConsumer',
              },
              import: {
                type: 'string',
              },
              includePackages: {
                type: 'boolean',
              },
              after: {
                type: ['string', 'null'],
              },
            },
            additionalProperties: false,
            required: ['consumer', 'import', 'includePackages'],
            $defs: {
              DeploymentRef: {
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'revision'],
              },
              BindingConsumer: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      name: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'root',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'name'],
                  },
                  {
                    type: 'object',
                    properties: {
                      package: {
                        $ref: '#/$defs/PackageRef',
                      },
                      kind: {
                        type: 'string',
                        const: 'package',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'package'],
                  },
                ],
              },
              PackageRef: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  revision: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['id', 'revision'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'BindingCandidatesPage',
            type: 'object',
            properties: {
              source: {
                $ref: '#/$defs/DeploymentRef',
              },
              configuration: {
                type: 'object',
                additionalProperties: true,
              },
              current: {
                type: 'array',
                items: {
                  $ref: '#/$defs/Target',
                },
              },
              candidates: {
                type: 'array',
                items: {
                  $ref: '#/$defs/BindingCandidate',
                },
              },
              next: {
                type: ['string', 'null'],
              },
            },
            additionalProperties: false,
            required: ['source', 'configuration', 'current', 'candidates'],
            $defs: {
              DeploymentRef: {
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'revision'],
              },
              Target: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      path: {
                        type: 'array',
                        items: {
                          type: 'string',
                        },
                      },
                      export: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'instance',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'path', 'export'],
                  },
                  {
                    type: 'object',
                    properties: {
                      name: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'import',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'name'],
                  },
                  {
                    type: 'object',
                    properties: {
                      deployment: {
                        type: 'string',
                      },
                      instance: {
                        $ref: '#/$defs/InstanceId',
                      },
                      export: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'remote',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'deployment', 'instance', 'export'],
                  },
                ],
              },
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
              BindingCandidate: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      key: {
                        type: 'string',
                      },
                      label: {
                        type: 'string',
                      },
                      presentation: {
                        $ref: '#/$defs/PackagePresentation',
                        default: {
                          displayName: '',
                          description: '',
                          localizations: {},
                        },
                      },
                      target: {
                        $ref: '#/$defs/Target',
                      },
                      kind: {
                        type: 'string',
                        const: 'bound',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'key', 'label', 'target'],
                  },
                  {
                    type: 'object',
                    properties: {
                      key: {
                        type: 'string',
                      },
                      label: {
                        type: 'string',
                      },
                      presentation: {
                        $ref: '#/$defs/PackagePresentation',
                        default: {
                          displayName: '',
                          description: '',
                          localizations: {},
                        },
                      },
                      package: {
                        $ref: '#/$defs/PackageRef',
                      },
                      export: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'package',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'key', 'label', 'package', 'export'],
                  },
                ],
              },
              PackagePresentation: {
                type: 'object',
                properties: {
                  displayName: {
                    type: 'string',
                  },
                  description: {
                    type: 'string',
                  },
                  localizations: {
                    type: 'object',
                    additionalProperties: {
                      $ref: '#/$defs/PackageDescription',
                    },
                    default: {},
                  },
                },
                additionalProperties: false,
                required: ['displayName', 'description'],
              },
              PackageDescription: {
                description:
                  'Author-provided copy for plugin discovery; never an authority declaration.',
                type: 'object',
                properties: {
                  displayName: {
                    type: 'string',
                  },
                  description: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['displayName', 'description'],
              },
              PackageRef: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  revision: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['id', 'revision'],
              },
            },
          },
          resources: {},
        },
        configure: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'InstanceConfigure',
            type: 'object',
            properties: {
              expectedRevision: {
                type: 'integer',
                format: 'uint64',
                minimum: 1,
                maximum: 9007199254740990,
              },
              instance: {
                $ref: '#/$defs/InstanceId',
              },
              changes: {
                type: 'array',
                items: {
                  $ref: '#/$defs/SettingChange',
                },
                minItems: 1,
              },
            },
            additionalProperties: false,
            required: ['expectedRevision', 'instance', 'changes'],
            $defs: {
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
              SettingChange: {
                type: 'object',
                properties: {
                  path: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                    minItems: 1,
                  },
                  value: {
                    description:
                      'None removes the field; all other fields retain their original source.',
                    anyOf: [
                      {
                        $ref: '#/$defs/SettingValue',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
                required: ['path'],
              },
              SettingValue: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      text: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'text',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'text'],
                  },
                  {
                    type: 'object',
                    properties: {
                      text: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'number',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'text'],
                  },
                  {
                    type: 'object',
                    properties: {
                      value: {
                        type: 'boolean',
                      },
                      kind: {
                        type: 'string',
                        const: 'boolean',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'value'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'null',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                ],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'ManagementResultForDeploymentRef',
            description:
              "A deterministic refusal is a recorded business result. Uncertain SQL/worker\nfailures remain in the original operation journal's Unknown outcome.",
            oneOf: [
              {
                type: 'object',
                properties: {
                  value: {
                    $ref: '#/$defs/DeploymentRef',
                  },
                  status: {
                    type: 'string',
                    const: 'committed',
                  },
                },
                additionalProperties: false,
                required: ['status', 'value'],
              },
              {
                type: 'object',
                properties: {
                  currentRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  status: {
                    type: 'string',
                    const: 'conflict',
                  },
                },
                additionalProperties: false,
                required: ['status', 'currentRevision'],
              },
              {
                type: 'object',
                properties: {
                  reason: {
                    $ref: '#/$defs/ManagementRejection',
                  },
                  diagnostic: {
                    type: ['string', 'null'],
                  },
                  status: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                additionalProperties: false,
                required: ['status', 'reason'],
              },
            ],
            $defs: {
              DeploymentRef: {
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'revision'],
              },
              ManagementRejection: {
                type: 'string',
                enum: [
                  'invalid_bundle',
                  'download_failed',
                  'invalid_document',
                  'invalid_source',
                  'package_unavailable',
                  'execution_environment',
                  'instance_unavailable',
                  'parent_disabled',
                ],
              },
            },
          },
          resources: {},
        },
        editComposition: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'CompositionEdit',
            type: 'object',
            properties: {
              expectedRevision: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
              edits: {
                type: 'array',
                items: {
                  $ref: '#/$defs/CompositionChange',
                },
              },
            },
            additionalProperties: false,
            required: ['expectedRevision', 'edits'],
            $defs: {
              CompositionChange: {
                description:
                  'One atomic patch to the original source, not a saved plan or draft registry.',
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      name: {
                        type: 'string',
                      },
                      package: {
                        $ref: '#/$defs/PackageRef',
                      },
                      settings: {
                        type: 'array',
                        items: {
                          $ref: '#/$defs/SettingChange',
                        },
                      },
                      bindings: {
                        type: 'object',
                        additionalProperties: {
                          type: 'array',
                          items: {
                            $ref: '#/$defs/Target',
                          },
                        },
                      },
                      kind: {
                        type: 'string',
                        const: 'insert',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'name', 'package', 'settings', 'bindings'],
                  },
                  {
                    type: 'object',
                    properties: {
                      name: {
                        type: 'string',
                      },
                      configuration: {
                        type: 'object',
                        additionalProperties: true,
                      },
                      bindings: {
                        type: 'object',
                        additionalProperties: {
                          type: 'array',
                          items: {
                            $ref: '#/$defs/Target',
                          },
                        },
                      },
                      kind: {
                        type: 'string',
                        const: 'update',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'name', 'configuration', 'bindings'],
                  },
                  {
                    type: 'object',
                    properties: {
                      name: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'remove',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'name'],
                  },
                ],
              },
              PackageRef: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  revision: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['id', 'revision'],
              },
              SettingChange: {
                type: 'object',
                properties: {
                  path: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                    minItems: 1,
                  },
                  value: {
                    description:
                      'None removes the field; all other fields retain their original source.',
                    anyOf: [
                      {
                        $ref: '#/$defs/SettingValue',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
                required: ['path'],
              },
              SettingValue: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      text: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'text',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'text'],
                  },
                  {
                    type: 'object',
                    properties: {
                      text: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'number',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'text'],
                  },
                  {
                    type: 'object',
                    properties: {
                      value: {
                        type: 'boolean',
                      },
                      kind: {
                        type: 'string',
                        const: 'boolean',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'value'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'null',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                ],
              },
              Target: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      path: {
                        type: 'array',
                        items: {
                          type: 'string',
                        },
                      },
                      export: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'instance',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'path', 'export'],
                  },
                  {
                    type: 'object',
                    properties: {
                      name: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'import',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'name'],
                  },
                  {
                    type: 'object',
                    properties: {
                      deployment: {
                        type: 'string',
                      },
                      instance: {
                        $ref: '#/$defs/InstanceId',
                      },
                      export: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'remote',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'deployment', 'instance', 'export'],
                  },
                ],
              },
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'ManagementResultForDeploymentRef',
            description:
              "A deterministic refusal is a recorded business result. Uncertain SQL/worker\nfailures remain in the original operation journal's Unknown outcome.",
            oneOf: [
              {
                type: 'object',
                properties: {
                  value: {
                    $ref: '#/$defs/DeploymentRef',
                  },
                  status: {
                    type: 'string',
                    const: 'committed',
                  },
                },
                additionalProperties: false,
                required: ['status', 'value'],
              },
              {
                type: 'object',
                properties: {
                  currentRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  status: {
                    type: 'string',
                    const: 'conflict',
                  },
                },
                additionalProperties: false,
                required: ['status', 'currentRevision'],
              },
              {
                type: 'object',
                properties: {
                  reason: {
                    $ref: '#/$defs/ManagementRejection',
                  },
                  diagnostic: {
                    type: ['string', 'null'],
                  },
                  status: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                additionalProperties: false,
                required: ['status', 'reason'],
              },
            ],
            $defs: {
              DeploymentRef: {
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'revision'],
              },
              ManagementRejection: {
                type: 'string',
                enum: [
                  'invalid_bundle',
                  'download_failed',
                  'invalid_document',
                  'invalid_source',
                  'package_unavailable',
                  'execution_environment',
                  'instance_unavailable',
                  'parent_disabled',
                ],
              },
            },
          },
          resources: {},
        },
        exportPackage: {
          mode: 'subscription',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'PackageBundleRead',
            description:
              'An immutable package from one committed revision, including binary files.',
            type: 'object',
            properties: {
              source: {
                $ref: '#/$defs/DeploymentRef',
              },
              package: {
                $ref: '#/$defs/PackageRef',
              },
            },
            additionalProperties: false,
            required: ['source', 'package'],
            $defs: {
              DeploymentRef: {
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'revision'],
              },
              PackageRef: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  revision: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['id', 'revision'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'PackageBundleExport',
            description:
              'Bundle JSON already encodes file bytes; text chunks add no second base64 layer.',
            oneOf: [
              {
                type: 'object',
                properties: {
                  offset: {
                    type: 'integer',
                    format: 'uint',
                    minimum: 0,
                  },
                  totalBytes: {
                    type: 'integer',
                    format: 'uint',
                    minimum: 0,
                  },
                  text: {
                    type: 'string',
                    maxLength: 16384,
                  },
                  kind: {
                    type: 'string',
                    const: 'chunk',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'offset', 'totalBytes', 'text'],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'complete',
                  },
                },
                additionalProperties: false,
                required: ['kind'],
              },
            ],
          },
          resources: {},
        },
        install: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'PackageInstall',
            type: 'object',
            properties: {
              expectedRevision: {
                type: 'integer',
                format: 'uint64',
                minimum: 1,
                maximum: 9007199254740990,
              },
            },
            additionalProperties: false,
            required: ['expectedRevision'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'ManagementResultForPackageInstalled',
            description:
              "A deterministic refusal is a recorded business result. Uncertain SQL/worker\nfailures remain in the original operation journal's Unknown outcome.",
            oneOf: [
              {
                type: 'object',
                properties: {
                  value: {
                    $ref: '#/$defs/PackageInstalled',
                  },
                  status: {
                    type: 'string',
                    const: 'committed',
                  },
                },
                additionalProperties: false,
                required: ['status', 'value'],
              },
              {
                type: 'object',
                properties: {
                  currentRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  status: {
                    type: 'string',
                    const: 'conflict',
                  },
                },
                additionalProperties: false,
                required: ['status', 'currentRevision'],
              },
              {
                type: 'object',
                properties: {
                  reason: {
                    $ref: '#/$defs/ManagementRejection',
                  },
                  diagnostic: {
                    type: ['string', 'null'],
                  },
                  status: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                additionalProperties: false,
                required: ['status', 'reason'],
              },
            ],
            $defs: {
              PackageInstalled: {
                type: 'object',
                properties: {
                  source: {
                    $ref: '#/$defs/DeploymentRef',
                  },
                  package: {
                    $ref: '#/$defs/PackageRef',
                  },
                },
                additionalProperties: false,
                required: ['source', 'package'],
              },
              DeploymentRef: {
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'revision'],
              },
              PackageRef: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  revision: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['id', 'revision'],
              },
              ManagementRejection: {
                type: 'string',
                enum: [
                  'invalid_bundle',
                  'download_failed',
                  'invalid_document',
                  'invalid_source',
                  'package_unavailable',
                  'execution_environment',
                  'instance_unavailable',
                  'parent_disabled',
                ],
              },
            },
          },
          resources: {
            package: {
              type: {
                name: 'maka.bytes',
                version: 1,
              },
              optional: false,
            },
          },
        },
        installSource: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'PackageSourceInstall',
            type: 'object',
            properties: {
              expectedRevision: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
              files: {
                description:
                  'UTF-8 package files, including maka.extension.json. Bytes determine identity.',
                type: 'object',
                additionalProperties: {
                  type: 'string',
                },
              },
            },
            additionalProperties: false,
            required: ['expectedRevision', 'files'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'ManagementResultForPackageInstalled',
            description:
              "A deterministic refusal is a recorded business result. Uncertain SQL/worker\nfailures remain in the original operation journal's Unknown outcome.",
            oneOf: [
              {
                type: 'object',
                properties: {
                  value: {
                    $ref: '#/$defs/PackageInstalled',
                  },
                  status: {
                    type: 'string',
                    const: 'committed',
                  },
                },
                additionalProperties: false,
                required: ['status', 'value'],
              },
              {
                type: 'object',
                properties: {
                  currentRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  status: {
                    type: 'string',
                    const: 'conflict',
                  },
                },
                additionalProperties: false,
                required: ['status', 'currentRevision'],
              },
              {
                type: 'object',
                properties: {
                  reason: {
                    $ref: '#/$defs/ManagementRejection',
                  },
                  diagnostic: {
                    type: ['string', 'null'],
                  },
                  status: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                additionalProperties: false,
                required: ['status', 'reason'],
              },
            ],
            $defs: {
              PackageInstalled: {
                type: 'object',
                properties: {
                  source: {
                    $ref: '#/$defs/DeploymentRef',
                  },
                  package: {
                    $ref: '#/$defs/PackageRef',
                  },
                },
                additionalProperties: false,
                required: ['source', 'package'],
              },
              DeploymentRef: {
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'revision'],
              },
              PackageRef: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  revision: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['id', 'revision'],
              },
              ManagementRejection: {
                type: 'string',
                enum: [
                  'invalid_bundle',
                  'download_failed',
                  'invalid_document',
                  'invalid_source',
                  'package_unavailable',
                  'execution_environment',
                  'instance_unavailable',
                  'parent_disabled',
                ],
              },
            },
          },
          resources: {},
        },
        installUrl: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'PackageUrlInstall',
            type: 'object',
            properties: {
              expectedRevision: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
              url: {
                type: 'string',
              },
              sha256: {
                description:
                  'Optional SHA-256 of the downloaded bundle bytes, from a trusted publisher.',
                type: ['string', 'null'],
                default: null,
              },
            },
            additionalProperties: false,
            required: ['expectedRevision', 'url'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'ManagementResultForPackageInstalled',
            description:
              "A deterministic refusal is a recorded business result. Uncertain SQL/worker\nfailures remain in the original operation journal's Unknown outcome.",
            oneOf: [
              {
                type: 'object',
                properties: {
                  value: {
                    $ref: '#/$defs/PackageInstalled',
                  },
                  status: {
                    type: 'string',
                    const: 'committed',
                  },
                },
                additionalProperties: false,
                required: ['status', 'value'],
              },
              {
                type: 'object',
                properties: {
                  currentRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  status: {
                    type: 'string',
                    const: 'conflict',
                  },
                },
                additionalProperties: false,
                required: ['status', 'currentRevision'],
              },
              {
                type: 'object',
                properties: {
                  reason: {
                    $ref: '#/$defs/ManagementRejection',
                  },
                  diagnostic: {
                    type: ['string', 'null'],
                  },
                  status: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                additionalProperties: false,
                required: ['status', 'reason'],
              },
            ],
            $defs: {
              PackageInstalled: {
                type: 'object',
                properties: {
                  source: {
                    $ref: '#/$defs/DeploymentRef',
                  },
                  package: {
                    $ref: '#/$defs/PackageRef',
                  },
                },
                additionalProperties: false,
                required: ['source', 'package'],
              },
              DeploymentRef: {
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'revision'],
              },
              PackageRef: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  revision: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['id', 'revision'],
              },
              ManagementRejection: {
                type: 'string',
                enum: [
                  'invalid_bundle',
                  'download_failed',
                  'invalid_document',
                  'invalid_source',
                  'package_unavailable',
                  'execution_environment',
                  'instance_unavailable',
                  'parent_disabled',
                ],
              },
            },
          },
          resources: {},
        },
        instances: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'DeploymentInstances',
            description:
              'A fixed committed source for continuation; no runtime or permission claim.',
            oneOf: [
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'start',
                  },
                },
                additionalProperties: false,
                required: ['kind'],
              },
              {
                type: 'object',
                properties: {
                  source: {
                    $ref: '#/$defs/DeploymentRef',
                  },
                  after: {
                    anyOf: [
                      {
                        $ref: '#/$defs/InstanceId',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  kind: {
                    type: 'string',
                    const: 'continue',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'source'],
              },
            ],
            $defs: {
              DeploymentRef: {
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'revision'],
              },
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'ManagedInstancesPage',
            type: 'object',
            properties: {
              source: {
                $ref: '#/$defs/DeploymentRef',
              },
              instances: {
                type: 'array',
                items: {
                  $ref: '#/$defs/ManagedInstance',
                },
                maxItems: 8,
              },
              next: {
                anyOf: [
                  {
                    $ref: '#/$defs/InstanceId',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
            },
            additionalProperties: false,
            required: ['source', 'instances'],
            $defs: {
              DeploymentRef: {
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'revision'],
              },
              ManagedInstance: {
                type: 'object',
                properties: {
                  instance: {
                    $ref: '#/$defs/InstanceId',
                  },
                  path: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  package: {
                    $ref: '#/$defs/PackageRef',
                  },
                  presentation: {
                    $ref: '#/$defs/PackagePresentation',
                    default: {
                      displayName: '',
                      description: '',
                      localizations: {},
                    },
                  },
                  structural: {
                    type: 'boolean',
                  },
                  disabled: {
                    type: 'boolean',
                  },
                  parentDisabled: {
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: [
                  'instance',
                  'path',
                  'package',
                  'structural',
                  'disabled',
                  'parentDisabled',
                ],
              },
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
              PackageRef: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  revision: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['id', 'revision'],
              },
              PackagePresentation: {
                type: 'object',
                properties: {
                  displayName: {
                    type: 'string',
                  },
                  description: {
                    type: 'string',
                  },
                  localizations: {
                    type: 'object',
                    additionalProperties: {
                      $ref: '#/$defs/PackageDescription',
                    },
                    default: {},
                  },
                },
                additionalProperties: false,
                required: ['displayName', 'description'],
              },
              PackageDescription: {
                description:
                  'Author-provided copy for plugin discovery; never an authority declaration.',
                type: 'object',
                properties: {
                  displayName: {
                    type: 'string',
                  },
                  description: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['displayName', 'description'],
              },
            },
          },
          resources: {},
        },
        packageSettings: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'PackageSettingsRead',
            type: 'object',
            properties: {
              source: {
                $ref: '#/$defs/DeploymentRef',
              },
              package: {
                $ref: '#/$defs/PackageRef',
              },
              path: {
                type: 'array',
                items: {
                  type: 'string',
                },
              },
              after: {
                type: ['string', 'null'],
              },
              changes: {
                type: 'array',
                items: {
                  $ref: '#/$defs/SettingChange',
                },
              },
            },
            additionalProperties: false,
            required: ['source', 'package', 'path', 'changes'],
            $defs: {
              DeploymentRef: {
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'revision'],
              },
              PackageRef: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  revision: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['id', 'revision'],
              },
              SettingChange: {
                type: 'object',
                properties: {
                  path: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                    minItems: 1,
                  },
                  value: {
                    description:
                      'None removes the field; all other fields retain their original source.',
                    anyOf: [
                      {
                        $ref: '#/$defs/SettingValue',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
                required: ['path'],
              },
              SettingValue: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      text: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'text',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'text'],
                  },
                  {
                    type: 'object',
                    properties: {
                      text: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'number',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'text'],
                  },
                  {
                    type: 'object',
                    properties: {
                      value: {
                        type: 'boolean',
                      },
                      kind: {
                        type: 'string',
                        const: 'boolean',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'value'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'null',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                ],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'PackageSettingsPage',
            type: 'object',
            properties: {
              source: {
                $ref: '#/$defs/DeploymentRef',
              },
              package: {
                $ref: '#/$defs/PackageRef',
              },
              path: {
                type: 'array',
                items: {
                  type: 'string',
                },
              },
              fields: {
                type: 'array',
                items: {
                  $ref: '#/$defs/SettingField',
                },
              },
              next: {
                type: ['string', 'null'],
              },
              imports: {
                type: 'array',
                items: {
                  $ref: '#/$defs/ManagedImport',
                },
              },
            },
            additionalProperties: false,
            required: ['source', 'package', 'path', 'fields', 'imports'],
            $defs: {
              DeploymentRef: {
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'revision'],
              },
              PackageRef: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  revision: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['id', 'revision'],
              },
              SettingField: {
                type: 'object',
                properties: {
                  key: {
                    type: 'string',
                  },
                  label: {
                    type: 'string',
                  },
                  description: {
                    type: 'string',
                  },
                  kind: {
                    $ref: '#/$defs/SettingKind',
                  },
                  present: {
                    type: 'boolean',
                  },
                  required: {
                    type: 'boolean',
                  },
                  nullable: {
                    type: 'boolean',
                  },
                  editable: {
                    type: 'boolean',
                  },
                  value: {
                    anyOf: [
                      {
                        $ref: '#/$defs/SettingValue',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  options: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/SettingValue',
                    },
                  },
                },
                additionalProperties: false,
                required: [
                  'key',
                  'label',
                  'description',
                  'kind',
                  'present',
                  'required',
                  'nullable',
                  'editable',
                  'options',
                ],
              },
              SettingKind: {
                type: 'string',
                enum: ['text', 'number', 'boolean', 'object', 'array', 'null', 'unsupported'],
              },
              SettingValue: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      text: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'text',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'text'],
                  },
                  {
                    type: 'object',
                    properties: {
                      text: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'number',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'text'],
                  },
                  {
                    type: 'object',
                    properties: {
                      value: {
                        type: 'boolean',
                      },
                      kind: {
                        type: 'string',
                        const: 'boolean',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'value'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'null',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                ],
              },
              ManagedImport: {
                type: 'object',
                properties: {
                  name: {
                    type: 'string',
                  },
                  contract: {
                    type: 'string',
                  },
                  cardinality: {
                    $ref: '#/$defs/Cardinality',
                  },
                },
                additionalProperties: false,
                required: ['name', 'contract', 'cardinality'],
              },
              Cardinality: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'one',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'optional',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      min: {
                        type: 'integer',
                        format: 'uint',
                        minimum: 0,
                      },
                      max: {
                        type: 'integer',
                        format: 'uint',
                        minimum: 0,
                      },
                      kind: {
                        type: 'string',
                        const: 'many',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'min', 'max'],
                  },
                ],
              },
            },
          },
          resources: {},
        },
        read: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'DeploymentRead',
            type: 'object',
            additionalProperties: false,
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'ManagedDeployment',
            description:
              'Committed desired source and available immutable packages, not runtime readiness.',
            type: 'object',
            properties: {
              source: {
                $ref: '#/$defs/Deployment',
              },
              packages: {
                type: 'array',
                items: {
                  $ref: '#/$defs/PackageRef',
                },
              },
            },
            additionalProperties: false,
            required: ['source', 'packages'],
            $defs: {
              Deployment: {
                type: 'object',
                properties: {
                  reference: {
                    $ref: '#/$defs/DeploymentRef',
                  },
                  input: {
                    $ref: '#/$defs/CompositionInput',
                  },
                  remoteExports: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/RemoteObservation',
                    },
                  },
                },
                additionalProperties: false,
                required: ['reference', 'input', 'remoteExports'],
              },
              DeploymentRef: {
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'revision'],
              },
              CompositionInput: {
                description:
                  'Durable deployment input. Plans are derived and never persisted as overrides.',
                type: 'object',
                properties: {
                  environment: {
                    $ref: '#/$defs/Environment',
                  },
                  instances: {
                    type: 'object',
                    additionalProperties: {
                      $ref: '#/$defs/CompositionNode',
                    },
                  },
                  launch: {
                    anyOf: [
                      {
                        $ref: '#/$defs/Target',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  recovery: {
                    description:
                      'Explicit ordinary fallback. Selection grants no extra capabilities.',
                    anyOf: [
                      {
                        $ref: '#/$defs/Target',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
                required: ['environment', 'instances'],
              },
              Environment: {
                type: 'object',
                properties: {
                  location: {
                    $ref: '#/$defs/ExecutionLocation',
                  },
                  presentation: {
                    anyOf: [
                      {
                        $ref: '#/$defs/PresentationTarget',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
                required: ['location'],
              },
              ExecutionLocation: {
                type: 'string',
                enum: ['host', 'ui'],
              },
              PresentationTarget: {
                type: 'string',
                enum: ['tui'],
              },
              CompositionNode: {
                type: 'object',
                properties: {
                  key: {
                    type: 'string',
                    format: 'uuid',
                  },
                  package: {
                    $ref: '#/$defs/PackageSelection',
                  },
                  usePackage: {
                    $ref: '#/$defs/PackageUse',
                  },
                  configuration: {
                    $ref: '#/$defs/Configuration',
                    default: {
                      values: {},
                      parameters: {},
                    },
                  },
                  parameters: {
                    $ref: '#/$defs/Configuration',
                    default: {
                      values: {},
                      parameters: {},
                    },
                  },
                  bindings: {
                    type: 'object',
                    additionalProperties: {
                      type: 'array',
                      items: {
                        $ref: '#/$defs/Target',
                      },
                    },
                    default: {},
                  },
                  disabled: {
                    type: 'boolean',
                    default: false,
                  },
                  overrides: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/Override',
                    },
                    default: [],
                  },
                },
                additionalProperties: false,
                required: ['key', 'package', 'usePackage'],
              },
              PackageSelection: {
                description:
                  'Templates can select an entry in their own immutable package without a\nself-referential content hash. Deployment roots must select a pinned revision.',
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      package: {
                        $ref: '#/$defs/PackageRef',
                      },
                      source: {
                        type: 'string',
                        const: 'pinned',
                      },
                    },
                    additionalProperties: false,
                    required: ['source', 'package'],
                  },
                  {
                    type: 'object',
                    properties: {
                      source: {
                        type: 'string',
                        const: 'current',
                      },
                    },
                    required: ['source'],
                    additionalProperties: false,
                  },
                ],
              },
              PackageRef: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  revision: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['id', 'revision'],
              },
              PackageUse: {
                type: 'string',
                enum: ['entry', 'composition'],
              },
              Configuration: {
                type: 'object',
                properties: {
                  values: {
                    type: 'object',
                    additionalProperties: true,
                    default: {},
                  },
                  parameters: {
                    description:
                      'Configuration field -> parameter name of the containing template.',
                    type: 'object',
                    additionalProperties: {
                      type: 'string',
                    },
                    default: {},
                  },
                },
                additionalProperties: false,
              },
              Target: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      path: {
                        type: 'array',
                        items: {
                          type: 'string',
                        },
                      },
                      export: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'instance',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'path', 'export'],
                  },
                  {
                    type: 'object',
                    properties: {
                      name: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'import',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'name'],
                  },
                  {
                    type: 'object',
                    properties: {
                      deployment: {
                        type: 'string',
                      },
                      instance: {
                        $ref: '#/$defs/InstanceId',
                      },
                      export: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'remote',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'deployment', 'instance', 'export'],
                  },
                ],
              },
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
              Override: {
                description:
                  'An override belongs to its containing structural instance. Missing paths fail;\nremoval/upgrade never guesses how to discard independent user intent.',
                type: 'object',
                properties: {
                  path: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  package: {
                    anyOf: [
                      {
                        $ref: '#/$defs/PackageRef',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  usePackage: {
                    anyOf: [
                      {
                        $ref: '#/$defs/PackageUse',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  parameters: {
                    type: 'object',
                    additionalProperties: true,
                    default: {},
                  },
                  configuration: {
                    type: 'object',
                    additionalProperties: true,
                    default: {},
                  },
                  bindings: {
                    type: 'object',
                    additionalProperties: {
                      type: 'array',
                      items: {
                        $ref: '#/$defs/Target',
                      },
                    },
                    default: {},
                  },
                  disabled: {
                    type: ['boolean', 'null'],
                  },
                },
                additionalProperties: false,
                required: ['path'],
              },
              RemoteObservation: {
                description:
                  'A static compatibility observation, never a remote registration or grant.',
                type: 'object',
                properties: {
                  capability: {
                    $ref: '#/$defs/RemoteCapability',
                  },
                  declaration: {
                    $ref: '#/$defs/Export',
                  },
                },
                additionalProperties: false,
                required: ['capability', 'declaration'],
              },
              RemoteCapability: {
                type: 'object',
                properties: {
                  deployment: {
                    type: 'string',
                  },
                  instance: {
                    $ref: '#/$defs/InstanceId',
                  },
                  export: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['deployment', 'instance', 'export'],
              },
              Export: {
                type: 'object',
                properties: {
                  contract: {
                    $ref: '#/$defs/Contract',
                  },
                  availability: {
                    $ref: '#/$defs/Availability',
                  },
                },
                additionalProperties: false,
                required: ['contract', 'availability'],
              },
              Contract: {
                description:
                  'Public contract definitions are package data, not live registration records.',
                type: 'object',
                properties: {
                  name: {
                    type: 'string',
                  },
                  version: {
                    type: 'integer',
                    format: 'uint32',
                    minimum: 0,
                  },
                  transport: {
                    $ref: '#/$defs/Transport',
                  },
                  interface: {
                    $ref: '#/$defs/Interface',
                  },
                },
                additionalProperties: false,
                required: ['name', 'version', 'transport', 'interface'],
              },
              Transport: {
                type: 'string',
                enum: ['local', 'remote'],
              },
              Interface: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      methods: {
                        type: 'object',
                        additionalProperties: {
                          $ref: '#/$defs/Method',
                        },
                      },
                      kind: {
                        type: 'string',
                        const: 'service',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'methods'],
                  },
                  {
                    type: 'object',
                    properties: {
                      props: true,
                      events: {
                        type: 'object',
                        additionalProperties: true,
                      },
                      captures: {
                        type: 'object',
                        additionalProperties: {
                          $ref: '#/$defs/Capture',
                        },
                      },
                      kind: {
                        type: 'string',
                        const: 'component',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'props', 'events', 'captures'],
                  },
                  {
                    type: 'object',
                    properties: {
                      schema: true,
                      kind: {
                        type: 'string',
                        const: 'value',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'schema'],
                  },
                  {
                    type: 'object',
                    properties: {
                      resource: {
                        type: 'string',
                      },
                      schema: true,
                      kind: {
                        type: 'string',
                        const: 'resource',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'resource', 'schema'],
                  },
                ],
              },
              Method: {
                type: 'object',
                properties: {
                  mode: {
                    $ref: '#/$defs/MethodMode',
                  },
                  input: true,
                  output: true,
                  progress: {
                    description:
                      'Bounded transient observations from this mutation, separate from its\noriginal final receipt. Only mutation methods may declare progress.',
                  },
                  resources: {
                    type: 'object',
                    additionalProperties: {
                      $ref: '#/$defs/ResourceSlot',
                    },
                  },
                },
                additionalProperties: false,
                required: ['mode', 'input', 'output', 'resources'],
              },
              MethodMode: {
                type: 'string',
                enum: ['query', 'mutation', 'subscription'],
              },
              ResourceSlot: {
                description:
                  'One declared input slot: its nominal type and whether the caller may omit it.',
                type: 'object',
                properties: {
                  type: {
                    $ref: '#/$defs/ResourceType',
                  },
                  optional: {
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: ['type', 'optional'],
              },
              ResourceType: {
                description:
                  'Nominal read-only resource shape, not a resource id or authorization token.',
                type: 'object',
                properties: {
                  name: {
                    type: 'string',
                  },
                  version: {
                    type: 'integer',
                    format: 'uint32',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['name', 'version'],
              },
              Capture: {
                type: 'object',
                properties: {
                  input: true,
                  output: {
                    $ref: '#/$defs/CaptureOutput',
                  },
                },
                additionalProperties: false,
                required: ['input', 'output'],
              },
              CaptureOutput: {
                description:
                  'Resource captures enter checked service slots; continuations remain in the\noriginal presentation owner and only decide admission of query feedback.',
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      resource: {
                        $ref: '#/$defs/ResourceType',
                      },
                      kind: {
                        type: 'string',
                        const: 'resource',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'resource'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'continuation',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                ],
              },
              Availability: {
                type: 'string',
                enum: ['required', 'optional'],
              },
            },
          },
          resources: {},
        },
        readDocument: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'DeploymentDocumentRead',
            type: 'object',
            properties: {
              source: {
                $ref: '#/$defs/DeploymentRef',
              },
              offset: {
                type: 'integer',
                format: 'uint',
                minimum: 0,
              },
            },
            additionalProperties: false,
            required: ['source', 'offset'],
            $defs: {
              DeploymentRef: {
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'revision'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'DeploymentDocumentChunk',
            type: 'object',
            properties: {
              source: {
                $ref: '#/$defs/DeploymentRef',
              },
              offset: {
                type: 'integer',
                format: 'uint',
                minimum: 0,
              },
              totalBytes: {
                type: 'integer',
                format: 'uint',
                minimum: 0,
              },
              text: {
                type: 'string',
                maxLength: 65536,
              },
              next: {
                type: ['integer', 'null'],
                format: 'uint',
                minimum: 0,
              },
            },
            additionalProperties: false,
            required: ['source', 'offset', 'totalBytes', 'text'],
            $defs: {
              DeploymentRef: {
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'revision'],
              },
            },
          },
          resources: {},
        },
        readPackage: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'PackageSourceRead',
            type: 'object',
            properties: {
              source: {
                $ref: '#/$defs/DeploymentRef',
              },
              package: {
                $ref: '#/$defs/PackageRef',
              },
              path: {
                type: ['string', 'null'],
              },
              offset: {
                type: 'integer',
                format: 'uint',
                minimum: 0,
              },
            },
            additionalProperties: false,
            required: ['source', 'package', 'offset'],
            $defs: {
              DeploymentRef: {
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'revision'],
              },
              PackageRef: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  revision: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['id', 'revision'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'PackageSourceChunk',
            type: 'object',
            properties: {
              paths: {
                type: 'array',
                items: {
                  type: 'string',
                },
              },
              text: {
                type: ['string', 'null'],
              },
              next: {
                type: ['integer', 'null'],
                format: 'uint',
                minimum: 0,
              },
            },
            additionalProperties: false,
            required: ['paths'],
          },
          resources: {},
        },
        readSettings: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'InstanceSettingsRead',
            type: 'object',
            properties: {
              source: {
                $ref: '#/$defs/DeploymentRef',
              },
              instance: {
                $ref: '#/$defs/InstanceId',
              },
              path: {
                type: 'array',
                items: {
                  type: 'string',
                },
              },
              after: {
                type: ['string', 'null'],
              },
            },
            additionalProperties: false,
            required: ['source', 'instance', 'path'],
            $defs: {
              DeploymentRef: {
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'revision'],
              },
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'InstanceSettingsPage',
            type: 'object',
            properties: {
              source: {
                $ref: '#/$defs/DeploymentRef',
              },
              instance: {
                $ref: '#/$defs/InstanceId',
              },
              path: {
                type: 'array',
                items: {
                  type: 'string',
                },
              },
              fields: {
                type: 'array',
                items: {
                  $ref: '#/$defs/SettingField',
                },
                maxItems: 8,
              },
              next: {
                type: ['string', 'null'],
              },
            },
            additionalProperties: false,
            required: ['source', 'instance', 'path', 'fields'],
            $defs: {
              DeploymentRef: {
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'revision'],
              },
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
              SettingField: {
                type: 'object',
                properties: {
                  key: {
                    type: 'string',
                  },
                  label: {
                    type: 'string',
                  },
                  description: {
                    type: 'string',
                  },
                  kind: {
                    $ref: '#/$defs/SettingKind',
                  },
                  present: {
                    type: 'boolean',
                  },
                  required: {
                    type: 'boolean',
                  },
                  nullable: {
                    type: 'boolean',
                  },
                  editable: {
                    type: 'boolean',
                  },
                  value: {
                    anyOf: [
                      {
                        $ref: '#/$defs/SettingValue',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  options: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/SettingValue',
                    },
                  },
                },
                additionalProperties: false,
                required: [
                  'key',
                  'label',
                  'description',
                  'kind',
                  'present',
                  'required',
                  'nullable',
                  'editable',
                  'options',
                ],
              },
              SettingKind: {
                type: 'string',
                enum: ['text', 'number', 'boolean', 'object', 'array', 'null', 'unsupported'],
              },
              SettingValue: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      text: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'text',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'text'],
                  },
                  {
                    type: 'object',
                    properties: {
                      text: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'number',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'text'],
                  },
                  {
                    type: 'object',
                    properties: {
                      value: {
                        type: 'boolean',
                      },
                      kind: {
                        type: 'string',
                        const: 'boolean',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'value'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'null',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                ],
              },
            },
          },
          resources: {},
        },
        replace: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'DeploymentReplace',
            type: 'object',
            properties: {
              expectedRevision: {
                type: 'integer',
                format: 'uint64',
                minimum: 1,
                maximum: 9007199254740990,
              },
            },
            additionalProperties: false,
            required: ['expectedRevision'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'ManagementResultForDeploymentRef',
            description:
              "A deterministic refusal is a recorded business result. Uncertain SQL/worker\nfailures remain in the original operation journal's Unknown outcome.",
            oneOf: [
              {
                type: 'object',
                properties: {
                  value: {
                    $ref: '#/$defs/DeploymentRef',
                  },
                  status: {
                    type: 'string',
                    const: 'committed',
                  },
                },
                additionalProperties: false,
                required: ['status', 'value'],
              },
              {
                type: 'object',
                properties: {
                  currentRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  status: {
                    type: 'string',
                    const: 'conflict',
                  },
                },
                additionalProperties: false,
                required: ['status', 'currentRevision'],
              },
              {
                type: 'object',
                properties: {
                  reason: {
                    $ref: '#/$defs/ManagementRejection',
                  },
                  diagnostic: {
                    type: ['string', 'null'],
                  },
                  status: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                additionalProperties: false,
                required: ['status', 'reason'],
              },
            ],
            $defs: {
              DeploymentRef: {
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'revision'],
              },
              ManagementRejection: {
                type: 'string',
                enum: [
                  'invalid_bundle',
                  'download_failed',
                  'invalid_document',
                  'invalid_source',
                  'package_unavailable',
                  'execution_environment',
                  'instance_unavailable',
                  'parent_disabled',
                ],
              },
            },
          },
          resources: {
            document: {
              type: {
                name: 'maka.text.utf8',
                version: 1,
              },
              optional: false,
            },
            packages: {
              type: {
                name: 'maka.bytes',
                version: 1,
              },
              optional: true,
            },
          },
        },
        replaceSource: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'DeploymentSourceReplace',
            type: 'object',
            properties: {
              expectedRevision: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
              document: {
                $ref: '#/$defs/DeploymentDocument',
              },
            },
            additionalProperties: false,
            required: ['expectedRevision', 'document'],
            $defs: {
              DeploymentDocument: {
                description:
                  'Source document edited by one native buffer, never a second desired plan.',
                type: 'object',
                properties: {
                  input: {
                    $ref: '#/$defs/CompositionInput',
                  },
                  remoteExports: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/RemoteObservation',
                    },
                  },
                  packages: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/PackageRef',
                    },
                  },
                },
                additionalProperties: false,
                required: ['input', 'remoteExports', 'packages'],
              },
              CompositionInput: {
                description:
                  'Durable deployment input. Plans are derived and never persisted as overrides.',
                type: 'object',
                properties: {
                  environment: {
                    $ref: '#/$defs/Environment',
                  },
                  instances: {
                    type: 'object',
                    additionalProperties: {
                      $ref: '#/$defs/CompositionNode',
                    },
                  },
                  launch: {
                    anyOf: [
                      {
                        $ref: '#/$defs/Target',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  recovery: {
                    description:
                      'Explicit ordinary fallback. Selection grants no extra capabilities.',
                    anyOf: [
                      {
                        $ref: '#/$defs/Target',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
                required: ['environment', 'instances'],
              },
              Environment: {
                type: 'object',
                properties: {
                  location: {
                    $ref: '#/$defs/ExecutionLocation',
                  },
                  presentation: {
                    anyOf: [
                      {
                        $ref: '#/$defs/PresentationTarget',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
                required: ['location'],
              },
              ExecutionLocation: {
                type: 'string',
                enum: ['host', 'ui'],
              },
              PresentationTarget: {
                type: 'string',
                enum: ['tui'],
              },
              CompositionNode: {
                type: 'object',
                properties: {
                  key: {
                    type: 'string',
                    format: 'uuid',
                  },
                  package: {
                    $ref: '#/$defs/PackageSelection',
                  },
                  usePackage: {
                    $ref: '#/$defs/PackageUse',
                  },
                  configuration: {
                    $ref: '#/$defs/Configuration',
                    default: {
                      values: {},
                      parameters: {},
                    },
                  },
                  parameters: {
                    $ref: '#/$defs/Configuration',
                    default: {
                      values: {},
                      parameters: {},
                    },
                  },
                  bindings: {
                    type: 'object',
                    additionalProperties: {
                      type: 'array',
                      items: {
                        $ref: '#/$defs/Target',
                      },
                    },
                    default: {},
                  },
                  disabled: {
                    type: 'boolean',
                    default: false,
                  },
                  overrides: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/Override',
                    },
                    default: [],
                  },
                },
                additionalProperties: false,
                required: ['key', 'package', 'usePackage'],
              },
              PackageSelection: {
                description:
                  'Templates can select an entry in their own immutable package without a\nself-referential content hash. Deployment roots must select a pinned revision.',
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      package: {
                        $ref: '#/$defs/PackageRef',
                      },
                      source: {
                        type: 'string',
                        const: 'pinned',
                      },
                    },
                    additionalProperties: false,
                    required: ['source', 'package'],
                  },
                  {
                    type: 'object',
                    properties: {
                      source: {
                        type: 'string',
                        const: 'current',
                      },
                    },
                    required: ['source'],
                    additionalProperties: false,
                  },
                ],
              },
              PackageRef: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  revision: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['id', 'revision'],
              },
              PackageUse: {
                type: 'string',
                enum: ['entry', 'composition'],
              },
              Configuration: {
                type: 'object',
                properties: {
                  values: {
                    type: 'object',
                    additionalProperties: true,
                    default: {},
                  },
                  parameters: {
                    description:
                      'Configuration field -> parameter name of the containing template.',
                    type: 'object',
                    additionalProperties: {
                      type: 'string',
                    },
                    default: {},
                  },
                },
                additionalProperties: false,
              },
              Target: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      path: {
                        type: 'array',
                        items: {
                          type: 'string',
                        },
                      },
                      export: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'instance',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'path', 'export'],
                  },
                  {
                    type: 'object',
                    properties: {
                      name: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'import',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'name'],
                  },
                  {
                    type: 'object',
                    properties: {
                      deployment: {
                        type: 'string',
                      },
                      instance: {
                        $ref: '#/$defs/InstanceId',
                      },
                      export: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'remote',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'deployment', 'instance', 'export'],
                  },
                ],
              },
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
              Override: {
                description:
                  'An override belongs to its containing structural instance. Missing paths fail;\nremoval/upgrade never guesses how to discard independent user intent.',
                type: 'object',
                properties: {
                  path: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  package: {
                    anyOf: [
                      {
                        $ref: '#/$defs/PackageRef',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  usePackage: {
                    anyOf: [
                      {
                        $ref: '#/$defs/PackageUse',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  parameters: {
                    type: 'object',
                    additionalProperties: true,
                    default: {},
                  },
                  configuration: {
                    type: 'object',
                    additionalProperties: true,
                    default: {},
                  },
                  bindings: {
                    type: 'object',
                    additionalProperties: {
                      type: 'array',
                      items: {
                        $ref: '#/$defs/Target',
                      },
                    },
                    default: {},
                  },
                  disabled: {
                    type: ['boolean', 'null'],
                  },
                },
                additionalProperties: false,
                required: ['path'],
              },
              RemoteObservation: {
                description:
                  'A static compatibility observation, never a remote registration or grant.',
                type: 'object',
                properties: {
                  capability: {
                    $ref: '#/$defs/RemoteCapability',
                  },
                  declaration: {
                    $ref: '#/$defs/Export',
                  },
                },
                additionalProperties: false,
                required: ['capability', 'declaration'],
              },
              RemoteCapability: {
                type: 'object',
                properties: {
                  deployment: {
                    type: 'string',
                  },
                  instance: {
                    $ref: '#/$defs/InstanceId',
                  },
                  export: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['deployment', 'instance', 'export'],
              },
              Export: {
                type: 'object',
                properties: {
                  contract: {
                    $ref: '#/$defs/Contract',
                  },
                  availability: {
                    $ref: '#/$defs/Availability',
                  },
                },
                additionalProperties: false,
                required: ['contract', 'availability'],
              },
              Contract: {
                description:
                  'Public contract definitions are package data, not live registration records.',
                type: 'object',
                properties: {
                  name: {
                    type: 'string',
                  },
                  version: {
                    type: 'integer',
                    format: 'uint32',
                    minimum: 0,
                  },
                  transport: {
                    $ref: '#/$defs/Transport',
                  },
                  interface: {
                    $ref: '#/$defs/Interface',
                  },
                },
                additionalProperties: false,
                required: ['name', 'version', 'transport', 'interface'],
              },
              Transport: {
                type: 'string',
                enum: ['local', 'remote'],
              },
              Interface: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      methods: {
                        type: 'object',
                        additionalProperties: {
                          $ref: '#/$defs/Method',
                        },
                      },
                      kind: {
                        type: 'string',
                        const: 'service',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'methods'],
                  },
                  {
                    type: 'object',
                    properties: {
                      props: true,
                      events: {
                        type: 'object',
                        additionalProperties: true,
                      },
                      captures: {
                        type: 'object',
                        additionalProperties: {
                          $ref: '#/$defs/Capture',
                        },
                      },
                      kind: {
                        type: 'string',
                        const: 'component',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'props', 'events', 'captures'],
                  },
                  {
                    type: 'object',
                    properties: {
                      schema: true,
                      kind: {
                        type: 'string',
                        const: 'value',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'schema'],
                  },
                  {
                    type: 'object',
                    properties: {
                      resource: {
                        type: 'string',
                      },
                      schema: true,
                      kind: {
                        type: 'string',
                        const: 'resource',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'resource', 'schema'],
                  },
                ],
              },
              Method: {
                type: 'object',
                properties: {
                  mode: {
                    $ref: '#/$defs/MethodMode',
                  },
                  input: true,
                  output: true,
                  progress: {
                    description:
                      'Bounded transient observations from this mutation, separate from its\noriginal final receipt. Only mutation methods may declare progress.',
                  },
                  resources: {
                    type: 'object',
                    additionalProperties: {
                      $ref: '#/$defs/ResourceSlot',
                    },
                  },
                },
                additionalProperties: false,
                required: ['mode', 'input', 'output', 'resources'],
              },
              MethodMode: {
                type: 'string',
                enum: ['query', 'mutation', 'subscription'],
              },
              ResourceSlot: {
                description:
                  'One declared input slot: its nominal type and whether the caller may omit it.',
                type: 'object',
                properties: {
                  type: {
                    $ref: '#/$defs/ResourceType',
                  },
                  optional: {
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: ['type', 'optional'],
              },
              ResourceType: {
                description:
                  'Nominal read-only resource shape, not a resource id or authorization token.',
                type: 'object',
                properties: {
                  name: {
                    type: 'string',
                  },
                  version: {
                    type: 'integer',
                    format: 'uint32',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['name', 'version'],
              },
              Capture: {
                type: 'object',
                properties: {
                  input: true,
                  output: {
                    $ref: '#/$defs/CaptureOutput',
                  },
                },
                additionalProperties: false,
                required: ['input', 'output'],
              },
              CaptureOutput: {
                description:
                  'Resource captures enter checked service slots; continuations remain in the\noriginal presentation owner and only decide admission of query feedback.',
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      resource: {
                        $ref: '#/$defs/ResourceType',
                      },
                      kind: {
                        type: 'string',
                        const: 'resource',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'resource'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'continuation',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                ],
              },
              Availability: {
                type: 'string',
                enum: ['required', 'optional'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'ManagementResultForDeploymentRef',
            description:
              "A deterministic refusal is a recorded business result. Uncertain SQL/worker\nfailures remain in the original operation journal's Unknown outcome.",
            oneOf: [
              {
                type: 'object',
                properties: {
                  value: {
                    $ref: '#/$defs/DeploymentRef',
                  },
                  status: {
                    type: 'string',
                    const: 'committed',
                  },
                },
                additionalProperties: false,
                required: ['status', 'value'],
              },
              {
                type: 'object',
                properties: {
                  currentRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  status: {
                    type: 'string',
                    const: 'conflict',
                  },
                },
                additionalProperties: false,
                required: ['status', 'currentRevision'],
              },
              {
                type: 'object',
                properties: {
                  reason: {
                    $ref: '#/$defs/ManagementRejection',
                  },
                  diagnostic: {
                    type: ['string', 'null'],
                  },
                  status: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                additionalProperties: false,
                required: ['status', 'reason'],
              },
            ],
            $defs: {
              DeploymentRef: {
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'revision'],
              },
              ManagementRejection: {
                type: 'string',
                enum: [
                  'invalid_bundle',
                  'download_failed',
                  'invalid_document',
                  'invalid_source',
                  'package_unavailable',
                  'execution_environment',
                  'instance_unavailable',
                  'parent_disabled',
                ],
              },
            },
          },
          resources: {},
        },
        setEnabled: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'InstanceSetEnabled',
            type: 'object',
            properties: {
              expectedRevision: {
                type: 'integer',
                format: 'uint64',
                minimum: 1,
                maximum: 9007199254740990,
              },
              instance: {
                $ref: '#/$defs/InstanceId',
              },
              enabled: {
                type: 'boolean',
              },
            },
            additionalProperties: false,
            required: ['expectedRevision', 'instance', 'enabled'],
            $defs: {
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'ManagementResultForDeploymentRef',
            description:
              "A deterministic refusal is a recorded business result. Uncertain SQL/worker\nfailures remain in the original operation journal's Unknown outcome.",
            oneOf: [
              {
                type: 'object',
                properties: {
                  value: {
                    $ref: '#/$defs/DeploymentRef',
                  },
                  status: {
                    type: 'string',
                    const: 'committed',
                  },
                },
                additionalProperties: false,
                required: ['status', 'value'],
              },
              {
                type: 'object',
                properties: {
                  currentRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  status: {
                    type: 'string',
                    const: 'conflict',
                  },
                },
                additionalProperties: false,
                required: ['status', 'currentRevision'],
              },
              {
                type: 'object',
                properties: {
                  reason: {
                    $ref: '#/$defs/ManagementRejection',
                  },
                  diagnostic: {
                    type: ['string', 'null'],
                  },
                  status: {
                    type: 'string',
                    const: 'rejected',
                  },
                },
                additionalProperties: false,
                required: ['status', 'reason'],
              },
            ],
            $defs: {
              DeploymentRef: {
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'revision'],
              },
              ManagementRejection: {
                type: 'string',
                enum: [
                  'invalid_bundle',
                  'download_failed',
                  'invalid_document',
                  'invalid_source',
                  'package_unavailable',
                  'execution_environment',
                  'instance_unavailable',
                  'parent_disabled',
                ],
              },
            },
          },
          resources: {},
        },
      },
    },
  },
  receiptReader: {
    name: 'maka.operations.ReceiptReader',
    version: 1,
    transport: 'remote',
    interface: {
      kind: 'service',
      methods: {
        read: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'RecoveryRef',
            type: 'object',
            properties: {
              source: {
                $ref: '#/$defs/DeploymentRef',
              },
              namespace: {
                $ref: '#/$defs/InstanceId',
              },
              export: {
                type: 'string',
              },
              method: {
                type: 'string',
              },
              operation: {
                type: 'string',
                format: 'uuid',
              },
              fingerprint: {
                type: 'string',
              },
              contract: {
                $ref: '#/$defs/RecoveryContract',
              },
              recovery: {
                $ref: '#/$defs/RecoveryProtocol',
              },
            },
            additionalProperties: false,
            required: [
              'source',
              'namespace',
              'export',
              'method',
              'operation',
              'fingerprint',
              'contract',
              'recovery',
            ],
            $defs: {
              DeploymentRef: {
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'revision'],
              },
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
              RecoveryContract: {
                description:
                  'Contract identity for a journal lookup. The original request retains the\ncomplete contract; a receipt carries only its digest.',
                type: 'object',
                properties: {
                  name: {
                    type: 'string',
                  },
                  version: {
                    type: 'integer',
                    format: 'uint32',
                    minimum: 0,
                  },
                  transport: {
                    $ref: '#/$defs/Transport',
                  },
                  digest: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['name', 'version', 'transport', 'digest'],
              },
              Transport: {
                type: 'string',
                enum: ['local', 'remote'],
              },
              RecoveryProtocol: {
                type: 'string',
                enum: ['journal_v1'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'OperationReply',
            type: 'object',
            properties: {
              reference: {
                $ref: '#/$defs/RecoveryRef',
              },
              receipt: {
                $ref: '#/$defs/Receipt',
              },
            },
            additionalProperties: false,
            required: ['reference', 'receipt'],
            $defs: {
              RecoveryRef: {
                type: 'object',
                properties: {
                  source: {
                    $ref: '#/$defs/DeploymentRef',
                  },
                  namespace: {
                    $ref: '#/$defs/InstanceId',
                  },
                  export: {
                    type: 'string',
                  },
                  method: {
                    type: 'string',
                  },
                  operation: {
                    type: 'string',
                    format: 'uuid',
                  },
                  fingerprint: {
                    type: 'string',
                  },
                  contract: {
                    $ref: '#/$defs/RecoveryContract',
                  },
                  recovery: {
                    $ref: '#/$defs/RecoveryProtocol',
                  },
                },
                additionalProperties: false,
                required: [
                  'source',
                  'namespace',
                  'export',
                  'method',
                  'operation',
                  'fingerprint',
                  'contract',
                  'recovery',
                ],
              },
              DeploymentRef: {
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'revision'],
              },
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
              RecoveryContract: {
                description:
                  'Contract identity for a journal lookup. The original request retains the\ncomplete contract; a receipt carries only its digest.',
                type: 'object',
                properties: {
                  name: {
                    type: 'string',
                  },
                  version: {
                    type: 'integer',
                    format: 'uint32',
                    minimum: 0,
                  },
                  transport: {
                    $ref: '#/$defs/Transport',
                  },
                  digest: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['name', 'version', 'transport', 'digest'],
              },
              Transport: {
                type: 'string',
                enum: ['local', 'remote'],
              },
              RecoveryProtocol: {
                type: 'string',
                enum: ['journal_v1'],
              },
              Receipt: {
                description:
                  "A caller's receipt observation, never an execution grant. Unavailable makes\nno claim about the journal's contents or physical cleanup.",
                oneOf: [
                  {
                    description:
                      'An authorized lookup found no row at the exact original reference.',
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'not_recorded',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      outcome: {
                        $ref: '#/$defs/OperationOutcome',
                      },
                      cleanup: {
                        $ref: '#/$defs/OperationCleanup',
                      },
                      kind: {
                        type: 'string',
                        const: 'recorded',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'outcome', 'cleanup'],
                  },
                  {
                    type: 'object',
                    properties: {
                      diagnostic: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'unavailable',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'diagnostic'],
                  },
                ],
              },
              OperationOutcome: {
                description:
                  'Unresolved means no durable result is known, including after process loss.',
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'unresolved',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      value: true,
                      kind: {
                        type: 'string',
                        const: 'returned',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'value'],
                  },
                  {
                    type: 'object',
                    properties: {
                      diagnostic: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'unknown',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'diagnostic'],
                  },
                ],
              },
              OperationCleanup: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'unconfirmed',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'confirmed',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      diagnostic: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'failed',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'diagnostic'],
                  },
                ],
              },
            },
          },
          resources: {},
        },
      },
    },
  },
  terminalSurface: {
    name: 'maka.ui.surface.tui',
    version: 1,
    transport: 'local',
    interface: {
      kind: 'resource',
      resource: 'surface.tui',
      schema: {
        type: 'object',
        additionalProperties: false,
      },
    },
  },
  uiAuthoring: {
    name: 'maka.application.Authoring',
    version: 1,
    transport: 'remote',
    interface: {
      kind: 'service',
      methods: {
        claim: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'Empty',
            type: 'object',
            additionalProperties: false,
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'UiAuthoringClaim',
            type: 'object',
            properties: {
              request: {
                anyOf: [
                  {
                    $ref: '#/$defs/UiAuthoringRequest',
                  },
                  {
                    type: 'null',
                  },
                ],
              },
            },
            additionalProperties: false,
            $defs: {
              UiAuthoringRequest: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  command: {
                    $ref: '#/$defs/UiAuthoringCommand',
                  },
                },
                additionalProperties: false,
                required: ['id', 'command'],
              },
              UiAuthoringCommand: {
                type: 'object',
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      method: {
                        type: 'string',
                        const: 'instances',
                      },
                      input: {
                        $ref: '#/$defs/DeploymentInstances',
                      },
                    },
                    required: ['method', 'input'],
                  },
                  {
                    type: 'object',
                    properties: {
                      method: {
                        type: 'string',
                        const: 'readDocument',
                      },
                      input: {
                        $ref: '#/$defs/DeploymentDocumentRead',
                      },
                    },
                    required: ['method', 'input'],
                  },
                  {
                    type: 'object',
                    properties: {
                      method: {
                        type: 'string',
                        const: 'readPackage',
                      },
                      input: {
                        $ref: '#/$defs/PackageSourceRead',
                      },
                    },
                    required: ['method', 'input'],
                  },
                  {
                    type: 'object',
                    properties: {
                      method: {
                        type: 'string',
                        const: 'installSource',
                      },
                      input: {
                        $ref: '#/$defs/PackageSourceInstall',
                      },
                    },
                    required: ['method', 'input'],
                  },
                  {
                    type: 'object',
                    properties: {
                      method: {
                        type: 'string',
                        const: 'installUrl',
                      },
                      input: {
                        $ref: '#/$defs/PackageUrlInstall',
                      },
                    },
                    required: ['method', 'input'],
                  },
                  {
                    type: 'object',
                    properties: {
                      method: {
                        type: 'string',
                        const: 'replaceSource',
                      },
                      input: {
                        $ref: '#/$defs/DeploymentSourceReplace',
                      },
                    },
                    required: ['method', 'input'],
                  },
                  {
                    type: 'object',
                    properties: {
                      method: {
                        type: 'string',
                        const: 'editComposition',
                      },
                      input: {
                        $ref: '#/$defs/CompositionEdit',
                      },
                    },
                    required: ['method', 'input'],
                  },
                  {
                    type: 'object',
                    properties: {
                      method: {
                        type: 'string',
                        const: 'configure',
                      },
                      input: {
                        $ref: '#/$defs/InstanceConfigure',
                      },
                    },
                    required: ['method', 'input'],
                  },
                  {
                    type: 'object',
                    properties: {
                      method: {
                        type: 'string',
                        const: 'bindingCandidates',
                      },
                      input: {
                        $ref: '#/$defs/BindingCandidatesRead',
                      },
                    },
                    required: ['method', 'input'],
                  },
                  {
                    type: 'object',
                    properties: {
                      method: {
                        type: 'string',
                        const: 'packageSettings',
                      },
                      input: {
                        $ref: '#/$defs/PackageSettingsRead',
                      },
                    },
                    required: ['method', 'input'],
                  },
                ],
              },
              DeploymentInstances: {
                description:
                  'A fixed committed source for continuation; no runtime or permission claim.',
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'start',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind'],
                  },
                  {
                    type: 'object',
                    properties: {
                      source: {
                        $ref: '#/$defs/DeploymentRef',
                      },
                      after: {
                        anyOf: [
                          {
                            $ref: '#/$defs/InstanceId',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'continue',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'source'],
                  },
                ],
              },
              DeploymentRef: {
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'revision'],
              },
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
              DeploymentDocumentRead: {
                type: 'object',
                properties: {
                  source: {
                    $ref: '#/$defs/DeploymentRef',
                  },
                  offset: {
                    type: 'integer',
                    format: 'uint',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['source', 'offset'],
              },
              PackageSourceRead: {
                type: 'object',
                properties: {
                  source: {
                    $ref: '#/$defs/DeploymentRef',
                  },
                  package: {
                    $ref: '#/$defs/PackageRef',
                  },
                  path: {
                    type: ['string', 'null'],
                  },
                  offset: {
                    type: 'integer',
                    format: 'uint',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['source', 'package', 'offset'],
              },
              PackageRef: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  revision: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['id', 'revision'],
              },
              PackageSourceInstall: {
                type: 'object',
                properties: {
                  expectedRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  files: {
                    description:
                      'UTF-8 package files, including maka.extension.json. Bytes determine identity.',
                    type: 'object',
                    additionalProperties: {
                      type: 'string',
                    },
                  },
                },
                additionalProperties: false,
                required: ['expectedRevision', 'files'],
              },
              PackageUrlInstall: {
                type: 'object',
                properties: {
                  expectedRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  url: {
                    type: 'string',
                  },
                  sha256: {
                    description:
                      'Optional SHA-256 of the downloaded bundle bytes, from a trusted publisher.',
                    type: ['string', 'null'],
                    default: null,
                  },
                },
                additionalProperties: false,
                required: ['expectedRevision', 'url'],
              },
              DeploymentSourceReplace: {
                type: 'object',
                properties: {
                  expectedRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  document: {
                    $ref: '#/$defs/DeploymentDocument',
                  },
                },
                additionalProperties: false,
                required: ['expectedRevision', 'document'],
              },
              DeploymentDocument: {
                description:
                  'Source document edited by one native buffer, never a second desired plan.',
                type: 'object',
                properties: {
                  input: {
                    $ref: '#/$defs/CompositionInput',
                  },
                  remoteExports: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/RemoteObservation',
                    },
                  },
                  packages: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/PackageRef',
                    },
                  },
                },
                additionalProperties: false,
                required: ['input', 'remoteExports', 'packages'],
              },
              CompositionInput: {
                description:
                  'Durable deployment input. Plans are derived and never persisted as overrides.',
                type: 'object',
                properties: {
                  environment: {
                    $ref: '#/$defs/Environment',
                  },
                  instances: {
                    type: 'object',
                    additionalProperties: {
                      $ref: '#/$defs/CompositionNode',
                    },
                  },
                  launch: {
                    anyOf: [
                      {
                        $ref: '#/$defs/Target',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  recovery: {
                    description:
                      'Explicit ordinary fallback. Selection grants no extra capabilities.',
                    anyOf: [
                      {
                        $ref: '#/$defs/Target',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
                required: ['environment', 'instances'],
              },
              Environment: {
                type: 'object',
                properties: {
                  location: {
                    $ref: '#/$defs/ExecutionLocation',
                  },
                  presentation: {
                    anyOf: [
                      {
                        $ref: '#/$defs/PresentationTarget',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
                required: ['location'],
              },
              ExecutionLocation: {
                type: 'string',
                enum: ['host', 'ui'],
              },
              PresentationTarget: {
                type: 'string',
                enum: ['tui'],
              },
              CompositionNode: {
                type: 'object',
                properties: {
                  key: {
                    type: 'string',
                    format: 'uuid',
                  },
                  package: {
                    $ref: '#/$defs/PackageSelection',
                  },
                  usePackage: {
                    $ref: '#/$defs/PackageUse',
                  },
                  configuration: {
                    $ref: '#/$defs/Configuration',
                    default: {
                      values: {},
                      parameters: {},
                    },
                  },
                  parameters: {
                    $ref: '#/$defs/Configuration',
                    default: {
                      values: {},
                      parameters: {},
                    },
                  },
                  bindings: {
                    type: 'object',
                    additionalProperties: {
                      type: 'array',
                      items: {
                        $ref: '#/$defs/Target',
                      },
                    },
                    default: {},
                  },
                  disabled: {
                    type: 'boolean',
                    default: false,
                  },
                  overrides: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/Override',
                    },
                    default: [],
                  },
                },
                additionalProperties: false,
                required: ['key', 'package', 'usePackage'],
              },
              PackageSelection: {
                description:
                  'Templates can select an entry in their own immutable package without a\nself-referential content hash. Deployment roots must select a pinned revision.',
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      package: {
                        $ref: '#/$defs/PackageRef',
                      },
                      source: {
                        type: 'string',
                        const: 'pinned',
                      },
                    },
                    additionalProperties: false,
                    required: ['source', 'package'],
                  },
                  {
                    type: 'object',
                    properties: {
                      source: {
                        type: 'string',
                        const: 'current',
                      },
                    },
                    required: ['source'],
                    additionalProperties: false,
                  },
                ],
              },
              PackageUse: {
                type: 'string',
                enum: ['entry', 'composition'],
              },
              Configuration: {
                type: 'object',
                properties: {
                  values: {
                    type: 'object',
                    additionalProperties: true,
                    default: {},
                  },
                  parameters: {
                    description:
                      'Configuration field -> parameter name of the containing template.',
                    type: 'object',
                    additionalProperties: {
                      type: 'string',
                    },
                    default: {},
                  },
                },
                additionalProperties: false,
              },
              Target: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      path: {
                        type: 'array',
                        items: {
                          type: 'string',
                        },
                      },
                      export: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'instance',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'path', 'export'],
                  },
                  {
                    type: 'object',
                    properties: {
                      name: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'import',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'name'],
                  },
                  {
                    type: 'object',
                    properties: {
                      deployment: {
                        type: 'string',
                      },
                      instance: {
                        $ref: '#/$defs/InstanceId',
                      },
                      export: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'remote',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'deployment', 'instance', 'export'],
                  },
                ],
              },
              Override: {
                description:
                  'An override belongs to its containing structural instance. Missing paths fail;\nremoval/upgrade never guesses how to discard independent user intent.',
                type: 'object',
                properties: {
                  path: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  package: {
                    anyOf: [
                      {
                        $ref: '#/$defs/PackageRef',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  usePackage: {
                    anyOf: [
                      {
                        $ref: '#/$defs/PackageUse',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  parameters: {
                    type: 'object',
                    additionalProperties: true,
                    default: {},
                  },
                  configuration: {
                    type: 'object',
                    additionalProperties: true,
                    default: {},
                  },
                  bindings: {
                    type: 'object',
                    additionalProperties: {
                      type: 'array',
                      items: {
                        $ref: '#/$defs/Target',
                      },
                    },
                    default: {},
                  },
                  disabled: {
                    type: ['boolean', 'null'],
                  },
                },
                additionalProperties: false,
                required: ['path'],
              },
              RemoteObservation: {
                description:
                  'A static compatibility observation, never a remote registration or grant.',
                type: 'object',
                properties: {
                  capability: {
                    $ref: '#/$defs/RemoteCapability',
                  },
                  declaration: {
                    $ref: '#/$defs/Export',
                  },
                },
                additionalProperties: false,
                required: ['capability', 'declaration'],
              },
              RemoteCapability: {
                type: 'object',
                properties: {
                  deployment: {
                    type: 'string',
                  },
                  instance: {
                    $ref: '#/$defs/InstanceId',
                  },
                  export: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['deployment', 'instance', 'export'],
              },
              Export: {
                type: 'object',
                properties: {
                  contract: {
                    $ref: '#/$defs/Contract',
                  },
                  availability: {
                    $ref: '#/$defs/Availability',
                  },
                },
                additionalProperties: false,
                required: ['contract', 'availability'],
              },
              Contract: {
                description:
                  'Public contract definitions are package data, not live registration records.',
                type: 'object',
                properties: {
                  name: {
                    type: 'string',
                  },
                  version: {
                    type: 'integer',
                    format: 'uint32',
                    minimum: 0,
                  },
                  transport: {
                    $ref: '#/$defs/Transport',
                  },
                  interface: {
                    $ref: '#/$defs/Interface',
                  },
                },
                additionalProperties: false,
                required: ['name', 'version', 'transport', 'interface'],
              },
              Transport: {
                type: 'string',
                enum: ['local', 'remote'],
              },
              Interface: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      methods: {
                        type: 'object',
                        additionalProperties: {
                          $ref: '#/$defs/Method',
                        },
                      },
                      kind: {
                        type: 'string',
                        const: 'service',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'methods'],
                  },
                  {
                    type: 'object',
                    properties: {
                      props: true,
                      events: {
                        type: 'object',
                        additionalProperties: true,
                      },
                      captures: {
                        type: 'object',
                        additionalProperties: {
                          $ref: '#/$defs/Capture',
                        },
                      },
                      kind: {
                        type: 'string',
                        const: 'component',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'props', 'events', 'captures'],
                  },
                  {
                    type: 'object',
                    properties: {
                      schema: true,
                      kind: {
                        type: 'string',
                        const: 'value',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'schema'],
                  },
                  {
                    type: 'object',
                    properties: {
                      resource: {
                        type: 'string',
                      },
                      schema: true,
                      kind: {
                        type: 'string',
                        const: 'resource',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'resource', 'schema'],
                  },
                ],
              },
              Method: {
                type: 'object',
                properties: {
                  mode: {
                    $ref: '#/$defs/MethodMode',
                  },
                  input: true,
                  output: true,
                  progress: {
                    description:
                      'Bounded transient observations from this mutation, separate from its\noriginal final receipt. Only mutation methods may declare progress.',
                  },
                  resources: {
                    type: 'object',
                    additionalProperties: {
                      $ref: '#/$defs/ResourceSlot',
                    },
                  },
                },
                additionalProperties: false,
                required: ['mode', 'input', 'output', 'resources'],
              },
              MethodMode: {
                type: 'string',
                enum: ['query', 'mutation', 'subscription'],
              },
              ResourceSlot: {
                description:
                  'One declared input slot: its nominal type and whether the caller may omit it.',
                type: 'object',
                properties: {
                  type: {
                    $ref: '#/$defs/ResourceType',
                  },
                  optional: {
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: ['type', 'optional'],
              },
              ResourceType: {
                description:
                  'Nominal read-only resource shape, not a resource id or authorization token.',
                type: 'object',
                properties: {
                  name: {
                    type: 'string',
                  },
                  version: {
                    type: 'integer',
                    format: 'uint32',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['name', 'version'],
              },
              Capture: {
                type: 'object',
                properties: {
                  input: true,
                  output: {
                    $ref: '#/$defs/CaptureOutput',
                  },
                },
                additionalProperties: false,
                required: ['input', 'output'],
              },
              CaptureOutput: {
                description:
                  'Resource captures enter checked service slots; continuations remain in the\noriginal presentation owner and only decide admission of query feedback.',
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      resource: {
                        $ref: '#/$defs/ResourceType',
                      },
                      kind: {
                        type: 'string',
                        const: 'resource',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'resource'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'continuation',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                ],
              },
              Availability: {
                type: 'string',
                enum: ['required', 'optional'],
              },
              CompositionEdit: {
                type: 'object',
                properties: {
                  expectedRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  edits: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/CompositionChange',
                    },
                  },
                },
                additionalProperties: false,
                required: ['expectedRevision', 'edits'],
              },
              CompositionChange: {
                description:
                  'One atomic patch to the original source, not a saved plan or draft registry.',
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      name: {
                        type: 'string',
                      },
                      package: {
                        $ref: '#/$defs/PackageRef',
                      },
                      settings: {
                        type: 'array',
                        items: {
                          $ref: '#/$defs/SettingChange',
                        },
                      },
                      bindings: {
                        type: 'object',
                        additionalProperties: {
                          type: 'array',
                          items: {
                            $ref: '#/$defs/Target',
                          },
                        },
                      },
                      kind: {
                        type: 'string',
                        const: 'insert',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'name', 'package', 'settings', 'bindings'],
                  },
                  {
                    type: 'object',
                    properties: {
                      name: {
                        type: 'string',
                      },
                      configuration: {
                        type: 'object',
                        additionalProperties: true,
                      },
                      bindings: {
                        type: 'object',
                        additionalProperties: {
                          type: 'array',
                          items: {
                            $ref: '#/$defs/Target',
                          },
                        },
                      },
                      kind: {
                        type: 'string',
                        const: 'update',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'name', 'configuration', 'bindings'],
                  },
                  {
                    type: 'object',
                    properties: {
                      name: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'remove',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'name'],
                  },
                ],
              },
              SettingChange: {
                type: 'object',
                properties: {
                  path: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                    minItems: 1,
                  },
                  value: {
                    description:
                      'None removes the field; all other fields retain their original source.',
                    anyOf: [
                      {
                        $ref: '#/$defs/SettingValue',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
                required: ['path'],
              },
              SettingValue: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      text: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'text',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'text'],
                  },
                  {
                    type: 'object',
                    properties: {
                      text: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'number',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'text'],
                  },
                  {
                    type: 'object',
                    properties: {
                      value: {
                        type: 'boolean',
                      },
                      kind: {
                        type: 'string',
                        const: 'boolean',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'value'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'null',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                ],
              },
              InstanceConfigure: {
                type: 'object',
                properties: {
                  expectedRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740990,
                  },
                  instance: {
                    $ref: '#/$defs/InstanceId',
                  },
                  changes: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/SettingChange',
                    },
                    minItems: 1,
                  },
                },
                additionalProperties: false,
                required: ['expectedRevision', 'instance', 'changes'],
              },
              BindingCandidatesRead: {
                type: 'object',
                properties: {
                  source: {
                    anyOf: [
                      {
                        $ref: '#/$defs/DeploymentRef',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  consumer: {
                    $ref: '#/$defs/BindingConsumer',
                  },
                  import: {
                    type: 'string',
                  },
                  includePackages: {
                    type: 'boolean',
                  },
                  after: {
                    type: ['string', 'null'],
                  },
                },
                additionalProperties: false,
                required: ['consumer', 'import', 'includePackages'],
              },
              BindingConsumer: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      name: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'root',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'name'],
                  },
                  {
                    type: 'object',
                    properties: {
                      package: {
                        $ref: '#/$defs/PackageRef',
                      },
                      kind: {
                        type: 'string',
                        const: 'package',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'package'],
                  },
                ],
              },
              PackageSettingsRead: {
                type: 'object',
                properties: {
                  source: {
                    $ref: '#/$defs/DeploymentRef',
                  },
                  package: {
                    $ref: '#/$defs/PackageRef',
                  },
                  path: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  after: {
                    type: ['string', 'null'],
                  },
                  changes: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/SettingChange',
                    },
                  },
                },
                additionalProperties: false,
                required: ['source', 'package', 'path', 'changes'],
              },
            },
          },
          resources: {},
        },
        complete: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'UiAuthoringCompletion',
            type: 'object',
            properties: {
              id: {
                type: 'string',
              },
              outcome: true,
            },
            additionalProperties: false,
            required: ['id', 'outcome'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'boolean',
            type: 'boolean',
          },
          resources: {},
        },
        result: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'UiAuthoringRequestId',
            type: 'object',
            properties: {
              id: {
                type: 'string',
              },
            },
            additionalProperties: false,
            required: ['id'],
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'UiAuthoringState',
            oneOf: [
              {
                type: 'object',
                properties: {
                  status: {
                    type: 'string',
                    const: 'queued',
                  },
                },
                required: ['status'],
              },
              {
                description:
                  'The foreground has claimed this request. A lost foreground leaves an\nunconfirmed result; it must not dispatch this request again.',
                type: 'object',
                properties: {
                  status: {
                    type: 'string',
                    const: 'claimed',
                  },
                },
                required: ['status'],
              },
              {
                type: 'object',
                properties: {
                  outcome: true,
                  status: {
                    type: 'string',
                    const: 'completed',
                  },
                },
                required: ['status', 'outcome'],
              },
            ],
          },
          resources: {},
        },
        submit: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'UiAuthoringCommand',
            type: 'object',
            oneOf: [
              {
                type: 'object',
                properties: {
                  method: {
                    type: 'string',
                    const: 'instances',
                  },
                  input: {
                    $ref: '#/$defs/DeploymentInstances',
                  },
                },
                required: ['method', 'input'],
              },
              {
                type: 'object',
                properties: {
                  method: {
                    type: 'string',
                    const: 'readDocument',
                  },
                  input: {
                    $ref: '#/$defs/DeploymentDocumentRead',
                  },
                },
                required: ['method', 'input'],
              },
              {
                type: 'object',
                properties: {
                  method: {
                    type: 'string',
                    const: 'readPackage',
                  },
                  input: {
                    $ref: '#/$defs/PackageSourceRead',
                  },
                },
                required: ['method', 'input'],
              },
              {
                type: 'object',
                properties: {
                  method: {
                    type: 'string',
                    const: 'installSource',
                  },
                  input: {
                    $ref: '#/$defs/PackageSourceInstall',
                  },
                },
                required: ['method', 'input'],
              },
              {
                type: 'object',
                properties: {
                  method: {
                    type: 'string',
                    const: 'installUrl',
                  },
                  input: {
                    $ref: '#/$defs/PackageUrlInstall',
                  },
                },
                required: ['method', 'input'],
              },
              {
                type: 'object',
                properties: {
                  method: {
                    type: 'string',
                    const: 'replaceSource',
                  },
                  input: {
                    $ref: '#/$defs/DeploymentSourceReplace',
                  },
                },
                required: ['method', 'input'],
              },
              {
                type: 'object',
                properties: {
                  method: {
                    type: 'string',
                    const: 'editComposition',
                  },
                  input: {
                    $ref: '#/$defs/CompositionEdit',
                  },
                },
                required: ['method', 'input'],
              },
              {
                type: 'object',
                properties: {
                  method: {
                    type: 'string',
                    const: 'configure',
                  },
                  input: {
                    $ref: '#/$defs/InstanceConfigure',
                  },
                },
                required: ['method', 'input'],
              },
              {
                type: 'object',
                properties: {
                  method: {
                    type: 'string',
                    const: 'bindingCandidates',
                  },
                  input: {
                    $ref: '#/$defs/BindingCandidatesRead',
                  },
                },
                required: ['method', 'input'],
              },
              {
                type: 'object',
                properties: {
                  method: {
                    type: 'string',
                    const: 'packageSettings',
                  },
                  input: {
                    $ref: '#/$defs/PackageSettingsRead',
                  },
                },
                required: ['method', 'input'],
              },
            ],
            $defs: {
              DeploymentInstances: {
                description:
                  'A fixed committed source for continuation; no runtime or permission claim.',
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'start',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind'],
                  },
                  {
                    type: 'object',
                    properties: {
                      source: {
                        $ref: '#/$defs/DeploymentRef',
                      },
                      after: {
                        anyOf: [
                          {
                            $ref: '#/$defs/InstanceId',
                          },
                          {
                            type: 'null',
                          },
                        ],
                      },
                      kind: {
                        type: 'string',
                        const: 'continue',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'source'],
                  },
                ],
              },
              DeploymentRef: {
                type: 'object',
                properties: {
                  stateDomain: {
                    type: 'string',
                  },
                  deployment: {
                    type: 'string',
                    format: 'uuid',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['stateDomain', 'deployment', 'revision'],
              },
              InstanceId: {
                description:
                  'Hierarchical, stable source keys. Display aliases never become data identities.',
                type: 'array',
                items: {
                  type: 'string',
                  format: 'uuid',
                },
              },
              DeploymentDocumentRead: {
                type: 'object',
                properties: {
                  source: {
                    $ref: '#/$defs/DeploymentRef',
                  },
                  offset: {
                    type: 'integer',
                    format: 'uint',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['source', 'offset'],
              },
              PackageSourceRead: {
                type: 'object',
                properties: {
                  source: {
                    $ref: '#/$defs/DeploymentRef',
                  },
                  package: {
                    $ref: '#/$defs/PackageRef',
                  },
                  path: {
                    type: ['string', 'null'],
                  },
                  offset: {
                    type: 'integer',
                    format: 'uint',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['source', 'package', 'offset'],
              },
              PackageRef: {
                type: 'object',
                properties: {
                  id: {
                    type: 'string',
                  },
                  revision: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['id', 'revision'],
              },
              PackageSourceInstall: {
                type: 'object',
                properties: {
                  expectedRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  files: {
                    description:
                      'UTF-8 package files, including maka.extension.json. Bytes determine identity.',
                    type: 'object',
                    additionalProperties: {
                      type: 'string',
                    },
                  },
                },
                additionalProperties: false,
                required: ['expectedRevision', 'files'],
              },
              PackageUrlInstall: {
                type: 'object',
                properties: {
                  expectedRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  url: {
                    type: 'string',
                  },
                  sha256: {
                    description:
                      'Optional SHA-256 of the downloaded bundle bytes, from a trusted publisher.',
                    type: ['string', 'null'],
                    default: null,
                  },
                },
                additionalProperties: false,
                required: ['expectedRevision', 'url'],
              },
              DeploymentSourceReplace: {
                type: 'object',
                properties: {
                  expectedRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  document: {
                    $ref: '#/$defs/DeploymentDocument',
                  },
                },
                additionalProperties: false,
                required: ['expectedRevision', 'document'],
              },
              DeploymentDocument: {
                description:
                  'Source document edited by one native buffer, never a second desired plan.',
                type: 'object',
                properties: {
                  input: {
                    $ref: '#/$defs/CompositionInput',
                  },
                  remoteExports: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/RemoteObservation',
                    },
                  },
                  packages: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/PackageRef',
                    },
                  },
                },
                additionalProperties: false,
                required: ['input', 'remoteExports', 'packages'],
              },
              CompositionInput: {
                description:
                  'Durable deployment input. Plans are derived and never persisted as overrides.',
                type: 'object',
                properties: {
                  environment: {
                    $ref: '#/$defs/Environment',
                  },
                  instances: {
                    type: 'object',
                    additionalProperties: {
                      $ref: '#/$defs/CompositionNode',
                    },
                  },
                  launch: {
                    anyOf: [
                      {
                        $ref: '#/$defs/Target',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  recovery: {
                    description:
                      'Explicit ordinary fallback. Selection grants no extra capabilities.',
                    anyOf: [
                      {
                        $ref: '#/$defs/Target',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
                required: ['environment', 'instances'],
              },
              Environment: {
                type: 'object',
                properties: {
                  location: {
                    $ref: '#/$defs/ExecutionLocation',
                  },
                  presentation: {
                    anyOf: [
                      {
                        $ref: '#/$defs/PresentationTarget',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
                required: ['location'],
              },
              ExecutionLocation: {
                type: 'string',
                enum: ['host', 'ui'],
              },
              PresentationTarget: {
                type: 'string',
                enum: ['tui'],
              },
              CompositionNode: {
                type: 'object',
                properties: {
                  key: {
                    type: 'string',
                    format: 'uuid',
                  },
                  package: {
                    $ref: '#/$defs/PackageSelection',
                  },
                  usePackage: {
                    $ref: '#/$defs/PackageUse',
                  },
                  configuration: {
                    $ref: '#/$defs/Configuration',
                    default: {
                      values: {},
                      parameters: {},
                    },
                  },
                  parameters: {
                    $ref: '#/$defs/Configuration',
                    default: {
                      values: {},
                      parameters: {},
                    },
                  },
                  bindings: {
                    type: 'object',
                    additionalProperties: {
                      type: 'array',
                      items: {
                        $ref: '#/$defs/Target',
                      },
                    },
                    default: {},
                  },
                  disabled: {
                    type: 'boolean',
                    default: false,
                  },
                  overrides: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/Override',
                    },
                    default: [],
                  },
                },
                additionalProperties: false,
                required: ['key', 'package', 'usePackage'],
              },
              PackageSelection: {
                description:
                  'Templates can select an entry in their own immutable package without a\nself-referential content hash. Deployment roots must select a pinned revision.',
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      package: {
                        $ref: '#/$defs/PackageRef',
                      },
                      source: {
                        type: 'string',
                        const: 'pinned',
                      },
                    },
                    additionalProperties: false,
                    required: ['source', 'package'],
                  },
                  {
                    type: 'object',
                    properties: {
                      source: {
                        type: 'string',
                        const: 'current',
                      },
                    },
                    required: ['source'],
                    additionalProperties: false,
                  },
                ],
              },
              PackageUse: {
                type: 'string',
                enum: ['entry', 'composition'],
              },
              Configuration: {
                type: 'object',
                properties: {
                  values: {
                    type: 'object',
                    additionalProperties: true,
                    default: {},
                  },
                  parameters: {
                    description:
                      'Configuration field -> parameter name of the containing template.',
                    type: 'object',
                    additionalProperties: {
                      type: 'string',
                    },
                    default: {},
                  },
                },
                additionalProperties: false,
              },
              Target: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      path: {
                        type: 'array',
                        items: {
                          type: 'string',
                        },
                      },
                      export: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'instance',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'path', 'export'],
                  },
                  {
                    type: 'object',
                    properties: {
                      name: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'import',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'name'],
                  },
                  {
                    type: 'object',
                    properties: {
                      deployment: {
                        type: 'string',
                      },
                      instance: {
                        $ref: '#/$defs/InstanceId',
                      },
                      export: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'remote',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'deployment', 'instance', 'export'],
                  },
                ],
              },
              Override: {
                description:
                  'An override belongs to its containing structural instance. Missing paths fail;\nremoval/upgrade never guesses how to discard independent user intent.',
                type: 'object',
                properties: {
                  path: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  package: {
                    anyOf: [
                      {
                        $ref: '#/$defs/PackageRef',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  usePackage: {
                    anyOf: [
                      {
                        $ref: '#/$defs/PackageUse',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  parameters: {
                    type: 'object',
                    additionalProperties: true,
                    default: {},
                  },
                  configuration: {
                    type: 'object',
                    additionalProperties: true,
                    default: {},
                  },
                  bindings: {
                    type: 'object',
                    additionalProperties: {
                      type: 'array',
                      items: {
                        $ref: '#/$defs/Target',
                      },
                    },
                    default: {},
                  },
                  disabled: {
                    type: ['boolean', 'null'],
                  },
                },
                additionalProperties: false,
                required: ['path'],
              },
              RemoteObservation: {
                description:
                  'A static compatibility observation, never a remote registration or grant.',
                type: 'object',
                properties: {
                  capability: {
                    $ref: '#/$defs/RemoteCapability',
                  },
                  declaration: {
                    $ref: '#/$defs/Export',
                  },
                },
                additionalProperties: false,
                required: ['capability', 'declaration'],
              },
              RemoteCapability: {
                type: 'object',
                properties: {
                  deployment: {
                    type: 'string',
                  },
                  instance: {
                    $ref: '#/$defs/InstanceId',
                  },
                  export: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['deployment', 'instance', 'export'],
              },
              Export: {
                type: 'object',
                properties: {
                  contract: {
                    $ref: '#/$defs/Contract',
                  },
                  availability: {
                    $ref: '#/$defs/Availability',
                  },
                },
                additionalProperties: false,
                required: ['contract', 'availability'],
              },
              Contract: {
                description:
                  'Public contract definitions are package data, not live registration records.',
                type: 'object',
                properties: {
                  name: {
                    type: 'string',
                  },
                  version: {
                    type: 'integer',
                    format: 'uint32',
                    minimum: 0,
                  },
                  transport: {
                    $ref: '#/$defs/Transport',
                  },
                  interface: {
                    $ref: '#/$defs/Interface',
                  },
                },
                additionalProperties: false,
                required: ['name', 'version', 'transport', 'interface'],
              },
              Transport: {
                type: 'string',
                enum: ['local', 'remote'],
              },
              Interface: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      methods: {
                        type: 'object',
                        additionalProperties: {
                          $ref: '#/$defs/Method',
                        },
                      },
                      kind: {
                        type: 'string',
                        const: 'service',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'methods'],
                  },
                  {
                    type: 'object',
                    properties: {
                      props: true,
                      events: {
                        type: 'object',
                        additionalProperties: true,
                      },
                      captures: {
                        type: 'object',
                        additionalProperties: {
                          $ref: '#/$defs/Capture',
                        },
                      },
                      kind: {
                        type: 'string',
                        const: 'component',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'props', 'events', 'captures'],
                  },
                  {
                    type: 'object',
                    properties: {
                      schema: true,
                      kind: {
                        type: 'string',
                        const: 'value',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'schema'],
                  },
                  {
                    type: 'object',
                    properties: {
                      resource: {
                        type: 'string',
                      },
                      schema: true,
                      kind: {
                        type: 'string',
                        const: 'resource',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'resource', 'schema'],
                  },
                ],
              },
              Method: {
                type: 'object',
                properties: {
                  mode: {
                    $ref: '#/$defs/MethodMode',
                  },
                  input: true,
                  output: true,
                  progress: {
                    description:
                      'Bounded transient observations from this mutation, separate from its\noriginal final receipt. Only mutation methods may declare progress.',
                  },
                  resources: {
                    type: 'object',
                    additionalProperties: {
                      $ref: '#/$defs/ResourceSlot',
                    },
                  },
                },
                additionalProperties: false,
                required: ['mode', 'input', 'output', 'resources'],
              },
              MethodMode: {
                type: 'string',
                enum: ['query', 'mutation', 'subscription'],
              },
              ResourceSlot: {
                description:
                  'One declared input slot: its nominal type and whether the caller may omit it.',
                type: 'object',
                properties: {
                  type: {
                    $ref: '#/$defs/ResourceType',
                  },
                  optional: {
                    type: 'boolean',
                  },
                },
                additionalProperties: false,
                required: ['type', 'optional'],
              },
              ResourceType: {
                description:
                  'Nominal read-only resource shape, not a resource id or authorization token.',
                type: 'object',
                properties: {
                  name: {
                    type: 'string',
                  },
                  version: {
                    type: 'integer',
                    format: 'uint32',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['name', 'version'],
              },
              Capture: {
                type: 'object',
                properties: {
                  input: true,
                  output: {
                    $ref: '#/$defs/CaptureOutput',
                  },
                },
                additionalProperties: false,
                required: ['input', 'output'],
              },
              CaptureOutput: {
                description:
                  'Resource captures enter checked service slots; continuations remain in the\noriginal presentation owner and only decide admission of query feedback.',
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      resource: {
                        $ref: '#/$defs/ResourceType',
                      },
                      kind: {
                        type: 'string',
                        const: 'resource',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'resource'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'continuation',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                ],
              },
              Availability: {
                type: 'string',
                enum: ['required', 'optional'],
              },
              CompositionEdit: {
                type: 'object',
                properties: {
                  expectedRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  edits: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/CompositionChange',
                    },
                  },
                },
                additionalProperties: false,
                required: ['expectedRevision', 'edits'],
              },
              CompositionChange: {
                description:
                  'One atomic patch to the original source, not a saved plan or draft registry.',
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      name: {
                        type: 'string',
                      },
                      package: {
                        $ref: '#/$defs/PackageRef',
                      },
                      settings: {
                        type: 'array',
                        items: {
                          $ref: '#/$defs/SettingChange',
                        },
                      },
                      bindings: {
                        type: 'object',
                        additionalProperties: {
                          type: 'array',
                          items: {
                            $ref: '#/$defs/Target',
                          },
                        },
                      },
                      kind: {
                        type: 'string',
                        const: 'insert',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'name', 'package', 'settings', 'bindings'],
                  },
                  {
                    type: 'object',
                    properties: {
                      name: {
                        type: 'string',
                      },
                      configuration: {
                        type: 'object',
                        additionalProperties: true,
                      },
                      bindings: {
                        type: 'object',
                        additionalProperties: {
                          type: 'array',
                          items: {
                            $ref: '#/$defs/Target',
                          },
                        },
                      },
                      kind: {
                        type: 'string',
                        const: 'update',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'name', 'configuration', 'bindings'],
                  },
                  {
                    type: 'object',
                    properties: {
                      name: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'remove',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'name'],
                  },
                ],
              },
              SettingChange: {
                type: 'object',
                properties: {
                  path: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                    minItems: 1,
                  },
                  value: {
                    description:
                      'None removes the field; all other fields retain their original source.',
                    anyOf: [
                      {
                        $ref: '#/$defs/SettingValue',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                additionalProperties: false,
                required: ['path'],
              },
              SettingValue: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      text: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'text',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'text'],
                  },
                  {
                    type: 'object',
                    properties: {
                      text: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'number',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'text'],
                  },
                  {
                    type: 'object',
                    properties: {
                      value: {
                        type: 'boolean',
                      },
                      kind: {
                        type: 'string',
                        const: 'boolean',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'value'],
                  },
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'null',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                ],
              },
              InstanceConfigure: {
                type: 'object',
                properties: {
                  expectedRevision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 1,
                    maximum: 9007199254740990,
                  },
                  instance: {
                    $ref: '#/$defs/InstanceId',
                  },
                  changes: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/SettingChange',
                    },
                    minItems: 1,
                  },
                },
                additionalProperties: false,
                required: ['expectedRevision', 'instance', 'changes'],
              },
              BindingCandidatesRead: {
                type: 'object',
                properties: {
                  source: {
                    anyOf: [
                      {
                        $ref: '#/$defs/DeploymentRef',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  consumer: {
                    $ref: '#/$defs/BindingConsumer',
                  },
                  import: {
                    type: 'string',
                  },
                  includePackages: {
                    type: 'boolean',
                  },
                  after: {
                    type: ['string', 'null'],
                  },
                },
                additionalProperties: false,
                required: ['consumer', 'import', 'includePackages'],
              },
              BindingConsumer: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      name: {
                        type: 'string',
                      },
                      kind: {
                        type: 'string',
                        const: 'root',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'name'],
                  },
                  {
                    type: 'object',
                    properties: {
                      package: {
                        $ref: '#/$defs/PackageRef',
                      },
                      kind: {
                        type: 'string',
                        const: 'package',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'package'],
                  },
                ],
              },
              PackageSettingsRead: {
                type: 'object',
                properties: {
                  source: {
                    $ref: '#/$defs/DeploymentRef',
                  },
                  package: {
                    $ref: '#/$defs/PackageRef',
                  },
                  path: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                  after: {
                    type: ['string', 'null'],
                  },
                  changes: {
                    type: 'array',
                    items: {
                      $ref: '#/$defs/SettingChange',
                    },
                  },
                },
                additionalProperties: false,
                required: ['source', 'package', 'path', 'changes'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'UiAuthoringRequestId',
            type: 'object',
            properties: {
              id: {
                type: 'string',
              },
            },
            additionalProperties: false,
            required: ['id'],
          },
          resources: {},
        },
        watch: {
          mode: 'subscription',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'Empty',
            type: 'object',
            additionalProperties: false,
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'AnyValue',
          },
          resources: {},
        },
      },
    },
  },
  workspaceWeb: {
    name: 'maka.workspace.Web',
    version: 1,
    transport: 'remote',
    interface: {
      kind: 'service',
      methods: {
        capture: {
          mode: 'query',
          input: {
            type: 'object',
            additionalProperties: false,
          },
          output: {
            type: 'object',
            additionalProperties: false,
            properties: {
              basis: {
                $ref: '#/$defs/WebBasis',
              },
              available: {
                type: 'boolean',
              },
              source: {
                $ref: '#/$defs/WebSource',
              },
              credentialConfigured: {
                type: 'boolean',
              },
            },
            required: ['basis', 'available', 'source', 'credentialConfigured'],
            title: 'WebCapture',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              WebBasis: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  revision: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  credentialRevision: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                },
              },
              WebSource: {
                type: 'string',
                enum: ['model', 'tavily'],
              },
            },
          },
          resources: {},
        },
        checkKey: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              revision: {
                type: ['integer', 'null'],
                format: 'uint64',
                minimum: 0,
              },
            },
            title: 'WebKey',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  snapshot: {
                    $ref: '#/$defs/WebSnapshot',
                  },
                  kind: {
                    type: 'string',
                    const: 'updated',
                  },
                },
                required: ['kind', 'snapshot'],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'changed',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'invalid_key',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'check_unavailable',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
            ],
            title: 'WebUpdate',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              WebSnapshot: {
                type: 'object',
                properties: {
                  revision: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  settings: {
                    $ref: '#/$defs/WebSettings',
                  },
                  credential: {
                    $ref: '#/$defs/WebCredential',
                  },
                },
                required: ['settings', 'credential'],
              },
              WebSettings: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  enabled: {
                    type: 'boolean',
                  },
                  source: {
                    $ref: '#/$defs/WebSource',
                  },
                },
                required: ['enabled', 'source'],
              },
              WebSource: {
                type: 'string',
                enum: ['model', 'tavily'],
              },
              WebCredential: {
                type: 'object',
                properties: {
                  revision: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  configured: {
                    type: 'boolean',
                  },
                  check: {
                    anyOf: [
                      {
                        $ref: '#/$defs/WebCheck',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                required: ['configured'],
              },
              WebCheck: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  credential_revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  outcome: {
                    $ref: '#/$defs/WebCheckOutcome',
                  },
                },
                required: ['credential_revision', 'outcome'],
              },
              WebCheckOutcome: {
                type: 'string',
                enum: ['valid', 'invalid_credentials', 'rate_limited', 'network_error', 'timeout'],
              },
            },
          },
          resources: {},
        },
        deleteKey: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              revision: {
                type: ['integer', 'null'],
                format: 'uint64',
                minimum: 0,
              },
            },
            title: 'WebKey',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  snapshot: {
                    $ref: '#/$defs/WebSnapshot',
                  },
                  kind: {
                    type: 'string',
                    const: 'updated',
                  },
                },
                required: ['kind', 'snapshot'],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'changed',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'invalid_key',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'check_unavailable',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
            ],
            title: 'WebUpdate',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              WebSnapshot: {
                type: 'object',
                properties: {
                  revision: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  settings: {
                    $ref: '#/$defs/WebSettings',
                  },
                  credential: {
                    $ref: '#/$defs/WebCredential',
                  },
                },
                required: ['settings', 'credential'],
              },
              WebSettings: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  enabled: {
                    type: 'boolean',
                  },
                  source: {
                    $ref: '#/$defs/WebSource',
                  },
                },
                required: ['enabled', 'source'],
              },
              WebSource: {
                type: 'string',
                enum: ['model', 'tavily'],
              },
              WebCredential: {
                type: 'object',
                properties: {
                  revision: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  configured: {
                    type: 'boolean',
                  },
                  check: {
                    anyOf: [
                      {
                        $ref: '#/$defs/WebCheck',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                required: ['configured'],
              },
              WebCheck: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  credential_revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  outcome: {
                    $ref: '#/$defs/WebCheckOutcome',
                  },
                },
                required: ['credential_revision', 'outcome'],
              },
              WebCheckOutcome: {
                type: 'string',
                enum: ['valid', 'invalid_credentials', 'rate_limited', 'network_error', 'timeout'],
              },
            },
          },
          resources: {},
        },
        fetch: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              basis: {
                $ref: '#/$defs/WebBasis',
              },
              input: {
                $ref: '#/$defs/WebFetch',
              },
            },
            required: ['basis', 'input'],
            title: 'WebCall_WebFetch',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              WebBasis: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  revision: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  credentialRevision: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                },
              },
              WebFetch: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  url: {
                    type: 'string',
                    minLength: 1,
                  },
                },
                required: ['url'],
              },
            },
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  value: true,
                  kind: {
                    type: 'string',
                    const: 'completed',
                  },
                },
                required: ['kind', 'value'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  message: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                required: ['kind', 'message'],
              },
            ],
            title: 'WebResult',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          resources: {},
        },
        probe: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              url: {
                type: 'string',
                minLength: 1,
              },
            },
            required: ['url'],
            title: 'WebProbe',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  value: true,
                  kind: {
                    type: 'string',
                    const: 'completed',
                  },
                },
                required: ['kind', 'value'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  message: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                required: ['kind', 'message'],
              },
            ],
            title: 'WebResult',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          resources: {},
        },
        save: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              revision: {
                type: ['integer', 'null'],
                format: 'uint64',
                minimum: 0,
              },
              settings: {
                $ref: '#/$defs/WebSettings',
              },
            },
            required: ['settings'],
            title: 'WebSet',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              WebSettings: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  enabled: {
                    type: 'boolean',
                  },
                  source: {
                    $ref: '#/$defs/WebSource',
                  },
                },
                required: ['enabled', 'source'],
              },
              WebSource: {
                type: 'string',
                enum: ['model', 'tavily'],
              },
            },
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  snapshot: {
                    $ref: '#/$defs/WebSnapshot',
                  },
                  kind: {
                    type: 'string',
                    const: 'updated',
                  },
                },
                required: ['kind', 'snapshot'],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'changed',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'invalid_key',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'check_unavailable',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
            ],
            title: 'WebUpdate',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              WebSnapshot: {
                type: 'object',
                properties: {
                  revision: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  settings: {
                    $ref: '#/$defs/WebSettings',
                  },
                  credential: {
                    $ref: '#/$defs/WebCredential',
                  },
                },
                required: ['settings', 'credential'],
              },
              WebSettings: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  enabled: {
                    type: 'boolean',
                  },
                  source: {
                    $ref: '#/$defs/WebSource',
                  },
                },
                required: ['enabled', 'source'],
              },
              WebSource: {
                type: 'string',
                enum: ['model', 'tavily'],
              },
              WebCredential: {
                type: 'object',
                properties: {
                  revision: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  configured: {
                    type: 'boolean',
                  },
                  check: {
                    anyOf: [
                      {
                        $ref: '#/$defs/WebCheck',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                required: ['configured'],
              },
              WebCheck: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  credential_revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  outcome: {
                    $ref: '#/$defs/WebCheckOutcome',
                  },
                },
                required: ['credential_revision', 'outcome'],
              },
              WebCheckOutcome: {
                type: 'string',
                enum: ['valid', 'invalid_credentials', 'rate_limited', 'network_error', 'timeout'],
              },
            },
          },
          resources: {},
        },
        saveKey: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              revision: {
                type: ['integer', 'null'],
                format: 'uint64',
                minimum: 0,
              },
            },
            title: 'WebKey',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  snapshot: {
                    $ref: '#/$defs/WebSnapshot',
                  },
                  kind: {
                    type: 'string',
                    const: 'updated',
                  },
                },
                required: ['kind', 'snapshot'],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'changed',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'invalid_key',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'check_unavailable',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
            ],
            title: 'WebUpdate',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              WebSnapshot: {
                type: 'object',
                properties: {
                  revision: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  settings: {
                    $ref: '#/$defs/WebSettings',
                  },
                  credential: {
                    $ref: '#/$defs/WebCredential',
                  },
                },
                required: ['settings', 'credential'],
              },
              WebSettings: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  enabled: {
                    type: 'boolean',
                  },
                  source: {
                    $ref: '#/$defs/WebSource',
                  },
                },
                required: ['enabled', 'source'],
              },
              WebSource: {
                type: 'string',
                enum: ['model', 'tavily'],
              },
              WebCredential: {
                type: 'object',
                properties: {
                  revision: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  configured: {
                    type: 'boolean',
                  },
                  check: {
                    anyOf: [
                      {
                        $ref: '#/$defs/WebCheck',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                required: ['configured'],
              },
              WebCheck: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  credential_revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  outcome: {
                    $ref: '#/$defs/WebCheckOutcome',
                  },
                },
                required: ['credential_revision', 'outcome'],
              },
              WebCheckOutcome: {
                type: 'string',
                enum: ['valid', 'invalid_credentials', 'rate_limited', 'network_error', 'timeout'],
              },
            },
          },
          resources: {
            secret: {
              type: {
                name: 'maka.text.utf8',
                version: 1,
              },
              optional: false,
            },
          },
        },
        search: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              basis: {
                $ref: '#/$defs/WebBasis',
              },
              input: {
                $ref: '#/$defs/WebQuery',
              },
            },
            required: ['basis', 'input'],
            title: 'WebCall_WebQuery',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              WebBasis: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  revision: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  credentialRevision: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                },
              },
              WebQuery: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  query: {
                    type: 'string',
                    minLength: 1,
                  },
                  limit: {
                    type: 'integer',
                    format: 'uint',
                    minimum: 1,
                    maximum: 20,
                    default: 5,
                  },
                },
                required: ['query'],
              },
            },
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  value: true,
                  kind: {
                    type: 'string',
                    const: 'completed',
                  },
                },
                required: ['kind', 'value'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  message: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                required: ['kind', 'message'],
              },
            ],
            title: 'WebResult',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          resources: {},
        },
        snapshot: {
          mode: 'query',
          input: {
            type: 'object',
            additionalProperties: false,
          },
          output: {
            type: 'object',
            properties: {
              revision: {
                type: ['integer', 'null'],
                format: 'uint64',
                minimum: 0,
              },
              settings: {
                $ref: '#/$defs/WebSettings',
              },
              credential: {
                $ref: '#/$defs/WebCredential',
              },
            },
            required: ['settings', 'credential'],
            title: 'WebSnapshot',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              WebSettings: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  enabled: {
                    type: 'boolean',
                  },
                  source: {
                    $ref: '#/$defs/WebSource',
                  },
                },
                required: ['enabled', 'source'],
              },
              WebSource: {
                type: 'string',
                enum: ['model', 'tavily'],
              },
              WebCredential: {
                type: 'object',
                properties: {
                  revision: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  configured: {
                    type: 'boolean',
                  },
                  check: {
                    anyOf: [
                      {
                        $ref: '#/$defs/WebCheck',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                },
                required: ['configured'],
              },
              WebCheck: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  credential_revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  outcome: {
                    $ref: '#/$defs/WebCheckOutcome',
                  },
                },
                required: ['credential_revision', 'outcome'],
              },
              WebCheckOutcome: {
                type: 'string',
                enum: ['valid', 'invalid_credentials', 'rate_limited', 'network_error', 'timeout'],
              },
            },
          },
          resources: {},
        },
      },
    },
  },
  workspaceJev: {
    name: 'maka.workspace.Jev',
    version: 1,
    transport: 'remote',
    interface: {
      kind: 'service',
      methods: {
        credential: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              url: {
                type: 'string',
                minLength: 1,
              },
              revision: {
                type: ['integer', 'null'],
                format: 'uint64',
                minimum: 0,
              },
              target: {
                $ref: '#/$defs/JevCredentialTarget',
              },
              change: {
                $ref: '#/$defs/JevCredentialChange',
              },
            },
            required: ['url', 'target', 'change'],
            title: 'JevCredential',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              JevCredentialTarget: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'api_key',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      name: {
                        type: 'string',
                        minLength: 1,
                      },
                      kind: {
                        type: 'string',
                        const: 'header',
                      },
                    },
                    required: ['kind', 'name'],
                  },
                ],
              },
              JevCredentialChange: {
                type: 'string',
                enum: ['replace', 'remove'],
              },
            },
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  snapshot: {
                    $ref: '#/$defs/JevSnapshot',
                  },
                  kind: {
                    type: 'string',
                    const: 'updated',
                  },
                },
                required: ['kind', 'snapshot'],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'changed',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'invalid',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
            ],
            title: 'JevUpdate',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              JevSnapshot: {
                type: 'object',
                properties: {
                  revision: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  settings: {
                    $ref: '#/$defs/JevSettings',
                  },
                  credentialRevision: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  configured: {
                    type: 'boolean',
                  },
                  apiKeyConfigured: {
                    type: 'boolean',
                  },
                  headerNames: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                },
                required: ['settings', 'configured', 'apiKeyConfigured', 'headerNames'],
              },
              JevSettings: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  enabled: {
                    type: 'boolean',
                  },
                  url: {
                    type: 'string',
                  },
                  model: {
                    type: 'string',
                  },
                  timeoutMs: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                required: ['enabled', 'url', 'model', 'timeoutMs'],
              },
            },
          },
          resources: {
            secret: {
              type: {
                name: 'maka.text.utf8',
                version: 1,
              },
              optional: true,
            },
          },
        },
        evaluate: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              state: true,
              questions: {
                type: 'object',
                additionalProperties: {
                  $ref: '#/$defs/JevQuestion',
                },
              },
            },
            required: ['state', 'questions'],
            title: 'JevEvaluation',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              JevQuestion: {
                oneOf: [
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      instructions: true,
                      criteria: {
                        type: ['object', 'null'],
                        additionalProperties: true,
                      },
                      type: {
                        type: 'string',
                        const: 'noul',
                      },
                    },
                    required: ['type', 'instructions'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      instructions: true,
                      criteria: {
                        type: 'object',
                        additionalProperties: true,
                      },
                      type: {
                        type: 'string',
                        const: 'choice',
                      },
                    },
                    required: ['type', 'instructions', 'criteria'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      instructions: true,
                      criteria: {
                        type: 'array',
                        items: true,
                      },
                      type: {
                        type: 'string',
                        const: 'score',
                      },
                    },
                    required: ['type', 'instructions', 'criteria'],
                  },
                ],
              },
            },
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  value: {
                    $ref: '#/$defs/JevEvaluationResult',
                  },
                  kind: {
                    type: 'string',
                    const: 'completed',
                  },
                },
                required: ['kind', 'value'],
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  message: {
                    type: 'string',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                required: ['kind', 'message'],
              },
            ],
            title: 'JevResult',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              JevEvaluationResult: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  model: {
                    type: 'string',
                  },
                  answers: {
                    type: 'object',
                    additionalProperties: {
                      $ref: '#/$defs/JevAnswer',
                    },
                  },
                  usage: {
                    $ref: '#/$defs/JevUsage',
                  },
                },
                required: ['model', 'answers', 'usage'],
              },
              JevAnswer: {
                oneOf: [
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      noul: {
                        type: 'number',
                        format: 'double',
                      },
                      type: {
                        type: 'string',
                        const: 'noul',
                      },
                    },
                    required: ['type', 'noul'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      choice: {
                        type: 'string',
                      },
                      confidence: {
                        type: 'number',
                        format: 'double',
                      },
                      probabilities: {
                        type: 'object',
                        additionalProperties: {
                          type: 'number',
                          format: 'double',
                        },
                      },
                      type: {
                        type: 'string',
                        const: 'choice',
                      },
                    },
                    required: ['type', 'choice', 'confidence', 'probabilities'],
                  },
                  {
                    type: 'object',
                    additionalProperties: false,
                    properties: {
                      score: {
                        type: 'number',
                        format: 'double',
                      },
                      confidence: {
                        type: 'number',
                        format: 'double',
                      },
                      probabilities: {
                        type: 'object',
                        additionalProperties: {
                          type: 'number',
                          format: 'double',
                        },
                      },
                      legend: {
                        type: 'object',
                        additionalProperties: {
                          type: 'string',
                        },
                      },
                      type: {
                        type: 'string',
                        const: 'score',
                      },
                    },
                    required: ['type', 'score', 'confidence', 'probabilities', 'legend'],
                  },
                ],
              },
              JevUsage: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  input_tokens: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                  output_tokens: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                required: ['input_tokens', 'output_tokens'],
              },
            },
          },
          resources: {},
        },
        save: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              revision: {
                type: ['integer', 'null'],
                format: 'uint64',
                minimum: 0,
              },
              settings: {
                $ref: '#/$defs/JevSettings',
              },
            },
            required: ['settings'],
            title: 'JevSet',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              JevSettings: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  enabled: {
                    type: 'boolean',
                  },
                  url: {
                    type: 'string',
                  },
                  model: {
                    type: 'string',
                  },
                  timeoutMs: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                required: ['enabled', 'url', 'model', 'timeoutMs'],
              },
            },
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  snapshot: {
                    $ref: '#/$defs/JevSnapshot',
                  },
                  kind: {
                    type: 'string',
                    const: 'updated',
                  },
                },
                required: ['kind', 'snapshot'],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'changed',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'invalid',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
            ],
            title: 'JevUpdate',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              JevSnapshot: {
                type: 'object',
                properties: {
                  revision: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  settings: {
                    $ref: '#/$defs/JevSettings',
                  },
                  credentialRevision: {
                    type: ['integer', 'null'],
                    format: 'uint64',
                    minimum: 0,
                  },
                  configured: {
                    type: 'boolean',
                  },
                  apiKeyConfigured: {
                    type: 'boolean',
                  },
                  headerNames: {
                    type: 'array',
                    items: {
                      type: 'string',
                    },
                  },
                },
                required: ['settings', 'configured', 'apiKeyConfigured', 'headerNames'],
              },
              JevSettings: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  enabled: {
                    type: 'boolean',
                  },
                  url: {
                    type: 'string',
                  },
                  model: {
                    type: 'string',
                  },
                  timeoutMs: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                required: ['enabled', 'url', 'model', 'timeoutMs'],
              },
            },
          },
          resources: {},
        },
        snapshot: {
          mode: 'query',
          input: {
            type: 'object',
            additionalProperties: false,
          },
          output: {
            type: 'object',
            properties: {
              revision: {
                type: ['integer', 'null'],
                format: 'uint64',
                minimum: 0,
              },
              settings: {
                $ref: '#/$defs/JevSettings',
              },
              credentialRevision: {
                type: ['integer', 'null'],
                format: 'uint64',
                minimum: 0,
              },
              configured: {
                type: 'boolean',
              },
              apiKeyConfigured: {
                type: 'boolean',
              },
              headerNames: {
                type: 'array',
                items: {
                  type: 'string',
                },
              },
            },
            required: ['settings', 'configured', 'apiKeyConfigured', 'headerNames'],
            title: 'JevSnapshot',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              JevSettings: {
                type: 'object',
                additionalProperties: false,
                properties: {
                  enabled: {
                    type: 'boolean',
                  },
                  url: {
                    type: 'string',
                  },
                  model: {
                    type: 'string',
                  },
                  timeoutMs: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                required: ['enabled', 'url', 'model', 'timeoutMs'],
              },
            },
          },
          resources: {},
        },
      },
    },
  },
  hostLogs: {
    name: 'maka.host.Logs',
    version: 1,
    transport: 'remote',
    interface: {
      kind: 'service',
      methods: {
        read: {
          mode: 'query',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'HostLogRequest',
            type: 'object',
            properties: {
              position: {
                $ref: '#/$defs/HostLogPosition',
              },
            },
            additionalProperties: false,
            required: ['position'],
            $defs: {
              HostLogPosition: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'tail',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      cursor: {
                        $ref: '#/$defs/HostLogCursor',
                      },
                      kind: {
                        type: 'string',
                        const: 'after',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'cursor'],
                  },
                ],
              },
              HostLogCursor: {
                type: 'string',
                maxLength: 512,
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'HostLogPage',
            oneOf: [
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'missing',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  cursor: {
                    $ref: '#/$defs/HostLogCursor',
                  },
                  bytes: {
                    type: 'string',
                  },
                  reset: {
                    anyOf: [
                      {
                        $ref: '#/$defs/HostLogReset',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  truncated: {
                    type: 'boolean',
                  },
                  hasMore: {
                    type: 'boolean',
                  },
                  kind: {
                    type: 'string',
                    const: 'data',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'cursor', 'bytes', 'truncated', 'hasMore'],
              },
            ],
            $defs: {
              HostLogCursor: {
                type: 'string',
                maxLength: 512,
              },
              HostLogReset: {
                type: 'string',
                enum: ['replaced', 'truncated'],
              },
            },
          },
          resources: {},
        },
        watch: {
          mode: 'subscription',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'HostLogRequest',
            type: 'object',
            properties: {
              position: {
                $ref: '#/$defs/HostLogPosition',
              },
            },
            additionalProperties: false,
            required: ['position'],
            $defs: {
              HostLogPosition: {
                oneOf: [
                  {
                    type: 'object',
                    properties: {
                      kind: {
                        type: 'string',
                        const: 'tail',
                      },
                    },
                    required: ['kind'],
                    additionalProperties: false,
                  },
                  {
                    type: 'object',
                    properties: {
                      cursor: {
                        $ref: '#/$defs/HostLogCursor',
                      },
                      kind: {
                        type: 'string',
                        const: 'after',
                      },
                    },
                    additionalProperties: false,
                    required: ['kind', 'cursor'],
                  },
                ],
              },
              HostLogCursor: {
                type: 'string',
                maxLength: 512,
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'HostLogPage',
            oneOf: [
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'missing',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  cursor: {
                    $ref: '#/$defs/HostLogCursor',
                  },
                  bytes: {
                    type: 'string',
                  },
                  reset: {
                    anyOf: [
                      {
                        $ref: '#/$defs/HostLogReset',
                      },
                      {
                        type: 'null',
                      },
                    ],
                  },
                  truncated: {
                    type: 'boolean',
                  },
                  hasMore: {
                    type: 'boolean',
                  },
                  kind: {
                    type: 'string',
                    const: 'data',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'cursor', 'bytes', 'truncated', 'hasMore'],
              },
            ],
            $defs: {
              HostLogCursor: {
                type: 'string',
                maxLength: 512,
              },
              HostLogReset: {
                type: 'string',
                enum: ['replaced', 'truncated'],
              },
            },
          },
          resources: {},
        },
      },
    },
  },
  workspaceComputer: {
    name: 'maka.workspace.Computer',
    version: 1,
    transport: 'remote',
    interface: {
      kind: 'service',
      methods: {
        evaluate: {
          mode: 'mutation',
          input: {
            type: 'object',
            additionalProperties: false,
            properties: {
              code: {
                type: 'string',
              },
              timeout_ms: {
                type: 'integer',
                format: 'uint64',
                minimum: 1,
                description:
                  'Wall-clock limit including asynchronous waits. Interrupted REPLs require reset.',
                default: 30000,
              },
              title: {
                type: ['string', 'null'],
                description: 'Short, user-facing description of this call, in the user’s language.',
              },
            },
            required: ['code'],
            title: 'ComputerEvaluate',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  artifact: {
                    type: 'string',
                  },
                  state: {
                    $ref: '#/$defs/ComputerReplState',
                  },
                  kind: {
                    type: 'string',
                    const: 'completed',
                  },
                },
                required: ['kind', 'artifact', 'state'],
                description:
                  "Immutable output in this original invocation's Session/Turn. The explicit\nAgent output projection consumes it; the identifier is not a read grant.",
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  message: {
                    type: 'string',
                  },
                  state: {
                    $ref: '#/$defs/ComputerReplState',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                required: ['kind', 'message', 'state'],
              },
            ],
            title: 'ComputerResult',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              ComputerReplState: {
                type: 'string',
                enum: ['fresh', 'ready', 'reset_required'],
              },
            },
          },
          resources: {},
        },
        reset: {
          mode: 'mutation',
          input: {
            type: 'object',
            properties: {},
            additionalProperties: false,
          },
          output: {
            oneOf: [
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  artifact: {
                    type: 'string',
                  },
                  state: {
                    $ref: '#/$defs/ComputerReplState',
                  },
                  kind: {
                    type: 'string',
                    const: 'completed',
                  },
                },
                required: ['kind', 'artifact', 'state'],
                description:
                  "Immutable output in this original invocation's Session/Turn. The explicit\nAgent output projection consumes it; the identifier is not a read grant.",
              },
              {
                type: 'object',
                additionalProperties: false,
                properties: {
                  message: {
                    type: 'string',
                  },
                  state: {
                    $ref: '#/$defs/ComputerReplState',
                  },
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                required: ['kind', 'message', 'state'],
              },
            ],
            title: 'ComputerResult',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            $defs: {
              ComputerReplState: {
                type: 'string',
                enum: ['fresh', 'ready', 'reset_required'],
              },
            },
          },
          resources: {},
        },
        state: {
          mode: 'query',
          input: {
            type: 'object',
            properties: {},
            additionalProperties: false,
          },
          output: {
            type: 'string',
            enum: ['fresh', 'ready', 'reset_required'],
            title: 'ComputerReplState',
            $schema: 'https://json-schema.org/draft/2020-12/schema',
          },
          resources: {},
        },
      },
    },
  },
  settingsSetup: {
    name: 'maka.settings.Setup',
    version: 1,
    transport: 'remote',
    interface: {
      kind: 'service',
      methods: {
        discoverModels: {
          mode: 'mutation',
          input: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'ConnectionCredentialTarget',
            type: 'object',
            properties: {
              connectionId: {
                type: 'string',
              },
              revision: {
                type: 'integer',
                format: 'uint64',
                minimum: 0,
              },
              slug: {
                type: 'string',
              },
              provider: {
                $ref: '#/$defs/Identity',
              },
              configuration: {
                type: 'object',
              },
            },
            additionalProperties: false,
            required: ['connectionId', 'revision', 'slug', 'provider', 'configuration'],
            $defs: {
              Identity: {
                description:
                  'Durable recipient, not a registration lease. Re-loading the same package can\nrestore it; another package, Entry or scope cannot inherit its credentials.',
                type: 'object',
                properties: {
                  packageId: {
                    type: 'string',
                  },
                  entryId: {
                    type: 'string',
                  },
                  scope: {
                    type: 'string',
                  },
                  name: {
                    type: 'string',
                  },
                },
                additionalProperties: false,
                required: ['packageId', 'entryId', 'scope', 'name'],
              },
            },
          },
          output: {
            $schema: 'https://json-schema.org/draft/2020-12/schema',
            title: 'SettingsSetupResult',
            oneOf: [
              {
                type: 'object',
                properties: {
                  connection: {
                    $ref: '#/$defs/ConnectionVersionBasis',
                  },
                  kind: {
                    type: 'string',
                    const: 'ready',
                  },
                },
                additionalProperties: false,
                required: ['kind', 'connection'],
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'failed',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
              {
                type: 'object',
                properties: {
                  kind: {
                    type: 'string',
                    const: 'superseded',
                  },
                },
                required: ['kind'],
                additionalProperties: false,
              },
            ],
            $defs: {
              ConnectionVersionBasis: {
                type: 'object',
                properties: {
                  connectionId: {
                    type: 'string',
                  },
                  revision: {
                    type: 'integer',
                    format: 'uint64',
                    minimum: 0,
                  },
                },
                additionalProperties: false,
                required: ['connectionId', 'revision'],
              },
            },
          },
          resources: {},
        },
      },
    },
  },
} satisfies Record<string, Contract>;