@node-llm/core 0.1.0 → 0.2.0

package/dist/errors/index.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Base class for all node-llm errors
+ */
+export declare class LLMError extends Error {
+    readonly code?: string | undefined;
+    constructor(message: string, code?: string | undefined);
+}
+/**
+ * Errors occurring during API calls to providers
+ */
+export declare class APIError extends LLMError {
+    readonly status: number;
+    readonly body: any;
+    readonly provider?: string | undefined;
+    readonly model?: string | undefined;
+    constructor(message: string, status: number, body: any, provider?: string | undefined, model?: string | undefined);
+}
+/**
+ * 400 - Invalid request parameters
+ */
+export declare class BadRequestError extends APIError {
+    constructor(message: string, body: any, provider?: string, model?: string);
+}
+/**
+ * 401/403 - API key or permission issues
+ */
+export declare class AuthenticationError extends APIError {
+    constructor(message: string, status: number, body: any, provider?: string);
+}
+/**
+ * 429 - Rate limit exceeded
+ */
+export declare class RateLimitError extends APIError {
+    constructor(message: string, body: any, provider?: string, model?: string);
+}
+/**
+ * 500+ - Provider server error
+ */
+export declare class ServerError extends APIError {
+    constructor(message: string, status: number, body: any, provider?: string, model?: string);
+}
+/**
+ * 502/503/529 - Service overloaded/unavailable
+ */
+export declare class ServiceUnavailableError extends ServerError {
+    constructor(message: string, status: number, body: any, provider?: string, model?: string);
+}
+/**
+ * Misconfiguration (e.g. missing API key)
+ */
+export declare class ConfigurationError extends LLMError {
+    constructor(message: string);
+}
+/**
+ * Requested model or provider not found
+ */
+export declare class NotFoundError extends LLMError {
+    constructor(message: string);
+}
+/**
+ * Model does not support requested capability
+ */
+export declare class CapabilityError extends LLMError {
+    constructor(message: string);
+}
+//# 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":"AAAA;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;aACY,IAAI,CAAC,EAAE,MAAM;gBAA9C,OAAO,EAAE,MAAM,EAAkB,IAAI,CAAC,EAAE,MAAM,YAAA;CAK3D;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,QAAQ;aAGlB,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,GAAG;aACT,QAAQ,CAAC,EAAE,MAAM;aACjB,KAAK,CAAC,EAAE,MAAM;gBAJ9B,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,GAAG,EACT,QAAQ,CAAC,EAAE,MAAM,YAAA,EACjB,KAAK,CAAC,EAAE,MAAM,YAAA;CAIjC;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAI1E;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,MAAM;CAI1E;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,QAAQ;gBAC9B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAI1E;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,QAAQ;gBAC3B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAI1F;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,WAAW;gBAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAI1F;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ;gBAClC,OAAO,EAAE,MAAM;CAG5B;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,OAAO,EAAE,MAAM;CAG5B;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM;CAG5B"}

package/dist/errors/index.js

