@node-llm/core 0.1.0

package/dist/providers/openai/index.js

@@ -0,0 +1,11 @@
+import { providerRegistry } from "../registry.js";
+import { OpenAIProvider } from "./OpenAIProvider.js";
+export function registerOpenAIProvider() {
+    providerRegistry.register("openai", () => {
+        const apiKey = process.env.OPENAI_API_KEY;
+        if (!apiKey) {
+            throw new Error("OPENAI_API_KEY is not set");
+        }
+        return new OpenAIProvider({ apiKey });
+    });
+}

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

@@ -0,0 +1,2 @@
+export declare function ensureOpenAIRegistered(): void;
+//# sourceMappingURL=register.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../src/providers/openai/register.ts"],"names":[],"mappings":"AAKA,wBAAgB,sBAAsB,SAcrC"}

package/dist/providers/openai/register.js

@@ -0,0 +1,15 @@
+import { providerRegistry } from "../registry.js";
+import { OpenAIProvider } from "./OpenAIProvider.js";
+let registered = false;
+export function ensureOpenAIRegistered() {
+    if (registered)
+        return;
+    providerRegistry.register("openai", () => {
+        const apiKey = process.env.OPENAI_API_KEY;
+        if (!apiKey) {
+            throw new Error("OPENAI_API_KEY is not set");
+        }
+        return new OpenAIProvider({ apiKey });
+    });
+    registered = true;
+}

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

