@dvina/agents 0.1.3 → 0.1.5

package/dist/index.cjs

@@ -20,10 +20,211 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  LangchainAgentFactory: () => LangchainAgentFactory,
   ToolRegistry: () => ToolRegistry
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/runtime/langchain/factory.ts
+var import_langgraph_checkpoint_postgres = require("@langchain/langgraph-checkpoint-postgres");
+var import_langchain2 = require("langchain");
+
+// src/runtime/langchain/agent.ts
+var import_deepagents = require("deepagents");
+var import_langchain = require("langchain");
+var LangchainAgent = class {
+  deepAgent;
+  toolCalls = [];
+  constructor(params) {
+    let middlewares = [
+      (0, import_langchain.createMiddleware)({
+        name: "toolCallsReporter",
+        wrapToolCall: async (request, handler) => {
+          const res = await handler(request);
+          this.toolCalls.push({
+            name: request.tool.name || "",
+            input: request.toolCall.args,
+            output: res.toJSON()
+          });
+          return res;
+        }
+      })
+    ];
+    if (params.middleware) middlewares = [...middlewares, ...params.middleware];
+    params.middleware = middlewares;
+    this.deepAgent = (0, import_deepagents.createDeepAgent)(params);
+  }
+  async run(input) {
+    this.toolCalls = [];
+    const result = await this.deepAgent.invoke({
+      messages: input.messages.map(
+        (m) => new import_langchain.HumanMessage({
+          content: m.content.map((c) => {
+            if (c.type === "image") {
+              return {
+                type: "image_url",
+                image_url: { url: c.url }
+              };
+            }
+            return c;
+          })
+        })
+      )
+    });
+    const lastMessage = result.messages[result.messages.length - 1];
+    const usage = lastMessage.usage_metadata || {
+      input_tokens: 0,
+      output_tokens: 0,
+      total_tokens: 0
+    };
+    return {
+      message: lastMessage.content.toString(),
+      toolCalls: this.toolCalls,
+      usage: {
+        promptTokens: usage.input_tokens || 0,
+        completionTokens: usage.output_tokens || 0,
+        totalTokens: usage.total_tokens || 0
+      }
+    };
+  }
+  getLangchainAgent() {
+    return this.deepAgent;
+  }
+};
+
+// src/runtime/langchain/model-resolver.ts
+var import_openai = require("@langchain/openai");
+var LangchainModelResolver = class {
+  constructor(config) {
+    this.config = config;
+  }
+  resolve(modelString) {
+    const parts = modelString.split(":");
+    if (parts.length === 2) {
+      const [provider, modelName] = parts;
+      return this.resolveByProvider(provider, "default", modelName);
+    }
+    if (parts.length === 3) {
+      const [provider, configName, modelName] = parts;
+      return this.resolveByProvider(provider, configName, modelName);
+    }
+    throw new Error(
+      'Model string must follow format "provider:modelName" (uses "default" config) or "provider:configName:modelName"'
+    );
+  }
+  resolveByProvider(provider, configName, modelName) {
+    switch (provider) {
+      case "openai":
+        return this.resolveOpenAI(configName, modelName);
+      case "azure":
+        return this.resolveAzure(configName, modelName);
+      default:
+        throw new Error(`Unsupported model provider: ${provider}`);
+    }
+  }
+  resolveOpenAI(configName, modelName) {
+    const providerConfig = this.config.openai?.[configName];
+    if (!providerConfig) {
+      throw new Error(`Configuration "${configName}" for provider "openai" is missing`);
+    }
+    return new import_openai.ChatOpenAI({
+      apiKey: providerConfig.apiKey,
+      modelName
+    });
+  }
+  resolveAzure(configName, deploymentName) {
+    const providerConfig = this.config.azure?.[configName];
+    if (!providerConfig) {
+      throw new Error(`Configuration "${configName}" for provider "azure" is missing`);
+    }
+    return new import_openai.AzureChatOpenAI({
+      azureOpenAIApiKey: providerConfig.apiKey,
+      azureOpenAIApiInstanceName: this.extractInstanceName(providerConfig.endpoint),
+      azureOpenAIApiDeploymentName: deploymentName,
+      azureOpenAIApiVersion: providerConfig.apiVersion
+    });
+  }
+  extractInstanceName(endpoint) {
+    try {
+      const url = new URL(endpoint);
+      return url.hostname.split(".")[0];
+    } catch (e) {
+      return endpoint;
+    }
+  }
+};
+
+// src/runtime/langchain/factory.ts
+var LangchainAgentFactory = class {
+  constructor(modelConfig, postgresSaverConnString, postgresSaverSchema) {
+    this.modelConfig = modelConfig;
+    this.postgresSaverConnString = postgresSaverConnString;
+    this.postgresSaverSchema = postgresSaverSchema;
+    this.modelResolver = new LangchainModelResolver(this.modelConfig);
+  }
+  modelResolver;
+  createAgent(options) {
+    let deepAgentOptions = {
+      model: this.modelResolver.resolve(options.model)
+    };
+    let middlewares = [];
+    if (options.history)
+      deepAgentOptions.checkpointer = import_langgraph_checkpoint_postgres.PostgresSaver.fromConnString(this.postgresSaverConnString, {
+        schema: this.postgresSaverSchema
+      });
+    if (options.instructions) deepAgentOptions.systemPrompt = options.instructions;
+    if (options.tools) {
+      deepAgentOptions.tools = options.tools.tools.map(
+        (t) => (0, import_langchain2.tool)(
+          async (input, options2) => {
+            return await t.exec(input);
+          },
+          {
+            name: t.name,
+            description: t.description,
+            schema: t.schema
+          }
+        )
+      );
+      middlewares.push(
+        (0, import_langchain2.llmToolSelectorMiddleware)({
+          model: this.modelResolver.resolve(options.tools.model),
+          maxTools: 128,
+          alwaysInclude: options.tools.alwaysIncludeTools ?? []
+        })
+      );
+    }
+    if (options.summarization)
+      middlewares.push(
+        (0, import_langchain2.summarizationMiddleware)({
+          model: this.modelResolver.resolve(options.summarization.model),
+          trigger: {
+            tokens: options.summarization.triggerAtTokens
+          },
+          keep: {
+            messages: options.summarization.keepMessages
+          }
+        })
+      );
+    if (options.handoffs) {
+      options.handoffs.every((h) => {
+        if (!(h.agent instanceof LangchainAgent)) {
+          throw new Error("Handoff agent must be an instance of LangchainAgent");
+        }
+      });
+      deepAgentOptions.subagents = options.handoffs.map((h) => {
+        return {
+          name: h.name,
+          description: h.description,
+          runnable: h.agent.getLangchainAgent()
+        };
+      });
+    }
+    if (middlewares.length > 0) deepAgentOptions.middleware = middlewares;
+    return new LangchainAgent(deepAgentOptions);
+  }
+};
+
 // src/core/tools/tool-registry.ts
 var ToolRegistry = class {
   entries = /* @__PURE__ */ new Map();
@@ -60,5 +261,6 @@ var ToolRegistry = class {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  LangchainAgentFactory,
   ToolRegistry
 });

