@runtypelabs/sdk 9.3.1 → 9.4.0

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @runtypelabs/sdk
 
+## 9.4.0
+
+### Minor Changes
+
+- 31e02de: Add opt-in durable recovery for Persona client-token chat surfaces, including automatic reconnect authorization for Runtime and Claude Managed owners, durable client-tool continuation, and typed surface/init/resume contracts.
+- b08a7a2: Organization admins now see every management API key in the organization from `GET /v1/api-keys` and `GET /v1/api-keys/analytics`; other members still see only the keys they created. Each listed key carries `ownerUserId`, `ownerName` and `isOwn`. Keys owned by another member are read-only for the admin (update, regenerate, reveal and delete stay owner-scoped), and the dashboard shows them with an owner line and a "View only" badge in place of the action buttons.
+- 0584e9a: Remove the development/production distinction on product surfaces (ADR 0023). Every surface accepts both test and live credentials and there is no promotion step; the `SURFACE_TYPE_PRERELEASE`, `SURFACE_HAS_LIVE_KEYS`, `SURFACE_ENVIRONMENT_MISMATCH` and `ENVIRONMENT_MISMATCH` errors are gone, OAuth-minted MCP surface keys are live keys, and a surface's integration tools resolve the organization-connection environment of the deployment they run in. For one release the wire keeps a compatibility shape: surface reads return `environment: 'production'` as a deprecated constant; create, update, ensure, FPO import, the MCP `create_surface` / `list_surfaces` inputs and the SDK `defineSurface` accept an `environment` key and ignore it; the `?environment=` list filter answers `400 SURFACE_ENVIRONMENT_RETIRED`. The `product_surfaces.environment` column is backfilled to `'production'`, never read, and dropped in a follow-up.
+
+### Patch Changes
+
+- 3285445: Remove the retired slow-mode execution throttle. Nothing produced `inSlowMode: true` since execution counts became uncapped, so the 10s delay branches, the `slow_mode_hourly` block type, the `X-Slow-Mode-*` headers, the `UsageTrackerDO.checkBuildTierExecution` / `resetSlowModeState` RPCs and their `hourly_rate_counts` table, and the `inSlowMode` field on 429 responses are gone. `/v1/usage-limits` keeps emitting `inSlowMode: false` as a deprecated constant because pinned Python/Ruby SDK models require the property. The plan-upgrade counter reset survives as `resetExecutionCountersForPlanChange` (daily + monthly). The Analytics Engine `doubles[3]` slot stays at 0 so historical column positions are unchanged.
+
+## 9.3.2
+
+### Patch Changes
+
+- ccd07e2: Report a truncated agent turn as a failure instead of a clean completion. When a model turn ends with the provider finish reason `length` while a tool call's arguments are still streaming, the agent loop now stops with the loop-level `stopReason: 'length'` and `success: false` — previously the run reported `success: true` / `stopReason: 'complete'` with an empty output and an unpaired tool start that was only discoverable by pairing trace events. `decideLoopContinuation` gains the matching `length_cutoff` reason on both the runtime and its api twin, and the cutoff verdict outranks `max_cost` so a run that trips both is still reported as failed.
+
+  The cutoff is attributed per tool call, not per turn. A turn that runs a multi-step authored flow ends on its LAST prompt step's stop reason, so each unpaired `tool_start` is stamped with the stop reason of the step that owned it: an early step that truncated mid tool call fails the run even when a later step ends cleanly, and an unpaired start from a clean step no longer fails a run whose last step merely truncated its text.
+
+  Every `tool_start` the loop leaves in flight at turn end is now closed by a synthesized failed `tool_complete`, under any stop reason rather than only the cutoff — an unpaired start was previously discarded when the next turn began. The cutoff close-out names the output-token limit; any other unresolved start reports that the turn ended first.
+
+  The loop-level stop reason and any salvaged reply are now observable: `execution_error` carries an optional `stopReason` and an optional `finalOutput` (both loose, like `execution_complete`'s), emitted by both the runtime emitter and the api's legacy translator. The buffered `/v1/dispatch` agent envelope reports the same verdict that `agent_executions.stop_reason` persists instead of hard-coding `error`, the SDK's `execution_error` → `agent_complete` fold forwards it rather than flattening it to `error`, and both durable readers project a failure terminal through one shared helper. A cut-off run still spends its final-reply elicitation turn, and a messaging surface delivers that salvaged sentence instead of the surface's generic error message while still recording the run as failed. The run's span no longer reports status OK.
+
+  MIGRATION: this changes the default verdict for an existing agent whose turns are truncated mid tool call — a run that used to report `success: true` with empty output now reports `success: false` with `stopReason: 'length'`. The fix is to raise the agent's `maxTokens`. To pin the old verdict while you do, set the new `loopConfig.treatLengthCutoffAsFailure` to `false`; it defaults to `true`, and the synthesized failed `tool_complete` close-outs are emitted either way.
+
+- 8ab7d4a: Apply flow and agent version snapshots to the live execution rows atomically when publishing from any API surface.
+
 ## 9.3.1
 
 ### Patch Changes

package/dist/index.cjs

@@ -666,7 +666,8 @@ function createAgentEventTranslator() {
             seq,
             agentId,
             success: false,
-            stopReason: "error",
+            // WHY(#7794): Forward the loop verdict like the execution_complete arm; `error` is the no-verdict answer.
+            stopReason: data.stopReason ?? "error",
             error: errorMessage(data.error),
             completedAt: data.completedAt
           })