@@ -0,0 +1,97 @@
+/**
+ * Base class for all node-llm errors
+ */
+export class LLMError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = this.constructor.name;
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+/**
+ * Errors occurring during API calls to providers
+ */
+export class APIError extends LLMError {
+    status;
+    body;
+    provider;
+    model;
+    constructor(message, status, body, provider, model) {
+        super(message, "API_ERROR");
+        this.status = status;
+        this.body = body;
+        this.provider = provider;
+        this.model = model;
+    }
+}
+/**
+ * 400 - Invalid request parameters
+ */
+export class BadRequestError extends APIError {
+    constructor(message, body, provider, model) {
+        super(message, 400, body, provider, model);
+        this.name = "BadRequestError";
+    }
+}
+/**
+ * 401/403 - API key or permission issues
+ */
+export class AuthenticationError extends APIError {
+    constructor(message, status, body, provider) {
+        super(message, status, body, provider);
+        this.name = "AuthenticationError";
+    }
+}
+/**
+ * 429 - Rate limit exceeded
+ */
+export class RateLimitError extends APIError {
+    constructor(message, body, provider, model) {
+        super(message, 429, body, provider, model);
+        this.name = "RateLimitError";
+    }
+}
+/**
+ * 500+ - Provider server error
+ */
+export class ServerError extends APIError {
+    constructor(message, status, body, provider, model) {
+        super(message, status, body, provider, model);
+        this.name = "ServerError";
+    }
+}
+/**
+ * 502/503/529 - Service overloaded/unavailable
+ */
+export class ServiceUnavailableError extends ServerError {
+    constructor(message, status, body, provider, model) {
+        super(message, status, body, provider, model);
+        this.name = "ServiceUnavailableError";
+    }
+}
+/**
+ * Misconfiguration (e.g. missing API key)
+ */
+export class ConfigurationError extends LLMError {
+    constructor(message) {
+        super(message, "CONFIGURATION_ERROR");
+    }
+}
+/**
+ * Requested model or provider not found
+ */
+export class NotFoundError extends LLMError {
+    constructor(message) {
+        super(message, "NOT_FOUND_ERROR");
+    }
+}
+/**
+ * Model does not support requested capability
+ */
+export class CapabilityError extends LLMError {
+    constructor(message) {
+        super(message, "CAPABILITY_ERROR");
+    }
+}

