@runtypelabs/sdk 9.14.0 → 9.15.0

package/dist/index.cjs

@@ -14089,7 +14089,7 @@ function transformQueryParams(params) {
 
 // src/version.ts
 var FALLBACK_VERSION = "0.0.0";
-var SDK_VERSION = "9.14.0".length > 0 ? "9.14.0" : FALLBACK_VERSION;
+var SDK_VERSION = "9.15.0".length > 0 ? "9.15.0" : FALLBACK_VERSION;
 var RUNTYPE_CLIENT_KIND = "sdk";
 var SDK_USER_AGENT = `runtype-sdk/${SDK_VERSION} (typescript)`;
 

package/dist/index.d.cts

@@ -2722,6 +2722,8 @@ interface paths {
                                 versionId: string;
                                 versionNumber: number | null;
                             }[];
+                            /** @description Whether an execution that names no version selector already resolves this agent through its `live` alias. False means a save still changes what runs, so moving production needs a publish; true means `live` is authoritative and moving production is an alias activation. */
+                            liveDefault: boolean;
                             nextCursor: string | null;
                         };
                     };
@@ -4547,6 +4549,7 @@ interface paths {
                             /** @enum {string} */
                             executionMode: "attached" | "detached";
                             expiresAt: string | null;
+                            externalObservedApprovals: components["schemas"]["ExternalObservedApprovals"];
                             finalOutput?: unknown;
                             id: string;
                             inputMessages?: unknown;
@@ -25040,7 +25043,7 @@ interface paths {
                     content: {
                         "application/json": {
                             data: {
-                                /** @description True when part of the window could not be read, so entries are missing: historical (R2 SQL) logs were unavailable, or the recent hot tier failed. Rows the hot tier evicted are served from R2 instead, so an eviction sets this only for the part too recent for R2 to have ingested. Absent on healthy responses. */
+                                /** @description True when part of the window could not be read, so entries may be missing. Evicted ordinary rows are recovered from R2 when old enough; receipt-backed recovery remains degraded when source time cannot prove ingestion. Absent on healthy responses. */
                                 degraded?: boolean;
                                 entries: {
                                     [key: string]: unknown;
@@ -25233,7 +25236,7 @@ interface paths {
                                 byType: {
                                     [key: string]: number;
                                 };
-                                /** @description True when part of the window could not be read, so counts are partial: historical (R2 SQL) counts were unavailable, or the recent hot tier failed. Rows the hot tier evicted are counted from R2 instead, so an eviction sets this only for the part too recent for R2 to have ingested. Absent on healthy responses, which are the only ones cached. */
+                                /** @description True when part of the window could not be read, so counts may be partial. Evicted ordinary rows are counted from R2 when old enough; receipt-backed recovery remains degraded when source time cannot prove ingestion. Absent on healthy responses, which are the only ones cached. */
                                 degraded?: boolean;
                                 histogram: {
                                     bucket: string;
@@ -45004,6 +45007,26 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/telemetry/ingest-health": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Inspect OTLP admission, queryability, and durable recovery debt
+         * @description Owner-scoped delivery receipts retained for 30 days. Lag is acceptance to the first positive query probe, not stream ACK latency or a production SLO guarantee. Idle is not proof of sink health. No transcripts or retained payloads are returned. Requires ANALYTICS:READ or AGENTS:READ; TELEMETRY:WRITE alone is append-only.
+         */
+        get: operations["getOtlpIngestHealth"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/tool-approval-grants": {
         parameters: {
             query?: never;
@@ -49038,6 +49061,12 @@ interface components {
             /** @enum {string} */
             targetType: "flow" | "agent";
             updatedAt: string;
+            /** @description Non-blocking findings about this suite. `AGENT_NOT_DEPLOYED` means the target agent has no runnable `live` version, so a run that names no version selector refuses once the live default is on for the organization. */
+            warnings?: {
+                agentId?: string;
+                code: string;
+                message: string;
+            }[];
         };
         EvalSuiteLatestRun: {
             completedAt: string | null;
@@ -49112,6 +49141,12 @@ interface components {
             /** @enum {string} */
             targetType: "flow" | "agent";
             updatedAt: string;
+            /** @description Non-blocking findings about this suite. `AGENT_NOT_DEPLOYED` means the target agent has no runnable `live` version, so a run that names no version selector refuses once the live default is on for the organization. */
+            warnings?: {
+                agentId?: string;
+                code: string;
+                message: string;
+            }[];
         };
         ExecutionStreamEvent: {
             agentId?: string;
@@ -49690,6 +49725,41 @@ interface components {
             type: "custom";
             value?: unknown;
         };
+        /** @description Read-only approval observations within producer traces. Null means history unavailable; an empty lifecycle list means none observed. Structural history survives ingest-fact expiry and is retained when verbose logging is off. */
+        ExternalObservedApprovals: {
+            /** @enum {string} */
+            availability: "observed";
+            lifecycles: {
+                /** @enum {string} */
+                decision: "requested" | "approved" | "denied" | "conflicted";
+                key: string;
+                observations: {
+                    key: string;
+                    /** Format: date-time */
+                    observedAt?: string;
+                    source: {
+                        /** @enum {string} */
+                        attribute: "cloudflare.agents.tool.approval.state";
+                        /** @enum {string} */
+                        kind: "cloudflare-agents";
+                        spanId: string;
+                        traceId: string;
+                    };
+                    /** @enum {string} */
+                    state: "requested" | "approved" | "denied";
+                }[];
+                rawStates: ("requested" | "approved" | "denied")[];
+                /** @enum {boolean} */
+                sourceConflict?: true;
+                toolCallId: string;
+                toolName?: string;
+                toolType?: string;
+            }[];
+            /** @enum {boolean} */
+            truncated?: true;
+            /** @enum {number} */
+            version: 1;
+        } | null;
         FlowEnsureConflict: {
             /** @enum {string} */
             code: "external_modification" | "remote_changed";
@@ -50363,6 +50433,135 @@ interface components {
     headers: never;
     pathItems: never;
 }
+interface operations {
+    getOtlpIngestHealth: {
+        parameters: {
+            query?: {
+                traceId?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Admission and observed delivery health */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        admission: {
+                            activeRequests: number;
+                            availableBytes: number;
+                            availableRecords: number;
+                            maximumConcurrentRequests: number;
+                        };
+                        errors: {
+                            code: string;
+                            records: number;
+                        }[];
+                        lastAcceptedAt: string | null;
+                        observedAt: string;
+                        receiptHistoryDays: number;
+                        /** @enum {string} */
+                        status: "idle" | "observing" | "degraded" | "queryable";
+                        tiers: {
+                            canonical: {
+                                confirmed: number;
+                                maximumConfirmedLagMs: number | null;
+                                oldestPendingAgeMs: number | null;
+                                repairs: number;
+                                waiting: number;
+                            };
+                            hot: {
+                                confirmed: number;
+                                maximumConfirmedLagMs: number | null;
+                                oldestPendingAgeMs: number | null;
+                                repairs: number;
+                                waiting: number;
+                            };
+                            raw: {
+                                confirmed: number;
+                                maximumConfirmedLagMs: number | null;
+                                oldestPendingAgeMs: number | null;
+                                repairs: number;
+                                waiting: number;
+                            };
+                        };
+                        totals: {
+                            accepted: number;
+                            claimConflicts: number;
+                            complete: number;
+                            deleted: number;
+                            exhaustedAttempts: number;
+                            expired: number;
+                            pending: number;
+                            pendingBytes: number;
+                            suppressed: number;
+                        };
+                        trace: {
+                            acceptedAt: string;
+                            completeness: string;
+                            /** @description Receipt counts for this trace only; confirmations require positive tier reads, not stream acknowledgments. */
+                            delivery: {
+                                accepted: number;
+                                canonicalConfirmed: number;
+                                complete: number;
+                                hotConfirmed: number;
+                                pending: number;
+                                rawConfirmed: number;
+                            };
+                            diagnostics: {
+                                [key: string]: unknown;
+                            };
+                            expiresAt: string;
+                            revision: number;
+                            traceId: string;
+                        } | null;
+                    };
+                };
+            };
+            /** @description Invalid trace identity */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Unauthenticated */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Read scope required */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Health state temporarily unavailable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+}
 
 /**
  * Hand-maintained, thin aliases over the GENERATED OpenAPI types.
@@ -54603,6 +54802,18 @@ interface EvalSuiteSummary {
     latestRun: EvalSuiteLatestRun | null;
     createdAt: string;
     updatedAt: string;
+    /**
+     * Non-blocking findings about this suite. `AGENT_NOT_DEPLOYED` means the
+     * target agent archived its `live` alias, so a run naming no version
+     * selector refuses once the live default is on for the organization.
+     */
+    warnings?: EvalSuiteWarning[];
+}
+/** One non-blocking finding about a suite's target. */
+interface EvalSuiteWarning {
+    code: string;
+    message: string;
+    agentId?: string;
 }
 /** A persisted test case. */
 interface EvalSuiteCase {

package/dist/index.d.ts

@@ -2722,6 +2722,8 @@ interface paths {
                                 versionId: string;
                                 versionNumber: number | null;
                             }[];
+                            /** @description Whether an execution that names no version selector already resolves this agent through its `live` alias. False means a save still changes what runs, so moving production needs a publish; true means `live` is authoritative and moving production is an alias activation. */
+                            liveDefault: boolean;
                             nextCursor: string | null;
                         };
                     };
@@ -4547,6 +4549,7 @@ interface paths {
                             /** @enum {string} */
                             executionMode: "attached" | "detached";
                             expiresAt: string | null;
+                            externalObservedApprovals: components["schemas"]["ExternalObservedApprovals"];
                             finalOutput?: unknown;
                             id: string;
                             inputMessages?: unknown;
@@ -25040,7 +25043,7 @@ interface paths {
                     content: {
                         "application/json": {
                             data: {
-                                /** @description True when part of the window could not be read, so entries are missing: historical (R2 SQL) logs were unavailable, or the recent hot tier failed. Rows the hot tier evicted are served from R2 instead, so an eviction sets this only for the part too recent for R2 to have ingested. Absent on healthy responses. */
+                                /** @description True when part of the window could not be read, so entries may be missing. Evicted ordinary rows are recovered from R2 when old enough; receipt-backed recovery remains degraded when source time cannot prove ingestion. Absent on healthy responses. */
                                 degraded?: boolean;
                                 entries: {
                                     [key: string]: unknown;
@@ -25233,7 +25236,7 @@ interface paths {
                                 byType: {
                                     [key: string]: number;
                                 };
-                                /** @description True when part of the window could not be read, so counts are partial: historical (R2 SQL) counts were unavailable, or the recent hot tier failed. Rows the hot tier evicted are counted from R2 instead, so an eviction sets this only for the part too recent for R2 to have ingested. Absent on healthy responses, which are the only ones cached. */
+                                /** @description True when part of the window could not be read, so counts may be partial. Evicted ordinary rows are counted from R2 when old enough; receipt-backed recovery remains degraded when source time cannot prove ingestion. Absent on healthy responses, which are the only ones cached. */
                                 degraded?: boolean;
                                 histogram: {
                                     bucket: string;
@@ -45004,6 +45007,26 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/telemetry/ingest-health": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Inspect OTLP admission, queryability, and durable recovery debt
+         * @description Owner-scoped delivery receipts retained for 30 days. Lag is acceptance to the first positive query probe, not stream ACK latency or a production SLO guarantee. Idle is not proof of sink health. No transcripts or retained payloads are returned. Requires ANALYTICS:READ or AGENTS:READ; TELEMETRY:WRITE alone is append-only.
+         */
+        get: operations["getOtlpIngestHealth"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/tool-approval-grants": {
         parameters: {
             query?: never;
@@ -49038,6 +49061,12 @@ interface components {
             /** @enum {string} */
             targetType: "flow" | "agent";
             updatedAt: string;
+            /** @description Non-blocking findings about this suite. `AGENT_NOT_DEPLOYED` means the target agent has no runnable `live` version, so a run that names no version selector refuses once the live default is on for the organization. */
+            warnings?: {
+                agentId?: string;
+                code: string;
+                message: string;
+            }[];
         };
         EvalSuiteLatestRun: {
             completedAt: string | null;
@@ -49112,6 +49141,12 @@ interface components {
             /** @enum {string} */
             targetType: "flow" | "agent";
             updatedAt: string;
+            /** @description Non-blocking findings about this suite. `AGENT_NOT_DEPLOYED` means the target agent has no runnable `live` version, so a run that names no version selector refuses once the live default is on for the organization. */
+            warnings?: {
+                agentId?: string;
+                code: string;
+                message: string;
+            }[];
         };
         ExecutionStreamEvent: {
             agentId?: string;
@@ -49690,6 +49725,41 @@ interface components {
             type: "custom";
             value?: unknown;
         };
+        /** @description Read-only approval observations within producer traces. Null means history unavailable; an empty lifecycle list means none observed. Structural history survives ingest-fact expiry and is retained when verbose logging is off. */
+        ExternalObservedApprovals: {
+            /** @enum {string} */
+            availability: "observed";
+            lifecycles: {
+                /** @enum {string} */
+                decision: "requested" | "approved" | "denied" | "conflicted";
+                key: string;
+                observations: {
+                    key: string;
+                    /** Format: date-time */
+                    observedAt?: string;
+                    source: {
+                        /** @enum {string} */
+                        attribute: "cloudflare.agents.tool.approval.state";
+                        /** @enum {string} */
+                        kind: "cloudflare-agents";
+                        spanId: string;
+                        traceId: string;
+                    };
+                    /** @enum {string} */
+                    state: "requested" | "approved" | "denied";
+                }[];
+                rawStates: ("requested" | "approved" | "denied")[];
+                /** @enum {boolean} */
+                sourceConflict?: true;
+                toolCallId: string;
+                toolName?: string;
+                toolType?: string;
+            }[];
+            /** @enum {boolean} */
+            truncated?: true;
+            /** @enum {number} */
+            version: 1;
+        } | null;
         FlowEnsureConflict: {
             /** @enum {string} */
             code: "external_modification" | "remote_changed";
@@ -50363,6 +50433,135 @@ interface components {
     headers: never;
     pathItems: never;
 }
+interface operations {
+    getOtlpIngestHealth: {
+        parameters: {
+            query?: {
+                traceId?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Admission and observed delivery health */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        admission: {
+                            activeRequests: number;
+                            availableBytes: number;
+                            availableRecords: number;
+                            maximumConcurrentRequests: number;
+                        };
+                        errors: {
+                            code: string;
+                            records: number;
+                        }[];
+                        lastAcceptedAt: string | null;
+                        observedAt: string;
+                        receiptHistoryDays: number;
+                        /** @enum {string} */
+                        status: "idle" | "observing" | "degraded" | "queryable";
+                        tiers: {
+                            canonical: {
+                                confirmed: number;
+                                maximumConfirmedLagMs: number | null;
+                                oldestPendingAgeMs: number | null;
+                                repairs: number;
+                                waiting: number;
+                            };
+                            hot: {
+                                confirmed: number;
+                                maximumConfirmedLagMs: number | null;
+                                oldestPendingAgeMs: number | null;
+                                repairs: number;
+                                waiting: number;
+                            };
+                            raw: {
+                                confirmed: number;
+                                maximumConfirmedLagMs: number | null;
+                                oldestPendingAgeMs: number | null;
+                                repairs: number;
+                                waiting: number;
+                            };
+                        };
+                        totals: {
+                            accepted: number;
+                            claimConflicts: number;
+                            complete: number;
+                            deleted: number;
+                            exhaustedAttempts: number;
+                            expired: number;
+                            pending: number;
+                            pendingBytes: number;
+                            suppressed: number;
+                        };
+                        trace: {
+                            acceptedAt: string;
+                            completeness: string;
+                            /** @description Receipt counts for this trace only; confirmations require positive tier reads, not stream acknowledgments. */
+                            delivery: {
+                                accepted: number;
+                                canonicalConfirmed: number;
+                                complete: number;
+                                hotConfirmed: number;
+                                pending: number;
+                                rawConfirmed: number;
+                            };
+                            diagnostics: {
+                                [key: string]: unknown;
+                            };
+                            expiresAt: string;
+                            revision: number;
+                            traceId: string;
+                        } | null;
+                    };
+                };
+            };
+            /** @description Invalid trace identity */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Unauthenticated */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Read scope required */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Health state temporarily unavailable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+}
 
 /**
  * Hand-maintained, thin aliases over the GENERATED OpenAPI types.
@@ -54603,6 +54802,18 @@ interface EvalSuiteSummary {
     latestRun: EvalSuiteLatestRun | null;
     createdAt: string;
     updatedAt: string;
+    /**
+     * Non-blocking findings about this suite. `AGENT_NOT_DEPLOYED` means the
+     * target agent archived its `live` alias, so a run naming no version
+     * selector refuses once the live default is on for the organization.
+     */
+    warnings?: EvalSuiteWarning[];
+}
+/** One non-blocking finding about a suite's target. */
+interface EvalSuiteWarning {
+    code: string;
+    message: string;
+    agentId?: string;
 }
 /** A persisted test case. */
 interface EvalSuiteCase {

package/dist/index.mjs

@@ -13875,7 +13875,7 @@ function transformQueryParams(params) {
 
 // src/version.ts
 var FALLBACK_VERSION = "0.0.0";
-var SDK_VERSION = "9.14.0".length > 0 ? "9.14.0" : FALLBACK_VERSION;
+var SDK_VERSION = "9.15.0".length > 0 ? "9.15.0" : FALLBACK_VERSION;
 var RUNTYPE_CLIENT_KIND = "sdk";
 var SDK_USER_AGENT = `runtype-sdk/${SDK_VERSION} (typescript)`;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtypelabs/sdk",
-  "version": "9.14.0",
+  "version": "9.15.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",
@@ -24,7 +24,7 @@
   ],
   "dependencies": {},
   "devDependencies": {
-    "@runtypelabs/shared": "3.49.0",
+    "@runtypelabs/shared": "3.50.0",
     "openapi-typescript": "^7.13.0",
     "tsup": "^8.0.2",
     "typescript": "^6.0.3",