@axiom-lattice/client-sdk 5.0.1 → 7.0.0

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as _axiom_lattice_protocols from '@axiom-lattice/protocols';
-import { McpUiResourcePayload, CapabilityBundle, CapabilityPreview, AgentWebApp, Message, MessageChunk, DatabaseConfigEntry, MetricsServerConfigEntry, DataSource, McpServerConfigEntry, McpTool, LocalA2ATemplateDefinition, OpenGrant, TaskItem, CreateDatabaseConfigRequest, UpdateDatabaseConfigRequest, ModelProviderPublicEntry, CreateModelProviderRequest, UpdateModelProviderRequest, ModelProviderProbeRequest, ModelProviderProbeResult, ModelSelection, ModelDiscoveryResult, TenantModelCatalog, CreateMetricsServerConfigRequest, UpdateMetricsServerConfigRequest, CreateMcpServerConfigRequest, UpdateMcpServerConfigRequest, ConnectionEntry, CreateTaskRequest, UpdateTaskRequest, TaskWorkItem, LocalA2AProviderState, OpenCatalog, McpUiRef, CreateCapabilityBundleInput, UpdateCapabilityBundleInput, CreateAgentWebAppInput, UpdateAgentWebAppInput, Skill, CreateSkillRequest, CreateShareRequest, ShareResult, ShareRecord, ProjectRoom, ProjectRoomPublicMessage, ProjectMembership, ProjectBotMembership, ProjectRoomPublicMembership, ProjectRoomPublicBotMembership, ProjectRoomMention, ProjectHumanRole, ProjectBotRole, Project as Project$1, ProjectRoomEventScope, ToolCallUi } from '@axiom-lattice/protocols';
-export { AgentWebApp, AgentWebAppAppearance, AgentWebAppFeatures, AgentWebAppQuickPrompt, AgentWebAppScope, AgentWebAppStatus, CapabilityBundle, CapabilityPreview, CreateAgentWebAppInput, CreateCapabilityBundleInput, LocalA2AProviderId, LocalA2AProviderState, LocalA2AProviderStatus, LocalA2ATemplateDefinition, LocalRuntimeConfig, UpdateAgentWebAppInput, UpdateCapabilityBundleInput } from '@axiom-lattice/protocols';
+import { McpUiResourcePayload, CapabilityBundle, CapabilityPreview, AgentWebApp, AgentInterrupt, Message, MessageChunk, DatabaseConfigEntry, MetricsServerConfigEntry, DataSource, McpServerConfigEntry, McpTool, LocalA2ATemplateDefinition, OpenGrant, TaskItem, CreateDatabaseConfigRequest, UpdateDatabaseConfigRequest, ModelProviderPublicEntry, CreateModelProviderRequest, UpdateModelProviderRequest, ModelProviderProbeRequest, ModelProviderProbeResult, ModelSelection, ModelDiscoveryResult, TenantModelCatalog, CreateMetricsServerConfigRequest, UpdateMetricsServerConfigRequest, CreateMcpServerConfigRequest, UpdateMcpServerConfigRequest, ConnectionEntry, CreateTaskRequest, UpdateTaskRequest, TaskWorkItem, ThreadCheckpointStorage, LocalA2AProviderState, OpenCatalog, McpUiRef, CreateCapabilityBundleInput, UpdateCapabilityBundleInput, CreateAgentWebAppInput, UpdateAgentWebAppInput, Skill, CreateSkillRequest, CreateShareRequest, ShareResult, ShareRecord, ProjectRoom, ProjectRoomPublicMessage, ProjectMembership, ProjectBotMembership, ProjectRoomPublicMembership, ProjectRoomPublicBotMembership, ProjectRoomMention, ProjectHumanRole, ProjectBotRole, Project as Project$1, ProjectRoomEventScope, ToolCallUi } from '@axiom-lattice/protocols';
+export { AgentInterrupt, AgentWebApp, AgentWebAppAppearance, AgentWebAppFeatures, AgentWebAppQuickPrompt, AgentWebAppScope, AgentWebAppStatus, CapabilityBundle, CapabilityPreview, CreateAgentWebAppInput, CreateCapabilityBundleInput, LocalA2AProviderId, LocalA2AProviderState, LocalA2AProviderStatus, LocalA2ATemplateDefinition, LocalRuntimeConfig, ThreadCheckpointStorage, UpdateAgentWebAppInput, UpdateCapabilityBundleInput } from '@axiom-lattice/protocols';
 
 /** Resolved MCP App UI resource plus its ready-to-use CSP policy string. */
 interface McpUiResourceResponse extends McpUiResourcePayload {
@@ -116,6 +116,47 @@ interface CreateThreadOptions {
      * Optional metadata for the thread
      */
     metadata?: Record<string, any>;
+    /** Optional relative TTL in seconds. */
+    ttlSeconds?: number;
+    /** Optional absolute ISO expiry; ignored when ttlSeconds is supplied. */
+    expiresAt?: string;
+    /** Optional pre-populated graph state written at creation. */
+    supersteps?: ThreadSuperstepInput[];
+}
+/** One checkpoint update applied when creating a thread. */
+interface ThreadSuperstepInput {
+    updates: Array<{
+        values: Record<string, unknown>;
+        as_node?: string;
+    }>;
+}
+/** Thread status and pending HITL interrupts. */
+interface ThreadStatusInfo {
+    status: "idle" | "busy" | "interrupted" | "error";
+    pendingMessages: number;
+    interrupts: AgentInterrupt[];
+}
+/** One page of thread checkpoint history (newest first). */
+interface ThreadHistoryPage {
+    history: unknown[];
+}
+/** Result of a thread copy operation. */
+type CopiedThread = Thread;
+/** Prune strategy input. */
+interface PruneThreadInput {
+    strategy: "delete" | "keep_latest";
+    keep?: number;
+}
+/** Result of a thread prune operation. */
+interface PruneThreadResult {
+    pruned: boolean;
+    strategy?: "delete" | "keep_latest";
+    keep?: number;
+    counts?: {
+        checkpoints: number;
+        blobs: number;
+        writes: number;
+    };
 }
 /**
  * Thread information
@@ -296,6 +337,13 @@ interface ResumeStreamOptions {
      * Polling interval in milliseconds (default: 100ms)
      */
     pollInterval?: number;
+    /**
+     * Last SSE event id received on a prior connection.
+     *
+     * Sent as `Last-Event-ID` so a shared/cursor-addressable chunk source resumes
+     * strictly after that record. Omit to position by message id.
+     */
+    lastEventId?: string;
 }
 /**
  * Thread list options
@@ -577,6 +625,306 @@ declare enum ScheduledTaskStatus {
 /**
  * Scheduled task definition
  */
