@mantra-ai/core 0.1.0

package/dist/ai/google/client.d.ts

@@ -0,0 +1,67 @@
+import type { ChatMessage, GeminiResponseMeta, LLMCallOptions } from "./types";
+export declare function toGeminiContents(messages: ChatMessage[]): any[];
+export interface GenerateContentParams {
+    model: string;
+    contents: any;
+    systemInstruction?: string;
+    temperature?: number;
+    maxOutputTokens?: number;
+    responseMimeType?: string;
+    thinkingConfig?: {
+        includeThoughts?: boolean;
+        thinkingBudget?: number;
+    };
+}
+export type GenerateContentResult = {
+    ok: true;
+    text: string;
+    meta: GeminiResponseMeta;
+    raw: unknown;
+} | {
+    ok: false;
+    error: string;
+    code?: string;
+    meta?: GeminiResponseMeta;
+    details?: unknown;
+};
+export declare function generateContentRaw(params: GenerateContentParams): Promise<GenerateContentResult>;
+export declare function toGenerateContentParams(messages: ChatMessage[], opts?: LLMCallOptions): GenerateContentParams;
+/**
+ * Build Gemini contents array with a PDF inline data part (base64).
+ */
+export declare function buildPdfContents(pdfBase64: string, prompt: string): any[];
+/**
+ * Build Gemini contents array referencing an uploaded file via fileData URI.
+ */
+export declare function buildPdfContentsFromFileUri(fileUri: string, mimeType: string, prompt: string): any[];
+/**
+ * Upload a PDF buffer to the Gemini Files API.
+ * Returns the file URI and mime type for use with fileData content parts.
+ */
+export declare function uploadPdfToGemini(pdfBuffer: Buffer, displayName?: string): Promise<{
+    ok: true;
+    fileUri: string;
+    mimeType: string;
+} | {
+    ok: false;
+    error: string;
+}>;
+/** PDF delivery strategy: inline base64 or uploaded file reference. */
+export type PdfStrategy = "inline" | "file_upload";
+export interface GenerateWithPdfParams {
+    pdfBase64: string;
+    pdfBuffer?: Buffer;
+    prompt: string;
+    systemInstruction?: string;
+    model?: string;
+    temperature?: number;
+    maxOutputTokens?: number;
+    responseMimeType?: string;
+    thinkingConfig?: {
+        includeThoughts?: boolean;
+        thinkingBudget?: number;
+    };
+    strategy?: PdfStrategy;
+}
+export declare function generateContentWithPdf(params: GenerateWithPdfParams): Promise<GenerateContentResult>;
+//# sourceMappingURL=client.d.ts.map

package/dist/ai/google/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/ai/google/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EAGX,kBAAkB,EAClB,cAAc,EACf,MAAM,SAAS,CAAC;AAkBjB,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,GAAG,EAAE,CAO/D;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,GAAG,CAAC;IACd,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACzE;AAED,MAAM,MAAM,qBAAqB,GAC7B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,kBAAkB,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,GAClE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAE9F,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC,CA2DhC;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,WAAW,EAAE,EACvB,IAAI,CAAC,EAAE,cAAc,GACpB,qBAAqB,CAMvB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,GAAG,EAAE,CAOP;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,GAAG,EAAE,CAQP;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAuBzF;AAED,uEAAuE;AACvE,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,aAAa,CAAC;AAEnD,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxE,QAAQ,CAAC,EAAE,WAAW,CAAC;CACxB;AAED,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC,CAmChC"}

package/dist/ai/google/client.js

