@cogitator-ai/a2a 0.7.8 → 0.8.0

package/dist/adapters/next.js

@@ -1,59 +1,83 @@
 import { createErrorResponse } from '../json-rpc.js';
 import * as errors from '../errors.js';
-import { isStreamRequest, pipeJsonRpcStream, SSE_HEADERS } from './shared.js';
+import { AGENT_CARD_PATH } from '../types.js';
+import { handleA2AHttp } from './shared.js';
+import { trimTrailingSlashes } from '../url.js';
+async function agentParam(context) {
+    const params = await context?.params;
+    const agent = params?.agent;
+    return Array.isArray(agent) ? agent[0] : agent;
+}
+function toResponse(response, abort) {
+    switch (response.kind) {
+        case 'json':
+            return Response.json(response.body, { status: response.status, headers: response.headers });
+        case 'empty':
+            return new Response(null, { status: response.status });
+        case 'pass':
+            return Response.json(createErrorResponse(null, errors.invalidRequest('Not an A2A route')), {
+                status: 404,
+            });
+        case 'sse': {
+            const encoder = new TextEncoder();
+            const stream = new ReadableStream({
+                async start(controller) {
+                    await response.pipe((frame) => {
+                        if (!abort.signal.aborted)
+                            controller.enqueue(encoder.encode(frame));
+                    });
+                    try {
+                        controller.close();
+                    }
+                    catch {
+                        return;
+                    }
+                },
+                cancel() {
+                    abort.abort();
+                },
+            });
+            return new Response(stream, { headers: response.headers });
+        }
+    }
+}
+/**
+ * Next.js App Router handlers for an A2A server. Export `GET` from the route that serves
+ * `/.well-known/agent-card.json` and `POST` from the route at `basePath`. In a dynamic
+ * `[agent]` route they serve that agent's own card and endpoint.
+ */
 export function a2aNext(server) {
+    const base = trimTrailingSlashes(server.basePath);
+    const serve = async (request, relativePath, method) => {
+        const controller = new AbortController();
+        request.signal?.addEventListener('abort', () => controller.abort(), { once: true });
+        try {
+            const response = await handleA2AHttp(server, {
+                method,
+                path: relativePath,
+                mountUrl: new URL(request.url).origin,
+                header: (name) => request.headers.get(name),
+                readBody: () => request.json(),
+                signal: controller.signal,
+            });
+            return toResponse(response, controller);
+        }
+        catch (error) {
+            return Response.json(createErrorResponse(null, errors.clientJsonRpcError(error, 'A2A request failed')));
+        }
+    };
     return {
-        async GET() {
-            const cards = server.getAgentCards();
-            return Response.json(cards.length === 1 ? cards[0] : cards);
+        async GET(request, context) {
+            const agent = await agentParam(context);
+            const path = agent
+                ? `${base}/${encodeURIComponent(agent)}${AGENT_CARD_PATH}`
+                : AGENT_CARD_PATH;
+            return serve(request, path, 'GET');
         },
-        async POST(request) {
-            const contentType = request.headers.get('content-type');
-            if (contentType && !contentType.startsWith('application/json')) {
-                return Response.json(createErrorResponse(null, errors.contentTypeNotSupported(contentType)));
-            }
-            let body;
-            try {
-                body = await request.json();
-            }
-            catch {
-                return Response.json(createErrorResponse(null, errors.parseError('Invalid JSON body')));
-            }
-            const authToken = server.getAuthToken((name) => request.headers.get(name));
-            if (isStreamRequest(body)) {
-                const encoder = new TextEncoder();
-                const controller = new AbortController();
-                const abort = () => controller.abort();
-                request.signal?.addEventListener('abort', abort, { once: true });
-                const stream = new ReadableStream({
-                    async start(streamController) {
-                        await pipeJsonRpcStream(server, body, authToken, controller.signal, (frame) => {
-                            streamController.enqueue(encoder.encode(frame));
-                        });
-                        request.signal?.removeEventListener('abort', abort);
-                        try {
-                            streamController.close();
-                        }
-                        catch {
-                            return;
-                        }
-                    },
-                    cancel() {
-                        controller.abort();
-                    },
-                });
-                return new Response(stream, { headers: SSE_HEADERS });
-            }
-            try {
-                const response = await server.handleJsonRpc(body, authToken);
-                if (response === null) {
-                    return new Response(null, { status: 204 });
-                }
-                return Response.json(response);
-            }
-            catch (error) {
-                return Response.json(createErrorResponse(null, errors.clientJsonRpcError(error, 'A2A request failed')));
-            }
+        async POST(request, context) {
+            const agent = await agentParam(context);
+            const path = agent ? `${base}/${encodeURIComponent(agent)}` : server.basePath;
+            return serve(request, path, 'POST');
         },
     };
 }

package/dist/adapters/next.js.map

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

package/dist/adapters/shared.d.ts

@@ -1,18 +1,51 @@
 import type { A2AServer } from '../server.js';
-import type { A2AStreamEvent } from '../types.js';
+import { type JsonRpcResponse } from '../json-rpc.js';
 export type HeaderValue = string | string[] | null | undefined;
+export declare function firstHeader(value: HeaderValue): string | undefined;
+export declare const SSE_HEADERS: Record<string, string>;
 /**
- * A request streams only for the `message/stream` method; the Accept header
- * alone does not switch a `message/send` request to SSE.
+ * A request streams when its method is `message/stream` or `tasks/resubscribe`; the Accept
+ * header alone does not switch another method to SSE.
  */
 export declare function isStreamRequest(body: unknown): boolean;
-export declare function firstHeader(value: HeaderValue): string | undefined;
-export declare function sseFrame(data: A2AStreamEvent | '[DONE]'): string;
-export declare const SSE_HEADERS: Record<string, string>;
+/** One SSE event carrying a JSON-RPC response (A2A v0.3, section 3.3.1). */
+export declare function sseFrame(response: JsonRpcResponse): string;
+/** A request as a framework adapter hands it over. */
+export interface A2AHttpRequest {
+    method: string;
+    /** The path relative to where the adapter is mounted, e.g. `/a2a` */
+    path: string;
+    /** Absolute URL the adapter is mounted at (origin plus mount path), for the cards' `url` */
+    mountUrl: string;
+    header(name: string): string | null | undefined;
+    /** The parsed JSON body; throws a SyntaxError when the body is not JSON */
+    readBody(): Promise<unknown>;
+    /** Aborted when the client disconnects */
+    signal: AbortSignal;
+}
+/** What the adapter sends back. */
+export type A2AHttpResponse = {
+    kind: 'json';
+    status: number;
+    headers: Record<string, string>;
+    body: unknown;
+} | {
+    kind: 'empty';
+    status: number;
+} | {
+    kind: 'sse';
+    headers: Record<string, string>;
+    /** Write the stream's frames until it ends or the client disconnects */
+    pipe(write: (frame: string) => void | Promise<void>): Promise<void>;
+} | {
+    kind: 'pass';
+};
 /**
- * Drive a JSON-RPC stream and write SSE frames until it ends, the client
- * disconnects (signal aborted) or a write fails. Errors are reported as a
- * final failed status-update frame.
+ * Serve an A2A request: the Agent Cards and the JSON-RPC endpoints, with streams as SSE where
+ * every event is a JSON-RPC response. Errors before a stream starts are answered as a plain
+ * JSON-RPC error, with HTTP 401 for missing or rejected credentials.
  */
-export declare function pipeJsonRpcStream(server: A2AServer, body: unknown, authToken: string | undefined, signal: AbortSignal, write: (frame: string) => void | Promise<void>): Promise<void>;
+export declare function handleA2AHttp(server: A2AServer, request: A2AHttpRequest): Promise<A2AHttpResponse>;
+/** The URL an adapter is mounted at, from the full request URL and the path relative to the mount. */
+export declare function mountUrlOf(requestUrl: URL, relativePath: string): string;
 //# sourceMappingURL=shared.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/adapters/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAOtD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAGlE;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,QAAQ,GAAG,MAAM,CAEhE;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAK9C,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,OAAO,EACb,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAC7C,OAAO,CAAC,IAAI,CAAC,CAef"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/adapters/shared.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAK3E,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;AAE/D,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAGlE;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAK9C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAItD;AAED,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAE1D;AAED,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,4FAA4F;IAC5F,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAChD,2EAA2E;IAC3E,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,0CAA0C;IAC1C,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,mCAAmC;AACnC,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAChF;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACjC;IACE,IAAI,EAAE,KAAK,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,wEAAwE;IACxE,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrE,GACD;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AA8DrB;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC,CA+D1B;AA0CD,sGAAsG;AACtG,wBAAgB,UAAU,CAAC,UAAU,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAMxE"}

package/dist/adapters/shared.js

@@ -1,22 +1,14 @@
-import { buildSseErrorEvent } from './sse-error-event.js';
-/**
- * A request streams only for the `message/stream` method; the Accept header
- * alone does not switch a `message/send` request to SSE.
- */
-export function isStreamRequest(body) {
-    return (typeof body === 'object' &&
-        body !== null &&
-        !Array.isArray(body) &&
-        body.method === 'message/stream');
-}
+import { encodeHeartbeat, startHeartbeat } from '@cogitator-ai/server-shared';
+import { STREAMING_METHODS } from '../server.js';
+import { createErrorResponse } from '../json-rpc.js';
+import * as errors from '../errors.js';
+import { AGENT_CARD_PATH, LEGACY_AGENT_CARD_PATH } from '../types.js';
+import { trimTrailingSlashes } from '../url.js';
 export function firstHeader(value) {
     if (Array.isArray(value))
         return value[0];
     return value ?? undefined;
 }
-export function sseFrame(data) {
-    return `data: ${typeof data === 'string' ? data : JSON.stringify(data)}\n\n`;
-}
 export const SSE_HEADERS = {
     'Content-Type': 'text/event-stream',
     'Cache-Control': 'no-cache',
@@ -24,29 +16,170 @@ export const SSE_HEADERS = {
     'X-Accel-Buffering': 'no',
 };
 /**
- * Drive a JSON-RPC stream and write SSE frames until it ends, the client
- * disconnects (signal aborted) or a write fails. Errors are reported as a
- * final failed status-update frame.
+ * A request streams when its method is `message/stream` or `tasks/resubscribe`; the Accept
+ * header alone does not switch another method to SSE.
+ */
+export function isStreamRequest(body) {
+    if (typeof body !== 'object' || body === null || Array.isArray(body))
+        return false;
+    const method = body.method;
+    return typeof method === 'string' && STREAMING_METHODS.includes(method);
+}
+/** One SSE event carrying a JSON-RPC response (A2A v0.3, section 3.3.1). */
+export function sseFrame(response) {
+    return `data: ${JSON.stringify(response)}\n\n`;
+}
+function agentNameFrom(segment) {
+    try {
+        return decodeURIComponent(segment);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The A2A route a request path names: the Agent Card at the well-known path, the pre-v0.3 card
+ * path, the shared JSON-RPC endpoint at `basePath`, or one agent's endpoint and card under
+ * `<basePath>/<agent name>`.
+ */
+function matchRoute(server, method, path) {
+    const basePath = trimTrailingSlashes(server.basePath) || '';
+    if (method === 'GET') {
+        if (path === AGENT_CARD_PATH)
+            return { kind: 'card' };
+        if (path === LEGACY_AGENT_CARD_PATH)
+            return { kind: 'legacy-card' };
+        const prefix = `${basePath}/`;
+        if (path.startsWith(prefix) && path.endsWith(AGENT_CARD_PATH)) {
+            const segment = path.slice(prefix.length, path.length - AGENT_CARD_PATH.length);
+            const agentName = segment.includes('/') ? null : agentNameFrom(segment);
+            if (agentName)
+                return { kind: 'card', agentName };
+        }
+        return null;
+    }
+    if (method === 'POST') {
+        if (path === server.basePath || path === basePath)
+            return { kind: 'rpc' };
+        const prefix = `${basePath}/`;
+        if (path.startsWith(prefix)) {
+            const segment = path.slice(prefix.length).replace(/\/$/, '');
+            const agentName = segment && !segment.includes('/') ? agentNameFrom(segment) : null;
+            if (agentName)
+                return { kind: 'rpc', agentName };
+        }
+    }
+    return null;
+}
+function json(status, body, headers = {}) {
+    return { kind: 'json', status, headers, body };
+}
+/** The HTTP status of a JSON-RPC response: 401 for missing or rejected credentials, else 200. */
+function errorStatus(server, response) {
+    if (response.error?.code === errors.A2A_ERROR_CODES.unauthorized) {
+        const challenge = server.authChallenge;
+        return json(401, response, challenge ? { 'WWW-Authenticate': challenge } : {});
+    }
+    return json(200, response);
+}
+/**
+ * Serve an A2A request: the Agent Cards and the JSON-RPC endpoints, with streams as SSE where
+ * every event is a JSON-RPC response. Errors before a stream starts are answered as a plain
+ * JSON-RPC error, with HTTP 401 for missing or rejected credentials.
+ */
+export async function handleA2AHttp(server, request) {
+    const route = matchRoute(server, request.method, request.path);
+    if (!route)
+        return { kind: 'pass' };
+    if (route.kind === 'legacy-card') {
+        const cards = server.getAgentCards({ baseUrl: request.mountUrl });
+        return json(200, cards.length === 1 ? cards[0] : cards);
+    }
+    if (route.agentName !== undefined && !server.hasAgent(route.agentName)) {
+        return json(404, createErrorResponse(null, errors.agentNotFound(route.agentName)));
+    }
+    if (route.kind === 'card') {
+        return json(200, server.getAgentCard(route.agentName, { baseUrl: request.mountUrl }));
+    }
+    const contentType = request.header('content-type');
+    if (contentType && !contentType.toLowerCase().startsWith('application/json')) {
+        return json(415, createErrorResponse(null, errors.invalidRequest('Content-Type must be application/json')));
+    }
+    let body;
+    try {
+        body = await request.readBody();
+    }
+    catch {
+        return json(200, createErrorResponse(null, errors.parseError('Invalid JSON body')));
+    }
+    if (body === undefined) {
+        return json(200, createErrorResponse(null, errors.parseError('Request body not parsed. Ensure body-parsing middleware is applied.')));
+    }
+    const authToken = server.getAuthToken((name) => request.header(name));
+    const options = route.agentName !== undefined ? { agentName: route.agentName } : undefined;
+    if (!isStreamRequest(body)) {
+        const response = await server.handleJsonRpc(body, authToken, options);
+        if (response === null)
+            return { kind: 'empty', status: 204 };
+        return response.error ? errorStatus(server, response) : json(200, response);
+    }
+    const stream = server.handleJsonRpcStream(body, authToken, request.signal, options);
+    const first = await stream.next();
+    if (first.done)
+        return { kind: 'empty', status: 204 };
+    if (first.value.error) {
+        await stream.return(undefined);
+        return errorStatus(server, first.value);
+    }
+    return {
+        kind: 'sse',
+        headers: SSE_HEADERS,
+        pipe: (write) => pipeStream(server, first.value, stream, request.signal, write),
+    };
+}
+/**
+ * Write the frames of a stream until it ends, the client disconnects or a write fails. While the
+ * stream is open a heartbeat comment goes out every `server.sseHeartbeatMs`, so a run that waits
+ * on a slow tool is not cut off by an idle timeout.
  */
-export async function pipeJsonRpcStream(server, body, authToken, signal, write) {
+async function pipeStream(server, first, rest, signal, write) {
+    const stopHeartbeat = startHeartbeat(() => {
+        if (signal.aborted)
+            return false;
+        void Promise.resolve()
+            .then(() => write(encodeHeartbeat()))
+            .catch(() => undefined);
+        return true;
+    }, server.sseHeartbeatMs);
     try {
-        for await (const event of server.handleJsonRpcStream(body, authToken, signal)) {
+        await write(sseFrame(first));
+        for await (const response of rest) {
             if (signal.aborted)
                 return;
-            await write(sseFrame(event));
+            await write(sseFrame(response));
         }
-        if (!signal.aborted)
-            await write(sseFrame('[DONE]'));
     }
     catch (error) {
         if (signal.aborted)
             return;
         try {
-            await write(sseFrame(buildSseErrorEvent(error)));
+            await write(sseFrame(createErrorResponse(null, errors.clientJsonRpcError(error, 'A2A stream failed'))));
         }
         catch {
             return;
         }
     }
+    finally {
+        stopHeartbeat();
+        await rest.return(undefined);
+    }
+}
+/** The URL an adapter is mounted at, from the full request URL and the path relative to the mount. */
+export function mountUrlOf(requestUrl, relativePath) {
+    const pathname = requestUrl.pathname;
+    const prefix = pathname.endsWith(relativePath)
+        ? pathname.slice(0, pathname.length - relativePath.length)
+        : '';
+    return `${requestUrl.origin}${prefix}`;
 }
 //# sourceMappingURL=shared.js.map

package/dist/adapters/shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/adapters/shared.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAI1D;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAa;IAC3C,OAAO,CACL,OAAO,IAAI,KAAK,QAAQ;QACxB,IAAI,KAAK,IAAI;QACb,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QACnB,IAAgC,CAAC,MAAM,KAAK,gBAAgB,CAC9D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAkB;IAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1C,OAAO,KAAK,IAAI,SAAS,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAA+B;IACtD,OAAO,SAAS,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC;AAC/E,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAA2B;IACjD,cAAc,EAAE,mBAAmB;IACnC,eAAe,EAAE,UAAU;IAC3B,UAAU,EAAE,YAAY;IACxB,mBAAmB,EAAE,IAAI;CAC1B,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAiB,EACjB,IAAa,EACb,SAA6B,EAC7B,MAAmB,EACnB,KAA8C;IAE9C,IAAI,CAAC;QACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC;YAC9E,IAAI,MAAM,CAAC,OAAO;gBAAE,OAAO;YAC3B,MAAM,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,MAAM,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO;QAC3B,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/adapters/shared.ts"],"names":[],"mappings":"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"}

package/dist/agent-card.d.ts

@@ -1,19 +1,34 @@
 import type { Agent as IAgent } from '@cogitator-ai/types';
 import type { AgentCard, AgentProvider, A2ACapabilities } from './types.js';
 export interface AgentCardOptions {
+    /** Absolute URL of the agent's JSON-RPC endpoint */
     url: string;
     capabilities?: Partial<A2ACapabilities>;
     provider?: AgentProvider;
+    /** The agent's version (default: '1.0.0') */
+    version?: string;
+    supportsAuthenticatedExtendedCard?: boolean;
 }
+/**
+ * The A2A v0.3 Agent Card of an agent. It names the agent, its description (never its
+ * instructions) and its tools as skills, and declares JSON-RPC at `url` as its transport.
+ */
 export declare function generateAgentCard(agent: IAgent, options: AgentCardOptions): AgentCard;
 export interface AgentCardSigningOptions {
-    algorithm?: 'hmac-sha256';
+    /** HMAC SHA-256; `hmac-sha256` is the name earlier versions used */
+    algorithm?: 'HS256' | 'hmac-sha256';
     secret: string;
 }
-export declare function signAgentCard(card: AgentCard, options: AgentCardSigningOptions): AgentCard & {
-    signature: string;
-};
-export declare function verifyAgentCardSignature(card: AgentCard & {
-    signature?: string;
-}, secret: string): boolean;
+/**
+ * JSON canonicalization (RFC 8785): object keys sorted by UTF-16 code units, no whitespace,
+ * values serialized as JSON. Undefined members are left out as JSON.stringify does.
+ */
+export declare function canonicalJson(value: unknown): string;
+/**
+ * The card with a JWS signature (RFC 7515, HS256, detached payload) over its canonical JSON
+ * (RFC 8785, without `signatures`) in `signatures`, as A2A v0.3 specifies.
+ */
+export declare function signAgentCard(card: AgentCard, options: AgentCardSigningOptions): AgentCard;
+/** Whether one of the card's HS256 signatures was made with `secret` over this exact card. */
+export declare function verifyAgentCardSignature(card: AgentCard, secret: string): boolean;
 //# sourceMappingURL=agent-card.d.ts.map

package/dist/agent-card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-card.d.ts","sourceRoot":"","sources":["../src/agent-card.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,IAAI,MAAM,EAAQ,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAc,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAExF,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B;AAYD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAuBrF;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAkBD,wBAAgB,aAAa,CAC3B,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,uBAAuB,GAC/B,SAAS,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAKnC;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,SAAS,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EACxC,MAAM,EAAE,MAAM,GACb,OAAO,CAcT"}
+{"version":3,"file":"agent-card.d.ts","sourceRoot":"","sources":["../src/agent-card.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,IAAI,MAAM,EAAQ,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EACV,SAAS,EAGT,aAAa,EACb,eAAe,EAChB,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC,CAAC,EAAE,OAAO,CAAC;CAC7C;AAaD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,SAAS,CA8BrF;AAED,MAAM,WAAW,uBAAuB;IACtC,oEAAoE;IACpE,SAAS,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAapD;AAkBD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,uBAAuB,GAAG,SAAS,CAM1F;AAWD,8FAA8F;AAC9F,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAQjF"}