@tai42/api-client 16.0.0 → 17.0.0

package/dist/client/marketplace-client.d.ts

@@ -0,0 +1,274 @@
+import type { Transport } from './transport';
+/**
+ * The marketplace search filter (GET `/api/marketplace/search` query params).
+ * `tags` is sent as REPEATED `tags` params, one per value; `page` is supplied
+ * per-request by the infinite query, never from the URL. `tier`, `namespace`,
+ * `contract`, and `page_size` are accepted by the route but the v1 UI sends none
+ * of them (every v1 row is official/tai42; the page size stays the server
+ * default) — they exist for contract completeness.
+ */
+export interface MarketplaceSearchQuery {
+    readonly q?: string;
+    readonly kind?: string;
+    readonly category?: string;
+    readonly tags?: string[];
+    readonly namespace?: string;
+    readonly tier?: string;
+    readonly contract?: string;
+    readonly sort?: 'downloads' | 'updated' | 'name' | 'relevance';
+    readonly page?: number;
+    readonly page_size?: number;
+}
+/**
+ * Body for installing / updating a plugin. `ref` is `namespace/name`.
+ *
+ * `env` / `secret_keys` satisfy an mcp-server entry's required `!ENV` markers in
+ * the same transaction that writes the entry: `env` supplies the values,
+ * `secret_keys` marks which land in the secret band. Both omitted for a plain
+ * install (no required markers).
+ *
+ * `route_mounts` maps a route-carrying item name to the base prefix its routes
+ * mount under (the default or the operator's remap); `accept_public_routes`
+ * explicitly consents to the routes served without authentication. Omitted for a
+ * plugin that registers no routes.
+ */
+export interface MarketplaceInstallBody {
+    readonly ref: string;
+    readonly version?: string;
+    readonly env?: Record<string, string>;
+    readonly secret_keys?: string[];
+    readonly route_mounts?: Record<string, string>;
+    readonly accept_public_routes?: boolean;
+}
+/**
+ * Body for previewing an install / update (`POST /api/marketplace/install/preview`):
+ * resolves the spec and computes the routes, collisions, and public rows WITHOUT
+ * side effects. `route_mounts` applies base overrides so the operator sees the
+ * effect of a remap before committing.
+ */
+export interface MarketplaceInstallPreviewBody {
+    readonly ref: string;
+    readonly version?: string;
+    readonly route_mounts?: Record<string, string>;
+}
+/** Body for uninstalling a plugin. */
+export interface MarketplaceUninstallBody {
+    readonly ref: string;
+}
+export declare function marketplaceClient(t: Transport): {
+    searchMarketplace: (query?: MarketplaceSearchQuery, signal?: AbortSignal) => Promise<{
+        listings: {
+            ref: string;
+            namespace: string;
+            name: string;
+            display_name: string | null;
+            icon_url: string | null;
+            package: string | null;
+            description: string;
+            categories: string[];
+            tags: string[];
+            trust_tier: string;
+            pricing: string;
+            latest_version: string | null;
+            downloads: number;
+            updated_at: string;
+            kinds: {
+                kind: string;
+                count: number;
+                names: string[];
+            }[];
+            groups: {
+                name: string;
+                count: number;
+            }[];
+            premium?: boolean | null | undefined;
+        }[];
+        total: number;
+        page: number;
+        page_size: number;
+    }>;
+    getMarketplacePlugin: (namespace: string, name: string, signal?: AbortSignal) => Promise<{
+        namespace: string;
+        name: string;
+        display_name: string | null;
+        icon_url: string | null;
+        package: string | null;
+        description: string;
+        readme_md: string | null;
+        license: string | null;
+        homepage_url: string | null;
+        repository_url: string | null;
+        categories: string[];
+        tags: string[];
+        trust_tier: string;
+        pricing: string;
+        downloads: number;
+        latest: {
+            version: string;
+            contract_range: string | null;
+            status: string;
+            published_at: string | null;
+            items: {
+                kind: string;
+                name: string;
+                description: string;
+                tags: string[];
+                group: string | null;
+                routes?: {
+                    base: string;
+                    paths: {
+                        path: string;
+                        methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+                        public: boolean;
+                    }[];
+                } | null | undefined;
+                required_env?: {
+                    name: string;
+                    secret: boolean;
+                }[] | undefined;
+            }[];
+        } | null;
+        versions: {
+            version: string;
+            contract_range: string | null;
+            status: string;
+            published_at: string | null;
+        }[];
+        source?: "pypi" | "github" | "spec" | null | undefined;
+        docs_url?: string | null | undefined;
+        premium?: boolean | null | undefined;
+    }>;
+    listMarketplaceCategories: (signal?: AbortSignal) => Promise<string[]>;
+    listMarketplaceKinds: (signal?: AbortSignal) => Promise<string[]>;
+    listInstalledMarketplacePlugins: (signal?: AbortSignal) => Promise<{
+        installed: {
+            ref: string;
+            version: string;
+            source: string;
+            delivery: "package" | "descriptor";
+            installed_at: string;
+            latest: string | null;
+            update_available: boolean;
+            incompatible_newer: string | null;
+            missing_upstream: boolean;
+            compat: {
+                status: "unknown" | "compatible" | "incompatible";
+                reason: string | null;
+            };
+            items: {
+                name: string;
+                kind: string;
+            }[];
+            route_mounts: Record<string, string>;
+        }[];
+        quarantined: {
+            name: string;
+            reason: string;
+        }[];
+    }>;
+    previewMarketplaceInstall: (body: MarketplaceInstallPreviewBody, signal?: AbortSignal) => Promise<{
+        ref: string;
+        version: string;
+        items: {
+            item: string;
+            kind: string;
+            base: string;
+            default_base: string;
+            routes: {
+                path: string;
+                full_path: string;
+                methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+                public: boolean;
+            }[];
+        }[];
+        collisions: {
+            item: string;
+            full_path: string;
+            methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+            conflict_owner: string;
+            conflict_path: string;
+        }[];
+        public_routes: {
+            item: string;
+            full_path: string;
+            methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+        }[];
+        new_public_routes: {
+            item: string;
+            full_path: string;
+            methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+        }[];
+        requires_public_acceptance: boolean;
+        required_env: {
+            name: string;
+            secret: boolean;
+        }[];
+        missing_env: string[];
+        delivery: "package" | "descriptor";
+    }>;
+    installMarketplacePlugin: (body: MarketplaceInstallBody) => Promise<{
+        ref: string;
+        version: string;
+        notes: string[];
+        advisories: {
+            id: number;
+            listing: string;
+            affected_versions: string;
+            severity: string;
+            summary: string;
+            created_at: string;
+            withdrawn_at: string | null;
+        }[];
+        routes: {
+            item: string;
+            full_path: string;
+            methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+            public: boolean;
+        }[];
+    }>;
+    uninstallMarketplacePlugin: (body: MarketplaceUninstallBody) => Promise<{
+        ref: string;
+        uninstalled: true;
+        notes: string[];
+    }>;
+    updateMarketplacePlugin: (body: MarketplaceInstallBody) => Promise<{
+        ref: string;
+        version: string;
+        notes: string[];
+        advisories: {
+            id: number;
+            listing: string;
+            affected_versions: string;
+            severity: string;
+            summary: string;
+            created_at: string;
+            withdrawn_at: string | null;
+        }[];
+        routes: {
+            item: string;
+            full_path: string;
+            methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+            public: boolean;
+        }[];
+    }>;
+    upgradeAllMarketplacePlugins: () => Promise<{
+        results: {
+            ref: string;
+            outcome: "failed" | "upgraded" | "up-to-date" | "no-compatible-version";
+            detail: string;
+        }[];
+    }>;
+    getMarketplaceAdvisories: (signal?: AbortSignal) => Promise<{
+        advisories: {
+            id: number;
+            listing: string;
+            affected_versions: string;
+            severity: string;
+            summary: string;
+            created_at: string;
+            withdrawn_at: string | null;
+        }[];
+        fetched_at: string;
+    }>;
+};
+//# sourceMappingURL=marketplace-client.d.ts.map