@@ -0,0 +1,169 @@
+import { GoogleGenAI } from "@google/genai";
+import { createPdfPart } from "./types";
+let aiSingleton = null;
+function getApiKey() {
+    return process.env.GEMINI_API_KEY || undefined;
+}
+function getClient() {
+    const apiKey = getApiKey();
+    if (!apiKey)
+        return { __error: "Missing GEMINI_API_KEY" };
+    if (!aiSingleton) {
+        aiSingleton = new GoogleGenAI({ apiKey });
+    }
+    return aiSingleton;
+}
+export function toGeminiContents(messages) {
+    // Map our chat messages to Gemini's Content shape.
+    // Gemini recognizes roles 'user' and 'model'; treat 'system' as 'user' instruction.
+    return messages.map((m) => ({
+        role: m.role === "assistant" ? "model" : "user",
+        parts: [{ text: m.content }],
+    }));
+}
+export async function generateContentRaw(params) {
+    const client = getClient();
+    if (client.__error) {
+        return { ok: false, error: client.__error, code: "missing_api_key" };
+    }
+    try {
+        const response = await client.models.generateContent({
+            model: params.model,
+            contents: params.contents,
+            config: {
+                temperature: params.temperature,
+                maxOutputTokens: params.maxOutputTokens,
+                ...(params.systemInstruction && {
+                    systemInstruction: params.systemInstruction,
+                }),
+                ...(params.responseMimeType && { responseMimeType: params.responseMimeType }),
+                ...(params.thinkingConfig && { thinkingConfig: params.thinkingConfig }),
+            },
+        });
+        const candidates = response?.candidates;
+        const firstCandidate = candidates?.[0];
+        const parts = firstCandidate?.content?.parts;
+        const finishReason = firstCandidate?.finishReason;
+        const finishMessage = firstCandidate?.finishMessage;
+        const text = response?.text ?? "";
+        const meta = {
+            finishReason,
+            finishMessage,
+            partsCount: parts?.length,
+            textLength: text.length,
+        };
+        if (finishReason === "RECITATION") {
+            return {
+                ok: false,
+                error: `Gemini returned RECITATION: model refused to generate output${finishMessage ? ` (${finishMessage})` : ""}`,
+                code: "recitation",
+                meta,
+                raw: response,
+            };
+        }
+        if (finishReason === "SAFETY") {
+            return {
+                ok: false,
+                error: `Gemini blocked by safety filter${finishMessage ? ` (${finishMessage})` : ""}`,
+                code: "safety_blocked",
+                meta,
+            };
+        }
+        return { ok: true, text, meta, raw: response };
+    }
+    catch (err) {
+        return { ok: false, error: err?.message || String(err), code: "api_error" };
+    }
+}
+export function toGenerateContentParams(messages, opts) {
+    const model = opts?.model ?? "gemini-2.0-flash-001";
+    const temperature = opts?.temperature ?? 0.2;
+    const maxOutputTokens = opts?.maxOutputTokens ?? 1024;
+    const contents = toGeminiContents(messages);
+    return { model, contents, temperature, maxOutputTokens };
+}
+/**
+ * Build Gemini contents array with a PDF inline data part (base64).
+ */
+export function buildPdfContents(pdfBase64, prompt) {
+    const parts = [
+        createPdfPart(pdfBase64),
+        { text: prompt },
+    ];
+    return [{ role: "user", parts }];
+}
+/**
+ * Build Gemini contents array referencing an uploaded file via fileData URI.
+ */
+export function buildPdfContentsFromFileUri(fileUri, mimeType, prompt) {
+    return [{
+            role: "user",
+            parts: [
+                { fileData: { fileUri, mimeType } },
+                { text: prompt },
+            ],
+        }];
+}
+/**
+ * Upload a PDF buffer to the Gemini Files API.
+ * Returns the file URI and mime type for use with fileData content parts.
+ */
+export async function uploadPdfToGemini(pdfBuffer, displayName) {
+    const client = getClient();
+    if (client.__error) {
+        return { ok: false, error: client.__error };
+    }
+    try {
+        const blob = new Blob([pdfBuffer], { type: "application/pdf" });
+        const file = await client.files.upload({
+            file: blob,
+            config: {
+                mimeType: "application/pdf",
+                displayName: displayName ?? "upload.pdf",
+            },
+        });
+        const fileUri = file.uri;
+        if (!fileUri) {
+            return { ok: false, error: "File upload succeeded but no URI returned" };
+        }
+        return { ok: true, fileUri, mimeType: "application/pdf" };
+    }
+    catch (err) {
+        return { ok: false, error: err?.message || String(err) };
+    }
+}
+export async function generateContentWithPdf(params) {
+    const strategy = params.strategy ?? "inline";
+    let contents;
+    if (strategy === "file_upload") {
+        if (!params.pdfBuffer) {
+            return {
+                ok: false,
+                error: "file_upload strategy requires pdfBuffer",
+                code: "invalid_params",
+            };
+        }
+        const upload = await uploadPdfToGemini(params.pdfBuffer);
+        if (!upload.ok) {
+            return {
+                ok: false,
+                error: `File upload failed: ${upload.error}`,
+                code: "file_upload_error",
+            };
+        }
+        contents = buildPdfContentsFromFileUri(upload.fileUri, upload.mimeType, params.prompt);
+    }
+    else {
+        contents = buildPdfContents(params.pdfBase64, params.prompt);
+    }
+    return generateContentRaw({
+        model: params.model ?? "gemini-2.5-flash",
+        contents,
+        systemInstruction: params.systemInstruction,
+        temperature: params.temperature ?? 0.1,
+        maxOutputTokens: params.maxOutputTokens ?? 16384,
+        responseMimeType: params.responseMimeType,
+        thinkingConfig: params.thinkingConfig,
+    });
+}
+//# sourceMappingURL=client.js.map

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

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

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

