@cavi-ai/api-client 0.1.0

package/dist/extensions/cavi/fallbacks/snapshots/runs.js

@@ -0,0 +1,133 @@
+import { fallbackSnapshotNow as now } from "./shared.js";
+const fallbackRuns = [
+    {
+        key: "agent:primary-operator:main",
+        title: "Primary Operator Orchestrator",
+        agentId: "primary-operator",
+        channel: "discord",
+        updatedAt: now - 2 * 60_000,
+        status: "active",
+        totalTokens: 138_203,
+        errors: 0,
+        model: "anthropic/claude-sonnet-4",
+        totalCostUsd: 1.24,
+    },
+    {
+        key: "agent:qa-operator:subagent:20260309-1",
+        title: "Inspectah CI Recovery",
+        agentId: "qa-operator",
+        channel: "discord",
+        updatedAt: now - 31 * 60_000,
+        status: "stalled",
+        totalTokens: 42_918,
+        errors: 3,
+        model: "openai/gpt-4o",
+        totalCostUsd: 0.89,
+    },
+    {
+        key: "agent:ui-operator:subagent:20260309-7",
+        title: "Cavi Control UI MVP",
+        agentId: "ui-operator",
+        channel: "webchat",
+        updatedAt: now - 11 * 60_000,
+        status: "idle",
+        totalTokens: 56_477,
+        errors: 0,
+        model: "anthropic/claude-sonnet-4",
+        totalCostUsd: 0.72,
+    },
+    {
+        key: "agent:backend-operator:backend:20260310-1",
+        title: "Backend validation",
+        agentId: "backend-operator",
+        channel: "discord",
+        updatedAt: now - 25 * 60_000,
+        status: "idle",
+        totalTokens: 22_100,
+        errors: 0,
+        model: "openai/gpt-4o-mini",
+        totalCostUsd: 0.31,
+    },
+    {
+        key: "agent:infra-operator:infra:20260310-2",
+        title: "AKS reconcile",
+        agentId: "infra-operator",
+        channel: "discord",
+        updatedAt: now - 55 * 60_000,
+        status: "stalled",
+        totalTokens: 18_400,
+        errors: 2,
+        model: "anthropic/claude-sonnet-4",
+        totalCostUsd: 0.28,
+    },
+];
+export const fallbackAgentRuns = {
+    live: fallbackRuns.filter((run) => run.status === "active" || run.status === "idle"),
+    history: fallbackRuns,
+    summary: {
+        active: fallbackRuns.filter((run) => run.status === "active").length,
+        idle: fallbackRuns.filter((run) => run.status === "idle").length,
+        stalled: fallbackRuns.filter((run) => run.status === "stalled").length,
+        error: fallbackRuns.filter((run) => run.status === "error").length,
+    },
+};
+export function fallbackRunDetailForKey(key) {
+    const run = fallbackRuns.find((entry) => entry.key === key) ?? fallbackRuns[0] ?? null;
+    return {
+        run,
+        preview: {
+            status: run ? "ok" : "missing",
+            items: run
+                ? [
+                    {
+                        role: "system",
+                        text: "Session booted and routing context attached.",
+                        at: now - 18 * 60_000,
+                        eventType: "system",
+                    },
+                    {
+                        role: "user",
+                        text: "Please harden Cavi Control run detail and health UX.",
+                        at: now - 15 * 60_000,
+                        eventType: "user",
+                    },
+                    {
+                        role: "assistant",
+                        text: "Acknowledged. I will scan cavi-control scope and execute a focused patch.",
+                        at: now - 14 * 60_000,
+                        eventType: "assistant",
+                    },
+                    {
+                        role: "tool",
+                        text: "read: cavi-control-ui/src/pages/AgentRunDetailPage.tsx",
+                        at: now - 13 * 60_000,
+                        eventType: "tool",
+                        toolName: "read",
+                        durationMs: 620,
+                    },
+                    {
+                        role: "tool",
+                        text: "edit: cavi-control-ui/src/pages/OverviewPage.tsx",
+                        at: now - 8 * 60_000,
+                        eventType: "tool",
+                        toolName: "edit",
+                        durationMs: 1_120,
+                    },
+                    {
+                        role: "assistant",
+                        text: "Build succeeded. Final validation checklist updated.",
+                        at: now - 5 * 60_000,
+                        eventType: "assistant",
+                    },
+                ]
+                : [],
+        },
+        usage: {
+            totalTokens: run?.totalTokens ?? 0,
+            totalCostUsd: run ? 1.74 : 0,
+            messages: run ? 36 : 0,
+            toolCalls: run ? 14 : 0,
+            errors: run?.errors ?? 0,
+        },
+    };
+}

