@tai42/api-client 16.0.0 → 16.0.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace.d.ts","sourceRoot":"","sources":["../../src/schemas/marketplace.ts"],"names":[],"mappings":"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"}

package/dist/schemas/marketplace.js

@@ -0,0 +1,387 @@
+/** Marketplace listing, version, install and advisory schemas. */
+import { z } from 'zod';
+/**
+ * The CLOSED HTTP-method enum fixed by the contract's RouteMethod, the one source
+ * for every route-method field (declaration and install/preview responses alike):
+ * a wire method the contract does not define fails loudly as drift rather than
+ * passing through silently.
+ */
+export const routeMethod = z.enum(['GET', 'POST', 'PUT', 'PATCH', 'DELETE']);
+/**
+ * How the plugin is delivered, derived server-side from whether its spec names a
+ * package: `package` is pip-installed, `descriptor` (marketplace `source` `spec`)
+ * installs nothing but the manifest entry. A CLOSED enum, so a wire value the
+ * server does not derive fails loudly as drift.
+ */
+export const marketplaceDelivery = z.enum(['package', 'descriptor']);
+/**
+ * The install-provenance vocabulary a listing/version resolves from: a pip index
+ * (`pypi`), a git tag (`github`), or a descriptor yml (`spec`). CLOSED, so a wire
+ * value outside it fails as drift.
+ */
+export const marketplaceSource = z.enum(['pypi', 'github', 'spec']);
+/**
+ * One env var an item requires before install: its `name` and whether its value is
+ * a `secret` (an OAuth client secret is; a client id or a plain marker var is not).
+ * The install dialog seeds each toggle from `secret` and collects the missing ones.
+ */
+export const marketplaceRequiredEnvVar = z.object({ name: z.string(), secret: z.boolean() });
+/**
+ * One HTTP route an item declares in its `tai-plugin.yml`: a `path` relative to
+ * the item's mount base, the `methods` it answers, and whether it is served
+ * `public` (without authentication). The absolute path an operator sees is
+ * resolved from the base at install time.
+ */
+export const marketplaceRouteDecl = z.object({
+    path: z.string(),
+    methods: z.array(routeMethod),
+    public: z.boolean(),
+});
+/**
+ * A route-carrying item's declared mount: the default `base` prefix the routes
+ * hang off (an operator may remap it at install) and the `paths` it registers.
+ */
+export const marketplaceRoutesDecl = z.object({
+    base: z.string(),
+    paths: z.array(marketplaceRouteDecl),
+});
+/**
+ * One contained item of a marketplace plugin's published version: its kind
+ * (tool / agent / extension / …), name, description, free-form tags, and the
+ * logical group it belongs to (`null` when ungrouped). `routes` is present only
+ * on a route-carrying item (a router or channel); absent/null on every other.
+ * `required_env` is the env vars the item needs before install — but the REGISTRY's
+ * plugin-detail body does NOT carry it per item: required-env is server-computed
+ * (`required_env_for_spec`) and rides the install PREVIEW, never the listing detail,
+ * so the registry OMITS it here and it parses as `undefined`. Optional (not
+ * defaulted) so the type mirrors the wire; the authority the install dialog collects
+ * from is the preview's `required_env`/`missing_env`, never this field.
+ */
+export const marketplaceItem = z.object({
+    kind: z.string(),
+    name: z.string(),
+    description: z.string(),
+    tags: z.array(z.string()),
+    group: z.string().nullable(),
+    routes: marketplaceRoutesDecl.nullish(),
+    required_env: z.array(marketplaceRequiredEnvVar).optional(),
+});
+/**
+ * One kind summary of a search row: an item kind, how many UNGROUPED items of
+ * that kind the listing's latest published version carries, and their names.
+ * The registry orders the array count DESC then kind ASC, and each entry's
+ * `names` ASC; the UI renders in that order.
+ */
+export const marketplaceSearchKind = z.object({
+    kind: z.string(),
+    count: z.number(),
+    names: z.array(z.string()),
+});
+/**
+ * One logical group of a search row: the group name and how many items the
+ * listing's latest published version places in it. The registry orders the
+ * array count DESC then name ASC; the UI renders in that order.
+ */
+export const marketplaceSearchGroup = z.object({
+    name: z.string(),
+    count: z.number(),
+});
+/**
+ * One listing-level search row (`GET /api/marketplace/search`). `ref` is the
+ * "namespace/name" install target, so every row carries enough to link to its
+ * plugin. `latest_version` is nullable defensively; the search relation only
+ * emits listings with a published version. `kinds` summarizes that latest
+ * version's UNGROUPED items; `groups` summarizes its logical groups (`[]` when
+ * none). Both keys are always present.
+ */
+export const marketplaceSearchRow = z.object({
+    ref: z.string(),
+    namespace: z.string(),
+    name: z.string(),
+    display_name: z.string().nullable(),
+    icon_url: z.string().nullable(),
+    // Null for a descriptor listing (`source` `spec`): it names no package.
+    package: z.string().nullable(),
+    description: z.string(),
+    categories: z.array(z.string()),
+    tags: z.array(z.string()),
+    trust_tier: z.string(),
+    pricing: z.string(),
+    // A display-only premium flag: a badge, never a payment surface. Nullable
+    // + optional: an older registry omits it, and it is absent on non-premium rows.
+    premium: z.boolean().nullish(),
+    latest_version: z.string().nullable(),
+    downloads: z.number(),
+    updated_at: z.string(),
+    kinds: z.array(marketplaceSearchKind),
+    groups: z.array(marketplaceSearchGroup),
+});
+/**
+ * One page of listing rows. The wire carries no next-page field — has-next is
+ * COMPUTED: `page * page_size < total`.
+ */
+export const marketplaceSearchPage = z.object({
+    listings: z.array(marketplaceSearchRow),
+    total: z.number(),
+    page: z.number(),
+    page_size: z.number(),
+});
+/**
+ * One version of a listing as the versions list carries it (`version`, its
+ * publication `status`, the `contract_range` it was validated against, and when
+ * it was `published_at`). `contract_range` and `published_at` are null until a
+ * version reaches the published state, so both are nullable.
+ */
+export const marketplaceVersion = z.object({
+    version: z.string(),
+    contract_range: z.string().nullable(),
+    status: z.string(),
+    published_at: z.string().nullable(),
+});
+/**
+ * The listing's latest published version as embedded in its detail: the version
+ * (with the `marketplaceVersion` lifecycle fields) and the items it contains. The
+ * registry's detail body carries NO per-version `delivery` field — delivery is
+ * server-computed from whether the spec names a package, and the detail surface
+ * derives it from the listing's `package` (null ⇒ `descriptor`, else `package`).
+ * Env to collect comes from the install preview (`required_env` / `missing_env`),
+ * never from these items.
+ */
+export const marketplaceLatestVersion = marketplaceVersion.extend({
+    items: z.array(marketplaceItem),
+});
+/** One advisory row; `withdrawn_at` non-null means it no longer applies. */
+export const marketplaceAdvisory = z.object({
+    id: z.number(),
+    // The "namespace/name" listing ref exactly as the registry serves it — the
+    // wire field consumers match installed plugins against.
+    listing: z.string(),
+    affected_versions: z.string(),
+    severity: z.string(),
+    summary: z.string(),
+    created_at: z.string(),
+    withdrawn_at: z.string().nullable(),
+});
+/**
+ * A plugin's full detail (`GET /api/marketplace/plugins/{ns}/{name}`): the
+ * listing, its latest published version (`null` when nothing is published yet,
+ * carrying the contained items), and the known version history.
+ */
+export const marketplacePluginDetail = z.object({
+    namespace: z.string(),
+    name: z.string(),
+    display_name: z.string().nullable(),
+    icon_url: z.string().nullable(),
+    // Null for a descriptor listing (`source` `spec`): it names no package.
+    package: z.string().nullable(),
+    // The install-provenance vocabulary (`pypi` / `github` / `spec`). Nullish: an
+    // older registry omits it, and a listing with nothing published carries none.
+    source: marketplaceSource.nullish(),
+    description: z.string(),
+    readme_md: z.string().nullable(),
+    license: z.string().nullable(),
+    homepage_url: z.string().nullable(),
+    repository_url: z.string().nullable(),
+    // The marketplace-stored docs-site URL: the store is the source, the UI a
+    // link. Nullable + optional: absent on a listing with no published docs.
+    docs_url: z.string().nullish(),
+    categories: z.array(z.string()),
+    tags: z.array(z.string()),
+    trust_tier: z.string(),
+    pricing: z.string(),
+    // A display-only premium flag: a badge, never a payment surface.
+    premium: z.boolean().nullish(),
+    downloads: z.number(),
+    latest: marketplaceLatestVersion.nullable(),
+    versions: z.array(marketplaceVersion),
+});
+/**
+ * One installed plugin's compat verdict against the RUNNING tai42-contract:
+ * `compatible` / `incompatible` per its declared contract range, `unknown` when
+ * no verdict could be computed. `reason` is the human-readable explanation of a
+ * non-`compatible` verdict, `null` when compatible. CLOSED (`.strict()`): the
+ * server is built against exactly this shape, so an unknown key is drift and
+ * throws instead of being stripped.
+ */
+export const marketplaceInstalledCompat = z
+    .object({
+    status: z.enum(['compatible', 'incompatible', 'unknown']),
+    reason: z.string().nullable(),
+})
+    .strict();
+/**
+ * One installed marketplace plugin as the local attribution store records it.
+ * `latest` is the newest registry version (`null` when unknown);
+ * `update_available` advertises only a newer COMPATIBLE version, and
+ * `incompatible_newer` names the newest version blocked by the running
+ * contract (`null` when none), so "an update exists but needs a newer core" is
+ * visible. `missing_upstream` flags a plugin the registry no longer lists.
+ * `compat` is the row's verdict against the running contract. CLOSED, like
+ * every shape of the installed listing.
+ */
+export const marketplaceInstalledPlugin = z
+    .object({
+    ref: z.string(),
+    version: z.string(),
+    source: z.string(),
+    // How the row was delivered: `package` for a pip-installed plugin, `descriptor`
+    // for a descriptor-only plugin whose stored spec names no package.
+    delivery: marketplaceDelivery,
+    installed_at: z.string(),
+    latest: z.string().nullable(),
+    update_available: z.boolean(),
+    incompatible_newer: z.string().nullable(),
+    missing_upstream: z.boolean(),
+    compat: marketplaceInstalledCompat,
+    // The `{kind, name}` of every item this plugin's stored spec provides
+    // (local truth). The connectors page's McpServersSection joins the mcp-server
+    // item names against the manifest's mcp-entry titles to render an
+    // installer-written entry read-only.
+    items: z.array(marketplaceItem.pick({ kind: true, name: true })),
+    // The persisted `{item_name: base}` mount this plugin is installed at (local
+    // truth; `{}` means every item at its declared base). Studio seeds the update
+    // flow and renders routes at the ACTUAL mounted base from this.
+    route_mounts: z.record(z.string(), z.string()),
+})
+    .strict();
+/** One plugin the boot pass quarantined instead of loading, with why. CLOSED. */
+export const marketplaceQuarantinedPlugin = z
+    .object({
+    name: z.string(),
+    reason: z.string(),
+})
+    .strict();
+/**
+ * The installed inventory (`GET /api/marketplace/installed`): the attributed
+ * rows plus every plugin the boot pass quarantined instead of loading. CLOSED.
+ */
+export const marketplaceInstalled = z
+    .object({
+    installed: z.array(marketplaceInstalledPlugin),
+    quarantined: z.array(marketplaceQuarantinedPlugin),
+})
+    .strict();
+/**
+ * One per-plugin outcome of `POST /api/marketplace/upgrade-all`: `upgraded`,
+ * already `up-to-date`, `no-compatible-version` in the registry, or `failed`;
+ * `detail` always carries the human-readable specifics. CLOSED.
+ */
+export const marketplaceUpgradeAllRow = z
+    .object({
+    ref: z.string(),
+    outcome: z.enum(['upgraded', 'up-to-date', 'no-compatible-version', 'failed']),
+    detail: z.string(),
+})
+    .strict();
+/** The whole upgrade-all readout: one outcome row per installed plugin. CLOSED. */
+export const marketplaceUpgradeAllResult = z
+    .object({
+    results: z.array(marketplaceUpgradeAllRow),
+})
+    .strict();
+/** The advisory state for installed plugins, with when it was last fetched. */
+export const marketplaceAdvisories = z.object({
+    advisories: z.array(marketplaceAdvisory),
+    fetched_at: z.string(),
+});
+/** The registry's controlled category list, proxied through the skeleton. */
+export const marketplaceCategories = z.array(z.string());
+/** The registry's controlled item-kind list, proxied through the skeleton. */
+export const marketplaceKinds = z.array(z.string());
+/**
+ * One route the install / update actually mounted: the item that owns it, the
+ * absolute `full_path` it now answers, the `methods`, and whether it is served
+ * `public`. The receipt lists these so the operator sees what was opened where.
+ */
+export const marketplaceMountedRoute = z.object({
+    item: z.string(),
+    full_path: z.string(),
+    methods: z.array(routeMethod),
+    public: z.boolean(),
+});
+/**
+ * The receipt of an install / update: what landed and at which version.
+ * `notes` (env-selected items naming their activating env var) and any
+ * non-critical `advisories` ride BOTH the install and update receipts.
+ * `routes` is the mounted-route list — empty for a plugin that registers none.
+ * The wire also carries `package`, `reload`, and `pip_output`, which the receipt
+ * does not model — zod's default strip drops them; the UI renders the receipt,
+ * not the raw install log.
+ */
+export const marketplaceInstallResult = z.object({
+    ref: z.string(),
+    version: z.string(),
+    notes: z.array(z.string()),
+    advisories: z.array(marketplaceAdvisory),
+    routes: z.array(marketplaceMountedRoute),
+});
+/** One resolved route in an install preview: the declared `path`, its resolved
+ * absolute `full_path`, the `methods`, and whether it is `public`. */
+export const marketplacePreviewRoute = z.object({
+    path: z.string(),
+    full_path: z.string(),
+    methods: z.array(routeMethod),
+    public: z.boolean(),
+});
+/** One route-carrying item in an install preview: its resolved `base` (the
+ * override or the default), the `default_base` it declares, and the routes that
+ * mount under it. */
+export const marketplacePreviewItem = z.object({
+    item: z.string(),
+    kind: z.string(),
+    base: z.string(),
+    default_base: z.string(),
+    routes: z.array(marketplacePreviewRoute),
+});
+/** One collision the preview found: a route whose resolved shape+method clashes
+ * with an already-owned route. `conflict_owner` is `core` or `plugin:<ref>`; the
+ * remedy is to remap the item's base. */
+export const marketplacePreviewCollision = z.object({
+    item: z.string(),
+    full_path: z.string(),
+    methods: z.array(routeMethod),
+    conflict_owner: z.string(),
+    conflict_path: z.string(),
+});
+/** One public route the operator is asked to accept: served WITHOUT
+ * authentication once installed. */
+export const marketplacePreviewPublicRoute = z.object({
+    item: z.string(),
+    full_path: z.string(),
+    methods: z.array(routeMethod),
+});
+/**
+ * The install preview (`POST /api/marketplace/install/preview`): the resolved
+ * routes per item with any base overrides applied, the collisions against the
+ * live registry, the public routes requiring acceptance, and whether acceptance
+ * is required at all. `new_public_routes` narrows to rows not already approved
+ * (the update case); on a fresh install it equals `public_routes`.
+ *
+ * `required_env` is every env var the spec requires with its derived secret-ness;
+ * `missing_env` is the bare names not already present in the env store union
+ * process env (server-computed — the ONE authority the dialog collects), and
+ * `delivery` is the one word the surface shows (`package` / `descriptor`).
+ */
+export const marketplaceInstallPreview = z.object({
+    ref: z.string(),
+    version: z.string(),
+    items: z.array(marketplacePreviewItem),
+    collisions: z.array(marketplacePreviewCollision),
+    public_routes: z.array(marketplacePreviewPublicRoute),
+    new_public_routes: z.array(marketplacePreviewPublicRoute),
+    requires_public_acceptance: z.boolean(),
+    required_env: z.array(marketplaceRequiredEnvVar),
+    missing_env: z.array(z.string()),
+    delivery: marketplaceDelivery,
+});
+/**
+ * The receipt of an uninstall. `notes` carries operator warnings (e.g. a config
+ * provider still selected by its env var); render them like the install
+ * receipt's notes.
+ */
+export const marketplaceUninstallResult = z.object({
+    ref: z.string(),
+    uninstalled: z.literal(true),
+    notes: z.array(z.string()),
+});
+//# sourceMappingURL=marketplace.js.map

