network-ai 4.0.17 → 4.2.0

package/dist/adapters/custom-streaming-adapter.js

@@ -0,0 +1,181 @@
+"use strict";
+/**
+ * CustomStreamingAdapter — CustomAdapter with streaming support.
+ *
+ * Extends {@link CustomAdapter} so that handlers can yield incremental text
+ * by returning an `AsyncIterable<string>` or `AsyncIterable<StreamingChunk>`.
+ * Plain `Promise<unknown>` handlers work unchanged (single-chunk fallback).
+ *
+ * Usage:
+ *
+ *   const adapter = new CustomStreamingAdapter();
+ *
+ *   // Streaming handler — yields tokens incrementally
+ *   adapter.registerHandler('writer', async function*(payload) {
+ *     yield 'Once ';
+ *     yield 'upon ';
+ *     yield 'a time…';
+ *   });
+ *
+ *   // Non-streaming handler — works exactly as before
+ *   adapter.registerHandler('analyze', async (payload) => ({ result: 'done' }));
+ *
+ *   // Consume the stream
+ *   for await (const chunk of adapter.executeAgentStream('writer', payload, ctx)) {
+ *     process.stdout.write(chunk.text);
+ *   }
+ *
+ * @module CustomStreamingAdapter
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomStreamingAdapter = void 0;
+const custom_adapter_1 = require("./custom-adapter");
+/** Type guard — checks whether the return value of a handler is async-iterable. */
+function isAsyncIterable(val) {
+    return (val != null &&
+        typeof val === 'object' &&
+        Symbol.asyncIterator in val);
+}
+/** Type guard — checks whether a `StreamingChunk`-shaped object was yielded. */
+function isStreamingChunk(val) {
+    return (val !== null &&
+        typeof val === 'object' &&
+        typeof val.text === 'string' &&
+        typeof val.done === 'boolean');
+}
+class CustomStreamingAdapter extends custom_adapter_1.CustomAdapter {
+    streamingHandlers = new Set();
+    get capabilities() {
+        return {
+            ...super.capabilities,
+            streaming: true,
+        };
+    }
+    /**
+     * Register a handler. Streaming handlers (functions returning `AsyncIterable`)
+     * are detected automatically and exposed through `executeAgentStream()`.
+     */
+    registerHandler(agentId, handler, metadata) {
+        // Probe: call the handler with synthetic inputs and check if the return
+        // is async-iterable. We do this via a duck-typed try, falling back safely.
+        // Instead, infer from the handler's prototype / generator signature:
+        const isGenerator = handler.constructor?.name === 'AsyncGeneratorFunction' ||
+            (Object.prototype.toString.call(handler) === '[object AsyncGeneratorFunction]');
+        if (isGenerator) {
+            this.streamingHandlers.add(agentId);
+        }
+        // Cast to base AgentHandler — the broader type is compatible at runtime
+        super.registerHandler(agentId, handler, metadata);
+    }
+    /**
+     * Mark an already-registered handler as streaming.
+     * Useful when the handler function is not an async generator but returns
+     * an `AsyncIterable` (e.g. a closure around a separate generator).
+     */
+    markStreaming(agentId) {
+        this.streamingHandlers.add(agentId);
+    }
+    supportsStreaming(agentId) {
+        return this.streamingHandlers.has(agentId);
+    }
+    /**
+     * Execute a handler with streaming support.
+     *
+     * - If the handler is registered as streaming (yields tokens), pipes the
+     *   async iterable to `StreamingChunk` values.
+     * - Otherwise falls back to `executeAgent()` and wraps the result as a
+     *   single chunk (same behaviour as the non-streaming `CustomAdapter`).
+     */
+    async *executeAgentStream(agentId, payload, context) {
+        this.ensureReady();
+        // Access the internal handlers map stored in the parent class
+        const handlers = this.handlers;
+        const handler = handlers?.get(agentId);
+        if (!handler) {
+            // No handler — delegate to base executeAgent (which returns AGENT_NOT_FOUND)
+            const result = await this.executeAgent(agentId, payload, context);
+            yield {
+                text: result.error?.message ?? 'Agent not found',
+                done: true,
+                metadata: { error: true },
+            };
+            return;
+        }
+        // Invoke the handler — may return a Promise or an AsyncIterable
+        let returnValue;
+        try {
+            returnValue = handler(payload, context);
+        }
+        catch (err) {
+            yield {
+                text: err instanceof Error ? err.message : 'Handler threw synchronously',
+                done: true,
+                metadata: { error: true },
+            };
+            return;
+        }
+        // If the return is a Promise, await it first
+        if (returnValue instanceof Promise) {
+            let resolved;
+            try {
+                resolved = await returnValue;
+            }
+            catch (err) {
+                yield {
+                    text: err instanceof Error ? err.message : 'Handler rejected',
+                    done: true,
+                    metadata: { error: true },
+                };
+                return;
+            }
+            if (isAsyncIterable(resolved)) {
+                // Resolved to an async iterable — pipe it through
+                yield* this._pipeIterable(resolved);
+                return;
+            }
+            // Plain resolved value — single chunk fallback
+            const text = typeof resolved === 'string' ? resolved :
+                resolved != null ? JSON.stringify(resolved) :
+                    '';
+            yield { text, done: false };
+            yield { text: '', done: true };
+            return;
+        }
+        // Returned an AsyncIterable directly (generator function, etc.)
+        if (isAsyncIterable(returnValue)) {
+            yield* this._pipeIterable(returnValue);
+            return;
+        }
+        // Fallback — single chunk from whatever value was returned
+        const text = typeof returnValue === 'string' ? returnValue :
+            returnValue != null ? JSON.stringify(returnValue) :
+                '';
+        yield { text, done: false };
+        yield { text: '', done: true };
+    }
+    /** Pipe an `AsyncIterable<string | StreamingChunk>` to `StreamingChunk` values. */
+    async *_pipeIterable(iterable) {
+        try {
+            for await (const item of iterable) {
+                if (isStreamingChunk(item)) {
+                    yield item;
+                }
+                else {
+                    const text = typeof item === 'string' ? item : JSON.stringify(item);
+                    yield { text, done: false };
+                }
+            }
+            yield { text: '', done: true };
+        }
+        catch (err) {
+            yield {
+                text: err instanceof Error ? err.message : 'Stream iteration failed',
+                done: true,
+                metadata: { error: true },
+            };
+        }
+    }
+}
+exports.CustomStreamingAdapter = CustomStreamingAdapter;
+//# sourceMappingURL=custom-streaming-adapter.js.map