package/dist/extensions/cavi/fallbacks/snapshots/shared.d.ts

@@ -0,0 +1,2 @@
+export declare const fallbackSnapshotNow: number;
+//# sourceMappingURL=shared.d.ts.map

package/dist/extensions/cavi/fallbacks/snapshots/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../../src/extensions/cavi/fallbacks/snapshots/shared.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,QAAa,CAAC"}

package/dist/extensions/cavi/fallbacks/snapshots/shared.js

@@ -0,0 +1 @@
+export const fallbackSnapshotNow = Date.now();

package/dist/extensions/cavi/index.d.ts

@@ -0,0 +1,27 @@
+export * from "./client.js";
+export * from "./contracts/index.js";
+export * from "./runtime/paths.js";
+export * from "./runtime/env-config.js";
+export * from "./library/client.js";
+export * from "./library/clip.js";
+export * from "./portal/client.js";
+export * from "./portal/tts.js";
+export * from "./adapters/create-cavi-control-adapters.js";
+export * from "./fallbacks/provider.js";
+export * from "./project-board/constants.js";
+export * from "./project-board/fallback.js";
+export * from "./project-board/live.js";
+export * from "./project-board/mutations.js";
+export * from "./project-board/normalize.js";
+export * from "./operator-control/constants.js";
+export * from "./operator-control/defaults.js";
+export * from "./operator-control/load-section.js";
+export { backfillCanonicalTeam, buildAgentMainSessionKey, configureCanonicalOperatorRegistry, configureCanonicalTeamRegistry, getOperatorTeamLookupKeys, getPortalTeamCode, getPortalTeamIdentity, getPortalTeamSectorSlug, getPortalTeamSlug, listCaviTeamPortalIds, listCompiledCanonicalTeams, matchesOperatorTeamIdentifier, matchesTaskTargetToTeam, normalizeSessionAgentId, normalizeSessionKey, normalizeTeamLookupValue, parseAgentSessionKey, resetCanonicalOperatorRegistry, resolveCompiledCanonicalTeam, resolvePortalPrimarySessionKey, resolveTeamSessionAgentId, resolveTeamSessionKey, sessionKeysEqual, type CaviTeamPortalId, type ParsedAgentSessionKey, } from "./registry/canonical-team-registry.js";
+export { PORTAL_CLIENT_ID_HEADER } from "../../core/http/client-id.js";
+export * from "./registry/portal-library-registry.js";
+export * from "./discourse/contracts.js";
+export * from "./discourse/normalize.js";
+export * from "./domain/index.js";
+export * from "./registry/team-registry.js";
+export * from "./registry/team-registry-config.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/extensions/cavi/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extensions/cavi/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,4CAA4C,CAAC;AAC3D,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC;AACnD,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,kCAAkC,EAClC,8BAA8B,EAC9B,yBAAyB,EACzB,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,EACrB,0BAA0B,EAC1B,6BAA6B,EAC7B,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACpB,8BAA8B,EAC9B,4BAA4B,EAC5B,8BAA8B,EAC9B,yBAAyB,EACzB,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,cAAc,uCAAuC,CAAC;AACtD,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oCAAoC,CAAC"}

package/dist/extensions/cavi/index.js

