@node-llm/core 0.8.0 → 1.1.0

package/dist/utils/FileLoader.js

@@ -41,9 +41,40 @@ const TEXT_EXTENSIONS = new Set([
 ]);
 export class FileLoader {
     static async load(filePath) {
-        if (filePath.startsWith("http") || filePath.startsWith("data:")) {
-            // Assume image URL for now if it looks like a URL
-            // TODO: Better detection for remote file types
+        if (filePath.startsWith("http")) {
+            try {
+                const response = await fetch(filePath);
+                if (!response.ok)
+                    throw new Error(`Failed to fetch file: ${response.statusText}`);
+                const buffer = await response.arrayBuffer();
+                const contentType = response.headers.get("content-type") || "image/jpeg";
+                const base64 = Buffer.from(buffer).toString("base64");
+                const dataUri = `data:${contentType};base64,${base64}`;
+                if (contentType.startsWith("image/")) {
+                    return { type: "image_url", image_url: { url: dataUri } };
+                }
+                if (contentType.startsWith("audio/")) {
+                    const format = contentType.split("/")[1];
+                    return {
+                        type: "input_audio",
+                        input_audio: {
+                            data: base64,
+                            format: (format === "mpeg" ? "mp3" : format) ?? "wav"
+                        }
+                    };
+                }
+                if (contentType.startsWith("video/")) {
+                    return { type: "video_url", video_url: { url: dataUri } };
+                }
+                // Default to image_url for unknown binary or use as-is
+                return { type: "image_url", image_url: { url: dataUri } };
+            }
+            catch (error) {
+                // Fallback to URL if fetch fails
+                return { type: "image_url", image_url: { url: filePath } };
+            }
+        }
+        if (filePath.startsWith("data:")) {
             return { type: "image_url", image_url: { url: filePath } };
         }
         const ext = path.extname(filePath).toLowerCase();

package/dist/utils/logger.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Centralized logger for node-llm
+ */
+declare class Logger {
+    private isDebugEnabled;
+    debug(message: string, data?: any): void;
+    warn(message: string): void;
+    error(message: string, error?: Error): void;
+    info(message: string): void;
+}
+export declare const logger: Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAM,MAAM;IACV,OAAO,CAAC,cAAc;IAItB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAOxC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI;IAI3C,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAG5B;AAED,eAAO,MAAM,MAAM,QAAe,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,24 @@
+/**
+ * Centralized logger for node-llm
+ */
+class Logger {
+    isDebugEnabled() {
+        return process.env.NODELLM_DEBUG === "true";
+    }
+    debug(message, data) {
+        if (this.isDebugEnabled()) {
+            const formattedData = data ? `\n${JSON.stringify(data, null, 2)}` : '';
+            console.log(`[NodeLLM Debug] ${message}${formattedData}`);
+        }
+    }
+    warn(message) {
+        console.warn(`[NodeLLM] ${message}`);
+    }
+    error(message, error) {
+        console.error(`[NodeLLM Error] ${message}`, error || '');
+    }
+    info(message) {
+        console.log(`[NodeLLM] ${message}`);
+    }
+}
+export const logger = new Logger();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@node-llm/core",
-  "version": "0.8.0",
+  "version": "1.1.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -10,7 +10,7 @@
       "default": "./dist/index.js"
     }
   },
-  "description": "A provider-agnostic LLM core for Node.js, inspired by ruby-llm.",
+  "description": "A provider-agnostic NodeLLM core for Node.js, inspired by ruby-llm.",
   "author": "node-llm contributors",
   "license": "MIT",
   "engines": {

package/dist/chat/Stream.d.ts

@@ -1,21 +0,0 @@
-import { Message } from "./Message.js";
-import { ChatOptions } from "./ChatOptions.js";
-import { Provider } from "../providers/Provider.js";
-export declare class Stream {
-    private readonly provider;
-    private readonly model;
-    private readonly options;
-    private messages;
-    constructor(provider: Provider, model: string, options?: ChatOptions, messages?: Message[]);
-    /**
-     * Read-only access to message history
-     */
-    get history(): readonly Message[];
-    /**
-     * Streams the model's response to a user question.
-     * @param content The user's question to send to the model.
-     * @returns An async generator yielding chunks of the assistant's response as strings.
-     */
-    stream(content: string): AsyncGenerator<import("../providers/Provider.js").ChatChunk, void, unknown>;
-}
-//# sourceMappingURL=Stream.d.ts.map

package/dist/chat/Stream.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Stream.d.ts","sourceRoot":"","sources":["../../src/chat/Stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGpD,qBAAa,MAAM;IAIf,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,OAAO,CAAC,QAAQ,CAAY;gBAGT,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,WAAgB,EAC1C,QAAQ,CAAC,EAAE,OAAO,EAAE;IAmBtB;;OAEG;IACH,IAAI,OAAO,IAAI,SAAS,OAAO,EAAE,CAEhC;IAED;;;;OAIG;IACI,MAAM,CAAC,OAAO,EAAE,MAAM;CA+C9B"}

package/dist/chat/Stream.js

@@ -1,73 +0,0 @@
-import { ChatResponseString } from "./ChatResponse.js";
-export class Stream {
-    provider;
-    model;
-    options;
-    messages;
-    constructor(provider, model, options = {}, messages) {
-        this.provider = provider;
-        this.model = model;
-        this.options = options;
-        this.messages = messages ?? [];
-        // Only initialize if we're starting a new history
-        if (this.messages.length === 0) {
-            if (options.systemPrompt) {
-                this.messages.push({
-                    role: "system",
-                    content: options.systemPrompt,
-                });
-            }
-            if (options.messages) {
-                this.messages.push(...options.messages);
-            }
-        }
-    }
-    /**
-     * Read-only access to message history
-     */
-    get history() {
-        return this.messages;
-    }
-    /**
-     * Streams the model's response to a user question.
-     * @param content The user's question to send to the model.
-     * @returns An async generator yielding chunks of the assistant's response as strings.
-     */
-    async *stream(content) {
-        this.messages.push({ role: "user", content });
-        if (!this.provider.stream) {
-            throw new Error("Streaming not supported by provider");
-        }
-        let full = "";
-        let fullReasoning = "";
-        let isFirst = true;
-        for await (const chunk of this.provider.stream({
-            model: this.model,
-            messages: this.messages,
-            temperature: this.options.temperature,
-            max_tokens: this.options.maxTokens,
-        })) {
-            if (isFirst) {
-                if (this.options.onNewMessage)
-                    this.options.onNewMessage();
-                isFirst = false;
-            }
-            if (chunk.content) {
-                full += chunk.content;
-            }
-            if (chunk.reasoning) {
-                fullReasoning += chunk.reasoning;
-            }
-            yield chunk;
-        }
-        this.messages.push({
-            role: "assistant",
-            content: full,
-            // @ts-ignore
-            reasoning: fullReasoning || undefined
-        });
-        if (this.options.onEndMessage) {
-            this.options.onEndMessage(new ChatResponseString(full, { input_tokens: 0, output_tokens: 0, total_tokens: 0 }, this.model, fullReasoning || undefined));
-        }
-    }
-}

package/dist/providers/Embedding.d.ts

@@ -1,20 +0,0 @@
-export interface EmbeddingRequest {
-    input: string | string[];
-    model?: string;
-    dimensions?: number;
-    user?: string;
-}
-export interface EmbeddingVector {
-    embedding: number[];
-    index: number;
-}
-export interface EmbeddingResponse {
-    vectors: number[][];
-    model: string;
-    input_tokens: number;
-    dimensions: number;
-}
-export interface EmbeddingProvider {
-    embed(request: EmbeddingRequest): Promise<EmbeddingResponse>;
-}
-//# sourceMappingURL=Embedding.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Embedding.d.ts","sourceRoot":"","sources":["../../src/providers/Embedding.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC9D"}

package/dist/providers/Embedding.js

@@ -1 +0,0 @@
-export {};