package/dist/adapters/custom-streaming-adapter.js.map

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

package/dist/adapters/index.d.ts

@@ -43,5 +43,14 @@ export { DSPyAdapter } from './dspy-adapter';
 export type { DSPyModule, DSPyProgram, DSPyPrediction, DSPyPredictor } from './dspy-adapter';
 export { AgnoAdapter } from './agno-adapter';
 export type { AgnoAgent, AgnoTeam, AgnoResponse, AgnoFunction, } from './agno-adapter';
+export { StreamingBaseAdapter, collectStream } from './streaming-base-adapter';
+export { LangChainStreamingAdapter } from './langchain-streaming-adapter';
+export { CustomStreamingAdapter } from './custom-streaming-adapter';
+export type { StreamingAgentHandler } from './custom-streaming-adapter';
+export { A2AAdapter } from './a2a-adapter';
+export type { A2AAgentCard, A2ATask, A2ATaskResponse, A2ATaskState, A2AArtifact, A2AAdapterConfig, } from './a2a-adapter';
+export { CodexAdapter } from './codex-adapter';
+export type { CodexMode, CodexAgentConfig, CodexChatClient, CodexCompletionClient, CodexCLIExecutor, } from './codex-adapter';
+export type { StreamingChunk, IStreamingAdapter, StreamCollector } from '../types/streaming-adapter';
 export type { IAgentAdapter, AgentPayload, AgentContext, AgentResult, AgentInfo, AdapterConfig, AdapterCapabilities, AdapterRoute, RegistryConfig, AdapterEvent, AdapterEventHandler, AdapterEventType, } from '../types/agent-adapter';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGlE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACtG,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,YAAY,EACV,eAAe,EACf,sBAAsB,EACtB,aAAa,EACb,SAAS,GACV,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EACV,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,EACb,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC7F,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EACV,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,YAAY,GACb,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACV,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../adapters/index.ts"],"names":[],"mappings":"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"}

package/dist/adapters/index.js

@@ -20,7 +20,7 @@
  * @version 1.0.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-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;
+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; } });
@@ -53,4 +53,18 @@ 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; } });
 //# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -1 +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;AAErC,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"}
+{"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;AAErC,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"}