package/dist/client/marketplace-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace-client.d.ts","sourceRoot":"","sources":["../../src/client/marketplace-client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,CAAC;IAC/D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;CACzC;AAED;;;;;GAKG;AACH,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChD;AAED,sCAAsC;AACtC,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,SAAS;gCAMf,sBAAsB,WAAgB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sCAgB1C,MAAM,QAAQ,MAAM,WAAW,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yCAMvC,WAAW;oCAEhB,WAAW;+CAEA,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;sCAKpB,6BAA6B,WAAW,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qCAMpD,sBAAsB;;;;;;;;;;;;;;;;;;;;uCAEpB,wBAAwB;;;;;oCAE3B,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;wCAMlB,WAAW;;;;;;;;;;;;EAGlD"}

package/dist/client/marketplace-client.js

@@ -0,0 +1,46 @@
+/** Marketplace search, install, update and advisory sub-client. */
+import { encodeSegment } from '../http';
+import * as s from '../schemas';
+export function marketplaceClient(t) {
+    const { req } = t;
+    return {
+        // Browse/search proxy the registry through the app (one origin, one auth);
+        // install/uninstall/update mutate the RUNNING app (pip install + manifest
+        // patch + reload) and return synchronous receipts.
+        searchMarketplace: (query = {}, signal) => req('/api/marketplace/search', s.marketplaceSearchPage, {
+            query: {
+                q: query.q,
+                kind: query.kind,
+                category: query.category,
+                tags: query.tags,
+                namespace: query.namespace,
+                tier: query.tier,
+                contract: query.contract,
+                sort: query.sort,
+                page: query.page,
+                page_size: query.page_size,
+            },
+            signal,
+        }),
+        getMarketplacePlugin: (namespace, name, signal) => req(`/api/marketplace/plugins/${encodeSegment(namespace)}/${encodeSegment(name)}`, s.marketplacePluginDetail, { signal }),
+        listMarketplaceCategories: (signal) => req('/api/marketplace/categories', s.marketplaceCategories, { signal }),
+        listMarketplaceKinds: (signal) => req('/api/marketplace/kinds', s.marketplaceKinds, { signal }),
+        listInstalledMarketplacePlugins: (signal) => req('/api/marketplace/installed', s.marketplaceInstalled, { signal }),
+        // Preview resolves the spec and computes routes/collisions/public rows with
+        // NO side effects, so the install dialog can show absolute paths, block on a
+        // collision, and surface the public routes before the operator commits.
+        previewMarketplaceInstall: (body, signal) => req('/api/marketplace/install/preview', s.marketplaceInstallPreview, {
+            method: 'POST',
+            body,
+            signal,
+        }),
+        installMarketplacePlugin: (body) => req('/api/marketplace/install', s.marketplaceInstallResult, { method: 'POST', body }),
+        uninstallMarketplacePlugin: (body) => req('/api/marketplace/uninstall', s.marketplaceUninstallResult, { method: 'POST', body }),
+        updateMarketplacePlugin: (body) => req('/api/marketplace/update', s.marketplaceInstallResult, { method: 'POST', body }),
+        // Upgrade EVERY installed plugin to its newest compatible version in one
+        // pass; the response is the per-plugin outcome readout.
+        upgradeAllMarketplacePlugins: () => req('/api/marketplace/upgrade-all', s.marketplaceUpgradeAllResult, { method: 'POST' }),
+        getMarketplaceAdvisories: (signal) => req('/api/marketplace/advisories', s.marketplaceAdvisories, { signal }),
+    };
+}
+//# sourceMappingURL=marketplace-client.js.map