+/** Queue behavior for an Agent cron. */
+type CronMultitaskStrategy = "enqueue" | "interrupt";
+/** Completion behavior for a stateless Agent cron. */
+type CronOnRunCompleted = "keep" | "delete";
+/** Agent cron resource returned by the gateway. */
+interface AgentCron {
+    cron_id: string;
+    thread_id?: string;
+    assistant_id: string;
+    /** Workspace scope captured when the cron was created. */
+    workspace_id?: string;
+    /** Project scope captured when the cron was created. */
+    project_id?: string;
+    schedule: string;
+    timezone: string;
+    end_time?: string;
+    next_run_date?: string;
+    enabled: boolean;
+    payload: Record<string, unknown>;
+    on_run_completed?: CronOnRunCompleted;
+    multitask_strategy: CronMultitaskStrategy;
+    created_at: string;
+    updated_at: string;
+    run_count: number;
+    status: string;
+}
+/** Shared create fields for thread and stateless crons. */
+interface CreateCronInput {
+    schedule: string;
+    timezone?: string;
+    end_time?: string;
+    payload: {
+        input: Record<string, unknown>;
+    };
+    enabled?: boolean;
+    multitask_strategy?: CronMultitaskStrategy;
+    /** Workspace to bind to the scheduled runs. */
+    workspace_id?: string;
+    /** Project to bind to the scheduled runs. */
+    project_id?: string;
+}
+/** Create a cron bound to an existing thread. */
+type CreateThreadCronInput = CreateCronInput;
+/** Create a stateless cron that starts a fresh thread per fire. */
+interface CreateStatelessCronInput extends CreateCronInput {
+    assistant_id: string;
+    on_run_completed?: CronOnRunCompleted;
+}
+/** Filters accepted by cron search/count. */
+interface CronSearchFilters {
+    assistant_id?: string;
+    thread_id?: string;
+    enabled?: boolean;
+    limit?: number;
+    offset?: number;
+}
+/** Count filters accepted by the cron count endpoint. */
+interface CronCountFilters {
+    assistant_id?: string;
+    thread_id?: string;
+    enabled?: boolean;
+}
+/** Patchable fields on an Agent cron (D1: enabled only). */
+interface UpdateAgentCronInput {
+    enabled: boolean;
+}
+/** Structured Agent graph returned by `agent.getTree`. */
+interface AgentGraphTree {
+    nodes: unknown[];
+    edges: unknown[];
+    mermaid: string;
+    namespaces: string[][];
+}
+/** Input payload accepted by the `run.start` thread command. */
+interface CommandRunStartInput {
+    message?: string;
+    messages?: Array<{
+        role: string;
+        content: unknown;
+    }>;
+    id?: string;
+}
+/** Arguments for `run.start`. */
+interface CommandRunStartArgs {
+    input: CommandRunStartInput;
+    config?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    multitask_strategy?: "enqueue" | "interrupt" | "collect";
+}
+/** Result of `run.start`. */
+interface CommandRunStartResult {
+    messageId: string;
+    queued: boolean;
+    mode: string;
+}
+/** Arguments for `input.respond`. */
+interface CommandInputRespondArgs {
+    interrupt_id: string;
+    response?: unknown;
+    answers?: unknown[];
+    resume?: Record<string, unknown>;
+    config?: Record<string, unknown>;
+    /** Server currently derives this from `interrupt_id`; accepted for forward compatibility. */
+    expected_interrupt_id?: string;
+}
+/** Result of `input.respond` (queue-first: the answer is accepted before it runs). */
+interface CommandInputRespondResult {
+    messageId: string;
+    queued: boolean;
+    interruptId: string;
+    /** Present on queue-first responses; the answer was durably accepted. */
+    accepted?: boolean;
+    /** Present on queue-first responses; the queued command id. */
+    commandId?: string;
+}
+/** Input accepted by the single-run create API. */
+interface RunCreateInput {
+    message?: string;
+    messages?: Array<{
+        role: string;
+        content: unknown;
+    }>;
+    id?: string;
+}
+/** Options accepted by the single-run create API. */
+interface RunCreateOptions {
+    config?: Record<string, unknown>;
+    mode?: "followup" | "enqueue";
+    /** HITL resume command; mutually exclusive with `input`. */
+    command?: {
+        resume: unknown;
+    };
+    /**
+     * Behavior when the thread already has an active run. Defaults to `enqueue`.
+     *
+     * @remarks `reject` returns `409 RUN_REJECTED` without touching the active
+     * run; `interrupt` settles or interrupts exactly one active run, waits for it
+     * to become terminal, then creates the new pending run; `rollback` rewinds
+     * and deletes the active run first. `interrupt`/`rollback` return
+     * `409 MULTITASK_INTERRUPT_CONFLICT` / `409 MULTITASK_ROLLBACK_CONFLICT` when
+     * more than one run is active.
+     */
+    multitaskStrategy?: "enqueue" | "reject" | "interrupt" | "rollback";
+}
+/** Result of creating a single run (durable pending queue entry). */
+interface RunCreateResult {
+    runId: string;
+    /** Present for input runs; command runs do not create a user message. */
+    messageId?: string;
+    status: "pending";
+}
+/** Safe, client-facing projection of a run ledger record. */
+interface RunRecord {
+    runId: string;
+    status: AgentRunStatus;
+    /** Null while the run is pending. */
+    owner: string | null;
+    attempts: number;
+    error: string | null;
+    cancelRequested: boolean;
+    createdAt: number;
+    updatedAt: number;
+    /** Null while the run is pending. */
+    startedAt: number | null;
+    finishedAt: number | null;
+}
+/** Options for cancelling a run. */
+interface RunCancelOptions {
+    /** Wait for the run to reach a terminal status (server caps the wait). */
+    wait?: boolean;
+    /**
+     * `interrupt` keeps the run and its checkpoints; `rollback` deletes the
+     * pending row or rewinds a running run's checkpoints and row.
+     */
+    action?: "interrupt" | "rollback";
+}
+/** Result of a run cancellation request. */
+interface RunCancelResult {
+    success: boolean;
+    accepted: boolean;
+    /** `rolled_back` means the run row was deleted; no `run` is returned. */
+    status: AgentRunStatus | "requested" | "rolled_back";
+    terminal: boolean;
+    run?: RunRecord;
+}
+/** One projected thread event from the SSE event stream. */
+interface ThreadEvent {
+    type: "event";
+    event_id: string;
+    seq: string;
+    method: string;
+    params: {
+        namespace: string[];
+        timestamp: number;
+        data: unknown;
+        node?: string;
+    };
+}
+/** Filters/resume cursor for the thread event stream. */
+interface ThreadEventStreamOptions {
+    channels?: string[];
+    namespaces?: string[][];
+    depth?: number;
+    since?: string | number;
+}
+/** Error delivered to `streamThreadEvents` consumers. */
+interface ThreadEventStreamError extends Error {
+    code?: string;
+    /** HTTP status for non-OK stream responses. */
+    status?: number;
+    /** Parsed JSON body for non-OK stream responses. */
+    responseBody?: unknown;
+}
+/** Public gateway identity, flags, capabilities, and endpoint paths. */
+interface GatewayInfo {
+    service: "lattice-gateway";
+    version: string;
+    commit?: string;
+    startedAt: string;
+    uptimeSeconds: number;
+    flags: {
+        authRequired: boolean;
+        executionWorker: boolean;
+        chunkSource: "memory" | "redis";
+        multiReplica: boolean;
+    };
+    capabilities: {
+        a2a: boolean;
+        mcp: boolean;
+        store: boolean;
+        crons: boolean;
+        threadEvents: boolean;
+        threadEventsWebSocket: boolean;
+        metrics: boolean;
+        taskLifecycle: boolean;
+    };
+    endpoints: {
+        health: string;
+        metrics: string;
+        info: string;
+        mcp: string;
+        store: string;
+        threadEvents: string;
+        a2aAgentCard: string;
+        a2aJsonRpc: string;
+    };
+    metadata: {
+        deployment?: string;
+    };
+}
+/** Agent run lifecycle status exposed by `/metrics`. */
+type AgentRunStatus = "pending" | "running" | "success" | "error" | "interrupted" | "cancelled" | "timeout";
+/** Execution worker posture exposed by `/metrics`. */
+interface SystemMetricsWorker {
+    enabled: boolean;
+    started?: boolean;
+    inFlight?: number;
+    maxConcurrentThreads?: number;
+    scanIntervalMs?: number;
+}
+/** Chunk stream posture exposed by `/metrics`. */
+interface SystemMetricsChunk {
+    source: "memory" | "redis";
+    ttlMs: number;
+    maxLen: number;
+}
+/** Point-in-time gateway posture returned by `/metrics?format=json`. */
+interface SystemMetrics {
+    replicaId: string;
+    uptimeSeconds: number;
+    agentRuns?: Record<AgentRunStatus, number>;
+    pendingThreads?: number;
+    worker: SystemMetricsWorker;
+    chunk: SystemMetricsChunk;
+}
+/** Tenant-scoped namespaced store item. */
+interface StoreItem {
+    namespace: string[];
+    key: string;
+    value: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+    expiresAt?: string;
+}
+/** Create/replace input for a store item. */
+interface StorePutInput {
+    namespace: string[];
+    key: string;
+    value: Record<string, unknown>;
+    ttlMinutes?: number;
+    index?: boolean | string[];
+}
+/** Search input for the tenant store. */
+interface StoreSearchInput {
+    namespacePrefix?: string[];
+    filter?: Record<string, unknown>;
+    query?: string;
+    limit?: number;
+    offset?: number;
+}
 interface ScheduledTask {
     /**
      * Unique task identifier
@@ -940,6 +1288,10 @@ interface KeyExposure {
             assistantId: string;
             cardUrl: string;
             jsonrpcUrl: string;
+            /** A2A 1.0 Agent Card endpoint (same credential as the 0.3 endpoint). */
+            v1CardUrl?: string;
+            /** A2A 1.0 JSON-RPC endpoint. */
+            v1JsonrpcUrl?: string;
             card: Record<string, unknown>;
         }>;
     };