@@ -0,0 +1,10 @@
+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;
+}
+export declare function generateWithSchema<T>(args: GenerateWithSchemaArgs<T>): Promise<LLMResult<T>>;
+//# sourceMappingURL=generate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/ai/google/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;AAyCjB,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,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,IAAI,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CA4GlG"}

package/dist/ai/google/generate.js

@@ -0,0 +1,137 @@
+import { z } from "zod";
+import { generateContentRaw, toGenerateContentParams } 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) {
+    const trimmed = text.trim();
+    try {
+        JSON.parse(trimmed);
+        return { ok: true, jsonText: trimmed };
+    }
+    catch { }
+    const unfenced = trimmed.replace(/^```(json)?/i, "").replace(/```$/i, "").trim();
+    try {
+        JSON.parse(unfenced);
+        return { ok: true, jsonText: unfenced };
+    }
+    catch { }
+    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 { }
+    }
+    return { ok: false };
+}
+function sleep(ms) {
+    return new Promise((res) => setTimeout(res, ms));
+}
+export async function generateWithSchema(args) {
+    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;
+    const schemaDescription = describeZodObjectSchema(schema);
+    const baseMessages = [
+        { role: "system", content: DEFAULT_SYSTEM_JSON_INSTRUCTIONS + (schemaDescription ? ` Output shape: { ${schemaDescription} }` : "") },
+        ...parsed.data,
+    ];
+    const convo = baseMessages.slice();
+    while (attempts < maxAttempts) {
+        attempts++;
+        const params = toGenerateContentParams(convo, opts);
+        const res = await generateContentRaw(params);
+        if (!res.ok) {
+            if (attempts >= maxAttempts) {
+                return { ok: false, error: { code: "api_error", message: res.error }, attempts };
+            }
+            await sleep(delayMs);
+            continue;
+        }
+        const rawText = (res.text ?? "").trim();
+        if (!rawText) {
+            if (attempts >= maxAttempts) {
+                return { ok: false, error: { code: "no_text", message: "Empty response" }, attempts, usage };
+            }
+            await sleep(delayMs);
+            continue;
+        }
+        const extracted = extractFirstJson(rawText);
+        if (!extracted.ok) {
+            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 };
+        }
+        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;
+        }
+        return { ok: false, error: { code: "invalid_output", message: "Output did not satisfy schema", details: flattened }, attempts, usage, rawText };
+    }
+    return { ok: false, error: { code: "api_error", message: "Unexpected end of control flow" }, attempts };
+}
+//# sourceMappingURL=generate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../../src/ai/google/generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,EAKL,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,SAAS,CAAC;AAEjB,MAAM,gCAAgC,GAAG;IACvC,mCAAmC;IACnC,wCAAwC;IACxC,0DAA0D;IAC1D,kEAAkE;IAClE,iCAAiC;CAClC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,SAAS,gBAAgB,CAAC,IAAY;IACpC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACpB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IAEV,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACjF,IAAI,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACrB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IAEV,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IACzG,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;IACvC,KAAK,IAAI,GAAG,GAAG,QAAQ,CAAC,MAAM,EAAE,GAAG,GAAG,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC;QACnD,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACpD,IAAI,CAAC;YACH,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACtB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;AACvB,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;AACnD,CAAC;AASD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAI,IAA+B;IACzE,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE;YAC/F,QAAQ,EAAE,CAAC;SACI,CAAC;IACpB,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACxB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAC/B,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,OAAO,IAAI,GAAG,CAAC,CAAC;IAElD,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,KAAK,GAAG,SAAgB,CAAC;IAE7B,MAAM,iBAAiB,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAC1D,MAAM,YAAY,GAAkB;QAClC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,gCAAgC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,oBAAoB,iBAAiB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;QACpI,GAAG,MAAM,CAAC,IAAI;KACf,CAAC;IAEF,MAAM,KAAK,GAAkB,YAAY,CAAC,KAAK,EAAE,CAAC;IAElD,OAAO,QAAQ,GAAG,WAAW,EAAE,CAAC;QAC9B,QAAQ,EAAE,CAAC;QAEX,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACpD,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,QAAQ,IAAI,WAAW,EAAE,CAAC;gBAC5B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAkB,CAAC;YACnG,CAAC;YACD,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;YACrB,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACxC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,IAAI,QAAQ,IAAI,WAAW,EAAE,CAAC;gBAC5B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,gBAAgB,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAkB,CAAC;YAC/G,CAAC;YACD,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;YACrB,SAAS;QACX,CAAC;QAED,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;YAClB,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;YACpD,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,MAAM;gBACZ,OAAO,EACL,4HAA4H;aAC/H,CAAC,CAAC;YACH,IAAI,QAAQ,IAAI,WAAW,EAAE,CAAC;gBAC5B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,sCAAsC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAkB,CAAC;YAClJ,CAAC;YACD,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;YACrB,SAAS;QACX,CAAC;QAED,IAAI,UAAmB,CAAC;QACxB,IAAI,CAAC;YACH,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;YACpD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,EAAE,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,mCAAmC,EAAE,CAAC,CAAC;YACxH,IAAI,QAAQ,IAAI,WAAW,EAAE,CAAC;gBAC5B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAkB,CAAC;YACvI,CAAC;YACD,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;YACrB,SAAS;QACX,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAC1C,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAkB,CAAC;QAClF,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACvC,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACxD,MAAM,YAAY,GAAG,SAAS,CAAC,QAAQ,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QACpD,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE;gBACP,8CAA8C;gBAC9C,iBAAiB,CAAC,CAAC,CAAC,mBAAmB,iBAAiB,IAAI,CAAC,CAAC,CAAC,EAAE;gBACjE,sBAAsB,YAAY,EAAE;gBACpC,sEAAsE;gBACtE,6BAA6B,YAAY,EAAE;aAC5C;iBACE,MAAM,CAAC,OAAO,CAAC;iBACf,IAAI,CAAC,IAAI,CAAC;SACd,CAAC,CAAC;QAEH,IAAI,QAAQ,GAAG,WAAW,EAAE,CAAC;YAC3B,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;YACrB,SAAS;QACX,CAAC;QAED,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,+BAA+B,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAkB,CAAC;IAClK,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,gCAAgC,EAAE,EAAE,QAAQ,EAAkB,CAAC;AAC1H,CAAC"}

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

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

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

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