@@ -5675,7 +5676,8 @@ function normalizeSurfaceDefinition(definition) {
     type: definition.type,
     behavior,
     status: definition.status || "draft",
-    environment: definition.environment || "development"
+    // INVARIANT: Mirrors the shared hash's frozen literal for the retired field; keeps existing configHashes stable.
+    environment: "development"
   };
 }
 async function computeSurfaceContentHash(definition) {
@@ -5687,9 +5689,9 @@ var DEFINE_SURFACE_TOP_LEVEL_KEYS = /* @__PURE__ */ new Set([
   "behavior",
   "inbound",
   "outbound",
-  "status",
-  "environment"
+  "status"
 ]);
+var DEFINE_SURFACE_RETIRED_KEYS = /* @__PURE__ */ new Set(["environment"]);
 var SURFACE_DEFINITION_TYPES = /* @__PURE__ */ new Set([
   "chat",
   "mcp",
@@ -5732,13 +5734,12 @@ function defineSurface(input) {
   if (input.status !== void 0 && !["draft", "active", "paused"].includes(input.status)) {
     throw new Error('defineSurface "status" must be one of: draft, active, paused');
   }
-  if (input.environment !== void 0 && !["production", "development"].includes(input.environment)) {
-    throw new Error('defineSurface "environment" must be one of: production, development');
-  }
-  const unknownKeys = Object.keys(input).filter((key) => !DEFINE_SURFACE_TOP_LEVEL_KEYS.has(key));
+  const unknownKeys = Object.keys(input).filter(
+    (key) => !DEFINE_SURFACE_TOP_LEVEL_KEYS.has(key) && !DEFINE_SURFACE_RETIRED_KEYS.has(key)
+  );
   if (unknownKeys.length > 0) {
     throw new Error(
-      `defineSurface: unknown field(s): ${unknownKeys.join(", ")}. Allowed fields are name, type, behavior, inbound, outbound, status, environment.`
+      `defineSurface: unknown field(s): ${unknownKeys.join(", ")}. Allowed fields are name, type, behavior, inbound, outbound, status.`
     );
   }
   return {
@@ -5747,8 +5748,7 @@ function defineSurface(input) {
     ...input.behavior !== void 0 ? { behavior: input.behavior } : {},
     ...input.inbound !== void 0 ? { inbound: input.inbound } : {},
     ...input.outbound !== void 0 ? { outbound: input.outbound } : {},
-    ...input.status !== void 0 ? { status: input.status } : {},
-    ...input.environment !== void 0 ? { environment: input.environment } : {}
+    ...input.status !== void 0 ? { status: input.status } : {}
   };
 }
 var SurfaceEnsureConflictError = class extends Error {
@@ -6487,7 +6487,7 @@ var Runtype = class {
 
 // src/version.ts
 var FALLBACK_VERSION = "0.0.0";
-var SDK_VERSION = "9.3.1".length > 0 ? "9.3.1" : FALLBACK_VERSION;
+var SDK_VERSION = "9.4.0".length > 0 ? "9.4.0" : FALLBACK_VERSION;
 var RUNTYPE_CLIENT_KIND = "sdk";
 var SDK_USER_AGENT = `runtype-sdk/${SDK_VERSION} (typescript)`;
 
@@ -9066,7 +9066,10 @@ var ApiKeysEndpoint = class {
     this.requests = new ApiKeyRequestsEndpoint(client);
   }
   /**
-   * List all API keys for the authenticated user
+   * List the API keys visible to the caller. An organization admin on a Clerk
+   * session receives every key in the organization (each carrying `ownerUserId`,
+   * `ownerName` and `isOwn`); other members, and every API-key caller, receive
+   * only the keys they created. Keys with `isOwn: false` are read-only.
    */
   async list() {
     const response = await this.client.get(
@@ -13126,9 +13129,10 @@ var AgentVersionsEndpoint = class {
   /**
    * Publish a version (promote it to the agent's published version).
    */
-  async publish(agentId, versionId) {
+  async publish(agentId, versionId, options = {}) {
     return this.client.post(`/agent-versions/${agentId}/publish`, {
-      versionId
+      versionId,
+      ...options
     });
   }
 };
@@ -13157,9 +13161,10 @@ var FlowVersionsEndpoint = class {
   /**
    * Publish a version (promote it to the flow's published version).
    */
-  async publish(flowId, versionId) {
+  async publish(flowId, versionId, options = {}) {
     return this.client.post(`/flow-versions/${flowId}/publish`, {
-      versionId
+      versionId,
+      ...options
     });
   }
 };

package/dist/index.d.cts

@@ -228,6 +228,12 @@ interface paths {
             requestBody?: {
                 content: {
                     "application/json": {
+                        /**
+                         * @description Use overwrite only after confirming replacement of a code-managed agent.
+                         * @default error
+                         * @enum {string}
+                         */
+                        onConflict?: "error" | "overwrite";
                         versionId: string;
                     };
                 };
@@ -241,9 +247,15 @@ interface paths {
                     content: {
                         "application/json": {
                             agentId: string;
+                            applied: {
+                                [key: string]: boolean;
+                            };
+                            /** @enum {string} */
+                            lastModifiedSource: "dashboard" | "api" | "mcp";
                             message: string;
                             success: boolean;
                             versionId: string;
+                            warnings: string[];
                         };
                     };
                 };
@@ -285,6 +297,20 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description Publishing would overwrite a definition managed by code */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"] & {
+                            /** @enum {string} */
+                            code: "managed_by_code_conflict";
+                            /** @enum {string} */
+                            lastModifiedSource: "sdk" | "terraform";
+                        };
+                    };
+                };
                 /** @description Internal server error */
                 500: {
                     headers: {
@@ -713,6 +739,7 @@ interface paths {
                                 maxCost?: number;
                                 maxTurns?: number;
                                 reflectionInterval?: number;
+                                treatLengthCutoffAsFailure?: boolean;
                             };
                             maxTokens?: number;
                             memory?: {
@@ -1143,6 +1170,7 @@ interface paths {
                                     maxCost?: number;
                                     maxTurns?: number;
                                     reflectionInterval?: number;
+                                    treatLengthCutoffAsFailure?: boolean;
                                 };
                                 maxTokens?: number;
                                 memory?: {
@@ -1841,6 +1869,7 @@ interface paths {
                                 maxCost?: number;
                                 maxTurns?: number;
                                 reflectionInterval?: number;
+                                treatLengthCutoffAsFailure?: boolean;
                             };
                             maxTokens?: number;
                             memory?: {
@@ -7692,12 +7721,14 @@ interface paths {
             requestBody: {
                 content: {
                     "application/json": {
+                        durableRecovery?: boolean;
                         flowId?: string;
                         identityProof?: string;
                         token: string;
                         visitorHistory?: boolean;
                         visitorToken?: string;
                     } | {
+                        durableRecovery?: boolean;
                         flowId?: string;
                         identityProof?: string;
                         sessionId: string;
@@ -7706,6 +7737,7 @@ interface paths {
                         visitorToken?: string;
                     } | {
                         conversationId: string;
+                        durableRecovery?: boolean;
                         flowId?: string;
                         identityProof?: string;
                         token: string;
@@ -7713,6 +7745,7 @@ interface paths {
                         visitorToken: string;
                     } | {
                         conversationId: string;
+                        durableRecovery?: boolean;
                         flowId?: string;
                         identityProof: string;
                         token: string;
@@ -7747,6 +7780,11 @@ interface paths {
                             conversationId: string;
                             /** @description Opaque change token for `conversationId` at the moment this session was created. Compare it for equality and nothing else — it is unordered and unparseable. It changes on every transcript mutation, including a display-projection finalization that deliberately leaves `updatedAt` untouched, so a second device or a reloaded tab can tell whether the transcript it holds is still current. */
                             conversationRevision: string;
+                            /** @description Returned when the request negotiates `durableRecovery`. Older servers omit it; clients must then keep ordinary streaming behavior. */
+                            durableRecovery?: {
+                                /** @description Whether this initialized client-token session has the visitor credential and surface policy needed to use the durable execution reconnect route. Reporting only: individual turns still self-identify as durable through replay cursors. */
+                                enabled: boolean;
+                            };
                             /** @description ISO-8601 session idle-expiry timestamp. */
                             expiresAt: string;
                             /** @description Resolved flow or agent for this session. Present on every response except the data-only Runtype App branch, which returns `app` instead. Retained for compatibility: `id` always carries the same value as the canonical top-level `targetId`, which new clients should read instead. */
@@ -7860,6 +7898,8 @@ interface paths {
             requestBody: {
                 content: {
                     "application/json": {
+                        /** @default  */
+                        after?: string;
                         /** @description Id for the assistant message this resumed leg produces. The leg's completion is persisted to the conversation, so sending the id the client already uses locally makes a later re-send of that same message deduplicate exactly instead of by text. Optional and backward compatible. */
                         assistantMessageId?: string;
                         clientTools?: {
@@ -10897,6 +10937,7 @@ interface paths {
                                 maxCost?: number;
                                 maxTurns?: number;
                                 reflectionInterval?: number;
+                                treatLengthCutoffAsFailure?: boolean;
                             };
                             maxTokens?: number;
                             memory?: {
@@ -11272,6 +11313,7 @@ interface paths {
                                 maxCost?: number;
                                 maxTurns?: number;
                                 reflectionInterval?: number;
+                                treatLengthCutoffAsFailure?: boolean;
                             };
                             maxTokens?: number;
                             memory?: {
@@ -16667,6 +16709,12 @@ interface paths {
             requestBody?: {
                 content: {
                     "application/json": {
+                        /**
+                         * @description Use overwrite only after confirming replacement of a code-managed flow.
+                         * @default error
+                         * @enum {string}
+                         */
+                        onConflict?: "error" | "overwrite";
                         versionId: string;
                     };
                 };
@@ -16679,10 +16727,16 @@ interface paths {
                     };
                     content: {
                         "application/json": {
+                            applied: {
+                                [key: string]: boolean;
+                            };
                             flowId: string;
+                            /** @enum {string} */
+                            lastModifiedSource: "dashboard" | "api" | "mcp";
                             message: string;
                             success: boolean;
                             versionId: string;
+                            warnings: string[];
                         };
                     };
                 };
@@ -16724,6 +16778,20 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description Publishing would overwrite a definition managed by code */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"] & {
+                            /** @enum {string} */
+                            code: "managed_by_code_conflict";
+                            /** @enum {string} */
+                            lastModifiedSource: "sdk" | "terraform";
+                        };
+                    };
+                };
                 /** @description Internal server error */
                 500: {
                     headers: {
@@ -28741,6 +28809,7 @@ interface paths {
                     cursor?: string;
                     type?: string;
                     status?: string;
+                    /** @description Retired; answers 400 SURFACE_ENVIRONMENT_RETIRED. */
                     environment?: string;
                 };
                 header?: never;
@@ -28763,7 +28832,11 @@ interface paths {
                                 createdAt: string;
                                 /** @description Canonical public URL of this surface (MCP, API, A2A, AG-UI, webhook, chat). Null for surface types reached through their own channels (Slack, email, schedule, ...). Clients should use this instead of constructing the URL themselves. */
                                 endpoint: string | null;
-                                environment: string;
+                                /**
+                                 * @deprecated
+                                 * @description Always 'production'. Surface environment was retired (ADR 0023); the field is removed together with the retained column.
+                                 */
+                                environment?: string;
                                 id: string;
                                 inbound?: unknown;
                                 name: string;
@@ -28844,10 +28917,7 @@ interface paths {
                     "application/json": {
                         behavior?: unknown;
                         config?: unknown;
-                        /**
-                         * @default development
-                         * @enum {string}
-                         */
+                        /** @enum {string} */
                         environment?: "production" | "development";
                         inbound?: {
                             [key: string]: unknown;
@@ -28875,7 +28945,11 @@ interface paths {
                             createdAt: string;
                             /** @description Canonical public URL of this surface (MCP, API, A2A, AG-UI, webhook, chat). Null for surface types reached through their own channels (Slack, email, schedule, ...). Clients should use this instead of constructing the URL themselves. */
                             endpoint: string | null;
-                            environment: string;
+                            /**
+                             * @deprecated
+                             * @description Always 'production'. Surface environment was retired (ADR 0023); the field is removed together with the retained column.
+                             */
+                            environment?: string;
                             id: string;
                             inbound?: unknown;
                             items: unknown[];
@@ -29199,7 +29273,11 @@ interface paths {
                             createdAt: string;
                             /** @description Canonical public URL of this surface (MCP, API, A2A, AG-UI, webhook, chat). Null for surface types reached through their own channels (Slack, email, schedule, ...). Clients should use this instead of constructing the URL themselves. */
                             endpoint: string | null;
-                            environment: string;
+                            /**
+                             * @deprecated
+                             * @description Always 'production'. Surface environment was retired (ADR 0023); the field is removed together with the retained column.
+                             */
+                            environment?: string;
                             id: string;
                             inbound?: unknown;
                             items: {
@@ -29346,7 +29424,11 @@ interface paths {
                             createdAt: string;
                             /** @description Canonical public URL of this surface (MCP, API, A2A, AG-UI, webhook, chat). Null for surface types reached through their own channels (Slack, email, schedule, ...). Clients should use this instead of constructing the URL themselves. */
                             endpoint: string | null;
-                            environment: string;
+                            /**
+                             * @deprecated
+                             * @description Always 'production'. Surface environment was retired (ADR 0023); the field is removed together with the retained column.
+                             */
+                            environment?: string;
                             id: string;
                             inbound?: unknown;
                             name: string;
@@ -30177,8 +30259,8 @@ interface paths {
             cookie?: never;
         };
         /**
-         * Reveal development surface key
-         * @description Reveal the plaintext of a development (test) surface key. Session-only — API key authentication is rejected.
+         * Reveal test surface key
+         * @description Reveal the plaintext of a test surface key. Session-only — API key authentication is rejected.
          */
         get: {
             parameters: {
@@ -42041,7 +42123,7 @@ interface paths {
         };
         /**
          * List surfaces
-         * @description List product surfaces across the authenticated user/org's products with cursor-based pagination. Supports filtering by product, type, status, and environment. Slack inbound config is returned only for Slack surfaces and only includes safe-to-expose keys.
+         * @description List product surfaces across the authenticated user/org's products with cursor-based pagination. Supports filtering by product, type, and status. Slack inbound config is returned only for Slack surfaces and only includes safe-to-expose keys.
          */
         get: {
             parameters: {
@@ -42051,6 +42133,7 @@ interface paths {
                     productId?: string;
                     type?: string;
                     status?: string;
+                    /** @description Retired; answers 400 SURFACE_ENVIRONMENT_RETIRED. */
                     environment?: string;
                 };
                 header?: never;
@@ -42070,7 +42153,11 @@ interface paths {
                                 createdAt: string;
                                 /** @description Canonical public URL of this surface (MCP, API, A2A, AG-UI, webhook, chat). Null for surface types reached through their own channels (Slack, email, schedule, ...). Clients should use this instead of constructing the URL themselves. */
                                 endpoint: string | null;
-                                environment: string;
+                                /**
+                                 * @deprecated
+                                 * @description Always 'production'. Surface environment was retired (ADR 0023); the field is removed together with the retained column.
+                                 */
+                                environment?: string;
                                 id: string;
                                 inbound: {
                                     appId?: string;
@@ -44817,6 +44904,7 @@ interface components {
                         maxCost?: number;
                         maxTurns?: number;
                         reflectionInterval?: number;
+                        treatLengthCutoffAsFailure?: boolean;
                     };
                     maxTokens?: number;
                     memory?: {
@@ -45744,9 +45832,11 @@ interface components {
                 message: string;
             };
             executionId: string;
+            finalOutput?: string;
             /** @enum {string} */
             kind: "agent" | "flow";
             seq: number;
+            stopReason?: string;
             /** @enum {string} */
             type: "execution_error";
             upgradeUrl?: string;
@@ -48307,6 +48397,14 @@ interface ApiKey {
     createdAt: string;
     updatedAt?: string;
     lastUsedAt?: string;
+    isTestKey?: boolean;
+    canReveal?: boolean;
+    /** User who created the key; differs from the caller only in the organization-admin view. */
+    ownerUserId?: string;
+    /** Owning member's display name or email; populated only for organization admins. */
+    ownerName?: string | null;
+    /** False for a key an organization admin can see but did not create. Such keys are read-only. */
+    isOwn?: boolean;
 }
 interface ModelConfig {
     id: string;
@@ -49355,6 +49453,12 @@ interface AgentVersionPublishResponse {
     message: string;
     agentId: string;
     versionId: string;
+    applied: Record<string, boolean>;
+    warnings: string[];
+    lastModifiedSource: 'dashboard' | 'api' | 'mcp';
+}
+interface VersionPublishOptions {
+    onConflict?: 'error' | 'overwrite';
 }
 interface FlowVersionListItem {
     id: string;
@@ -49377,6 +49481,9 @@ interface FlowVersionPublishResponse {
     message: string;
     flowId: string;
     versionId: string;
+    applied: Record<string, boolean>;
+    warnings: string[];
+    lastModifiedSource: 'dashboard' | 'api' | 'mcp';
 }
 type VersionType = 'published' | 'draft' | 'test' | 'virtual';
 type Integration = paths['/v1/integrations']['get']['responses'][200]['content']['application/json']['integrations'][number];
@@ -52756,12 +52863,10 @@ interface SurfaceContentInput {
     inbound?: Record<string, unknown> | null;
     outbound?: Record<string, unknown> | null;
     status?: string | null;
-    environment?: string | null;
 }
 /** The surface types `ensure` accepts (mirrors the server's createSurfaceSchema). */
 type SurfaceDefinitionType = 'chat' | 'mcp' | 'mcp_code' | 'api' | 'webhook' | 'schedule' | 'a2a' | 'email' | 'slack' | 'sms' | 'imessage' | 'discord' | 'whatsapp' | 'telegram' | 'hosted-page' | 'chrome_extension';
 type SurfaceDefinitionStatus = 'draft' | 'active' | 'paused';
-type SurfaceDefinitionEnvironment = 'production' | 'development';
 /** `defineSurface` input: identity (name) + the convergeable content fields. */
 interface DefineSurfaceInput {
     name: string;
@@ -52770,7 +52875,8 @@ interface DefineSurfaceInput {
     inbound?: Record<string, unknown>;
     outbound?: Record<string, unknown>;
     status?: SurfaceDefinitionStatus;
-    environment?: SurfaceDefinitionEnvironment;
+    /** @deprecated Surface environment was retired (ADR 0023); accepted and dropped. */
+    environment?: 'production' | 'development';
 }
 /** The canonical (wire) definition produced by `defineSurface`. */
 interface SurfaceDefinition {
@@ -52780,7 +52886,6 @@ interface SurfaceDefinition {
     inbound?: Record<string, unknown>;
     outbound?: Record<string, unknown>;
     status?: SurfaceDefinitionStatus;
-    environment?: SurfaceDefinitionEnvironment;
 }
 /**
  * Pure-local declarative constructor for a surface definition. No I/O.
@@ -54313,7 +54418,10 @@ declare class ApiKeysEndpoint {
     readonly requests: ApiKeyRequestsEndpoint;
     constructor(client: ApiClient);
     /**
-     * List all API keys for the authenticated user
+     * List the API keys visible to the caller. An organization admin on a Clerk
+     * session receives every key in the organization (each carrying `ownerUserId`,
+     * `ownerName` and `isOwn`); other members, and every API-key caller, receive
+     * only the keys they created. Keys with `isOwn: false` are read-only.
      */
     list(): Promise<ApiKey[]>;
     /**
@@ -55285,7 +55393,7 @@ interface AgentCompleteEvent extends BaseAgentEvent {
     agentId: string;
     success: boolean;
     iterations: number;
-    stopReason: 'complete' | 'end_turn' | 'max_turns' | 'max_cost' | 'timeout' | 'error';
+    stopReason: 'complete' | 'end_turn' | 'max_turns' | 'max_cost' | 'timeout' | 'error' | 'length';
     completedAt: string;
     totalCost?: number;
     totalTokens?: {
@@ -55578,7 +55686,7 @@ interface AgentExecuteResponse {
         input: number;
         output: number;
     };
-    stopReason: 'complete' | 'end_turn' | 'max_turns' | 'max_cost' | 'timeout' | 'error' | 'paused';
+    stopReason: 'complete' | 'end_turn' | 'max_turns' | 'max_cost' | 'timeout' | 'error' | 'paused' | 'length';
     reflections?: string[];
     error?: string;
     /**
@@ -56560,7 +56668,7 @@ declare class AgentVersionsEndpoint {
     /**
      * Publish a version (promote it to the agent's published version).
      */
-    publish(agentId: string, versionId: string): Promise<AgentVersionPublishResponse>;
+    publish(agentId: string, versionId: string, options?: VersionPublishOptions): Promise<AgentVersionPublishResponse>;
 }
 /**
  * Flow Versions endpoint handlers
@@ -56588,7 +56696,7 @@ declare class FlowVersionsEndpoint {
     /**
      * Publish a version (promote it to the flow's published version).
      */
-    publish(flowId: string, versionId: string): Promise<FlowVersionPublishResponse>;
+    publish(flowId: string, versionId: string, options?: VersionPublishOptions): Promise<FlowVersionPublishResponse>;
 }
 /**
  * Integrations endpoint handlers
@@ -58315,4 +58423,4 @@ declare function getLikelySupportingCandidatePaths(bestCandidatePath: string | u
 declare function getDefaultPlanPath(taskName: string): string;
 declare function sanitizeTaskSlug(taskName: string): string;
 
-export { type AIGrader, type Agent, type AgentAdmissionOptions, type AgentApprovalCompleteEvent, type AgentApprovalStartEvent, type AgentCompleteEvent, type AgentDefinition, type AgentDefinitionConfig, 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, type AgentPullResult, type AgentReflectionEvent, 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 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, DispatchEndpoint, type DispatchEnvironment, type DispatchEvent, type DispatchFlowInput, type DispatchMessageContent, type DispatchOptions$1 as DispatchOptions, type DispatchRequest, type DispatchResponse, type DispatchResumeRequest, type DispatchResumeResponse, 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, 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 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 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 HumanVerdict, type ImageContentPart, type InferCollectionSchemaResponse, type Integration, type IntegrationTool, IntegrationsEndpoint, type IntegrationsListResponse, type JSONSchema, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, LEDGER_ARTIFACT_LINE_PREFIX, 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 ModelConfig, ModelConfigsEndpoint, type ModelFallback, type ModelOverride, type ModelUsageDetail, type ModelUsageQueryParams, type ModelUsageResponse, type ModelUsageSummary, type ModelUsageTimeSeries, type PaginationResponse, type PersistedGraderOutcome, type ProductDefinition, ProductDriftError, ProductEnsureConflictError, type ProductPullResult, ProductsNamespace, 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 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 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 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 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 SurfaceDefinitionEnvironment, 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 UpdatedFlow, type UpsertFlowConfig$1 as UpsertFlowConfig, type UpsertOptions, type UpsertRecordStepConfig$1 as UpsertRecordStepConfig, type UserProfile, UsersEndpoint, type ValidateExistingRecordsResponse, type VectorSearchStepConfig$1 as VectorSearchStepConfig, 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, applyGeneratedRuntimeToolProposalToDispatchRequest, attachRuntimeToolsToDispatchRequest, buildAgentAdmissionHeaders, buildEmptySessionNudge, buildGeneratedRuntimeToolGateOutput, buildLedgerOffloadReference, buildPolicyGuidance, buildSendViewOffloadMarker, calledTool, 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, processStream, pullEval, pullFpo, ranStep, regex, registerWorkflowHook, resolveStallStopAfter, resolveWorkflowHook, runEvalSuite, sanitizeTaskSlug, shouldInjectEmptySessionNudge, shouldRequestModelEscalation, stepOrder, streamEvents, toolOrder, unregisterWorkflowHook, usedNoTools, validJson, withDetachedReconnect, withUnifiedEvents };
+export { type AIGrader, type Agent, type AgentAdmissionOptions, type AgentApprovalCompleteEvent, type AgentApprovalStartEvent, type AgentCompleteEvent, type AgentDefinition, type AgentDefinitionConfig, 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, type AgentPullResult, type AgentReflectionEvent, 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 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, DispatchEndpoint, type DispatchEnvironment, type DispatchEvent, type DispatchFlowInput, type DispatchMessageContent, type DispatchOptions$1 as DispatchOptions, type DispatchRequest, type DispatchResponse, type DispatchResumeRequest, type DispatchResumeResponse, 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, 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 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 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 HumanVerdict, type ImageContentPart, type InferCollectionSchemaResponse, type Integration, type IntegrationTool, IntegrationsEndpoint, type IntegrationsListResponse, type JSONSchema, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, LEDGER_ARTIFACT_LINE_PREFIX, 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 ModelConfig, ModelConfigsEndpoint, type ModelFallback, type ModelOverride, type ModelUsageDetail, type ModelUsageQueryParams, type ModelUsageResponse, type ModelUsageSummary, type ModelUsageTimeSeries, type PaginationResponse, type PersistedGraderOutcome, type ProductDefinition, ProductDriftError, ProductEnsureConflictError, type ProductPullResult, ProductsNamespace, 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 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 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 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 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 UpdatedFlow, type UpsertFlowConfig$1 as UpsertFlowConfig, type UpsertOptions, type UpsertRecordStepConfig$1 as UpsertRecordStepConfig, type UserProfile, UsersEndpoint, 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, applyGeneratedRuntimeToolProposalToDispatchRequest, attachRuntimeToolsToDispatchRequest, buildAgentAdmissionHeaders, buildEmptySessionNudge, buildGeneratedRuntimeToolGateOutput, buildLedgerOffloadReference, buildPolicyGuidance, buildSendViewOffloadMarker, calledTool, 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, processStream, pullEval, pullFpo, ranStep, regex, registerWorkflowHook, resolveStallStopAfter, resolveWorkflowHook, runEvalSuite, sanitizeTaskSlug, shouldInjectEmptySessionNudge, shouldRequestModelEscalation, stepOrder, streamEvents, toolOrder, unregisterWorkflowHook, usedNoTools, validJson, withDetachedReconnect, withUnifiedEvents };

package/dist/index.d.ts

@@ -228,6 +228,12 @@ interface paths {
             requestBody?: {
                 content: {
                     "application/json": {
+                        /**
+                         * @description Use overwrite only after confirming replacement of a code-managed agent.
+                         * @default error
+                         * @enum {string}
+                         */
+                        onConflict?: "error" | "overwrite";
                         versionId: string;
                     };
                 };
@@ -241,9 +247,15 @@ interface paths {
                     content: {
                         "application/json": {
                             agentId: string;
+                            applied: {
+                                [key: string]: boolean;
+                            };
+                            /** @enum {string} */
+                            lastModifiedSource: "dashboard" | "api" | "mcp";
                             message: string;
                             success: boolean;
                             versionId: string;
+                            warnings: string[];
                         };
                     };
                 };
@@ -285,6 +297,20 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description Publishing would overwrite a definition managed by code */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"] & {
+                            /** @enum {string} */
+                            code: "managed_by_code_conflict";
+                            /** @enum {string} */
+                            lastModifiedSource: "sdk" | "terraform";
+                        };
+                    };
+                };
                 /** @description Internal server error */
                 500: {
                     headers: {
@@ -713,6 +739,7 @@ interface paths {
                                 maxCost?: number;
                                 maxTurns?: number;
                                 reflectionInterval?: number;
+                                treatLengthCutoffAsFailure?: boolean;
                             };
                             maxTokens?: number;
                             memory?: {
@@ -1143,6 +1170,7 @@ interface paths {
                                     maxCost?: number;
                                     maxTurns?: number;
                                     reflectionInterval?: number;
+                                    treatLengthCutoffAsFailure?: boolean;
                                 };
                                 maxTokens?: number;
                                 memory?: {
@@ -1841,6 +1869,7 @@ interface paths {
                                 maxCost?: number;
                                 maxTurns?: number;
                                 reflectionInterval?: number;
+                                treatLengthCutoffAsFailure?: boolean;
                             };
                             maxTokens?: number;
                             memory?: {
@@ -7692,12 +7721,14 @@ interface paths {
             requestBody: {
                 content: {
                     "application/json": {
+                        durableRecovery?: boolean;
                         flowId?: string;
                         identityProof?: string;
                         token: string;
                         visitorHistory?: boolean;
                         visitorToken?: string;
                     } | {
+                        durableRecovery?: boolean;
                         flowId?: string;
                         identityProof?: string;
                         sessionId: string;
@@ -7706,6 +7737,7 @@ interface paths {
                         visitorToken?: string;
                     } | {
                         conversationId: string;
+                        durableRecovery?: boolean;
                         flowId?: string;
                         identityProof?: string;
                         token: string;
@@ -7713,6 +7745,7 @@ interface paths {
                         visitorToken: string;
                     } | {
                         conversationId: string;
+                        durableRecovery?: boolean;
                         flowId?: string;
                         identityProof: string;
                         token: string;
@@ -7747,6 +7780,11 @@ interface paths {
                             conversationId: string;
                             /** @description Opaque change token for `conversationId` at the moment this session was created. Compare it for equality and nothing else — it is unordered and unparseable. It changes on every transcript mutation, including a display-projection finalization that deliberately leaves `updatedAt` untouched, so a second device or a reloaded tab can tell whether the transcript it holds is still current. */
                             conversationRevision: string;
+                            /** @description Returned when the request negotiates `durableRecovery`. Older servers omit it; clients must then keep ordinary streaming behavior. */
+                            durableRecovery?: {
+                                /** @description Whether this initialized client-token session has the visitor credential and surface policy needed to use the durable execution reconnect route. Reporting only: individual turns still self-identify as durable through replay cursors. */
+                                enabled: boolean;
+                            };
                             /** @description ISO-8601 session idle-expiry timestamp. */
                             expiresAt: string;
                             /** @description Resolved flow or agent for this session. Present on every response except the data-only Runtype App branch, which returns `app` instead. Retained for compatibility: `id` always carries the same value as the canonical top-level `targetId`, which new clients should read instead. */
@@ -7860,6 +7898,8 @@ interface paths {
             requestBody: {
                 content: {
                     "application/json": {
+                        /** @default  */
+                        after?: string;
                         /** @description Id for the assistant message this resumed leg produces. The leg's completion is persisted to the conversation, so sending the id the client already uses locally makes a later re-send of that same message deduplicate exactly instead of by text. Optional and backward compatible. */
                         assistantMessageId?: string;
                         clientTools?: {
@@ -10897,6 +10937,7 @@ interface paths {
                                 maxCost?: number;
                                 maxTurns?: number;
                                 reflectionInterval?: number;
+                                treatLengthCutoffAsFailure?: boolean;
                             };
                             maxTokens?: number;
                             memory?: {
@@ -11272,6 +11313,7 @@ interface paths {
                                 maxCost?: number;
                                 maxTurns?: number;
                                 reflectionInterval?: number;
+                                treatLengthCutoffAsFailure?: boolean;
                             };
                             maxTokens?: number;
                             memory?: {
@@ -16667,6 +16709,12 @@ interface paths {
             requestBody?: {
                 content: {
                     "application/json": {
+                        /**
+                         * @description Use overwrite only after confirming replacement of a code-managed flow.
+                         * @default error
+                         * @enum {string}
+                         */
+                        onConflict?: "error" | "overwrite";
                         versionId: string;
                     };
                 };
@@ -16679,10 +16727,16 @@ interface paths {
                     };
                     content: {
                         "application/json": {
+                            applied: {
+                                [key: string]: boolean;
+                            };
                             flowId: string;
+                            /** @enum {string} */
+                            lastModifiedSource: "dashboard" | "api" | "mcp";
                             message: string;
                             success: boolean;
                             versionId: string;
+                            warnings: string[];
                         };
                     };
                 };
@@ -16724,6 +16778,20 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description Publishing would overwrite a definition managed by code */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"] & {
+                            /** @enum {string} */
+                            code: "managed_by_code_conflict";
+                            /** @enum {string} */
+                            lastModifiedSource: "sdk" | "terraform";
+                        };
+                    };
+                };
                 /** @description Internal server error */
                 500: {
                     headers: {
@@ -28741,6 +28809,7 @@ interface paths {
                     cursor?: string;
                     type?: string;
                     status?: string;
+                    /** @description Retired; answers 400 SURFACE_ENVIRONMENT_RETIRED. */
                     environment?: string;
                 };
                 header?: never;
@@ -28763,7 +28832,11 @@ interface paths {
                                 createdAt: string;
                                 /** @description Canonical public URL of this surface (MCP, API, A2A, AG-UI, webhook, chat). Null for surface types reached through their own channels (Slack, email, schedule, ...). Clients should use this instead of constructing the URL themselves. */
                                 endpoint: string | null;
-                                environment: string;
+                                /**
+                                 * @deprecated
+                                 * @description Always 'production'. Surface environment was retired (ADR 0023); the field is removed together with the retained column.
+                                 */
+                                environment?: string;
                                 id: string;
                                 inbound?: unknown;
                                 name: string;
@@ -28844,10 +28917,7 @@ interface paths {
                     "application/json": {
                         behavior?: unknown;
                         config?: unknown;
-                        /**
-                         * @default development
-                         * @enum {string}
-                         */
+                        /** @enum {string} */
                         environment?: "production" | "development";
                         inbound?: {
                             [key: string]: unknown;
@@ -28875,7 +28945,11 @@ interface paths {
                             createdAt: string;
                             /** @description Canonical public URL of this surface (MCP, API, A2A, AG-UI, webhook, chat). Null for surface types reached through their own channels (Slack, email, schedule, ...). Clients should use this instead of constructing the URL themselves. */
                             endpoint: string | null;
-                            environment: string;
+                            /**
+                             * @deprecated
+                             * @description Always 'production'. Surface environment was retired (ADR 0023); the field is removed together with the retained column.
+                             */
+                            environment?: string;
                             id: string;
                             inbound?: unknown;
                             items: unknown[];
@@ -29199,7 +29273,11 @@ interface paths {
                             createdAt: string;
                             /** @description Canonical public URL of this surface (MCP, API, A2A, AG-UI, webhook, chat). Null for surface types reached through their own channels (Slack, email, schedule, ...). Clients should use this instead of constructing the URL themselves. */
                             endpoint: string | null;
-                            environment: string;
+                            /**
+                             * @deprecated
+                             * @description Always 'production'. Surface environment was retired (ADR 0023); the field is removed together with the retained column.
+                             */
+                            environment?: string;
                             id: string;
                             inbound?: unknown;
                             items: {
@@ -29346,7 +29424,11 @@ interface paths {
                             createdAt: string;
                             /** @description Canonical public URL of this surface (MCP, API, A2A, AG-UI, webhook, chat). Null for surface types reached through their own channels (Slack, email, schedule, ...). Clients should use this instead of constructing the URL themselves. */
                             endpoint: string | null;
-                            environment: string;
+                            /**
+                             * @deprecated
+                             * @description Always 'production'. Surface environment was retired (ADR 0023); the field is removed together with the retained column.
+                             */
+                            environment?: string;
                             id: string;
                             inbound?: unknown;
                             name: string;
@@ -30177,8 +30259,8 @@ interface paths {
             cookie?: never;
         };
         /**
-         * Reveal development surface key
-         * @description Reveal the plaintext of a development (test) surface key. Session-only — API key authentication is rejected.
+         * Reveal test surface key
+         * @description Reveal the plaintext of a test surface key. Session-only — API key authentication is rejected.
          */
         get: {
             parameters: {
@@ -42041,7 +42123,7 @@ interface paths {
         };
         /**
          * List surfaces
-         * @description List product surfaces across the authenticated user/org's products with cursor-based pagination. Supports filtering by product, type, status, and environment. Slack inbound config is returned only for Slack surfaces and only includes safe-to-expose keys.
+         * @description List product surfaces across the authenticated user/org's products with cursor-based pagination. Supports filtering by product, type, and status. Slack inbound config is returned only for Slack surfaces and only includes safe-to-expose keys.
          */
         get: {
             parameters: {
@@ -42051,6 +42133,7 @@ interface paths {
                     productId?: string;
                     type?: string;
                     status?: string;
+                    /** @description Retired; answers 400 SURFACE_ENVIRONMENT_RETIRED. */
                     environment?: string;
                 };
                 header?: never;
@@ -42070,7 +42153,11 @@ interface paths {
                                 createdAt: string;
                                 /** @description Canonical public URL of this surface (MCP, API, A2A, AG-UI, webhook, chat). Null for surface types reached through their own channels (Slack, email, schedule, ...). Clients should use this instead of constructing the URL themselves. */
                                 endpoint: string | null;
-                                environment: string;
+                                /**
+                                 * @deprecated
+                                 * @description Always 'production'. Surface environment was retired (ADR 0023); the field is removed together with the retained column.
+                                 */
+                                environment?: string;
                                 id: string;
                                 inbound: {
                                     appId?: string;
@@ -44817,6 +44904,7 @@ interface components {
                         maxCost?: number;
                         maxTurns?: number;
                         reflectionInterval?: number;
+                        treatLengthCutoffAsFailure?: boolean;
                     };
                     maxTokens?: number;
                     memory?: {
@@ -45744,9 +45832,11 @@ interface components {
                 message: string;
             };
             executionId: string;
+            finalOutput?: string;
             /** @enum {string} */
             kind: "agent" | "flow";
             seq: number;
+            stopReason?: string;
             /** @enum {string} */
             type: "execution_error";
             upgradeUrl?: string;
@@ -48307,6 +48397,14 @@ interface ApiKey {
     createdAt: string;
     updatedAt?: string;
     lastUsedAt?: string;
+    isTestKey?: boolean;
+    canReveal?: boolean;
+    /** User who created the key; differs from the caller only in the organization-admin view. */
+    ownerUserId?: string;
+    /** Owning member's display name or email; populated only for organization admins. */
+    ownerName?: string | null;
+    /** False for a key an organization admin can see but did not create. Such keys are read-only. */
+    isOwn?: boolean;
 }
 interface ModelConfig {
     id: string;
@@ -49355,6 +49453,12 @@ interface AgentVersionPublishResponse {
     message: string;
     agentId: string;
     versionId: string;
+    applied: Record<string, boolean>;
+    warnings: string[];
+    lastModifiedSource: 'dashboard' | 'api' | 'mcp';
+}
+interface VersionPublishOptions {
+    onConflict?: 'error' | 'overwrite';
 }
 interface FlowVersionListItem {
     id: string;
@@ -49377,6 +49481,9 @@ interface FlowVersionPublishResponse {
     message: string;
     flowId: string;
     versionId: string;
+    applied: Record<string, boolean>;
+    warnings: string[];
+    lastModifiedSource: 'dashboard' | 'api' | 'mcp';
 }
 type VersionType = 'published' | 'draft' | 'test' | 'virtual';
 type Integration = paths['/v1/integrations']['get']['responses'][200]['content']['application/json']['integrations'][number];
@@ -52756,12 +52863,10 @@ interface SurfaceContentInput {
     inbound?: Record<string, unknown> | null;
     outbound?: Record<string, unknown> | null;
     status?: string | null;
-    environment?: string | null;
 }
 /** The surface types `ensure` accepts (mirrors the server's createSurfaceSchema). */
 type SurfaceDefinitionType = 'chat' | 'mcp' | 'mcp_code' | 'api' | 'webhook' | 'schedule' | 'a2a' | 'email' | 'slack' | 'sms' | 'imessage' | 'discord' | 'whatsapp' | 'telegram' | 'hosted-page' | 'chrome_extension';
 type SurfaceDefinitionStatus = 'draft' | 'active' | 'paused';
-type SurfaceDefinitionEnvironment = 'production' | 'development';
 /** `defineSurface` input: identity (name) + the convergeable content fields. */
 interface DefineSurfaceInput {
     name: string;
@@ -52770,7 +52875,8 @@ interface DefineSurfaceInput {
     inbound?: Record<string, unknown>;
     outbound?: Record<string, unknown>;
     status?: SurfaceDefinitionStatus;
-    environment?: SurfaceDefinitionEnvironment;
+    /** @deprecated Surface environment was retired (ADR 0023); accepted and dropped. */
+    environment?: 'production' | 'development';
 }
 /** The canonical (wire) definition produced by `defineSurface`. */
 interface SurfaceDefinition {
@@ -52780,7 +52886,6 @@ interface SurfaceDefinition {
     inbound?: Record<string, unknown>;
     outbound?: Record<string, unknown>;
     status?: SurfaceDefinitionStatus;
-    environment?: SurfaceDefinitionEnvironment;
 }
 /**
  * Pure-local declarative constructor for a surface definition. No I/O.
@@ -54313,7 +54418,10 @@ declare class ApiKeysEndpoint {
     readonly requests: ApiKeyRequestsEndpoint;
     constructor(client: ApiClient);
     /**
-     * List all API keys for the authenticated user
+     * List the API keys visible to the caller. An organization admin on a Clerk
+     * session receives every key in the organization (each carrying `ownerUserId`,
+     * `ownerName` and `isOwn`); other members, and every API-key caller, receive
+     * only the keys they created. Keys with `isOwn: false` are read-only.
      */
     list(): Promise<ApiKey[]>;
     /**
@@ -55285,7 +55393,7 @@ interface AgentCompleteEvent extends BaseAgentEvent {
     agentId: string;
     success: boolean;
     iterations: number;
-    stopReason: 'complete' | 'end_turn' | 'max_turns' | 'max_cost' | 'timeout' | 'error';
+    stopReason: 'complete' | 'end_turn' | 'max_turns' | 'max_cost' | 'timeout' | 'error' | 'length';
     completedAt: string;
     totalCost?: number;
     totalTokens?: {
@@ -55578,7 +55686,7 @@ interface AgentExecuteResponse {
         input: number;
         output: number;
     };
-    stopReason: 'complete' | 'end_turn' | 'max_turns' | 'max_cost' | 'timeout' | 'error' | 'paused';
+    stopReason: 'complete' | 'end_turn' | 'max_turns' | 'max_cost' | 'timeout' | 'error' | 'paused' | 'length';
     reflections?: string[];
     error?: string;
     /**
@@ -56560,7 +56668,7 @@ declare class AgentVersionsEndpoint {
     /**
      * Publish a version (promote it to the agent's published version).
      */
-    publish(agentId: string, versionId: string): Promise<AgentVersionPublishResponse>;
+    publish(agentId: string, versionId: string, options?: VersionPublishOptions): Promise<AgentVersionPublishResponse>;
 }
 /**
  * Flow Versions endpoint handlers
@@ -56588,7 +56696,7 @@ declare class FlowVersionsEndpoint {
     /**
      * Publish a version (promote it to the flow's published version).
      */
-    publish(flowId: string, versionId: string): Promise<FlowVersionPublishResponse>;
+    publish(flowId: string, versionId: string, options?: VersionPublishOptions): Promise<FlowVersionPublishResponse>;
 }
 /**
  * Integrations endpoint handlers
@@ -58315,4 +58423,4 @@ declare function getLikelySupportingCandidatePaths(bestCandidatePath: string | u
 declare function getDefaultPlanPath(taskName: string): string;
 declare function sanitizeTaskSlug(taskName: string): string;
 
-export { type AIGrader, type Agent, type AgentAdmissionOptions, type AgentApprovalCompleteEvent, type AgentApprovalStartEvent, type AgentCompleteEvent, type AgentDefinition, type AgentDefinitionConfig, 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, type AgentPullResult, type AgentReflectionEvent, 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 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, DispatchEndpoint, type DispatchEnvironment, type DispatchEvent, type DispatchFlowInput, type DispatchMessageContent, type DispatchOptions$1 as DispatchOptions, type DispatchRequest, type DispatchResponse, type DispatchResumeRequest, type DispatchResumeResponse, 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, 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 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 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 HumanVerdict, type ImageContentPart, type InferCollectionSchemaResponse, type Integration, type IntegrationTool, IntegrationsEndpoint, type IntegrationsListResponse, type JSONSchema, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, LEDGER_ARTIFACT_LINE_PREFIX, 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 ModelConfig, ModelConfigsEndpoint, type ModelFallback, type ModelOverride, type ModelUsageDetail, type ModelUsageQueryParams, type ModelUsageResponse, type ModelUsageSummary, type ModelUsageTimeSeries, type PaginationResponse, type PersistedGraderOutcome, type ProductDefinition, ProductDriftError, ProductEnsureConflictError, type ProductPullResult, ProductsNamespace, 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 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 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 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 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 SurfaceDefinitionEnvironment, 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 UpdatedFlow, type UpsertFlowConfig$1 as UpsertFlowConfig, type UpsertOptions, type UpsertRecordStepConfig$1 as UpsertRecordStepConfig, type UserProfile, UsersEndpoint, type ValidateExistingRecordsResponse, type VectorSearchStepConfig$1 as VectorSearchStepConfig, 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, applyGeneratedRuntimeToolProposalToDispatchRequest, attachRuntimeToolsToDispatchRequest, buildAgentAdmissionHeaders, buildEmptySessionNudge, buildGeneratedRuntimeToolGateOutput, buildLedgerOffloadReference, buildPolicyGuidance, buildSendViewOffloadMarker, calledTool, 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, processStream, pullEval, pullFpo, ranStep, regex, registerWorkflowHook, resolveStallStopAfter, resolveWorkflowHook, runEvalSuite, sanitizeTaskSlug, shouldInjectEmptySessionNudge, shouldRequestModelEscalation, stepOrder, streamEvents, toolOrder, unregisterWorkflowHook, usedNoTools, validJson, withDetachedReconnect, withUnifiedEvents };
+export { type AIGrader, type Agent, type AgentAdmissionOptions, type AgentApprovalCompleteEvent, type AgentApprovalStartEvent, type AgentCompleteEvent, type AgentDefinition, type AgentDefinitionConfig, 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, type AgentPullResult, type AgentReflectionEvent, 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 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, DispatchEndpoint, type DispatchEnvironment, type DispatchEvent, type DispatchFlowInput, type DispatchMessageContent, type DispatchOptions$1 as DispatchOptions, type DispatchRequest, type DispatchResponse, type DispatchResumeRequest, type DispatchResumeResponse, 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, 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 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 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 HumanVerdict, type ImageContentPart, type InferCollectionSchemaResponse, type Integration, type IntegrationTool, IntegrationsEndpoint, type IntegrationsListResponse, type JSONSchema, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, LEDGER_ARTIFACT_LINE_PREFIX, 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 ModelConfig, ModelConfigsEndpoint, type ModelFallback, type ModelOverride, type ModelUsageDetail, type ModelUsageQueryParams, type ModelUsageResponse, type ModelUsageSummary, type ModelUsageTimeSeries, type PaginationResponse, type PersistedGraderOutcome, type ProductDefinition, ProductDriftError, ProductEnsureConflictError, type ProductPullResult, ProductsNamespace, 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 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 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 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 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 UpdatedFlow, type UpsertFlowConfig$1 as UpsertFlowConfig, type UpsertOptions, type UpsertRecordStepConfig$1 as UpsertRecordStepConfig, type UserProfile, UsersEndpoint, 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, applyGeneratedRuntimeToolProposalToDispatchRequest, attachRuntimeToolsToDispatchRequest, buildAgentAdmissionHeaders, buildEmptySessionNudge, buildGeneratedRuntimeToolGateOutput, buildLedgerOffloadReference, buildPolicyGuidance, buildSendViewOffloadMarker, calledTool, 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, processStream, pullEval, pullFpo, ranStep, regex, registerWorkflowHook, resolveStallStopAfter, resolveWorkflowHook, runEvalSuite, sanitizeTaskSlug, shouldInjectEmptySessionNudge, shouldRequestModelEscalation, stepOrder, streamEvents, toolOrder, unregisterWorkflowHook, usedNoTools, validJson, withDetachedReconnect, withUnifiedEvents };

package/dist/index.mjs

@@ -471,7 +471,8 @@ function createAgentEventTranslator() {
             seq,
             agentId,
             success: false,
-            stopReason: "error",
+            // WHY(#7794): Forward the loop verdict like the execution_complete arm; `error` is the no-verdict answer.
+            stopReason: data.stopReason ?? "error",
             error: errorMessage(data.error),
             completedAt: data.completedAt
           })
@@ -5480,7 +5481,8 @@ function normalizeSurfaceDefinition(definition) {
     type: definition.type,
     behavior,
     status: definition.status || "draft",
-    environment: definition.environment || "development"
+    // INVARIANT: Mirrors the shared hash's frozen literal for the retired field; keeps existing configHashes stable.
+    environment: "development"
   };
 }
 async function computeSurfaceContentHash(definition) {
@@ -5492,9 +5494,9 @@ var DEFINE_SURFACE_TOP_LEVEL_KEYS = /* @__PURE__ */ new Set([
   "behavior",
   "inbound",
   "outbound",
-  "status",
-  "environment"
+  "status"
 ]);
+var DEFINE_SURFACE_RETIRED_KEYS = /* @__PURE__ */ new Set(["environment"]);
 var SURFACE_DEFINITION_TYPES = /* @__PURE__ */ new Set([
   "chat",
   "mcp",
@@ -5537,13 +5539,12 @@ function defineSurface(input) {
   if (input.status !== void 0 && !["draft", "active", "paused"].includes(input.status)) {
     throw new Error('defineSurface "status" must be one of: draft, active, paused');
   }
-  if (input.environment !== void 0 && !["production", "development"].includes(input.environment)) {
-    throw new Error('defineSurface "environment" must be one of: production, development');
-  }
-  const unknownKeys = Object.keys(input).filter((key) => !DEFINE_SURFACE_TOP_LEVEL_KEYS.has(key));
+  const unknownKeys = Object.keys(input).filter(
+    (key) => !DEFINE_SURFACE_TOP_LEVEL_KEYS.has(key) && !DEFINE_SURFACE_RETIRED_KEYS.has(key)
+  );
   if (unknownKeys.length > 0) {
     throw new Error(
-      `defineSurface: unknown field(s): ${unknownKeys.join(", ")}. Allowed fields are name, type, behavior, inbound, outbound, status, environment.`
+      `defineSurface: unknown field(s): ${unknownKeys.join(", ")}. Allowed fields are name, type, behavior, inbound, outbound, status.`
     );
   }
   return {
@@ -5552,8 +5553,7 @@ function defineSurface(input) {
     ...input.behavior !== void 0 ? { behavior: input.behavior } : {},
     ...input.inbound !== void 0 ? { inbound: input.inbound } : {},
     ...input.outbound !== void 0 ? { outbound: input.outbound } : {},
-    ...input.status !== void 0 ? { status: input.status } : {},
-    ...input.environment !== void 0 ? { environment: input.environment } : {}
+    ...input.status !== void 0 ? { status: input.status } : {}
   };
 }
 var SurfaceEnsureConflictError = class extends Error {
@@ -6292,7 +6292,7 @@ var Runtype = class {
 
 // src/version.ts
 var FALLBACK_VERSION = "0.0.0";
-var SDK_VERSION = "9.3.1".length > 0 ? "9.3.1" : FALLBACK_VERSION;
+var SDK_VERSION = "9.4.0".length > 0 ? "9.4.0" : FALLBACK_VERSION;
 var RUNTYPE_CLIENT_KIND = "sdk";
 var SDK_USER_AGENT = `runtype-sdk/${SDK_VERSION} (typescript)`;
 
@@ -8871,7 +8871,10 @@ var ApiKeysEndpoint = class {
     this.requests = new ApiKeyRequestsEndpoint(client);
   }
   /**
-   * List all API keys for the authenticated user
+   * List the API keys visible to the caller. An organization admin on a Clerk
+   * session receives every key in the organization (each carrying `ownerUserId`,
+   * `ownerName` and `isOwn`); other members, and every API-key caller, receive
+   * only the keys they created. Keys with `isOwn: false` are read-only.
    */
   async list() {
     const response = await this.client.get(
@@ -12931,9 +12934,10 @@ var AgentVersionsEndpoint = class {
   /**
    * Publish a version (promote it to the agent's published version).
    */
-  async publish(agentId, versionId) {
+  async publish(agentId, versionId, options = {}) {
     return this.client.post(`/agent-versions/${agentId}/publish`, {
-      versionId
+      versionId,
+      ...options
     });
   }
 };
@@ -12962,9 +12966,10 @@ var FlowVersionsEndpoint = class {
   /**
    * Publish a version (promote it to the flow's published version).
    */
-  async publish(flowId, versionId) {
+  async publish(flowId, versionId, options = {}) {
     return this.client.post(`/flow-versions/${flowId}/publish`, {
-      versionId
+      versionId,
+      ...options
     });
   }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtypelabs/sdk",
-  "version": "9.3.1",
+  "version": "9.4.0",
   "type": "module",
   "description": "TypeScript SDK for the Runtype API with fluent methods. Use it to quickly realize AI products, agents, and workflows.",
   "main": "dist/index.cjs",