package/dist/client/marketplace-client.js.map

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

package/dist/client/mcp-config-schema-client.d.ts

@@ -0,0 +1,5 @@
+import type { Transport } from './transport';
+export declare function mcpConfigSchemaClient(t: Transport): {
+    getMcpConfigSchema: (signal?: AbortSignal) => Promise<Record<string, unknown>>;
+};
+//# sourceMappingURL=mcp-config-schema-client.d.ts.map

package/dist/client/mcp-config-schema-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-config-schema-client.d.ts","sourceRoot":"","sources":["../../src/client/mcp-config-schema-client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,SAAS;kCAGhB,WAAW;EAG5C"}

package/dist/client/mcp-config-schema-client.js

@@ -0,0 +1,9 @@
+/** MCP config-schema read sub-client. */
+import * as s from '../schemas';
+export function mcpConfigSchemaClient(t) {
+    const { req } = t;
+    return {
+        getMcpConfigSchema: (signal) => req('/api/mcp-config/schema', s.jsonSchema, { signal }),
+    };
+}
+//# sourceMappingURL=mcp-config-schema-client.js.map

package/dist/client/mcp-config-schema-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-config-schema-client.js","sourceRoot":"","sources":["../../src/client/mcp-config-schema-client.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,OAAO,KAAK,CAAC,MAAM,YAAY,CAAC;AAGhC,MAAM,UAAU,qBAAqB,CAAC,CAAY;IAChD,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAClB,OAAO;QACL,kBAAkB,EAAE,CAAC,MAAoB,EAAE,EAAE,CAC3C,GAAG,CAAC,wBAAwB,EAAE,CAAC,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,CAAC;KAC1D,CAAC;AACJ,CAAC"}