package/dist/ai/google/index.js

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

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

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

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

@@ -0,0 +1,88 @@
+import { z } from "zod";
+export type ChatRole = "system" | "user" | "assistant";
+export interface ChatMessage {
+    role: ChatRole;
+    content: string;
+}
+export interface InlineDataPart {
+    inlineData: {
+        data: string;
+        mimeType: string;
+    };
+}
+export interface TextPart {
+    text: string;
+}
+export type GeminiPart = TextPart | InlineDataPart;
+export declare function createPdfPart(base64Data: string): InlineDataPart;
+export interface GeminiUsage {
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+}
+/** Known Gemini finish reasons from the SDK FinishReason enum. */
+export type GeminiFinishReason = "STOP" | "MAX_TOKENS" | "SAFETY" | "RECITATION" | "LANGUAGE" | "OTHER" | "BLOCKLIST" | "PROHIBITED_CONTENT" | "SPII" | "FINISH_REASON_UNSPECIFIED";
+/** Typed metadata from the first candidate of a Gemini response. */
+export interface GeminiResponseMeta {
+    finishReason?: GeminiFinishReason;
+    finishMessage?: string;
+    partsCount?: number;
+    textLength: number;
+}
+export interface LLMCallOptions {
+    model?: string;
+    temperature?: number;
+    maxOutputTokens?: number;
+    responseFormat?: "json" | "text";
+}
+export interface RetryOptions {
+    maxAttempts?: number;
+    delayMs?: number;
+}
+export type LLMResult<T> = {
+    ok: true;
+    value: T;
+    rawText: string;
+    attempts: number;
+    usage?: GeminiUsage;
+} | {
+    ok: false;
+    error: {
+        code: "missing_api_key" | "api_error" | "no_text" | "parse_error" | "invalid_output";
+        message: string;
+        details?: unknown;
+    };
+    rawText?: string;
+    attempts: number;
+    usage?: GeminiUsage;
+};
+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/google/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/ai/google/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,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;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,cAAc,CAAC;AAEnD,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CAEhE;AAGD,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,kEAAkE;AAClE,MAAM,MAAM,kBAAkB,GAC1B,MAAM,GACN,YAAY,GACZ,QAAQ,GACR,YAAY,GACZ,UAAU,GACV,OAAO,GACP,WAAW,GACX,oBAAoB,GACpB,MAAM,GACN,2BAA2B,CAAC;AAEhC,oEAAoE;AACpE,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,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;CAClC;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,SAAS,CAAC,CAAC,IACnB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,WAAW,CAAA;CAAE,GAC9E;IACE,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE;QACL,IAAI,EACA,iBAAiB,GACjB,WAAW,GACX,SAAS,GACT,aAAa,GACb,gBAAgB,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC;AAEN,eAAO,MAAM,iBAAiB;;;;;;;;;EAG5B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;WAAoC,CAAC;AAGpE,eAAO,MAAM,mBAAmB;;;;;;EAA2C,CAAC;AAC5E,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAGhE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,MAAM,CAUpE"}

