network-ai 5.10.2 → 5.11.0

package/dist/esm/adapters/hermes-adapter.js

@@ -0,0 +1,217 @@
+"use strict";
+/**
+ * Hermes Adapter (NousResearch Hermes)
+ *
+ * Integrates NousResearch Hermes models (Hermes-3, Hermes-2, etc.) with the
+ * SwarmOrchestrator. Hermes runs via Ollama, llama.cpp, Together AI, Fireworks,
+ * or any OpenAI-compatible endpoint — BYOC, no hard dependency.
+ *
+ * Usage — Ollama (local):
+ *   const adapter = new HermesAdapter();
+ *   adapter.registerAgent('assistant', {
+ *     model: 'hermes3',
+ *     baseUrl: 'http://localhost:11434/v1',
+ *     systemPrompt: 'You are a helpful assistant.',
+ *   });
+ *
+ * Usage — Together AI / Fireworks (hosted):
+ *   adapter.registerAgent('reasoner', {
+ *     model: 'NousResearch/Hermes-3-Llama-3.1-70B',
+ *     baseUrl: 'https://api.together.xyz/v1',
+ *     apiKey: process.env.TOGETHER_API_KEY,
+ *   });
+ *
+ * Usage — bring-your-own OpenAI-compatible client:
+ *   adapter.registerAgent('coder', {
+ *     model: 'hermes3:8b',
+ *     client: openaiInstance.chat.completions,
+ *   });
+ *
+ * @module HermesAdapter
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HermesAdapter = void 0;
+const base_adapter_1 = require("./base-adapter");
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Build the user prompt string from an AgentPayload */
+function buildPrompt(payload) {
+    const parts = [];
+    const instruction = payload.handoff?.instruction;
+    if (instruction)
+        parts.push(instruction);
+    if (payload.action)
+        parts.push(`Task: ${payload.action}`);
+    if (payload.params && Object.keys(payload.params).length > 0) {
+        parts.push(`Parameters: ${JSON.stringify(payload.params, null, 2)}`);
+    }
+    if (payload.blackboardSnapshot && Object.keys(payload.blackboardSnapshot).length > 0) {
+        const relevant = Object.entries(payload.blackboardSnapshot)
+            .slice(0, 10)
+            .map(([k, v]) => `${k}: ${JSON.stringify(v)}`)
+            .join('\n');
+        parts.push(`Context:\n${relevant}`);
+    }
+    return parts.join('\n\n') || 'Complete the task.';
+}
+/** Resolve API key from config then environment */
+function resolveApiKey(config) {
+    return config.apiKey ?? process.env['HERMES_API_KEY'] ?? '';
+}
+/**
+ * Built-in fetch-based OpenAI-compatible completion.
+ * Used when no `client` is supplied.
+ */
+async function fetchCompletion(config, messages) {
+    const baseUrl = (config.baseUrl ?? 'http://localhost:11434/v1').replace(/\/$/, '');
+    const url = `${baseUrl}/chat/completions`;
+    const apiKey = resolveApiKey(config);
+    const headers = {
+        'Content-Type': 'application/json',
+        ...(apiKey ? { Authorization: `Bearer ${apiKey}` } : {}),
+        ...(config.headers ?? {}),
+    };
+    const body = JSON.stringify({
+        model: config.model ?? 'hermes3',
+        messages,
+        ...(config.maxTokens !== undefined ? { max_tokens: config.maxTokens } : {}),
+        ...(config.temperature !== undefined ? { temperature: config.temperature } : {}),
+        ...(config.stop?.length ? { stop: config.stop } : {}),
+    });
+    const controller = new AbortController();
+    const timeoutMs = config.timeout ?? 120_000;
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const res = await fetch(url, { method: 'POST', headers, body, signal: controller.signal });
+        if (!res.ok) {
+            const text = await res.text().catch(() => '');
+            throw new Error(`Hermes API error ${res.status}: ${text}`);
+        }
+        const json = await res.json();
+        const content = json.choices?.[0]?.message?.content ?? '';
+        const usage = json.usage
+            ? {
+                prompt_tokens: json.usage.prompt_tokens ?? 0,
+                completion_tokens: json.usage.completion_tokens ?? 0,
+                total_tokens: json.usage.total_tokens ?? 0,
+            }
+            : undefined;
+        return { content, ...(usage ? { usage } : {}) };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+// ---------------------------------------------------------------------------
+// Adapter
+// ---------------------------------------------------------------------------
+class HermesAdapter extends base_adapter_1.BaseAdapter {
+    name = 'hermes';
+    version = '1.0.0';
+    agents = new Map();
+    get capabilities() {
+        return {
+            streaming: false,
+            parallel: true,
+            bidirectional: false,
+            discovery: true,
+            authentication: false,
+            statefulSessions: false,
+        };
+    }
+    /**
+     * Register a Hermes agent with the given configuration.
+     *
+     * @param agentId - Unique identifier used to route tasks to this agent
+     * @param config  - Model, endpoint, system prompt, and optional BYOC client
+     */
+    registerAgent(agentId, config) {
+        if (!agentId || typeof agentId !== 'string') {
+            throw new Error('HermesAdapter.registerAgent: agentId must be a non-empty string');
+        }
+        this.agents.set(agentId, { config });
+        this.registeredAgents.set(agentId, {
+            id: agentId,
+            name: agentId,
+            description: `Hermes agent — model: ${config.model ?? 'hermes3'}`,
+            adapter: 'hermes',
+            capabilities: ['text-generation', 'reasoning', 'instruction-following'],
+            status: 'available',
+        });
+    }
+    async executeAgent(agentId, payload, _context) {
+        if (!this.ready) {
+            return { success: false, error: { code: 'NOT_INITIALIZED', message: 'HermesAdapter not initialized', recoverable: false } };
+        }
+        const entry = this.agents.get(agentId);
+        if (!entry) {
+            return { success: false, error: { code: 'AGENT_NOT_FOUND', message: `Hermes agent not found: ${agentId}`, recoverable: false } };
+        }
+        const { config } = entry;
+        const prompt = buildPrompt(payload);
+        const messages = [];
+        if (config.systemPrompt) {
+            messages.push({ role: 'system', content: config.systemPrompt });
+        }
+        messages.push({ role: 'user', content: prompt });
+        try {
+            let content;
+            let usage;
+            if (config.client) {
+                // BYOC path
+                const resp = await config.client.create({
+                    model: config.model ?? 'hermes3',
+                    messages,
+                    ...(config.maxTokens !== undefined ? { max_tokens: config.maxTokens } : {}),
+                    ...(config.temperature !== undefined ? { temperature: config.temperature } : {}),
+                    ...(config.stop?.length ? { stop: config.stop } : {}),
+                });
+                content = resp.choices[0]?.message?.content ?? resp.choices[0]?.text ?? '';
+                if (resp.usage) {
+                    usage = {
+                        prompt_tokens: resp.usage.prompt_tokens ?? 0,
+                        completion_tokens: resp.usage.completion_tokens ?? 0,
+                        total_tokens: resp.usage.total_tokens ?? 0,
+                    };
+                }
+            }
+            else {
+                // Built-in fetch path
+                const result = await fetchCompletion(config, messages);
+                content = result.content;
+                usage = result.usage;
+            }
+            return {
+                success: true,
+                data: {
+                    response: content,
+                    model: config.model ?? 'hermes3',
+                    agentId,
+                    ...(usage ? { usage } : {}),
+                },
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: {
+                    code: 'EXECUTION_ERROR',
+                    message: err instanceof Error ? err.message : String(err),
+                    recoverable: true,
+                    nativeError: err,
+                },
+            };
+        }
+    }
+    async initialize(config) {
+        await super.initialize(config);
+    }
+    async shutdown() {
+        this.agents.clear();
+        await super.shutdown();
+    }
+}
+exports.HermesAdapter = HermesAdapter;
+//# sourceMappingURL=hermes-adapter.js.map

package/dist/esm/adapters/hermes-adapter.js.map

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

package/dist/esm/adapters/index.js

@@ -0,0 +1,109 @@
+"use strict";
+/**
+ * Adapter System -- Plug-and-Play Agent Framework Support
+ *
+ * This module exports everything needed to make the SwarmOrchestrator
+ * work with any agent system. Import from here for clean access.
+ *
+ * Quick Start:
+ *
+ *   import { AdapterRegistry, CustomAdapter } from './adapters';
+ *
+ *   const registry = new AdapterRegistry();
+ *   const custom = new CustomAdapter();
+ *   custom.registerHandler("my-agent", async (payload) => {
+ *     return { result: "done" };
+ *   });
+ *   await registry.addAdapter(custom);
+ *
+ * @module Adapters
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RLMAdapter = exports.OrchestratorAdapter = exports.BrowserAgentAdapter = exports.PydanticAIAdapter = exports.VertexAIAdapter = exports.OpenAIAgentsAdapter = exports.AnthropicComputerUseAdapter = exports.LangGraphAdapter = exports.HermesAdapter = exports.CopilotAdapter = exports.NemoClawAdapter = exports.APSAdapter = exports.MiniMaxAdapter = exports.CodexAdapter = exports.A2AAdapter = exports.CustomStreamingAdapter = exports.LangChainStreamingAdapter = exports.collectStream = exports.StreamingBaseAdapter = exports.AgnoAdapter = exports.DSPyAdapter = exports.HaystackAdapter = exports.OpenAIAssistantsAdapter = exports.SemanticKernelAdapter = exports.LlamaIndexAdapter = exports.CustomAdapter = exports.MCPAdapter = exports.CrewAIAdapter = exports.AutoGenAdapter = exports.LangChainAdapter = exports.OpenClawAdapter = exports.getRegistry = exports.AdapterRegistry = exports.BaseAdapter = void 0;
+// Core infrastructure
+var base_adapter_1 = require("./base-adapter");
+Object.defineProperty(exports, "BaseAdapter", { enumerable: true, get: function () { return base_adapter_1.BaseAdapter; } });
+var adapter_registry_1 = require("./adapter-registry");
+Object.defineProperty(exports, "AdapterRegistry", { enumerable: true, get: function () { return adapter_registry_1.AdapterRegistry; } });
+Object.defineProperty(exports, "getRegistry", { enumerable: true, get: function () { return adapter_registry_1.getRegistry; } });
+// Framework adapters -- Original 6
+var openclaw_adapter_1 = require("./openclaw-adapter");
+Object.defineProperty(exports, "OpenClawAdapter", { enumerable: true, get: function () { return openclaw_adapter_1.OpenClawAdapter; } });
+var langchain_adapter_1 = require("./langchain-adapter");
+Object.defineProperty(exports, "LangChainAdapter", { enumerable: true, get: function () { return langchain_adapter_1.LangChainAdapter; } });
+var autogen_adapter_1 = require("./autogen-adapter");
+Object.defineProperty(exports, "AutoGenAdapter", { enumerable: true, get: function () { return autogen_adapter_1.AutoGenAdapter; } });
+var crewai_adapter_1 = require("./crewai-adapter");
+Object.defineProperty(exports, "CrewAIAdapter", { enumerable: true, get: function () { return crewai_adapter_1.CrewAIAdapter; } });
+var mcp_adapter_1 = require("./mcp-adapter");
+Object.defineProperty(exports, "MCPAdapter", { enumerable: true, get: function () { return mcp_adapter_1.MCPAdapter; } });
+var custom_adapter_1 = require("./custom-adapter");
+Object.defineProperty(exports, "CustomAdapter", { enumerable: true, get: function () { return custom_adapter_1.CustomAdapter; } });
+// Framework adapters -- New 6
+var llamaindex_adapter_1 = require("./llamaindex-adapter");
+Object.defineProperty(exports, "LlamaIndexAdapter", { enumerable: true, get: function () { return llamaindex_adapter_1.LlamaIndexAdapter; } });
+var semantic_kernel_adapter_1 = require("./semantic-kernel-adapter");
+Object.defineProperty(exports, "SemanticKernelAdapter", { enumerable: true, get: function () { return semantic_kernel_adapter_1.SemanticKernelAdapter; } });
+var openai_assistants_adapter_1 = require("./openai-assistants-adapter");
+Object.defineProperty(exports, "OpenAIAssistantsAdapter", { enumerable: true, get: function () { return openai_assistants_adapter_1.OpenAIAssistantsAdapter; } });
+var haystack_adapter_1 = require("./haystack-adapter");
+Object.defineProperty(exports, "HaystackAdapter", { enumerable: true, get: function () { return haystack_adapter_1.HaystackAdapter; } });
+var dspy_adapter_1 = require("./dspy-adapter");
+Object.defineProperty(exports, "DSPyAdapter", { enumerable: true, get: function () { return dspy_adapter_1.DSPyAdapter; } });
+var agno_adapter_1 = require("./agno-adapter");
+Object.defineProperty(exports, "AgnoAdapter", { enumerable: true, get: function () { return agno_adapter_1.AgnoAdapter; } });
+// Streaming adapters
+var streaming_base_adapter_1 = require("./streaming-base-adapter");
+Object.defineProperty(exports, "StreamingBaseAdapter", { enumerable: true, get: function () { return streaming_base_adapter_1.StreamingBaseAdapter; } });
+Object.defineProperty(exports, "collectStream", { enumerable: true, get: function () { return streaming_base_adapter_1.collectStream; } });
+var langchain_streaming_adapter_1 = require("./langchain-streaming-adapter");
+Object.defineProperty(exports, "LangChainStreamingAdapter", { enumerable: true, get: function () { return langchain_streaming_adapter_1.LangChainStreamingAdapter; } });
+var custom_streaming_adapter_1 = require("./custom-streaming-adapter");
+Object.defineProperty(exports, "CustomStreamingAdapter", { enumerable: true, get: function () { return custom_streaming_adapter_1.CustomStreamingAdapter; } });
+// A2A (Agent-to-Agent) adapter
+var a2a_adapter_1 = require("./a2a-adapter");
+Object.defineProperty(exports, "A2AAdapter", { enumerable: true, get: function () { return a2a_adapter_1.A2AAdapter; } });
+// Codex adapter (OpenAI Codex CLI / chat / completion)
+var codex_adapter_1 = require("./codex-adapter");
+Object.defineProperty(exports, "CodexAdapter", { enumerable: true, get: function () { return codex_adapter_1.CodexAdapter; } });
+// MiniMax adapter (MiniMax LLM API — MiniMax-M2.5 / MiniMax-M2.5-highspeed)
+var minimax_adapter_1 = require("./minimax-adapter");
+Object.defineProperty(exports, "MiniMaxAdapter", { enumerable: true, get: function () { return minimax_adapter_1.MiniMaxAdapter; } });
+// APS adapter (Agent Permission Service — delegation chain → trust mapping)
+var aps_adapter_1 = require("./aps-adapter");
+Object.defineProperty(exports, "APSAdapter", { enumerable: true, get: function () { return aps_adapter_1.APSAdapter; } });
+// NemoClaw adapter (NVIDIA NemoClaw — sandboxed agent execution via OpenShell)
+var nemoclaw_adapter_1 = require("./nemoclaw-adapter");
+Object.defineProperty(exports, "NemoClawAdapter", { enumerable: true, get: function () { return nemoclaw_adapter_1.NemoClawAdapter; } });
+// Copilot adapter (GitHub Copilot — code generation, review, analysis)
+var copilot_adapter_1 = require("./copilot-adapter");
+Object.defineProperty(exports, "CopilotAdapter", { enumerable: true, get: function () { return copilot_adapter_1.CopilotAdapter; } });
+// Hermes adapter (NousResearch Hermes — Ollama / OpenAI-compatible endpoint, BYOC)
+var hermes_adapter_1 = require("./hermes-adapter");
+Object.defineProperty(exports, "HermesAdapter", { enumerable: true, get: function () { return hermes_adapter_1.HermesAdapter; } });
+// LangGraph adapter (LangChain stateful graph execution)
+var langgraph_adapter_1 = require("./langgraph-adapter");
+Object.defineProperty(exports, "LangGraphAdapter", { enumerable: true, get: function () { return langgraph_adapter_1.LangGraphAdapter; } });
+// Anthropic Computer Use adapter (Claude with screen/keyboard/mouse)
+var anthropic_computer_use_adapter_1 = require("./anthropic-computer-use-adapter");
+Object.defineProperty(exports, "AnthropicComputerUseAdapter", { enumerable: true, get: function () { return anthropic_computer_use_adapter_1.AnthropicComputerUseAdapter; } });
+// OpenAI Agents SDK adapter (agent runners with tools, handoffs, guardrails)
+var openai_agents_adapter_1 = require("./openai-agents-adapter");
+Object.defineProperty(exports, "OpenAIAgentsAdapter", { enumerable: true, get: function () { return openai_agents_adapter_1.OpenAIAgentsAdapter; } });
+// Vertex AI adapter (Google Gemini, PaLM, custom endpoints)
+var vertex_ai_adapter_1 = require("./vertex-ai-adapter");
+Object.defineProperty(exports, "VertexAIAdapter", { enumerable: true, get: function () { return vertex_ai_adapter_1.VertexAIAdapter; } });
+// Pydantic AI adapter (type-safe Python agent framework)
+var pydantic_ai_adapter_1 = require("./pydantic-ai-adapter");
+Object.defineProperty(exports, "PydanticAIAdapter", { enumerable: true, get: function () { return pydantic_ai_adapter_1.PydanticAIAdapter; } });
+// Browser Agent adapter (Playwright, Puppeteer, CDP browser automation)
+var browser_agent_adapter_1 = require("./browser-agent-adapter");
+Object.defineProperty(exports, "BrowserAgentAdapter", { enumerable: true, get: function () { return browser_agent_adapter_1.BrowserAgentAdapter; } });
+// Orchestrator adapter (hierarchical multi-orchestrator coordination)
+var orchestrator_adapter_1 = require("./orchestrator-adapter");
+Object.defineProperty(exports, "OrchestratorAdapter", { enumerable: true, get: function () { return orchestrator_adapter_1.OrchestratorAdapter; } });
+// RLM adapter (Recursive Language Model — arxiv 2512.24601)
+var rlm_adapter_1 = require("./rlm-adapter");
+Object.defineProperty(exports, "RLMAdapter", { enumerable: true, get: function () { return rlm_adapter_1.RLMAdapter; } });
+//# sourceMappingURL=index.js.map

package/dist/esm/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../adapters/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;AAEH,sBAAsB;AACtB,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AACpB,uDAAkE;AAAzD,mHAAA,eAAe,OAAA;AAAE,+GAAA,WAAW,OAAA;AAGrC,mCAAmC;AACnC,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AACxB,yDAAuD;AAA9C,qHAAA,gBAAgB,OAAA;AAEzB,qDAAmD;AAA1C,iHAAA,cAAc,OAAA;AAEvB,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AAEtB,6CAA2C;AAAlC,yGAAA,UAAU,OAAA;AAEnB,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AAGtB,8BAA8B;AAC9B,2DAAyD;AAAhD,uHAAA,iBAAiB,OAAA;AAO1B,qEAAkE;AAAzD,gIAAA,qBAAqB,OAAA;AAE9B,yEAAsE;AAA7D,oIAAA,uBAAuB,OAAA;AAOhC,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AAQxB,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AAEpB,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AAQpB,qBAAqB;AACrB,mEAA+E;AAAtE,8HAAA,oBAAoB,OAAA;AAAE,uHAAA,aAAa,OAAA;AAC5C,6EAA0E;AAAjE,wIAAA,yBAAyB,OAAA;AAClC,uEAAoE;AAA3D,kIAAA,sBAAsB,OAAA;AAG/B,+BAA+B;AAC/B,6CAA2C;AAAlC,yGAAA,UAAU,OAAA;AAUnB,uDAAuD;AACvD,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AASrB,4EAA4E;AAC5E,qDAAmD;AAA1C,iHAAA,cAAc,OAAA;AAGvB,4EAA4E;AAC5E,6CAA2C;AAAlC,yGAAA,UAAU,OAAA;AAOnB,+EAA+E;AAC/E,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AAYxB,uEAAuE;AACvE,qDAAmD;AAA1C,iHAAA,cAAc,OAAA;AAGvB,mFAAmF;AACnF,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AAGtB,yDAAyD;AACzD,yDAAuD;AAA9C,qHAAA,gBAAgB,OAAA;AAGzB,qEAAqE;AACrE,mFAA+E;AAAtE,6IAAA,2BAA2B,OAAA;AAUpC,6EAA6E;AAC7E,iEAA8D;AAArD,4HAAA,mBAAmB,OAAA;AAQ5B,4DAA4D;AAC5D,yDAAsD;AAA7C,oHAAA,eAAe,OAAA;AAUxB,yDAAyD;AACzD,6DAA0D;AAAjD,wHAAA,iBAAiB,OAAA;AAQ1B,wEAAwE;AACxE,iEAA8D;AAArD,4HAAA,mBAAmB,OAAA;AAS5B,sEAAsE;AACtE,+DAA6D;AAApD,2HAAA,mBAAmB,OAAA;AAO5B,4DAA4D;AAC5D,6CAA2C;AAAlC,yGAAA,UAAU,OAAA"}

package/dist/esm/adapters/langchain-adapter.js

@@ -0,0 +1,134 @@
+"use strict";
+/**
+ * LangChain / LangGraph Adapter
+ *
+ * Allows LangChain agents, chains, and LangGraph workflows to plug into
+ * the SwarmOrchestrator. Agents are registered as callable functions
+ * or LangChain Runnable objects.
+ *
+ * Usage:
+ *   const adapter = new LangChainAdapter();
+ *   adapter.registerAgent("research", myLangChainAgent);
+ *   adapter.registerAgent("summarizer", myChain);
+ *   await registry.addAdapter(adapter);
+ *
+ * Then in the orchestrator:
+ *   delegateTask({ targetAgent: "lc:research", ... })
+ *
+ * @module LangChainAdapter
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LangChainAdapter = void 0;
+const base_adapter_1 = require("./base-adapter");
+class LangChainAdapter extends base_adapter_1.BaseAdapter {
+    name = 'langchain';
+    version = '1.0.0';
+    runnables = new Map();
+    get capabilities() {
+        return {
+            streaming: true,
+            parallel: true,
+            bidirectional: false,
+            discovery: true,
+            authentication: false,
+            statefulSessions: true,
+        };
+    }
+    /**
+     * Register a LangChain agent, chain, or LangGraph graph.
+     *
+     * @param agentId - Unique identifier for this agent
+     * @param runnable - A LangChain Runnable (agent, chain, graph) or async function
+     * @param metadata - Optional metadata (description, capabilities)
+     */
+    registerAgent(agentId, runnable, metadata) {
+        this.runnables.set(agentId, runnable);
+        this.registerLocalAgent({
+            id: agentId,
+            name: agentId,
+            description: metadata?.description ?? `LangChain agent: ${agentId}`,
+            capabilities: metadata?.capabilities,
+            status: 'available',
+        });
+    }
+    async executeAgent(agentId, payload, context) {
+        this.ensureReady();
+        const runnable = this.runnables.get(agentId);
+        if (!runnable) {
+            return this.errorResult('AGENT_NOT_FOUND', `LangChain agent "${agentId}" is not registered. Call adapter.registerAgent() first.`, false);
+        }
+        const startTime = Date.now();
+        try {
+            // Build the input in LangChain's expected format
+            const input = this.buildInput(payload, context);
+            // Execute: support both Runnable.invoke() and plain functions
+            let result;
+            if (typeof runnable === 'function') {
+                result = await runnable(input);
+            }
+            else {
+                result = await runnable.invoke(input, {
+                    metadata: {
+                        taskId: context.taskId,
+                        sessionId: context.sessionId,
+                        sourceAgent: context.agentId,
+                    },
+                });
+            }
+            // Normalize the result
+            return this.normalizeResult(result, startTime);
+        }
+        catch (error) {
+            return this.errorResult('LANGCHAIN_ERROR', error instanceof Error ? error.message : 'LangChain execution failed', true, error);
+        }
+    }
+    buildInput(payload, context) {
+        const input = {
+            ...payload.params,
+        };
+        // Map handoff instruction to common LangChain input keys
+        if (payload.handoff) {
+            input.input = payload.handoff.instruction;
+            input.question = payload.handoff.instruction; // Some chains expect "question"
+            input.task = payload.handoff.instruction;
+            if (payload.handoff.context) {
+                input.context = payload.handoff.context;
+            }
+            if (payload.handoff.constraints) {
+                input.constraints = payload.handoff.constraints;
+            }
+        }
+        // Include blackboard data
+        if (payload.blackboardSnapshot) {
+            input.shared_state = payload.blackboardSnapshot;
+        }
+        // Agent context
+        input.agent_context = {
+            agentId: context.agentId,
+            taskId: context.taskId,
+            sessionId: context.sessionId,
+        };
+        return input;
+    }
+    normalizeResult(result, startTime) {
+        // Handle LangChain's various output formats
+        if (result && typeof result === 'object') {
+            const obj = result;
+            // AgentExecutor returns { output: "..." }
+            if ('output' in obj) {
+                return this.successResult(obj.output, Date.now() - startTime);
+            }
+            // Some chains return { result: "..." }
+            if ('result' in obj) {
+                return this.successResult(obj.result, Date.now() - startTime);
+            }
+            // LangGraph returns state objects — pass through  
+            return this.successResult(result, Date.now() - startTime);
+        }
+        // String or primitive result
+        return this.successResult(result, Date.now() - startTime);
+    }
+}
+exports.LangChainAdapter = LangChainAdapter;
+//# sourceMappingURL=langchain-adapter.js.map