package/dist/client/notifications-client.d.ts

@@ -0,0 +1,27 @@
+import type { Transport } from './transport';
+export declare function notificationsClient(t: Transport): {
+    listNotifications: (signal?: AbortSignal) => Promise<{
+        notifications: {
+            id: string;
+            message: string;
+            recipient: string | null;
+            created_at: string;
+            audience?: string | null | undefined;
+            media?: unknown[] | null | undefined;
+            template?: {
+                body_parameters: string[];
+                buttons: unknown[];
+                header_media: {
+                    caption: string | null;
+                    filename: string | null;
+                    kind: "image" | "link" | "document" | "video" | "audio";
+                    url: string;
+                } | null;
+                language: string;
+                name: string;
+            } | null | undefined;
+            options?: string[] | null | undefined;
+        }[];
+    }>;
+};
+//# sourceMappingURL=notifications-client.d.ts.map

package/dist/client/notifications-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications-client.d.ts","sourceRoot":"","sources":["../../src/client/notifications-client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,SAAS;iCAKf,WAAW;;;;;;;;;;;;;;;;;;;;;;;EAG3C"}

package/dist/client/notifications-client.js

@@ -0,0 +1,11 @@
+/** Notification-sink listing sub-client. */
+import * as s from '../schemas';
+export function notificationsClient(t) {
+    const { req } = t;
+    return {
+        // The internal notifications sink, newest-first — the messages the `notify_user`
+        // operation records with no channel, so they surface only in this inbox.
+        listNotifications: (signal) => req('/api/notifications', s.notifications, { signal }),
+    };
+}
+//# sourceMappingURL=notifications-client.js.map

package/dist/client/notifications-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications-client.js","sourceRoot":"","sources":["../../src/client/notifications-client.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,OAAO,KAAK,CAAC,MAAM,YAAY,CAAC;AAGhC,MAAM,UAAU,mBAAmB,CAAC,CAAY;IAC9C,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAClB,OAAO;QACL,iFAAiF;QACjF,yEAAyE;QACzE,iBAAiB,EAAE,CAAC,MAAoB,EAAE,EAAE,CAC1C,GAAG,CAAC,oBAAoB,EAAE,CAAC,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,CAAC;KACzD,CAAC;AACJ,CAAC"}

