network-ai 4.0.16 → 4.1.0

package/dist/adapters/a2a-adapter.js

@@ -0,0 +1,235 @@
+"use strict";
+/**
+ * A2AAdapter — Agent-to-Agent (A2A) protocol adapter.
+ *
+ * Implements the Google A2A (Agent-to-Agent) open protocol that lets
+ * independently hosted agents discover each other through a standard
+ * Agent Card (/.well-known/agent.json) and exchange tasks via a
+ * JSON-RPC envelope posted to the agent's task endpoint.
+ *
+ * References:
+ *   https://google.github.io/A2A/
+ *   https://github.com/google/A2A
+ *
+ * Usage:
+ *
+ *   const adapter = new A2AAdapter();
+ *   await adapter.initialize({});
+ *
+ *   // Register a remote agent by its Agent Card URL
+ *   await adapter.registerRemoteAgent('remote-analyst', 'https://agent.example.com');
+ *
+ *   // Or register a local agent that serves an A2A-compliant card
+ *   adapter.registerLocalA2AAgent('local-writer', {
+ *     name: 'Writing Agent',
+ *     description: 'Draft documents given a topic',
+ *     version: '1.0',
+ *     capabilities: { streaming: false },
+ *     taskEndpoint: 'https://writer.internal/tasks',
+ *   });
+ *
+ *   await registry.addAdapter(adapter);
+ *
+ *   // In the orchestrator:
+ *   delegateTask({ targetAgent: 'a2a:remote-analyst', ... })
+ *
+ * @module A2AAdapter
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.A2AAdapter = void 0;
+const base_adapter_1 = require("./base-adapter");
+class A2AAdapter extends base_adapter_1.BaseAdapter {
+    name = 'a2a';
+    version = '1.0.0';
+    a2aAgents = new Map();
+    defaultBearerToken;
+    defaultTimeoutMs = 30_000;
+    fetchImpl = globalThis.fetch;
+    get capabilities() {
+        return {
+            streaming: false,
+            parallel: true,
+            bidirectional: false,
+            discovery: true,
+            authentication: true,
+            statefulSessions: false,
+        };
+    }
+    async initialize(config) {
+        await super.initialize(config);
+        if (config.defaultBearerToken)
+            this.defaultBearerToken = config.defaultBearerToken;
+        if (config.defaultTimeoutMs)
+            this.defaultTimeoutMs = config.defaultTimeoutMs;
+        if (config.fetchImpl)
+            this.fetchImpl = config.fetchImpl;
+    }
+    // ── Registration ────────────────────────────────────────────────────────────
+    /**
+     * Fetch the Agent Card from `<baseUrl>/.well-known/agent.json` and register
+     * the remote agent for use in the orchestrator.
+     *
+     * @param agentId  - Local identifier (used in `delegate_task` calls)
+     * @param baseUrl  - Root URL of the remote A2A-compliant agent server
+     * @param options  - Optional bearer token / timeout override
+     */
+    async registerRemoteAgent(agentId, baseUrl, options) {
+        const url = baseUrl.replace(/\/$/, '');
+        const card = await this.fetchAgentCard(url, options?.bearerToken ?? this.defaultBearerToken);
+        const taskEndpoint = card.taskEndpoint ??
+            (card.url ? `${card.url.replace(/\/$/, '')}/tasks` : `${url}/tasks`);
+        this.a2aAgents.set(agentId, {
+            baseUrl: url,
+            card,
+            taskEndpoint,
+            bearerToken: options?.bearerToken ?? this.defaultBearerToken,
+            timeoutMs: options?.timeoutMs ?? this.defaultTimeoutMs,
+        });
+        this.registerLocalAgent({
+            id: agentId,
+            name: card.name,
+            description: card.description ?? `Remote A2A agent at ${url}`,
+            capabilities: card.capabilities
+                ? Object.keys(card.capabilities).filter(k => card.capabilities[k] === true)
+                : undefined,
+            status: 'available',
+            metadata: { a2aBaseUrl: url, taskEndpoint },
+        });
+    }
+    /**
+     * Register a local A2A agent whose card you already have (no network fetch).
+     * Useful when the card is embedded in config or returned from another service.
+     */
+    registerLocalA2AAgent(agentId, card, options) {
+        this.a2aAgents.set(agentId, {
+            baseUrl: card.url ?? '',
+            card,
+            taskEndpoint: card.taskEndpoint,
+            bearerToken: options?.bearerToken ?? this.defaultBearerToken,
+            timeoutMs: options?.timeoutMs ?? this.defaultTimeoutMs,
+        });
+        this.registerLocalAgent({
+            id: agentId,
+            name: card.name,
+            description: card.description ?? `Local A2A agent: ${agentId}`,
+            capabilities: card.capabilities
+                ? Object.keys(card.capabilities).filter(k => card.capabilities[k] === true)
+                : undefined,
+            status: 'available',
+        });
+    }
+    // ── Execution ───────────────────────────────────────────────────────────────
+    async executeAgent(agentId, payload, context) {
+        this.ensureReady();
+        const config = this.a2aAgents.get(agentId);
+        if (!config) {
+            return this.errorResult('AGENT_NOT_FOUND', `A2A agent "${agentId}" is not registered. Call registerRemoteAgent() or registerLocalA2AAgent() first.`, false);
+        }
+        const startTime = Date.now();
+        // Build the task instruction from the handoff payload
+        const instruction = payload.handoff?.instruction ??
+            (payload.params ? JSON.stringify(payload.params) : 'No instruction provided');
+        const taskId = `${context.taskId ?? 'task'}-${Date.now()}`;
+        const taskEnvelope = {
+            jsonrpc: '2.0',
+            id: taskId,
+            method: 'tasks/send',
+            params: {
+                id: taskId,
+                message: {
+                    role: 'user',
+                    parts: [{ type: 'text', text: instruction }],
+                },
+                metadata: {
+                    sourceAgent: context.agentId,
+                    sessionId: context.sessionId,
+                    ...(payload.handoff?.context ?? {}),
+                },
+            },
+        };
+        try {
+            const response = await this.sendTask(config, taskEnvelope);
+            if (response.error) {
+                return this.errorResult(`A2A_ERROR_${response.error.code}`, response.error.message, response.error.code >= 500, response.error);
+            }
+            if (!response.result) {
+                return this.errorResult('A2A_EMPTY_RESPONSE', 'A2A response had no result field', true);
+            }
+            const state = response.result.status.state;
+            if (state === 'failed' || state === 'canceled') {
+                return this.errorResult(`A2A_TASK_${state.toUpperCase()}`, response.result.status.message ?? `Task ended with state: ${state}`, state === 'failed');
+            }
+            // Extract text from artifacts
+            const output = this.extractOutput(response.result.artifacts);
+            return this.successResult({ output, state, artifacts: response.result.artifacts, metadata: response.result.metadata }, Date.now() - startTime);
+        }
+        catch (err) {
+            if (err instanceof Error && err.name === 'AbortError') {
+                return this.errorResult('A2A_TIMEOUT', `A2A request timed out after ${config.timeoutMs}ms`, true);
+            }
+            return this.errorResult('A2A_REQUEST_FAILED', err instanceof Error ? err.message : 'A2A request failed', true, err);
+        }
+    }
+    // ── Internals ───────────────────────────────────────────────────────────────
+    async fetchAgentCard(baseUrl, bearerToken) {
+        const cardUrl = `${baseUrl}/.well-known/agent.json`;
+        const headers = { Accept: 'application/json' };
+        if (bearerToken)
+            headers.Authorization = `Bearer ${bearerToken}`;
+        const controller = new AbortController();
+        const id = setTimeout(() => controller.abort(), this.defaultTimeoutMs);
+        let response;
+        try {
+            response = await this.fetchImpl(cardUrl, { headers, signal: controller.signal });
+        }
+        finally {
+            clearTimeout(id);
+        }
+        if (!response.ok) {
+            throw new Error(`Failed to fetch agent card from ${cardUrl}: HTTP ${response.status}`);
+        }
+        const card = await response.json();
+        if (!card.name) {
+            throw new Error(`Agent card at ${cardUrl} is missing required "name" field`);
+        }
+        return card;
+    }
+    async sendTask(config, task) {
+        const headers = {
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+        };
+        if (config.bearerToken)
+            headers.Authorization = `Bearer ${config.bearerToken}`;
+        const controller = new AbortController();
+        const id = setTimeout(() => controller.abort(), config.timeoutMs);
+        let response;
+        try {
+            response = await this.fetchImpl(config.taskEndpoint, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify(task),
+                signal: controller.signal,
+            });
+        }
+        finally {
+            clearTimeout(id);
+        }
+        if (!response.ok) {
+            throw new Error(`A2A task endpoint returned HTTP ${response.status}: ${response.statusText}`);
+        }
+        return response.json();
+    }
+    extractOutput(artifacts) {
+        if (!artifacts?.length)
+            return '';
+        return artifacts
+            .flatMap(a => a.parts)
+            .filter(p => p.type === 'text' && typeof p.text === 'string')
+            .map(p => p.text)
+            .join('\n');
+    }
+}
+exports.A2AAdapter = A2AAdapter;
+//# sourceMappingURL=a2a-adapter.js.map