@@ -1237,6 +1589,27 @@ declare abstract class AbstractClient {
      * @returns A new client instance with the same configuration and state
      */
     clone(overrides?: Partial<ClientConfig>): AbstractClient;
+    /**
+     * Headers for thread event SSE requests. Concrete clients may add live
+     * tenant/workspace/auth state.
+     *
+     * @returns Request headers.
+     */
+    protected getThreadEventHeaders(): Record<string, string>;
+    /**
+     * Stream thread-wide projected events over SSE.
+     *
+     * The caller owns reconnection: pass the last `event.seq` as `since`.
+     * There is no automatic retry. Browser WebSocket auth is not covered here;
+     * this SSE path uses `fetch` and the normal Authorization headers.
+     *
+     * @param threadId - Thread id.
+     * @param options - Channel/namespace/depth filters and resume cursor.
+     * @param onEvent - Callback for each projected event.
+     * @param onError - Callback for stream/cursor errors (stream stops).
+     * @returns Abort function.
+     */
+    streamThreadEvents(threadId: string, options: ThreadEventStreamOptions, onEvent: (event: ThreadEvent) => void, onError?: (error: ThreadEventStreamError) => void): () => void;
     /**
      * Abstract method for making API requests
      * To be implemented by concrete client classes
@@ -1282,6 +1655,58 @@ declare abstract class AbstractClient {
      * @returns A promise that resolves to an array of threads
      */
     listThreads(options?: ListThreadsOptions): Promise<Thread[]>;
+    /**
+     * Reads a thread's run status, pending message count, and interrupts.
+     * @param threadId - Thread identifier.
+     * @returns Thread status projection.
+     */
+    getThreadStatus(threadId: string): Promise<ThreadStatusInfo>;
+    /**
+     * Reads a page of thread checkpoint history.
+     * @param threadId - Thread identifier.
+     * @param options - Optional limit and before-checkpoint cursor.
+     * @returns Checkpoint snapshots, newest first.
+     */
+    getThreadHistory(threadId: string, options?: {
+        limit?: number;
+        before?: string;
+    }): Promise<unknown[]>;
+    /**
+     * Reads the raw snapshot at one checkpoint.
+     * @param threadId - Thread identifier.
+     * @param checkpointId - Checkpoint identifier.
+     * @returns The raw checkpoint snapshot.
+     */
+    getThreadStateAtCheckpoint(threadId: string, checkpointId: string): Promise<unknown>;
+    /**
+     * Reads checkpoint storage accounting for a thread.
+     * @param threadId - Thread identifier.
+     * @returns Storage byte/count projection.
+     */
+    getThreadStorage(threadId: string): Promise<ThreadCheckpointStorage>;
+    /**
+     * Copies a thread's checkpoints and row into a new thread.
+     * @param threadId - Source thread identifier.
+     * @returns The created thread.
+     */
+    copyThread(threadId: string): Promise<CopiedThread>;
+    /**
+     * Prunes a thread's checkpoints or deletes the thread.
+     * @param threadId - Thread identifier.
+     * @param input - Prune strategy and optional keep count.
+     * @returns Prune result.
+     */
+    pruneThread(threadId: string, input: PruneThreadInput): Promise<PruneThreadResult>;
+    /**
+     * Reads the public gateway info surface.
+     * @returns Service identity, flags, capabilities, endpoints, and metadata.
+     */
+    getInfo(): Promise<GatewayInfo>;
+    /**
+     * Reads the current gateway replica's runtime metrics.
+     * @returns Run counts, pending threads, worker posture, and chunk posture.
+     */
+    getSystemMetrics(): Promise<SystemMetrics>;
     /**
      * Deletes a thread
      * @deprecated Use threads.delete() instead
@@ -1332,6 +1757,7 @@ declare abstract class AbstractClient {
         sendBackground: (options: ChatSendOptions) => Promise<{
             messageId: string;
             queued: boolean;
+            runId?: string;
         }>;
         /**
          * Sends a message to a thread and streams the response
@@ -1832,6 +2258,165 @@ declare abstract class AbstractClient {
          */
         resume: (taskId: string) => Promise<boolean>;
     };
