@agentdock-ai/models 0.1.0

package/README.md

@@ -0,0 +1,25 @@
+# @agentdock-ai/models
+
+Optional provider configuration resolver for [AgentDock](https://www.npmjs.com/package/@agentdock-ai/agentdock). It creates a standard LangChain `BaseChatModel`, so AgentDock stays provider-neutral.
+
+## Install
+
+```bash
+yarn add @agentdock-ai/agentdock @agentdock-ai/models
+```
+
+## Usage
+
+```ts
+import { AgentDock } from "@agentdock-ai/agentdock";
+import { AgentDockModel } from "@agentdock-ai/models";
+
+const model = AgentDockModel.openAI({
+  model: "gpt-5.4-mini",
+  apiKey: process.env.OPENAI_API_KEY,
+});
+
+const dock = new AgentDock({ model });
+```
+
+Supported providers are `openai`, `ollama`, and `openrouter`. An omitted API key leaves the provider's normal environment-variable configuration in effect.

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+import type { BaseChatModel } from "@langchain/core/language_models/chat_models";
+interface AgentDockModelSettings {
+    readonly model: string;
+    readonly temperature?: number;
+}
+export interface OpenAIModelConfig extends AgentDockModelSettings {
+    readonly apiKey?: string;
+    readonly baseUrl?: string;
+}
+export interface OllamaModelConfig extends AgentDockModelSettings {
+    readonly baseUrl?: string;
+}
+export interface OpenRouterModelConfig extends AgentDockModelSettings {
+    readonly apiKey?: string;
+    readonly baseUrl?: string;
+}
+/**
+ * Creates LangChain chat models for the providers supported by AgentDock.
+ * Provider environment variables remain available when an API key is omitted.
+ */
+export declare class AgentDockModel {
+    private constructor();
+    static openRouter(config: OpenRouterModelConfig): BaseChatModel;
+    static openAI(config: OpenAIModelConfig): BaseChatModel;
+    static ollama(config: OllamaModelConfig): BaseChatModel;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAKjF,UAAU,sBAAsB;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAkB,SAAQ,sBAAsB;IAC/D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAkB,SAAQ,sBAAsB;IAC/D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAsB,SAAQ,sBAAsB;IACnE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,eAAiB;IAExB,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,qBAAqB,GAAG,aAAa,CAW9D;IAED,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,aAAa,CAWtD;IAED,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,aAAa,CAStD;CACF"}

package/dist/index.js

@@ -0,0 +1,87 @@
+import { ChatOllama } from "@langchain/ollama";
+import { ChatOpenAI } from "@langchain/openai";
+import { ChatOpenRouter } from "@langchain/openrouter";
+/**
+ * Creates LangChain chat models for the providers supported by AgentDock.
+ * Provider environment variables remain available when an API key is omitted.
+ */
+export class AgentDockModel {
+    constructor() { }
+    static openRouter(config) {
+        validateModelConfig(config);
+        assertOptionalNonEmptyString(config.apiKey, "apiKey");
+        assertOptionalUrl(config.baseUrl, "baseUrl");
+        return new ChatOpenRouter({
+            model: config.model,
+            temperature: config.temperature,
+            apiKey: config.apiKey,
+            baseURL: config.baseUrl,
+        });
+    }
+    static openAI(config) {
+        validateModelConfig(config);
+        assertOptionalNonEmptyString(config.apiKey, "apiKey");
+        assertOptionalUrl(config.baseUrl, "baseUrl");
+        return new ChatOpenAI({
+            model: config.model,
+            temperature: config.temperature,
+            apiKey: config.apiKey,
+            configuration: config.baseUrl ? { baseURL: config.baseUrl } : undefined,
+        });
+    }
+    static ollama(config) {
+        validateModelConfig(config);
+        assertOptionalUrl(config.baseUrl, "baseUrl");
+        return new ChatOllama({
+            model: config.model,
+            temperature: config.temperature,
+            baseUrl: config.baseUrl,
+        });
+    }
+}
+function validateModelConfig(config) {
+    if (!isRecord(config)) {
+        throw new Error("AgentDock model configuration must be an object.");
+    }
+    assertNonEmptyString(config.model, "model");
+    assertOptionalTemperature(config.temperature);
+}
+function assertNonEmptyString(value, name) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new Error(`AgentDock model ${name} must be a non-empty string.`);
+    }
+}
+function assertOptionalNonEmptyString(value, name) {
+    if (value !== undefined) {
+        assertNonEmptyString(value, name);
+    }
+}
+function assertOptionalTemperature(value) {
+    if (value === undefined)
+        return;
+    if (typeof value !== "number" ||
+        !Number.isFinite(value) ||
+        value < 0 ||
+        value > 2) {
+        throw new Error("AgentDock model temperature must be a number from 0 to 2.");
+    }
+}
+function assertOptionalUrl(value, name) {
+    if (value === undefined)
+        return;
+    assertNonEmptyString(value, name);
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        throw new Error(`AgentDock model ${name} must be a valid HTTP(S) URL.`);
+    }
+    if (url.protocol !== "http:" && url.protocol !== "https:") {
+        throw new Error(`AgentDock model ${name} must be a valid HTTP(S) URL.`);
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@agentdock-ai/models",
+  "version": "0.1.0",
+  "description": "Optional LangChain model resolver for AgentDock",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agentdock-ai/agentdock.git",
+    "directory": "packages/models"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run test",
+    "prepack": "yarn build"
+  },
+  "dependencies": {
+    "@langchain/core": "^1.2.9",
+    "@langchain/ollama": "^1.3.0",
+    "@langchain/openai": "^1.5.10",
+    "@langchain/openrouter": "^0.4.10"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.2",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.11"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "license": "MIT"
+}