package/dist/esm/adapters/langchain-adapter.js.map

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

package/dist/esm/adapters/langchain-streaming-adapter.js

@@ -0,0 +1,161 @@
+"use strict";
+/**
+ * LangChainStreamingAdapter — LangChainAdapter with real incremental streaming.
+ *
+ * Extends {@link LangChainAdapter} with genuine streaming via the LangChain
+ * Runnable `.stream()` interface. Falls back gracefully to `.invoke()` for
+ * agents whose Runnable does not expose `.stream()`.
+ *
+ * Usage (drop-in replacement for LangChainAdapter):
+ *
+ *   const adapter = new LangChainStreamingAdapter();
+ *   adapter.registerAgent('analyst', myChain);        // same API
+ *   await registry.addAdapter(adapter);
+ *
+ *   // Stream the response
+ *   for await (const chunk of adapter.executeAgentStream('analyst', payload, ctx)) {
+ *     process.stdout.write(chunk.text);
+ *     if (chunk.done) break;
+ *   }
+ *
+ * @module LangChainStreamingAdapter
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LangChainStreamingAdapter = void 0;
+const langchain_adapter_1 = require("./langchain-adapter");
+function isStreamable(runnable) {
+    return (typeof runnable === 'object' &&
+        runnable !== null &&
+        typeof runnable.stream === 'function');
+}
+/** Coerce any chunk value yielded by a LangChain stream to a string. */
+function chunkToText(raw) {
+    if (typeof raw === 'string')
+        return raw;
+    if (raw == null)
+        return '';
+    if (typeof raw === 'object') {
+        const obj = raw;
+        // AIMessage / BaseMessage pattern
+        if (typeof obj.content === 'string')
+            return obj.content;
+        // { output: "..." } pattern
+        if (typeof obj.output === 'string')
+            return obj.output;
+        // { result: "..." } pattern
+        if (typeof obj.result === 'string')
+            return obj.result;
+        // Generic object — stringify
+        return JSON.stringify(obj);
+    }
+    return String(raw);
+}
+class LangChainStreamingAdapter extends langchain_adapter_1.LangChainAdapter {
+    // Internal registry of agents that have a real .stream() method
+    streamableAgentIds = new Set();
+    get capabilities() {
+        return {
+            ...super.capabilities,
+            streaming: true,
+        };
+    }
+    /**
+     * Register a LangChain agent. Automatically detects `.stream()` support.
+     */
+    registerAgent(agentId, runnable, metadata) {
+        super.registerAgent(agentId, runnable, metadata);
+        if (isStreamable(runnable)) {
+            this.streamableAgentIds.add(agentId);
+        }
+    }
+    /** Returns `true` when the agent exposes LangChain's `.stream()` method. */
+    supportsStreaming(agentId) {
+        return this.streamableAgentIds.has(agentId);
+    }
+    /**
+     * Stream agent execution as incremental `StreamingChunk` values.
+     *
+     * - If the registered Runnable exposes `.stream()`, emits tokens incrementally.
+     * - Otherwise falls back to `.invoke()` and emits a single chunk.
+     */
+    async *executeAgentStream(agentId, payload, context) {
+        this.ensureReady();
+        // Access the internal runnables map via the parent's execute path.
+        // We override at the stream level; non-streamable agents fall through
+        // to the single-chunk wrapper in the base non-streaming path.
+        if (!this.streamableAgentIds.has(agentId)) {
+            // Fall back: executeAgent → single chunk
+            const result = await this.executeAgent(agentId, payload, context);
+            if (!result.success) {
+                yield {
+                    text: result.error?.message ?? 'Agent execution failed',
+                    done: true,
+                    metadata: { error: true, code: result.error?.code },
+                };
+                return;
+            }
+            const data = result.data;
+            const text = typeof data === 'string' ? data :
+                data != null ? JSON.stringify(data) :
+                    '';
+            yield { text, done: false, metadata: result.metadata };
+            yield { text: '', done: true, metadata: { adapter: this.name } };
+            return;
+        }
+        // Build the same input the non-streaming path would use
+        const input = this.buildInput(payload, context);
+        // We need the runnable — access it via executeAgent's path by delegating
+        // through a custom approach: re-invoke via the known runnables map.
+        // The parent stores runnables as a private field; we get it via symbol.
+        const runnables = this.runnables;
+        const runnable = runnables?.get(agentId);
+        if (!runnable || !isStreamable(runnable)) {
+            // Shouldn't happen — fallback anyway
+            yield* this._fallbackStream(agentId, payload, context);
+            return;
+        }
+        const langchainConfig = {
+            metadata: {
+                taskId: context.taskId,
+                sessionId: context.sessionId,
+                sourceAgent: context.agentId,
+            },
+        };
+        try {
+            for await (const rawChunk of runnable.stream(input, langchainConfig)) {
+                const text = chunkToText(rawChunk);
+                if (text)
+                    yield { text, done: false };
+            }
+            yield { text: '', done: true, metadata: { adapter: this.name } };
+        }
+        catch (error) {
+            yield {
+                text: error instanceof Error ? error.message : 'Streaming failed',
+                done: true,
+                metadata: { error: true },
+            };
+        }
+    }
+    // Private helper used for fallback path
+    async *_fallbackStream(agentId, payload, context) {
+        const result = await this.executeAgent(agentId, payload, context);
+        if (!result.success) {
+            yield {
+                text: result.error?.message ?? 'Agent execution failed',
+                done: true,
+                metadata: { error: true },
+            };
+            return;
+        }
+        const data = result.data;
+        const text = typeof data === 'string' ? data :
+            data != null ? JSON.stringify(data) :
+                '';
+        yield { text, done: false };
+        yield { text: '', done: true };
+    }
+}
+exports.LangChainStreamingAdapter = LangChainStreamingAdapter;
+//# sourceMappingURL=langchain-streaming-adapter.js.map

package/dist/esm/adapters/langchain-streaming-adapter.js.map

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