@jaypie/llm 1.1.30-rc.0 → 1.2.0-rc.0

package/dist/esm/operate/adapters/AnthropicAdapter.d.ts

@@ -1,4 +1,4 @@
-import { Anthropic } from "@anthropic-ai/sdk";
+import type { Anthropic } from "@anthropic-ai/sdk";
 import { JsonObject, NaturalSchema } from "@jaypie/types";
 import { z } from "zod/v4";
 import { Toolkit } from "../../tools/Toolkit.class.js";

package/dist/esm/operate/adapters/OpenRouterAdapter.d.ts

@@ -0,0 +1,96 @@
+import { JsonObject, NaturalSchema } from "@jaypie/types";
+import { z } from "zod/v4";
+import { Toolkit } from "../../tools/Toolkit.class.js";
+import { LlmHistory, LlmOperateOptions, LlmUsageItem } from "../../types/LlmProvider.interface.js";
+import { ClassifiedError, OperateRequest, ParsedResponse, ProviderToolDefinition, StandardToolCall, StandardToolResult } from "../types.js";
+import { BaseProviderAdapter } from "./ProviderAdapter.interface.js";
+interface OpenRouterMessage {
+    role: "system" | "user" | "assistant" | "tool";
+    content?: string | null;
+    toolCalls?: OpenRouterToolCall[];
+    toolCallId?: string;
+}
+interface OpenRouterToolCall {
+    id: string;
+    type: "function";
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+interface OpenRouterResponseMessage {
+    role: "assistant";
+    content?: string | null;
+    toolCalls?: OpenRouterToolCall[];
+    refusal?: string | null;
+    reasoning?: string | null;
+}
+interface OpenRouterChoice {
+    index: number;
+    message: OpenRouterResponseMessage;
+    finishReason: string | null;
+    finish_reason?: string | null;
+}
+interface OpenRouterUsage {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+    prompt_tokens?: number;
+    completion_tokens?: number;
+    total_tokens?: number;
+}
+interface OpenRouterResponse {
+    id: string;
+    object: string;
+    created: number;
+    model: string;
+    choices: OpenRouterChoice[];
+    usage?: OpenRouterUsage;
+}
+interface OpenRouterTool {
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: JsonObject;
+    };
+}
+interface OpenRouterRequest {
+    model: string;
+    messages: OpenRouterMessage[];
+    tools?: OpenRouterTool[];
+    tool_choice?: "auto" | "none" | "required";
+    response_format?: {
+        type: "json_object" | "text";
+    };
+    user?: string;
+}
+/**
+ * OpenRouterAdapter implements the ProviderAdapter interface for OpenRouter's API.
+ * OpenRouter provides a unified API to access hundreds of AI models through OpenAI-compatible endpoints.
+ * It handles request building, response parsing, and error classification
+ * specific to OpenRouter's Chat Completions API.
+ */
+export declare class OpenRouterAdapter extends BaseProviderAdapter {
+    readonly name: "openrouter";
+    readonly defaultModel: "openai/gpt-4o";
+    buildRequest(request: OperateRequest): OpenRouterRequest;
+    formatTools(toolkit: Toolkit, outputSchema?: JsonObject): ProviderToolDefinition[];
+    formatOutputSchema(schema: JsonObject | NaturalSchema | z.ZodType): JsonObject;
+    executeRequest(client: unknown, request: unknown): Promise<OpenRouterResponse>;
+    parseResponse(response: unknown, _options?: LlmOperateOptions): ParsedResponse;
+    extractToolCalls(response: unknown): StandardToolCall[];
+    extractUsage(response: unknown, model: string): LlmUsageItem;
+    formatToolResult(toolCall: StandardToolCall, result: StandardToolResult): OpenRouterMessage;
+    appendToolResult(request: unknown, toolCall: StandardToolCall, result: StandardToolResult): OpenRouterRequest;
+    responseToHistoryItems(response: unknown): LlmHistory;
+    classifyError(error: unknown): ClassifiedError;
+    isComplete(response: unknown): boolean;
+    hasStructuredOutput(response: unknown): boolean;
+    extractStructuredOutput(response: unknown): JsonObject | undefined;
+    private hasToolCalls;
+    private extractContent;
+    private convertMessagesToOpenRouter;
+}
+export declare const openRouterAdapter: OpenRouterAdapter;
+export {};

package/dist/esm/operate/adapters/index.d.ts

@@ -3,3 +3,4 @@ export type { ProviderAdapter } from "./ProviderAdapter.interface.js";
 export { AnthropicAdapter, anthropicAdapter } from "./AnthropicAdapter.js";
 export { GeminiAdapter, geminiAdapter } from "./GeminiAdapter.js";
 export { OpenAiAdapter, openAiAdapter } from "./OpenAiAdapter.js";
