@graphext/cuery 0.4.0 → 0.5.2

package/esm/src/helpers/async.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.d.ts","sourceRoot":"","sources":["../../../src/src/helpers/async.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB1E;AAMD,MAAM,WAAW,WAAW;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC5B;AAED,eAAO,MAAM,cAAc;;;;;;CAM1B,CAAC;AAEF;;;GAGG;AACH,wBAAsB,WAAW,CAChC,EAAE,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,EAC3B,EACC,UAAsC,EACtC,YAA0C,EAC1C,QAAkC,EAClC,iBAAoD,EACpD,WAAwC,EACxC,GAAE,WAAgB,GACjB,OAAO,CAAC,QAAQ,CAAC,CA+CnB;AAMD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE,CAAC,EACrC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,EACzC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAC/C,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CA0BnB"}

package/esm/src/{async.js → helpers/async.js}

@@ -8,7 +8,7 @@
  * Sleeps for a specified duration. If an AbortSignal is provided and triggered,
  * the promise rejects with the abort reason and the timeout is cleared.
  */
-import * as dntShim from "../_dnt.shims.js";
+import * as dntShim from "../../_dnt.shims.js";
 export function sleep(ms, abortSignal) {
     return new Promise((resolve, reject) => {
         if (abortSignal?.aborted) {

package/esm/src/helpers/seedKeywords.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seedKeywords.d.ts","sourceRoot":"","sources":["../../../src/src/helpers/seedKeywords.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAGvF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAOpE,UAAU,iBAAiB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED,UAAU,WAAW;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED,UAAU,kBAAkB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED,UAAU,eAAe;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAAC;CACvC;AAED,UAAU,cAAc;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC;CACrC;AAMD,MAAM,WAAW,yBAAyB;IACzC,cAAc,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAC1C,QAAQ,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAC9B,YAAY,CAAC,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;IACtC,WAAW,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IACpC,cAAc,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,EACnC,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,cAAc,EACd,EAAE,yBAAyB,GAAG,KAAK,CAAC,WAAW,CAAC,CA+EhD;AAcD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAChC,YAAY,EAAE,KAAK,CAAC,WAAW,CAAC,EAChC,sBAAsB,GAAE,OAAc,GACpC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,WAAW,CAAC,CA8FzC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAClC,YAAY,EAAE,KAAK,CAAC,WAAW,CAAC,EAChC,sBAAsB,GAAE,OAAc,GACpC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,CAS/B;AAED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC5C,MAAM,EAAE,yBAAyB,EACjC,sBAAsB,GAAE,OAAc,GACpC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,CAG/B"}

package/esm/src/helpers/urls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urls.d.ts","sourceRoot":"","sources":["../../../src/src/helpers/urls.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAQzC;AAaD;;;GAGG;AACH,wBAAgB,aAAa,CAC5B,GAAG,EAAE,MAAM,EACX,aAAa,GAAE,OAAe,EAC9B,sBAAsB,GAAE,OAAc,GACpC,MAAM,CA6BR"}

package/esm/src/helpers/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/src/helpers/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;;GAGG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA8B3C;AAwCD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMpD;AAMD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAoCrF;AAMD;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAYnE;AAMD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5D,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EACjB,KAAK,EAAE,MAAM,CAAC,GACZ,KAAK,CAAC,CAAC,CAAC,CAoBV;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EACjB,KAAK,EAAE,MAAM,CAAC,GACZ,KAAK,CAAC,CAAC,CAAC,CAgBV"}

package/esm/src/llm.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Unified LLM interface - provider-agnostic API for making LLM calls.
+ */
+import type { z } from '../deps/jsr.io/@zod/zod/4.3.6/src/index.js';
+import { type Message, type LLMResponse, type ProviderParams } from './providers/index.js';
+export type { Message, LLMResponse, LLMProvider, ProviderParams, LLMConversation } from './providers/index.js';
+export type { TokenUsage, UsageCost, AggregatedUsage } from './response.js';
+export { calculateCost } from './providers/index.js';
+/**
+ * Parameters for askLLMSafe.
+ */
+export interface AskLLMParams<T = string> {
+    /** The prompt (string or message array) */
+    prompt: string | Message[];
+    /** The model to use (e.g., 'gpt-4.1-mini', 'gemini-2.0-flash') */
+    model: string;
+    /** Optional Zod schema for structured output */
+    schema?: z.ZodType<T> | null;
+    /** Provider-specific parameters */
+    params?: ProviderParams;
+    /** Maximum retry attempts (default: 3) */
+    maxRetries?: number;
+    /** Error handling mode: 'throw' or 'return' (default: 'throw') */
+    onError?: 'throw' | 'return';
+}
+/**
+ * Make a single LLM call with retry logic.
+ * Returns LLMResponse with raw TokenUsage (no cost calculation).
+ */
+export declare function askLLMSafe<T = string>({ prompt, model, schema, params, maxRetries, onError, }: AskLLMParams<T>): Promise<LLMResponse<T>>;
+/**
+ * Make a single LLM call without retry logic.
+ */
+export declare function askLLM<T = string>(params: Omit<AskLLMParams<T>, 'maxRetries' | 'onError'>): Promise<LLMResponse<T>>;
+//# sourceMappingURL=llm.d.ts.map

package/esm/src/llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../src/src/llm.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,4CAA4C,CAAC;AACpE,OAAO,EAAuB,KAAK,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGhH,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG/G,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,MAAM;IACvC,2CAA2C;IAC3C,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,CAAC;IAC3B,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC7B,mCAAmC;IACnC,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;CAC7B;AAYD;;;GAGG;AACH,wBAAsB,UAAU,CAAC,CAAC,GAAG,MAAM,EAAE,EAC5C,MAAM,EACN,KAAK,EACL,MAAM,EACN,MAAM,EACN,UAAc,EACd,OAAiB,GACjB,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAwC3C;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,CAAC,GAAG,MAAM,EACtC,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC,GACrD,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAEzB"}

package/esm/src/llm.js

@@ -0,0 +1,59 @@
+/**
+ * Unified LLM interface - provider-agnostic API for making LLM calls.
+ */
+import { getProviderForModel } from './providers/index.js';
+export { calculateCost } from './providers/index.js';
+/**
+ * Normalize a prompt to a message array.
+ */
+function normalizePrompt(prompt) {
+    if (Array.isArray(prompt)) {
+        return prompt;
+    }
+    return [{ role: 'user', content: prompt }];
+}
+/**
+ * Make a single LLM call with retry logic.
+ * Returns LLMResponse with raw TokenUsage (no cost calculation).
+ */
+export async function askLLMSafe({ prompt, model, schema, params, maxRetries = 3, onError = 'throw', }) {
+    const provider = getProviderForModel(model);
+    let messages = normalizePrompt(prompt);
+    let lastResponse = null;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        const response = await provider.complete(messages, model, schema ?? null, params);
+        if (response.error === null && response.parsed !== null) {
+            return response;
+        }
+        lastResponse = {
+            parsed: null,
+            text: response.text,
+            usage: response.usage,
+            error: response.error ?? new Error('Unknown error'),
+        };
+        if (attempt < maxRetries && response.error) {
+            // Add error context to messages for retry
+            const errorMessage = `Previous attempt failed with error: ${response.error.message}`;
+            if (response.text) {
+                messages = [
+                    ...messages,
+                    {
+                        role: 'system',
+                        content: `${errorMessage}\nYour raw response was:\n${response.text}`,
+                    },
+                ];
+            }
+            console.log(`askLLMSafe retrying! Attempt ${attempt + 1} failed: ${response.error.message}`);
+        }
+    }
+    if (onError === 'return') {
+        return lastResponse;
+    }
+    throw lastResponse.error;
+}
+/**
+ * Make a single LLM call without retry logic.
+ */
+export async function askLLM(params) {
+    return askLLMSafe({ ...params, maxRetries: 0, onError: 'throw' });
+}

package/esm/src/providers/google.d.ts

@@ -0,0 +1,12 @@
+import { z } from '../../deps/jsr.io/@zod/zod/4.3.6/src/index.js';
+import type { LLMProvider, LLMResponse, Message, ProviderParams } from './types.js';
+/**
+ * Google LLM provider (for Gemini models).
+ */
+export declare class GoogleProvider implements LLMProvider {
+    readonly name = "google";
+    private client;
+    constructor(apiKey?: string);
+    complete<T>(messages: Message[], model: string, schema: z.ZodType<T> | null, params?: ProviderParams): Promise<LLMResponse<T>>;
+}
+//# sourceMappingURL=google.d.ts.map

package/esm/src/providers/google.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google.d.ts","sourceRoot":"","sources":["../../../src/src/providers/google.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC,EAAE,MAAM,+CAA+C,CAAC;AAElE,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAuCpF;;GAEG;AACH,qBAAa,cAAe,YAAW,WAAW;IACjD,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,CAAC,EAAE,MAAM;IAUrB,QAAQ,CAAC,CAAC,EACf,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,EAC3B,MAAM,CAAC,EAAE,cAAc,GACrB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CA8D1B"}

package/esm/src/providers/google.js

@@ -0,0 +1,111 @@
+/**
+ * Google provider implementation (for Gemini models).
+ */
+import * as dntShim from "../../_dnt.shims.js";
+import { GoogleGenAI } from '@google/genai';
+import { z } from '../../deps/jsr.io/@zod/zod/4.3.6/src/index.js';
+/**
+ * Convert messages to Gemini content format.
+ * Handles system prompts by prepending them as context.
+ */
+function convertMessages(messages) {
+    // For simple single message, return as string
+    if (messages.length === 1 && messages[0].role === 'user') {
+        return messages[0].content;
+    }
+    // Build system instruction and contents separately
+    const systemParts = [];
+    const contents = [];
+    for (const msg of messages) {
+        if (msg.role === 'system') {
+            systemParts.push(msg.content);
+        }
+        else {
+            contents.push({
+                role: msg.role === 'assistant' ? 'model' : 'user',
+                parts: [{ text: msg.content }],
+            });
+        }
+    }
+    // If we have system prompts, prepend to the first user message
+    if (systemParts.length > 0 && contents.length > 0) {
+        const systemContext = systemParts.join('\n\n');
+        const firstContent = contents[0];
+        if (firstContent.role === 'user' && firstContent.parts.length > 0) {
+            firstContent.parts[0].text = `${systemContext}\n\n${firstContent.parts[0].text}`;
+        }
+    }
+    return contents;
+}
+/**
+ * Google LLM provider (for Gemini models).
+ */
+export class GoogleProvider {
+    name = 'google';
+    client;
+    constructor(apiKey) {
+        const resolvedKey = apiKey ?? dntShim.Deno.env.get('GOOGLE_API_KEY') ?? dntShim.Deno.env.get('GEMINI_API_KEY');
+        if (!resolvedKey) {
+            throw new Error('GOOGLE_API_KEY or GEMINI_API_KEY environment variable is required');
+        }
+        this.client = new GoogleGenAI({ apiKey: resolvedKey });
+    }
+    async complete(messages, model, schema, params) {
+        try {
+            const config = {
+                ...(params ?? {}),
+            };
+            if (schema != null) {
+                config.responseMimeType = 'application/json';
+                config.responseSchema = z.toJSONSchema(schema, { target: 'draft-7' });
+            }
+            const response = await this.client.models.generateContent({
+                model,
+                contents: convertMessages(messages),
+                config,
+            });
+            const text = response.text ?? '';
+            const usageMetadata = response.usageMetadata;
+            const usage = usageMetadata
+                ? {
+                    inputTokens: usageMetadata.promptTokenCount ?? 0,
+                    outputTokens: usageMetadata.candidatesTokenCount ?? 0,
+                    totalTokens: usageMetadata.totalTokenCount ?? 0,
+                }
+                : null;
+            if (schema != null) {
+                try {
+                    const parsed = schema.parse(JSON.parse(text));
+                    return {
+                        parsed,
+                        text,
+                        usage,
+                        error: null,
+                    };
+                }
+                catch (error) {
+                    return {
+                        parsed: null,
+                        text,
+                        usage,
+                        error: error instanceof Error ? error : new Error(String(error)),
+                    };
+                }
+            }
+            return {
+                parsed: text,
+                text,
+                usage,
+                error: null,
+            };
+        }
+        catch (error) {
+            return {
+                parsed: null,
+                text: null,
+                usage: null,
+                error: error instanceof Error ? error : new Error(String(error)),
+            };
+        }
+    }
+}

package/esm/src/providers/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Provider registry and pricing.
+ *
+ * This module consolidates all provider-related functionality:
+ * - Provider implementations (OpenAI, Google)
+ * - Cost calculation utilities
+ */
+export { getProvider, getProviderForModel } from './registry.js';
+export { OpenAIProvider } from './openai.js';
+export { GoogleProvider } from './google.js';
+export { getModelPricing, getModelInfo, calculateCost, type ModelPricing, type ModelInfo, } from './pricing.js';
+export type { Message, LLMResponse, LLMProvider, ProviderParams, LLMConversation, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/esm/src/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGjE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,EACN,eAAe,EACf,YAAY,EACZ,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,SAAS,GACd,MAAM,cAAc,CAAC;AAGtB,YAAY,EACX,OAAO,EACP,WAAW,EACX,WAAW,EACX,cAAc,EACd,eAAe,GACf,MAAM,YAAY,CAAC"}

package/esm/src/providers/index.js

@@ -0,0 +1,14 @@
+/**
+ * Provider registry and pricing.
+ *
+ * This module consolidates all provider-related functionality:
+ * - Provider implementations (OpenAI, Google)
+ * - Cost calculation utilities
+ */
+// Re-export provider registry functions
+export { getProvider, getProviderForModel } from './registry.js';
+// Re-export provider implementations
+export { OpenAIProvider } from './openai.js';
+export { GoogleProvider } from './google.js';
+// Re-export pricing utilities
+export { getModelPricing, getModelInfo, calculateCost, } from './pricing.js';

package/esm/src/providers/openai.d.ts

@@ -0,0 +1,12 @@
+import { z } from '../../deps/jsr.io/@zod/zod/4.3.6/src/index.js';
+import type { LLMProvider, LLMResponse, Message, ProviderParams } from './types.js';
+/**
+ * OpenAI LLM provider.
+ */
+export declare class OpenAIProvider implements LLMProvider {
+    readonly name = "openai";
+    private client;
+    constructor(apiKey?: string);
+    complete<T>(messages: Message[], model: string, schema: z.ZodType<T> | null, params?: ProviderParams): Promise<LLMResponse<T>>;
+}
+//# sourceMappingURL=openai.d.ts.map

package/esm/src/providers/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/src/providers/openai.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC,EAAE,MAAM,+CAA+C,CAAC;AAElE,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAyFpF;;GAEG;AACH,qBAAa,cAAe,YAAW,WAAW;IACjD,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,CAAC,EAAE,MAAM;IAarB,QAAQ,CAAC,CAAC,EACf,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,EAC3B,MAAM,CAAC,EAAE,cAAc,GACrB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CAkD1B"}

package/esm/src/providers/openai.js

@@ -0,0 +1,141 @@
+/**
+ * OpenAI provider implementation.
+ */
+import * as dntShim from "../../_dnt.shims.js";
+import OpenAI from 'openai';
+import { z } from '../../deps/jsr.io/@zod/zod/4.3.6/src/index.js';
+const zodTextFormatCache = new Map();
+class ZodValidationError extends Error {
+}
+/**
+ * Sanitizes a JSON schema for OpenAI compatibility.
+ * OpenAI's structured output has strict requirements:
+ * - additionalProperties must be false (not empty object or missing)
+ * - propertyNames is not permitted
+ */
+function sanitizeSchemaForOpenAI(schema) {
+    const result = {};
+    for (const [key, value] of Object.entries(schema)) {
+        // Remove unsupported keys
+        if (key === 'propertyNames') {
+            continue;
+        }
+        // Handle additionalProperties - set to false for strict mode
+        if (key === 'additionalProperties') {
+            result[key] = false;
+            continue;
+        }
+        // Recursively sanitize nested objects
+        if (value && typeof value === 'object' && !Array.isArray(value)) {
+            result[key] = sanitizeSchemaForOpenAI(value);
+        }
+        else if (Array.isArray(value)) {
+            result[key] = value.map(item => item && typeof item === 'object' && !Array.isArray(item)
+                ? sanitizeSchemaForOpenAI(item)
+                : item);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    // For object types without additionalProperties, add it as false
+    if (result['type'] === 'object' && !('additionalProperties' in result)) {
+        result['additionalProperties'] = false;
+    }
+    return result;
+}
+function getCachedZodTextFormat(zodObject, name) {
+    const cached = zodTextFormatCache.get(zodObject);
+    if (cached && cached.name === name) {
+        return cached;
+    }
+    const format = zodTextFormat(zodObject, name);
+    zodTextFormatCache.set(zodObject, format);
+    return format;
+}
+function zodTextFormat(zodObject, name) {
+    const rawSchema = z.toJSONSchema(zodObject, { target: 'draft-7' });
+    const sanitizedSchema = sanitizeSchemaForOpenAI(rawSchema);
+    return {
+        type: 'json_schema',
+        name,
+        strict: true,
+        schema: sanitizedSchema,
+        $brand: 'auto-parseable-response-format',
+        $parseRaw: (content) => {
+            try {
+                return zodObject.parse(JSON.parse(content));
+            }
+            catch (error) {
+                return new ZodValidationError(error instanceof Error ? error.message : String(error));
+            }
+        },
+        __output: undefined,
+    };
+}
+/**
+ * OpenAI LLM provider.
+ */
+export class OpenAIProvider {
+    name = 'openai';
+    client;
+    constructor(apiKey) {
+        const fetchOptions = {};
+        const abortSignal = dntShim.dntGlobalThis.abortSignal;
+        if (abortSignal) {
+            fetchOptions.signal = abortSignal;
+        }
+        this.client = new OpenAI({
+            apiKey: apiKey ?? dntShim.Deno.env.get('OPENAI_API_KEY'),
+            fetchOptions,
+        });
+    }
+    async complete(messages, model, schema, params) {
+        try {
+            const response = await this.client.responses.parse({
+                ...params,
+                model,
+                input: messages.map((m) => ({
+                    role: m.role,
+                    content: m.content,
+                })),
+                ...(schema != null
+                    ? {
+                        text: {
+                            format: getCachedZodTextFormat(schema, 'response'),
+                        },
+                    }
+                    : {}),
+            });
+            const usage = response.usage
+                ? {
+                    inputTokens: response.usage.input_tokens,
+                    outputTokens: response.usage.output_tokens,
+                    totalTokens: response.usage.total_tokens,
+                }
+                : null;
+            if (response.output_parsed instanceof Error) {
+                return {
+                    parsed: null,
+                    text: response.output_text,
+                    usage,
+                    error: response.output_parsed,
+                };
+            }
+            return {
+                parsed: schema != null ? response.output_parsed : response.output_text,
+                text: response.output_text,
+                usage,
+                error: null,
+            };
+        }
+        catch (error) {
+            return {
+                parsed: null,
+                text: null,
+                usage: null,
+                error: error instanceof Error ? error : new Error(String(error)),
+            };
+        }
+    }
+}

package/esm/src/providers/pricing.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Model pricing lookup and cost calculation.
+ *
+ * Pricing data is bundled from models.dev at build time.
+ * Run `deno task update-models` to refresh the data.
+ */
+import type { TokenUsage, UsageCost } from '../response.js';
+/**
+ * Pricing information for a model (USD per 1M tokens).
+ */
+export interface ModelPricing {
+    input: number;
+    output: number;
+    cacheRead?: number;
+    cacheWrite?: number;
+    reasoning?: number;
+}
+/**
+ * Model information including pricing and limits.
+ */
+export interface ModelInfo {
+    id: string;
+    name: string;
+    provider: string;
+    pricing: ModelPricing | null;
+    contextLimit: number | null;
+    outputLimit: number | null;
+    capabilities: {
+        structuredOutput: boolean;
+        toolCall: boolean;
+        reasoning: boolean;
+    };
+}
+interface ModelEntry {
+    id: string;
+    name: string;
+    cost?: {
+        input?: number;
+        output?: number;
+        cache_read?: number;
+        cache_write?: number;
+        reasoning?: number;
+    };
+    limit?: {
+        context?: number;
+        output?: number;
+    };
+    structured_output?: boolean;
+    tool_call?: boolean;
+    reasoning?: boolean;
+}
+/**
+ * Look up a model entry by ID (with normalization fallback).
+ */
+export declare function lookupModel(modelId: string): {
+    provider: string;
+    model: ModelEntry;
+} | null;
+/**
+ * Get pricing information for a model.
+ */
+export declare function getModelPricing(modelId: string): ModelPricing | null;
+/**
+ * Get full model information including pricing and capabilities.
+ */
+export declare function getModelInfo(modelId: string): ModelInfo | null;
+/**
+ * Calculate cost for token usage.
+ */
+export declare function calculateCost(modelId: string, usage: TokenUsage): UsageCost | null;
+export {};
+//# sourceMappingURL=pricing.d.ts.map

package/esm/src/providers/pricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../../../src/src/providers/pricing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE;QACb,gBAAgB,EAAE,OAAO,CAAC;QAC1B,QAAQ,EAAE,OAAO,CAAC;QAClB,SAAS,EAAE,OAAO,CAAC;KACnB,CAAC;CACF;AAGD,UAAU,UAAU;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,KAAK,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AA4BD;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GAAG,IAAI,CAE3F;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAoBpE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAsB9D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,IAAI,CAgBlF"}

package/esm/src/providers/pricing.js

@@ -0,0 +1,88 @@
+/**
+ * Model pricing lookup and cost calculation.
+ *
+ * Pricing data is bundled from models.dev at build time.
+ * Run `deno task update-models` to refresh the data.
+ */
+import modelsData from '../assets/models.js';
+// Build flat index: model ID -> { provider, model }
+const modelIndex = new Map();
+for (const [providerId, provider] of Object.entries(modelsData)) {
+    if (!provider.models)
+        continue;
+    for (const [modelId, model] of Object.entries(provider.models)) {
+        modelIndex.set(modelId, { provider: providerId, model });
+    }
+}
+/**
+ * Normalize a model ID by removing date suffixes and common variations.
+ */
+function normalizeModel(modelId) {
+    return modelId.replace(/-\d{4}-\d{2}-\d{2}$/, '');
+}
+/**
+ * Look up a model entry by ID (with normalization fallback).
+ */
+export function lookupModel(modelId) {
+    return modelIndex.get(modelId) ?? modelIndex.get(normalizeModel(modelId)) ?? null;
+}
+/**
+ * Get pricing information for a model.
+ */
+export function getModelPricing(modelId) {
+    const entry = lookupModel(modelId);
+    if (!entry?.model.cost) {
+        return null;
+    }
+    const cost = entry.model.cost;
+    if (cost.input === 0 && cost.output === 0) {
+        return null;
+    }
+    return {
+        input: cost.input ?? 0,
+        output: cost.output ?? 0,
+        cacheRead: cost.cache_read,
+        cacheWrite: cost.cache_write,
+        reasoning: cost.reasoning,
+    };
+}
+/**
+ * Get full model information including pricing and capabilities.
+ */
+export function getModelInfo(modelId) {
+    const entry = lookupModel(modelId);
+    if (!entry) {
+        return null;
+    }
+    const { provider, model: m } = entry;
+    return {
+        id: m.id,
+        name: m.name,
+        provider,
+        pricing: getModelPricing(modelId),
+        contextLimit: m.limit?.context ?? null,
+        outputLimit: m.limit?.output ?? null,
+        capabilities: {
+            structuredOutput: m.structured_output ?? false,
+            toolCall: m.tool_call ?? false,
+            reasoning: m.reasoning ?? false,
+        },
+    };
+}
+/**
+ * Calculate cost for token usage.
+ */
+export function calculateCost(modelId, usage) {
+    const pricing = getModelPricing(modelId);
+    if (!pricing) {
+        return null;
+    }
+    const inputCost = (usage.inputTokens / 1_000_000) * pricing.input;
+    const outputCost = (usage.outputTokens / 1_000_000) * pricing.output;
+    return {
+        inputCost,
+        outputCost,
+        totalCost: inputCost + outputCost,
+        currency: 'USD',
+    };
+}

package/esm/src/providers/registry.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Provider registry - instantiates LLM providers by name or model ID.
+ */
+import type { LLMProvider } from './types.js';
+/**
+ * Get a provider by name.
+ * Creates a fresh provider instance each time to support different API keys.
+ * @param name - Provider name ('openai', 'google')
+ * @param apiKey - Optional API key. If not provided, uses environment variable.
+ */
+export declare function getProvider(name: string, apiKey?: string): LLMProvider;
+/**
+ * Get the appropriate provider for a model ID.
+ * Infers provider from model name prefix.
+ * Creates a fresh provider instance each time to support different API keys.
+ * @param modelId - Model identifier (e.g., 'gpt-4.1', 'gemini-2.0-flash')
+ * @param apiKey - Optional API key. If not provided, uses environment variable.
+ */
+export declare function getProviderForModel(modelId: string, apiKey?: string): LLMProvider;
+//# sourceMappingURL=registry.d.ts.map

package/esm/src/providers/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/src/providers/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAQtE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CASjF"}