@runtypelabs/sdk 9.17.3 → 10.1.1

package/dist/index.d.cts

@@ -1033,6 +1033,7 @@ interface paths {
                                         [key: string]: unknown;
                                     };
                                     description: string;
+                                    idempotent?: boolean;
                                     name: string;
                                     parametersSchema: {
                                         [key: string]: unknown;
@@ -1546,6 +1547,7 @@ interface paths {
                                             [key: string]: unknown;
                                         };
                                         description: string;
+                                        idempotent?: boolean;
                                         name: string;
                                         parametersSchema: {
                                             [key: string]: unknown;
@@ -2193,7 +2195,7 @@ interface paths {
                                 reflectionInterval?: number;
                                 treatLengthCutoffAsFailure?: boolean;
                             };
-                            maxTokens?: number;
+                            maxTokens?: number | null;
                             memory?: {
                                 enabled: boolean;
                                 injectSummary?: boolean;
@@ -2333,6 +2335,7 @@ interface paths {
                                         [key: string]: unknown;
                                     };
                                     description: string;
+                                    idempotent?: boolean;
                                     name: string;
                                     parametersSchema: {
                                         [key: string]: unknown;
@@ -4411,6 +4414,12 @@ interface paths {
                                 lastHeartbeatAt: string | null;
                                 /** @enum {string} */
                                 notificationMode: "none" | "narrate" | "react";
+                                /** @description What instrumentation produced an ingested run, as the OTLP ingest resolved it: the adapter a producer named itself as (`runtype.adapter.name`) and every normalizer that claimed the trace. An empty `normalizers` array states that nothing claimed it, which is what a producer already speaking canonical GenAI semantic conventions looks like. `null` means the producer was never recorded (a hosted run, or a run ingested before this was persisted) and must not be read as "identified as nothing". */
+                                otelProducer: {
+                                    adapterName?: string;
+                                    adapterVersion?: string;
+                                    normalizers?: string[];
+                                } | null;
                                 parentAgentId: string | null;
                                 parentConversationId: string | null;
                                 parentExecutionId: string | null;
@@ -4550,6 +4559,11 @@ interface paths {
                             conversationId: string | null;
                             createdAt: string;
                             executionId: string;
+                            /**
+                             * @description Which substrate actually ran this turn. `durable` means a Durable Object owned it: a Runtype session for an attached turn (the only lane that sets the `X-Runtype-Execution-Driver` response header), or the run owner a detached run is handed to. `in_process` means the request worker ran it to completion. Read back from the run's own admission-time record, so it reports what happened rather than what the current routing policy would choose now. `executionMode` cannot answer this on its own: both lanes record `attached` for an attached turn. One routing rule is worth knowing when comparing runs: `POST /v1/dispatch` keeps a request that sets `options.debugMode: true` on `in_process`.
+                             * @enum {string}
+                             */
+                            executionLane: "durable" | "in_process";
                             /** @enum {string} */
                             executionMode: "attached" | "detached";
                             expiresAt: string | null;
@@ -14390,15 +14404,6 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Documentation search is not enabled */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
                 /** @description Upstream documentation search failed */
                 502: {
                     headers: {
@@ -18369,6 +18374,11 @@ interface paths {
                             createdAt: string;
                             error?: string;
                             executionId: string;
+                            /**
+                             * @description Which substrate ran this turn: `durable` for a Durable Object (a Runtype session, or the run owner a detached run is handed to), `in_process` for the request worker. Present only for an execution with a canonical agent row; a flow handle and a Claude Managed handle omit it.
+                             * @enum {string}
+                             */
+                            executionLane?: "durable" | "in_process";
                             httpStatus?: number;
                             result?: unknown;
                             /** @enum {string} */
@@ -25151,10 +25161,14 @@ interface paths {
         get: {
             parameters: {
                 query?: {
-                    /** @description Start timestamp (ISO 8601) */
+                    /** @description Start timestamp (ISO 8601). Defaults to 24 hours ago. */
                     from?: string;
-                    /** @description End timestamp (ISO 8601) */
+                    /** @description End timestamp (ISO 8601). Defaults to now. */
                     to?: string;
+                    /** @description Alias for from. Ignored when from is also given. */
+                    startTime?: string;
+                    /** @description Alias for to. Ignored when to is also given. */
+                    endTime?: string;
                     /** @description Comma-separated log levels (debug,info,warn,error) */
                     level?: string;
                     /** @description Comma-separated categories */
@@ -25203,6 +25217,13 @@ interface paths {
                                 };
                             };
                             success: boolean;
+                            /** @description The time window the query resolved to, after defaults and from/to aliases. */
+                            window: {
+                                /** @description Resolved start timestamp the query actually used */
+                                from: string;
+                                /** @description Resolved end timestamp the query actually used */
+                                to: string;
+                            };
                         };
                     };
                 };
@@ -25414,10 +25435,14 @@ interface paths {
         get: {
             parameters: {
                 query?: {
-                    /** @description Start timestamp (ISO 8601) */
+                    /** @description Start timestamp (ISO 8601). Defaults to 24 hours ago. */
                     from?: string;
-                    /** @description End timestamp (ISO 8601) */
+                    /** @description End timestamp (ISO 8601). Defaults to now. */
                     to?: string;
+                    /** @description Alias for from. Ignored when from is also given. */
+                    startTime?: string;
+                    /** @description Alias for to. Ignored when to is also given. */
+                    endTime?: string;
                     /** @description Comma-separated log levels (debug,info,warn,error) */
                     level?: string;
                     /** @description Comma-separated categories */
@@ -25479,9 +25504,25 @@ interface paths {
                                 total: number;
                             };
                             success: boolean;
+                            /** @description The time window the query resolved to, after defaults and from/to aliases. */
+                            window: {
+                                /** @description Resolved start timestamp the query actually used */
+                                from: string;
+                                /** @description Resolved end timestamp the query actually used */
+                                to: string;
+                            };
                         };
                     };
                 };
+                /** @description Invalid request */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
                 /** @description Unauthorized */
                 401: {
                     headers: {
@@ -25553,7 +25594,7 @@ interface paths {
                     };
                     content: {
                         "application/json": {
-                            data?: unknown;
+                            data: components["schemas"]["ConversationTrace"];
                             success: boolean;
                         };
                     };
@@ -25625,7 +25666,7 @@ interface paths {
                     };
                     content: {
                         "application/json": {
-                            data?: unknown;
+                            data: components["schemas"]["TraceTree"];
                             success: boolean;
                         };
                     };
@@ -25705,6 +25746,8 @@ interface paths {
                                 status: string;
                             }[];
                             success: boolean;
+                            /** @description Present and true only when the span-store leg of this read hit its per-parent ceiling, so later children it holds are not listed. Absent otherwise. */
+                            truncated?: boolean;
                         };
                     };
                 };
@@ -30715,7 +30758,7 @@ interface paths {
         };
         /**
          * Get product activity
-         * @description First page of every activity source a product has: one entry per conversational surface (messaging conversations or client-conversation records) and one per distinct agent capability (compact executions). Rows, cursors and `hasMore` are identical to the per-source list endpoints, so a client can continue any source with its own endpoint. A source that fails returns empty rows plus an `error`; the response is still 200.
+         * @description First page of every activity source a product has: one entry per conversational surface (messaging conversations or client-conversation records) and one per distinct agent capability. Agent rows are `RunListRow`s read the way `GET /v1/runs?agentId=` reads them, so a client continues that source with `/v1/runs` and the surface sources with their own list endpoints; rows, cursors and `hasMore` match. A source that fails returns empty rows plus an `error`; the response is still 200.
          */
         get: {
             parameters: {
@@ -30742,71 +30785,105 @@ interface paths {
                                 agents: {
                                     agentId: string;
                                     data: {
+                                        /** @description Agent that ran. */
                                         agentId: string | null;
-                                        agentSource: string | null;
-                                        agentSpec?: unknown;
+                                        /** @description How the run chose its version: alias, version or legacy-live-row. Absent means the overlay did not answer, which is not false and not null. */
+                                        agentTargetResolution?: string | null;
+                                        /** @description Agent version that ran. Absent means the overlay did not answer, which is not false and not null. */
+                                        agentVersionId?: string | null;
+                                        /** @description Version label. Absent means the overlay did not answer, which is not false and not null. */
+                                        agentVersionLabel?: string | null;
+                                        /** @description Version number, for a version chip and version grouping. Absent means the overlay did not answer, which is not false and not null. */
+                                        agentVersionNumber?: number | null;
+                                        /** @description Batch this run belongs to. */
+                                        batchExecutionId: string | null;
+                                        /** @description Budget exhausted. Absent means the overlay did not answer, which is not false and not null. */
+                                        budgetExhausted?: boolean | null;
+                                        /** @description Cancel request. Absent means the overlay did not answer, which is not false and not null. */
+                                        cancelRequestedAt?: string | null;
                                         /**
-                                         * @description How the run selected its definition: `alias` or `version` for a request that named a selector, `legacy-live-row` for a run that read the mutable agent row.
-                                         * @enum {string}
+                                         * @description Storage completeness; null on a row the control-plane arm served.
+                                         * @enum {string|null}
                                          */
-                                        agentTargetResolution: "alias" | "version" | "legacy-live-row";
-                                        /** @description Version number and label for `agentVersionId`, joined from `agent_versions`. `null` exactly when `agentVersionId` is `null`. */
-                                        agentVersion: {
-                                            id: string;
-                                            label: string | null;
-                                            versionNumber: number;
-                                        } | null;
-                                        /** @description The `agent_versions` row this run was recorded against, or `null`. `null` means the surface that admitted the run stamps no version (A2A, Product API, A2A pause admission and the Product MCP capability path record none today) or the run predates version stamping. It is never a claim that the run executed an unversioned configuration. */
-                                        agentVersionId: string | null;
-                                        /** @description Whether the agent loop ended by exhausting its `maxTurns` budget. Read this rather than inferring truncation from `stopReason`: a single-turn loop publishes `end_turn` on a budget end to preserve its original payload shape, and several clean success paths publish that same value. `null` means UNKNOWN — a run recorded before this field existed, or one executed by a lane that reports no per-iteration breakdown (external agents, Claude Managed) — and must not be read as `false`. */
-                                        budgetExhausted: boolean | null;
-                                        cancelRequestedAt: string | null;
-                                        completedAt: string | null;
-                                        /** @description The conversation thread this run belongs to, so consumers can group a multi-turn conversation's runs without a per-run log query. This is the run's OWN thread, distinct from `parentConversationId` (subagent lineage, the conversation of the run that spawned it). `null` on stateless surfaces (webhook, schedule, eval, one-shot API) and on runs persisted before the column existed. */
+                                        completeness: "partial" | "complete" | "conflicted" | "expired" | "deleted" | null;
+                                        /** @description Conversation this run belongs to. */
                                         conversationId: string | null;
-                                        createdAt: string;
+                                        /** @description Wall-clock duration in milliseconds. */
+                                        durationMs: number | null;
+                                        /** @description ISO instant the run ended; null while it is still running. */
+                                        endedAt: string | null;
+                                        /** @description Runtime execution id; the key for /v1/logs and /v1/runs/{id}. */
                                         executionId: string;
-                                        /** @enum {string} */
-                                        executionMode: "attached" | "detached";
-                                        expiresAt: string | null;
-                                        /** @description The run's final output. Present by default; omitted when `view=compact`. */
-                                        finalOutput?: unknown;
-                                        id: string;
+                                        /** @description Budget expiry. Absent means the overlay did not answer, which is not false and not null. */
+                                        expiresAt?: string | null;
+                                        /** @description Fidelity of the projection behind this row. */
+                                        fidelityTier: string | null;
+                                        /** @description Flow that ran. */
+                                        flowId: string | null;
+                                        /** @description Messages the run started from. Absent means the overlay did not answer, which is not false and not null. */
                                         inputMessages?: unknown;
-                                        iterations: number | null;
-                                        lastHeartbeatAt: string | null;
-                                        /** @enum {string} */
-                                        notificationMode: "none" | "narrate" | "react";
-                                        parentAgentId: string | null;
-                                        parentConversationId: string | null;
+                                        /** @description Input tokens reported. */
+                                        inputTokens: number | null;
+                                        /** @description Loop iterations from the terminal frame. */
+                                        iterations?: number | null;
+                                        /**
+                                         * @description Whether an agent or a flow ran.
+                                         * @enum {string}
+                                         */
+                                        kind: "agent" | "flow";
+                                        /** @description Last heartbeat. Absent means the overlay did not answer, which is not false and not null. */
+                                        lastHeartbeatAt?: string | null;
+                                        /** @description Framework identity the producer reported, for a versionless run group. Absent means the overlay did not answer, which is not false and not null. */
+                                        otelProducer?: unknown;
+                                        /** @description Output tokens reported. */
+                                        outputTokens: number | null;
+                                        /** @description Run that spawned this one. */
                                         parentExecutionId: string | null;
+                                        /** @description Parent's tool call that spawned this run. */
                                         parentToolCallId: string | null;
-                                        pendingApproval: {
-                                            approvalId: string;
-                                            description?: string;
-                                            parameters?: unknown;
-                                            reason?: string;
-                                            requestedAt: string;
-                                            timeout?: number;
-                                            toolCallId: string;
-                                            toolName: string;
-                                            toolType: string;
-                                        } | null;
+                                        /** @description Approval awaiting a human. Absent means the overlay did not answer, which is not false and not null. */
+                                        pendingApproval?: unknown;
+                                        /** @description Live progress document. Absent means the overlay did not answer, which is not false and not null. */
                                         progress?: unknown;
-                                        retryOfExecutionId: string | null;
+                                        /** @description Record this run processed. */
+                                        recordId: string | null;
+                                        /** @description Retention removed the spans; the run still lists and reads as completed. */
+                                        retentionElided?: boolean;
+                                        /** @description Outermost run of the tree. */
                                         rootExecutionId: string | null;
-                                        startedAt: string | null;
-                                        /** @enum {string} */
-                                        status: "queued" | "running" | "paused" | "completed" | "failed" | "cancelled" | "interrupted";
-                                        stopReason: string | null;
+                                        /** @description Cost the producer reported. */
+                                        selfReportedCost: string | null;
+                                        /**
+                                         * @description hosted, or ingested for an OTLP export. An ingested run is never reported running.
+                                         * @enum {string}
+                                         */
+                                        source: "hosted" | "ingested";
+                                        /** @description Spans the projection wrote. */
+                                        spanCount: number | null;
+                                        /** @description ISO instant the run started. */
+                                        startedAt: string;
+                                        /**
+                                         * @description Customer-facing status, derived by runStatusFrom.
+                                         * @enum {string}
+                                         */
+                                        status: "queued" | "running" | "awaiting" | "completed" | "failed" | "cancelled";
+                                        /** @description Stop reason from the terminal frame. */
+                                        stopReason?: string | null;
+                                        /** @description Product surface that entered this run. */
+                                        surfaceId: string | null;
+                                        /** @description Surface family (api, chat, webhook, schedule, ...). */
                                         surfaceType: string | null;
+                                        /** @description True when the run was dispatched with storeResults: false, so it has no control-plane row and no overlay. NULL means the header states nothing about it, which is not false: headers written before this field shipped, and lanes that take no such flag, carry no dispatch stamp and are never backfilled. */
+                                        test: boolean | null;
+                                        /** @description Metered cost as a decimal string. */
                                         totalCost: string | null;
-                                        totalTokens?: unknown;
+                                        /** @description Trace id in the span store; null on a row the control-plane arm served. */
+                                        traceId: string | null;
                                     }[];
                                     error?: {
                                         message: string;
                                     };
-                                    pagination: components["schemas"]["Pagination"];
+                                    pagination: components["schemas"]["RunListPagination"];
                                 }[];
                                 surfaces: {
                                     data: (({
@@ -39955,6 +40032,233 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/runs": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List runs
+         * @description Every agent and flow run in the span store, newest start first. A run dispatched with `storeResults: false` is listed with `test: true` rather than being invisible. `overlay=live` adds live control-plane fields; the overlay never adds, drops or reorders a row. Returns 404 when run reads are not enabled for the organization.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Filter by agent id; repeat for a set. */
+                    agentId?: string | string[];
+                    /** @description Filter by flow id; repeat for a set. */
+                    flowId?: string | string[];
+                    /** @description Filter by conversation id. */
+                    conversationId?: string;
+                    /** @description Filter by surface id. */
+                    surfaceId?: string;
+                    /** @description Filter by surface family. */
+                    surfaceType?: string;
+                    /** @description Filter by record id. */
+                    recordId?: string;
+                    /** @description Filter by batch id; repeat for a set. */
+                    batchExecutionId?: string | string[];
+                    /** @description Runs spawned by this execution. */
+                    parentExecutionId?: string;
+                    /** @description Runs in this execution tree. */
+                    rootExecutionId?: string;
+                    /** @description Read specific runs by id; at most 100 per request. */
+                    executionId?: string | string[];
+                    /** @description Filter by producing lane. */
+                    source?: "hosted" | "ingested";
+                    /** @description status accepts only running, completed or failed. queued, awaiting and cancelled exist only in the live overlay, which may never change which rows a page holds, so the server cannot filter on them. */
+                    status?: "running" | "completed" | "failed";
+                    /** @description Window start (ISO 8601). Defaults to 24 hours ago. */
+                    from?: string;
+                    /** @description Window end (ISO 8601). Defaults to now. */
+                    to?: string;
+                    /** @description full (the default) returns every field. compact omits exactly these 14: stopReason, iterations, agentVersionId, agentVersionLabel, agentVersionNumber, agentTargetResolution, otelProducer, lastHeartbeatAt, expiresAt, cancelRequestedAt, progress, pendingApproval, budgetExhausted and inputMessages. The status is still overlay-corrected on a compact page; only the fields differ. */
+                    view?: "compact" | "full";
+                    /** @description live adds control-plane fields; defaults to live for a session, none for an API key. */
+                    overlay?: "live" | "none";
+                    /** @description Page size, at most 100. */
+                    limit?: string;
+                    /** @description Keyset cursor from a previous page. */
+                    cursor?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Runs returned */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["RunListRow"][];
+                            pagination: {
+                                hasMore: boolean;
+                                hasPrev: boolean;
+                                limit: number;
+                                nextCursor: string | null;
+                            };
+                            /** @description The started_at window the query resolved to, after defaults. */
+                            window: {
+                                from: string;
+                                to: string;
+                            };
+                        };
+                    };
+                };
+                /** @description Invalid request, including a filter whose value could not be read */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Insufficient API key permissions */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Run reads are not enabled for this organization */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/runs/{executionId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Read one run
+         * @description One run the caller owns, in the row shape the list returns. An API key must hold the scope of the run's own execution kind (AGENTS:READ or FLOWS:READ, and both when the run states neither). Use `GET /v1/logs/trace/execution/{id}` for its span tree.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description live adds control-plane fields; defaults to live for a session, none for an API key. */
+                    overlay?: "live" | "none";
+                    /** @description full (the default) returns every field. compact omits exactly these 14: stopReason, iterations, agentVersionId, agentVersionLabel, agentVersionNumber, agentTargetResolution, otelProducer, lastHeartbeatAt, expiresAt, cancelRequestedAt, progress, pendingApproval, budgetExhausted and inputMessages. The status is still overlay-corrected on a compact page; only the fields differ. */
+                    view?: "compact" | "full";
+                };
+                header?: never;
+                path: {
+                    executionId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Run returned */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["RunListRow"];
+                        };
+                    };
+                };
+                /** @description Invalid request, including a filter whose value could not be read */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Insufficient API key permissions */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Run not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/runtime/crawl": {
         parameters: {
             query?: never;
@@ -41914,6 +42218,7 @@ interface paths {
                                 flowId: string | null;
                                 id: string;
                                 processedRecords: number | null;
+                                run: components["schemas"]["ScheduleRunLink"];
                                 scheduleId: string;
                                 startedAt: string | null;
                                 status: string;
@@ -42654,6 +42959,7 @@ interface paths {
                                 flowId: string | null;
                                 id: string;
                                 processedRecords: number | null;
+                                run: components["schemas"]["ScheduleRunLink"];
                                 scheduleId: string;
                                 startedAt: string | null;
                                 status: string;
@@ -45700,6 +46006,7 @@ interface paths {
                             updatedAt: string;
                             userId: string | null;
                             validation?: {
+                                recommendations?: components["schemas"]["FlowValidationIssue"][];
                                 warnings: {
                                     code: string;
                                     column?: number;
@@ -46198,6 +46505,7 @@ interface paths {
                             updatedAt: string;
                             userId: string | null;
                             validation?: {
+                                recommendations?: components["schemas"]["FlowValidationIssue"][];
                                 warnings: {
                                     code: string;
                                     column?: number;
@@ -47011,6 +47319,7 @@ interface paths {
                             updatedAt: string;
                             userId: string | null;
                             validation?: {
+                                recommendations?: components["schemas"]["FlowValidationIssue"][];
                                 warnings: {
                                     code: string;
                                     column?: number;
@@ -48539,6 +48848,7 @@ interface components {
                                 [key: string]: unknown;
                             };
                             description: string;
+                            idempotent?: boolean;
                             name: string;
                             parametersSchema: {
                                 [key: string]: unknown;
@@ -48776,6 +49086,22 @@ interface components {
             /** @description The system the transcript came from, for example "intercom" or "custom". */
             system: string;
         };
+        ConversationTrace: {
+            conversationId: string;
+            executions: {
+                executionId: string;
+                timestamp: string;
+                tree: components["schemas"]["TraceTree"];
+            }[];
+            producedBy?: components["schemas"]["TraceProducedBy"] & unknown;
+            totalExecutions: number;
+            truncation?: {
+                limit: number;
+                message: string;
+                /** @enum {string} */
+                reason: "record_limit";
+            };
+        };
         ConversationTranscriptMessage: {
             author?: components["schemas"]["ConversationMessageAuthor"];
             /** @description Plain string, or an array of {type:"text"|"image"|"file"|"reasoning"|"asset_ref"} parts. */
@@ -49349,6 +49675,11 @@ interface components {
                  * @enum {string|null}
                  */
                 executionEngine?: "runtime" | "legacy" | "external" | null;
+                /**
+                 * @description Present when the failure belongs to the platform, not the target: the model gateway went silent and the stall watchdog gave up before the target could answer. Such a case runs no graders (its outcomes are empty) and is excluded from the suite score. Absent on an ordinary failure.
+                 * @enum {string}
+                 */
+                failureKind?: "platform_stall";
                 name: string;
                 /** @description For a checkpoint ("saved from run") case run in next-step mode: the tool-call intent(s) the target emitted as its graded next step. An empty array means it replied with a message instead of calling a tool. Null for ordinary runs and for runs recorded before this field shipped. */
                 nextStepToolCalls: {
@@ -49397,9 +49728,11 @@ interface components {
             /** @description The eval name recorded on the run. */
             name: string | null;
             passedCases: number;
+            /** @description Cases the platform aborted before the target could answer. They run no graders and are counted in neither half of score, so totalCases minus this is the denominator score was taken over. */
+            platformAbortedCases: number;
             /** @description The run (batch execution) id these scores belong to. */
             runId: string;
-            /** @description Suite score, 0..1 (passed cases / total cases); null when the run has no cases. */
+            /** @description Suite score, 0..1 (passed cases / graded cases). Platform-aborted cases are excluded from both halves; null when the run graded no cases. */
             score: number | null;
             /** @description The severity semantics the run was graded with (and that these verdicts reproduce): true when a soft grader miss failed its case. */
             strict: boolean;
@@ -49478,6 +49811,8 @@ interface components {
         EvalSuiteLatestRun: {
             completedAt: string | null;
             passedCases: number | null;
+            /** @description Cases the platform aborted before the target could answer. They run no graders and are counted in neither half of score, so totalCases minus this is the denominator score was taken over. */
+            platformAbortedCases: number | null;
             runId: string;
             /** @description Suite score of the run, 0..1; null while unscored (in flight / unscoreable). */
             score: number | null;
@@ -49685,6 +50020,52 @@ interface components {
             };
             /** @enum {string} */
             type: "turn_complete";
+        } | {
+            executionId: string;
+            id: string;
+            iteration?: number;
+            model?: string;
+            ordinal: number;
+            provider?: string;
+            seq: number;
+            startedAt?: string;
+            stepId?: string;
+            subagent?: {
+                agentName?: string;
+                parentToolCallId?: string;
+                toolName: string;
+            };
+            turnId?: string;
+            /** @enum {string} */
+            type: "model_call_start";
+        } | {
+            completedAt?: string;
+            cost?: number;
+            durationMs?: number;
+            executionId: string;
+            finishReason?: string;
+            id: string;
+            iteration?: number;
+            model?: string;
+            ordinal: number;
+            provider?: string;
+            responseModel?: string;
+            seq: number;
+            subagent?: {
+                agentName?: string;
+                parentToolCallId?: string;
+                toolName: string;
+            };
+            success?: boolean;
+            tokens?: {
+                cacheRead?: number;
+                cacheWrite?: number;
+                input: number;
+                output: number;
+            };
+            turnId?: string;
+            /** @enum {string} */
+            type: "model_call_complete";
         } | {
             executionId: string;
             id: string;
@@ -50477,6 +50858,11 @@ interface components {
                 /** @description Why the case errored (the provider or execution failure text, 2000 chars max). Present only when errored is true and the run reported a cause. */
                 error?: string;
                 errored: boolean;
+                /**
+                 * @description Present when the failure belongs to the platform, not the target: the model gateway went silent and the stall watchdog gave up before the target could answer. Such a case runs no graders and is excluded from the suite score. Absent on an ordinary failure.
+                 * @enum {string}
+                 */
+                failureKind?: "platform_stall";
                 name: string;
                 outcomes: {
                     /** @description AI graders only: transcript entries the verdict rests on — indices into the run's trace steps (message) or tool calls (tool_call). */
@@ -50510,15 +50896,119 @@ interface components {
             /** @description True when every case passed every grader. */
             passed: boolean;
             passedCases: number;
+            /** @description Cases the platform aborted before the target could answer. They run no graders and are counted in neither half of score, so totalCases minus this is the denominator score was taken over. */
+            platformAbortedCases: number;
             /** @description The persisted run id — query its scores via GET /eval/runs/{runId}/scores. Null for an ephemeral (virtual/inline) run. */
             runId: string | null;
-            /** @description Suite score, 0..1 (passed cases / total cases). */
+            /** @description Suite score, 0..1 (passed cases / graded cases). Platform-aborted cases are excluded from both halves. */
             score: number;
             suiteId: string | null;
             /** @enum {string} */
             targetType: "flow" | "agent";
             totalCases: number;
         };
+        RunListPagination: {
+            hasMore: boolean;
+            hasPrev: boolean;
+            limit: number;
+            nextCursor: string | null;
+        };
+        RunListRow: {
+            /** @description Agent that ran. */
+            agentId: string | null;
+            /** @description How the run chose its version: alias, version or legacy-live-row. Absent means the overlay did not answer, which is not false and not null. */
+            agentTargetResolution?: string | null;
+            /** @description Agent version that ran. Absent means the overlay did not answer, which is not false and not null. */
+            agentVersionId?: string | null;
+            /** @description Version label. Absent means the overlay did not answer, which is not false and not null. */
+            agentVersionLabel?: string | null;
+            /** @description Version number, for a version chip and version grouping. Absent means the overlay did not answer, which is not false and not null. */
+            agentVersionNumber?: number | null;
+            /** @description Batch this run belongs to. */
+            batchExecutionId: string | null;
+            /** @description Budget exhausted. Absent means the overlay did not answer, which is not false and not null. */
+            budgetExhausted?: boolean | null;
+            /** @description Cancel request. Absent means the overlay did not answer, which is not false and not null. */
+            cancelRequestedAt?: string | null;
+            /**
+             * @description Storage completeness; null on a row the control-plane arm served.
+             * @enum {string|null}
+             */
+            completeness: "partial" | "complete" | "conflicted" | "expired" | "deleted" | null;
+            /** @description Conversation this run belongs to. */
+            conversationId: string | null;
+            /** @description Wall-clock duration in milliseconds. */
+            durationMs: number | null;
+            /** @description ISO instant the run ended; null while it is still running. */
+            endedAt: string | null;
+            /** @description Runtime execution id; the key for /v1/logs and /v1/runs/{id}. */
+            executionId: string;
+            /** @description Budget expiry. Absent means the overlay did not answer, which is not false and not null. */
+            expiresAt?: string | null;
+            /** @description Fidelity of the projection behind this row. */
+            fidelityTier: string | null;
+            /** @description Flow that ran. */
+            flowId: string | null;
+            /** @description Messages the run started from. Absent means the overlay did not answer, which is not false and not null. */
+            inputMessages?: unknown;
+            /** @description Input tokens reported. */
+            inputTokens: number | null;
+            /** @description Loop iterations from the terminal frame. */
+            iterations?: number | null;
+            /**
+             * @description Whether an agent or a flow ran.
+             * @enum {string}
+             */
+            kind: "agent" | "flow";
+            /** @description Last heartbeat. Absent means the overlay did not answer, which is not false and not null. */
+            lastHeartbeatAt?: string | null;
+            /** @description Framework identity the producer reported, for a versionless run group. Absent means the overlay did not answer, which is not false and not null. */
+            otelProducer?: unknown;
+            /** @description Output tokens reported. */
+            outputTokens: number | null;
+            /** @description Run that spawned this one. */
+            parentExecutionId: string | null;
+            /** @description Parent's tool call that spawned this run. */
+            parentToolCallId: string | null;
+            /** @description Approval awaiting a human. Absent means the overlay did not answer, which is not false and not null. */
+            pendingApproval?: unknown;
+            /** @description Live progress document. Absent means the overlay did not answer, which is not false and not null. */
+            progress?: unknown;
+            /** @description Record this run processed. */
+            recordId: string | null;
+            /** @description Retention removed the spans; the run still lists and reads as completed. */
+            retentionElided?: boolean;
+            /** @description Outermost run of the tree. */
+            rootExecutionId: string | null;
+            /** @description Cost the producer reported. */
+            selfReportedCost: string | null;
+            /**
+             * @description hosted, or ingested for an OTLP export. An ingested run is never reported running.
+             * @enum {string}
+             */
+            source: "hosted" | "ingested";
+            /** @description Spans the projection wrote. */
+            spanCount: number | null;
+            /** @description ISO instant the run started. */
+            startedAt: string;
+            /**
+             * @description Customer-facing status, derived by runStatusFrom.
+             * @enum {string}
+             */
+            status: "queued" | "running" | "awaiting" | "completed" | "failed" | "cancelled";
+            /** @description Stop reason from the terminal frame. */
+            stopReason?: string | null;
+            /** @description Product surface that entered this run. */
+            surfaceId: string | null;
+            /** @description Surface family (api, chat, webhook, schedule, ...). */
+            surfaceType: string | null;
+            /** @description True when the run was dispatched with storeResults: false, so it has no control-plane row and no overlay. NULL means the header states nothing about it, which is not false: headers written before this field shipped, and lanes that take no such flag, carry no dispatch stamp and are never backfilled. */
+            test: boolean | null;
+            /** @description Metered cost as a decimal string. */
+            totalCost: string | null;
+            /** @description Trace id in the span store; null on a row the control-plane arm served. */
+            traceId: string | null;
+        };
         RuntimeEmailAdmissionError: {
             code?: string;
             error: string;
@@ -50562,6 +51052,19 @@ interface components {
             /** @description Dashboard-relative URL to the billing/upgrade page. */
             upgradeUrl?: string;
         };
+        ScheduleRunLink: {
+            /** @description The agent_executions ROW id the scheduled run stored. Provenance only: a different id space from executionId, and never a /v1/runs key. */
+            agentExecutionRowId: string | null;
+            /** @description The batch whose per-record runs are GET /v1/runs?batchExecutionId=. */
+            batchExecutionId: string | null;
+            /** @description The RUNTIME execution id, which is what GET /v1/runs/{executionId} keys on. Null unless kind is run. */
+            executionId: string | null;
+            /**
+             * @description run: one execution, readable at GET /v1/runs/{executionId}. records: a batch, whose per-record runs are GET /v1/runs?batchExecutionId=. none: no readable run was recorded for this scheduled run.
+             * @enum {string}
+             */
+            kind: "run" | "records" | "none";
+        };
         SkillEnsureConflict: {
             /** @enum {string} */
             code: "external_modification" | "remote_changed";
@@ -50750,6 +51253,183 @@ interface components {
             toolId: string;
             updatedAt: string | null;
         };
+        TraceLogEntry: {
+            agentId?: string | null;
+            agentName?: string | null;
+            batchExecutionId?: string | null;
+            cacheReadTokens?: number | null;
+            cacheWriteTokens?: number | null;
+            completionTokens?: number | null;
+            configuredModel?: string | null;
+            conversationId?: string | null;
+            description?: string;
+            durationMs?: number | null;
+            error?: string | null;
+            errorStack?: string | null;
+            estimatedContextBreakdown?: ({
+                categories: {
+                    [key: string]: {
+                        chars: number;
+                        estimatedTokens: number;
+                    } & {
+                        [key: string]: unknown;
+                    };
+                };
+                contextWindowSize?: number;
+                estimatedTotalTokens: number;
+                estimatedUtilizationPercent?: number;
+            } & {
+                [key: string]: unknown;
+            }) | null;
+            /** @description Observed cost. Absent or null means unknown, never zero. */
+            estimatedCost?: number | string | null;
+            eventName?: string | null;
+            executionSessionId?: string | null;
+            fallbackModel?: string | null;
+            flowId?: string | null;
+            flowName?: string | null;
+            id: string;
+            /** @description Arbitrary JSON; shape varies by producer. */
+            input?: unknown;
+            inputSummary?: string | null;
+            isStreaming?: boolean;
+            iteration?: number | null;
+            /** @enum {string} */
+            level: "debug" | "info" | "warn" | "error";
+            /** @enum {string|null} */
+            loggingPolicy?: "off" | null;
+            /** @description Producer bag. Span-store reads carry spanKind, completeness, logicalParentId, otlpAttributes, otlpSpanEvents, systemInstructions, artifacts and state here. */
+            metadata?: {
+                [key: string]: unknown;
+            };
+            modelUsed?: string | null;
+            /** @enum {string} */
+            otlpIncompleteActivity?: "invoke_agent" | "chat" | "execute_tool";
+            /** @enum {string} */
+            otlpInstrumentationWarning?: "span_not_ended";
+            otlpOperationName?: string | null;
+            otlpParentSpanId?: string | null;
+            otlpRecordHash?: string | null;
+            /** @enum {string|null} */
+            otlpRecordKind?: "span" | "span_event" | "log_record" | null;
+            otlpRetentionScope?: string | null;
+            otlpSpanEventIndex?: number | null;
+            otlpSpanId?: string | null;
+            /** @description Arbitrary JSON; shape varies by producer. */
+            output?: unknown;
+            outputSummary?: string | null;
+            promptTokens?: number | null;
+            providerErrorClass?: string | null;
+            providerHost?: string | null;
+            providerHttpMethod?: string | null;
+            providerHttpStatus?: number | null;
+            providerRateLimitHeaders?: {
+                [key: string]: string;
+            } | null;
+            recordId?: string | null;
+            recordName?: string | null;
+            requestId?: string | null;
+            resolvedModel?: string | null;
+            seq?: number;
+            /** @enum {string} */
+            status: "running" | "completed" | "failed" | "queued" | "cancelled" | "unknown";
+            stepId?: string | null;
+            stepName?: string | null;
+            stepType?: string | null;
+            stopReason?: string | null;
+            streamContent?: string;
+            subtitle?: string;
+            surfaceId?: string | null;
+            surfaceType?: string | null;
+            timestamp: string;
+            title: string;
+            toolCallId?: string | null;
+            toolName?: string | null;
+            toolType?: string | null;
+            totalTokens?: number | null;
+            turnId?: string | null;
+            /** @enum {string} */
+            type: "flow" | "step" | "tool" | "batch" | "system" | "agent" | "model" | "schedule" | "audit";
+            usedFallback?: boolean | null;
+        } & {
+            [key: string]: unknown;
+        };
+        TraceNode: {
+            childExecutionId?: string | null;
+            children: components["schemas"]["TraceNode"][];
+            depth: number;
+            endOffsetMs?: number | null;
+            endedAt?: string | null;
+            entry: components["schemas"]["TraceLogEntry"];
+            failed?: boolean;
+            /** @enum {string} */
+            lifecycle?: "single" | "paired" | "start-only" | "complete-only";
+            /** @enum {string} */
+            nodeType: "root" | "iteration" | "model" | "tool" | "step" | "system";
+            recorded?: boolean;
+            startEntry?: components["schemas"]["TraceLogEntry"];
+            startOffsetMs?: number | null;
+            startedAt?: string | null;
+            synthetic?: boolean;
+        };
+        TraceProducedBy: {
+            adapterName?: string | null;
+            adapterVersion?: string | null;
+            agentId?: string | null;
+            agentName?: string | null;
+            agentVersionId?: string | null;
+            agentVersionLabel?: string | null;
+            callable?: boolean;
+            fidelityTier?: string | null;
+            flowId?: string | null;
+            flowName?: string | null;
+            flowVersionId?: string | null;
+            productId?: string | null;
+            productName?: string | null;
+            /** @enum {string} */
+            source: "native" | "external";
+            surfaceType?: string | null;
+        };
+        TraceTree: {
+            availability?: {
+                /** @enum {boolean} */
+                available: false;
+                message: string;
+                /** @enum {string} */
+                reason: "json_ingest_compatibility_path";
+            };
+            /** @description Present only when the child-run read hit its per-parent ceiling, so later child runs are not grafted and their tool-call spans carry no `childExecutionId`. Absent otherwise. */
+            childTruncation?: {
+                limit: number;
+                message: string;
+                /** @enum {string} */
+                reason: "child_limit";
+            };
+            /** @description A span with spilled content could not be read back; those spans carry previews. */
+            contentUnavailable?: boolean;
+            failedCount?: number;
+            nodeCount: number;
+            producedBy?: components["schemas"]["TraceProducedBy"];
+            root: components["schemas"]["TraceNode"] | null;
+            /** @description The run itself failed, as opposed to a span inside a run that completed. */
+            runFailed?: boolean;
+            /** @enum {string} */
+            source?: "logs" | "records" | "logs+records";
+            startedAt?: string | null;
+            toolTimeMs?: number | null;
+            toolTimeOverlapped?: boolean;
+            totalCost: number | null;
+            totalDuration: number | null;
+            totalTokens: number | null;
+            /** @enum {string} */
+            totalsSource?: "execution" | "partial";
+            truncation?: {
+                limit: number;
+                message: string;
+                /** @enum {string} */
+                reason: "record_limit";
+            };
+        };
         UpdateUserProfileResponse: {
             email?: string;
             firstName?: string;
@@ -50875,6 +51555,7 @@ interface operations {
                         /** @enum {string} */
                         status: "idle" | "observing" | "degraded" | "queryable";
                         tiers: {
+                            /** @description Deprecated: the canonical storage tier is retired and every field is permanently zero. It is emitted only so already-published SDKs, which model it as required, keep parsing; it is removed in a following release. */
                             canonical: {
                                 confirmed: number;
                                 maximumConfirmedLagMs: number | null;
@@ -50914,6 +51595,7 @@ interface operations {
                             /** @description Receipt counts for this trace only; confirmations require positive tier reads, not stream acknowledgments. */
                             delivery: {
                                 accepted: number;
+                                /** @description Deprecated: the canonical storage tier is retired and every field is permanently zero. It is emitted only so already-published SDKs, which model it as required, keep parsing; it is removed in a following release. */
                                 canonicalConfirmed: number;
                                 complete: number;
                                 hotConfirmed: number;
@@ -52415,6 +53097,7 @@ declare function createExternalTool(config: {
     method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
     headers?: Record<string, string>;
     body?: string;
+    idempotent?: boolean;
 }): RuntimeTool;
 
 type JsonPrimitive = string | number | boolean | null;
@@ -52485,6 +53168,8 @@ interface ApiKey {
     name: string;
     keyPrefix: string;
     searchHint?: string;
+    /** Owning organization, fixed at mint together with the owning user. Present on create, get and list. */
+    organizationId?: string;
     permissions: string[];
     isActive: boolean;
     expiresAt?: string;
@@ -53211,6 +53896,12 @@ interface RuntimeTool {
     toolType: 'flow' | 'custom' | 'external' | 'local' | 'subagent';
     parametersSchema: JSONSchema;
     config?: RuntimeToolConfig;
+    /**
+     * Safe for a resumed durable turn to dispatch a second time. Absent means
+     * not safe: an interrupted call is repaired into an errored result the model
+     * re-decides, rather than silently re-fired.
+     */
+    idempotent?: boolean;
 }
 type RuntimeToolConfig = RuntimeFlowToolConfig | RuntimeCustomToolConfig | RuntimeExternalToolConfig | RuntimeLocalToolConfig | RuntimeSubagentToolConfig;
 interface RuntimeLocalToolConfig {
@@ -53516,10 +54207,17 @@ interface LogQueryResult {
     /** True when historical (R2 SQL) logs were unavailable and only recent hot-tier entries are included. */
     degraded?: boolean;
 }
+/** The `from`/`to` the API resolved for a logs query, after defaults and aliases. */
+interface LogSearchedWindow {
+    from: string;
+    to: string;
+}
 /** Logs are wrapped in a `{ success, data }` envelope by the API. */
 interface LogQueryResponse {
     success: boolean;
     data: LogQueryResult;
+    /** The window the query actually ran over. An empty list names its own range. */
+    window: LogSearchedWindow;
     _debug?: unknown;
 }
 interface LogStatsResult {
@@ -53540,11 +54238,19 @@ interface LogStatsResponse {
     success: boolean;
     data: LogStatsResult;
     cachedAt?: string | null;
+    /** The window the query actually ran over, so `cachedAt` never speaks for another range. */
+    window: LogSearchedWindow;
     _debug?: unknown;
 }
 interface LogQueryParams {
+    /** Start timestamp (ISO 8601). Defaults to 24 hours ago. */
     from?: string;
+    /** End timestamp (ISO 8601). Defaults to now. */
     to?: string;
+    /** Alias for {@link LogQueryParams.from}, ignored when `from` is also set. */
+    startTime?: string;
+    /** Alias for {@link LogQueryParams.to}, ignored when `to` is also set. */
+    endTime?: string;
     /** Comma-separated levels (debug,info,warn,error). */
     level?: string;
     /** Comma-separated categories (execution,agent,tool,model,system,error). */
@@ -54379,6 +55085,12 @@ interface RunEvalCaseResult {
     errored: boolean;
     /** Why the case errored (provider or execution failure text); present only when `errored` is true and a cause was reported. */
     error?: string;
+    /**
+     * Present when the failure belongs to the platform, not the target: the model
+     * gateway went silent and the stall watchdog gave up before the target could
+     * answer. Such a case runs no graders and is excluded from the suite score.
+     */
+    failureKind?: 'platform_stall';
 }
 /**
  * Pin an Agent-target run to one version. Supply at most one of `alias` or
@@ -54416,12 +55128,18 @@ interface RunEvalResult extends EvalRunEvidence {
      * or `null` for an ephemeral (virtual/inline) run.
      */
     runId: string | null;
-    /** Suite score, 0..1 (passed cases / total cases). */
+    /** Suite score, 0..1 (passed cases / graded cases; platform-aborted cases are excluded). */
     score: number;
     /** True when every case passed every grader. */
     passed: boolean;
     totalCases: number;
     passedCases: number;
+    /**
+     * Cases the platform aborted before the target could answer. They run no
+     * graders and count in neither half of `score`, so `totalCases` minus this is
+     * the denominator `score` was taken over.
+     */
+    platformAbortedCases: number;
     cases: RunEvalCaseResult[];
 }
 /**
@@ -54459,6 +55177,12 @@ interface EvalRunCaseScores {
      * calling a tool. Null for ordinary runs and pre-feature rows.
      */
     nextStepToolCalls: NextStepToolCall[] | null;
+    /**
+     * Present when the platform aborted the case before the target could answer
+     * (the model gateway went silent and the stall watchdog gave up). Such a case
+     * has no outcomes and is excluded from the run's score.
+     */
+    failureKind?: 'platform_stall';
 }
 /** Persisted per-case grader scores for a run (`client.evals.getRunScores`). */
 interface EvalRunScores extends EvalRunEvidence {
@@ -54469,10 +55193,19 @@ interface EvalRunScores extends EvalRunEvidence {
     name: string | null;
     /** The severity semantics the run was graded with (soft misses fail when true). */
     strict: boolean;
-    /** Suite score, 0..1; null when the run has no persisted scores. */
+    /**
+     * Suite score, 0..1 (passed cases / graded cases; platform-aborted cases are
+     * excluded from both halves); null when the run graded no cases.
+     */
     score: number | null;
     totalCases: number;
     passedCases: number;
+    /**
+     * Cases the platform aborted before the target could answer. They run no
+     * graders and count in neither half of `score`, so `totalCases` minus this is
+     * the denominator `score` was taken over.
+     */
+    platformAbortedCases: number;
     cases: EvalRunCaseScores[];
 }
 /**
@@ -55194,6 +55927,12 @@ interface EvalSuiteLatestRun {
     score: number | null;
     totalCases: number | null;
     passedCases: number | null;
+    /**
+     * Cases the platform aborted before the target could answer. They run no
+     * graders and count in neither half of `score`, so `totalCases` minus this is
+     * the denominator `score` was taken over.
+     */
+    platformAbortedCases: number | null;
 }
 /** A suite as returned by list/update (no cases). */
 interface EvalSuiteSummary {
@@ -57125,6 +57864,111 @@ declare class ExecutionsNamespace {
     getStatus(executionId: string): Promise<AsyncExecutionStatus>;
 }
 
+/**
+ * One run, as `GET /v1/runs` returns it. A local copy of `RunListRow` from
+ * `@runtypelabs/shared`: this package is published to npm and its source runs
+ * directly from the staging smoke lane, where a workspace specifier does not
+ * resolve. Pinned against the shared schema in `marathon-shared-parity.test.ts`.
+ */
+interface RunListRow {
+    executionId: string;
+    traceId: string | null;
+    startedAt: string;
+    endedAt: string | null;
+    durationMs: number | null;
+    status: 'queued' | 'running' | 'awaiting' | 'completed' | 'failed' | 'cancelled';
+    kind: 'agent' | 'flow';
+    agentId: string | null;
+    flowId: string | null;
+    conversationId: string | null;
+    surfaceId: string | null;
+    surfaceType: string | null;
+    recordId: string | null;
+    batchExecutionId: string | null;
+    parentExecutionId: string | null;
+    parentToolCallId: string | null;
+    rootExecutionId: string | null;
+    source: 'hosted' | 'ingested';
+    fidelityTier: string | null;
+    completeness: 'partial' | 'complete' | 'conflicted' | 'expired' | 'deleted' | null;
+    retentionElided?: boolean;
+    spanCount: number | null;
+    inputTokens: number | null;
+    outputTokens: number | null;
+    totalCost: string | null;
+    selfReportedCost: string | null;
+    /**
+     * True when the run was dispatched with `storeResults: false`, such as an
+     * editor test. NULL means the header states nothing about it, which is not
+     * `false`: headers written before the field shipped carry no dispatch stamp.
+     */
+    test: boolean | null;
+    stopReason?: string | null;
+    iterations?: number | null;
+    /** Overlay fields. Absent means the overlay did not answer, never `false`. */
+    agentVersionId?: string | null;
+    agentVersionLabel?: string | null;
+    agentVersionNumber?: number | null;
+    agentTargetResolution?: string | null;
+    otelProducer?: unknown;
+    lastHeartbeatAt?: string | null;
+    expiresAt?: string | null;
+    cancelRequestedAt?: string | null;
+    progress?: unknown;
+    pendingApproval?: unknown;
+    budgetExhausted?: boolean | null;
+    inputMessages?: unknown;
+}
+/** Filters `GET /v1/runs` accepts. Every one lands on an indexed or key column. */
+interface RunListParams {
+    agentId?: string | string[];
+    flowId?: string | string[];
+    conversationId?: string;
+    surfaceId?: string;
+    surfaceType?: string;
+    recordId?: string;
+    batchExecutionId?: string | string[];
+    parentExecutionId?: string;
+    rootExecutionId?: string;
+    executionId?: string | string[];
+    source?: 'hosted' | 'ingested';
+    /**
+     * `running`, `completed` or `failed` only. `queued`, `awaiting` and
+     * `cancelled` exist only in the live overlay and answer 400.
+     */
+    status?: 'running' | 'completed' | 'failed';
+    from?: string;
+    to?: string;
+    view?: 'compact' | 'full';
+    overlay?: 'live' | 'none';
+    limit?: number;
+    cursor?: string;
+}
+interface RunListResponse {
+    data: RunListRow[];
+    pagination: {
+        nextCursor: string | null;
+        hasMore: boolean;
+        hasPrev: boolean;
+        limit: number;
+    };
+    window: {
+        from: string;
+        to: string;
+    };
+}
+/**
+ * Read-only namespace over `/v1/runs`, the one list of agent and flow runs.
+ * A run dispatched with `storeResults: false` is listed with `test: true`
+ * rather than being absent.
+ */
+declare class RunsNamespace {
+    private readonly getClient;
+    constructor(getClient: () => RuntypeClient$1);
+    list(params?: RunListParams): Promise<RunListResponse>;
+    get(executionId: string, params?: Pick<RunListParams, 'view' | 'overlay'>): Promise<RunListRow>;
+}
+
 /** Canonical normalized form of a tool definition (name excluded — identity). */
 declare function normalizeToolDefinition(definition: ToolContentInput): {
     toolType: string;
@@ -58085,6 +58929,17 @@ declare class Runtype {
     static get agents(): AgentsNamespace;
     /** Poll durable handles returned by asynchronous execute operations. */
     static get executions(): ExecutionsNamespace;
+    /**
+     * Runs namespace - the one list of agent and flow runs, read from the span
+     * store. Includes runs dispatched with `storeResults: false` as `test: true`.
+     *
+     * @example
+     * ```typescript
+     * const { data } = await Runtype.runs.list({ agentId, status: 'failed' })
+     * const run = await Runtype.runs.get(data[0].executionId, { view: 'full' })
+     * ```
+     */
+    static get runs(): RunsNamespace;
     /**
      * Tools namespace - Tool config-as-code (define / ensure / pull)
      *
@@ -63404,4 +64259,4 @@ declare function getLikelySupportingCandidatePaths(bestCandidatePath: string | u
 declare function getDefaultPlanPath(taskName: string): string;
 declare function sanitizeTaskSlug(taskName: string): string;
 
-export { type AIGrader, type ActivateAgentAliasInput, type ActivateAgentPromotionInput, type Agent, type AgentAdmissionOptions, type AgentAlias, type AgentAliasActivation, type AgentAliasArchiveFailure, type AgentAliasArchived, AgentAliasDependencyError, type AgentAliasList, AgentAliasNotFoundError, AgentAliasPreviewLimitError, AgentAliasRevisionMismatchError, AgentAliasRevisionRequiredError, type AgentAliasTransport, AgentAliasesNamespace, type AgentApprovalCompleteEvent, type AgentApprovalStartEvent, type AgentCompleteEvent, type AgentDefinition, type AgentDefinitionConfig, type AgentDeploymentList, type AgentDeploymentPromotion, type AgentDeploymentReceipt, AgentDeploymentsNamespace, AgentDriftError, type AgentElicitation, type AgentElicitationRequest, AgentEnsureConflictError, type AgentErrorEvent, type AgentEvent, type AgentEventType, type AgentExecuteRequest, type AgentExecuteResponse, type AgentIterationCompleteEvent, type AgentIterationStartEvent, type AgentMediaEvent, type AgentMessage, type AgentPausedEvent, type AgentPingEvent, AgentPromotionError, type AgentPromotionManifest, type AgentPromotionTransport, type AgentPromotionValidation, type AgentPullResult, type AgentReflectionEvent, type AgentRunInsightsResponse, type AgentRuntimeToolDefinition, type AgentStartEvent, type AgentStreamCallbacks, type AgentStreamEvent, type AgentSubagentConfig, type AgentToolCompleteEvent, type AgentToolDeltaEvent, type AgentToolInputCompleteEvent, type AgentToolInputDeltaEvent, type AgentToolStartEvent, type AgentTurnCompleteEvent, type AgentTurnDeltaEvent, type AgentTurnStartEvent, type AgentVersionDetail, type AgentVersionListItem, type AgentVersionPublishResponse, AgentVersionsEndpoint, type AgentVersionsListResponse, AgentsEndpoint, AgentsNamespace, AnalyticsEndpoint, type ApiClient, type ApiKey, type ApiKeyRequest, type ApiKeyRequestDelivery, type ApiKeyRequestEnvironment, type ApiKeyRequestHandoff, type ApiKeyRequestListParams, type ApiKeyRequestRequester, type ApiKeyRequestStatus, ApiKeyRequestsEndpoint, ApiKeysEndpoint, type ApiResponse, type ApplyGeneratedProposalOptions, type ApplyGeneratedProposalResult, type ArchiveAgentAliasEverywhereResult, type ArchiveAgentAliasInput, type AssetReferenceContentPart, type AsyncExecutionHandle, type AsyncExecutionStatus, type AttachRuntimeToolsOptions, type BaseAgentEvent, BatchBuilder, type BatchClient, type BatchListParams, type BatchOptions, type BatchRequest, type BatchResult, type BatchScheduleConfig, type BatchStatus, BatchesNamespace, BillingEndpoint, type BillingSpendAnalyticsParams, type BindSkillInput, type BuiltInGraderId, type BuiltInTool, type BulkEditCondition, type BulkEditRequest, type BulkEditResponse, type BulkEditResult, type CanonicalDispatchMessageContent, type CanonicalDispatchRequest, type CaseExpected, type CatalogClientToolRef, ChatEndpoint, type CheckGrader, type ClaimApiKeyRequestInput, type ClaimApiKeyRequestResponse, type ClaudeManagedEvalOverrideValues, ClientBatchBuilder, type ClientConfig, type ClientConversation, ClientEvalBuilder, ClientFlowBuilder, type ClientToken, type ClientTokenConfig, type ClientTokenEnvironment, type ClientTokenVersionPin, ClientTokensEndpoint, type ClientToolDefinition, type ClientToolEntry, type ClientWidgetTheme, type CollectionMeta, CollectionsEndpoint, type ConditionalGetResult, type ConditionalStepConfig$1 as ConditionalStepConfig, type ContextErrorHandling, type ContextFallback, ContextTemplatesEndpoint, type Conversation, type ConversationListItem, type ConversationListParams, type ConversationMessage, type ConversationSource, ConversationsEndpoint, type ConversationsListResponse, type CreateApiKeyRequest, type CreateApiKeyRequestInput, type CreateApiKeyRequestResponse, type CreateClientTokenRequest, type CreateClientTokenResponse, type CreateCollectionRequest, type CreateConversationRequest, type CreateEvalSuiteInput, type CreateFlowRequest, type CreateModelConfigRequest, type CreatePromptData, type CreatePromptRequest, type CreateProviderKeyRequest, type CreateRecordRequest, type CreateScheduleRequest, type CreateSecretRequest, type CreateToolRequest, type CurrentBilledSpendResponse, type CurrentBilledSpendSource, type CustomMCPServer, type CustomMCPServerAuth, type CustomToolConfig, DEFAULT_MAX_DETACHED_RECONNECTS, DEFAULT_RECOVERY_AFTER_EMPTY_SESSIONS, DEFAULT_STALL_STOP_AFTER, type DecomposeCriteriaResult, type DefineAgentInput, type DefineEvalCaseInput, type DefineEvalInput, type DefineFlowInput, type DefineProductInput, type DefineSkillInput, type DefineSurfaceInput, type DefineToolInput, type DeployCfSandboxRequest, type DeployCfSandboxResponse, type DeploySandboxRequest, type DeploySandboxResponse, type DetachedReattach, type DetachedReconnectOptions, type DiscoveredModel, type DispatchAgentInput, type DispatchApprovalContinuationResponse, type DispatchApproveRequest, type DispatchApproveResponse, type DispatchClient, type DispatchContinuationRequest, type DispatchContinuationResponse, type DispatchDetachedApprovalResponse, type DispatchDetachedToolOutputResponse, DispatchEndpoint, type DispatchEnvironment, type DispatchEvent, type DispatchFlowInput, type DispatchMessageContent, type DispatchOptions$1 as DispatchOptions, type DispatchRequest, type DispatchResponse, type DispatchResumeJsonResponse, type DispatchResumeRequest, type DispatchResumeResponse, ENSURE_RELEASE_DEPLOY_CONFLICT_MESSAGE, type EndUserUsageQuery, type EndUserUsageResponse, type EnsureAgentConverged, type EnsureAgentOptions, type EnsureAgentPlan, type EnsureAgentResult, type EnsureEvalResult, type EnsureFlowConverged, type EnsureFlowOptions, type EnsureFlowPlan, type EnsureFlowResult, type EnsureFpoOptions, type EnsureFpoResult, type EnsureProductConverged, type EnsureProductOptions, type EnsureProductPlan, type EnsureProductResult, type EnsureSkillConverged, type EnsureSkillOptions, type EnsureSkillPlan, type EnsureSkillResult, type EnsureSurfaceConverged, type EnsureSurfaceOptions, type EnsureSurfacePlan, type EnsureSurfaceResult, type EnsureToolConverged, type EnsureToolOptions, type EnsureToolPlan, type EnsureToolResult, type ErrorHandlingMode, type EvalAgentSelector, type EvalAgentTargetResolution, EvalBuilder, type EvalCaseDefinition, type EvalCaseInput, type EvalCaseProposal, type EvalCaseProposalAccepted, type EvalCaseProposalListResult, type EvalCasesGenerated, type EvalClient, type EvalDefinition, EvalEndpoint, type EvalListParams, type EvalMessage, type EvalOptions, type EvalOverrideValues, type EvalProposalSource, type EvalProposalStatus, type EvalProposedCase, type EvalPullResult, type EvalRecord, type EvalRequest, type EvalResult, type EvalRunCaseScores, type EvalRunConfig, type EvalRunEvidence, type EvalRunScores, EvalRunner, type EvalStatus, type EvalSuiteCase, type EvalSuiteCaseInput, type EvalSuiteCoverage, type EvalSuiteDetail, type EvalSuiteLatestRun, type EvalSuiteListResult, type EvalSuiteRunQueued, type EvalSuiteRunResult, type EvalSuiteSummary, EvalSuitesNamespace, type EvalTarget, EvalsNamespace, type ExecuteToolRequest, type ExecuteToolResponse, type ExecutionCounts, type ExecutionStreamEvent, ExecutionsEndpoint, ExecutionsNamespace, type ExternalAgentContext, type ExternalToolConfig, type FallbackFailEvent, type FallbackStartEvent, type FallbackSuccessEvent, type FallbackTrigger, type FallbackTriggerType, type FallbacksExhaustedEvent, type FallbacksInitiatedEvent, type FetchUrlStepConfig$1 as FetchUrlStepConfig, type FieldFormat, type FileContentPart, type Flow, type FlowAttachment, FlowBuilder, type FlowCompleteEvent, type FlowConfig$1 as FlowConfig, type FlowDefinition, type FlowDefinitionStep, FlowDriftError, FlowEnsureConflictError, type FlowErrorEvent, type FlowFallback, type FlowInlineEvalInput, type FlowListItem, type FlowPausedEvent, type FlowPullResult, FlowResult, type FlowStartEvent, type FlowStep, type FlowStepDefinition, type FlowStepType, FlowStepsEndpoint, type FlowStreamEvent, type FlowSummary, type FlowToolConfig, type FlowValidationClient, type FlowValidationIssue, type FlowValidationResult, type FlowVersionDetail, type FlowVersionListItem, type FlowVersionPublishResponse, FlowVersionsEndpoint, type FlowVersionsListResponse, FlowsEndpoint, FlowsNamespace, type FpoEntityOutcome, type FpoInput, type GenerateEmbeddingStepConfig$1 as GenerateEmbeddingStepConfig, type GenerateEvalCasesInput, type GeneratedRuntimeToolGateDecision, type GeneratedRuntimeToolGateOptions, type GetApiKeyRequestResponse, type GetRecordStepConfig$1 as GetRecordStepConfig, type Gradeable, type GraderConfig, type GraderOutcome, type GraderSeverity, type HealthInsight, type HumanVerdict, type ImageContentPart, type InferCollectionSchemaResponse, type InputDeliveryReceipt, type Integration, type IntegrationTool, IntegrationsEndpoint, type IntegrationsListResponse, type JSONSchema, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, LEDGER_ARTIFACT_LINE_PREFIX, LIVE_AGENT_ALIAS, type ListAgentAliasesOptions, type ListAgentDeploymentsOptions, type ListCollectionsResponse, type ListConversationsResponse, type ListParams, type ListRecordsStepConfig$1 as ListRecordsStepConfig, type LocalToolConfig, type LocalToolDefinition, type LocalToolExecutionCompleteEvent, type LocalToolExecutionLoopSnapshotSlice, type LocalToolExecutionStartEvent, type LogEntry, type LogQueryParams, type LogQueryResponse, type LogQueryResult, type LogStatsParams, type LogStatsResponse, type LogStatsResult, LogsEndpoint, type LoopStepConfig$1 as LoopStepConfig, type Message$1 as Message, type MessageContent, type MessageFallback, type Metadata, type MetricDelta, type ModelConfig, ModelConfigsEndpoint, type ModelFallback, type ModelOverride, type ModelUsageDetail, type ModelUsageQueryParams, type ModelUsageResponse, type ModelUsageSummary, type ModelUsageTimeSeries, type OrganizationAgentAlias, type OrganizationAgentAliasList, type PaginationResponse, type PersistedGraderOutcome, type PrepareAgentPromotionInput, type ProductDefinition, ProductDriftError, ProductEnsureConflictError, type ProductPullResult, type ProductionHealthQuery, type ProductionHealthResponse, ProductsNamespace, type PromoteAgentInput, type PromoteAgentResult, type Prompt$1 as Prompt, type PromptErrorHandling, type PromptFallback, type PromptListParams, type PromptStepConfig$1 as PromptStepConfig, PromptsEndpoint, PromptsNamespace, type ProviderApiKey, type ProviderKeyModel, ProviderKeysEndpoint, type PullFpoResult, RUNTYPE_CLIENT_KIND, type ReasoningConfig, type ReasoningContentPart, type ReasoningValue, type RecordCollection, type RecordCollectionWithHistory, type RecordCollections, type RecordConfig$1 as RecordConfig, type RecordCostAggregation, type RecordCostModelBreakdown, type RecordFilter, type RecordFilterCondition, type RecordFilterGroup, type RecordFilterOperator, type RecordListItem, type RecordListParams, type RecordStepResult, type RecordStepResultsParams, type RecordStepResultsResponse, type RecordWriteResponse, RecordsEndpoint, type RetrieveRecordStepConfig$1 as RetrieveRecordStepConfig, type RetryFallback, type RollbackAgentAliasInput, type RunEvalCaseResult, type RunEvalInput, type RunEvalResult, type RunTaskContextBudgetBreakdown, type RunTaskContextCompactionEvent, type RunTaskContextCompactionStrategy, type RunTaskContextNoticeEvent, type RunTaskContextSummaryEntry, type RunTaskContinuation, type RunTaskOffloadRecorder, type RunTaskOnContextCompaction, type RunTaskOnContextNotice, type RunTaskOnSession, type RunTaskOptions, type RunTaskResult, type RunTaskResumeState, type RunTaskSessionSummary, type RunTaskState, type RunTaskStateSlice, type RunTaskStatus, type RunTaskToolTraceSlice, type RuntimeCustomToolConfig, type RuntimeExternalToolConfig, type RuntimeFlowToolConfig, type RuntimeLocalToolConfig, type RuntimeSubagentToolConfig, type RuntimeTool, type RuntimeToolConfig, Runtype, type AgentSkillBinding as RuntypeAgentSkillBinding, RuntypeApiError, RuntypeClient, type ConditionalStepConfig as RuntypeConditionalStepConfig, type RuntypeConfig, type FetchUrlStepConfig as RuntypeFetchUrlStepConfig, RuntypeFlowBuilder, type FlowConfig as RuntypeFlowConfig, type GenerateEmbeddingStepConfig as RuntypeGenerateEmbeddingStepConfig, type GetRecordStepConfig as RuntypeGetRecordStepConfig, type ListRecordsStepConfig as RuntypeListRecordsStepConfig, type LoopStepConfig as RuntypeLoopStepConfig, type Message as RuntypeMessage, type ModelOverride$1 as RuntypeModelOverride, type Prompt as RuntypePrompt, type PromptStepConfig as RuntypePromptStepConfig, type RuntypeRecord, type RecordConfig as RuntypeRecordConfig, type RetrieveRecordStepConfig as RuntypeRetrieveRecordStepConfig, type SearchStepConfig as RuntypeSearchStepConfig, type SendEmailStepConfig as RuntypeSendEmailStepConfig, type SendEventStepConfig as RuntypeSendEventStepConfig, type SendStreamStepConfig as RuntypeSendStreamStepConfig, type SetVariableStepConfig as RuntypeSetVariableStepConfig, type Skill as RuntypeSkill, type SkillBindingWithAgent as RuntypeSkillBindingWithAgent, type SkillCapabilities as RuntypeSkillCapabilities, type SkillFrontmatter as RuntypeSkillFrontmatter, type SkillManifest as RuntypeSkillManifest, type SkillProposal as RuntypeSkillProposal, type SkillRuntypeExtensions as RuntypeSkillRuntypeExtensions, type SkillVersion as RuntypeSkillVersion, type TransformDataStepConfig as RuntypeTransformDataStepConfig, type UpsertFlowConfig as RuntypeUpsertFlowConfig, type UpsertRecordStepConfig as RuntypeUpsertRecordStepConfig, type VectorSearchStepConfig as RuntypeVectorSearchStepConfig, type WaitUntilStepConfig as RuntypeWaitUntilStepConfig, SDK_USER_AGENT, SDK_VERSION, STEP_FIELD_REGISTRY, STEP_TYPE_TO_METHOD, type SandboxDeployEffectivePolicy, type SandboxDeployRetention, type SandboxDeploySleepPolicy, type Schedule, type ScheduleExecutionOptions, type ScheduleListParams, type ScheduleMessage, type ScheduleMessageSet, type ScheduleMessages, type ScheduleMutationResponse, type ScheduleRun, type ScheduleRunNowResponse, type ScheduleStatusResponse, type ScheduleTarget, type ScheduleTrigger, SchedulesEndpoint, type SearchStepConfig$1 as SearchStepConfig, type Secret, type SecretCheckResponse, type SecretDeleteResponse, type SecretSetupUrlRequest, type SecretSetupUrlResponse, SecretsEndpoint, type SelectOrganizationProviderCredentialRequest, type SelectOrganizationProviderCredentialResponse, type SendEmailStepConfig$1 as SendEmailStepConfig, type SendEventStepConfig$1 as SendEventStepConfig, type SendStreamStepConfig$1 as SendStreamStepConfig, type SetVariableStepConfig$1 as SetVariableStepConfig, type SkillDefinition, SkillDriftError, SkillEnsureConflictError, type SkillListPage, type SkillListPagination, type SkillListParams, type SkillManifestInput, type SkillMarkdownInput, type SkillOrigin, type SkillProposalStatus, SkillProposalsNamespace, type SkillPullResult, type SkillStatus, type SkillTrustLevel, type SkillVersionStatus, type SkillWithVersion, type SkillWriteInput, SkillsNamespace, type SlackAppStatusResponse, type SlackInstallRequest, type SlackManifestRequest, type SlackManifestResponse, type SlackOAuthStartRequest, type SlackOAuthStartResponse, type StepCompleteEvent, type StepDeltaEvent, type StepFallback, type StepFieldMeta, type StepStartEvent, type StepWaitingLocalEvent, type StreamCallbacks, type StreamConsumeOptions, type StreamEvent, type StreamEventOf, type SubagentToolConfig, type Surface, type SurfaceDefinition, type SurfaceDefinitionStatus, type SurfaceDefinitionType, SurfaceDriftError, SurfaceEnsureConflictError, type SurfaceListParams, type SurfacePullResult, SurfacesEndpoint, SurfacesNamespace, type TextContentPart, type Tool, type ToolApprovalGrant, ToolApprovalGrantsEndpoint, type ToolConfig, type ToolDefinition, type ToolDefinitionType, ToolDriftError, ToolEnsureConflictError, type ToolPullResult, type ToolWithValidation, type ToolsConfig, ToolsEndpoint, ToolsNamespace, type TransformDataStepConfig$1 as TransformDataStepConfig, type TypedCreateRecordRequest, type TypedRecordListItem, type TypedRecordWriteResponse, TypedRecordsScope, type TypedRuntypeRecord, UNIFIED_EVENTS_QUERY, type UpdateClientTokenRequest, type UpdateCollectionRequest, type UpdateCollectionResponse, type UpdateConversationRequest, type UpdateEvalCaseInput, type UpdateEvalSuiteInput, type UpdateFlowRequest, type UpdatePromptData, type UpdateProviderKeyRequest, type UpdateScheduleRequest, type UpdateSecretRequest, type UpdateToolRequest, type UpdatedAgent, type UpdatedFlow, type UpsertFlowConfig$1 as UpsertFlowConfig, type UpsertOptions, type UpsertRecordStepConfig$1 as UpsertRecordStepConfig, type UserProfile, UsersEndpoint, type ValidateAgentPromotionInput, type ValidateExistingRecordsResponse, type VectorSearchStepConfig$1 as VectorSearchStepConfig, type VersionPublishOptions, type VersionType, type WaitUntilStepConfig$1 as WaitUntilStepConfig, type WorkflowCompileDeps, type WorkflowCompletionCriteriaConfig, type WorkflowConfig, type WorkflowConfigFactory, type WorkflowContext, type WorkflowDefinition, type WorkflowHookEntry, type WorkflowHookKind, type WorkflowHookRef, type WorkflowHookSignatures, type WorkflowMilestoneConfig, type WorkflowPhase, type WorkflowPolicyConfig, type WorkflowRecoveryConfig, type WorkflowSlot, type WorkflowStallPolicy, activateAgentPromotion, agentAliasErrorCode, applyGeneratedRuntimeToolProposalToDispatchRequest, attachRuntimeToolsToDispatchRequest, buildAgentAdmissionHeaders, buildEmptySessionNudge, buildExecutionEventsPath, buildGeneratedRuntimeToolGateOutput, buildLedgerOffloadReference, buildObservationMaskMarker, buildPolicyGuidance, buildSendViewOffloadMarker, calledTool, combineAbortSignals, compileWorkflowConfig, completed, computeAgentContentHash, computeEvalContentHash, computeFlowContentHash, computeFpoContentHash, computeProductContentHash, computeSkillContentHash, computeSurfaceContentHash, computeToolContentHash, contains, cost, createAgentEventTranslator, createClient, createExternalTool, createFlowEventTranslator, defaultWorkflow, defaultWorkflowConfig, defineAgent, defineEval, defineFlow, defineFpo, definePlaybook, defineProduct, defineSkill, defineSurface, defineTool, deployWorkflow, ensureDefaultWorkflowHooks, ensureEval, ensureFpo, evaluateGeneratedRuntimeToolProposal, extractDeclaredToolResultChars, gameWorkflow, getDefaultPlanPath, getLikelySupportingCandidatePaths, interpolateWorkflowTemplate, isCatalogClientToolRef, isDiscoveryToolName, isMarathonArtifactPath, isPreservationSensitiveTask, isUnifiedEventType, isWorkflowHookRef, jsonField, judge, judges, latency, length, listWorkflowHooks, matchesExpected, maxToolCalls, noError, normalizeAgentDefinition, normalizeCandidatePath, normalizeFpoDefinition, normalizeProductDefinition, normalizeSkillDefinition, normalizeSurfaceDefinition, normalizeToolDefinition, notCalledTool, notContains, parseFinalBuffer, parseLedgerArtifactRelativePath, parseOffloadedOutputId, parseSSEChunk, prepareAgentPromotion, processStream, promoteAgent, promotionIdempotencyKey, pullEval, pullFpo, ranStep, regex, registerWorkflowHook, resolveStallStopAfter, resolveWorkflowHook, runEvalSuite, sanitizeTaskSlug, shouldInjectEmptySessionNudge, shouldRequestModelEscalation, stepOrder, streamEvents, toolOrder, unregisterWorkflowHook, usedNoTools, validJson, validateAgentPromotion, withDetachedReconnect, withUnifiedEvents };
+export { type AIGrader, type ActivateAgentAliasInput, type ActivateAgentPromotionInput, type Agent, type AgentAdmissionOptions, type AgentAlias, type AgentAliasActivation, type AgentAliasArchiveFailure, type AgentAliasArchived, AgentAliasDependencyError, type AgentAliasList, AgentAliasNotFoundError, AgentAliasPreviewLimitError, AgentAliasRevisionMismatchError, AgentAliasRevisionRequiredError, type AgentAliasTransport, AgentAliasesNamespace, type AgentApprovalCompleteEvent, type AgentApprovalStartEvent, type AgentCompleteEvent, type AgentDefinition, type AgentDefinitionConfig, type AgentDeploymentList, type AgentDeploymentPromotion, type AgentDeploymentReceipt, AgentDeploymentsNamespace, AgentDriftError, type AgentElicitation, type AgentElicitationRequest, AgentEnsureConflictError, type AgentErrorEvent, type AgentEvent, type AgentEventType, type AgentExecuteRequest, type AgentExecuteResponse, type AgentIterationCompleteEvent, type AgentIterationStartEvent, type AgentMediaEvent, type AgentMessage, type AgentPausedEvent, type AgentPingEvent, AgentPromotionError, type AgentPromotionManifest, type AgentPromotionTransport, type AgentPromotionValidation, type AgentPullResult, type AgentReflectionEvent, type AgentRunInsightsResponse, type AgentRuntimeToolDefinition, type AgentStartEvent, type AgentStreamCallbacks, type AgentStreamEvent, type AgentSubagentConfig, type AgentToolCompleteEvent, type AgentToolDeltaEvent, type AgentToolInputCompleteEvent, type AgentToolInputDeltaEvent, type AgentToolStartEvent, type AgentTurnCompleteEvent, type AgentTurnDeltaEvent, type AgentTurnStartEvent, type AgentVersionDetail, type AgentVersionListItem, type AgentVersionPublishResponse, AgentVersionsEndpoint, type AgentVersionsListResponse, AgentsEndpoint, AgentsNamespace, AnalyticsEndpoint, type ApiClient, type ApiKey, type ApiKeyRequest, type ApiKeyRequestDelivery, type ApiKeyRequestEnvironment, type ApiKeyRequestHandoff, type ApiKeyRequestListParams, type ApiKeyRequestRequester, type ApiKeyRequestStatus, ApiKeyRequestsEndpoint, ApiKeysEndpoint, type ApiResponse, type ApplyGeneratedProposalOptions, type ApplyGeneratedProposalResult, type ArchiveAgentAliasEverywhereResult, type ArchiveAgentAliasInput, type AssetReferenceContentPart, type AsyncExecutionHandle, type AsyncExecutionStatus, type AttachRuntimeToolsOptions, type BaseAgentEvent, BatchBuilder, type BatchClient, type BatchListParams, type BatchOptions, type BatchRequest, type BatchResult, type BatchScheduleConfig, type BatchStatus, BatchesNamespace, BillingEndpoint, type BillingSpendAnalyticsParams, type BindSkillInput, type BuiltInGraderId, type BuiltInTool, type BulkEditCondition, type BulkEditRequest, type BulkEditResponse, type BulkEditResult, type CanonicalDispatchMessageContent, type CanonicalDispatchRequest, type CaseExpected, type CatalogClientToolRef, ChatEndpoint, type CheckGrader, type ClaimApiKeyRequestInput, type ClaimApiKeyRequestResponse, type ClaudeManagedEvalOverrideValues, ClientBatchBuilder, type ClientConfig, type ClientConversation, ClientEvalBuilder, ClientFlowBuilder, type ClientToken, type ClientTokenConfig, type ClientTokenEnvironment, type ClientTokenVersionPin, ClientTokensEndpoint, type ClientToolDefinition, type ClientToolEntry, type ClientWidgetTheme, type CollectionMeta, CollectionsEndpoint, type ConditionalGetResult, type ConditionalStepConfig$1 as ConditionalStepConfig, type ContextErrorHandling, type ContextFallback, ContextTemplatesEndpoint, type Conversation, type ConversationListItem, type ConversationListParams, type ConversationMessage, type ConversationSource, ConversationsEndpoint, type ConversationsListResponse, type CreateApiKeyRequest, type CreateApiKeyRequestInput, type CreateApiKeyRequestResponse, type CreateClientTokenRequest, type CreateClientTokenResponse, type CreateCollectionRequest, type CreateConversationRequest, type CreateEvalSuiteInput, type CreateFlowRequest, type CreateModelConfigRequest, type CreatePromptData, type CreatePromptRequest, type CreateProviderKeyRequest, type CreateRecordRequest, type CreateScheduleRequest, type CreateSecretRequest, type CreateToolRequest, type CurrentBilledSpendResponse, type CurrentBilledSpendSource, type CustomMCPServer, type CustomMCPServerAuth, type CustomToolConfig, DEFAULT_MAX_DETACHED_RECONNECTS, DEFAULT_RECOVERY_AFTER_EMPTY_SESSIONS, DEFAULT_STALL_STOP_AFTER, type DecomposeCriteriaResult, type DefineAgentInput, type DefineEvalCaseInput, type DefineEvalInput, type DefineFlowInput, type DefineProductInput, type DefineSkillInput, type DefineSurfaceInput, type DefineToolInput, type DeployCfSandboxRequest, type DeployCfSandboxResponse, type DeploySandboxRequest, type DeploySandboxResponse, type DetachedReattach, type DetachedReconnectOptions, type DiscoveredModel, type DispatchAgentInput, type DispatchApprovalContinuationResponse, type DispatchApproveRequest, type DispatchApproveResponse, type DispatchClient, type DispatchContinuationRequest, type DispatchContinuationResponse, type DispatchDetachedApprovalResponse, type DispatchDetachedToolOutputResponse, DispatchEndpoint, type DispatchEnvironment, type DispatchEvent, type DispatchFlowInput, type DispatchMessageContent, type DispatchOptions$1 as DispatchOptions, type DispatchRequest, type DispatchResponse, type DispatchResumeJsonResponse, type DispatchResumeRequest, type DispatchResumeResponse, ENSURE_RELEASE_DEPLOY_CONFLICT_MESSAGE, type EndUserUsageQuery, type EndUserUsageResponse, type EnsureAgentConverged, type EnsureAgentOptions, type EnsureAgentPlan, type EnsureAgentResult, type EnsureEvalResult, type EnsureFlowConverged, type EnsureFlowOptions, type EnsureFlowPlan, type EnsureFlowResult, type EnsureFpoOptions, type EnsureFpoResult, type EnsureProductConverged, type EnsureProductOptions, type EnsureProductPlan, type EnsureProductResult, type EnsureSkillConverged, type EnsureSkillOptions, type EnsureSkillPlan, type EnsureSkillResult, type EnsureSurfaceConverged, type EnsureSurfaceOptions, type EnsureSurfacePlan, type EnsureSurfaceResult, type EnsureToolConverged, type EnsureToolOptions, type EnsureToolPlan, type EnsureToolResult, type ErrorHandlingMode, type EvalAgentSelector, type EvalAgentTargetResolution, EvalBuilder, type EvalCaseDefinition, type EvalCaseInput, type EvalCaseProposal, type EvalCaseProposalAccepted, type EvalCaseProposalListResult, type EvalCasesGenerated, type EvalClient, type EvalDefinition, EvalEndpoint, type EvalListParams, type EvalMessage, type EvalOptions, type EvalOverrideValues, type EvalProposalSource, type EvalProposalStatus, type EvalProposedCase, type EvalPullResult, type EvalRecord, type EvalRequest, type EvalResult, type EvalRunCaseScores, type EvalRunConfig, type EvalRunEvidence, type EvalRunScores, EvalRunner, type EvalStatus, type EvalSuiteCase, type EvalSuiteCaseInput, type EvalSuiteCoverage, type EvalSuiteDetail, type EvalSuiteLatestRun, type EvalSuiteListResult, type EvalSuiteRunQueued, type EvalSuiteRunResult, type EvalSuiteSummary, EvalSuitesNamespace, type EvalTarget, EvalsNamespace, type ExecuteToolRequest, type ExecuteToolResponse, type ExecutionCounts, type ExecutionStreamEvent, ExecutionsEndpoint, ExecutionsNamespace, type ExternalAgentContext, type ExternalToolConfig, type FallbackFailEvent, type FallbackStartEvent, type FallbackSuccessEvent, type FallbackTrigger, type FallbackTriggerType, type FallbacksExhaustedEvent, type FallbacksInitiatedEvent, type FetchUrlStepConfig$1 as FetchUrlStepConfig, type FieldFormat, type FileContentPart, type Flow, type FlowAttachment, FlowBuilder, type FlowCompleteEvent, type FlowConfig$1 as FlowConfig, type FlowDefinition, type FlowDefinitionStep, FlowDriftError, FlowEnsureConflictError, type FlowErrorEvent, type FlowFallback, type FlowInlineEvalInput, type FlowListItem, type FlowPausedEvent, type FlowPullResult, FlowResult, type FlowStartEvent, type FlowStep, type FlowStepDefinition, type FlowStepType, FlowStepsEndpoint, type FlowStreamEvent, type FlowSummary, type FlowToolConfig, type FlowValidationClient, type FlowValidationIssue, type FlowValidationResult, type FlowVersionDetail, type FlowVersionListItem, type FlowVersionPublishResponse, FlowVersionsEndpoint, type FlowVersionsListResponse, FlowsEndpoint, FlowsNamespace, type FpoEntityOutcome, type FpoInput, type GenerateEmbeddingStepConfig$1 as GenerateEmbeddingStepConfig, type GenerateEvalCasesInput, type GeneratedRuntimeToolGateDecision, type GeneratedRuntimeToolGateOptions, type GetApiKeyRequestResponse, type GetRecordStepConfig$1 as GetRecordStepConfig, type Gradeable, type GraderConfig, type GraderOutcome, type GraderSeverity, type HealthInsight, type HumanVerdict, type ImageContentPart, type InferCollectionSchemaResponse, type InputDeliveryReceipt, type Integration, type IntegrationTool, IntegrationsEndpoint, type IntegrationsListResponse, type JSONSchema, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, LEDGER_ARTIFACT_LINE_PREFIX, LIVE_AGENT_ALIAS, type ListAgentAliasesOptions, type ListAgentDeploymentsOptions, type ListCollectionsResponse, type ListConversationsResponse, type ListParams, type ListRecordsStepConfig$1 as ListRecordsStepConfig, type LocalToolConfig, type LocalToolDefinition, type LocalToolExecutionCompleteEvent, type LocalToolExecutionLoopSnapshotSlice, type LocalToolExecutionStartEvent, type LogEntry, type LogQueryParams, type LogQueryResponse, type LogQueryResult, type LogSearchedWindow, type LogStatsParams, type LogStatsResponse, type LogStatsResult, LogsEndpoint, type LoopStepConfig$1 as LoopStepConfig, type Message$1 as Message, type MessageContent, type MessageFallback, type Metadata, type MetricDelta, type ModelConfig, ModelConfigsEndpoint, type ModelFallback, type ModelOverride, type ModelUsageDetail, type ModelUsageQueryParams, type ModelUsageResponse, type ModelUsageSummary, type ModelUsageTimeSeries, type OrganizationAgentAlias, type OrganizationAgentAliasList, type PaginationResponse, type PersistedGraderOutcome, type PrepareAgentPromotionInput, type ProductDefinition, ProductDriftError, ProductEnsureConflictError, type ProductPullResult, type ProductionHealthQuery, type ProductionHealthResponse, ProductsNamespace, type PromoteAgentInput, type PromoteAgentResult, type Prompt$1 as Prompt, type PromptErrorHandling, type PromptFallback, type PromptListParams, type PromptStepConfig$1 as PromptStepConfig, PromptsEndpoint, PromptsNamespace, type ProviderApiKey, type ProviderKeyModel, ProviderKeysEndpoint, type PullFpoResult, RUNTYPE_CLIENT_KIND, type ReasoningConfig, type ReasoningContentPart, type ReasoningValue, type RecordCollection, type RecordCollectionWithHistory, type RecordCollections, type RecordConfig$1 as RecordConfig, type RecordCostAggregation, type RecordCostModelBreakdown, type RecordFilter, type RecordFilterCondition, type RecordFilterGroup, type RecordFilterOperator, type RecordListItem, type RecordListParams, type RecordStepResult, type RecordStepResultsParams, type RecordStepResultsResponse, type RecordWriteResponse, RecordsEndpoint, type RetrieveRecordStepConfig$1 as RetrieveRecordStepConfig, type RetryFallback, type RollbackAgentAliasInput, type RunEvalCaseResult, type RunEvalInput, type RunEvalResult, type RunListParams, type RunListResponse, type RunListRow, type RunTaskContextBudgetBreakdown, type RunTaskContextCompactionEvent, type RunTaskContextCompactionStrategy, type RunTaskContextNoticeEvent, type RunTaskContextSummaryEntry, type RunTaskContinuation, type RunTaskOffloadRecorder, type RunTaskOnContextCompaction, type RunTaskOnContextNotice, type RunTaskOnSession, type RunTaskOptions, type RunTaskResult, type RunTaskResumeState, type RunTaskSessionSummary, type RunTaskState, type RunTaskStateSlice, type RunTaskStatus, type RunTaskToolTraceSlice, RunsNamespace, type RuntimeCustomToolConfig, type RuntimeExternalToolConfig, type RuntimeFlowToolConfig, type RuntimeLocalToolConfig, type RuntimeSubagentToolConfig, type RuntimeTool, type RuntimeToolConfig, Runtype, type AgentSkillBinding as RuntypeAgentSkillBinding, RuntypeApiError, RuntypeClient, type ConditionalStepConfig as RuntypeConditionalStepConfig, type RuntypeConfig, type FetchUrlStepConfig as RuntypeFetchUrlStepConfig, RuntypeFlowBuilder, type FlowConfig as RuntypeFlowConfig, type GenerateEmbeddingStepConfig as RuntypeGenerateEmbeddingStepConfig, type GetRecordStepConfig as RuntypeGetRecordStepConfig, type ListRecordsStepConfig as RuntypeListRecordsStepConfig, type LoopStepConfig as RuntypeLoopStepConfig, type Message as RuntypeMessage, type ModelOverride$1 as RuntypeModelOverride, type Prompt as RuntypePrompt, type PromptStepConfig as RuntypePromptStepConfig, type RuntypeRecord, type RecordConfig as RuntypeRecordConfig, type RetrieveRecordStepConfig as RuntypeRetrieveRecordStepConfig, type SearchStepConfig as RuntypeSearchStepConfig, type SendEmailStepConfig as RuntypeSendEmailStepConfig, type SendEventStepConfig as RuntypeSendEventStepConfig, type SendStreamStepConfig as RuntypeSendStreamStepConfig, type SetVariableStepConfig as RuntypeSetVariableStepConfig, type Skill as RuntypeSkill, type SkillBindingWithAgent as RuntypeSkillBindingWithAgent, type SkillCapabilities as RuntypeSkillCapabilities, type SkillFrontmatter as RuntypeSkillFrontmatter, type SkillManifest as RuntypeSkillManifest, type SkillProposal as RuntypeSkillProposal, type SkillRuntypeExtensions as RuntypeSkillRuntypeExtensions, type SkillVersion as RuntypeSkillVersion, type TransformDataStepConfig as RuntypeTransformDataStepConfig, type UpsertFlowConfig as RuntypeUpsertFlowConfig, type UpsertRecordStepConfig as RuntypeUpsertRecordStepConfig, type VectorSearchStepConfig as RuntypeVectorSearchStepConfig, type WaitUntilStepConfig as RuntypeWaitUntilStepConfig, SDK_USER_AGENT, SDK_VERSION, STEP_FIELD_REGISTRY, STEP_TYPE_TO_METHOD, type SandboxDeployEffectivePolicy, type SandboxDeployRetention, type SandboxDeploySleepPolicy, type Schedule, type ScheduleExecutionOptions, type ScheduleListParams, type ScheduleMessage, type ScheduleMessageSet, type ScheduleMessages, type ScheduleMutationResponse, type ScheduleRun, type ScheduleRunNowResponse, type ScheduleStatusResponse, type ScheduleTarget, type ScheduleTrigger, SchedulesEndpoint, type SearchStepConfig$1 as SearchStepConfig, type Secret, type SecretCheckResponse, type SecretDeleteResponse, type SecretSetupUrlRequest, type SecretSetupUrlResponse, SecretsEndpoint, type SelectOrganizationProviderCredentialRequest, type SelectOrganizationProviderCredentialResponse, type SendEmailStepConfig$1 as SendEmailStepConfig, type SendEventStepConfig$1 as SendEventStepConfig, type SendStreamStepConfig$1 as SendStreamStepConfig, type SetVariableStepConfig$1 as SetVariableStepConfig, type SkillDefinition, SkillDriftError, SkillEnsureConflictError, type SkillListPage, type SkillListPagination, type SkillListParams, type SkillManifestInput, type SkillMarkdownInput, type SkillOrigin, type SkillProposalStatus, SkillProposalsNamespace, type SkillPullResult, type SkillStatus, type SkillTrustLevel, type SkillVersionStatus, type SkillWithVersion, type SkillWriteInput, SkillsNamespace, type SlackAppStatusResponse, type SlackInstallRequest, type SlackManifestRequest, type SlackManifestResponse, type SlackOAuthStartRequest, type SlackOAuthStartResponse, type StepCompleteEvent, type StepDeltaEvent, type StepFallback, type StepFieldMeta, type StepStartEvent, type StepWaitingLocalEvent, type StreamCallbacks, type StreamConsumeOptions, type StreamEvent, type StreamEventOf, type SubagentToolConfig, type Surface, type SurfaceDefinition, type SurfaceDefinitionStatus, type SurfaceDefinitionType, SurfaceDriftError, SurfaceEnsureConflictError, type SurfaceListParams, type SurfacePullResult, SurfacesEndpoint, SurfacesNamespace, type TextContentPart, type Tool, type ToolApprovalGrant, ToolApprovalGrantsEndpoint, type ToolConfig, type ToolDefinition, type ToolDefinitionType, ToolDriftError, ToolEnsureConflictError, type ToolPullResult, type ToolWithValidation, type ToolsConfig, ToolsEndpoint, ToolsNamespace, type TransformDataStepConfig$1 as TransformDataStepConfig, type TypedCreateRecordRequest, type TypedRecordListItem, type TypedRecordWriteResponse, TypedRecordsScope, type TypedRuntypeRecord, UNIFIED_EVENTS_QUERY, type UpdateClientTokenRequest, type UpdateCollectionRequest, type UpdateCollectionResponse, type UpdateConversationRequest, type UpdateEvalCaseInput, type UpdateEvalSuiteInput, type UpdateFlowRequest, type UpdatePromptData, type UpdateProviderKeyRequest, type UpdateScheduleRequest, type UpdateSecretRequest, type UpdateToolRequest, type UpdatedAgent, type UpdatedFlow, type UpsertFlowConfig$1 as UpsertFlowConfig, type UpsertOptions, type UpsertRecordStepConfig$1 as UpsertRecordStepConfig, type UserProfile, UsersEndpoint, type ValidateAgentPromotionInput, type ValidateExistingRecordsResponse, type VectorSearchStepConfig$1 as VectorSearchStepConfig, type VersionPublishOptions, type VersionType, type WaitUntilStepConfig$1 as WaitUntilStepConfig, type WorkflowCompileDeps, type WorkflowCompletionCriteriaConfig, type WorkflowConfig, type WorkflowConfigFactory, type WorkflowContext, type WorkflowDefinition, type WorkflowHookEntry, type WorkflowHookKind, type WorkflowHookRef, type WorkflowHookSignatures, type WorkflowMilestoneConfig, type WorkflowPhase, type WorkflowPolicyConfig, type WorkflowRecoveryConfig, type WorkflowSlot, type WorkflowStallPolicy, activateAgentPromotion, agentAliasErrorCode, applyGeneratedRuntimeToolProposalToDispatchRequest, attachRuntimeToolsToDispatchRequest, buildAgentAdmissionHeaders, buildEmptySessionNudge, buildExecutionEventsPath, buildGeneratedRuntimeToolGateOutput, buildLedgerOffloadReference, buildObservationMaskMarker, buildPolicyGuidance, buildSendViewOffloadMarker, calledTool, combineAbortSignals, compileWorkflowConfig, completed, computeAgentContentHash, computeEvalContentHash, computeFlowContentHash, computeFpoContentHash, computeProductContentHash, computeSkillContentHash, computeSurfaceContentHash, computeToolContentHash, contains, cost, createAgentEventTranslator, createClient, createExternalTool, createFlowEventTranslator, defaultWorkflow, defaultWorkflowConfig, defineAgent, defineEval, defineFlow, defineFpo, definePlaybook, defineProduct, defineSkill, defineSurface, defineTool, deployWorkflow, ensureDefaultWorkflowHooks, ensureEval, ensureFpo, evaluateGeneratedRuntimeToolProposal, extractDeclaredToolResultChars, gameWorkflow, getDefaultPlanPath, getLikelySupportingCandidatePaths, interpolateWorkflowTemplate, isCatalogClientToolRef, isDiscoveryToolName, isMarathonArtifactPath, isPreservationSensitiveTask, isUnifiedEventType, isWorkflowHookRef, jsonField, judge, judges, latency, length, listWorkflowHooks, matchesExpected, maxToolCalls, noError, normalizeAgentDefinition, normalizeCandidatePath, normalizeFpoDefinition, normalizeProductDefinition, normalizeSkillDefinition, normalizeSurfaceDefinition, normalizeToolDefinition, notCalledTool, notContains, parseFinalBuffer, parseLedgerArtifactRelativePath, parseOffloadedOutputId, parseSSEChunk, prepareAgentPromotion, processStream, promoteAgent, promotionIdempotencyKey, pullEval, pullFpo, ranStep, regex, registerWorkflowHook, resolveStallStopAfter, resolveWorkflowHook, runEvalSuite, sanitizeTaskSlug, shouldInjectEmptySessionNudge, shouldRequestModelEscalation, stepOrder, streamEvents, toolOrder, unregisterWorkflowHook, usedNoTools, validJson, validateAgentPromotion, withDetachedReconnect, withUnifiedEvents };