@tai42/api-client 19.3.0 → 21.0.0

package/dist/schemas/notifications.d.ts

@@ -1,17 +1,77 @@
 /** Notification-sink record response schemas. */
-import { z } from 'zod';
+import type { z } from 'zod';
 export declare const notification: z.ZodObject<{
+    audience: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    created_at: z.ZodString;
+    footer: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    header: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        caption: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        filename: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        kind: z.ZodEnum<{
+            image: "image";
+            link: "link";
+            document: "document";
+            video: "video";
+            audio: "audio";
+        }>;
+        url: z.ZodString;
+    }, z.core.$strict>>>;
     id: z.ZodString;
+    location: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        address: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        latitude: z.ZodNumber;
+        longitude: z.ZodNumber;
+        name: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>>;
+    media: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        caption: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        filename: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        kind: z.ZodEnum<{
+            image: "image";
+            link: "link";
+            document: "document";
+            video: "video";
+            audio: "audio";
+        }>;
+        url: z.ZodString;
+    }, z.core.$strict>>>>;
     message: z.ZodString;
-    recipient: z.ZodNullable<z.ZodString>;
-    audience: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    media: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnknown>>>;
-    template: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-        body_parameters: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        buttons: z.ZodDefault<z.ZodArray<z.ZodUnknown>>;
-        header_media: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
-            caption: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
-            filename: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+    options: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        description: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        kind: z.ZodDefault<z.ZodLiteral<"reply">>;
+        text: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodDefault<z.ZodLiteral<"link">>;
+        label: z.ZodString;
+        url: z.ZodString;
+    }, z.core.$strict>], "kind">>>>;
+    recipient: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    schema: z.ZodDefault<z.ZodUnknown>;
+    sections: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        rows: z.ZodArray<z.ZodObject<{
+            description: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            kind: z.ZodDefault<z.ZodLiteral<"reply">>;
+            text: z.ZodString;
+        }, z.core.$strict>>;
+        title: z.ZodString;
+    }, z.core.$strict>>>>;
+    template: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        language: z.ZodString;
+        name: z.ZodString;
+        parameters: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    }, z.core.$strict>>>;
+}, z.core.$strip>;
+export type Notification = z.infer<typeof notification>;
+export declare const notifications: z.ZodObject<{
+    notifications: z.ZodArray<z.ZodObject<{
+        audience: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        created_at: z.ZodString;
+        footer: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        header: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+            caption: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            filename: z.ZodDefault<z.ZodNullable<z.ZodString>>;
             kind: z.ZodEnum<{
                 image: "image";
                 link: "link";
@@ -20,41 +80,53 @@ export declare const notification: z.ZodObject<{
                 audio: "audio";
             }>;
             url: z.ZodString;
-        }, z.core.$strip>, z.ZodNull]>>;
-        language: z.ZodString;
-        name: z.ZodString;
-    }, z.core.$strip>>>;
-    options: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
-    created_at: z.ZodString;
-}, z.core.$strip>;
-export type Notification = z.infer<typeof notification>;
-export declare const notifications: z.ZodObject<{
-    notifications: z.ZodArray<z.ZodObject<{
+        }, z.core.$strict>>>;
         id: z.ZodString;
+        location: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+            address: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            latitude: z.ZodNumber;
+            longitude: z.ZodNumber;
+            name: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>>>;
+        media: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            caption: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            filename: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            kind: z.ZodEnum<{
+                image: "image";
+                link: "link";
+                document: "document";
+                video: "video";
+                audio: "audio";
+            }>;
+            url: z.ZodString;
+        }, z.core.$strict>>>>;
         message: z.ZodString;