package/dist/index.d.cts

@@ -67,6 +67,28 @@ interface AgentFactory {
     createAgent(options: CreateAgentOptions): Agent;
 }
 
+type LangchainOpenAIConfig = {
+    apiKey: string;
+};
+type LangchainAzureConfig = {
+    apiKey: string;
+    endpoint: string;
+    apiVersion: string;
+};
+type LangchainModelConfig = {
+    openai?: Record<string, LangchainOpenAIConfig>;
+    azure?: Record<string, LangchainAzureConfig>;
+};
+
+declare class LangchainAgentFactory implements AgentFactory {
+    private modelConfig;
+    private postgresSaverConnString;
+    private postgresSaverSchema;
+    private modelResolver;
+    constructor(modelConfig: LangchainModelConfig, postgresSaverConnString: string, postgresSaverSchema: string);
+    createAgent(options: CreateAgentOptions): Agent;
+}
+
 interface ToolProvider {
     getTools(): Promise<ToolDefinition[]> | ToolDefinition[];
 }
@@ -79,4 +101,4 @@ declare class ToolRegistry {
     invalidate(key: string): void;
 }
 
-export { type Agent, type AgentFactory, type AgentHandoff, type AgentResult, type AgentRunInput, type ContentBlock, type CreateAgentOptions, type HumanMessage, type Message, type ToolCall, type ToolDefinition, type ToolProvider, ToolRegistry, type UsageMeta };
+export { type Agent, type AgentFactory, type AgentHandoff, type AgentResult, type AgentRunInput, type ContentBlock, type CreateAgentOptions, type HumanMessage, LangchainAgentFactory, type Message, type ToolCall, type ToolDefinition, type ToolProvider, ToolRegistry, type UsageMeta };

package/dist/index.d.ts

@@ -67,6 +67,28 @@ interface AgentFactory {
     createAgent(options: CreateAgentOptions): Agent;
 }
 