package/dist/executor/Executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Executor.d.ts","sourceRoot":"","sources":["../../src/executor/Executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE/E,qBAAa,QAAQ;IAEjB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAGzD,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;CAqB/D"}
+{"version":3,"file":"Executor.d.ts","sourceRoot":"","sources":["../../src/executor/Executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAG/E,qBAAa,QAAQ;IAEjB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAGzD,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;CAwB/D"}

package/dist/executor/Executor.js

@@ -1,3 +1,4 @@
+import { RateLimitError, ServerError } from "../errors/index.js";
 export class Executor {
     provider;
     retry;
@@ -13,7 +14,9 @@ export class Executor {
             }
             catch (error) {
                 lastError = error;
-                if (attempt >= this.retry.attempts) {
+                // If it's a fatal error (BadRequest, Authentication), don't retry
+                const isRetryable = error instanceof RateLimitError || error instanceof ServerError;
+                if (!isRetryable || attempt >= this.retry.attempts) {
                     throw error;
                 }
                 if (this.retry.delayMs > 0) {

package/dist/image/GeneratedImage.d.ts

@@ -0,0 +1,25 @@
+import { Readable } from "stream";
+import { ImageResponse } from "../providers/Provider.js";
+export declare class GeneratedImage extends String {
+    private readonly response;
+    constructor(response: ImageResponse);
+    get url(): string | undefined;
+    get data(): string | undefined;
+    get revisedPrompt(): string | undefined;
+    get mimeType(): string | undefined;
+    get isBase64(): boolean;
+    /**
+     * Returns the raw binary image data as a Buffer.
+     */
+    toBuffer(): Promise<Buffer>;
+    /**
+     * Returns a Readable stream of the image data.
+     */
+    toStream(): Promise<Readable>;
+    /**
+     * Saves the image to the specified local path.
+     */
+    save(path: string): Promise<string>;
+    toString(): string;
+}
+//# sourceMappingURL=GeneratedImage.d.ts.map

package/dist/image/GeneratedImage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeneratedImage.d.ts","sourceRoot":"","sources":["../../src/image/GeneratedImage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,qBAAa,cAAe,SAAQ,MAAM;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,aAAa;IAIpD,IAAI,GAAG,IAAI,MAAM,GAAG,SAAS,CAE5B;IAED,IAAI,IAAI,IAAI,MAAM,GAAG,SAAS,CAE7B;IAED,IAAI,aAAa,IAAI,MAAM,GAAG,SAAS,CAEtC;IAED,IAAI,QAAQ,IAAI,MAAM,GAAG,SAAS,CAEjC;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IAiBjC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IAKnC;;OAEG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMzC,QAAQ;CAGT"}

package/dist/image/GeneratedImage.js

@@ -0,0 +1,59 @@
+import fs from "fs/promises";
+import { Readable } from "stream";
+export class GeneratedImage extends String {
+    response;
+    constructor(response) {
+        super(response.url || "");
+        this.response = response;
+    }
+    get url() {
+        return this.response.url;
+    }
+    get data() {
+        return this.response.data;
+    }
+    get revisedPrompt() {
+        return this.response.revised_prompt;
+    }
+    get mimeType() {
+        return this.response.mime_type;
+    }
+    get isBase64() {
+        return !!this.data;
+    }
+    /**
+     * Returns the raw binary image data as a Buffer.
+     */
+    async toBuffer() {
+        if (this.data) {
+            return Buffer.from(this.data, "base64");
+        }
+        if (this.url) {
+            const resp = await fetch(this.url);
+            if (!resp.ok) {
+                throw new Error(`Failed to download image from ${this.url}: ${resp.statusText}`);
+            }
+            const arrayBuffer = await resp.arrayBuffer();
+            return Buffer.from(arrayBuffer);
+        }
+        throw new Error("No image data or URL available");
+    }
+    /**
+     * Returns a Readable stream of the image data.
+     */
+    async toStream() {
+        const buffer = await this.toBuffer();
+        return Readable.from(buffer);
+    }
+    /**
+     * Saves the image to the specified local path.
+     */
+    async save(path) {
+        const buffer = await this.toBuffer();
+        await fs.writeFile(path, buffer);
+        return path;
+    }
+    toString() {
+        return this.valueOf();
+    }
+}

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 export { Chat } from "./chat/Chat.js";
+export { Stream } from "./chat/Stream.js";
+export { GeneratedImage } from "./image/GeneratedImage.js";
 export type { Message } from "./chat/Message.js";
 export type { Role } from "./chat/Role.js";
 export type { ChatOptions } from "./chat/ChatOptions.js";
@@ -8,4 +10,6 @@ export { LLM } from "./llm.js";
 export { providerRegistry } from "./providers/registry.js";
 export { OpenAIProvider } from "./providers/openai/OpenAIProvider.js";
 export { registerOpenAIProvider } from "./providers/openai/index.js";
+export type { ImageRequest, ImageResponse } from "./providers/Provider.js";
+export * from "./errors/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,YAAY,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACrD,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErE,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,YAAY,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACrD,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErE,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC3E,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -1,5 +1,8 @@
 export { Chat } from "./chat/Chat.js";
+export { Stream } from "./chat/Stream.js";
+export { GeneratedImage } from "./image/GeneratedImage.js";
 export { LLM } from "./llm.js";
 export { providerRegistry } from "./providers/registry.js";
 export { OpenAIProvider } from "./providers/openai/OpenAIProvider.js";
 export { registerOpenAIProvider } from "./providers/openai/index.js";
+export * from "./errors/index.js";

package/dist/llm.d.ts

@@ -1,6 +1,7 @@
 import { Chat } from "./chat/Chat.js";
 import { ChatOptions } from "./chat/ChatOptions.js";
 import { Provider } from "./providers/Provider.js";
+import { GeneratedImage } from "./image/GeneratedImage.js";
 export interface RetryOptions {
     attempts?: number;
     delayMs?: number;
@@ -18,6 +19,11 @@ declare class LLMCore {
     configure(config: LLMConfig): void;
     chat(model: string, options?: ChatOptions): Chat;
     listModels(): Promise<import("./providers/Provider.js").ModelInfo[]>;
+    paint(prompt: string, options?: {
+        model?: string;
+        size?: string;
+        quality?: string;
+    }): Promise<GeneratedImage>;
     getRetryConfig(): Required<RetryOptions>;
 }
 export declare const LLM: LLMCore;

package/dist/llm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../src/llm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAInD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,KAAK,SAAS,GACV;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,KAAK,CAAC,EAAE,YAAY,CAAA;CAAE,GAC5C;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,YAAY,CAAA;CAAE,CAAC;AAE/C,cAAM,OAAO;IACX,OAAO,CAAC,QAAQ,CAAC,CAAW;IAE5B,OAAO,CAAC,KAAK,CAGX;IAEF,SAAS,CAAC,MAAM,EAAE,SAAS;IAmB3B,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI;IAQ1C,UAAU;IAUhB,cAAc;CAIf;AAED,eAAO,MAAM,GAAG,SAAgB,CAAC"}
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../src/llm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEtC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAGnD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,KAAK,SAAS,GACV;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,KAAK,CAAC,EAAE,YAAY,CAAA;CAAE,GAC5C;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,YAAY,CAAA;CAAE,CAAC;AAE/C,cAAM,OAAO;IACX,OAAO,CAAC,QAAQ,CAAC,CAAW;IAE5B,OAAO,CAAC,KAAK,CAGX;IAEF,SAAS,CAAC,MAAM,EAAE,SAAS;IAmB3B,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI;IAQ1C,UAAU;IAUV,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAgBnH,cAAc;CAIf;AAED,eAAO,MAAM,GAAG,SAAgB,CAAC"}

package/dist/llm.js

@@ -1,6 +1,7 @@
 import { Chat } from "./chat/Chat.js";
 import { providerRegistry } from "./providers/registry.js";
 import { ensureOpenAIRegistered } from "./providers/openai/register.js";
+import { GeneratedImage } from "./image/GeneratedImage.js";
 class LLMCore {
     provider;
     retry = {
@@ -35,10 +36,23 @@ class LLMCore {
             throw new Error("LLM provider not configured");
         }
         if (!this.provider.listModels) {
-            throw new Error(`Provider ${typeof this.provider} does not support listModels`);
+            throw new Error(`Provider does not support listModels`);
         }
         return this.provider.listModels();
     }
+    async paint(prompt, options) {
+        if (!this.provider) {
+            throw new Error("LLM provider not configured");
+        }
+        if (!this.provider.paint) {
+            throw new Error(`Provider does not support paint`);
+        }
+        const response = await this.provider.paint({
+            prompt,
+            ...options,
+        });
+        return new GeneratedImage(response);
+    }
     getRetryConfig() {
         return this.retry;
     }

package/dist/providers/Provider.d.ts

@@ -11,9 +11,16 @@ export interface ChatChunk {
     content: string;
     done?: boolean;
 }
+export interface Usage {
+    input_tokens: number;
+    output_tokens: number;
+    total_tokens: number;
+    cached_tokens?: number;
+}
 export interface ChatResponse {
     content: string | null;
     tool_calls?: ToolCall[];
+    usage?: Usage;
 }
 export interface ProviderCapabilities {
     supportsVision: (model: string) => boolean;
@@ -36,10 +43,24 @@ export interface ModelInfo {
     pricing: any;
     metadata?: Record<string, any>;
 }
+export interface ImageRequest {
+    model?: string;
+    prompt: string;
+    size?: string;
+    quality?: string;
+    n?: number;
+}
+export interface ImageResponse {
+    url?: string;
+    data?: string;
+    mime_type?: string;
+    revised_prompt?: string;
+}
 export interface Provider {
     chat(request: ChatRequest): Promise<ChatResponse>;
     stream?(request: ChatRequest): AsyncIterable<ChatChunk>;
     listModels?(): Promise<ModelInfo[]>;
+    paint?(request: ImageRequest): Promise<ImageResponse>;
     capabilities?: ProviderCapabilities;
 }
 //# sourceMappingURL=Provider.d.ts.map

package/dist/providers/Provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Provider.d.ts","sourceRoot":"","sources":["../../src/providers/Provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGjD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3C,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1C,wBAAwB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IACrD,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CACpD;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAClD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,GAAG,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAClD,MAAM,CAAC,CAAC,OAAO,EAAE,WAAW,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACxD,UAAU,CAAC,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACpC,YAAY,CAAC,EAAE,oBAAoB,CAAC;CACrC"}
+{"version":3,"file":"Provider.d.ts","sourceRoot":"","sources":["../../src/providers/Provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGjD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,KAAK;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3C,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1C,wBAAwB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IACrD,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CACpD;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAClD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,GAAG,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAClD,MAAM,CAAC,CAAC,OAAO,EAAE,WAAW,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACxD,UAAU,CAAC,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACpC,KAAK,CAAC,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACtD,YAAY,CAAC,EAAE,oBAAoB,CAAC;CACrC"}

package/dist/providers/openai/Chat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Chat.d.ts","sourceRoot":"","sources":["../../../src/providers/openai/Chat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAI3D,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,OAAO;IAAU,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAxC,OAAO,EAAE,MAAM,EAAmB,MAAM,EAAE,MAAM;IAEvE,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;CA+C3D"}
+{"version":3,"file":"Chat.d.ts","sourceRoot":"","sources":["../../../src/providers/openai/Chat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAK3D,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,OAAO;IAAU,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAxC,OAAO,EAAE,MAAM,EAAmB,MAAM,EAAE,MAAM;IAEvE,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;CAqD3D"}

package/dist/providers/openai/Chat.js

@@ -1,4 +1,5 @@
 import { Capabilities } from "./Capabilities.js";
+import { handleOpenAIError } from "./Errors.js";
 export class OpenAIChat {
     baseUrl;
     apiKey;
@@ -32,16 +33,21 @@ export class OpenAIChat {
             body: JSON.stringify(body),
         });
         if (!response.ok) {
-            const errorText = await response.text();
-            throw new Error(`OpenAI error (${response.status}): ${errorText}`);
+            await handleOpenAIError(response, request.model);
         }
         const json = (await response.json());
         const message = json.choices[0]?.message;
         const content = message?.content ?? null;
         const tool_calls = message?.tool_calls;
+        const usage = json.usage ? {
+            input_tokens: json.usage.prompt_tokens,
+            output_tokens: json.usage.completion_tokens,
+            total_tokens: json.usage.total_tokens,
+            cached_tokens: json.usage.prompt_tokens_details?.cached_tokens,
+        } : undefined;
         if (!content && !tool_calls) {
             throw new Error("OpenAI returned empty response");
         }
-        return { content, tool_calls };
+        return { content, tool_calls, usage };
     }
 }

package/dist/providers/openai/Errors.d.ts

@@ -0,0 +1,2 @@
+export declare function handleOpenAIError(response: Response, model?: string): Promise<never>;
+//# sourceMappingURL=Errors.d.ts.map

package/dist/providers/openai/Errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Errors.d.ts","sourceRoot":"","sources":["../../../src/providers/openai/Errors.ts"],"names":[],"mappings":"AASA,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAuC1F"}

package/dist/providers/openai/Errors.js

@@ -0,0 +1,34 @@
+import { BadRequestError, AuthenticationError, RateLimitError, ServerError, ServiceUnavailableError, APIError } from "../../errors/index.js";
+export async function handleOpenAIError(response, model) {
+    const status = response.status;
+    let body;
+    let message = `OpenAI error (${status})`;
+    try {
+        body = await response.json();
+        if (body?.error?.message) {
+            message = body.error.message;
+        }
+    }
+    catch {
+        // If not JSON, use the status text
+        body = await response.text().catch(() => "Unknown error");
+        message = `OpenAI error (${status}): ${body}`;
+    }
+    const provider = "openai";
+    if (status === 400) {
+        throw new BadRequestError(message, body, provider, model);
+    }
+    if (status === 401 || status === 403) {
+        throw new AuthenticationError(message, status, body, provider);
+    }
+    if (status === 429) {
+        throw new RateLimitError(message, body, provider, model);
+    }
+    if (status === 502 || status === 503) {
+        throw new ServiceUnavailableError(message, status, body, provider, model);
+    }
+    if (status >= 500) {
+        throw new ServerError(message, status, body, provider, model);
+    }
+    throw new APIError(message, status, body, provider, model);
+}

package/dist/providers/openai/Image.d.ts

@@ -0,0 +1,8 @@
+import { ImageRequest, ImageResponse } from "../Provider.js";
+export declare class OpenAIImage {
+    private readonly baseUrl;
+    private readonly apiKey;
+    constructor(baseUrl: string, apiKey: string);
+    execute(request: ImageRequest): Promise<ImageResponse>;
+}
+//# sourceMappingURL=Image.d.ts.map

package/dist/providers/openai/Image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Image.d.ts","sourceRoot":"","sources":["../../../src/providers/openai/Image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAG7D,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,OAAO;IAAU,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAxC,OAAO,EAAE,MAAM,EAAmB,MAAM,EAAE,MAAM;IAEvE,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;CAmC7D"}

package/dist/providers/openai/Image.js

@@ -0,0 +1,39 @@
+import { handleOpenAIError } from "./Errors.js";
+export class OpenAIImage {
+    baseUrl;
+    apiKey;
+    constructor(baseUrl, apiKey) {
+        this.baseUrl = baseUrl;
+        this.apiKey = apiKey;
+    }
+    async execute(request) {
+        const body = {
+            model: request.model || "dall-e-3",
+            prompt: request.prompt,
+            size: request.size || "1024x1024",
+            quality: request.quality || "standard",
+            n: request.n || 1,
+        };
+        const response = await fetch(`${this.baseUrl}/images/generations`, {
+            method: "POST",
+            headers: {
+                "Authorization": `Bearer ${this.apiKey}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            await handleOpenAIError(response, request.model);
+        }
+        const json = await response.json();
+        const data = json.data?.[0];
+        if (!data) {
+            throw new Error("OpenAI returned empty image response");
+        }
+        return {
+            url: data.url,
+            revised_prompt: data.revised_prompt,
+            mime_type: "image/png",
+        };
+    }
+}

package/dist/providers/openai/OpenAIProvider.d.ts

@@ -1,4 +1,4 @@
-import { Provider, ChatRequest, ChatResponse, ModelInfo, ChatChunk } from "../Provider.js";
+import { Provider, ChatRequest, ChatResponse, ModelInfo, ChatChunk, ImageRequest, ImageResponse } from "../Provider.js";
 export interface OpenAIProviderOptions {
     apiKey: string;
     baseUrl?: string;
@@ -9,6 +9,7 @@ export declare class OpenAIProvider implements Provider {
     private readonly chatHandler;
     private readonly streamingHandler;
     private readonly modelsHandler;
+    private readonly imageHandler;
     capabilities: {
         supportsVision: (model: string) => boolean;
         supportsTools: (model: string) => boolean;
@@ -19,5 +20,6 @@ export declare class OpenAIProvider implements Provider {
     chat(request: ChatRequest): Promise<ChatResponse>;
     stream(request: ChatRequest): AsyncGenerator<ChatChunk>;
     listModels(): Promise<ModelInfo[]>;
+    paint(request: ImageRequest): Promise<ImageResponse>;
 }
 //# sourceMappingURL=OpenAIProvider.d.ts.map

package/dist/providers/openai/OpenAIProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OpenAIProvider.d.ts","sourceRoot":"","sources":["../../../src/providers/openai/OpenAIProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAM3F,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,cAAe,YAAW,QAAQ;IAajC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAZpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkB;IACnD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAEtC,YAAY;gCACO,MAAM;+BACP,MAAM;0CACK,MAAM;kCACd,MAAM;MAChC;gBAE2B,OAAO,EAAE,qBAAqB;IAOrD,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAIhD,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,CAAC,SAAS,CAAC;IAIxD,UAAU,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;CAGzC"}
+{"version":3,"file":"OpenAIProvider.d.ts","sourceRoot":"","sources":["../../../src/providers/openai/OpenAIProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAOxH,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,cAAe,YAAW,QAAQ;IAcjC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAbpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkB;IACnD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;IAEpC,YAAY;gCACO,MAAM;+BACP,MAAM;0CACK,MAAM;kCACd,MAAM;MAChC;gBAE2B,OAAO,EAAE,qBAAqB;IAQrD,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAIhD,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,CAAC,SAAS,CAAC;IAIxD,UAAU,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAIlC,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;CAG3D"}

package/dist/providers/openai/OpenAIProvider.js

@@ -2,12 +2,14 @@ import { Capabilities } from "./Capabilities.js";
 import { OpenAIChat } from "./Chat.js";
 import { OpenAIStreaming } from "./Streaming.js";
 import { OpenAIModels } from "./Models.js";
+import { OpenAIImage } from "./Image.js";
 export class OpenAIProvider {
     options;
     baseUrl;
     chatHandler;
     streamingHandler;
     modelsHandler;
+    imageHandler;
     capabilities = {
         supportsVision: (model) => Capabilities.supportsVision(model),
         supportsTools: (model) => Capabilities.supportsTools(model),
@@ -20,6 +22,7 @@ export class OpenAIProvider {
         this.chatHandler = new OpenAIChat(this.baseUrl, options.apiKey);
         this.streamingHandler = new OpenAIStreaming(this.baseUrl, options.apiKey);
         this.modelsHandler = new OpenAIModels(this.baseUrl, options.apiKey);
+        this.imageHandler = new OpenAIImage(this.baseUrl, options.apiKey);
     }
     async chat(request) {
         return this.chatHandler.execute(request);
@@ -30,4 +33,7 @@ export class OpenAIProvider {
     async listModels() {
         return this.modelsHandler.execute();
     }
+    async paint(request) {
+        return this.imageHandler.execute(request);
+    }
 }

package/dist/providers/openai/Streaming.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Streaming.d.ts","sourceRoot":"","sources":["../../../src/providers/openai/Streaming.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGxD,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,OAAO;IAAU,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAxC,OAAO,EAAE,MAAM,EAAmB,MAAM,EAAE,MAAM;IAEtE,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,CAAC,SAAS,CAAC;CAsDhE"}
+{"version":3,"file":"Streaming.d.ts","sourceRoot":"","sources":["../../../src/providers/openai/Streaming.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAIxD,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,OAAO;IAAU,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAxC,OAAO,EAAE,MAAM,EAAmB,MAAM,EAAE,MAAM;IAEtE,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,CAAC,SAAS,CAAC;CA0DhE"}

package/dist/providers/openai/Streaming.js

@@ -1,4 +1,5 @@
 import { Capabilities } from "./Capabilities.js";
+import { handleOpenAIError } from "./Errors.js";
 export class OpenAIStreaming {
     baseUrl;
     apiKey;
@@ -27,6 +28,9 @@ export class OpenAIStreaming {
             },
             body: JSON.stringify(body),
         });
+        if (!response.ok) {
+            await handleOpenAIError(response, request.model);
+        }
         if (!response.body) {
             throw new Error("No response body for streaming");
         }

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

@@ -19,5 +19,13 @@ export interface OpenAIChatResponse {
         };
         finish_reason: string;
     }>;
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+        prompt_tokens_details?: {
+            cached_tokens?: number;
+        };
+    };
 }
 //# sourceMappingURL=types.d.ts.map