+    /**
+     * Agent cron resources (`/api/runs/crons` and thread-bound crons).
+     */
+    crons: {
+        /**
+         * Creates a cron bound to an existing thread.
+         * @param threadId - Thread that receives follow-up runs.
+         * @param body - Cron definition.
+         * @returns The created cron.
+         */
+        createForThread: (threadId: string, body: CreateThreadCronInput) => Promise<AgentCron>;
+        /**
+         * Creates a stateless cron that starts a fresh thread per fire.
+         * @param body - Cron definition including the assistant id.
+         * @returns The created cron.
+         */
+        createStateless: (body: CreateStatelessCronInput) => Promise<AgentCron>;
+        /**
+         * Searches tenant-scoped Agent crons.
+         * @param body - Optional assistant/thread/enabled/pagination filters.
+         * @returns Matching crons.
+         */
+        search: (body?: CronSearchFilters) => Promise<AgentCron[]>;
+        /**
+         * Counts tenant-scoped Agent crons.
+         * @param body - Optional assistant/thread/enabled filters.
+         * @returns Matching cron count.
+         */
+        count: (body?: CronCountFilters) => Promise<number>;
+        /**
+         * Reads one Agent cron.
+         * @param cronId - Cron id.
+         * @returns The cron resource.
+         */
+        get: (cronId: string) => Promise<AgentCron>;
+        /**
+         * Pauses or resumes a cron.
+         * @param cronId - Cron id.
+         * @param enabled - Desired enabled state.
+         * @returns The updated cron.
+         */
+        updateEnabled: (cronId: string, enabled: boolean) => Promise<AgentCron>;
+        /**
+         * Cancels/deletes a cron.
+         * @param cronId - Cron id.
+         * @returns True when the gateway reports success.
+         */
+        delete: (cronId: string) => Promise<boolean>;
+    };
+    /**
+     * Thread command surface (`run.start`, `input.respond`, `agent.getTree`).
+     */
+    commands: {
+        /**
+         * Starts a run on a thread.
+         * @param threadId - Thread id.
+         * @param args - Input/config/metadata/strategy.
+         * @returns Queued message id and mode.
+         */
+        runStart: (threadId: string, args: CommandRunStartArgs) => Promise<CommandRunStartResult>;
+        /**
+         * Answers a pending interrupt.
+         * @param threadId - Thread id.
+         * @param args - Interrupt id and response/resume payload.
+         * @returns Queued message id and interrupt id.
+         */
+        respond: (threadId: string, args: CommandInputRespondArgs) => Promise<CommandInputRespondResult>;
+        /**
+         * Reads the structured Agent graph.
+         * @param threadId - Thread id.
+         * @returns Nodes, edges, Mermaid, and namespace placeholder.
+         */
+        getTree: (threadId: string) => Promise<AgentGraphTree>;
+    };
+    /**
+     * Single-run surface (`POST/GET /threads/:id/runs`, cancellation).
+     */
+    runs: {
+        /**
+         * Enqueues one run-bound input or HITL resume command.
+         * @param threadId - Thread id.
+         * @param input - Message or messages accepted by the run API; omit for command runs.
+         * @param options - Optional config, mode, command, and multitask strategy.
+         * @param assistantId - Assistant id override (defaults to the client's).
+         * @returns Pending run id and the optional input message id.
+         */
+        create: (threadId: string, input: RunCreateInput | undefined, options?: RunCreateOptions, assistantId?: string) => Promise<RunCreateResult>;
+        /**
+         * Lists run ledger records for a thread.
+         * @param threadId - Thread id.
+         * @param assistantId - Assistant id override (defaults to the client's).
+         * @returns Safe run records.
+         */
+        list: (threadId: string, assistantId?: string) => Promise<RunRecord[]>;
+        /**
+         * Reads one run ledger record.
+         * @param threadId - Thread id.
+         * @param runId - Run id.
+         * @param assistantId - Assistant id override (defaults to the client's).
+         * @returns The safe run record.
+         */
+        get: (threadId: string, runId: string, assistantId?: string) => Promise<RunRecord>;
+        /**
+         * Waits for a run to reach a terminal status (server-capped).
+         * @param threadId - Thread id.
+         * @param runId - Run id.
+         * @param assistantId - Assistant id override (defaults to the client's).
+         * @returns The terminal run record.
+         * @throws {ApiError} On `504 RUN_JOIN_TIMEOUT` or `404 RUN_NOT_FOUND`.
+         */
+        join: (threadId: string, runId: string, assistantId?: string) => Promise<RunRecord>;
+        /**
+         * Requests cancellation of one run.
+         * @param threadId - Thread id.
+         * @param runId - Run id.
+         * @param options - Optional `wait` and `action` (`interrupt` or `rollback`).
+         * @param assistantId - Assistant id override (defaults to the client's).
+         * @returns Acceptance, terminal status, and optional latest run.
+         */
+        cancel: (threadId: string, runId: string, options?: RunCancelOptions, assistantId?: string) => Promise<RunCancelResult>;
+    };
+    /**
+     * Tenant-scoped namespaced key-value store (viewer/editor surface).
+     */
+    store: {
+        /**
+         * Creates or replaces a store item.
+         * @param input - Namespace, key, value, optional TTL/index hint.
+         * @returns The persisted item.
+         */
+        put: (input: StorePutInput) => Promise<StoreItem>;
+        /**
+         * Reads one item by namespace and key.
+         * @param namespace - Namespace path.
+         * @param key - Item key.
+         * @returns The item.
+         */
+        get: (namespace: string[], key: string) => Promise<StoreItem>;
+        /**
+         * Deletes one item.
+         * @param namespace - Namespace path.
+         * @param key - Item key.
+         * @returns True when deleted.
+         */
+        delete: (namespace: string[], key: string) => Promise<boolean>;
+        /**
+         * Searches items under a namespace prefix.
+         * @param input - Prefix/filter/query/pagination.
+         * @returns Matching items.
+         */
+        search: (input?: StoreSearchInput) => Promise<StoreItem[]>;
+        /**
+         * Lists distinct namespace paths.
+         * @param prefix - Optional namespace prefix.
+         * @param limit - Optional result cap (gateway clamps).
+         * @returns Namespace paths.
+         */
+        namespaces: (prefix?: string[], limit?: number) => Promise<string[][]>;
+    };
 }
 
 /**
@@ -2080,15 +2665,18 @@ type ResumeProjectRoomInterruptInput = {
         kind: "presence";
         membershipId: string;
     };
+    interruptId?: string;
     answers?: ProjectRoomInterruptAnswerInput[];
 } | {
     ref: {
         kind: "task";
         taskId: string;
     };
+    interruptId?: string;
     answers?: ProjectRoomInterruptAnswerInput[];
 } | {
     membershipId: string;
+    interruptId?: string;
     answers?: ProjectRoomInterruptAnswerInput[];
 };
 type HeadersGetter$1 = () => Record<string, string>;
@@ -2279,6 +2867,8 @@ declare class RoomEventsClient {
  */
 declare class Client extends AbstractClient {
     private headers;
+    /** Last SSE event id observed per thread, for automatic resume. */
+    private resumeEventIds;
     resources: ResourcesClient;
     exportImport: ExportImportClient;
     readonly projectRooms: ProjectRoomsClient;
@@ -2326,6 +2916,12 @@ declare class Client extends AbstractClient {
      * Get workspace headers for THIS instance (merged with global fallback)
      */
     getWorkspaceHeaders(): Record<string, string>;
+    /**
+     * Instance-only workspace headers (never merged with the process-global
+     * Console context). Runtime transports use this so a web-app scope cannot
+     * inherit a Console tenant/project selection from another client.
+     */
+    getInstanceWorkspaceHeaders(): Record<string, string>;
     /**
      * Get global workspace headers (legacy static API)
      */
@@ -2384,6 +2980,7 @@ declare class Client extends AbstractClient {
      * @private
      */
     protected getAllHeaders(): Record<string, string>;
+    protected getThreadEventHeaders(): Record<string, string>;
     protected bodyAffinityHeaders(body: unknown): Record<string, string>;
     private streamRun;
 }
@@ -2658,4 +3255,4 @@ declare function normalizeToolResult(message: {
     artifact?: unknown;
 }): NormalizedToolResult;
 
-export { A2AKeyListItem, A2AKeysListResponse, AbortAgentParams, AbstractClient, AddProjectBotMembershipInput, AddProjectMembershipInput, AgentState, AgentWebAppsListResponse, ApiError, ArchiveInput, Assistant, AssistantListResponse, AssistantResponse, AuthenticationError, CapabilityBundleListResponse, ChatResponse, ChatSendOptions, ChatStreamOptions, Client, ClientConfig, CompleteTaskInput, CompleteTaskResponse, CreateA2AKeyInput, CreateAssistantOptions, CreateProjectRequest, CreateThreadOptions, CreateWorkspaceRequest, DatabaseConfigResponse, DatabaseConfigsListResponse, DatasourcesListResponse, ExportBundle, ExportConfigResult, ExportConfirmationRequired, ExportDownload, ExportEntityIds, ExportEntityPreview, ExportEntityPreviewMap, ExportImportClient, ExportableEntity, ExportableTypeInfo, FileItem, GetMessagesOptions, GetScheduledTasksOptions, ImportApplyResult, ImportConflict, ImportEntityResult, ImportInsertion, ImportPreviewError, ImportPreviewResult, ImportResolution, ImportResolutions, ImportSource, InvalidCapabilityBundleSummary, KeyExposure, ListAgentWebAppsParams, ListProjectRoomMessagesOptions, ListThreadsOptions, LocalA2ATemplatesListResponse, McpServerResponse, McpServersListResponse, McpUiResourceResponse, MetricsConfigResponse, MetricsConfigsListResponse, MutationExpectedUpdatedAt, NetworkError, NormalizedToolResult, OpenAuditLogRecord, PendingMessage, Project, ProjectCapabilitiesResponse, ProjectKind, ProjectRecord, ProjectRoomBotRecord, ProjectRoomClientError, ProjectRoomDispatchErrorCode, ProjectRoomDispatchResult, ProjectRoomInterruptAnswerInput, ProjectRoomMembershipRecord, ProjectRoomMessageRecord, ProjectRoomPublicBotRecord, ProjectRoomPublicMembershipRecord, ProjectRoomRecord, ProjectRoomSendResult, ProjectRoomsClient, RegisterToolOptions, RemovePendingMessageOptions, ResourcesClient, ResumeProjectRoomInterruptInput, ResumeStreamOptions, RetryConfig, RoomEventScopeRecord, RoomEventsClient, RunOptions, RuntimeAxiomClient, RuntimeAxiomIdentity, ScheduleExecutionType, ScheduledTask, ScheduledTaskStatus, ScheduledTasksListResponse, SendProjectRoomMessageInput, StorageType, StreamCallbacks, StreamEvent, TaskCommandInput, TaskCommandResponse, TaskLifecycleWarning, TaskResponse, TasksListResponse, TestConnectionResponse, TestMcpServerResponse, Thread, ThreadListResponse, ThreadResponse, Tool, ToolResponse, ToolsListResponse, Transport, UpdateAssistantOptions, UpdateProjectBotMembershipInput, UpdateProjectMembershipInput, UpdateProjectRequest, UpdateThreadOptions, UpdateWorkspaceRequest, WeChatClient, Workspace, WorkspaceClient, WorkspaceMemberRecord, WorkspaceMembersClient, WorkspaceRoomBusinessEvent, WorkspaceRoomControlEvent, WorkspaceRoomEntryRecord, WorkspaceRoomEventConnection, WorkspaceRoomEventFrame, WorkspaceRoomKnownBusinessEvent, WorkspaceRoomUnknownBusinessEvent, WorkspaceRoomsClient, createSimpleMessageMerger, normalizeToolResult };
+export { A2AKeyListItem, A2AKeysListResponse, AbortAgentParams, AbstractClient, AddProjectBotMembershipInput, AddProjectMembershipInput, AgentCron, AgentGraphTree, AgentRunStatus, AgentState, AgentWebAppsListResponse, ApiError, ArchiveInput, Assistant, AssistantListResponse, AssistantResponse, AuthenticationError, CapabilityBundleListResponse, ChatResponse, ChatSendOptions, ChatStreamOptions, Client, ClientConfig, CommandInputRespondArgs, CommandInputRespondResult, CommandRunStartArgs, CommandRunStartInput, CommandRunStartResult, CompleteTaskInput, CompleteTaskResponse, CopiedThread, CreateA2AKeyInput, CreateAssistantOptions, CreateCronInput, CreateProjectRequest, CreateStatelessCronInput, CreateThreadCronInput, CreateThreadOptions, CreateWorkspaceRequest, CronCountFilters, CronMultitaskStrategy, CronOnRunCompleted, CronSearchFilters, DatabaseConfigResponse, DatabaseConfigsListResponse, DatasourcesListResponse, ExportBundle, ExportConfigResult, ExportConfirmationRequired, ExportDownload, ExportEntityIds, ExportEntityPreview, ExportEntityPreviewMap, ExportImportClient, ExportableEntity, ExportableTypeInfo, FileItem, GatewayInfo, GetMessagesOptions, GetScheduledTasksOptions, ImportApplyResult, ImportConflict, ImportEntityResult, ImportInsertion, ImportPreviewError, ImportPreviewResult, ImportResolution, ImportResolutions, ImportSource, InvalidCapabilityBundleSummary, KeyExposure, ListAgentWebAppsParams, ListProjectRoomMessagesOptions, ListThreadsOptions, LocalA2ATemplatesListResponse, McpServerResponse, McpServersListResponse, McpUiResourceResponse, MetricsConfigResponse, MetricsConfigsListResponse, MutationExpectedUpdatedAt, NetworkError, NormalizedToolResult, OpenAuditLogRecord, PendingMessage, Project, ProjectCapabilitiesResponse, ProjectKind, ProjectRecord, ProjectRoomBotRecord, ProjectRoomClientError, ProjectRoomDispatchErrorCode, ProjectRoomDispatchResult, ProjectRoomInterruptAnswerInput, ProjectRoomMembershipRecord, ProjectRoomMessageRecord, ProjectRoomPublicBotRecord, ProjectRoomPublicMembershipRecord, ProjectRoomRecord, ProjectRoomSendResult, ProjectRoomsClient, PruneThreadInput, PruneThreadResult, RegisterToolOptions, RemovePendingMessageOptions, ResourcesClient, ResumeProjectRoomInterruptInput, ResumeStreamOptions, RetryConfig, RoomEventScopeRecord, RoomEventsClient, RunCancelOptions, RunCancelResult, RunCreateInput, RunCreateOptions, RunCreateResult, RunOptions, RunRecord, RuntimeAxiomClient, RuntimeAxiomIdentity, ScheduleExecutionType, ScheduledTask, ScheduledTaskStatus, ScheduledTasksListResponse, SendProjectRoomMessageInput, StorageType, StoreItem, StorePutInput, StoreSearchInput, StreamCallbacks, StreamEvent, SystemMetrics, SystemMetricsChunk, SystemMetricsWorker, TaskCommandInput, TaskCommandResponse, TaskLifecycleWarning, TaskResponse, TasksListResponse, TestConnectionResponse, TestMcpServerResponse, Thread, ThreadEvent, ThreadEventStreamError, ThreadEventStreamOptions, ThreadHistoryPage, ThreadListResponse, ThreadResponse, ThreadStatusInfo, ThreadSuperstepInput, Tool, ToolResponse, ToolsListResponse, Transport, UpdateAgentCronInput, UpdateAssistantOptions, UpdateProjectBotMembershipInput, UpdateProjectMembershipInput, UpdateProjectRequest, UpdateThreadOptions, UpdateWorkspaceRequest, WeChatClient, Workspace, WorkspaceClient, WorkspaceMemberRecord, WorkspaceMembersClient, WorkspaceRoomBusinessEvent, WorkspaceRoomControlEvent, WorkspaceRoomEntryRecord, WorkspaceRoomEventConnection, WorkspaceRoomEventFrame, WorkspaceRoomKnownBusinessEvent, WorkspaceRoomUnknownBusinessEvent, WorkspaceRoomsClient, createSimpleMessageMerger, normalizeToolResult };