package/dist/schemas/marketplace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace.js","sourceRoot":"","sources":["../../src/schemas/marketplace.ts"],"names":[],"mappings":"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"}

package/dist/schemas/notifications.d.ts

@@ -0,0 +1,61 @@
+/** Notification-sink record response schemas. */
+import { z } from 'zod';
+export declare const notification: z.ZodObject<{
+    id: z.ZodString;
+    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]>>;
+        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<{
+        id: z.ZodString;
+        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]>>;
+            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>>;
+}, z.core.$strip>;
+export type Notifications = z.infer<typeof notifications>;
+//# sourceMappingURL=notifications.d.ts.map

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

@@ -0,0 +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;AAWxB,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"}

package/dist/schemas/notifications.js

@@ -0,0 +1,38 @@
+/** Notification-sink record response schemas. */
+import { z } from 'zod';
+import { channelTemplate } from './served';
+// 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),
+});
+//# sourceMappingURL=notifications.js.map

package/dist/schemas/notifications.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.js","sourceRoot":"","sources":["../../src/schemas/notifications.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,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"}

package/dist/schemas/observability.d.ts

@@ -0,0 +1,114 @@
+/** Run metrics, listing, span and trace response schemas. */
+import { 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;
+        calls: z.ZodNumber;
+        cost: z.ZodNumber;
+        totalTokens: z.ZodNumber;
+        avgLatencyMs: z.ZodNumber;
+    }, z.core.$strip>>;
+    granularity: z.ZodEnum<{
+        hour: "hour";
+        day: "day";
+        week: "week";
+    }>;
+}, z.core.$strip>;
+export type DashboardMetrics = z.infer<typeof dashboardMetrics>;
+export declare const run: z.ZodObject<{
+    id: z.ZodString;
+    traceId: z.ZodString;
+    createdAt: z.ZodNullable<z.ZodString>;
+    tags: z.ZodArray<z.ZodString>;
+    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>>;
+}, z.core.$strip>;
+export type Run = z.infer<typeof run>;
+export declare const runsPage: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        traceId: z.ZodString;
+        createdAt: z.ZodNullable<z.ZodString>;
+        tags: z.ZodArray<z.ZodString>;
+        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>>;
+    }, z.core.$strip>>;
+    page: z.ZodNumber;
+    nextPage: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const runSpan: z.ZodObject<{
+    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>;
+}, z.core.$strip>;
+export type RunSpan = z.infer<typeof runSpan>;
+export declare const runTrace: z.ZodObject<{
+    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>>>;
+    spans: z.ZodArray<z.ZodObject<{
+        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>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type RunTrace = z.infer<typeof runTrace>;
+//# sourceMappingURL=observability.d.ts.map

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

@@ -0,0 +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;AAGxB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6B3B,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"}