+export { OpenRouterAdapter, openRouterAdapter } from "./OpenRouterAdapter.js";

package/dist/esm/operate/index.d.ts

@@ -1,4 +1,4 @@
-export { AnthropicAdapter, anthropicAdapter, BaseProviderAdapter, GeminiAdapter, geminiAdapter, OpenAiAdapter, openAiAdapter, } from "./adapters/index.js";
+export { AnthropicAdapter, anthropicAdapter, BaseProviderAdapter, GeminiAdapter, geminiAdapter, OpenAiAdapter, openAiAdapter, OpenRouterAdapter, openRouterAdapter, } from "./adapters/index.js";
 export type { ProviderAdapter } from "./adapters/index.js";
 export { createOperateLoop, OperateLoop } from "./OperateLoop.js";
 export type { OperateLoopConfig } from "./OperateLoop.js";

package/dist/esm/providers/anthropic/utils.d.ts

@@ -1,43 +1,9 @@
-import { log } from "@jaypie/core";
-import Anthropic from "@anthropic-ai/sdk";
+import type Anthropic from "@anthropic-ai/sdk";
 import { LlmMessageOptions } from "../../types/LlmProvider.interface.js";
 import { z } from "zod/v4";
 import { JsonObject, NaturalSchema } from "@jaypie/types";
-export declare const getLogger: () => {
-    debug: {
-        (...args: unknown[]): void;
-        var(key: string | Record<string, unknown>, value?: unknown): void;
-    };
-    error: {
-        (...args: unknown[]): void;
-        var(key: string | Record<string, unknown>, value?: unknown): void;
-    };
-    fatal: {
-        (...args: unknown[]): void;
-        var(key: string | Record<string, unknown>, value?: unknown): void;
-    };
-    info: {
-        (...args: unknown[]): void;
-        var(key: string | Record<string, unknown>, value?: unknown): void;
-    };
-    trace: {
-        (...args: unknown[]): void;
-        var(key: string | Record<string, unknown>, value?: unknown): void;
-    };
-    warn: {
-        (...args: unknown[]): void;
-        var(key: string | Record<string, unknown>, value?: unknown): void;
-    };
-    var(key: string | Record<string, unknown>, value?: unknown): void;
-    with(tags: Record<string, unknown>): typeof log;
-    tag(key: string | string[] | Record<string, unknown> | null, value?: string): void;
-    untag(tags: string | string[] | Record<string, unknown> | null): void;
-    lib(options: {
-        level?: string;
-        lib?: string;
-        tags?: Record<string, unknown>;
-    }): typeof log;
-};
+export declare function loadSdk(): Promise<typeof import("@anthropic-ai/sdk")>;
+export declare const getLogger: () => import("@jaypie/logger/dist/esm/JaypieLogger.js").default;
 export declare function initializeClient({ apiKey, }?: {
     apiKey?: string;
 }): Promise<Anthropic>;

package/dist/esm/providers/gemini/utils.d.ts

@@ -1,41 +1,7 @@
-import { log as defaultLog } from "@jaypie/core";
-import { GoogleGenAI } from "@google/genai";
+import type { GoogleGenAI } from "@google/genai";
 import { LlmMessageOptions } from "../../types/LlmProvider.interface.js";
-export declare const getLogger: () => {
-    debug: {
-        (...args: unknown[]): void;
-        var(key: string | Record<string, unknown>, value?: unknown): void;
-    };
-    error: {
-        (...args: unknown[]): void;
-        var(key: string | Record<string, unknown>, value?: unknown): void;
-    };
-    fatal: {
-        (...args: unknown[]): void;
-        var(key: string | Record<string, unknown>, value?: unknown): void;
-    };
-    info: {
-        (...args: unknown[]): void;
-        var(key: string | Record<string, unknown>, value?: unknown): void;
-    };
-    trace: {
-        (...args: unknown[]): void;
-        var(key: string | Record<string, unknown>, value?: unknown): void;
-    };
-    warn: {
-        (...args: unknown[]): void;
-        var(key: string | Record<string, unknown>, value?: unknown): void;
-    };
-    var(key: string | Record<string, unknown>, value?: unknown): void;
-    with(tags: Record<string, unknown>): typeof defaultLog;
-    tag(key: string | string[] | Record<string, unknown> | null, value?: string): void;
-    untag(tags: string | string[] | Record<string, unknown> | null): void;
-    lib(options: {
-        level?: string;
-        lib?: string;
-        tags?: Record<string, unknown>;
-    }): typeof defaultLog;
-};
+export declare function loadSdk(): Promise<typeof import("@google/genai")>;
+export declare const getLogger: () => import("@jaypie/logger/dist/esm/JaypieLogger.js").default;
 export declare function initializeClient({ apiKey, }?: {
     apiKey?: string;
 }): Promise<GoogleGenAI>;