+type LangchainOpenAIConfig = {
+    apiKey: string;
+};
+type LangchainAzureConfig = {
+    apiKey: string;
+    endpoint: string;
+    apiVersion: string;
+};
+type LangchainModelConfig = {
+    openai?: Record<string, LangchainOpenAIConfig>;
+    azure?: Record<string, LangchainAzureConfig>;
+};
+
+declare class LangchainAgentFactory implements AgentFactory {
+    private modelConfig;
+    private postgresSaverConnString;
+    private postgresSaverSchema;
+    private modelResolver;
+    constructor(modelConfig: LangchainModelConfig, postgresSaverConnString: string, postgresSaverSchema: string);
+    createAgent(options: CreateAgentOptions): Agent;
+}
+
 interface ToolProvider {
     getTools(): Promise<ToolDefinition[]> | ToolDefinition[];
 }
@@ -79,4 +101,4 @@ declare class ToolRegistry {
     invalidate(key: string): void;
 }
 
-export { type Agent, type AgentFactory, type AgentHandoff, type AgentResult, type AgentRunInput, type ContentBlock, type CreateAgentOptions, type HumanMessage, type Message, type ToolCall, type ToolDefinition, type ToolProvider, ToolRegistry, type UsageMeta };
+export { type Agent, type AgentFactory, type AgentHandoff, type AgentResult, type AgentRunInput, type ContentBlock, type CreateAgentOptions, type HumanMessage, LangchainAgentFactory, type Message, type ToolCall, type ToolDefinition, type ToolProvider, ToolRegistry, type UsageMeta };

package/dist/index.js

