network-ai 4.0.17 → 4.1.0

package/README.md

@@ -4,10 +4,10 @@
 
 [![CI](https://github.com/jovanSAPFIONEER/Network-AI/actions/workflows/ci.yml/badge.svg)](https://github.com/jovanSAPFIONEER/Network-AI/actions/workflows/ci.yml)
 [![CodeQL](https://github.com/jovanSAPFIONEER/Network-AI/actions/workflows/codeql.yml/badge.svg)](https://github.com/jovanSAPFIONEER/Network-AI/actions/workflows/codeql.yml)
-[![Release](https://img.shields.io/badge/release-v4.0.17-blue.svg)](https://github.com/jovanSAPFIONEER/Network-AI/releases)
+[![Release](https://img.shields.io/badge/release-v4.1.0-blue.svg)](https://github.com/jovanSAPFIONEER/Network-AI/releases)
 [![npm](https://img.shields.io/npm/dw/network-ai.svg?label=npm%20downloads)](https://www.npmjs.com/package/network-ai)
-[![Tests](https://img.shields.io/badge/tests-1184%20passing-brightgreen.svg)](#testing)
-[![Adapters](https://img.shields.io/badge/frameworks-12%20supported-blueviolet.svg)](#adapter-system)
+[![Tests](https://img.shields.io/badge/tests-1283%20passing-brightgreen.svg)](#testing)
+[![Adapters](https://img.shields.io/badge/frameworks-13%20supported-blueviolet.svg)](#adapter-system)
 [![License](https://img.shields.io/badge/license-MIT-brightgreen.svg)](LICENSE)
 [![Socket](https://socket.dev/api/badge/npm/package/network-ai)](https://socket.dev/npm/package/network-ai/overview)
 [![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org)
@@ -19,7 +19,13 @@ Network-AI is a TypeScript/Node.js multi-agent orchestrator that adds coordinati
 
 - **Shared blackboard with locking** — atomic `propose → validate → commit` prevents race conditions and split-brain failures across parallel agents
 - **Guardrails and budgets** — FSM governance, per-agent token ceilings, HMAC audit trails, and permission gating
-- **12 framework adapters** — LangChain, AutoGen, CrewAI, OpenAI Assistants, LlamaIndex, Semantic Kernel, and more in one orchestrator — no glue code, no lock-in
+- **13 adapters** — LangChain (+ streaming), AutoGen, CrewAI, OpenAI Assistants, LlamaIndex, Semantic Kernel, Haystack, DSPy, Agno, MCP, Custom (+ streaming), OpenClaw, and A2A — no glue code, no lock-in
+
+> **The silent failure mode in multi-agent systems:** parallel agents writing to the same key
+> use last-write-wins by default — one agent's result silently overwrites another's mid-flight.
+> The outcome is split-brain state: double-spends, contradictory decisions, corrupted context,
+> no error thrown. Network-AI's `propose → validate → commit` mutex prevents this at the
+> coordination layer, before any write reaches shared state.
 
 **Use Network-AI as:**
 - A **TypeScript/Node.js library** — `import { createSwarmOrchestrator } from 'network-ai'`
@@ -28,6 +34,15 @@ Network-AI is a TypeScript/Node.js multi-agent orchestrator that adds coordinati
 
 [**5-minute quickstart →**](QUICKSTART.md)  |  [**Architecture →**](ARCHITECTURE.md)  |  [**All adapters →**](#adapter-system)  |  [**Benchmarks →**](BENCHMARKS.md)
 
+> **Try the control-plane stress test — no API key, ~3 seconds:**
+> ```bash
+> npx ts-node examples/08-control-plane-stress-demo.ts
+> ```
+> Runs priority preemption, AuthGuardian permission gating, FSM governance, and compliance
+> monitoring against a live swarm. No external services required.
+>
+> If it saves you from a race condition, a ⭐ helps others find it.
+
 ---
 
 ## Why teams use Network-AI
@@ -37,7 +52,7 @@ Network-AI is a TypeScript/Node.js multi-agent orchestrator that adds coordinati
 | Race conditions in parallel agents | Atomic blackboard: `propose → validate → commit` with file-system mutex |
 | Agent overspend / runaway costs | `FederatedBudget` — hard per-agent token ceilings with live spend tracking |
 | No visibility into what agents did | HMAC-signed audit log on every write, permission grant, and FSM transition |
-| Locked into one AI framework | 12 adapters — mix LangChain + AutoGen + CrewAI + custom in one swarm |
+| Locked into one AI framework | 13 adapters — mix LangChain + AutoGen + CrewAI + A2A + custom in one swarm |
 | Agents escalating beyond their scope | `AuthGuardian` — scoped permission tokens required before sensitive operations |
 
 ---
@@ -90,6 +105,64 @@ No native dependencies, no build step. Adapters are dependency-free (BYOC — br
 
 ---
 
+## Use as MCP Server
+
+Start the server (no config required, zero dependencies):
+
+```bash
+npx network-ai-server --port 3001
+# or from source:
+npx ts-node bin/mcp-server.ts --port 3001
+```
+
+Then wire any MCP-compatible client to it.
+
+**Claude Desktop** — add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "network-ai": {
+      "url": "http://localhost:3001/sse"
+    }
+  }
+}
+```
+
+**Cursor / Cline / any SSE-based MCP client** — point to the same URL:
+
+```json
+{
+  "mcpServers": {
+    "network-ai": {
+      "url": "http://localhost:3001/sse"
+    }
+  }
+}
+```
+
+Verify it's running:
+
+```bash
+curl http://localhost:3001/health   # { "status": "ok", "tools": <n>, "uptime": <ms> }
+curl http://localhost:3001/tools    # full tool list
+```
+
+**Tools exposed over MCP:**
+- `blackboard_read` / `blackboard_write` / `blackboard_list` / `blackboard_delete` / `blackboard_exists`
+- `budget_status` / `budget_spend` / `budget_reset` — federated token tracking
+- `token_create` / `token_validate` / `token_revoke` — HMAC-signed permission tokens
+- `audit_query` — query the append-only audit log
+- `config_get` / `config_set` — live orchestrator configuration
+- `agent_list` / `agent_spawn` / `agent_stop` — agent lifecycle
+- `fsm_transition` — write FSM state transitions to the blackboard
+
+Each tool takes an `agent_id` parameter — all writes are identity-verified and namespace-scoped, exactly as they are in the TypeScript API.
+
+Options: `--no-budget`, `--no-token`, `--no-control`, `--ceiling <n>`, `--board <name>`, `--audit-log <path>`.
+
+---
+
 ## Two agents, one shared state — without race conditions
 
 The real differentiator is coordination. Here is what no single-framework solution handles: two agents writing to the same resource concurrently, atomically, without corrupting each other.
@@ -157,12 +230,12 @@ npm run demo -- --07
 
 ## Adapter System
 
-12 frameworks, zero adapter dependencies. You bring your own SDK objects.
+13 adapters, zero adapter dependencies. You bring your own SDK objects.
 
-| Adapter | Framework | Register method |
+| Adapter | Framework / Protocol | Register method |
 |---|---|---|
 | `CustomAdapter` | Any function or HTTP endpoint | `registerHandler(name, fn)` |
-| `LangChainAdapter` | LangChain | `registerRunnable(name, runnable)` |
+| `LangChainAdapter` | LangChain | `registerAgent(name, runnable)` |
 | `AutoGenAdapter` | AutoGen / AG2 | `registerAgent(name, agent)` |
 | `CrewAIAdapter` | CrewAI | `registerAgent` or `registerCrew` |
 | `MCPAdapter` | Model Context Protocol | `registerTool(name, handler)` |
@@ -173,8 +246,16 @@ npm run demo -- --07
 | `DSPyAdapter` | Stanford DSPy | `registerModule()`, `registerProgram()` |
 | `AgnoAdapter` | Agno (formerly Phidata) | `registerAgent()`, `registerTeam()` |
 | `OpenClawAdapter` | OpenClaw | `registerSkill(name, skillRef)` |
+| `A2AAdapter` | Google A2A Protocol | `registerRemoteAgent(name, url)` |
+
+**Streaming variants** (drop-in replacements with `.stream()` support):
 
-Extend `BaseAdapter` to add your own in minutes. See [references/adapter-system.md](references/adapter-system.md).
+| Adapter | Extends | Streaming source |
+|---|---|---|
+| `LangChainStreamingAdapter` | `LangChainAdapter` | Calls `.stream()` on the Runnable if available; falls back to `.invoke()` |
+| `CustomStreamingAdapter` | `CustomAdapter` | Pipes `AsyncIterable<string>` handlers; falls back to single-chunk for plain Promises |
+
+Extend `BaseAdapter` (or `StreamingBaseAdapter` for streaming) to add your own in minutes. See [references/adapter-system.md](references/adapter-system.md).
 
 ---
 
@@ -184,7 +265,7 @@ Extend `BaseAdapter` to add your own in minutes. See [references/adapter-system.
 
 | Capability | Network-AI | LangGraph | CrewAI | AutoGen |
 |---|---|---|---|---|
-| Cross-framework agents in one swarm | ✅ 12 built-in adapters | ⚠️ Nodes can call any code; no adapter abstraction | ⚠️ Extensible via tools; CrewAI-native agents only | ⚠️ Extensible via plugins; AutoGen-native agents only |
+| Cross-framework agents in one swarm | ✅ 13 built-in adapters | ⚠️ Nodes can call any code; no adapter abstraction | ⚠️ Extensible via tools; CrewAI-native agents only | ⚠️ Extensible via plugins; AutoGen-native agents only |
 | Atomic shared state (conflict-safe) | ✅ `propose → validate → commit` mutex | ⚠️ State passed between nodes; last-write-wins | ⚠️ Shared memory available; no conflict resolution | ⚠️ Shared context available; no conflict resolution |
 | Hard token ceiling per agent | ✅ `FederatedBudget` (first-class API) | ⚠️ Via callbacks / custom middleware | ⚠️ Via callbacks / custom middleware | ⚠️ Built-in token tracking in v0.4+; no swarm-level ceiling |
 | Permission gating before sensitive ops | ✅ `AuthGuardian` (built-in) | ⚠️ Possible via custom node logic | ⚠️ Possible via custom tools | ⚠️ Possible via custom middleware |
@@ -200,29 +281,31 @@ Extend `BaseAdapter` to add your own in minutes. See [references/adapter-system.
 npm run test:all          # All suites in sequence
 npm test                  # Core orchestrator
 npm run test:security     # Security module
-npm run test:adapters     # All 12 adapters
+npm run test:adapters     # All 13 adapters
+npm run test:streaming    # Streaming adapters
+npm run test:a2a          # A2A protocol adapter
 npm run test:priority     # Priority & preemption
 ```
 
-**1,184 passing assertions across 15 test suites** (verified by counting `assert()` / `pass()` calls in each file):
+**1,283 passing assertions across 15 test suites** (`npm run test:all`):
 
 | Suite | Assertions | Covers |
 |---|---|---|
-| `test-standalone.ts` | 83 | Blackboard, auth, integration, persistence, parallelisation, quality gate |
-| `test-adapters.ts` | 142 | All 12 adapters, registry routing, integration, edge cases |
-| `test-phase4.ts` | 133 | FSM, compliance monitor, adapter integration |
-| `test-phase5d.ts` | 119 | Pluggable backend |
-| `test-phase5f.ts` | 113 | Phase 5f extended |
-| `test-phase5g.ts` | 106 | Phase 5g extended |
-| `test-phase6.ts` | 122 | Latest feature coverage |
-| `test-phase5c.ts` | 74 | Named multi-blackboard |
-| `test-phase5e.ts` | 88 | Phase 5e |
-| `test-phase5b.ts` | 56 | Pluggable backend part 2 |
-| `test-priority.ts` | 65 | Priority preemption, conflict resolution, backward compat |
-| `test-security.ts` | 35 | Tokens, sanitization, rate limiting, encryption, audit |
-| `test-phase5.ts` | 24 | Named multi-blackboard base |
-| `test.ts` | 24 | Full integration |
-| `test-phase4.ts` (stubs) | 4 | FSM stub coverage |
+| `test-phase4.ts` | 147 | FSM governance, compliance monitor, adapter integration |
+| `test-phase5f.ts` | 127 | SSE transport, `McpCombinedBridge`, extended MCP tools |
+| `test-phase5g.ts` | 121 | CRDT backend, vector clocks, bidirectional sync |
+| `test-phase6.ts` | 121 | MCP server, control-plane tools, audit tools |
+| `test-phase5d.ts` | 117 | Pluggable backend (Redis, CRDT, Memory) |
+| `test-adapters.ts` | 139 | All 13 adapters, registry routing, integration, edge cases |
+| `test-standalone.ts` | 88 | Blackboard, auth, integration, persistence, parallelisation, quality gate |
+| `test-phase5e.ts` | 87 | Federated budget tracking |
+| `test-phase5c.ts` | 73 | Named multi-blackboard, isolation, backend options |
+| `test-priority.ts` | 64 | Priority preemption, conflict resolution, backward compat |
+| `test-a2a.ts` | 34 | A2A protocol: register, execute, mock fetch, error paths |
+| `test-streaming.ts` | 31 | Streaming adapters, chunk shapes, fallback, collectStream |
+| `test-phase5b.ts` | 55 | Pluggable backend part 2, consistency levels |
+| `test-phase5.ts` | 42 | Named multi-blackboard base |
+| `test-security.ts` | 34 | Tokens, sanitization, rate limiting, encryption, audit |
 
 ---
 
@@ -248,9 +331,6 @@ npm run test:priority     # Priority & preemption
 
 1. Fork → feature branch → `npm run test:all` → pull request
 2. Bugs and feature requests via [Issues](https://github.com/jovanSAPFIONEER/Network-AI/issues)
-3. If Network-AI saves you time, a ⭐ helps others find it
-
-[![Star on GitHub](https://img.shields.io/github/stars/jovanSAPFIONEER/Network-AI?style=social)](https://github.com/jovanSAPFIONEER/Network-AI)
 
 ---
 

package/dist/adapters/a2a-adapter.d.ts

@@ -0,0 +1,152 @@
+/**
+ * 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
+ */
+import { BaseAdapter } from './base-adapter';
+import type { AdapterConfig, AdapterCapabilities, AgentPayload, AgentContext, AgentResult } from '../types/agent-adapter';
+/** Agent Card served at /.well-known/agent.json (A2A spec §3.1) */
+export interface A2AAgentCard {
+    /** Human-readable agent name */
+    name: string;
+    /** Purpose / capabilities in plain English */
+    description?: string;
+    /** SemVer */
+    version?: string;
+    /** Protocol capabilities declared by the agent */
+    capabilities?: {
+        streaming?: boolean;
+        pushNotifications?: boolean;
+        stateTransitionHistory?: boolean;
+    };
+    /** URL that accepts A2A task envelopes (defaults to <baseUrl>/tasks) */
+    taskEndpoint?: string;
+    /** Agent homepage or further docs */
+    url?: string;
+}
+/** JSON-RPC 2.0 task request envelope sent to the task endpoint (A2A spec §4) */
+export interface A2ATask {
+    jsonrpc: '2.0';
+    id: string;
+    method: 'tasks/send';
+    params: {
+        id: string;
+        message: {
+            role: 'user';
+            parts: Array<{
+                type: 'text';
+                text: string;
+            }>;
+        };
+        metadata?: Record<string, unknown>;
+    };
+}
+/** State of a running A2A task */
+export type A2ATaskState = 'submitted' | 'working' | 'input-required' | 'completed' | 'canceled' | 'failed' | 'unknown';
+/** Artifact produced by the agent (A2A spec §4.3) */
+export interface A2AArtifact {
+    name?: string;
+    description?: string;
+    parts: Array<{
+        type: string;
+        text?: string;
+        data?: unknown;
+    }>;
+}
+/** JSON-RPC 2.0 task response (A2A spec §4) */
+export interface A2ATaskResponse {
+    jsonrpc: '2.0';
+    id: string;
+    result?: {
+        id: string;
+        status: {
+            state: A2ATaskState;
+            message?: string;
+        };
+        artifacts?: A2AArtifact[];
+        metadata?: Record<string, unknown>;
+    };
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+/** Adapter configuration specific to A2A */
+export interface A2AAdapterConfig extends AdapterConfig {
+    /** Default bearer token applied to all agents unless overridden at agent level */
+    defaultBearerToken?: string;
+    /** Default timeout for all agents in ms (default: 30 000) */
+    defaultTimeoutMs?: number;
+    /** Custom fetch implementation (for testing / node compat) */
+    fetchImpl?: typeof fetch;
+}
+export declare class A2AAdapter extends BaseAdapter {
+    readonly name = "a2a";
+    readonly version = "1.0.0";
+    private a2aAgents;
+    private defaultBearerToken?;
+    private defaultTimeoutMs;
+    private fetchImpl;
+    get capabilities(): AdapterCapabilities;
+    initialize(config: A2AAdapterConfig): Promise<void>;
+    /**
+     * 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
+     */
+    registerRemoteAgent(agentId: string, baseUrl: string, options?: {
+        bearerToken?: string;
+        timeoutMs?: number;
+    }): Promise<void>;
+    /**
+     * 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: string, card: A2AAgentCard & {
+        taskEndpoint: string;
+    }, options?: {
+        bearerToken?: string;
+        timeoutMs?: number;
+    }): void;
+    executeAgent(agentId: string, payload: AgentPayload, context: AgentContext): Promise<AgentResult>;
+    private fetchAgentCard;
+    private sendTask;
+    private extractOutput;
+}
+//# sourceMappingURL=a2a-adapter.d.ts.map

package/dist/adapters/a2a-adapter.d.ts.map

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

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