package/dist/esm/providers/openai/utils.d.ts

@@ -1,43 +1,8 @@
-import { log as defaultLog } from "@jaypie/core";
 import { JsonObject, NaturalSchema } from "@jaypie/types";
 import { OpenAI } from "openai";
 import { z } from "zod/v4";
 import { LlmMessageOptions } from "../../types/LlmProvider.interface.js";
-export declare const getLogger: () => {
-    debug: {
-        (...args: unknown[]): void;
-        var(key: string | Record<string, unknown>, value?: unknown): void;
-    };
-    error: {
-        (...args: unknown[]): void;
-        var(key: string | Record<string, unknown>, value?: unknown): void;
-    };
-    fatal: {
-        (...args: unknown[]): void;
-        var(key: string | Record<string, unknown>, value?: unknown): void;
-    };
-    info: {
-        (...args: unknown[]): void;
-        var(key: string | Record<string, unknown>, value?: unknown): void;
-    };
-    trace: {
-        (...args: unknown[]): void;
-        var(key: string | Record<string, unknown>, value?: unknown): void;
-    };
-    warn: {
-        (...args: unknown[]): void;
-        var(key: string | Record<string, unknown>, value?: unknown): void;
-    };
-    var(key: string | Record<string, unknown>, value?: unknown): void;
-    with(tags: Record<string, unknown>): typeof defaultLog;
-    tag(key: string | string[] | Record<string, unknown> | null, value?: string): void;
-    untag(tags: string | string[] | Record<string, unknown> | null): void;
-    lib(options: {
-        level?: string;
-        lib?: string;
-        tags?: Record<string, unknown>;
-    }): typeof defaultLog;
-};
+export declare const getLogger: () => import("@jaypie/logger/dist/esm/JaypieLogger.js").default;
 export declare function initializeClient({ apiKey, }?: {
     apiKey?: string;
 }): Promise<OpenAI>;

package/dist/esm/providers/openrouter/OpenRouterProvider.class.d.ts

@@ -0,0 +1,17 @@
+import { JsonObject } from "@jaypie/types";
+import { LlmHistory, LlmInputMessage, LlmMessageOptions, LlmOperateOptions, LlmOperateResponse, LlmProvider } from "../../types/LlmProvider.interface.js";
+export declare class OpenRouterProvider implements LlmProvider {
+    private model;
+    private _client?;
+    private _operateLoop?;
+    private apiKey?;
+    private log;
+    private conversationHistory;
+    constructor(model?: string, { apiKey }?: {
+        apiKey?: string;
+    });
+    private getClient;
+    private getOperateLoop;
+    send(message: string, options?: LlmMessageOptions): Promise<string | JsonObject>;
+    operate(input: string | LlmHistory | LlmInputMessage, options?: LlmOperateOptions): Promise<LlmOperateResponse>;
+}

package/dist/esm/providers/openrouter/index.d.ts

@@ -0,0 +1,2 @@
+export { OpenRouterProvider } from "./OpenRouterProvider.class.js";
+export * from "./utils.js";

package/dist/esm/providers/openrouter/utils.d.ts

@@ -0,0 +1,15 @@
+import type { OpenRouter } from "@openrouter/sdk";
+import { LlmMessageOptions } from "../../types/LlmProvider.interface.js";
+export declare function loadSdk(): Promise<typeof import("@openrouter/sdk")>;
+export declare const getLogger: () => import("@jaypie/logger/dist/esm/JaypieLogger.js").default;
+export declare function initializeClient({ apiKey, }?: {
+    apiKey?: string;
+}): Promise<OpenRouter>;
+export declare function getDefaultModel(): string;
+export interface ChatMessage {
+    role: "system" | "user" | "assistant";
+    content: string;
+}
+export declare function formatSystemMessage(systemPrompt: string, { data, placeholders }?: Pick<LlmMessageOptions, "data" | "placeholders">): ChatMessage;
+export declare function formatUserMessage(message: string, { data, placeholders }?: Pick<LlmMessageOptions, "data" | "placeholders">): ChatMessage;
+export declare function prepareMessages(message: string, { system, data, placeholders }?: LlmMessageOptions): ChatMessage[];

package/dist/esm/util/logger.d.ts