package/dist/adapters/langchain-streaming-adapter.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 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
+ */
+import type { AgentPayload, AgentContext, AdapterCapabilities } from '../types/agent-adapter';
+import type { StreamingChunk } from '../types/streaming-adapter';
+import type { IStreamingAdapter } from '../types/streaming-adapter';
+import { LangChainAdapter, LangChainRunnable } from './langchain-adapter';
+export declare class LangChainStreamingAdapter extends LangChainAdapter implements IStreamingAdapter {
+    private streamableAgentIds;
+    get capabilities(): AdapterCapabilities;
+    /**
+     * Register a LangChain agent. Automatically detects `.stream()` support.
+     */
+    registerAgent(agentId: string, runnable: LangChainRunnable, metadata?: {
+        description?: string;
+        capabilities?: string[];
+    }): void;
+    /** Returns `true` when the agent exposes LangChain's `.stream()` method. */
+    supportsStreaming(agentId: string): boolean;
+    /**
+     * 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.
+     */
+    executeAgentStream(agentId: string, payload: AgentPayload, context: AgentContext): AsyncIterable<StreamingChunk>;
+    private _fallbackStream;
+}
+//# sourceMappingURL=langchain-streaming-adapter.d.ts.map

package/dist/adapters/langchain-streaming-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain-streaming-adapter.d.ts","sourceRoot":"","sources":["../../adapters/langchain-streaming-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC9F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAsC1E,qBAAa,yBAA0B,SAAQ,gBAAiB,YAAW,iBAAiB;IAG1F,OAAO,CAAC,kBAAkB,CAAqB;IAE/C,IAAI,YAAY,IAAI,mBAAmB,CAKtC;IAED;;OAEG;IACH,aAAa,CACX,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAC3D,IAAI;IAOP,4EAA4E;IAC5E,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAI3C;;;;;OAKG;IACI,kBAAkB,CACvB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,YAAY,GACpB,aAAa,CAAC,cAAc,CAAC;YAkEjB,eAAe;CAsB/B"}

package/dist/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/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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"}

package/dist/adapters/streaming-base-adapter.d.ts

@@ -0,0 +1,42 @@
+/**
+ * StreamingBaseAdapter — Abstract base for all streaming-capable adapters.
+ *
+ * Extends {@link BaseAdapter} with a default `executeAgentStream()` that wraps
+ * the non-streaming `executeAgent()` result as a single `StreamingChunk`.
+ * Subclasses override `executeAgentStream()` and/or `supportsStreaming()` to
+ * provide genuine incremental streaming.
+ *
+ * @module StreamingBaseAdapter
+ * @version 1.0.0
+ */
+import type { AgentPayload, AgentContext } from '../types/agent-adapter';
+import type { IStreamingAdapter, StreamingChunk } from '../types/streaming-adapter';
+import { BaseAdapter } from './base-adapter';
+export declare abstract class StreamingBaseAdapter extends BaseAdapter implements IStreamingAdapter {
+    /**
+     * Returns `true` when the named agent has a real streaming implementation.
+     * Default: `false` (fallback single-chunk wrapper is used).
+     * Override in subclasses that register streaming agents.
+     */
+    supportsStreaming(_agentId: string): boolean;
+    /**
+     * Default streaming implementation — wraps `executeAgent()` as a single chunk.
+     *
+     * Subclasses that support genuine streaming should override this method.
+     * The overriding implementation should:
+     *  1. yield partial text chunks as they arrive
+     *  2. yield a final chunk with `done: true` and `text: ''`
+     */
+    executeAgentStream(agentId: string, payload: AgentPayload, context: AgentContext): AsyncIterable<StreamingChunk>;
+}
+/**
+ * Utility: drain a streaming adapter into a single accumulated result.
+ *
+ * @example
+ *   const { output } = await collectStream(adapter.executeAgentStream('my-agent', payload, ctx));
+ */
+export declare function collectStream(stream: AsyncIterable<StreamingChunk>): Promise<{
+    output: string;
+    chunks: StreamingChunk[];
+}>;
+//# sourceMappingURL=streaming-base-adapter.d.ts.map

package/dist/adapters/streaming-base-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-base-adapter.d.ts","sourceRoot":"","sources":["../../adapters/streaming-base-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,8BAAsB,oBAAqB,SAAQ,WAAY,YAAW,iBAAiB;IAEzF;;;;OAIG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI5C;;;;;;;OAOG;IACI,kBAAkB,CACvB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,YAAY,GACpB,aAAa,CAAC,cAAc,CAAC;CAoBjC;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,aAAa,CAAC,cAAc,CAAC,GACpC,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,cAAc,EAAE,CAAA;CAAE,CAAC,CAQvD"}

