@mantra-ai/core 0.1.0

package/dist/ai/openai/client.js

@@ -0,0 +1,49 @@
+import {} from "./types";
+const OPENAI_API_URL = "https://api.openai.com/v1/chat/completions";
+function getApiKey() {
+    // Prefer local env; don't import global config to avoid coupling.
+    return process.env.OPENAI_API_KEY || undefined;
+}
+export async function chatCompletionRaw(params) {
+    const apiKey = getApiKey();
+    if (!apiKey)
+        return { ok: false, error: "Missing OPENAI_API_KEY", details: { env: "OPENAI_API_KEY" } };
+    try {
+        const res = await fetch(OPENAI_API_URL, {
+            method: "POST",
+            headers: {
+                "Authorization": `Bearer ${apiKey}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                model: params.model,
+                messages: params.messages,
+                temperature: params.temperature,
+                max_tokens: params.max_tokens,
+                response_format: params.response_format,
+            }),
+            signal: params.signal,
+        });
+        if (!res.ok) {
+            let details = undefined;
+            try {
+                details = await res.json();
+            }
+            catch { /* noop */ }
+            return { ok: false, status: res.status, error: `HTTP ${res.status}`, details };
+        }
+        const data = (await res.json());
+        return { ok: true, data };
+    }
+    catch (err) {
+        return { ok: false, error: err?.message || String(err) };
+    }
+}
+export function toChatCompletionParams(messages, opts) {
+    const model = opts?.model ?? "gpt-4o-mini";
+    const temperature = opts?.temperature ?? 0.2;
+    const max_tokens = opts?.maxOutputTokens ?? 1024;
+    const response_format = (opts?.responseFormat ?? "json") === "json" ? { type: "json_object" } : { type: "text" };
+    return { model, messages, temperature, max_tokens, response_format, signal: opts?.signal };
+}
+//# sourceMappingURL=client.js.map

package/dist/ai/openai/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/ai/openai/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkE,MAAM,SAAS,CAAC;AAEzF,MAAM,cAAc,GAAG,4CAA4C,CAAC;AAEpE,SAAS,SAAS;IAChB,kEAAkE;IAClE,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,SAAS,CAAC;AACjD,CAAC;AAWD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAA4B;IAE5B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,wBAAwB,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,gBAAgB,EAAE,EAAE,CAAC;IAEvG,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,cAAc,EAAE;YACtC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,eAAe,EAAE,UAAU,MAAM,EAAE;gBACnC,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,eAAe,EAAE,MAAM,CAAC,eAAe;aACxC,CAAC;YACF,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,OAAO,GAAQ,SAAS,CAAC;YAC7B,IAAI,CAAC;gBAAC,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;YACxD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC;QACjF,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAuB,CAAC;QACtD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC5B,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IAC3D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,QAAuB,EACvB,IAAqB;IAErB,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,aAAa,CAAC;IAC3C,MAAM,WAAW,GAAG,IAAI,EAAE,WAAW,IAAI,GAAG,CAAC;IAC7C,MAAM,UAAU,GAAG,IAAI,EAAE,eAAe,IAAI,IAAI,CAAC;IACjD,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,cAAc,IAAI,MAAM,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,aAAsB,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,CAAC;IACnI,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC7F,CAAC"}

package/dist/ai/openai/generate.d.ts

@@ -0,0 +1,14 @@
+import { z } from "zod";
+import { type ChatMessage, type LLMCallOptions, type LLMResult, type RetryOptions } from "./types";
+export interface GenerateWithSchemaArgs<T> {
+    messages: ChatMessage[];
+    schema: z.ZodType<T>;
+    options?: LLMCallOptions;
+    retry?: RetryOptions;
+}
+/**
+ * Calls the OpenAI chat completions API, enforces JSON-only output, validates
+ * it against a provided zod schema, and retries with targeted feedback when validation fails.
+ */
+export declare function generateWithSchema<T>(args: GenerateWithSchemaArgs<T>): Promise<LLMResult<T>>;
+//# sourceMappingURL=generate.d.ts.map

package/dist/ai/openai/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/ai/openai/generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,YAAY,EAGlB,MAAM,SAAS,CAAC;AA4CjB,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACrB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,IAAI,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CA+IlG"}

package/dist/ai/openai/generate.js

@@ -0,0 +1,178 @@
+import { z } from "zod";
+import { chatCompletionRaw, toChatCompletionParams } from "./client";
+import { ChatMessagesSchema, describeZodObjectSchema, } from "./types";
+const DEFAULT_SYSTEM_JSON_INSTRUCTIONS = [
+    "You are a precise JSON generator.",
+    "Respond with strictly valid JSON only.",
+    "No markdown, no code fences, no comments, no extra text.",
+    "If a field is optional, omit it entirely rather than using null.",
+    "Do not include trailing commas.",
+].join(" ");
+function extractFirstJson(text) {
+    // Try to find the first {...} or [ ... ] block. Fall back to raw text if simple parse succeeds.
+    const trimmed = text.trim();
+    try {
+        JSON.parse(trimmed);
+        return { ok: true, jsonText: trimmed };
+    }
+    catch { }
+    // Remove code fences if present
+    const unfenced = trimmed.replace(/^```(json)?/i, "").replace(/```$/i, "").trim();
+    try {
+        JSON.parse(unfenced);
+        return { ok: true, jsonText: unfenced };
+    }
+    catch { }
+    // Greedy brace/bracket matching (simple heuristic)
+    const objStart = unfenced.indexOf("{");
+    const arrStart = unfenced.indexOf("[");
+    const start = (objStart === -1) ? arrStart : (arrStart === -1 ? objStart : Math.min(objStart, arrStart));
+    if (start === -1)
+        return { ok: false };
+    for (let end = unfenced.length; end > start; end--) {
+        const candidate = unfenced.slice(start, end).trim();
+        try {
+            JSON.parse(candidate);
+            return { ok: true, jsonText: candidate };
+        }
+        catch { /* keep searching */ }
+    }
+    return { ok: false };
+}
+function sleep(ms) {
+    return new Promise((res) => setTimeout(res, ms));
+}
+/**
+ * Calls the OpenAI chat completions API, enforces JSON-only output, validates
+ * it against a provided zod schema, and retries with targeted feedback when validation fails.
+ */
+export async function generateWithSchema(args) {
+    // Validate the messages input shape early to provide actionable errors.
+    const parsed = ChatMessagesSchema.safeParse(args.messages);
+    if (!parsed.success) {
+        return {
+            ok: false,
+            error: { code: "invalid_output", message: "Invalid messages", details: parsed.error.flatten() },
+            attempts: 0,
+        };
+    }
+    const { schema } = args;
+    const opts = args.options ?? {};
+    const retry = args.retry ?? {};
+    const maxAttempts = Math.max(1, retry.maxAttempts ?? 2);
+    const delayMs = Math.max(0, retry.delayMs ?? 250);
+    let attempts = 0;
+    let usage = undefined;
+    // Prepend our system JSON instruction once, without altering user-provided context ordering otherwise
+    const schemaDescription = describeZodObjectSchema(schema);
+    const baseMessages = [
+        { role: "system", content: DEFAULT_SYSTEM_JSON_INSTRUCTIONS + (schemaDescription ? ` Output shape: { ${schemaDescription} }` : "") },
+        ...parsed.data,
+    ];
+    // Keep the conversation growing across retries by appending validation feedback
+    const convo = baseMessages.slice();
+    while (attempts < maxAttempts) {
+        attempts++;
+        const params = toChatCompletionParams(convo, opts);
+        const res = await chatCompletionRaw(params);
+        if (!res.ok) {
+            if (attempts < maxAttempts)
+                await sleep(delayMs);
+            // For HTTP/API errors we do not add model feedback; simply retry.
+            if (attempts >= maxAttempts) {
+                return {
+                    ok: false,
+                    error: { code: res.status ? "http_error" : "api_error", message: res.error, details: res.details, status: res.status },
+                    attempts,
+                };
+            }
+            continue;
+        }
+        usage = res.data.usage;
+        const first = res.data.choices?.[0];
+        if (!first) {
+            if (attempts >= maxAttempts) {
+                return { ok: false, error: { code: "no_choices", message: "No choices returned by API" }, attempts, usage };
+            }
+            await sleep(delayMs);
+            continue;
+        }
+        const rawText = (first.message?.content ?? "").trim();
+        if (!rawText) {
+            if (attempts >= maxAttempts) {
+                return { ok: false, error: { code: "empty_content", message: "Empty assistant content" }, attempts, usage };
+            }
+            await sleep(delayMs);
+            continue;
+        }
+        const extracted = extractFirstJson(rawText);
+        if (!extracted.ok) {
+            // Provide corrective instruction and try again
+            convo.push({ role: "assistant", content: rawText });
+            convo.push({
+                role: "user",
+                content: "Your previous response did not contain valid JSON. Return strictly valid JSON only, matching the required shape. No prose.",
+            });
+            if (attempts >= maxAttempts) {
+                return { ok: false, error: { code: "parse_error", message: "Could not extract JSON from response" }, attempts, usage, rawText };
+            }
+            await sleep(delayMs);
+            continue;
+        }
+        let parsedJson;
+        try {
+            parsedJson = JSON.parse(extracted.jsonText);
+        }
+        catch (err) {
+            convo.push({ role: "assistant", content: rawText });
+            convo.push({ role: "user", content: `Parsing error: ${err?.message || String(err)}. Reply with corrected JSON only.` });
+            if (attempts >= maxAttempts) {
+                return {
+                    ok: false,
+                    error: { code: "parse_error", message: err?.message || String(err) },
+                    attempts,
+                    usage,
+                    rawText,
+                };
+            }
+            await sleep(delayMs);
+            continue;
+        }
+        const safe = schema.safeParse(parsedJson);
+        if (safe.success) {
+            return { ok: true, value: safe.data, rawText, attempts, usage };
+        }
+        // Append targeted feedback with zod errors and the JSON to correct.
+        const flattened = safe.error.flatten();
+        const errorSummary = JSON.stringify(flattened, null, 2);
+        const previousJson = extracted.jsonText;
+        convo.push({ role: "assistant", content: rawText });
+        convo.push({
+            role: "user",
+            content: [
+                "The JSON does not match the required schema.",
+                schemaDescription ? `Schema shape: { ${schemaDescription} }` : "",
+                `Validation errors: ${errorSummary}`,
+                "Return corrected JSON only. Do not include markdown or explanations.",
+                `Previous JSON to correct: ${previousJson}`,
+            ]
+                .filter(Boolean)
+                .join("\n"),
+        });
+        if (attempts < maxAttempts) {
+            await sleep(delayMs);
+            continue;
+        }
+        // Out of attempts
+        return {
+            ok: false,
+            error: { code: "invalid_output", message: "Output did not satisfy schema", details: flattened },
+            attempts,
+            usage,
+            rawText,
+        };
+    }
+    // Should be unreachable
+    return { ok: false, error: { code: "api_error", message: "Unexpected end of control flow" }, attempts };
+}
+//# sourceMappingURL=generate.js.map

package/dist/ai/openai/generate.js.map

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

package/dist/ai/openai/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./types";
+export * from "./client";
+export * from "./generate";
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/openai/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai/openai/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC"}

package/dist/ai/openai/index.js

@@ -0,0 +1,4 @@
+export * from "./types";
+export * from "./client";
+export * from "./generate";
+//# sourceMappingURL=index.js.map

package/dist/ai/openai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ai/openai/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC"}

package/dist/ai/openai/types.d.ts

@@ -0,0 +1,86 @@
+import { z } from "zod";
+export type ChatRole = "system" | "user" | "assistant";
+export interface ChatMessage {
+    role: ChatRole;
+    content: string;
+}
+export interface OpenAIChatChoice {
+    index: number;
+    message: {
+        role: ChatRole;
+        content?: string | null;
+    };
+    finish_reason?: string | null;
+}
+export interface OpenAIChatUsage {
+    prompt_tokens?: number;
+    completion_tokens?: number;
+    total_tokens?: number;
+}
+export interface OpenAIChatResponse {
+    id?: string;
+    object?: string;
+    created?: number;
+    model?: string;
+    choices: OpenAIChatChoice[];
+    usage?: OpenAIChatUsage;
+}
+export interface LLMCallOptions {
+    model?: string;
+    temperature?: number;
+    maxOutputTokens?: number;
+    responseFormat?: "json" | "text";
+    signal?: AbortSignal;
+}
+export interface RetryOptions {
+    maxAttempts?: number;
+    delayMs?: number;
+}
+export type LLMResult<T> = {
+    ok: true;
+    value: T;
+    rawText: string;
+    attempts: number;
+    usage?: OpenAIChatUsage;
+} | {
+    ok: false;
+    error: {
+        code: "missing_api_key" | "http_error" | "api_error" | "no_choices" | "empty_content" | "parse_error" | "invalid_output";
+        message: string;
+        details?: unknown;
+        status?: number;
+    };
+    rawText?: string;
+    attempts: number;
+    usage?: OpenAIChatUsage;
+};
+export declare const ChatMessageSchema: z.ZodObject<{
+    role: z.ZodUnion<[z.ZodLiteral<"system">, z.ZodLiteral<"user">, z.ZodLiteral<"assistant">]>;
+    content: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    role: "system" | "user" | "assistant";
+    content: string;
+}, {
+    role: "system" | "user" | "assistant";
+    content: string;
+}>;
+export declare const ChatMessagesSchema: z.ZodArray<z.ZodObject<{
+    role: z.ZodUnion<[z.ZodLiteral<"system">, z.ZodLiteral<"user">, z.ZodLiteral<"assistant">]>;
+    content: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    role: "system" | "user" | "assistant";
+    content: string;
+}, {
+    role: "system" | "user" | "assistant";
+    content: string;
+}>, "many">;
+export declare const SimpleSummarySchema: z.ZodObject<{
+    summary: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    summary: string;
+}, {
+    summary: string;
+}>;
+export type SimpleSummary = z.infer<typeof SimpleSummarySchema>;
+export declare function describeZodObjectSchema(schema: z.ZodTypeAny): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/ai/openai/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/ai/openai/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AACvD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAGD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACrD,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAGD,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAGD,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAGD,MAAM,MAAM,SAAS,CAAC,CAAC,IACnB;IACE,EAAE,EAAE,IAAI,CAAC;IACT,KAAK,EAAE,CAAC,CAAC;IACT,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB,GACD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE;QACL,IAAI,EACA,iBAAiB,GACjB,YAAY,GACZ,WAAW,GACX,YAAY,GACZ,eAAe,GACf,aAAa,GACb,gBAAgB,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB,CAAC;AAGN,eAAO,MAAM,iBAAiB;;;;;;;;;EAG5B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;WAAoC,CAAC;AAGpE,eAAO,MAAM,mBAAmB;;;;;;EAE9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAIhE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,MAAM,CAUpE"}

package/dist/ai/openai/types.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+// Common zod schemas to validate inputs and allow reuse elsewhere
+export const ChatMessageSchema = z.object({
+    role: z.union([z.literal("system"), z.literal("user"), z.literal("assistant")]),
+    content: z.string().min(1),
+});
+export const ChatMessagesSchema = z.array(ChatMessageSchema).min(1);
+// A small, generic example schema people can reuse for quick tasks
+export const SimpleSummarySchema = z.object({
+    summary: z.string().min(1),
+});
+// Helper to describe a zod object schema in plain English for the model
+// Focused on common primitives for clarity; not a full serializer.
+export function describeZodObjectSchema(schema) {
+    const parts = [];
+    const root = schema._def;
+    if (root?.typeName !== z.ZodFirstPartyTypeKind.ZodObject)
+        return "";
+    const shape = root.shape();
+    for (const key of Object.keys(shape)) {
+        const def = shape[key]?._def;
+        parts.push(`${key}: ${describeZodType(def)}`);
+    }
+    return parts.join("; ");
+}
+function describeZodType(def) {
+    const t = def?.typeName;
+    switch (t) {
+        case z.ZodFirstPartyTypeKind.ZodString:
+            return "string";
+        case z.ZodFirstPartyTypeKind.ZodNumber:
+            return "number";
+        case z.ZodFirstPartyTypeKind.ZodBoolean:
+            return "boolean";
+        case z.ZodFirstPartyTypeKind.ZodArray:
+            return `array<${describeZodType(def?.type?._def)}>`;
+        case z.ZodFirstPartyTypeKind.ZodObject: {
+            const shape = def.shape?.();
+            const entries = Object.keys(shape || {}).map((k) => `${k}: ${describeZodType(shape[k]._def)}`);
+            return `{ ${entries.join(", ")} }`;
+        }
+        case z.ZodFirstPartyTypeKind.ZodLiteral:
+            return JSON.stringify(def?.value);
+        case z.ZodFirstPartyTypeKind.ZodEnum:
+            return `enum<${(def?.values || []).join(", ")}>`;
+        case z.ZodFirstPartyTypeKind.ZodUnion:
+            return (def?.options || []).map((o) => describeZodType(o._def)).join(" | ");
+        case z.ZodFirstPartyTypeKind.ZodOptional:
+            return `${describeZodType(def?.innerType?._def)}?`;
+        case z.ZodFirstPartyTypeKind.ZodNullable:
+            return `${describeZodType(def?.innerType?._def)} | null`;
+        default:
+            return t || "unknown";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/ai/openai/types.js.map

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

package/dist/ai/prompts/index.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai/prompts/index.ts"],"names":[],"mappings":""}

package/dist/ai/prompts/index.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=index.js.map

package/dist/ai/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ai/prompts/index.ts"],"names":[],"mappings":""}

package/dist/errors/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./types";
+export * from "./schemas";
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC"}

package/dist/errors/index.js

@@ -0,0 +1,4 @@
+// Export all error-related types, schemas, and utilities
+export * from "./types";
+export * from "./schemas";
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC"}