@@ -1,71 +1,2 @@
-import { log as defaultLog } from "@jaypie/core";
-export declare const getLogger: () => {
-    debug: {
-        (...args: unknown[]): void;
-        var(key: string | Record<string, unknown>, value?: unknown): void;
-    };
-    error: {
-        (...args: unknown[]): void;
-        var(key: string | Record<string, unknown>, value?: unknown): void;
-    };
-    fatal: {
-        (...args: unknown[]): void;
-        var(key: string | Record<string, unknown>, value?: unknown): void;
-    };
-    info: {
-        (...args: unknown[]): void;
-        var(key: string | Record<string, unknown>, value?: unknown): void;
-    };
-    trace: {
-        (...args: unknown[]): void;
-        var(key: string | Record<string, unknown>, value?: unknown): void;
-    };
-    warn: {
-        (...args: unknown[]): void;
-        var(key: string | Record<string, unknown>, value?: unknown): void;
-    };
-    var(key: string | Record<string, unknown>, value?: unknown): void;
-    with(tags: Record<string, unknown>): typeof defaultLog;
-    tag(key: string | string[] | Record<string, unknown> | null, value?: string): void;
-    untag(tags: string | string[] | Record<string, unknown> | null): void;
-    lib(options: {
-        level?: string;
-        lib?: string;
-        tags?: Record<string, unknown>;
-    }): typeof defaultLog;
-};
-export declare const log: {
-    debug: {
-        (...args: unknown[]): void;
-        var(key: string | Record<string, unknown>, value?: unknown): void;
-    };
-    error: {
-        (...args: unknown[]): void;
-        var(key: string | Record<string, unknown>, value?: unknown): void;
-    };
-    fatal: {
-        (...args: unknown[]): void;
-        var(key: string | Record<string, unknown>, value?: unknown): void;
-    };
-    info: {
-        (...args: unknown[]): void;
-        var(key: string | Record<string, unknown>, value?: unknown): void;
-    };
-    trace: {
-        (...args: unknown[]): void;
-        var(key: string | Record<string, unknown>, value?: unknown): void;
-    };
-    warn: {
-        (...args: unknown[]): void;
-        var(key: string | Record<string, unknown>, value?: unknown): void;
-    };
-    var(key: string | Record<string, unknown>, value?: unknown): void;
-    with(tags: Record<string, unknown>): typeof defaultLog;
-    tag(key: string | string[] | Record<string, unknown> | null, value?: string): void;
-    untag(tags: string | string[] | Record<string, unknown> | null): void;
-    lib(options: {
-        level?: string;
-        lib?: string;
-        tags?: Record<string, unknown>;
-    }): typeof defaultLog;
-};
+export declare const getLogger: () => import("@jaypie/logger/dist/esm/JaypieLogger").default;
+export declare const log: import("@jaypie/logger/dist/esm/JaypieLogger").default;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jaypie/llm",
-  "version": "1.1.30-rc.0",
+  "version": "1.2.0-rc.0",
   "description": "Large language model utilities",
   "repository": {
     "type": "git",
@@ -8,6 +8,7 @@
   },
   "license": "MIT",
   "author": "Finlayson Studio",