package/dist/client/observability-client.d.ts

@@ -0,0 +1,103 @@
+import type { Transport } from './transport';
+/** The observability-metrics window + bucket size (GET query params). */
+export interface MetricsQuery {
+    readonly from?: string;
+    readonly to?: string;
+    readonly granularity?: string;
+}
+/**
+ * The observability runs filter. List/dict-valued params (`tags`) are
+ * JSON-encoded into the query string; scalars are sent verbatim. Shared by
+ * `listRuns` and the `exportRuns` download.
+ */
+export interface RunsQuery {
+    readonly from?: string;
+    readonly to?: string;
+    readonly tags?: string[];
+    readonly status?: 'error' | 'success';
+    readonly minCost?: number;
+    readonly maxCost?: number;
+    readonly minTokens?: number;
+    readonly maxTokens?: number;
+    readonly minLatencyMs?: number;
+    readonly maxLatencyMs?: number;
+    readonly sort?: string;
+    readonly dir?: 'asc' | 'desc';
+    readonly page?: number;
+    readonly pageSize?: number;
+}
+export declare function observabilityClient(t: Transport): {
+    getObservabilityMetrics: (params?: MetricsQuery, signal?: AbortSignal) => Promise<{
+        summary: {
+            totalRuns: number;
+            totalCost: number;
+            totalTokens: number;
+            averageLatencyMs: number;
+            avgCostPerRun: number;
+            avgTokensPerRun: number;
+            timeToFirstTokenMs: number | null;
+        };
+        timeSeries: {
+            bucket: string | null;
+            runs: number;
+            cost: number;
+            avgLatencyMs: number;
+            totalTokens: number;
+        }[];
+        byModel: {
+            model: string;
+            calls: number;
+            cost: number;
+            totalTokens: number;
+            avgLatencyMs: number;
+        }[];
+        granularity: "hour" | "day" | "week";
+    }>;
+    listRuns: (params?: RunsQuery, signal?: AbortSignal) => Promise<{
+        items: {
+            id: string;
+            traceId: string;
+            createdAt: string | null;
+            tags: string[];
+            status: "error" | "success";
+            cost: number | null;
+            latencyMs: number | null;
+            totalTokens: number | null;
+            inputPreview: unknown;
+            outputPreview: unknown;
+        }[];
+        page: number;
+        nextPage: number | null;
+    }>;
+    getRunTrace: (traceId: string, signal?: AbortSignal) => Promise<{
+        traceId: string;
+        timestamp: string | null;
+        tags: string[];
+        totalCost: number | null;
+        input: unknown;
+        output: unknown;
+        metadata: unknown;
+        spans: {
+            id: string;
+            parentId: string | null;
+            traceId: string | null;
+            name: string | null;
+            type: string | null;
+            level: string | null;
+            statusMessage: string | null;
+            start: string | null;
+            end: string | null;
+            model: string | null;
+            usage: unknown;
+            metadata: unknown;
+            input: unknown;
+            output: unknown;
+            nodeId: string | null;
+        }[];
+    }>;
+    exportTrace: (traceId: string, signal?: AbortSignal) => Promise<Blob>;
+    exportRuns: (params: RunsQuery & {
+        format: "csv" | "json";
+    }, signal?: AbortSignal) => Promise<Blob>;
+};
+//# sourceMappingURL=observability-client.d.ts.map

package/dist/client/observability-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-client.d.ts","sourceRoot":"","sources":["../../src/client/observability-client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,yEAAyE;AACzE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAsBD,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,SAAS;uCAKV,YAAY,WAAgB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;wBAKtD,SAAS,WAAgB,WAAW;;;;;;;;;;;;;;;;2BAEhC,MAAM,WAAW,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;2BAE5B,MAAM,WAAW,WAAW,KAAG,OAAO,CAAC,IAAI,CAAC;yBAKzD,SAAS,GAAG;QAAE,MAAM,EAAE,KAAK,GAAG,MAAM,CAAA;KAAE,WACrC,WAAW,KACnB,OAAO,CAAC,IAAI,CAAC;EAMnB"}

