@mininglamp-oss/octo-runtime-client 0.0.0-stage → 1.1.11

package/node_modules/@mininglamp-oss/octo-runtime-protocol/dist/generated/protocol-types.d.ts

@@ -0,0 +1,3022 @@
+/**
+ * Generated by scripts/gen-types.mjs from schema/protocol.schema.json.
+ * Do not edit directly; update the schema and run `pnpm gen`.
+ */
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ProtocolMode".
+ */
+export type ProtocolMode = "native" | "canonical";
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "HostFrame".
+ */
+export type HostFrame = NativeHostFrame | CanonicalHostFrame | ControlHostFrame;
+/**
+ * Provider-neutral assistant output channel. analysis is reasoning-class content gated by exposure; commentary is public in-run progress; final is answer content delivered only after the Run reaches a completed terminal state.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "MessageChannel".
+ */
+export type MessageChannel = "analysis" | "commentary" | "final";
+/**
+ * Adapter-authenticated classification of analysis content. public_reasoning, public_summary, and public_plan may enter a public Presentation; missing values are unknown.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "MessageExposure".
+ */
+export type MessageExposure = "public_reasoning" | "public_summary" | "public_plan" | "private_reasoning" | "unknown";
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "HostControl".
+ */
+export type HostControl = {
+    type: "evidence";
+    name: "execution";
+    payload: ExecutionEvidence;
+} | {
+    type: "evidence";
+    name: "session";
+    payload: {
+        [k: string]: unknown;
+    };
+} | {
+    type: "state";
+    state: "running" | "completed" | "failed" | "cancelled" | "lost";
+} | {
+    type: "error";
+    code: RunProtocolErrorCode;
+    message: string;
+    failure?: FailureEnvelope;
+} | {
+    type: "interaction";
+    requestId: string | number;
+    status: "pending" | "resolved" | "expired" | "invalidated";
+    /**
+     * Whether an external response is required. Omission means required; false does not imply resolution or completion.
+     */
+    responseRequired?: boolean;
+    expiresAt?: number;
+} | {
+    type: "gap";
+    requested_after_seq: number;
+    oldest_seq: number;
+    latest_seq: number;
+};
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "RunProtocolErrorCode".
+ */
+export type RunProtocolErrorCode = "PROTOCOL_MODE_INVALID" | "PROTOCOL_MODE_UNSUPPORTED" | "EXECUTION_PROTOCOL_MISMATCH" | "EXECUTION_IDENTITY_CONFLICT" | "NATIVE_METHOD_UNSUPPORTED" | "NATIVE_RESPONSE_INVALID" | "INTERACTION_NOT_ACTIVE" | "INVALID_QUESTION_RESPONSE" | "ASYNC_ANSWER_REJECTED" | "OPERATION_OUTCOME_UNKNOWN" | "HOST_EXECUTION_FAILED" | "HOST_ENDED_WITHOUT_TERMINAL" | "PROVIDER_MESSAGE_TOO_LARGE" | "HOST_FRAME_TOO_LARGE" | "STREAM_QUEUE_ITEM_TOO_LARGE" | "STREAM_QUEUE_BYTES_EXCEEDED" | "STREAM_QUEUE_ITEMS_EXCEEDED" | "STREAM_GAP" | "STREAM_EXPIRED" | "REMOTE_NATIVE_UNSUPPORTED" | "HOST_FRAME_INVALID" | "HOST_CONTROL_INVALID" | "HOST_RECEIPT_INVALID" | "PROTOCOL_SUPPORT_INVALID";
+export type ProtocolMode1 = "native" | "canonical";
+/**
+ * Public, channel-neutral project notification. No runtime context, reasoning, credentials, or tool payloads belong in this envelope.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "NotificationMessage".
+ */
+export type NotificationMessage = NotificationMessage1;
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ApprovalMode".
+ */
+export type ApprovalMode = "ask" | "assisted" | "full_access";
+/**
+ * Open Context item. Built-in types retain their payload contracts; unknown optional types are preserved and ignored by unsupported consumers.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ContextItem".
+ */
+export type ContextItem = {
+    namespace: string;
+    name: string;
+    guidance?: string;
+    data_format?: "text";
+    payload: Record<string, unknown>;
+};
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "PersistentContextEnvelope".
+ */
+export type PersistentContextEnvelope = ContextEnvelope;
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "PublicObjectMaterial".
+ */
+export type PublicObjectMaterial = {
+    resource_ref: string;
+    object_type: "task" | "discussion" | "discussion_comment" | "discussion_reply" | "local_file" | "drive_file";
+    object_id?: string;
+    origin: "mention" | "attachment" | "object_action" | "source_entity";
+    revision?: string;
+    byte_size: number;
+    digest: string;
+    object_scope?: {
+        type: "user" | "teamspace";
+        id: string;
+    };
+    selector?: {
+        mode: "core" | "content" | "history" | "chain" | "metadata";
+        start?: number;
+        end?: number;
+    };
+};
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ContextModelSelectionPayload".
+ */
+export type ContextModelSelectionPayload = {
+    id?: string;
+    use_provider_default?: true;
+} & ContextModelSelectionPayload1;
+export type ContextModelSelectionPayload1 = {
+    [k: string]: unknown;
+};
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ContextReasoningPayload".
+ */
+export type ContextReasoningPayload = {
+    effort?: string;
+    use_provider_default?: true;
+} & ContextReasoningPayload1;
+export type ContextReasoningPayload1 = {
+    [k: string]: unknown;
+};
+/**
+ * fixed uses the supplied path; random creates a workspace on the AgentSession's first run and reuses it for subsequent runs; none delegates workspace ownership to a preset Agent.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ContextWorkspacePayload".
+ */
+export type ContextWorkspacePayload = {
+    mode: "fixed";
+    path: string;
+} | {
+    mode: "random";
+} | {
+    mode: "none";
+};
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ContextRuntimeSelectionPayload".
+ */
+export type ContextRuntimeSelectionPayload = {
+    mode: "candidates" | "explicit";
+    runtime_id?: string;
+    /**
+     * @minItems 1
+     * @maxItems 64
+     */
+    runtime_ids?: [string, ...string[]];
+    strategy?: "preferred_failover";
+    offline_behavior?: "wait" | "fail";
+    failover?: "candidates" | "none";
+} & ContextRuntimeSelectionPayload1;
+export type ContextRuntimeSelectionPayload1 = {
+    mode?: "candidates";
+} | {
+    mode?: "explicit";
+};
+/**
+ * A channel continuity descriptor. The x-octo-matching-trigger-fields keyword requires trigger_fact.message_id == trigger_message_id and matching presence/value of trigger_fact.message_seq and trigger_seq.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ContextContinuityPayload".
+ */
+export type ContextContinuityPayload = ChannelContextDescriptor & {
+    session_generation?: {
+        [k: string]: unknown;
+    };
+    trigger_seq?: {
+        [k: string]: unknown;
+    };
+    trigger_fact?: {
+        message_seq?: {
+            [k: string]: unknown;
+        };
+        occurred_at_ms?: {
+            [k: string]: unknown;
+        };
+    };
+};
+/**
+ * Worker-frozen Context runtime candidates. Explicit selection cannot fail over.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ResolvedRuntimeSelection".
+ */
+export type ResolvedRuntimeSelection = ResolvedRuntimeSelection1;
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ResolvedExecutionPlan".
+ */
+export type ResolvedExecutionPlan = ResolvedExecutionPlan1;
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "AgentSource".
+ */
+export type AgentSource = "preset" | "provisioned";
+/**
+ * Dynamic server-name map. No business-specific names are enumerated. Each value must match one closed transport variant.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "McpServers".
+ */
+export type McpServers = Record<string, McpServer>;
+/**
+ * Provider-neutral interaction. Omitted delivery retains synchronous blocking semantics; async questions allow continued work. Only Adapter-owned automatic approvals may omit external responses; this does not imply completion.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "InteractionRequestedPayload".
+ */
+export type InteractionRequestedPayload = InteractionRequestedPayload1;
+/**
+ * Display-only fields permitted by assertApprovalRequest. Values remain inert provider metadata and do not redefine commands, permissions or grant scope.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ApprovalDisplayDetails".
+ */
+export type ApprovalDisplayDetails = Record<string, unknown>;
+/**
+ * Bounded history result. complete means only that the requested window was returned, not that the local journal is authoritative.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ContextSyncResult".
+ */
+export type ContextSyncResult = ContextSyncResult1;
+/**
+ * Provider-neutral per-invocation MCP server definition.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "McpServer".
+ */
+export type McpServer = McpStdioServer | McpStreamableHttpServer;
+/**
+ * Ordered provider-native user input. Image bytes are materialized only for the invocation, never used as a text fallback.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ModelInputPart".
+ */
+export type ModelInputPart = {
+    id?: string;
+    type: "text";
+    text: string;
+} | {
+    id?: string;
+    type: "image";
+    mimeType: "image/png" | "image/jpeg" | "image/webp";
+    data: string;
+    byteSize: number;
+    sha256: string;
+};
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ActivitySubject".
+ */
+export type ActivitySubject = {
+    type: "run";
+} | {
+    type: "message";
+    id: string;
+} | {
+    type: "tool";
+    id: string;
+} | {
+    type: "interaction";
+    id: string;
+};
+/**
+ * Declarative MCP resource operation. Only deployed scoped operations may execute; schema validation does not authorize access.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ContextReferenceEntry".
+ */
+export type ContextReferenceEntry = {
+    locator?: ContextMcpLocator;
+} & {
+    resource_ref: string;
+    resolver: "mcp";
+    locator: {};
+    /**
+     * Frozen non-secret JSON parameters supplied by the authenticated resolver plan, not model-generated commands.
+     */
+    params?: Record<string, unknown>;
+    authorization_ref?: string;
+    revision?: string;
+};
+/**
+ * @minItems 1
+ * @maxItems 128
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ModelInputParts".
+ */
+export type ModelInputParts = [ModelInputPart, ...ModelInputPart[]];
+/**
+ * Serializable data shapes for the Octo Runtime NDJSON protocol. Runtime behavior remains hand-written in src/index.ts, and this schema is the source of truth for generated TypeScript types. The x-octo-unicode-scalar-strings semantic keyword requires every JSON string value and object member name to contain Unicode scalar values only: unpaired UTF-16 surrogates are rejected, not repaired or normalized. Consumers must enforce this protocol-wide rule even when validating a definition directly.
+ */
+export interface OctoRuntimeProtocolSchema {
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "KernelLookupKey".
+ */
+export interface KernelLookupKey {
+    run_id: string;
+    invocation_id: string;
+    agent_session_id: string;
+    session_generation: number;
+    protocol_mode: ProtocolMode;
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "KernelRunRef".
+ */
+export interface KernelRunRef {
+    kernel_instance_id: string;
+    run_id: string;
+    invocation_id: string;
+    stream_id: string;
+    agent_session_id: string;
+    session_generation: number;
+    protocol_mode: ProtocolMode;
+    protocol: string;
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "KernelRunSnapshot".
+ */
+export interface KernelRunSnapshot {
+    ref: KernelRunRef;
+    oldest_seq: number;
+    latest_seq: number;
+    terminal?: HostFrame;
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "NativeHostFrame".
+ */
+export interface NativeHostFrame {
+    run_id: string;
+    invocation_id: string;
+    stream_id: string;
+    agent_session_id: string;
+    session_generation: number;
+    seq: number;
+    protocol_mode: "native";
+    protocol: string;
+    kind: "native";
+    messageKind: "response" | "notification" | "request" | "message";
+    payload: {
+        [k: string]: unknown;
+    };
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "CanonicalHostFrame".
+ */
+export interface CanonicalHostFrame {
+    run_id: string;
+    invocation_id: string;
+    stream_id: string;
+    agent_session_id: string;
+    session_generation: number;
+    seq: number;
+    protocol_mode: "canonical";
+    protocol: string;
+    kind: "canonical";
+    event: CanonicalEventWire;
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "CanonicalEventWire".
+ */
+export interface CanonicalEventWire {
+    protocolVersion: 2;
+    type: "session.update" | "execution.update" | "usage.update" | "model_step.started" | "model_step.finished" | "message.create" | "message.delta" | "message.update" | "tool_call.create" | "tool_call.delta" | "tool_call.update" | "activity.started" | "activity.updated" | "activity.finished" | "plan.updated" | "tool_call.progress" | "run.notice" | "interaction.requested" | "interaction.resolved" | "run.queued" | "run.started" | "run.completed" | "run.failed" | "run.cancelled";
+    payload: CanonicalEventPayload;
+}
+/**
+ * Shared canonical event payload. The open dictionary carries structured tool, surface, and usage fields while common lifecycle fields remain explicit.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "CanonicalEventPayload".
+ */
+export interface CanonicalEventPayload {
+    /**
+     * Async questions do not block provider work. Omitted for existing synchronous interactions.
+     */
+    delivery?: "async";
+    /**
+     * Message snapshot only; an active interaction.requested authorizes submission.
+     *
+     * @maxItems 50
+     */
+    questions?: AsyncUserInputQuestion[];
+    providerSession?: ProviderSession;
+    channel?: MessageChannel;
+    exposure?: MessageExposure;
+    provenance?: MessageProvenance;
+    /**
+     * Stable message identifier.
+     */
+    messageId?: string;
+    /**
+     * Stable model-step identifier used to associate messages and tool calls with one provider turn.
+     */
+    stepId?: string;
+    /**
+     * Message role, such as assistant.
+     */
+    role?: string;
+    /**
+     * Tool call or run status identifier.
+     */
+    status?: string;
+    /**
+     * Text delta or complete text.
+     */
+    text?: string;
+    /**
+     * Termination or error reason.
+     */
+    reason?: string;
+    /**
+     * Human-readable diagnostic message.
+     */
+    message?: string;
+    failure?: FailureEnvelope;
+    [k: string]: unknown;
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "AsyncUserInputQuestion".
+ */
+export interface AsyncUserInputQuestion {
+    title: string;
+    /**
+     * @maxItems 50
+     */
+    options: string[] | null;
+}
+/**
+ * Provider-owned session resume data. Core treats sessionId and adapter extension fields as opaque.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ProviderSession".
+ */
+export interface ProviderSession {
+    /**
+     * Opaque provider session identifier.
+     */
+    sessionId: string;
+    /**
+     * Whether the provider declares that later invocations can resume this session.
+     */
+    resumable?: boolean;
+    /**
+     * Require the original provider session; adapters must reject rather than start a fresh fallback. Currently implemented by Codex.
+     */
+    requireResume?: boolean;
+    /**
+     * Continuity outcome for this session update. Compaction applies to the next turn; fresh fallback applies to the current turn.
+     */
+    resumeOutcome?: "new" | "resumed" | "fresh_fallback" | "compacted";
+    /**
+     * Low-cardinality reason for a fresh resume fallback.
+     */
+    resumeFallback?: string;
+    /**
+     * Frozen context input variant actually selected for the current provider turn.
+     */
+    contextInputVariant?: "primary" | "recovery";
+    [k: string]: unknown;
+}
+/**
+ * Provider-native provenance written by the adapter. Audience projectors use it to audit public exposure and clients cannot override it.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "MessageProvenance".
+ */
+export interface MessageProvenance {
+    /**
+     * Adapter or provider type that produced the message.
+     */
+    provider: string;
+    /**
+     * Provider-native event type that was normalized.
+     */
+    nativeEvent: string;
+}
+/**
+ * Versioned, safe failure fact shared by Runtime, Worker, and channel projectors. Public codes are immutable catalog identifiers; dynamic diagnostics stay outside this object.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "FailureEnvelope".
+ */
+export interface FailureEnvelope {
+    schemaVersion: 1;
+    code: string;
+    reasonCode: string;
+    category: string;
+    stage: string;
+    messageKey: string;
+    /**
+     * Catalog-allowlisted presentation parameters only.
+     */
+    params: {
+        [k: string]: string | number | boolean;
+    };
+    retryable: boolean;
+    retryAfterMs?: number;
+    action: FailureAction;
+    diagnosticId: string;
+    source: FailureSource;
+    cause?: FailureCause;
+    occurredAt: string;
+}
+/**
+ * A catalog-controlled recovery action. Clients render labelKey and must not execute arbitrary commands from this object.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "FailureAction".
+ */
+export interface FailureAction {
+    type: "retry" | "retry_later" | "update_credentials" | "change_model" | "check_runtime" | "install_dependency" | "fix_permissions" | "contact_admin";
+    labelKey: string;
+}
+/**
+ * Low-cardinality component identity. It intentionally excludes hostnames, paths, accounts, and tenant data.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "FailureSource".
+ */
+export interface FailureSource {
+    component: "octo-runtime" | "octo-agent-worker";
+    adapter?: string;
+}
+/**
+ * Sanitized machine-readable root cause. Raw stderr, response bodies, paths, and credentials are forbidden.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "FailureCause".
+ */
+export interface FailureCause {
+    reasonCode: string;
+    httpStatus?: number;
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ControlHostFrame".
+ */
+export interface ControlHostFrame {
+    run_id: string;
+    invocation_id: string;
+    stream_id: string;
+    agent_session_id: string;
+    session_generation: number;
+    seq: number;
+    protocol_mode: ProtocolMode;
+    protocol: string;
+    kind: "control";
+    control: HostControl;
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ExecutionEvidence".
+ */
+export interface ExecutionEvidence {
+    actmode: {
+        requested: "default" | "plan";
+        effective: "default" | "plan" | null;
+        status: "applied" | "fallback" | "unknown";
+        nativeMode?: string;
+        reason?: "provider_unsupported" | "adapter_unmapped" | "provider_unconfirmed";
+    };
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ServiceProcessSnapshot".
+ */
+export interface ServiceProcessSnapshot {
+    scope_id: string;
+    service_id: string;
+    incarnation: number;
+    provider: string;
+    owner_pid: number;
+    pid?: number;
+    state: "not_started" | "starting" | "ready" | "recovering" | "degraded" | "closing" | "closed" | "cleanup_incomplete";
+    observation: "alive" | "exited" | "unknown";
+    ownership: "owned";
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "KernelStatus".
+ */
+export interface KernelStatus {
+    ipc_version: 1;
+    kernel_instance_id: string;
+    pid: number;
+    execution_ready: boolean;
+    /**
+     * @maxItems 256
+     */
+    service_processes?: ServiceProcessSnapshot[];
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "HostInvokeOptions".
+ */
+export interface HostInvokeOptions {
+    protocolMode?: ProtocolMode1;
+    protocol?: string;
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "HostRunReceipt".
+ */
+export interface HostRunReceipt {
+    run_id: string;
+    invocation_id: string;
+    stream_id: string;
+    agent_session_id: string;
+    session_generation: number;
+    protocol_mode: ProtocolMode;
+    protocol: string;
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "AdapterProtocolSupport".
+ */
+export interface AdapterProtocolSupport {
+    protocol: string;
+    /**
+     * @minItems 1
+     */
+    modes: [ProtocolMode, ...ProtocolMode[]];
+    nativeMethods: string[];
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "NativeInteractionResponse".
+ */
+export interface NativeInteractionResponse {
+    requestId: string | number;
+    payload: {
+        [k: string]: unknown;
+    };
+}
+export interface NotificationMessage1 {
+    schema: "octo.notification.v2";
+    eventId: string;
+    event: "task.event" | "execution.succeeded" | "execution.failed" | "notification.test";
+    occurredAt: string;
+    projectId: string;
+    sourceId: string;
+    title: string;
+    text: string;
+    evt_type?: number;
+    task?: {
+        id: string;
+        title: string;
+        status: "backlog" | "todo" | "in_progress" | "done" | "cancelled";
+        row_version: number;
+        handler_epoch: number;
+        responsible_party?: {} | null;
+        current_handler?: {} | null;
+    };
+    taskEvent?: {
+        id: string;
+        sequence: number;
+        evt_type: number;
+        actor: {};
+        task_conversation_id?: string;
+        source_run_id?: string;
+        summary: string;
+        payload: {};
+    };
+    /**
+     * @maxItems 20
+     */
+    timeline?: [] | [
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        }
+    ] | [
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        }
+    ] | [
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        }
+    ] | [
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        }
+    ] | [
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        }
+    ] | [
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        }
+    ] | [
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        }
+    ] | [
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        }
+    ] | [
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        }
+    ] | [
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        }
+    ] | [
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        }
+    ] | [
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        }
+    ] | [
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        }
+    ] | [
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        }
+    ] | [
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        }
+    ] | [
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        }
+    ] | [
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        }
+    ] | [
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        }
+    ] | [
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        }
+    ] | [
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        },
+        {
+            eventId: string;
+            sequence: number;
+            evt_type: number;
+            summary: string;
+        }
+    ];
+    timelineTruncated?: boolean;
+    timelineThroughSequence?: number;
+}
+/**
+ * In addition to draft-07 validation, every consumer must enforce the x-octo semantic keywords: unique ordered namespace/name tuples, compact UTF-8 JSON byte budget, JSON nesting depth with the envelope at depth zero, and Unicode scalar strings in every nested value and object key. Canonical hashing uses ECMAScript JSON number serialization, including -0 becoming 0 and normalized exponent notation; object keys are sorted by UTF-16 code units before ECMAScript integer-index enumeration. U+2028/U+2029 and non-ASCII scalar values are not escaped or Unicode-normalized.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ContextEnvelope".
+ */
+export interface ContextEnvelope {
+    schema: "octo.context-envelope/v3";
+    /**
+     * @maxItems 32
+     */
+    items: ContextItem[];
+}
+/**
+ * Agent defaults and mandatory constraints, stored under one external configuration version. Authorized configuration writers may persist system instructions in mandatory with text-only entries. Ephemeral business content and default-layer instructions are forbidden; callers cannot submit trusted control instructions.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ContextConfiguration".
+ */
+export interface ContextConfiguration {
+    defaults: ContextEnvelope;
+    mandatory: PersistentContextEnvelope;
+}
+/**
+ * Public Context facts. Preparation is distinct from Adapter application or invocation. This projection excludes resource files, trusted instruction text, credentials and Runtime paths.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "RunContextProjection".
+ */
+export interface RunContextProjection {
+    run_id: string;
+    context_hash: string;
+    actual_runtime_id?: string;
+    preparation_status: "unknown" | "prepared";
+    application_status: "unknown" | "applied";
+    invocation_status: "unknown";
+    model_uses_provider_default: boolean;
+    effort_uses_provider_default: boolean;
+    /**
+     * Frozen inline object facts proven by a matching preparation receipt. Source fields are provenance claims, not access grants. No contents, local handles, paths or credentials are exposed; application is separately evidenced by application_status.
+     *
+     * @maxItems 32
+     */
+    object_materials?: PublicObjectMaterial[];
+    execution: {
+        adapter_type: string;
+        model?: string;
+        effort?: string;
+        approval_mode: "ask" | "assisted" | "full_access";
+        workspace_mode: "fixed" | "random" | "none";
+    };
+}
+/**
+ * Workspace preparation for the current Run lease and frozen execution Context; it does not prove Provider use of model context.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ContextPreparationReceipt".
+ */
+export interface ContextPreparationReceipt {
+    context_hash: string;
+    run_id: string;
+    lease_id: string;
+    fencing_token: number;
+    workspace_mode: "fixed" | "random" | "none";
+    workspace_path: string;
+    provider_state_dir: string;
+    /**
+     * @maxItems 256
+     */
+    warnings: string[];
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ContextAdapterPayload".
+ */
+export interface ContextAdapterPayload {
+    type: string;
+    provider_agent_id?: string;
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ContextActmodePayload".
+ */
+export interface ContextActmodePayload {
+    mode: "default" | "plan";
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ContextModelPayload".
+ */
+export interface ContextModelPayload {
+    selection?: ContextModelSelectionPayload;
+    reasoning?: ContextReasoningPayload;
+}
+/**
+ * Snake-case frozen watchdog limits, with the same bounds as RuntimeLimits. Legacy enforcement=observe cannot be combined with v2 settings.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ContextLimitsPayload".
+ */
+export interface ContextLimitsPayload {
+    first_frame_timeout_ms?: number;
+    model_idle_timeout_ms?: number;
+    model_idle_warning_ms?: number;
+    model_idle_policy?: "enforce" | "observe";
+    tool_timeout_ms?: number;
+    tool_wall_timeout_ms?: number;
+    run_timeout_ms?: number;
+    cancel_grace_ms?: number;
+    enforcement?: "enforce" | "observe";
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ContextApprovalPolicyPayload".
+ */
+export interface ContextApprovalPolicyPayload {
+    mode: ApprovalMode;
+}
+/**
+ * Untrusted inline selection text with optional resource reference, source metadata and summary. Source metadata is not an authorization claim.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ContextSelectionEntry".
+ */
+export interface ContextSelectionEntry {
+    text: string;
+    resource_ref?: string;
+    source?: {
+        [k: string]: unknown;
+    } | string;
+    summary?: string;
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ContextMcpLocator".
+ */
+export interface ContextMcpLocator {
+    server_ref: string;
+    tool: string;
+}
+export interface ContextResourceEntry {
+    resource_ref: string;
+    resolver: "mcp";
+    locator: {};
+    /**
+     * Frozen non-secret JSON parameters supplied by the authenticated resolver plan, not model-generated commands.
+     */
+    params?: Record<string, unknown>;
+    authorization_ref?: string;
+    revision?: string;
+}
+/**
+ * Control instruction containing only non-empty text. Authorization belongs to the authenticated upstream boundary, not to a caller-supplied source label.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ContextInstructionEntry".
+ */
+export interface ContextInstructionEntry {
+    text: string;
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ContextInstructionsPayload".
+ */
+export interface ContextInstructionsPayload {
+    entries: ContextInstructionEntry[];
+}
+/**
+ * Snapshot selection descriptor in ExecutionEnvelope. Scope, consumer_key, and session_generation isolate the consumption cursor.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ChannelContextDescriptor".
+ */
+export interface ChannelContextDescriptor {
+    scope: ChannelScope;
+    consumer_key: string;
+    session_generation: number;
+    trigger_message_id: string;
+    trigger_seq?: number;
+    trigger_fact: ChannelMessageFact;
+}
+/**
+ * Platform-neutral channel isolation key. account_id may be null but remains explicit; an absent thread_id selects the conversation root.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ChannelScope".
+ */
+export interface ChannelScope {
+    tenant_id: string;
+    endpoint_id: string;
+    channel: string;
+    account_id: string | null;
+    bot_id: string;
+    conversation_id: string;
+    thread_id?: string | null;
+}
+/**
+ * A platform-neutral message fact in the rebuildable channel journal. Message content is always untrusted external input.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ChannelMessageFact".
+ */
+export interface ChannelMessageFact {
+    message_id: string;
+    message_seq?: number;
+    sender: ChannelMessageSender;
+    occurred_at_ms: number;
+    /**
+     * @minItems 1
+     */
+    parts: [ChannelMessagePart, ...ChannelMessagePart[]];
+    flags?: ChannelMessageFlags;
+}
+/**
+ * Normalized sender fact without platform credentials.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ChannelMessageSender".
+ */
+export interface ChannelMessageSender {
+    id: string;
+    label?: string;
+    kind: string;
+}
+/**
+ * Normalized platform message part. type and text are common fields; connector extensions remain untrusted external data.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ChannelMessagePart".
+ */
+export interface ChannelMessagePart {
+    type: string;
+    text?: string;
+    [k: string]: unknown;
+}
+/**
+ * Common message flags that affect context projection. Self and control messages are excluded from provider-visible context.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ChannelMessageFlags".
+ */
+export interface ChannelMessageFlags {
+    self?: boolean;
+    control?: boolean;
+}
+export interface ResolvedRuntimeSelection1 {
+    schema: "octo.runtime-selection/v2";
+    selection_mode: "explicit" | "candidates";
+    explicit_runtime_id?: string;
+    /**
+     * @minItems 1
+     * @maxItems 64
+     */
+    authorized_candidates: [
+        {
+            runtime_id: string;
+            priority: number;
+            owner_subject_type: "user" | "teamspace";
+            owner_subject_id: string;
+        },
+        ...{
+            runtime_id: string;
+            priority: number;
+            owner_subject_type: "user" | "teamspace";
+            owner_subject_id: string;
+        }[]
+    ];
+    offline_behavior: "wait" | "fail";
+    failover: "candidates" | "none";
+}
+export interface ResolvedExecutionPlan1 {
+    actmode?: "default" | "plan";
+    adapter_type: string;
+    workdir: string;
+    workspace?: ContextWorkspacePayload;
+    model?: string;
+    effort?: string;
+    approval_mode: ApprovalMode;
+    runtime_limits?: ContextLimitsPayload;
+    provider_agent_id?: string;
+    agent_source: AgentSource;
+    envs?: ContextEnvsPayload;
+    mcp?: ContextMcpPayload;
+}
+/**
+ * Run 级环境变量列表；以 key 标识变量，按 key 合并，不进入模型输入。
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ContextEnvsPayload".
+ */
+export interface ContextEnvsPayload {
+    /**
+     * @maxItems 128
+     */
+    env_variables: {
+        key: string;
+        value: string;
+    }[];
+}
+/**
+ * Run-scoped MCP connection templates. Server names are dynamic keys; values are validated by transport. Variables resolve only in the execution environment, never in the model context.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ContextMcpPayload".
+ */
+export interface ContextMcpPayload {
+    mcpServers: McpServers;
+}
+/**
+ * Runtime-owned phase-aware invocation watchdog budgets.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "RuntimeLimits".
+ */
+export interface RuntimeLimits {
+    firstFrameTimeoutMs?: number;
+    modelIdleTimeoutMs?: number;
+    modelIdleWarningMs?: number;
+    modelIdlePolicy?: "observe" | "enforce";
+    toolTimeoutMs?: number;
+    toolWallTimeoutMs?: number;
+    runTimeoutMs?: number;
+    cancelGraceMs?: number;
+    enforcement?: "observe" | "enforce";
+}
+/**
+ * Adapter-internal configuration derived from the resolved execution plan, not a public source of run model or approval choices. Legacy permission and thinking fields are forbidden.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "AgentConfig".
+ */
+export interface AgentConfig {
+    /**
+     * Default provider CLI working directory. It is a cwd, not a filesystem security boundary.
+     */
+    workdir?: string;
+    /**
+     * Model identifier.
+     */
+    model?: string;
+    /**
+     * Provider sandbox mode identifier.
+     */
+    sandbox?: string;
+    /**
+     * Provider-side agent identifier.
+     */
+    providerAgentId?: string;
+    /**
+     * Optional provider reasoning effort identifier. Provider adapters may define an explicit default.
+     */
+    effort?: string;
+    /**
+     * Invocation timeout in seconds.
+     */
+    timeoutSeconds?: number;
+    /**
+     * OpenClaw configuration path.
+     */
+    openclawConfigPath?: string;
+    /**
+     * OpenClaw state directory.
+     */
+    openclawStateDir?: string;
+    /**
+     * Provider-specific extension options passed through unchanged by Core.
+     */
+    providerOptions?: Record<string, unknown>;
+    [k: string]: unknown;
+}
+/**
+ * Non-blocking question batch. IDs are positions scoped to this interaction, not provider-native question IDs.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "QuestionRequest".
+ */
+export interface QuestionRequest {
+    schema: "octo.question-request/v1";
+    messageId: string;
+    /**
+     * @minItems 1
+     * @maxItems 50
+     */
+    questions: [
+        {
+            id: string;
+            title: string;
+            /**
+             * @maxItems 50
+             */
+            options: string[] | null;
+            allowCustom: true;
+        },
+        ...{
+            id: string;
+            title: string;
+            /**
+             * @maxItems 50
+             */
+            options: string[] | null;
+            allowCustom: true;
+        }[]
+    ];
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "QuestionResponse".
+ */
+export interface QuestionResponse {
+    schema: "octo.question-response/v1";
+    /**
+     * @minItems 1
+     * @maxItems 50
+     */
+    answers: [
+        {
+            questionId: string;
+            text: string;
+        },
+        ...{
+            questionId: string;
+            text: string;
+        }[]
+    ];
+}
+/**
+ * Host-owned supplement state, never stored by Kernel. Submitting or unknown records cannot be replayed.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "AsyncQuestionReplySnapshot".
+ */
+export interface AsyncQuestionReplySnapshot {
+    schema: "octo.async-question-reply/v1";
+    ref: KernelRunRef;
+    question: InteractionRequestedPayload;
+    providerSession: ProviderSession;
+    providerEpoch?: number;
+    completed: boolean;
+    phase: "pending" | "submitting" | "answered" | "cancelled" | "invalidated" | "unknown";
+}
+export interface InteractionRequestedPayload1 {
+    delivery?: "async";
+    executionInstanceId: string;
+    expiresAt?: string;
+    /**
+     * Stable invocation-scoped interaction identifier.
+     */
+    interactionId: string;
+    kind: "approval" | "question" | "elicitation";
+    /**
+     * Whether an external response is required. Omission means required; only an Adapter-owned automatic approval may set false.
+     */
+    responseRequired?: boolean;
+    /**
+     * Display-safe provider request projected for the responding product.
+     */
+    request: Record<string, unknown>;
+}
+/**
+ * Supported profile: original native request approval with requestedPermissions=[] only. Non-empty permission instances fail with APPROVAL_PERMISSION_UNSUPPORTED; consumers must not fabricate them. Details are allowlisted inert metadata. The compact UTF-8 JSON budget is enforced by x-octo-max-json-bytes.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ApprovalRequest".
+ */
+export interface ApprovalRequest {
+    schema: "octo.approval-request/v1";
+    policy: {
+        mode: ApprovalMode;
+        hash: string;
+    };
+    operation: ApprovalOperation;
+    /**
+     * @maxItems 0
+     */
+    requestedPermissions: never[];
+    reason?: string;
+    /**
+     * @minItems 1
+     */
+    allowedOutcomes: ["accepted" | "declined" | "cancelled", ...("accepted" | "declined" | "cancelled")[]];
+    grantScope: "request" | "provider";
+    providerDetails?: ApprovalDisplayDetails;
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ApprovalOperation".
+ */
+export interface ApprovalOperation {
+    kind: "command_execution" | "file_change" | "tool_execution" | "permission_grant" | "context_access";
+    summary: string;
+    toolCallId?: string;
+    details?: ApprovalDisplayDetails;
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "InteractionResolvedPayload".
+ */
+export interface InteractionResolvedPayload {
+    interactionId: string;
+    executionInstanceId: string;
+    status: "resolved" | "expired" | "invalidated";
+    outcome?: "accepted" | "declined" | "cancelled" | "answered";
+    reasonCode?: string;
+}
+/**
+ * Starts one provider model round. A round may contain public reasoning, tool calls, and text output.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ModelStepStartedPayload".
+ */
+export interface ModelStepStartedPayload {
+    /**
+     * Stable identifier reused by model_step.finished and child events.
+     */
+    stepId: string;
+    /**
+     * Provider-observed round content-start timestamp in Unix milliseconds.
+     */
+    startedAtMs?: number;
+    [k: string]: unknown;
+}
+/**
+ * Finishes one provider model round and records why control returned to the harness.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ModelStepFinishedPayload".
+ */
+export interface ModelStepFinishedPayload {
+    /**
+     * Stable identifier from model_step.started.
+     */
+    stepId: string;
+    status: "completed" | "failed" | "cancelled";
+    /**
+     * Provider-normalized reason such as tool-calls or stop.
+     */
+    finishReason?: string;
+    /**
+     * Provider-observed round finish timestamp in Unix milliseconds.
+     */
+    endedAtMs?: number;
+    [k: string]: unknown;
+}
+/**
+ * Formal tool_call.create payload. args preserves the original structured input, including args.command for shell tools.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ToolCallCreatePayload".
+ */
+export interface ToolCallCreatePayload {
+    /**
+     * Stable tool call identifier reused by later delta and update events.
+     */
+    id: string;
+    /**
+     * Tool name normalized across providers.
+     */
+    name: string;
+    /**
+     * Original structured input known when the tool call starts. Streaming providers may begin empty and append argsDelta.
+     */
+    args: Record<string, unknown>;
+    status: "running";
+    [k: string]: unknown;
+}
+/**
+ * Formal tool_call.delta payload. argsDelta is an ordered raw JSON fragment and must be concatenated before parsing.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ToolCallDeltaPayload".
+ */
+export interface ToolCallDeltaPayload {
+    /**
+     * Stable identifier from the corresponding tool_call.create event.
+     */
+    id: string;
+    /**
+     * Raw JSON argument fragment; do not parse fragments independently.
+     */
+    argsDelta?: string;
+    /**
+     * Tool output text fragment.
+     */
+    outputDelta?: string;
+    /**
+     * Full replacement of a provider rolling output snapshot; never an activity or a terminal status.
+     */
+    outputSnapshot?: string;
+    [k: string]: unknown;
+}
+/**
+ * Formal tool_call.update payload that closes the tool lifecycle and carries its final result.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ToolCallUpdatePayload".
+ */
+export interface ToolCallUpdatePayload {
+    /**
+     * Stable identifier from the corresponding tool_call.create event.
+     */
+    id: string;
+    status: "completed" | "failed" | "cancelled";
+    /**
+     * Final tool output as text or structured JSON.
+     */
+    output?: unknown;
+    /**
+     * Structured error details.
+     */
+    error?: Record<string, unknown>;
+    /**
+     * Process exit code for command tools.
+     */
+    exitCode?: number;
+    durationMs?: number;
+    [k: string]: unknown;
+}
+/**
+ * Stable run identity used by envelopes without requiring the complete domain object.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "RunIdentity".
+ */
+export interface RunIdentity {
+    /**
+     * Run identifier.
+     */
+    id: string;
+    /**
+     * Owning Agent Worker session identifier.
+     */
+    agentSessionId: string;
+}
+/**
+ * Idempotent context-only batch appended by agent-worker to its bound daemon.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ChannelContextAppend".
+ */
+export interface ChannelContextAppend {
+    agent_id: string;
+    scope: ChannelScope;
+    /**
+     * @minItems 1
+     * @maxItems 100
+     */
+    facts: [ChannelMessageFact, ...ChannelMessageFact[]];
+    gap_after_seq?: number;
+}
+/**
+ * Bounded backfill requested by the daemon after cold start or gap detection. It never carries platform tokens.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ContextSyncRequest".
+ */
+export interface ContextSyncRequest {
+    request_id: string;
+    run_id: string;
+    scope: ChannelScope;
+    trigger_message_id: string;
+    trigger_seq?: number;
+    after_seq?: number;
+    limit: number;
+}
+export interface ContextSyncResult1 {
+    request_id: string;
+    scope: ChannelScope;
+    /**
+     * @maxItems 100
+     */
+    facts: ChannelMessageFact[];
+    completeness: "complete" | "partial" | "unavailable";
+    through_seq?: number;
+}
+/**
+ * Result of advancing the consumer cursor with version CAS after terminal durability.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ContextCommitResult".
+ */
+export interface ContextCommitResult {
+    snapshot_id: string;
+    committed: boolean;
+    reason?: "already_committed" | "snapshot_not_found" | "snapshot_not_submitted" | "consumer_advanced" | "snapshot_failed";
+}
+/**
+ * A per-invocation MCP server launched as a child process by the provider.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "McpStdioServer".
+ */
+export interface McpStdioServer {
+    type: "stdio";
+    command: string;
+    /**
+     * @maxItems 128
+     */
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+    required?: boolean;
+    startupTimeoutMs?: number;
+    toolTimeoutMs?: number;
+}
+/**
+ * A per-invocation Streamable HTTP MCP endpoint. Header values are sensitive and must never enter logs or canonical events.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "McpStreamableHttpServer".
+ */
+export interface McpStreamableHttpServer {
+    type: "streamable_http";
+    /**
+     * Absolute HTTP(S) endpoint or environment template; the resolved endpoint is validated again before connecting.
+     */
+    url: string;
+    headers?: Record<string, string>;
+    required?: boolean;
+    startupTimeoutMs?: number;
+    toolTimeoutMs?: number;
+}
+/**
+ * Serializable execution request sent from Core to Adapter Host. AbortSignal is added in src/index.ts because it cannot cross a process boundary.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "InvokeRequestWire".
+ */
+export interface InvokeRequestWire {
+    executionEnvOverrides?: ContextEnvsPayload1;
+    /**
+     * Active Adapter Host invocation identifier and cancellation target.
+     */
+    invocationId: string;
+    /**
+     * Long-lived Agent Worker session identifier for this execution context.
+     */
+    agentSessionId: string;
+    /**
+     * Caller-owned nonblank display name of 1-256 Unicode code points, without C0/DEL/C1 controls; independent of business identity and opaque provider recovery handles.
+     */
+    sessionName?: string;
+    /**
+     * Run identifier for this execution.
+     */
+    runId: string;
+    /**
+     * Worker-owned AgentSession generation that fences stale continuity updates.
+     */
+    sessionGeneration?: number;
+    /**
+     * Worker-owned provider binding epoch for this Run.
+     */
+    providerEpoch?: number;
+    /**
+     * Caller continuity intent. Fresh invocations must not carry providerSession.
+     */
+    continuityMode?: "continue" | "fresh";
+    /**
+     * Display-safe current request or task description. It excludes hidden channel context and provider control parameters.
+     */
+    prompt: string;
+    /**
+     * Required exact provider-visible user turn.
+     */
+    modelInput: string;
+    /**
+     * @minItems 1
+     * @maxItems 128
+     */
+    modelInputParts?: ModelInputPart[];
+    /**
+     * @minItems 1
+     * @maxItems 128
+     */
+    freshFallbackModelInputParts?: ModelInputPart[];
+    /**
+     * Recovery includes historical images whose bytes are unavailable. Adapters must fail before sending a fresh prompt.
+     */
+    freshFallbackImagesUnavailable?: boolean;
+    /**
+     * Frozen alternate user turn for the first turn of a fresh provider session after resume fails.
+     */
+    freshFallbackModelInput?: string;
+    /**
+     * Provider process cwd. Sandboxing, containers, or host permissions provide the actual access boundary.
+     */
+    workdir: string;
+    /**
+     * Trusted session instructions. Adapters inject them only when starting a provider session; resuming an existing session must not inject or clear them.
+     */
+    controlInstructions: string;
+    context: ContextEnvelope;
+    runMetadata?: Record<string, unknown>;
+    approvalMode: ApprovalMode;
+    providerSession?: ProviderSession;
+    runtimeLimits?: RuntimeLimits;
+    agentConfig: AgentConfig;
+    protocolVersion: 2;
+    agentSource: AgentSource;
+}
+/**
+ * Run 级环境变量列表；以 key 标识变量，按 key 合并，不进入模型输入。
+ */
+export interface ContextEnvsPayload1 {
+    /**
+     * @maxItems 128
+     */
+    env_variables: {
+        key: string;
+        value: string;
+    }[];
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ActivityInfo".
+ */
+export interface ActivityInfo {
+    messageKey?: string;
+    params?: {
+        [k: string]: string | number | boolean;
+    };
+    attempt?: number;
+    retryAfterMs?: number;
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ActivityStartedPayload".
+ */
+export interface ActivityStartedPayload {
+    activityId: string;
+    kind: "starting" | "thinking" | "executing_tool" | "responding" | "waiting_approval" | "waiting_input" | "compacting" | "retrying" | "working";
+    subject: ActivitySubject;
+    source: "provider" | "harness";
+    info: ActivityInfo;
+    startedAtMs?: number;
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ActivityUpdatedPayload".
+ */
+export interface ActivityUpdatedPayload {
+    activityId: string;
+    info: ActivityInfo;
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ActivityFinishedPayload".
+ */
+export interface ActivityFinishedPayload {
+    activityId: string;
+    status: "completed" | "failed" | "cancelled" | "superseded";
+    endedAtMs?: number;
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "PlanUpdatedPayload".
+ */
+export interface PlanUpdatedPayload {
+    planId: string;
+    revision: number;
+    explanation: string | null;
+    /**
+     * @maxItems 200
+     */
+    steps: {
+        text: string;
+        status: "pending" | "in_progress" | "completed" | "blocked" | "cancelled";
+    }[];
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ToolProgressPayload".
+ */
+export interface ToolProgressPayload {
+    id: string;
+    progress: {
+        message?: string;
+        completed?: number;
+        total?: number;
+        unit?: "items" | "bytes" | "steps";
+    };
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "RunNoticePayload".
+ */
+export interface RunNoticePayload {
+    noticeId: string;
+    code: "retry_scheduled" | "context_compacted" | "model_rerouted" | "config_warning" | "provider_diagnostic";
+    severity: "info" | "warning";
+    params: {
+        [k: string]: string | number | boolean;
+    };
+    relatedActivityId?: string;
+    relatedItemId?: string;
+}
+/**
+ * Untrusted inline selection text with optional resource reference, source metadata and summary. Source metadata is not an authorization claim.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ContextInlineEntry".
+ */
+export interface ContextInlineEntry {
+    text: string;
+    resource_ref?: string;
+    source?: {
+        [k: string]: unknown;
+    } | string;
+    summary?: string;
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ContextInlinePayload".
+ */
+export interface ContextInlinePayload {
+    /**
+     * @minItems 1
+     */
+    entries: [ContextInlineEntry, ...ContextInlineEntry[]];
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ContextReferencesPayload".
+ */
+export interface ContextReferencesPayload {
+    /**
+     * @minItems 1
+     */
+    entries: [ContextReferenceEntry, ...ContextReferenceEntry[]];
+}
+/**
+ * Business authorization intent; never a tool installation definition.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "ToolAuthorization".
+ */
+export interface ToolAuthorization {
+    service_subject_id: string;
+    /**
+     * @minItems 1
+     * @maxItems 128
+     */
+    allowed_tools: [string, ...string[]];
+    /**
+     * @minItems 1
+     * @maxItems 128
+     */
+    resource_refs: [string, ...string[]];
+}
+/**
+ * Run lease-bound credentials delivered over the authenticated Runtime channel. Never enter provider configuration, prompts or logs.
+ *
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "IssuedToolAuthorization".
+ */
+export interface IssuedToolAuthorization {
+    service_subject_id: string;
+    /**
+     * @minItems 1
+     * @maxItems 128
+     */
+    allowed_tools: [string, ...string[]];
+    /**
+     * @minItems 1
+     * @maxItems 128
+     */
+    resource_refs: [string, ...string[]];
+    token: string;
+    octo_space_id: string;
+    namespace: string;
+    expires_at: string;
+}
+export interface InvokeInputWire {
+    /**
+     * Optional caller-owned nonblank display name of 1-256 Unicode code points, without C0/DEL/C1 controls; Core supplies a random UUID default without business naming policy.
+     */
+    sessionName?: string;
+    sessionId?: string;
+    invocationId?: string;
+    runId?: string;
+    prompt?: string;
+    modelInput?: string;
+    freshFallbackModelInput?: string;
+    workdir?: string;
+    controlInstructions?: string;
+    inputs: ModelInputParts;
+    contexts: ContextEnvelope;
+    protocol_mode?: ProtocolMode;
+    agentSource?: AgentSource;
+    approvalMode?: ApprovalMode;
+    agentConfig?: AgentConfig;
+    runtimeLimits?: RuntimeLimits;
+    providerSession?: ProviderSession;
+    sessionGeneration?: number;
+    providerEpoch?: number;
+    runMetadata?: {
+        [k: string]: unknown;
+    };
+    continuityMode?: "fresh" | "continue";
+    freshFallbackModelInputParts?: ModelInputParts;
+    freshFallbackImagesUnavailable?: boolean;
+    [k: string]: unknown;
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "KernelInvokeEnvironmentWire".
+ */
+export interface KernelInvokeEnvironmentWire {
+    executionEnvOverrides?: ContextEnvsPayload;
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "InteractionResponseWire".
+ */
+export interface InteractionResponseWire {
+    interactionId: string;
+    outcome: "accepted" | "declined" | "answered" | "cancelled";
+    value?: unknown;
+    [k: string]: unknown;
+}
+/**
+ * This interface was referenced by `OctoRuntimeProtocolSchema`'s JSON-Schema
+ * via the `definition` "HostedAdapterMetadataWire".
+ */
+export interface HostedAdapterMetadataWire {
+    type: string;
+    agentSources: AgentSource[];
+    workspace?: boolean;
+    protocolSupport?: AdapterProtocolSupport;
+    processModel?: string;
+    transport?: string;
+    providerVersion?: string | null;
+    providerPath?: string | null;
+    available?: boolean;
+    unavailableReason?: string | null;
+    [k: string]: unknown;
+}