+  "sideEffects": false,
   "type": "module",
   "exports": {
     ".": {
@@ -31,11 +32,8 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@anthropic-ai/sdk": "^0.71.0",
-    "@google/genai": "^1.30.0",
-    "@jaypie/aws": "^1.1.15",
-    "@jaypie/core": "^1.1.2",
-    "@jaypie/errors": "^1.1.6",
+    "@jaypie/aws": "1.2.0-rc.0",
+    "@jaypie/errors": "1.2.0-rc.0",
     "openai": "^6.9.1",
     "openmeteo": "^1.2.0",
     "random": "^5.3.0",
@@ -43,7 +41,26 @@
     "zod": "^4.1.13"
   },
   "devDependencies": {
-    "@jaypie/types": "^0.1.3"
+    "@anthropic-ai/sdk": "^0.71.0",
+    "@google/genai": "^1.30.0",
+    "@jaypie/types": "*",
+    "@openrouter/sdk": "^0.1.27"
+  },
+  "peerDependencies": {
+    "@anthropic-ai/sdk": "^0.71.0",
+    "@google/genai": "^1.30.0",
+    "@openrouter/sdk": "^0.1.27"
+  },
+  "peerDependenciesMeta": {
+    "@anthropic-ai/sdk": {
+      "optional": true
+    },
+    "@google/genai": {
+      "optional": true
+    },
+    "@openrouter/sdk": {
+      "optional": true
+    }
   },
   "publishConfig": {
     "access": "public"

package/dist/cjs/providers/anthropic/operate.d.ts

@@ -1,16 +0,0 @@
-import { Anthropic } from "@anthropic-ai/sdk";
-import { LlmHistory, LlmInputMessage, LlmOperateOptions, LlmOperateResponse } from "../../types/LlmProvider.interface.js";
-import { LlmTool } from "../../types/LlmTool.interface.js";
-/**
- * OpenAI request options type that includes model and input properties
- */
-export type AnthropicRequestOptions = Omit<LlmOperateOptions, "tools"> & {
-    model: string;
-    input: LlmInputMessage | LlmHistory;
-    text?: unknown;
-    tools?: Omit<LlmTool, "call">[];
-};
-export declare function operate(input: string | LlmHistory | LlmInputMessage, options?: LlmOperateOptions, context?: {
-    client: Anthropic;
-    maxRetries?: number;
-}): Promise<LlmOperateResponse>;

package/dist/cjs/providers/openai/operate.d.ts

@@ -1,26 +0,0 @@
-import { OpenAI } from "openai";
-import { LlmHistory, LlmInputMessage, LlmOperateOptions, LlmOperateResponse } from "../../types/LlmProvider.interface.js";
-import { LlmTool } from "../../types/LlmTool.interface.js";
-/**
- * OpenAI request options type that includes model and input properties
- */
-export type OpenAiRequestOptions = Omit<LlmOperateOptions, "tools"> & {
-    model: string;
-    input: LlmInputMessage | LlmHistory;
-    text?: unknown;
-    tools?: Omit<LlmTool, "call">[];
-};
-export declare const MAX_RETRIES_ABSOLUTE_LIMIT = 72;
-export declare const MAX_RETRIES_DEFAULT_LIMIT = 6;
-/**
- * Creates the request options for the OpenAI API call
- *
- * @param input - The formatted input messages
- * @param options - The LLM operation options
- * @returns The request options for the OpenAI API
- */
-export declare function createRequestOptions(input: LlmInputMessage | LlmHistory, options?: LlmOperateOptions): OpenAiRequestOptions;
-export declare function operate(input: string | LlmHistory | LlmInputMessage, options?: LlmOperateOptions, context?: {
-    client: OpenAI;
-    maxRetries?: number;
-}): Promise<LlmOperateResponse>;

package/dist/esm/providers/anthropic/operate.d.ts

@@ -1,16 +0,0 @@
-import { Anthropic } from "@anthropic-ai/sdk";
-import { LlmHistory, LlmInputMessage, LlmOperateOptions, LlmOperateResponse } from "../../types/LlmProvider.interface.js";
-import { LlmTool } from "../../types/LlmTool.interface.js";
-/**
- * OpenAI request options type that includes model and input properties
- */
-export type AnthropicRequestOptions = Omit<LlmOperateOptions, "tools"> & {
-    model: string;
-    input: LlmInputMessage | LlmHistory;
-    text?: unknown;
-    tools?: Omit<LlmTool, "call">[];
-};
-export declare function operate(input: string | LlmHistory | LlmInputMessage, options?: LlmOperateOptions, context?: {
-    client: Anthropic;
-    maxRetries?: number;
-}): Promise<LlmOperateResponse>;

package/dist/esm/providers/openai/operate.d.ts

@@ -1,26 +0,0 @@
-import { OpenAI } from "openai";
-import { LlmHistory, LlmInputMessage, LlmOperateOptions, LlmOperateResponse } from "../../types/LlmProvider.interface.js";
-import { LlmTool } from "../../types/LlmTool.interface.js";
-/**
- * OpenAI request options type that includes model and input properties
- */
-export type OpenAiRequestOptions = Omit<LlmOperateOptions, "tools"> & {
-    model: string;
-    input: LlmInputMessage | LlmHistory;
-    text?: unknown;
-    tools?: Omit<LlmTool, "call">[];
-};
-export declare const MAX_RETRIES_ABSOLUTE_LIMIT = 72;
-export declare const MAX_RETRIES_DEFAULT_LIMIT = 6;
-/**
- * Creates the request options for the OpenAI API call
- *
- * @param input - The formatted input messages
- * @param options - The LLM operation options
- * @returns The request options for the OpenAI API
- */
-export declare function createRequestOptions(input: LlmInputMessage | LlmHistory, options?: LlmOperateOptions): OpenAiRequestOptions;
-export declare function operate(input: string | LlmHistory | LlmInputMessage, options?: LlmOperateOptions, context?: {
-    client: OpenAI;
-    maxRetries?: number;
-}): Promise<LlmOperateResponse>;