@@ -0,0 +1,26 @@
+export * from "./client.js";
+export * from "./contracts/index.js";
+export * from "./runtime/paths.js";
+export * from "./runtime/env-config.js";
+export * from "./library/client.js";
+export * from "./library/clip.js";
+export * from "./portal/client.js";
+export * from "./portal/tts.js";
+export * from "./adapters/create-cavi-control-adapters.js";
+export * from "./fallbacks/provider.js";
+export * from "./project-board/constants.js";
+export * from "./project-board/fallback.js";
+export * from "./project-board/live.js";
+export * from "./project-board/mutations.js";
+export * from "./project-board/normalize.js";
+export * from "./operator-control/constants.js";
+export * from "./operator-control/defaults.js";
+export * from "./operator-control/load-section.js";
+export { backfillCanonicalTeam, buildAgentMainSessionKey, configureCanonicalOperatorRegistry, configureCanonicalTeamRegistry, getOperatorTeamLookupKeys, getPortalTeamCode, getPortalTeamIdentity, getPortalTeamSectorSlug, getPortalTeamSlug, listCaviTeamPortalIds, listCompiledCanonicalTeams, matchesOperatorTeamIdentifier, matchesTaskTargetToTeam, normalizeSessionAgentId, normalizeSessionKey, normalizeTeamLookupValue, parseAgentSessionKey, resetCanonicalOperatorRegistry, resolveCompiledCanonicalTeam, resolvePortalPrimarySessionKey, resolveTeamSessionAgentId, resolveTeamSessionKey, sessionKeysEqual, } from "./registry/canonical-team-registry.js";
+export { PORTAL_CLIENT_ID_HEADER } from "../../core/http/client-id.js";
+export * from "./registry/portal-library-registry.js";
+export * from "./discourse/contracts.js";
+export * from "./discourse/normalize.js";
+export * from "./domain/index.js";
+export * from "./registry/team-registry.js";
+export * from "./registry/team-registry-config.js";

package/dist/extensions/cavi/library/api.d.ts

@@ -0,0 +1,18 @@
+type LibraryApiMutationMethod = "POST" | "PUT" | "PATCH" | "DELETE";
+export type LibraryApiRequestJson = <TData>(path: string, init?: {
+    method?: LibraryApiMutationMethod;
+    body?: unknown;
+}) => Promise<TData>;
+export declare function fetchLibraryApiJson<T>(path: string, clientId: string, authToken: string | null, options?: {
+    method?: string;
+    body?: unknown;
+    signal?: AbortSignal;
+    cache?: RequestCache;
+}): Promise<T>;
+export declare function requestLibraryApiJson<T>(requestJson: LibraryApiRequestJson, path: string, options?: {
+    method?: LibraryApiMutationMethod;
+    body?: unknown;
+    query?: Record<string, string | number | boolean | undefined>;
+}): Promise<T>;
+export {};
+//# sourceMappingURL=api.d.ts.map

package/dist/extensions/cavi/library/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cavi/library/api.ts"],"names":[],"mappings":"AAaA,KAAK,wBAAwB,GACzB,MAAM,GACN,KAAK,GACL,OAAO,GACP,QAAQ,CAAC;AAEb,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EACxC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;IACL,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAClC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,KACE,OAAO,CAAC,KAAK,CAAC,CAAC;AAEpB,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB,GACA,OAAO,CAAC,CAAC,CAAC,CAgDZ;AAED,wBAAsB,qBAAqB,CAAC,CAAC,EAC3C,WAAW,EAAE,qBAAqB,EAClC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAClC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;CAC/D,GACA,OAAO,CAAC,CAAC,CAAC,CAaZ"}

package/dist/extensions/cavi/library/api.js

@@ -0,0 +1,67 @@
+import { HttpApiError } from "../../../core/http/errors.js";
+import { createRawHttpApiClient, toHttpRequestInit, } from "../../../core/http/raw-client.js";
+import { buildGatewayAuthHeaders, resolveGatewayRequestCredentials, } from "../../../core/gateway/client/fetch.js";
+import { extractGatewayErrorDetails } from "../../../core/gateway/client/error-details.js";
+import { appendHttpQuery, resolveLibraryApiPath } from "../contracts/paths.js";
+import { isSessionAuthMode } from "../runtime/standalone-mode.js";
+export async function fetchLibraryApiJson(path, clientId, authToken, options) {
+    const sessionAuthMode = isSessionAuthMode();
+    const headers = buildGatewayAuthHeaders(clientId, authToken, {
+        includeBearerToken: !sessionAuthMode,
+    });
+    const init = {
+        method: options?.method ?? "GET",
+        signal: options?.signal,
+        cache: options?.cache ?? "no-store",
+    };
+    if (options && "body" in options) {
+        headers["Content-Type"] = "application/json";
+        init.body = JSON.stringify(options.body);
+    }
+    const credentials = resolveGatewayRequestCredentials(sessionAuthMode);
+    const client = createRawHttpApiClient({
+        surface: "library-api",
+        baseUrl: "",
+        authToken: sessionAuthMode ? null : authToken,
+        clientId,
+        credentials,
+    });
+    const response = await client.raw(resolveLibraryApiPath(path), toHttpRequestInit({
+        ...init,
+        ...(credentials ? { credentials } : {}),
+    }, headers)).catch((error) => {
+        if (error instanceof HttpApiError && error.status > 0) {
+            const payload = parseLibraryApiPayload(error.body, error.status);
+            const fallbackMessage = error.body.trim() || `Request failed (${error.status})`;
+            throw new Error(extractGatewayErrorDetails(payload).message ?? fallbackMessage);
+        }
+        throw error;
+    });
+    const raw = await response.text();
+    const payload = parseLibraryApiPayload(raw, response.status);
+    if (payload === null) {
+        throw new Error("Empty response.");
+    }
+    return payload;
+}
+export async function requestLibraryApiJson(requestJson, path, options) {
+    const requestPath = appendHttpQuery(resolveLibraryApiPath(path), options?.query);
+    const init = options && (options.method !== undefined || "body" in options)
+        ? {
+            method: options.method,
+            body: options.body,
+        }
+        : undefined;
+    return await requestJson(requestPath, init);
+}
+function parseLibraryApiPayload(raw, status) {
+    if (!raw) {
+        return null;
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        throw new Error(raw.trim() || `Librarian error (${status})`);
+    }
+}

