@sprinterai/runtime 0.3.0 → 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sprinter AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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

@@ -1,24 +1,52 @@
+import type { DiscoveredAgent } from '@sprinterai/core';
 /** Configuration for an A2A (Agent-to-Agent) connection. */
 export interface A2AAdapterConfig {
     /** The A2A endpoint URL. */
     endpointUrl: string;
     /** Authentication token. */
     authToken?: string;
-    /** Agent card metadata if known. */
+    /** Agent card metadata if already known (skips discovery). */
     agentCard?: {
         name: string;
         description: string;
         skills: string[];
     };
+    /** Request timeout in milliseconds (default: 60000). */
+    timeoutMs?: number;
 }
+/** Input for sending a task to an A2A agent. */
+export interface A2ATaskInput {
+    /** The message text to send. */
+    message: string;
+    /** Optional session ID for multi-turn conversations. */
+    sessionId?: string;
+    /** Optional context/metadata to include. */
+    context?: Record<string, unknown>;
+}
+/** Result from an A2A task execution. */
+export interface A2ATaskResult {
+    /** Task ID assigned by the remote agent. */
+    taskId: string;
+    /** Current task status. */
+    status: 'completed' | 'failed' | 'pending' | 'working';
+    /** Task output artifacts. */
+    output?: unknown;
+    /** Error message if failed. */
+    error?: string;
+}
+/** Callable A2A agent endpoint. */
+export interface A2AAgentEndpoint {
+    /** Discovered agent metadata. */
+    agentCard: DiscoveredAgent;
+    /** Send a task/message to the remote agent. */
+    sendTask(input: A2ATaskInput): Promise<A2ATaskResult>;
+}
+/**
+ * Discover an A2A agent's capabilities via the well-known agent card endpoint.
+ */
+export declare function discoverA2AAgent(config: A2AAdapterConfig): Promise<DiscoveredAgent>;
 /**
- * Adapter for A2A protocol connections.
- *
- * A2A enables cross-platform agent communication using a standard protocol.
- * This adapter wraps an A2A endpoint as a callable agent.
- *
- * Note: A2A support requires the @google/a2a-sdk or compatible library.
- * Throws if not configured.
+ * Create an A2A agent endpoint. Discovers the agent card and returns a callable interface.
  */
-export declare function createA2AAgent(_config: A2AAdapterConfig): Promise<never>;
+export declare function createA2AAgent(config: A2AAdapterConfig): Promise<A2AAgentEndpoint>;
 //# sourceMappingURL=a2a-adapter.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"a2a-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/a2a-adapter.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,MAAM,WAAW,gBAAgB;IAC/B,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,SAAS,CAAC,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;CACH;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,KAAK,CAAC,CAIhB"}
+{"version":3,"file":"a2a-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/a2a-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD,4DAA4D;AAC5D,MAAM,WAAW,gBAAgB;IAC/B,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,SAAS,CAAC,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;IACF,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,gDAAgD;AAChD,MAAM,WAAW,YAAY;IAC3B,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;IACvD,6BAA6B;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,mCAAmC;AACnC,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,SAAS,EAAE,eAAe,CAAC;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACvD;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CA8CzF;AAOD;;GAEG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA2FxF"}

package/dist/adapters/a2a-adapter.js

@@ -1,13 +1,136 @@
 /**
- * Adapter for A2A protocol connections.
- *
- * A2A enables cross-platform agent communication using a standard protocol.
- * This adapter wraps an A2A endpoint as a callable agent.
- *
- * Note: A2A support requires the @google/a2a-sdk or compatible library.
- * Throws if not configured.
+ * Discover an A2A agent's capabilities via the well-known agent card endpoint.
  */