package/dist/adapters/a2a-adapter.js.map

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

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

@@ -0,0 +1,68 @@
+/**
+ * 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
+ */
+import type { AgentPayload, AgentContext, AdapterCapabilities } from '../types/agent-adapter';
+import type { IStreamingAdapter, StreamingChunk } from '../types/streaming-adapter';
+import { CustomAdapter, AgentHandler } from './custom-adapter';
+/**
+ * Extended handler type that may also return an async iterable of string tokens
+ * or full `StreamingChunk` objects.
+ */
+export type StreamingAgentHandler = AgentHandler | ((payload: AgentPayload, context: AgentContext) => AsyncIterable<string>) | ((payload: AgentPayload, context: AgentContext) => AsyncIterable<StreamingChunk>);
+export declare class CustomStreamingAdapter extends CustomAdapter implements IStreamingAdapter {
+    private streamingHandlers;
+    get capabilities(): AdapterCapabilities;
+    /**
+     * Register a handler. Streaming handlers (functions returning `AsyncIterable`)
+     * are detected automatically and exposed through `executeAgentStream()`.
+     */
+    registerHandler(agentId: string, handler: StreamingAgentHandler, metadata?: {
+        description?: string;
+        capabilities?: string[];
+    }): void;
+    /**
+     * 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: string): void;
+    supportsStreaming(agentId: string): boolean;
+    /**
+     * 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`).
+     */
+    executeAgentStream(agentId: string, payload: AgentPayload, context: AgentContext): AsyncIterable<StreamingChunk>;
+    /** Pipe an `AsyncIterable<string | StreamingChunk>` to `StreamingChunk` values. */
+    private _pipeIterable;
+}
+//# sourceMappingURL=custom-streaming-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"custom-streaming-adapter.d.ts","sourceRoot":"","sources":["../../adapters/custom-streaming-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC9F,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE/D;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAC7B,YAAY,GACZ,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,KAAK,aAAa,CAAC,MAAM,CAAC,CAAC,GACzE,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,KAAK,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC;AAqBtF,qBAAa,sBAAuB,SAAQ,aAAc,YAAW,iBAAiB;IAEpF,OAAO,CAAC,iBAAiB,CAAqB;IAE9C,IAAI,YAAY,IAAI,mBAAmB,CAKtC;IAED;;;OAGG;IACH,eAAe,CACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,qBAAqB,EAC9B,QAAQ,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAC3D,IAAI;IAgBP;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIpC,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAI3C;;;;;;;OAOG;IACI,kBAAkB,CACvB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,YAAY,GACpB,aAAa,CAAC,cAAc,CAAC;IA4EhC,mFAAmF;YACpE,aAAa;CAqB7B"}

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,12 @@ 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 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":"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,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,YAAY,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGxE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,YAAY,EACV,YAAY,EACZ,OAAO,EACP,eAAe,EACf,YAAY,EACZ,WAAW,EACX,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAGvB,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAGrG,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"}

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.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,15 @@ 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; } });
 //# 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"}

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"}