@@ -1,3 +1,203 @@
+// src/runtime/langchain/factory.ts
+import { PostgresSaver } from "@langchain/langgraph-checkpoint-postgres";
+import { llmToolSelectorMiddleware, summarizationMiddleware, tool } from "langchain";
+
+// src/runtime/langchain/agent.ts
+import { createDeepAgent } from "deepagents";
+import { createMiddleware, HumanMessage } from "langchain";
+var LangchainAgent = class {
+  deepAgent;
+  toolCalls = [];
+  constructor(params) {
+    let middlewares = [
+      createMiddleware({
+        name: "toolCallsReporter",
+        wrapToolCall: async (request, handler) => {
+          const res = await handler(request);
+          this.toolCalls.push({
+            name: request.tool.name || "",
+            input: request.toolCall.args,
+            output: res.toJSON()
+          });
+          return res;
+        }
+      })
+    ];
+    if (params.middleware) middlewares = [...middlewares, ...params.middleware];
+    params.middleware = middlewares;
+    this.deepAgent = createDeepAgent(params);
+  }
+  async run(input) {
+    this.toolCalls = [];
+    const result = await this.deepAgent.invoke({
+      messages: input.messages.map(
+        (m) => new HumanMessage({
+          content: m.content.map((c) => {
+            if (c.type === "image") {
+              return {
+                type: "image_url",
+                image_url: { url: c.url }
+              };
+            }
+            return c;
+          })
+        })
+      )
+    });
+    const lastMessage = result.messages[result.messages.length - 1];
+    const usage = lastMessage.usage_metadata || {
+      input_tokens: 0,
+      output_tokens: 0,
+      total_tokens: 0
+    };
+    return {
+      message: lastMessage.content.toString(),
+      toolCalls: this.toolCalls,
+      usage: {
+        promptTokens: usage.input_tokens || 0,
+        completionTokens: usage.output_tokens || 0,
+        totalTokens: usage.total_tokens || 0
+      }
+    };
+  }
+  getLangchainAgent() {
+    return this.deepAgent;
+  }
+};
+
+// src/runtime/langchain/model-resolver.ts
+import { AzureChatOpenAI, ChatOpenAI } from "@langchain/openai";
+var LangchainModelResolver = class {
+  constructor(config) {
+    this.config = config;
+  }
+  resolve(modelString) {
+    const parts = modelString.split(":");
+    if (parts.length === 2) {
+      const [provider, modelName] = parts;
+      return this.resolveByProvider(provider, "default", modelName);
+    }
+    if (parts.length === 3) {
+      const [provider, configName, modelName] = parts;
+      return this.resolveByProvider(provider, configName, modelName);
+    }
+    throw new Error(
+      'Model string must follow format "provider:modelName" (uses "default" config) or "provider:configName:modelName"'
+    );
+  }
+  resolveByProvider(provider, configName, modelName) {
+    switch (provider) {
+      case "openai":
+        return this.resolveOpenAI(configName, modelName);
+      case "azure":
+        return this.resolveAzure(configName, modelName);
+      default:
+        throw new Error(`Unsupported model provider: ${provider}`);
+    }
+  }
+  resolveOpenAI(configName, modelName) {
+    const providerConfig = this.config.openai?.[configName];
+    if (!providerConfig) {
+      throw new Error(`Configuration "${configName}" for provider "openai" is missing`);
+    }
+    return new ChatOpenAI({
+      apiKey: providerConfig.apiKey,
+      modelName
+    });
+  }
+  resolveAzure(configName, deploymentName) {
+    const providerConfig = this.config.azure?.[configName];
+    if (!providerConfig) {
+      throw new Error(`Configuration "${configName}" for provider "azure" is missing`);
+    }
+    return new AzureChatOpenAI({
+      azureOpenAIApiKey: providerConfig.apiKey,
+      azureOpenAIApiInstanceName: this.extractInstanceName(providerConfig.endpoint),
+      azureOpenAIApiDeploymentName: deploymentName,
+      azureOpenAIApiVersion: providerConfig.apiVersion
+    });
+  }
+  extractInstanceName(endpoint) {
+    try {
+      const url = new URL(endpoint);
+      return url.hostname.split(".")[0];
+    } catch (e) {
+      return endpoint;
+    }
+  }
+};
+
+// src/runtime/langchain/factory.ts
+var LangchainAgentFactory = class {
+  constructor(modelConfig, postgresSaverConnString, postgresSaverSchema) {
+    this.modelConfig = modelConfig;
+    this.postgresSaverConnString = postgresSaverConnString;
+    this.postgresSaverSchema = postgresSaverSchema;
+    this.modelResolver = new LangchainModelResolver(this.modelConfig);
+  }
+  modelResolver;
+  createAgent(options) {
+    let deepAgentOptions = {
+      model: this.modelResolver.resolve(options.model)
+    };
+    let middlewares = [];
+    if (options.history)
+      deepAgentOptions.checkpointer = PostgresSaver.fromConnString(this.postgresSaverConnString, {
+        schema: this.postgresSaverSchema
+      });
+    if (options.instructions) deepAgentOptions.systemPrompt = options.instructions;
+    if (options.tools) {
+      deepAgentOptions.tools = options.tools.tools.map(
+        (t) => tool(
+          async (input, options2) => {
+            return await t.exec(input);
+          },
+          {
+            name: t.name,
+            description: t.description,
+            schema: t.schema
+          }
+        )
+      );
+      middlewares.push(
+        llmToolSelectorMiddleware({
+          model: this.modelResolver.resolve(options.tools.model),
+          maxTools: 128,
+          alwaysInclude: options.tools.alwaysIncludeTools ?? []
+        })
+      );
+    }
+    if (options.summarization)
+      middlewares.push(
+        summarizationMiddleware({
+          model: this.modelResolver.resolve(options.summarization.model),
+          trigger: {
+            tokens: options.summarization.triggerAtTokens
+          },
+          keep: {
+            messages: options.summarization.keepMessages
+          }
+        })
+      );
+    if (options.handoffs) {
+      options.handoffs.every((h) => {
+        if (!(h.agent instanceof LangchainAgent)) {
+          throw new Error("Handoff agent must be an instance of LangchainAgent");
+        }
+      });
+      deepAgentOptions.subagents = options.handoffs.map((h) => {
+        return {
+          name: h.name,
+          description: h.description,
+          runnable: h.agent.getLangchainAgent()
+        };
+      });
+    }
+    if (middlewares.length > 0) deepAgentOptions.middleware = middlewares;
+    return new LangchainAgent(deepAgentOptions);
+  }
+};
+
 // src/core/tools/tool-registry.ts
 var ToolRegistry = class {
   entries = /* @__PURE__ */ new Map();
@@ -33,5 +233,6 @@ var ToolRegistry = class {
   }
 };
 export {
+  LangchainAgentFactory,
   ToolRegistry
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@dvina/agents",
-	"version": "0.1.3",
+	"version": "0.1.5",
 	"description": "Standalone, provider-agnostic AI agent library",
 	"main": "./dist/index.js",
 	"module": "./dist/index.mjs",
@@ -29,7 +29,7 @@
 		"node": ">=24"
 	},
 	"dependencies": {
-		"@langchain/core": "1.1.4",
+		"@langchain/core": "1.1.8",
 		"@langchain/langgraph": "1.0.2",
 		"@langchain/langgraph-checkpoint-postgres": "^1.0.0",
 		"@langchain/openai": "^1.2.0",

package/dist/chunk-2ESYSVXG.js

@@ -1,48 +0,0 @@
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-var __esm = (fn, res) => function __init() {
-  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
-};
-var __commonJS = (cb, mod) => function __require2() {
-  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
-};
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-export {
-  __require,
-  __esm,
-  __commonJS,
-  __export,
-  __toESM,
-  __toCommonJS
-};