-        recipient: z.ZodNullable<z.ZodString>;
-        audience: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        media: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnknown>>>;
-        template: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-            body_parameters: z.ZodDefault<z.ZodArray<z.ZodString>>;
-            buttons: z.ZodDefault<z.ZodArray<z.ZodUnknown>>;
-            header_media: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
-                caption: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
-                filename: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
-                kind: z.ZodEnum<{
-                    image: "image";
-                    link: "link";
-                    document: "document";
-                    video: "video";
-                    audio: "audio";
-                }>;
-                url: z.ZodString;
-            }, z.core.$strip>, z.ZodNull]>>;
+        options: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            description: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            kind: z.ZodDefault<z.ZodLiteral<"reply">>;
+            text: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodDefault<z.ZodLiteral<"link">>;
+            label: z.ZodString;
+            url: z.ZodString;
+        }, z.core.$strict>], "kind">>>>;
+        recipient: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        schema: z.ZodDefault<z.ZodUnknown>;
+        sections: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            rows: z.ZodArray<z.ZodObject<{
+                description: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                kind: z.ZodDefault<z.ZodLiteral<"reply">>;
+                text: z.ZodString;
+            }, z.core.$strict>>;
+            title: z.ZodString;
+        }, z.core.$strict>>>>;
+        template: z.ZodDefault<z.ZodNullable<z.ZodObject<{
             language: z.ZodString;
             name: z.ZodString;
-        }, z.core.$strip>>>;
-        options: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
-        created_at: z.ZodString;
+            parameters: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        }, z.core.$strict>>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type Notifications = z.infer<typeof notifications>;