package/dist/client/observability-client.js

@@ -0,0 +1,43 @@
+/** Run metrics, listing, trace and export sub-client. */
+import { apiDownload, encodeSegment } from '../http';
+import * as s from '../schemas';
+/** Flatten a `RunsQuery` to transport params, JSON-encoding the `tags` list. */
+function runsQueryToParams(query) {
+    return {
+        from: query.from,
+        to: query.to,
+        tags: query.tags === undefined ? undefined : JSON.stringify(query.tags),
+        status: query.status,
+        minCost: query.minCost,
+        maxCost: query.maxCost,
+        minTokens: query.minTokens,
+        maxTokens: query.maxTokens,
+        minLatencyMs: query.minLatencyMs,
+        maxLatencyMs: query.maxLatencyMs,
+        sort: query.sort,
+        dir: query.dir,
+        page: query.page,
+        pageSize: query.pageSize,
+    };
+}
+export function observabilityClient(t) {
+    const { config, req } = t;
+    return {
+        // The monitoring-backend dashboard rollups (`GET /api/observability/metrics`),
+        // a JSON aggregate distinct from any raw process-metrics text endpoint.
+        getObservabilityMetrics: (params = {}, signal) => req('/api/observability/metrics', s.dashboardMetrics, {
+            query: { from: params.from, to: params.to, granularity: params.granularity },
+            signal,
+        }),
+        listRuns: (params = {}, signal) => req('/api/observability/runs', s.runsPage, { query: runsQueryToParams(params), signal }),
+        getRunTrace: (traceId, signal) => req(`/api/observability/runs/${encodeSegment(traceId)}/trace`, s.runTrace, { signal }),
+        exportTrace: (traceId, signal) => apiDownload(config, `/api/observability/runs/${encodeSegment(traceId)}/trace/export`, {
+            signal,
+        }),
+        exportRuns: (params, signal) => apiDownload(config, '/api/observability/runs/export', {
+            query: { ...runsQueryToParams(params), format: params.format },
+            signal,
+        }),
+    };
+}
+//# sourceMappingURL=observability-client.js.map

package/dist/client/observability-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-client.js","sourceRoot":"","sources":["../../src/client/observability-client.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAuB,MAAM,SAAS,CAAC;AAC1E,OAAO,KAAK,CAAC,MAAM,YAAY,CAAC;AAgChC,gFAAgF;AAChF,SAAS,iBAAiB,CAAC,KAAgB;IACzC,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC;QACvE,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,CAAY;IAC9C,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAC1B,OAAO;QACL,+EAA+E;QAC/E,wEAAwE;QACxE,uBAAuB,EAAE,CAAC,SAAuB,EAAE,EAAE,MAAoB,EAAE,EAAE,CAC3E,GAAG,CAAC,4BAA4B,EAAE,CAAC,CAAC,gBAAgB,EAAE;YACpD,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE;YAC5E,MAAM;SACP,CAAC;QACJ,QAAQ,EAAE,CAAC,SAAoB,EAAE,EAAE,MAAoB,EAAE,EAAE,CACzD,GAAG,CAAC,yBAAyB,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAC1F,WAAW,EAAE,CAAC,OAAe,EAAE,MAAoB,EAAE,EAAE,CACrD,GAAG,CAAC,2BAA2B,aAAa,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC;QACxF,WAAW,EAAE,CAAC,OAAe,EAAE,MAAoB,EAAiB,EAAE,CACpE,WAAW,CAAC,MAAM,EAAE,2BAA2B,aAAa,CAAC,OAAO,CAAC,eAAe,EAAE;YACpF,MAAM;SACP,CAAC;QACJ,UAAU,EAAE,CACV,MAA8C,EAC9C,MAAoB,EACL,EAAE,CACjB,WAAW,CAAC,MAAM,EAAE,gCAAgC,EAAE;YACpD,KAAK,EAAE,EAAE,GAAG,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;YAC9D,MAAM;SACP,CAAC;KACL,CAAC;AACJ,CAAC"}