package/dist/adapters/streaming-base-adapter.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * StreamingBaseAdapter — Abstract base for all streaming-capable adapters.
+ *
+ * Extends {@link BaseAdapter} with a default `executeAgentStream()` that wraps
+ * the non-streaming `executeAgent()` result as a single `StreamingChunk`.
+ * Subclasses override `executeAgentStream()` and/or `supportsStreaming()` to
+ * provide genuine incremental streaming.
+ *
+ * @module StreamingBaseAdapter
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StreamingBaseAdapter = void 0;
+exports.collectStream = collectStream;
+const base_adapter_1 = require("./base-adapter");
+class StreamingBaseAdapter extends base_adapter_1.BaseAdapter {
+    /**
+     * Returns `true` when the named agent has a real streaming implementation.
+     * Default: `false` (fallback single-chunk wrapper is used).
+     * Override in subclasses that register streaming agents.
+     */
+    supportsStreaming(_agentId) {
+        return false;
+    }
+    /**
+     * Default streaming implementation — wraps `executeAgent()` as a single chunk.
+     *
+     * Subclasses that support genuine streaming should override this method.
+     * The overriding implementation should:
+     *  1. yield partial text chunks as they arrive
+     *  2. yield a final chunk with `done: true` and `text: ''`
+     */
+    async *executeAgentStream(agentId, payload, context) {
+        const result = await this.executeAgent(agentId, payload, context);
+        if (!result.success) {
+            // Propagate the error as a single done-chunk with error text
+            const msg = result.error?.message ?? 'Agent execution failed';
+            yield { text: msg, done: true, metadata: { error: true, code: result.error?.code } };
+            return;
+        }
+        // Flatten data to a string for the streaming consumer
+        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 } };
+    }
+}
+exports.StreamingBaseAdapter = StreamingBaseAdapter;
+/**
+ * Utility: drain a streaming adapter into a single accumulated result.
+ *
+ * @example
+ *   const { output } = await collectStream(adapter.executeAgentStream('my-agent', payload, ctx));
+ */
+async function collectStream(stream) {
+    const chunks = [];
+    let output = '';
+    for await (const chunk of stream) {
+        chunks.push(chunk);
+        if (chunk.text)
+            output += chunk.text;
+    }
+    return { output, chunks };
+}
+//# sourceMappingURL=streaming-base-adapter.js.map

package/dist/adapters/streaming-base-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-base-adapter.js","sourceRoot":"","sources":["../../adapters/streaming-base-adapter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAyDH,sCAUC;AA/DD,iDAA6C;AAE7C,MAAsB,oBAAqB,SAAQ,0BAAW;IAE5D;;;;OAIG;IACH,iBAAiB,CAAC,QAAgB;QAChC,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,CAAC,kBAAkB,CACvB,OAAe,EACf,OAAqB,EACrB,OAAqB;QAErB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAElE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,6DAA6D;YAC7D,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,wBAAwB,CAAC;YAC9D,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC;YACrF,OAAO;QACT,CAAC;QAED,sDAAsD;QACtD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACzB,MAAM,IAAI,GACR,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACjC,IAAI,IAAI,IAAI,CAAa,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;gBACtB,EAAE,CAAC;QAEhC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;QACvD,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;IACnE,CAAC;CACF;AA3CD,oDA2CC;AAED;;;;;GAKG;AACI,KAAK,UAAU,aAAa,CACjC,MAAqC;IAErC,MAAM,MAAM,GAAqB,EAAE,CAAC;IACpC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnB,IAAI,KAAK,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC;IACvC,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC"}

package/dist/index.d.ts

@@ -788,4 +788,13 @@ export { ExtendedMcpTools } from './lib/mcp-tools-extended';
 export type { IBudget, ITokenManager, ExtendedMcpToolsOptions } from './lib/mcp-tools-extended';
 export { ControlMcpTools } from './lib/mcp-tools-control';
 export type { IConfig, IAgentStatus, ControlMcpToolsOptions } from './lib/mcp-tools-control';
+export { StreamingBaseAdapter, collectStream } from './adapters/streaming-base-adapter';
+export { LangChainStreamingAdapter } from './adapters/langchain-streaming-adapter';
+export { CustomStreamingAdapter } from './adapters/custom-streaming-adapter';
+export type { StreamingAgentHandler } from './adapters/custom-streaming-adapter';
+export { A2AAdapter } from './adapters/a2a-adapter';
+export type { A2AAgentCard, A2ATask, A2ATaskResponse, A2ATaskState, A2AArtifact, A2AAdapterConfig, } from './adapters/a2a-adapter';
+export { CodexAdapter } from './adapters/codex-adapter';
+export type { CodexMode, CodexAgentConfig, CodexChatClient, CodexCompletionClient, CodexCLIExecutor, } from './adapters/codex-adapter';
+export type { StreamingChunk, IStreamingAdapter, StreamCollector } from './types/streaming-adapter';
 //# sourceMappingURL=index.d.ts.map