@runtypelabs/sdk 10.2.0 → 10.2.2

package/dist/index.cjs

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

package/dist/index.d.cts

@@ -25207,9 +25207,7 @@ interface paths {
                     content: {
                         "application/json": {
                             data: {
-                                /** @description True when the historical segment was served by the flat fallback plan because the deduplicating one was rejected, so a re-sent delivery can appear more than once. Absent on healthy responses. */
-                                dedupeFallback?: boolean;
-                                /** @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. */
+                                /** @description True when the live overlay or the audit plane could not be read, so entries from that source are missing. Absent on healthy responses. */
                                 degraded?: boolean;
                                 entries: {
                                     [key: string]: unknown;
@@ -25280,59 +25278,8 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/logs/debug": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Debug R2 SQL diagnostics
-         * @description R2 SQL diagnostic endpoint for troubleshooting log queries. Non-production only.
-         */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Diagnostics returned */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            data?: unknown;
-                            success: boolean;
-                        };
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Not found */
-                404: {
+                /** @description Log store temporarily unavailable; no entries or counts could be read */
+                503: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -25359,25 +25306,17 @@ interface paths {
         };
         /**
          * Read one log entry in full
-         * @description Returns a single log entry, including the model-call transcript the paged list projection omits. Address it either by the span key (traceId, spanId and timestamp) or by the legacy triple (executionId and timestamp, optionally narrowed by requestId, seq or eventName). Bounded to one millisecond of one execution, so a detail read never costs a page.
+         * @description Returns a single log entry, including the model-call transcript the paged list projection omits. Addressed by the span key: traceId, spanId and timestamp. Bounded to one span, so a detail read never costs a page.
          */
         get: {
             parameters: {
                 query: {
-                    /** @description Runtime execution_id / executionSessionId the entry belongs to. Required unless traceId and spanId are given. */
-                    executionId?: string;
-                    /** @description The entry's exact timestamp (ISO 8601) */
+                    /** @description The span's exact started_at (ISO 8601) */
                     timestamp: string;
-                    /** @description Trace the span belongs to. Required with spanId; a span id is unique only within its trace. */
-                    traceId?: string;
-                    /** @description Span to read, from a list row’s otlpSpanId. Requires traceId. */
-                    spanId?: string;
-                    /** @description Narrow to one request */
-                    requestId?: string;
-                    /** @description Narrow to one sequence number */
-                    seq?: string;
-                    /** @description Narrow to one tail event name */
-                    eventName?: string;
+                    /** @description Trace the span belongs to; a span id is unique only within its trace. */
+                    traceId: string;
+                    /** @description Span to read, from a list row’s otlpSpanId. */
+                    spanId: string;
                 };
                 header?: never;
                 path?: never;
@@ -25511,15 +25450,20 @@ interface paths {
                                 byType: {
                                     [key: string]: number;
                                 };
-                                /** @description True when counts came from the flat fallback plan because the deduplicating one was rejected, so a re-sent delivery can be counted more than once. Such a response is never cached. Absent on healthy responses. */
-                                dedupeFallback?: boolean;
-                                /** @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. */
+                                /** @description The span plane’s earliest certified hour for this organization (ISO 8601). Counts before it are not in the store. Null when no hour is certified yet. */
+                                coveredFrom?: string | null;
+                                /** @description True when the live overlay or the audit plane could not be read, so counts are partial. Absent on healthy responses, which are the only ones cached. */
                                 degraded?: boolean;
                                 histogram: {
                                     bucket: string;
                                     count: number;
                                     errors: number;
                                 }[];
+                                /**
+                                 * @description Which tier answered these counts. Always store today; the field exists so a granularity discontinuity is a labeled one rather than an unexplained drop in total.
+                                 * @enum {string}
+                                 */
+                                statsSource?: "store" | "legacy" | "mixed";
                                 total: number;
                             };
                             success: boolean;
@@ -25573,6 +25517,15 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description Log store temporarily unavailable; no entries or counts could be read */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
             };
         };
         put?: never;
@@ -54264,7 +54217,7 @@ interface LogQueryResult {
         cursor: string | null;
         hasMore: boolean;
     };
-    /** True when historical (R2 SQL) logs were unavailable and only recent hot-tier entries are included. */
+    /** True when the live overlay or the audit plane could not be read, so some entries are missing. */
     degraded?: boolean;
 }
 /** The `from`/`to` the API resolved for a logs query, after defaults and aliases. */
@@ -54291,8 +54244,12 @@ interface LogStatsResult {
         count: number;
         errors: number;
     }>;
-    /** True when historical (R2 SQL) counts were unavailable and stats cover only the recent hot-tier window. */
+    /** True when the live overlay or the audit plane could not be read, so counts are partial. */
     degraded?: boolean;
+    /** Which tier answered these counts. Always `store` today. */
+    statsSource?: 'store' | 'legacy' | 'mixed';
+    /** The span plane's earliest certified hour; counts before it are not in the store. */
+    coveredFrom?: string | null;
 }
 interface LogStatsResponse {
     success: boolean;

package/dist/index.d.ts

@@ -25207,9 +25207,7 @@ interface paths {
                     content: {
                         "application/json": {
                             data: {
-                                /** @description True when the historical segment was served by the flat fallback plan because the deduplicating one was rejected, so a re-sent delivery can appear more than once. Absent on healthy responses. */
-                                dedupeFallback?: boolean;
-                                /** @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. */
+                                /** @description True when the live overlay or the audit plane could not be read, so entries from that source are missing. Absent on healthy responses. */
                                 degraded?: boolean;
                                 entries: {
                                     [key: string]: unknown;
@@ -25280,59 +25278,8 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/logs/debug": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Debug R2 SQL diagnostics
-         * @description R2 SQL diagnostic endpoint for troubleshooting log queries. Non-production only.
-         */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Diagnostics returned */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            data?: unknown;
-                            success: boolean;
-                        };
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Not found */
-                404: {
+                /** @description Log store temporarily unavailable; no entries or counts could be read */
+                503: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -25359,25 +25306,17 @@ interface paths {
         };
         /**
          * Read one log entry in full
-         * @description Returns a single log entry, including the model-call transcript the paged list projection omits. Address it either by the span key (traceId, spanId and timestamp) or by the legacy triple (executionId and timestamp, optionally narrowed by requestId, seq or eventName). Bounded to one millisecond of one execution, so a detail read never costs a page.
+         * @description Returns a single log entry, including the model-call transcript the paged list projection omits. Addressed by the span key: traceId, spanId and timestamp. Bounded to one span, so a detail read never costs a page.
          */
         get: {
             parameters: {
                 query: {
-                    /** @description Runtime execution_id / executionSessionId the entry belongs to. Required unless traceId and spanId are given. */
-                    executionId?: string;
-                    /** @description The entry's exact timestamp (ISO 8601) */
+                    /** @description The span's exact started_at (ISO 8601) */
                     timestamp: string;
-                    /** @description Trace the span belongs to. Required with spanId; a span id is unique only within its trace. */
-                    traceId?: string;
-                    /** @description Span to read, from a list row’s otlpSpanId. Requires traceId. */
-                    spanId?: string;
-                    /** @description Narrow to one request */
-                    requestId?: string;
-                    /** @description Narrow to one sequence number */
-                    seq?: string;
-                    /** @description Narrow to one tail event name */
-                    eventName?: string;
+                    /** @description Trace the span belongs to; a span id is unique only within its trace. */
+                    traceId: string;
+                    /** @description Span to read, from a list row’s otlpSpanId. */
+                    spanId: string;
                 };
                 header?: never;
                 path?: never;
@@ -25511,15 +25450,20 @@ interface paths {
                                 byType: {
                                     [key: string]: number;
                                 };
-                                /** @description True when counts came from the flat fallback plan because the deduplicating one was rejected, so a re-sent delivery can be counted more than once. Such a response is never cached. Absent on healthy responses. */
-                                dedupeFallback?: boolean;
-                                /** @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. */
+                                /** @description The span plane’s earliest certified hour for this organization (ISO 8601). Counts before it are not in the store. Null when no hour is certified yet. */
+                                coveredFrom?: string | null;
+                                /** @description True when the live overlay or the audit plane could not be read, so counts are partial. Absent on healthy responses, which are the only ones cached. */
                                 degraded?: boolean;
                                 histogram: {
                                     bucket: string;
                                     count: number;
                                     errors: number;
                                 }[];
+                                /**
+                                 * @description Which tier answered these counts. Always store today; the field exists so a granularity discontinuity is a labeled one rather than an unexplained drop in total.
+                                 * @enum {string}
+                                 */
+                                statsSource?: "store" | "legacy" | "mixed";
                                 total: number;
                             };
                             success: boolean;
@@ -25573,6 +25517,15 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description Log store temporarily unavailable; no entries or counts could be read */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
             };
         };
         put?: never;
@@ -54264,7 +54217,7 @@ interface LogQueryResult {
         cursor: string | null;
         hasMore: boolean;
     };
-    /** True when historical (R2 SQL) logs were unavailable and only recent hot-tier entries are included. */
+    /** True when the live overlay or the audit plane could not be read, so some entries are missing. */
     degraded?: boolean;
 }
 /** The `from`/`to` the API resolved for a logs query, after defaults and aliases. */
@@ -54291,8 +54244,12 @@ interface LogStatsResult {
         count: number;
         errors: number;
     }>;
-    /** True when historical (R2 SQL) counts were unavailable and stats cover only the recent hot-tier window. */
+    /** True when the live overlay or the audit plane could not be read, so counts are partial. */
     degraded?: boolean;
+    /** Which tier answered these counts. Always `store` today. */
+    statsSource?: 'store' | 'legacy' | 'mixed';
+    /** The span plane's earliest certified hour; counts before it are not in the store. */
+    coveredFrom?: string | null;
 }
 interface LogStatsResponse {
     success: boolean;

package/dist/index.mjs

@@ -13934,7 +13934,7 @@ function transformQueryParams(params) {
 
 // src/version.ts
 var FALLBACK_VERSION = "0.0.0";
-var SDK_VERSION = "10.2.0".length > 0 ? "10.2.0" : FALLBACK_VERSION;
+var SDK_VERSION = "10.2.2".length > 0 ? "10.2.2" : 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": "10.2.0",
+  "version": "10.2.2",
   "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.59.0",
+    "@runtypelabs/shared": "3.59.1",
     "openapi-typescript": "^7.13.0",
     "tsup": "^8.0.2",
     "typescript": "^6.0.3",