@@ -0,0 +1,23 @@
+import { Message } from "../../chat/Message.js";
+export interface OpenAIChatRequest {
+    model: string;
+    messages: Message[];
+}
+export interface OpenAIChatResponse {
+    choices: Array<{
+        message: {
+            role: string;
+            content: string | null;
+            tool_calls?: Array<{
+                id: string;
+                type: 'function';
+                function: {
+                    name: string;
+                    arguments: string;
+                };
+            }>;
+        };
+        finish_reason: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/providers/openai/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,KAAK,CAAC;QACb,OAAO,EAAE;YACP,IAAI,EAAE,MAAM,CAAC;YACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;YACvB,UAAU,CAAC,EAAE,KAAK,CAAC;gBACjB,EAAE,EAAE,MAAM,CAAC;gBACX,IAAI,EAAE,UAAU,CAAC;gBACjB,QAAQ,EAAE;oBACR,IAAI,EAAE,MAAM,CAAC;oBACb,SAAS,EAAE,MAAM,CAAC;iBACnB,CAAC;aACH,CAAC,CAAC;SACJ,CAAC;QACF,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC,CAAC;CACJ"}

package/dist/providers/openai/types.js

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

package/dist/providers/registry.d.ts

@@ -0,0 +1,20 @@
+import { Provider } from "./Provider.js";
+type ProviderFactory = () => Provider;
+declare class ProviderRegistry {
+    private providers;
+    /**
+     * Register a provider factory
+     */
+    register(name: string, factory: ProviderFactory): void;
+    /**
+     * Resolve a provider by name
+     */
+    resolve(name: string): Provider;
+    /**
+     * Introspection / debugging
+     */
+    list(): string[];
+}
+export declare const providerRegistry: ProviderRegistry;
+export {};
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,KAAK,eAAe,GAAG,MAAM,QAAQ,CAAC;AAEtC,cAAM,gBAAgB;IACpB,OAAO,CAAC,SAAS,CAAsC;IAEvD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IAQtD;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAU/B;;OAEG;IACH,IAAI,IAAI,MAAM,EAAE;CAGjB;AAED,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}

package/dist/providers/registry.js

@@ -0,0 +1,29 @@
+class ProviderRegistry {
+    providers = new Map();
+    /**
+     * Register a provider factory
+     */
+    register(name, factory) {
+        if (this.providers.has(name)) {
+            throw new Error(`Provider '${name}' is already registered`);
+        }
+        this.providers.set(name, factory);
+    }
+    /**
+     * Resolve a provider by name
+     */
+    resolve(name) {
+        const factory = this.providers.get(name);
+        if (!factory) {
+            throw new Error(`Unknown LLM provider '${name}'`);
+        }
+        return factory();
+    }
+    /**
+     * Introspection / debugging
+     */
+    list() {
+        return [...this.providers.keys()];
+    }
+}
+export const providerRegistry = new ProviderRegistry();

package/dist/tools/Tool.d.ts

@@ -0,0 +1,8 @@
+export type ToolHandler = (args: any) => any | Promise<any>;
+export interface Tool {
+    name: string;
+    description?: string;
+    parameters?: Record<string, any>;
+    handler: ToolHandler;
+}
+//# sourceMappingURL=Tool.d.ts.map

package/dist/tools/Tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tool.d.ts","sourceRoot":"","sources":["../../src/tools/Tool.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,GAAG,KAAK,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;AAE5D,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,OAAO,EAAE,WAAW,CAAC;CACtB"}

package/dist/tools/Tool.js

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

package/dist/tools/ToolSet.d.ts

@@ -0,0 +1,15 @@
+import { Tool, ToolHandler } from "./Tool.js";
+type ToolDefinition = ToolHandler | {
+    description?: string;
+    parameters?: Record<string, any>;
+    handler: ToolHandler;
+};
+export declare class ToolSet {
+    private tools;
+    constructor(defs?: Record<string, ToolDefinition>);
+    register(tool: Tool): void;
+    get(name: string): Tool | undefined;
+    list(): Tool[];
+}
+export {};
+//# sourceMappingURL=ToolSet.d.ts.map

package/dist/tools/ToolSet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolSet.d.ts","sourceRoot":"","sources":["../../src/tools/ToolSet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE9C,KAAK,cAAc,GACf,WAAW,GACX;IACE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,OAAO,EAAE,WAAW,CAAC;CACtB,CAAC;AAEN,qBAAa,OAAO;IAClB,OAAO,CAAC,KAAK,CAA2B;gBAE5B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC;IAiBjD,QAAQ,CAAC,IAAI,EAAE,IAAI;IAInB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAInC,IAAI,IAAI,IAAI,EAAE;CAGf"}

package/dist/tools/ToolSet.js

@@ -0,0 +1,29 @@
+export class ToolSet {
+    tools = new Map();
+    constructor(defs) {
+        if (defs) {
+            for (const [name, def] of Object.entries(defs)) {
+                if (typeof def === "function") {
+                    this.register({ name, handler: def });
+                }
+                else {
+                    this.register({
+                        name,
+                        handler: def.handler,
+                        description: def.description,
+                        parameters: def.parameters,
+                    });
+                }
+            }
+        }
+    }
+    register(tool) {
+        this.tools.set(tool.name, tool);
+    }
+    get(name) {
+        return this.tools.get(name);
+    }
+    list() {
+        return [...this.tools.values()];
+    }
+}

package/dist/tools/index.d.ts

@@ -0,0 +1,2 @@
+export { runCommand } from './runCommandTool.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/tools/index.js

@@ -0,0 +1 @@
+export { runCommand } from './runCommandTool.js';

package/dist/tools/runCommandTool.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Executes a shell command and returns its stdout as a string.
+ *
+ * @param command - The command to execute.
+ * @returns A promise that resolves with the command's standard output.
+ */
+export declare function runCommand(command: string): Promise<string>;
+//# sourceMappingURL=runCommandTool.d.ts.map

package/dist/tools/runCommandTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runCommandTool.d.ts","sourceRoot":"","sources":["../../src/tools/runCommandTool.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAW3D"}

package/dist/tools/runCommandTool.js

@@ -0,0 +1,19 @@
+import { exec } from 'child_process';
+/**
+ * Executes a shell command and returns its stdout as a string.
+ *
+ * @param command - The command to execute.
+ * @returns A promise that resolves with the command's standard output.
+ */
+export function runCommand(command) {
+    return new Promise((resolve, reject) => {
+        exec(command, { maxBuffer: 1024 * 1024 }, (error, stdout, stderr) => {
+            if (error) {
+                reject(error);
+                return;
+            }
+            // Trim trailing newlines for cleaner output
+            resolve(stdout.trim());
+        });
+    });
+}

package/dist/utils/FileLoader.d.ts

@@ -0,0 +1,5 @@
+import { ContentPart } from "../chat/Content.js";
+export declare class FileLoader {
+    static load(filePath: string): Promise<ContentPart>;
+}
+//# sourceMappingURL=FileLoader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FileLoader.d.ts","sourceRoot":"","sources":["../../src/utils/FileLoader.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA+BjD,qBAAa,UAAU;WACR,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CA+C1D"}

package/dist/utils/FileLoader.js

@@ -0,0 +1,71 @@
+import { promises as fs } from "fs";
+import * as path from "path";
+const MIME_TYPES = {
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".png": "image/png",
+    ".gif": "image/gif",
+    ".webp": "image/webp",
+    ".mp4": "video/mp4",
+    ".mpeg": "video/mpeg",
+    ".mov": "video/quicktime",
+    ".wav": "audio/wav",
+    ".mp3": "audio/mpeg",
+    ".json": "application/json",
+    ".js": "text/javascript",
+    ".ts": "text/typescript",
+    ".rb": "text/x-ruby",
+    ".py": "text/x-python",
+    ".txt": "text/plain",
+    ".md": "text/markdown",
+    ".html": "text/html",
+    ".css": "text/css",
+    ".xml": "text/xml",
+    ".yml": "text/yaml",
+    ".yaml": "text/yaml",
+};
+const TEXT_EXTENSIONS = new Set([
+    ".json", ".js", ".ts", ".rb", ".py", ".txt", ".md", ".html", ".css", ".xml", ".yml", ".yaml", ".env"
+]);
+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
+            return { type: "image_url", image_url: { url: filePath } };
+        }
+        const ext = path.extname(filePath).toLowerCase();
+        const mime = MIME_TYPES[ext] ?? "application/octet-stream";
+        if (TEXT_EXTENSIONS.has(ext)) {
+            const content = await fs.readFile(filePath, "utf-8");
+            return {
+                type: "text",
+                text: `\n\n--- File: ${path.basename(filePath)} ---\n${content}\n--- End of File ---\n`
+            };
+        }
+        // Binary files (Images, Video, Audio)
+        const data = await fs.readFile(filePath);
+        const base64 = data.toString("base64");
+        const dataUri = `data:${mime};base64,${base64}`;
+        if (mime.startsWith("image/")) {
+            return { type: "image_url", image_url: { url: dataUri } };
+        }
+        if (mime.startsWith("audio/")) {
+            // OpenAI expects 'wav' or 'mp3' as format, not full mime
+            const format = mime.split("/")[1];
+            return {
+                type: "input_audio",
+                input_audio: {
+                    data: base64,
+                    format: (format === "mpeg" ? "mp3" : format) ?? "wav"
+                }
+            };
+        }
+        if (mime.startsWith("video/")) {
+            // For now, treat video as a URL (some providers might support data URIs for video)
+            return { type: "video_url", video_url: { url: dataUri } };
+        }
+        // Fallback for unknown binary types
+        return { type: "image_url", image_url: { url: dataUri } };
+    }
+}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@node-llm/core",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "description": "A provider-agnostic LLM core for Node.js, inspired by ruby-llm.",
+  "author": "node-llm contributors",
+  "license": "MIT",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -w",
+    "test": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "zod": "^3.23.8"
+  }
+}