package/dist/ai/google/types.js

@@ -0,0 +1,55 @@
+import { z } from "zod";
+export function createPdfPart(base64Data) {
+    return { inlineData: { data: base64Data, mimeType: "application/pdf" } };
+}
+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);
+// Simple reusable example schema
+export const SimpleSummarySchema = z.object({ summary: z.string().min(1) });
+// Mirrors the helper in OpenAI impl; kept local to avoid coupling
+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/google/types.js.map

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

package/dist/ai/index.d.ts

@@ -0,0 +1,3 @@
+export * as OpenAI from "./openai";
+export * as Google from "./google";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC"}

package/dist/ai/index.js

@@ -0,0 +1,3 @@
+export * as OpenAI from "./openai";
+export * as Google from "./google";
+//# sourceMappingURL=index.js.map

package/dist/ai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC"}

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

@@ -0,0 +1,22 @@
+import { type ChatMessage, type LLMCallOptions, type OpenAIChatResponse } from "./types";
+export interface ChatCompletionParams {
+    model: string;
+    messages: ChatMessage[];
+    temperature?: number;
+    max_tokens?: number;
+    response_format?: {
+        type: "json_object" | "text";
+    } | undefined;
+    signal?: AbortSignal;
+}
+export declare function chatCompletionRaw(params: ChatCompletionParams): Promise<{
+    ok: true;
+    data: OpenAIChatResponse;
+} | {
+    ok: false;
+    status?: number;
+    error: string;
+    details?: unknown;
+}>;
+export declare function toChatCompletionParams(messages: ChatMessage[], opts?: LLMCallOptions): ChatCompletionParams;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/ai/openai/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,SAAS,CAAC;AASzF,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE;QAAE,IAAI,EAAE,aAAa,GAAG,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAC/D,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,kBAAkB,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAgCpH;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,WAAW,EAAE,EACvB,IAAI,CAAC,EAAE,cAAc,GACpB,oBAAoB,CAMtB"}