package/dist/extensions/cavi/library/client.d.ts

@@ -0,0 +1,51 @@
+import { BaseHttpApiClient } from "../../../core/http/client.js";
+import type { HttpApiClientOptions, HttpApiTransport } from "../../../core/http/types.js";
+export type LibraryIngestSource = {
+    kind: "url" | "text" | "file" | "note";
+    uri?: string;
+    title?: string;
+    text?: string;
+    mimeType?: string;
+    metadata?: Record<string, unknown>;
+};
+export type LibraryIngestRequest = {
+    source: LibraryIngestSource;
+    workspaceId?: string;
+    channelId?: string;
+    threadId?: string;
+    requestedBy?: string;
+};
+export type LibraryIngestResult = {
+    accepted: boolean;
+    id?: string;
+    jobId?: string;
+    message?: string;
+    errors?: Array<{
+        field?: string;
+        message: string;
+    }>;
+};
+export declare class LibraryApiClient extends BaseHttpApiClient {
+    readonly endpoints: {
+        readonly root: "/library/api";
+        readonly search: "/library/api/search";
+        readonly ingest: "/library/api/ingest";
+        readonly documents: "/library/api/documents";
+        readonly fleetStatus: "/library/api/fleet-status";
+        readonly status: "/library/api/status";
+        readonly inbox: "/library/api/inbox";
+        readonly promotable: "/library/api/promotable";
+        readonly reviewRequests: "/library/api/review-requests";
+        readonly clip: "/library/api/clip";
+        readonly clipHealth: "/library/api/clip/health";
+        readonly clipSchema: "/library/api/clip/schema";
+        readonly clipLogs: "/library/api/clip/logs";
+        readonly document: (id: string) => string;
+    };
+    readonly request: HttpApiTransport;
+    constructor(options: HttpApiClientOptions);
+    ingest(body: LibraryIngestRequest, idempotencyKey?: string): Promise<LibraryIngestResult>;
+    search<T = unknown>(query: Record<string, string | number | boolean | undefined>): Promise<T>;
+    getDocument<T = unknown>(id: string): Promise<T>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/extensions/cavi/library/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cavi/library/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE1F,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD,CAAC;AAEF,qBAAa,gBAAiB,SAAQ,iBAAiB;IACrD,QAAQ,CAAC,SAAS;;;;;;;;;;;;;;;MAAyB;IAC3C,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;gBAEvB,OAAO,EAAE,oBAAoB;IAKzC,MAAM,CAAC,IAAI,EAAE,oBAAoB,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAQzF,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAI7F,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CAGjD"}

package/dist/extensions/cavi/library/client.js

@@ -0,0 +1,23 @@
+import { BaseHttpApiClient } from "../../../core/http/client.js";
+import { appendHttpQuery, LIBRARY_API_ENDPOINTS } from "../contracts/paths.js";
+export class LibraryApiClient extends BaseHttpApiClient {
+    endpoints = LIBRARY_API_ENDPOINTS;
+    request;
+    constructor(options) {
+        super("library-api", options);
+        this.request = this.createTransport();
+    }
+    ingest(body, idempotencyKey) {
+        return this.request(this.endpoints.ingest, {
+            method: "POST",
+            body,
+            idempotencyKey,
+        });
+    }
+    search(query) {
+        return this.request(appendHttpQuery(this.endpoints.search, query));
+    }
+    getDocument(id) {
+        return this.request(this.endpoints.document(id));
+    }
+}

package/dist/extensions/cavi/library/clip.d.ts

@@ -0,0 +1,93 @@
+export declare const LIBRARY_CLIP_ENDPOINT: "/library/api/clip";
+export declare const LIBRARY_CLIP_HEALTH_ENDPOINT: "/library/api/clip/health";
+export declare const LIBRARY_CLIP_SCHEMA_ENDPOINT: "/library/api/clip/schema";
+export declare const LIBRARY_CLIP_LOGS_ENDPOINT: "/library/api/clip/logs";
+export declare const LIBRARY_CLIP_DEFAULT_TEAM = "library";
+export declare const LIBRARY_CLIP_SOURCE_TAG = "caviclip";
+export type LibraryClipInput = {
+    title?: string | null;
+    sourceUrl?: string | null;
+    text?: string | null;
+    team?: string | null;
+    tags?: readonly string[] | null;
+    note?: string | null;
+    metadata?: Record<string, unknown> | null;
+    capturedAt?: string | null;
+};
+export type LibraryClipRequest = {
+    title: string;
+    team: string;
+    tags: string[];
+    note: string;
+    source_url?: string;
+    text?: string;
+    metadata: Record<string, unknown>;
+};
+export type LibraryClipResult = {
+    accepted?: boolean;
+    id?: string;
+    clip_id?: string;
+    jobId?: string;
+    message?: string;
+    errors?: Array<{
+        field?: string;
+        message: string;
+    }>;
+    [key: string]: unknown;
+};
+export type LibraryClipTransport = <T>(path: string, init?: {
+    method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    body?: unknown;
+    timeoutMs?: number;
+}) => Promise<T>;
+export type LibraryClipSchemaField = {
+    type: string;
+    required: boolean;
+    description: string;
+};
+export type LibraryClipSchemaSnapshot = {
+    contract: "LIBRARY_CLIP_V1";
+    endpoint: typeof LIBRARY_CLIP_ENDPOINT;
+    method: "POST";
+    fields: Record<keyof LibraryClipRequest, LibraryClipSchemaField>;
+    example: LibraryClipRequest;
+};
+export type LibraryClipDiagnosticsCheck = {
+    id: "clip-endpoint" | "pipeline-status" | "clip-health" | "clip-schema" | "clip-logs";
+    label: string;
+    path: string;
+    ok: boolean;
+    status?: number;
+    message: string;
+    source: "local-contract" | "gateway";
+};
+export type LibraryClipDiagnosticsLog = {
+    at?: string;
+    level?: string;
+    message: string;
+    path?: string;
+};
+export type LibraryClipDiagnosticsSnapshot = {
+    fetchedAt: number;
+    endpoint: typeof LIBRARY_CLIP_ENDPOINT;
+    schema: LibraryClipSchemaSnapshot | Record<string, unknown>;
+    schemaSource: "local-contract" | "gateway";
+    checks: LibraryClipDiagnosticsCheck[];
+    logs: LibraryClipDiagnosticsLog[];
+};
+export type LibraryManualFileClipInput = {
+    name: string;
+    uri?: string | null;
+    mimeType?: string | null;
+    size?: number | null;
+    text?: string | null;
+    capturedAt?: string | null;
+};
+export declare function buildLibraryClipPayload(input: LibraryClipInput): LibraryClipRequest;
+export declare function buildLibraryClipSchemaSnapshot(): LibraryClipSchemaSnapshot;
+export declare function buildLibraryManualFileClipInput(input: LibraryManualFileClipInput): LibraryClipInput;
+export declare function postLibraryClip<T extends LibraryClipResult = LibraryClipResult>(requestJson: LibraryClipTransport, input: LibraryClipInput, opts?: {
+    timeoutMs?: number;
+}): Promise<T>;
+export declare function requestLibraryClipDiagnostics(requestJson: LibraryClipTransport): Promise<LibraryClipDiagnosticsSnapshot>;
+//# sourceMappingURL=clip.d.ts.map

package/dist/extensions/cavi/library/clip.d.ts.map

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