package/dist/client/plugins-client.d.ts

@@ -0,0 +1,17 @@
+import type { Transport } from './transport';
+export declare function pluginsClient(t: Transport): {
+    listStudioPlugins: (signal?: AbortSignal) => Promise<{
+        name: string;
+        version: string;
+        api_version: number;
+        entry: string;
+        integrity: Record<string, string>;
+        contributions: {
+            tool_panels: Record<string, string>;
+            pages: string[];
+            settings_tabs: string[];
+            nav_entries: string[];
+        };
+    }[]>;
+};
+//# sourceMappingURL=plugins-client.d.ts.map

package/dist/client/plugins-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins-client.d.ts","sourceRoot":"","sources":["../../src/client/plugins-client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,wBAAgB,aAAa,CAAC,CAAC,EAAE,SAAS;iCAGT,WAAW;;;;;;;;;;;;;EAG3C"}

package/dist/client/plugins-client.js

@@ -0,0 +1,9 @@
+/** Studio front-end plugin registry sub-client. */
+import * as s from '../schemas';
+export function pluginsClient(t) {
+    const { req } = t;
+    return {
+        listStudioPlugins: (signal) => req('/api/plugins', s.studioPluginRegistry, { signal }),
+    };
+}
+//# sourceMappingURL=plugins-client.js.map

package/dist/client/plugins-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins-client.js","sourceRoot":"","sources":["../../src/client/plugins-client.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,OAAO,KAAK,CAAC,MAAM,YAAY,CAAC;AAGhC,MAAM,UAAU,aAAa,CAAC,CAAY;IACxC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAClB,OAAO;QACL,iBAAiB,EAAE,CAAC,MAAoB,EAAE,EAAE,CAC1C,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC,oBAAoB,EAAE,EAAE,MAAM,EAAE,CAAC;KAC1D,CAAC;AACJ,CAAC"}

package/dist/client/policy-client.d.ts

@@ -0,0 +1,37 @@
+import type { Transport } from './transport';
+/**
+ * Body for the fail-closed jq guard (POST `/api/auth/validate-condition`). The guard
+ * compile-checks the inline jq `condition` the author typed. `sample_context` is a
+ * `JqAuthContext`-shaped sample; when present the guard also evaluates the condition
+ * against it and returns the boolean `result` (else `result` is `null`).
+ */
+export interface ValidateConditionBody {
+    readonly condition?: string;
+    readonly sample_context?: Record<string, unknown>;
+}
+export declare function policyClient(t: Transport): {
+    validateCondition: (body: ValidateConditionBody) => Promise<{
+        ok: boolean;
+        result: boolean | null;
+    }>;
+    listPolicyVersions: (userId: string, signal?: AbortSignal) => Promise<{
+        version: number;
+        body: {
+            condition: {
+                content?: string | undefined;
+                id?: string | undefined;
+                kwargs?: Record<string, unknown> | undefined;
+            } | null;
+            policy_data: Record<string, unknown>;
+            scopes: string[];
+        };
+        tags: string[];
+        created_at: string;
+        is_current: boolean;
+    }[]>;
+    rollbackPolicy: (userId: string, version: number) => Promise<{
+        user_id: string;
+        active_version: number;
+    }>;
+};
+//# sourceMappingURL=policy-client.d.ts.map

package/dist/client/policy-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy-client.d.ts","sourceRoot":"","sources":["../../src/client/policy-client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnD;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,SAAS;8BAOX,qBAAqB;;;;iCAKlB,MAAM,WAAW,WAAW;;;;;;;;;;;;;;;6BAMhC,MAAM,WAAW,MAAM;;;;EAMnD"}