-export async function createA2AAgent(_config) {
-    throw new Error("A2A adapter not configured. Install an A2A client library and provide it to the adapter.");
+export async function discoverA2AAgent(config) {
+    if (config.agentCard) {
+        return {
+            externalAgentId: config.endpointUrl,
+            name: config.agentCard.name,
+            description: config.agentCard.description,
+            metadata: { skills: config.agentCard.skills },
+            alreadyImported: false,
+        };
+    }
+    try {
+        const baseUrl = new URL(config.endpointUrl);
+        const cardUrl = `${baseUrl.origin}/.well-known/agent.json`;
+        const headers = {};
+        if (config.authToken) {
+            headers['Authorization'] = `Bearer ${config.authToken}`;
+        }
+        const response = await fetch(cardUrl, { headers });
+        if (!response.ok) {
+            return {
+                externalAgentId: config.endpointUrl,
+                name: 'Unknown Agent',
+                description: 'Agent card not available',
+                alreadyImported: false,
+            };
+        }
+        const raw = await response.json();
+        const card = typeof raw === 'object' && raw !== null ? raw : {};
+        return {
+            externalAgentId: card.url ?? config.endpointUrl,
+            name: card.name ?? 'Unknown',
+            description: card.description ?? '',
+            metadata: card,
+            alreadyImported: false,
+        };
+    }
+    catch {
+        return {
+            externalAgentId: config.endpointUrl,
+            name: 'Unknown Agent',
+            description: 'Agent card discovery failed',
+            alreadyImported: false,
+        };
+    }
+}
+/** Generate a unique request ID for JSON-RPC calls. */
+function generateRequestId() {
+    return `a2a-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+}
+/**
+ * Create an A2A agent endpoint. Discovers the agent card and returns a callable interface.
+ */
+export async function createA2AAgent(config) {
+    const agentCard = await discoverA2AAgent(config);
+    const timeoutMs = config.timeoutMs ?? 60_000;
+    return {
+        agentCard,
+        async sendTask(input) {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+            try {
+                const headers = {
+                    'Content-Type': 'application/json',
+                    Accept: 'application/json',
+                };
+                if (config.authToken) {
+                    headers['Authorization'] = `Bearer ${config.authToken}`;
+                }
+                const response = await fetch(config.endpointUrl, {
+                    method: 'POST',
+                    headers,
+                    // AbortController.signal type varies across Node.js/DOM environments
+                    signal: controller.signal,
+                    body: JSON.stringify({
+                        jsonrpc: '2.0',
+                        method: 'tasks/send',
+                        params: {
+                            message: {
+                                role: 'user',
+                                parts: [{ type: 'text', text: input.message }],
+                            },
+                            ...(input.sessionId ? { sessionId: input.sessionId } : {}),
+                            ...(input.context ? { metadata: input.context } : {}),
+                        },
+                        id: generateRequestId(),
+                    }),
+                });
+                if (!response.ok) {
+                    return {
+                        taskId: '',
+                        status: 'failed',
+                        error: `A2A request failed with HTTP ${response.status}`,
+                    };
+                }
+                const contentType = response.headers.get('content-type') ?? '';
+                if (!contentType.includes('application/json')) {
+                    return {
+                        taskId: '',
+                        status: 'failed',
+                        error: `Unexpected content-type from A2A endpoint: ${contentType}`,
+                    };
+                }
+                const raw = await response.json();
+                const result = typeof raw === 'object' && raw !== null ? raw : {};
+                if (result.error) {
+                    const err = typeof result.error === 'object' && result.error !== null
+                        ? result.error
+                        : {};
+                    return {
+                        taskId: '',
+                        status: 'failed',
+                        error: err.message ?? 'Unknown A2A error',
+                    };
+                }
+                const taskResult = typeof result.result === 'object' && result.result !== null
+                    ? result.result
+                    : undefined;
+                const status = typeof taskResult?.status === 'object' && taskResult?.status !== null
+                    ? taskResult.status
+                    : undefined;
+                return {
+                    taskId: taskResult?.id ?? '',
+                    status: (status?.state ?? 'pending'),
+                    output: taskResult?.artifacts,
+                };
+            }
+            finally {
+                clearTimeout(timeoutId);
+            }
+        },
+    };
 }
 //# sourceMappingURL=a2a-adapter.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"a2a-adapter.js","sourceRoot":"","sources":["../../src/adapters/a2a-adapter.ts"],"names":[],"mappings":"AAcA;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAyB;IAEzB,MAAM,IAAI,KAAK,CACb,0FAA0F,CAC3F,CAAC;AACJ,CAAC"}
+{"version":3,"file":"a2a-adapter.js","sourceRoot":"","sources":["../../src/adapters/a2a-adapter.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=a2a-adapter.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-adapter.test.d.ts","sourceRoot":"","sources":["../../src/adapters/a2a-adapter.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,295 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { createA2AAgent, discoverA2AAgent } from './a2a-adapter.js';
+/** Create a minimal mock Response compatible with the adapter's usage. */
+function mockFetchResponse(body, options) {
+    const status = options?.status ?? 200;
+    const contentType = options?.contentType ?? 'application/json';
+    const headers = new Headers({ 'content-type': contentType });
+    return vi.fn().mockResolvedValue({
+        ok: status >= 200 && status < 300,
+        status,
+        headers,
+        json: () => Promise.resolve(body),
+        text: () => Promise.resolve(typeof body === 'string' ? body : JSON.stringify(body)),
+    });
+}
+describe('discoverA2AAgent', () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('returns agent card from pre-supplied config (no fetch needed)', async () => {
+        const mockFetch = mockFetchResponse({});
+        vi.stubGlobal('fetch', mockFetch);
+        const config = {
+            endpointUrl: 'https://agent.example.com/a2a',
+            agentCard: {
+                name: 'Test Agent',
+                description: 'A test agent',
+                skills: ['search', 'summarize'],
+            },
+        };
+        const result = await discoverA2AAgent(config);
+        expect(result.name).toBe('Test Agent');
+        expect(result.description).toBe('A test agent');
+        expect(result.externalAgentId).toBe('https://agent.example.com/a2a');
+        expect(result.metadata).toEqual({ skills: ['search', 'summarize'] });
+        expect(result.alreadyImported).toBe(false);
+        // fetch should NOT be called when agentCard is pre-supplied
+        expect(mockFetch).not.toHaveBeenCalled();
+    });
+    it('discovers agent via .well-known/agent.json endpoint', async () => {
+        const cardResponse = {
+            url: 'https://agent.example.com/endpoint',
+            name: 'Remote Agent',
+            description: 'A remote agent',
+            version: '1.0',
+        };
+        const mockFetch = mockFetchResponse(cardResponse);
+        vi.stubGlobal('fetch', mockFetch);
+        const result = await discoverA2AAgent({
+            endpointUrl: 'https://agent.example.com/a2a',
+        });
+        expect(result.name).toBe('Remote Agent');
+        expect(result.description).toBe('A remote agent');
+        expect(result.externalAgentId).toBe('https://agent.example.com/endpoint');
+        expect(result.metadata).toEqual(cardResponse);
+        expect(mockFetch).toHaveBeenCalledOnce();
+        const [url] = mockFetch.mock.calls[0];
+        expect(url).toBe('https://agent.example.com/.well-known/agent.json');
+    });
+    it('returns fallback on non-ok response from .well-known endpoint', async () => {
+        const mockFetch = mockFetchResponse({}, { status: 404 });
+        vi.stubGlobal('fetch', mockFetch);
+        const result = await discoverA2AAgent({
+            endpointUrl: 'https://agent.example.com/a2a',
+        });
+        expect(result.name).toBe('Unknown Agent');
+        expect(result.description).toBe('Agent card not available');
+        expect(result.externalAgentId).toBe('https://agent.example.com/a2a');
+    });
+    it('returns fallback on network error', async () => {
+        vi.stubGlobal('fetch', vi.fn().mockRejectedValue(new Error('Network unreachable')));
+        const result = await discoverA2AAgent({
+            endpointUrl: 'https://agent.example.com/a2a',
+        });
+        expect(result.name).toBe('Unknown Agent');
+        expect(result.description).toBe('Agent card discovery failed');
+        expect(result.externalAgentId).toBe('https://agent.example.com/a2a');
+    });
+    it('handles non-object JSON response (null)', async () => {
+        const mockFetch = mockFetchResponse(null);
+        vi.stubGlobal('fetch', mockFetch);
+        const result = await discoverA2AAgent({
+            endpointUrl: 'https://agent.example.com/a2a',
+        });
+        // null is not an object, so the guard falls back to empty object
+        expect(result.name).toBe('Unknown');
+        expect(result.description).toBe('');
+        expect(result.externalAgentId).toBe('https://agent.example.com/a2a');
+    });
+    it('handles non-object JSON response (array)', async () => {
+        const mockFetch = mockFetchResponse(['not', 'an', 'object']);
+        vi.stubGlobal('fetch', mockFetch);
+        const result = await discoverA2AAgent({
+            endpointUrl: 'https://agent.example.com/a2a',
+        });
+        // Arrays pass typeof === 'object' and !== null check, so are treated as Record
+        // With no .name or .description properties, defaults kick in
+        expect(result.name).toBe('Unknown');
+        expect(result.description).toBe('');
+    });
+    it('includes auth token in discovery request headers', async () => {
+        const mockFetch = mockFetchResponse({ name: 'Secure Agent' });
+        vi.stubGlobal('fetch', mockFetch);
+        await discoverA2AAgent({
+            endpointUrl: 'https://agent.example.com/a2a',
+            authToken: 'secret-token',
+        });
+        const [, options] = mockFetch.mock.calls[0];
+        const headers = options.headers;
+        expect(headers['Authorization']).toBe('Bearer secret-token');
+    });
+});
+describe('createA2AAgent', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+        vi.useRealTimers();
+    });
+    it('returns endpoint with discovered agent card', async () => {
+        const mockFetch = mockFetchResponse({});
+        vi.stubGlobal('fetch', mockFetch);
+        const agent = await createA2AAgent({
+            endpointUrl: 'https://agent.example.com/a2a',
+            agentCard: {
+                name: 'My Agent',
+                description: 'Does things',
+                skills: ['chat'],
+            },
+        });
+        expect(agent.agentCard.name).toBe('My Agent');
+        expect(agent.agentCard.description).toBe('Does things');
+        expect(typeof agent.sendTask).toBe('function');
+    });
+});
+describe('sendTask', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+        vi.useRealTimers();
+    });
+    /** Helper: create an A2A agent with pre-supplied card and custom fetch mock for sendTask. */
+    async function createAgentWithMock(taskFetch, config) {
+        // First call is for discovery (skipped via agentCard), second is for sendTask
+        vi.stubGlobal('fetch', taskFetch);
+        return createA2AAgent({
+            endpointUrl: 'https://agent.example.com/a2a',
+            agentCard: { name: 'Test', description: 'Test agent', skills: [] },
+            ...config,
+        });
+    }
+    it('formats JSON-RPC 2.0 correctly', async () => {
+        const rpcResponse = {
+            jsonrpc: '2.0',
+            result: {
+                id: 'task-1',
+                status: { state: 'completed' },
+                artifacts: [{ text: 'result' }],
+            },
+            id: 'req-1',
+        };
+        const mockFetch = mockFetchResponse(rpcResponse);
+        const agent = await createAgentWithMock(mockFetch);
+        await agent.sendTask({ message: 'Hello', sessionId: 'sess-1', context: { key: 'val' } });
+        const [url, options] = mockFetch.mock.calls[0];
+        expect(url).toBe('https://agent.example.com/a2a');
+        expect(options.method).toBe('POST');
+        const body = JSON.parse(options.body);
+        expect(body.jsonrpc).toBe('2.0');
+        expect(body.method).toBe('tasks/send');
+        expect(typeof body.id).toBe('string');
+        const params = body.params;
+        const message = params.message;
+        expect(message.role).toBe('user');
+        expect(message.parts).toEqual([{ type: 'text', text: 'Hello' }]);
+        expect(params.sessionId).toBe('sess-1');
+        expect(params.metadata).toEqual({ key: 'val' });
+    });
+    it('omits sessionId and metadata when not provided', async () => {
+        const rpcResponse = {
+            jsonrpc: '2.0',
+            result: { id: 'task-2', status: { state: 'completed' } },
+            id: 'req-2',
+        };
+        const mockFetch = mockFetchResponse(rpcResponse);
+        const agent = await createAgentWithMock(mockFetch);
+        await agent.sendTask({ message: 'Just a message' });
+        const body = JSON.parse(mockFetch.mock.calls[0][1].body);
+        const params = body.params;
+        expect(params.sessionId).toBeUndefined();
+        expect(params.metadata).toBeUndefined();
+    });
+    it('returns structured error on non-ok HTTP response', async () => {
+        const mockFetch = mockFetchResponse('Server Error', { status: 500 });
+        const agent = await createAgentWithMock(mockFetch);
+        const result = await agent.sendTask({ message: 'test' });
+        expect(result.taskId).toBe('');
+        expect(result.status).toBe('failed');
+        expect(result.error).toBe('A2A request failed with HTTP 500');
+    });
+    it('returns structured error on non-JSON content-type', async () => {
+        const mockFetch = mockFetchResponse('not json', { contentType: 'text/html' });
+        const agent = await createAgentWithMock(mockFetch);
+        const result = await agent.sendTask({ message: 'test' });
+        expect(result.taskId).toBe('');
+        expect(result.status).toBe('failed');
+        expect(result.error).toContain('Unexpected content-type');
+        expect(result.error).toContain('text/html');
+    });
+    it('handles JSON-RPC error response', async () => {
+        const rpcError = {
+            jsonrpc: '2.0',
+            error: { code: -32600, message: 'Invalid request' },
+            id: 'req-3',
+        };
+        const mockFetch = mockFetchResponse(rpcError);
+        const agent = await createAgentWithMock(mockFetch);
+        const result = await agent.sendTask({ message: 'bad request' });
+        expect(result.taskId).toBe('');
+        expect(result.status).toBe('failed');
+        expect(result.error).toBe('Invalid request');
+    });
+    it('handles JSON-RPC error with non-object error field', async () => {
+        const rpcError = {
+            jsonrpc: '2.0',
+            error: 'something went wrong',
+            id: 'req-4',
+        };
+        const mockFetch = mockFetchResponse(rpcError);
+        const agent = await createAgentWithMock(mockFetch);
+        const result = await agent.sendTask({ message: 'test' });
+        expect(result.status).toBe('failed');
+        expect(result.error).toBe('Unknown A2A error');
+    });
+    it('handles malformed JSON-RPC result (null/undefined fields)', async () => {
+        // result is missing id, status, artifacts
+        const rpcResponse = {
+            jsonrpc: '2.0',
+            result: {},
+            id: 'req-5',
+        };
+        const mockFetch = mockFetchResponse(rpcResponse);
+        const agent = await createAgentWithMock(mockFetch);
+        const result = await agent.sendTask({ message: 'test' });
+        expect(result.taskId).toBe('');
+        expect(result.status).toBe('pending');
+        expect(result.output).toBeUndefined();
+    });
+    it('handles null result field gracefully', async () => {
+        const rpcResponse = {
+            jsonrpc: '2.0',
+            result: null,
+            id: 'req-6',
+        };
+        const mockFetch = mockFetchResponse(rpcResponse);
+        const agent = await createAgentWithMock(mockFetch);
+        const result = await agent.sendTask({ message: 'test' });
+        // null result -> taskResult is undefined, so defaults apply
+        expect(result.taskId).toBe('');
+        expect(result.status).toBe('pending');
+    });
+    it('includes auth token in sendTask request headers', async () => {
+        const rpcResponse = {
+            jsonrpc: '2.0',
+            result: { id: 'task-x', status: { state: 'completed' } },
+        };
+        const mockFetch = mockFetchResponse(rpcResponse);
+        const agent = await createAgentWithMock(mockFetch, { authToken: 'bearer-token' });
+        await agent.sendTask({ message: 'test' });
+        const [, options] = mockFetch.mock.calls[0];
+        const headers = options.headers;
+        expect(headers['Authorization']).toBe('Bearer bearer-token');
+    });
+    it('returns completed task with artifacts', async () => {
+        const artifacts = [{ type: 'text', text: 'Generated content' }];
+        const rpcResponse = {
+            jsonrpc: '2.0',
+            result: {
+                id: 'task-42',
+                status: { state: 'completed' },
+                artifacts,
+            },
+        };
+        const mockFetch = mockFetchResponse(rpcResponse);
+        const agent = await createAgentWithMock(mockFetch);
+        const result = await agent.sendTask({ message: 'generate something' });
+        expect(result.taskId).toBe('task-42');
+        expect(result.status).toBe('completed');
+        expect(result.output).toEqual(artifacts);
+    });
+});
+//# sourceMappingURL=a2a-adapter.test.js.map

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

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

package/dist/adapters/http-agent-adapter.d.ts

@@ -3,20 +3,30 @@ export interface HTTPAgentAdapterConfig {
     /** The HTTP endpoint URL. */
     endpointUrl: string;
     /** HTTP method (default: POST). */
-    method?: "GET" | "POST";
+    method?: 'GET' | 'POST';
     /** Custom headers. */
     headers?: Record<string, string>;
     /** Authentication token (added as Bearer token). */
     authToken?: string;
+    /** Request timeout in milliseconds (default: 30000). */
+    timeoutMs?: number;
+}
+/** Response from an HTTP agent endpoint. */
+export interface HTTPAgentResponse {
+    status: number;
+    data: unknown;
+    headers: Record<string, string>;
+}
+/** Callable HTTP agent endpoint. */
+export interface HTTPAgentEndpoint {
+    /** Send a message/payload to the agent and receive a response. */
+    send(input: Record<string, unknown>): Promise<HTTPAgentResponse>;
+    /** The endpoint configuration. */
+    readonly config: HTTPAgentAdapterConfig;
 }
 /**
- * Adapter for generic HTTP agent endpoints.
- *
- * Wraps any HTTP endpoint that accepts JSON and returns JSON
- * as a callable agent interface.
- *
- * Note: This is a stub. Implement with your preferred HTTP client.
- * Throws if not configured.
+ * Create a callable HTTP agent endpoint.
+ * Wraps any HTTP endpoint that accepts/returns JSON as a callable agent interface.
  */
-export declare function createHTTPAgent(_config: HTTPAgentAdapterConfig): Promise<never>;
+export declare function createHTTPAgent(config: HTTPAgentAdapterConfig): HTTPAgentEndpoint;
 //# sourceMappingURL=http-agent-adapter.d.ts.map

package/dist/adapters/http-agent-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-agent-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/http-agent-adapter.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,MAAM,WAAW,sBAAsB;IACrC,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,KAAK,CAAC,CAIhB"}
+{"version":3,"file":"http-agent-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/http-agent-adapter.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,MAAM,WAAW,sBAAsB;IACrC,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,4CAA4C;AAC5C,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,oCAAoC;AACpC,MAAM,WAAW,iBAAiB;IAChC,kEAAkE;IAClE,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACjE,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;CACzC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,sBAAsB,GAAG,iBAAiB,CA8DjF"}