package/dist/schemas/notifications.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../../src/schemas/notifications.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuBvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAExB,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}
+{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../../src/schemas/notifications.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAa7B,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAA6B,CAAC;AACvD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAA8B,CAAC;AACzD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/dist/schemas/notifications.js

@@ -1,38 +1,12 @@
-/** Notification-sink record response schemas. */
-import { z } from 'zod';
-import { channelTemplate } from './served';
+import * as openapi from '../generated/openapi-schemas';
 // The internal notifications sink: the messages the `notify_user` operation records
 // with no channel, so they land only in the Studio inbox. Each record carries the
-// server-minted id + timestamp; `recipient` is null when the message names none.
-// The sink also stores the richer-send forms a notify carried — `media`
-// (images/links shown WITH the message), `template` (a pre-approved out-of-window
-// send), `options` (tappable option labels) — plus the `audience` identity the
-// record is addressed to; the inbox renders them.
-export const notification = z.object({
-    id: z.string(),
-    message: z.string(),
-    // A channel DELIVERY address the message went to; null when the send named none.
-    recipient: z.string().nullable(),
-    // The IDENTITY (a user_id) whose in-app inbox the record is addressed to, distinct
-    // from `recipient`. `.nullish()` accepts both an older record that predates the
-    // field (key omitted) and a broadcast send (explicit null) — both parse to "none".
-    audience: z.string().nullish(),
-    // Display-only media stored WITH the message (images and/or links). Deliberately
-    // LOOSE (`z.array(z.unknown())`), like the interactions frame: each item is
-    // `safeParse`d per item by the renderer against `interactionMediaItem`, so one
-    // malformed/hostile item is a loud per-item notice, never a whole-feed parse
-    // failure that would silently vanish every other notification. `.nullish()` covers
-    // an older record (key omitted) and a plain send (explicit null).
-    media: z.array(z.unknown()).nullish(),
-    // A pre-approved template the notify carried, parsed strictly: a drifting one is a
-    // loud feed-level `ApiSchemaError`, consistent with the record contract.
-    template: channelTemplate.nullish(),
-    // Tappable option labels the notify offered; display-only in the operator inbox
-    // (there is no conversation for the sink to enter). Strictly a string list.
-    options: z.array(z.string()).nullish(),
-    created_at: z.string(),
-});
-export const notifications = z.object({
-    notifications: z.array(notification),
-});
+// server-minted id + timestamp; `recipient` is the channel DELIVERY address the message
+// went to (null when the send named none) and `audience` the IDENTITY (a user_id) whose
+// in-app inbox the record is addressed to. The sink also stores the richer-send forms a
+// notify carried — `media` (images/links shown WITH the message), `template` (a
+// pre-approved out-of-window send), `options`/`sections` (tappable options), `header`,
+// `footer`, `location` and `schema` — and the inbox renders them.
+export const notification = openapi.notificationRecord;
+export const notifications = openapi.notificationListing;
 //# sourceMappingURL=notifications.js.map

package/dist/schemas/notifications.js.map

@@ -1 +1 @@
-{"version":3,"file":"notifications.js","sourceRoot":"","sources":["../../src/schemas/notifications.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,oFAAoF;AACpF,kFAAkF;AAClF,iFAAiF;AACjF,wEAAwE;AACxE,kFAAkF;AAClF,+EAA+E;AAC/E,kDAAkD;AAElD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,iFAAiF;IACjF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,mFAAmF;IACnF,gFAAgF;IAChF,mFAAmF;IACnF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IAC9B,iFAAiF;IACjF,4EAA4E;IAC5E,+EAA+E;IAC/E,6EAA6E;IAC7E,mFAAmF;IACnF,kEAAkE;IAClE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACrC,mFAAmF;IACnF,yEAAyE;IACzE,QAAQ,EAAE,eAAe,CAAC,OAAO,EAAE;IACnC,gFAAgF;IAChF,4EAA4E;IAC5E,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;IACtC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC;CACrC,CAAC,CAAC"}
+{"version":3,"file":"notifications.js","sourceRoot":"","sources":["../../src/schemas/notifications.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,OAAO,MAAM,8BAA8B,CAAC;AAExD,oFAAoF;AACpF,kFAAkF;AAClF,wFAAwF;AACxF,wFAAwF;AACxF,wFAAwF;AACxF,gFAAgF;AAChF,uFAAuF;AACvF,kEAAkE;AAElE,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,kBAAkB,CAAC;AAGvD,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC,mBAAmB,CAAC"}

package/dist/schemas/observability.d.ts

@@ -1,115 +1,217 @@
 /** Run metrics, listing, span and trace response schemas. */
-import { z } from 'zod';
+import type { z } from 'zod';
 export declare const dashboardMetrics: z.ZodObject<{
-    summary: z.ZodObject<{
-        totalRuns: z.ZodNumber;
-        totalCost: z.ZodNumber;
-        totalTokens: z.ZodNumber;
-        averageLatencyMs: z.ZodNumber;
-        avgCostPerRun: z.ZodNumber;
-        avgTokensPerRun: z.ZodNumber;
-        timeToFirstTokenMs: z.ZodNullable<z.ZodNumber>;
-    }, z.core.$strip>;
-    timeSeries: z.ZodArray<z.ZodObject<{
-        bucket: z.ZodNullable<z.ZodString>;
-        runs: z.ZodNumber;
-        cost: z.ZodNumber;
-        avgLatencyMs: z.ZodNumber;
-        totalTokens: z.ZodNumber;
-    }, z.core.$strip>>;
     byModel: z.ZodArray<z.ZodObject<{
-        model: z.ZodString;
+        avgLatencyMs: z.ZodNumber;
         calls: z.ZodNumber;
         cost: z.ZodNumber;
+        model: z.ZodString;
         totalTokens: z.ZodNumber;
-        avgLatencyMs: z.ZodNumber;
     }, z.core.$strip>>;
-    byModelAvailable: z.ZodBoolean;
+    byModelAvailable: z.ZodDefault<z.ZodBoolean>;
     granularity: z.ZodEnum<{
         hour: "hour";
         day: "day";
         week: "week";
     }>;
+    summary: z.ZodObject<{
+        averageLatencyMs: z.ZodNumber;
+        avgCostPerRun: z.ZodNumber;
+        avgTokensPerRun: z.ZodNumber;
+        timeToFirstTokenMs: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        totalCost: z.ZodNumber;
+        totalRuns: z.ZodNumber;
+        totalTokens: z.ZodNumber;
+    }, z.core.$strip>;
+    timeSeries: z.ZodArray<z.ZodObject<{
+        avgLatencyMs: z.ZodNumber;
+        bucket: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        cost: z.ZodNumber;
+        runs: z.ZodNumber;
+        totalTokens: z.ZodNumber;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type DashboardMetrics = z.infer<typeof dashboardMetrics>;
 export declare const run: z.ZodObject<{
+    cost: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    createdAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     id: z.ZodString;
-    traceId: z.ZodString;
-    createdAt: z.ZodNullable<z.ZodString>;
-    tags: z.ZodArray<z.ZodString>;
+    inputPreview: z.ZodUnknown;
+    latencyMs: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    outputPreview: z.ZodUnknown;
     status: z.ZodEnum<{
         error: "error";
         success: "success";
     }>;
-    cost: z.ZodNullable<z.ZodNumber>;
-    latencyMs: z.ZodNullable<z.ZodNumber>;
-    totalTokens: z.ZodNullable<z.ZodNumber>;
-    inputPreview: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
-    outputPreview: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    tags: z.ZodArray<z.ZodString>;
+    totalTokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    traceId: z.ZodString;
 }, z.core.$strip>;
 export type Run = z.infer<typeof run>;
 export declare const runsPage: z.ZodObject<{
     items: z.ZodArray<z.ZodObject<{
+        cost: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        createdAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         id: z.ZodString;
-        traceId: z.ZodString;
-        createdAt: z.ZodNullable<z.ZodString>;
-        tags: z.ZodArray<z.ZodString>;
+        inputPreview: z.ZodUnknown;
+        latencyMs: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        outputPreview: z.ZodUnknown;
         status: z.ZodEnum<{
             error: "error";
             success: "success";
         }>;
-        cost: z.ZodNullable<z.ZodNumber>;
-        latencyMs: z.ZodNullable<z.ZodNumber>;
-        totalTokens: z.ZodNullable<z.ZodNumber>;
-        inputPreview: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
-        outputPreview: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+        tags: z.ZodArray<z.ZodString>;
+        totalTokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        traceId: z.ZodString;
     }, z.core.$strip>>;
+    nextPage: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
     page: z.ZodNumber;
-    nextPage: z.ZodNullable<z.ZodNumber>;
 }, z.core.$strip>;
+/** The neutral span kinds the monitoring backend maps its own observation types onto. */
+export declare const spanKind: z.ZodEnum<{
+    LLM: "LLM";
+    TOOL: "TOOL";
+    CHAIN: "CHAIN";
+    EVENT: "EVENT";
+}>;
+export type SpanKind = z.infer<typeof spanKind>;
+/** One span of a run without its input and output: the light span-tree row. */
+export declare const runSpanOutline: z.ZodObject<{
+    end: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    id: z.ZodString;
+    inputTokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    kind: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+        LLM: "LLM";
+        TOOL: "TOOL";
+        CHAIN: "CHAIN";
+        EVENT: "EVENT";
+    }>>>;
+    level: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    metadata: z.ZodDefault<z.ZodUnknown>;
+    model: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    name: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    outputTokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    parentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    start: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    statusMessage: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    totalTokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    traceId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type RunSpanOutline = z.infer<typeof runSpanOutline>;
 export declare const runSpan: z.ZodObject<{
+    end: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     id: z.ZodString;
-    parentId: z.ZodNullable<z.ZodString>;
-    traceId: z.ZodNullable<z.ZodString>;
-    name: z.ZodNullable<z.ZodString>;
-    type: z.ZodNullable<z.ZodString>;
-    level: z.ZodNullable<z.ZodString>;
-    statusMessage: z.ZodNullable<z.ZodString>;
-    start: z.ZodNullable<z.ZodString>;
-    end: z.ZodNullable<z.ZodString>;
-    model: z.ZodNullable<z.ZodString>;
-    usage: z.ZodNullable<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
-    metadata: z.ZodNullable<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
-    input: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
-    output: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
-    nodeId: z.ZodNullable<z.ZodString>;
+    input: z.ZodDefault<z.ZodUnknown>;
+    inputTokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    kind: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+        LLM: "LLM";
+        TOOL: "TOOL";
+        CHAIN: "CHAIN";
+        EVENT: "EVENT";
+    }>>>;
+    level: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    metadata: z.ZodDefault<z.ZodUnknown>;
+    model: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    name: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    output: z.ZodDefault<z.ZodUnknown>;
+    outputTokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    parentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    start: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    statusMessage: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    totalTokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    traceId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 export type RunSpan = z.infer<typeof runSpan>;
-export declare const runTrace: z.ZodObject<{
+/** A run's span tree (`GET /api/observability/runs/{trace}/trace/outline`). */
+export declare const runTraceOutline: z.ZodObject<{
+    spans: z.ZodArray<z.ZodObject<{
+        end: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        id: z.ZodString;
+        inputTokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        kind: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+            LLM: "LLM";
+            TOOL: "TOOL";
+            CHAIN: "CHAIN";
+            EVENT: "EVENT";
+        }>>>;
+        level: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        metadata: z.ZodDefault<z.ZodUnknown>;
+        model: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        name: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        outputTokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        parentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        start: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        statusMessage: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        totalTokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        traceId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
     traceId: z.ZodString;
-    timestamp: z.ZodNullable<z.ZodString>;
-    tags: z.ZodArray<z.ZodString>;
-    totalCost: z.ZodNullable<z.ZodNumber>;
-    input: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
-    output: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
-    metadata: z.ZodNullable<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+}, z.core.$strip>;
+export type RunTraceOutline = z.infer<typeof runTraceOutline>;
+export declare const runTrace: z.ZodObject<{
+    input: z.ZodDefault<z.ZodUnknown>;
+    metadata: z.ZodDefault<z.ZodUnknown>;
+    output: z.ZodDefault<z.ZodUnknown>;
     spans: z.ZodArray<z.ZodObject<{
+        end: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         id: z.ZodString;
-        parentId: z.ZodNullable<z.ZodString>;
-        traceId: z.ZodNullable<z.ZodString>;
-        name: z.ZodNullable<z.ZodString>;
-        type: z.ZodNullable<z.ZodString>;
-        level: z.ZodNullable<z.ZodString>;
-        statusMessage: z.ZodNullable<z.ZodString>;
-        start: z.ZodNullable<z.ZodString>;
-        end: z.ZodNullable<z.ZodString>;
-        model: z.ZodNullable<z.ZodString>;
-        usage: z.ZodNullable<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
-        metadata: z.ZodNullable<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
-        input: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
-        output: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
-        nodeId: z.ZodNullable<z.ZodString>;
+        input: z.ZodDefault<z.ZodUnknown>;
+        inputTokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        kind: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+            LLM: "LLM";
+            TOOL: "TOOL";
+            CHAIN: "CHAIN";
+            EVENT: "EVENT";
+        }>>>;
+        level: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        metadata: z.ZodDefault<z.ZodUnknown>;
+        model: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        name: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        output: z.ZodDefault<z.ZodUnknown>;
+        outputTokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        parentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        start: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        statusMessage: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        totalTokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        traceId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>>;
+    tags: z.ZodArray<z.ZodString>;
+    timestamp: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    totalCost: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    traceId: z.ZodString;
 }, z.core.$strip>;
 export type RunTrace = z.infer<typeof runTrace>;
+/**
+ * What the monitoring backend serves, in the run list's wire names
+ * (`GET /api/observability/capabilities`): the largest run-list page, the sort keys
+ * it serves, the filter params each sort cannot be combined with, and the metrics
+ * measures and dimensions.
+ */
+export declare const observabilityCapabilities: z.ZodObject<{
+    incompatibleFilters: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
+    metrics: z.ZodObject<{
+        dimensions: z.ZodArray<z.ZodString>;
+        measures: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    pageSizeMax: z.ZodNumber;
+    sortKeys: z.ZodArray<z.ZodEnum<{
+        totalTokens: "totalTokens";
+        cost: "cost";
+        createdAt: "createdAt";
+        latencyMs: "latencyMs";
+    }>>;
+}, z.core.$strip>;
+export type ObservabilityCapabilities = z.infer<typeof observabilityCapabilities>;
+/** One span field's value with every record reference resolved. */
+export declare const resolvedSpanValue: z.ZodObject<{
+    field: z.ZodEnum<{
+        output: "output";
+        input: "input";
+    }>;
+    pointer: z.ZodString;
+    spanId: z.ZodString;
+    traceId: z.ZodString;
+    value: z.ZodDefault<z.ZodUnknown>;
+}, z.core.$strip>;
+export type ResolvedSpanValue = z.infer<typeof resolvedSpanValue>;
 //# sourceMappingURL=observability.d.ts.map

package/dist/schemas/observability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../../src/schemas/observability.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgC3B,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,eAAO,MAAM,GAAG;;;;;;;;;;;;;;iBAWd,CAAC;AACH,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC;AAEtC,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;iBAInB,CAAC;AAEH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;iBAgBlB,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,OAAO,CAAC,CAAC;AAE9C,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;iBASnB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC"}
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../../src/schemas/observability.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAM7B,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAwB,CAAC;AACtD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,eAAO,MAAM,GAAG;;;;;;;;;;;;;;iBAA+B,CAAC;AAChD,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC;AAEtC,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;iBAAgC,CAAC;AAEtD,yFAAyF;AACzF,eAAO,MAAM,QAAQ;;;;;EAAuD,CAAC;AAC7E,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD,+EAA+E;AAC/E,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;iBAA0B,CAAC;AACtD,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;iBAAmB,CAAC;AACxC,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,OAAO,CAAC,CAAC;AAE9C,+EAA+E;AAC/E,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;iBAA8B,CAAC;AAC3D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAuB,CAAC;AAC7C,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;iBAAoC,CAAC;AAC3E,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAElF,mEAAmE;AACnE,eAAO,MAAM,iBAAiB;;;;;;;;;iBAA4B,CAAC;AAC3D,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/schemas/observability.js

@@ -1,77 +1,24 @@
-/** Run metrics, listing, span and trace response schemas. */
-import { z } from 'zod';
-import { jsonValue } from './shared';
-export const dashboardMetrics = z.object({
-    summary: z.object({
-        totalRuns: z.number(),
-        totalCost: z.number(),
-        totalTokens: z.number(),
-        averageLatencyMs: z.number(),
-        avgCostPerRun: z.number(),
-        avgTokensPerRun: z.number(),
-        timeToFirstTokenMs: z.number().nullable(),
-    }),
-    timeSeries: z.array(z.object({
-        bucket: z.string().nullable(),
-        runs: z.number(),
-        cost: z.number(),
-        avgLatencyMs: z.number(),
-        totalTokens: z.number(),
-    })),
-    byModel: z.array(z.object({
-        model: z.string(),
-        calls: z.number(),
-        cost: z.number(),
-        totalTokens: z.number(),
-        avgLatencyMs: z.number(),
-    })),
-    // `false` when the by-model sub-query faulted, so an empty breakdown is
-    // distinguishable from an unavailable one.
-    byModelAvailable: z.boolean(),
-    granularity: z.enum(['hour', 'day', 'week']),
-});
-export const run = z.object({
-    id: z.string(),
-    traceId: z.string(),
-    createdAt: z.string().nullable(),
-    tags: z.array(z.string()),
-    status: z.enum(['error', 'success']),
-    cost: z.number().nullable(),
-    latencyMs: z.number().nullable(),
-    totalTokens: z.number().nullable(),
-    inputPreview: jsonValue,
-    outputPreview: jsonValue,
-});
-export const runsPage = z.object({
-    items: z.array(run),
-    page: z.number(),
-    nextPage: z.number().nullable(),
-});
-export const runSpan = z.object({
-    id: z.string(),
-    parentId: z.string().nullable(),
-    traceId: z.string().nullable(),
-    name: z.string().nullable(),
-    type: z.string().nullable(),
-    level: z.string().nullable(),
-    statusMessage: z.string().nullable(),
-    start: z.string().nullable(),
-    end: z.string().nullable(),
-    model: z.string().nullable(),
-    usage: jsonValue.nullable(),
-    metadata: jsonValue.nullable(),
-    input: jsonValue,
-    output: jsonValue,
-    nodeId: z.string().nullable(),
-});
-export const runTrace = z.object({
-    traceId: z.string(),
-    timestamp: z.string().nullable(),
-    tags: z.array(z.string()),
-    totalCost: z.number().nullable(),
-    input: jsonValue,
-    output: jsonValue,
-    metadata: jsonValue.nullable(),
-    spans: z.array(runSpan),
-});
+import * as openapi from '../generated/openapi-schemas';
+// `byModelAvailable` is `false` when the by-model sub-query faulted, so an empty breakdown is
+// distinguishable from an unavailable one.
+export const dashboardMetrics = openapi.metricsResult;
+export const run = openapi.observabilityRunView;
+export const runsPage = openapi.observabilityRunsPage;
+/** The neutral span kinds the monitoring backend maps its own observation types onto. */
+export const spanKind = openapi.spanOutlineView.shape.kind.unwrap().unwrap();
+/** One span of a run without its input and output: the light span-tree row. */
+export const runSpanOutline = openapi.spanOutlineView;
+export const runSpan = openapi.spanView;
+/** A run's span tree (`GET /api/observability/runs/{trace}/trace/outline`). */
+export const runTraceOutline = openapi.runTraceOutlineView;
+export const runTrace = openapi.runTraceView;
+/**
+ * What the monitoring backend serves, in the run list's wire names
+ * (`GET /api/observability/capabilities`): the largest run-list page, the sort keys
+ * it serves, the filter params each sort cannot be combined with, and the metrics
+ * measures and dimensions.
+ */
+export const observabilityCapabilities = openapi.observabilityCapabilities;
+/** One span field's value with every record reference resolved. */
+export const resolvedSpanValue = openapi.resolvedSpanValue;
 //# sourceMappingURL=observability.js.map