@camstack/types 1.1.42 → 1.1.44

package/dist/capabilities/llm-shared.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Shared LLM generate contracts — imported by BOTH `llm.cap.ts` (consumer
+ * surface) and `llm-runtime.cap.ts` (node-side managed executor) so the two
+ * caps stay wire-compatible without a circular cap→cap import.
+ *
+ * Errors are a discriminated-union RESULT, never thrown: the shape survives
+ * every transport tier structurally, and failed calls still write usage rows.
+ * Token counts only in v1 — no costUsd (operator decision, 2026-07-15).
+ */
+import { z } from 'zod';
+export declare const LlmUsageSchema: z.ZodObject<{
+    inputTokens: z.ZodNumber;
+    outputTokens: z.ZodNumber;
+}, z.core.$strip>;
+export type LlmUsage = z.infer<typeof LlmUsageSchema>;
+export declare const LlmErrorCodeSchema: z.ZodEnum<{
+    auth: "auth";
+    timeout: "timeout";
+    "rate-limited": "rate-limited";
+    refusal: "refusal";
+    "bad-request": "bad-request";
+    unavailable: "unavailable";
+    "no-profile": "no-profile";
+    "budget-exceeded": "budget-exceeded";
+    "adapter-error": "adapter-error";
+}>;
+export type LlmErrorCode = z.infer<typeof LlmErrorCodeSchema>;
+export declare const LlmGenerateOkSchema: z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+    text: z.ZodString;
+    model: z.ZodString;
+    usage: z.ZodObject<{
+        inputTokens: z.ZodNumber;
+        outputTokens: z.ZodNumber;
+    }, z.core.$strip>;
+    truncated: z.ZodBoolean;
+    latencyMs: z.ZodNumber;
+}, z.core.$strip>;
+export declare const LlmGenerateErrSchema: z.ZodObject<{
+    ok: z.ZodLiteral<false>;
+    code: z.ZodEnum<{
+        auth: "auth";
+        timeout: "timeout";
+        "rate-limited": "rate-limited";
+        refusal: "refusal";
+        "bad-request": "bad-request";
+        unavailable: "unavailable";
+        "no-profile": "no-profile";
+        "budget-exceeded": "budget-exceeded";
+        "adapter-error": "adapter-error";
+    }>;
+    message: z.ZodString;
+    retryAfterMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const LlmGenerateResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+    text: z.ZodString;
+    model: z.ZodString;
+    usage: z.ZodObject<{
+        inputTokens: z.ZodNumber;
+        outputTokens: z.ZodNumber;
+    }, z.core.$strip>;
+    truncated: z.ZodBoolean;
+    latencyMs: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    ok: z.ZodLiteral<false>;
+    code: z.ZodEnum<{
+        auth: "auth";
+        timeout: "timeout";
+        "rate-limited": "rate-limited";
+        refusal: "refusal";
+        "bad-request": "bad-request";
+        unavailable: "unavailable";
+        "no-profile": "no-profile";
+        "budget-exceeded": "budget-exceeded";
+        "adapter-error": "adapter-error";
+    }>;
+    message: z.ZodString;
+    retryAfterMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>], "ok">;
+export type LlmGenerateOk = z.infer<typeof LlmGenerateOkSchema>;
+export type LlmGenerateErr = z.infer<typeof LlmGenerateErrSchema>;
+export type LlmGenerateResult = z.infer<typeof LlmGenerateResultSchema>;
+/**
+ * `Uint8Array` is the sanctioned binary convention — superjson + the UDS
+ * MsgPack channel round-trip typed arrays (embedding-encoder.cap.ts:29,
+ * notification-output.cap.ts:27-31 precedents).
+ */
+export declare const LlmImageSchema: z.ZodObject<{
+    bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+    mimeType: z.ZodString;
+}, z.core.$strip>;
+export type LlmImage = z.infer<typeof LlmImageSchema>;
+export declare const LlmGenerateBaseInputSchema: z.ZodObject<{
+    addonId: z.ZodOptional<z.ZodString>;
+    profileId: z.ZodOptional<z.ZodString>;
+    consumer: z.ZodString;
+    system: z.ZodOptional<z.ZodString>;
+    prompt: z.ZodString;
+    jsonSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    maxTokens: z.ZodOptional<z.ZodNumber>;
+    temperature: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type LlmGenerateBaseInput = z.infer<typeof LlmGenerateBaseInputSchema>;