@zhin.js/a2a 1.0.0

package/lib/http-handlers.js

@@ -0,0 +1,183 @@
+import { createHash } from 'node:crypto';
+import { A2A_CONTENT_TYPE, A2A_VERSION_HEADER, HTTP_EXTENSION_HEADER, } from '@a2a-js/sdk';
+import { JsonRpcTransportHandler, ServerCallContext, UnauthenticatedUser, validateVersion, } from '@a2a-js/sdk/server';
+import { Extensions } from '@a2a-js/sdk';
+import { RestTransportHandler } from './rest-transport-handler.js';
+const SSE_HEADERS = {
+    'Content-Type': 'text/event-stream',
+    'Cache-Control': 'no-cache',
+    Connection: 'keep-alive',
+};
+function formatSSEEvent(data) {
+    return `data: ${JSON.stringify(data)}\n\n`;
+}
+function formatSSEErrorEvent(data) {
+    return `event: error\ndata: ${JSON.stringify(data)}\n\n`;
+}
+async function readJsonBody(req) {
+    const chunks = [];
+    for await (const chunk of req) {
+        chunks.push(typeof chunk === 'string' ? Buffer.from(chunk) : chunk);
+    }
+    const raw = Buffer.concat(chunks).toString('utf8');
+    if (!raw.trim())
+        return {};
+    return JSON.parse(raw);
+}
+function buildServerContext(req) {
+    return new ServerCallContext({
+        requestedExtensions: Extensions.parseServiceParameter(req.headers[HTTP_EXTENSION_HEADER.toLowerCase()]),
+        user: new UnauthenticatedUser(),
+        requestedVersion: req.headers[A2A_VERSION_HEADER.toLowerCase()],
+    });
+}
+function sendJson(res, status, body, extraHeaders) {
+    res.writeHead(status, { 'Content-Type': 'application/json', ...extraHeaders });
+    res.end(JSON.stringify(body));
+}
+function computeETag(json) {
+    const hash = createHash('sha256').update(json).digest('hex').slice(0, 16);
+    return `W/"${hash}"`;
+}
+export async function handleAgentCard(req, res, requestHandler) {
+    if (req.method !== 'GET') {
+        sendJson(res, 405, { error: 'Method not allowed' });
+        return;
+    }
+    try {
+        const agentCard = await requestHandler.getAgentCard();
+        const body = JSON.stringify(agentCard);
+        const etag = computeETag(body);
+        res.setHeader('ETag', etag);
+        res.setHeader('Cache-Control', 'public, max-age=3600');
+        if (req.headers['if-none-match'] === etag) {
+            res.writeHead(304);
+            res.end();
+            return;
+        }
+        sendJson(res, 200, agentCard);
+    }
+    catch (err) {
+        sendJson(res, 500, { error: err instanceof Error ? err.message : String(err) });
+    }
+}
+export async function handleJsonRpc(req, res, requestHandler, preParsedBody) {
+    if (req.method !== 'POST') {
+        sendJson(res, 405, { error: 'Method not allowed', Allow: 'POST' });
+        return;
+    }
+    const transport = new JsonRpcTransportHandler(requestHandler);
+    try {
+        const body = preParsedBody !== undefined ? preParsedBody : await readJsonBody(req);
+        const context = buildServerContext(req);
+        const agentCard = await requestHandler.getAgentCard();
+        validateVersion(context.requestedVersion, agentCard, 'JSONRPC');
+        const rpcResponseOrStream = await transport.handle(body, context);
+        if (context.activatedExtensions) {
+            res.setHeader(HTTP_EXTENSION_HEADER, Array.from(context.activatedExtensions).join(', '));
+        }
+        if (rpcResponseOrStream && typeof rpcResponseOrStream[Symbol.asyncIterator] === 'function') {
+            const stream = rpcResponseOrStream;
+            const iterator = stream[Symbol.asyncIterator]();
+            let firstResult = await iterator.next();
+            for (const [key, value] of Object.entries(SSE_HEADERS)) {
+                res.setHeader(key, value);
+            }
+            if (!firstResult.done) {
+                res.write(formatSSEEvent(firstResult.value));
+            }
+            for (;;) {
+                const next = await iterator.next();
+                if (next.done)
+                    break;
+                res.write(formatSSEEvent(next.value));
+            }
+            if (!res.writableEnded)
+                res.end();
+            return;
+        }
+        sendJson(res, 200, rpcResponseOrStream);
+    }
+    catch (err) {
+        const errorResponse = {
+            jsonrpc: '2.0',
+            id: null,
+            error: JsonRpcTransportHandler.mapToJSONRPCError(err),
+        };
+        sendJson(res, 200, errorResponse);
+    }
+}
+export async function handleRest(req, res, requestHandler, subPath, preParsedBody) {
+    const transport = new RestTransportHandler(requestHandler);
+    const context = buildServerContext(req);
+    const method = req.method ?? 'GET';
+    const path = subPath.replace(/^\//, '');
+    try {
+        const agentCard = await requestHandler.getAgentCard();
+        validateVersion(context.requestedVersion, agentCard, 'HTTP+JSON');
+        if (method === 'GET' && (path === '' || path === 'v1/card')) {
+            sendJson(res, 200, await transport.getAgentCard(), { 'Content-Type': A2A_CONTENT_TYPE });
+            return;
+        }
+        if (method === 'POST' && path === 'v1/message:send') {
+            const params = preParsedBody !== undefined ? preParsedBody : await readJsonBody(req);
+            const result = await transport.sendMessage(params, context);
+            sendJson(res, 200, result, { 'Content-Type': A2A_CONTENT_TYPE });
+            return;
+        }
+        if (method === 'POST' && path === 'v1/message:stream') {
+            const params = preParsedBody !== undefined ? preParsedBody : await readJsonBody(req);
+            const stream = await transport.sendMessageStream(params, context);
+            for (const [key, value] of Object.entries(SSE_HEADERS)) {
+                res.setHeader(key, value);
+            }
+            for await (const event of stream) {
+                res.write(formatSSEEvent(event));
+            }
+            if (!res.writableEnded)
+                res.end();
+            return;
+        }
+        const taskGet = path.match(/^v1\/tasks\/([^/]+)$/);
+        if (method === 'GET' && taskGet) {
+            const historyLength = req.url?.includes('historyLength=')
+                ? new URL(req.url, 'http://localhost').searchParams.get('historyLength') ?? undefined
+                : undefined;
+            const result = await transport.getTask(taskGet[1], context, historyLength ?? undefined);
+            sendJson(res, 200, result, { 'Content-Type': A2A_CONTENT_TYPE });
+            return;
+        }
+        const taskCancel = path.match(/^v1\/tasks\/([^/]+):cancel$/);
+        if (method === 'POST' && taskCancel) {
+            const result = await transport.cancelTask(taskCancel[1], context);
+            sendJson(res, 200, result, { 'Content-Type': A2A_CONTENT_TYPE });
+            return;
+        }
+        if (method === 'GET' && path === 'v1/tasks') {
+            const url = new URL(req.url ?? '/', 'http://localhost');
+            const query = {};
+            url.searchParams.forEach((v, k) => { query[k] = v; });
+            const result = await transport.listTasks(query, context);
+            sendJson(res, 200, result, { 'Content-Type': A2A_CONTENT_TYPE });
+            return;
+        }
+        sendJson(res, 404, { error: 'Not found' });
+    }
+    catch (err) {
+        sendJson(res, 400, { error: err instanceof Error ? err.message : String(err) });
+    }
+}
+export async function handleRestStreamError(res, err, requestId) {
+    if (!res.headersSent) {
+        sendJson(res, 500, { error: err instanceof Error ? err.message : String(err) });
+        return;
+    }
+    res.write(formatSSEErrorEvent({
+        jsonrpc: '2.0',
+        id: requestId ?? null,
+        error: JsonRpcTransportHandler.mapToJSONRPCError(err),
+    }));
+    if (!res.writableEnded)
+        res.end();
+}
+//# sourceMappingURL=http-handlers.js.map

package/lib/http-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-handlers.js","sourceRoot":"","sources":["../src/http-handlers.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,MAAM,WAAW,GAA2B;IAC1C,cAAc,EAAE,mBAAmB;IACnC,eAAe,EAAE,UAAU;IAC3B,UAAU,EAAE,YAAY;CACzB,CAAC;AAEF,SAAS,cAAc,CAAC,IAAa;IACnC,OAAO,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC;AAC7C,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAa;IACxC,OAAO,uBAAuB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC;AAC3D,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,GAAoB;IAC9C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACtE,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACnD,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;AACpC,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAoB;IAC9C,OAAO,IAAI,iBAAiB,CAAC;QAC3B,mBAAmB,EAAE,UAAU,CAAC,qBAAqB,CACnD,GAAG,CAAC,OAAO,CAAC,qBAAqB,CAAC,WAAW,EAAE,CAAuB,CACvE;QACD,IAAI,EAAE,IAAI,mBAAmB,EAAE;QAC/B,gBAAgB,EAAE,GAAG,CAAC,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,CAAuB;KACtF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,QAAQ,CAAC,GAAmB,EAAE,MAAc,EAAE,IAAa,EAAE,YAAqC;IACzG,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,GAAG,YAAY,EAAE,CAAC,CAAC;IAC/E,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1E,OAAO,MAAM,IAAI,GAAG,CAAC;AACvB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAoB,EACpB,GAAmB,EACnB,cAAiC;IAEjC,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QACzB,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC,CAAC;QACpD,OAAO;IACT,CAAC;IACD,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,YAAY,EAAE,CAAC;QACtD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAC/B,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC5B,GAAG,CAAC,SAAS,CAAC,eAAe,EAAE,sBAAsB,CAAC,CAAC;QACvD,IAAI,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,KAAK,IAAI,EAAE,CAAC;YAC1C,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACnB,GAAG,CAAC,GAAG,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QACD,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClF,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAoB,EACpB,GAAmB,EACnB,cAAiC,EACjC,aAAuB;IAEvB,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC1B,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QACnE,OAAO;IACT,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,uBAAuB,CAAC,cAAc,CAAC,CAAC;IAC9D,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;QACnF,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,YAAY,EAAE,CAAC;QACtD,eAAe,CAAC,OAAO,CAAC,gBAAgB,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QAEhE,MAAM,mBAAmB,GAAG,MAAM,SAAS,CAAC,MAAM,CAChD,IAAwC,EACxC,OAAO,CACR,CAAC;QAEF,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;YAChC,GAAG,CAAC,SAAS,CAAC,qBAAqB,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3F,CAAC;QAED,IAAI,mBAAmB,IAAI,OAAQ,mBAA8C,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,UAAU,EAAE,CAAC;YACvH,MAAM,MAAM,GAAG,mBAA+D,CAAC;YAC/E,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;YAChD,IAAI,WAAW,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAExC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;gBACvD,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC5B,CAAC;YACD,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;gBACtB,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;YAC/C,CAAC;YACD,SAAS,CAAC;gBACR,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACnC,IAAI,IAAI,CAAC,IAAI;oBAAE,MAAM;gBACrB,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YACxC,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,aAAa;gBAAE,GAAG,CAAC,GAAG,EAAE,CAAC;YAClC,OAAO;QACT,CAAC;QAED,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,mBAAmB,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,aAAa,GAAG;YACpB,OAAO,EAAE,KAAK;YACd,EAAE,EAAE,IAAI;YACR,KAAK,EAAE,uBAAuB,CAAC,iBAAiB,CAAC,GAAG,CAAC;SACtD,CAAC;QACF,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAoB,EACpB,GAAmB,EACnB,cAAiC,EACjC,OAAe,EACf,aAAuB;IAEvB,MAAM,SAAS,GAAG,IAAI,oBAAoB,CAAC,cAAc,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC;IACnC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAExC,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,YAAY,EAAE,CAAC;QACtD,eAAe,CAAC,OAAO,CAAC,gBAAgB,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QAElE,IAAI,MAAM,KAAK,KAAK,IAAI,CAAC,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,SAAS,CAAC,EAAE,CAAC;YAC5D,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC,YAAY,EAAE,EAAE,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAC,CAAC;YACzF,OAAO;QACT,CAAC;QAED,IAAI,MAAM,KAAK,MAAM,IAAI,IAAI,KAAK,iBAAiB,EAAE,CAAC;YACpD,MAAM,MAAM,GAAG,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;YACrF,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,MAAe,EAAE,OAAO,CAAC,CAAC;YACrE,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAC,CAAC;YACjE,OAAO;QACT,CAAC;QAED,IAAI,MAAM,KAAK,MAAM,IAAI,IAAI,KAAK,mBAAmB,EAAE,CAAC;YACtD,MAAM,MAAM,GAAG,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;YACrF,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,iBAAiB,CAAC,MAAe,EAAE,OAAO,CAAC,CAAC;YAC3E,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;gBACvD,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC5B,CAAC;YACD,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBACjC,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;YACnC,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,aAAa;gBAAE,GAAG,CAAC,GAAG,EAAE,CAAC;YAClC,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QACnD,IAAI,MAAM,KAAK,KAAK,IAAI,OAAO,EAAE,CAAC;YAChC,MAAM,aAAa,GAAG,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,gBAAgB,CAAC;gBACvD,CAAC,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,SAAS;gBACrF,CAAC,CAAC,SAAS,CAAC;YACd,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAE,EAAE,OAAO,EAAE,aAAa,IAAI,SAAS,CAAC,CAAC;YACzF,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAC,CAAC;YACjE,OAAO;QACT,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAC7D,IAAI,MAAM,KAAK,MAAM,IAAI,UAAU,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAE,EAAE,OAAO,CAAC,CAAC;YACnE,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAC,CAAC;YACjE,OAAO;QACT,CAAC;QAED,IAAI,MAAM,KAAK,KAAK,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YAC5C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,kBAAkB,CAAC,CAAC;YACxD,MAAM,KAAK,GAAuC,EAAE,CAAC;YACrD,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACtD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACzD,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAC,CAAC;YACjE,OAAO;QACT,CAAC;QAED,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClF,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,GAAmB,EACnB,GAAY,EACZ,SAAkB;IAElB,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;QACrB,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChF,OAAO;IACT,CAAC;IACD,GAAG,CAAC,KAAK,CAAC,mBAAmB,CAAC;QAC5B,OAAO,EAAE,KAAK;QACd,EAAE,EAAE,SAAS,IAAI,IAAI;QACrB,KAAK,EAAE,uBAAuB,CAAC,iBAAiB,CAAC,GAAG,CAAC;KACtD,CAAC,CAAC,CAAC;IACJ,IAAI,CAAC,GAAG,CAAC,aAAa;QAAE,GAAG,CAAC,GAAG,EAAE,CAAC;AACpC,CAAC"}

package/lib/index.d.ts

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

package/lib/index.d.ts.map

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

package/lib/index.js

@@ -0,0 +1,130 @@
+/**
+ * @zhin.js/a2a — A2A v1.0 server plugin for Zhin.js Host.
+ *
+ * Auto-exposes one Agent Card per `ai.agents[]` entry at:
+ *   GET  /a2a/{agentName}/.well-known/agent-card.json
+ *   POST /a2a/{agentName}/jsonrpc
+ *   *    /a2a/{agentName}/rest/*
+ */
+import { formatCompact, usePlugin } from '@zhin.js/core';
+import { paramPath } from '@zhin.js/host-router';
+import { DefaultRequestHandler, InMemoryTaskStore, } from '@a2a-js/sdk/server';
+import { AGENT_CARD_PATH } from '@a2a-js/sdk';
+import { getAgentRuntimeRegistry } from '@zhin.js/agent';
+import { resolvePublicBaseUrl, a2aAgentBasePath } from './config.js';
+import { verifyA2aBearer } from './auth.js';
+import { buildAgentCardForBinding, listExposableAgentNames } from './card-builder.js';
+import { ZhinA2AExecutor } from './agent-executor.js';
+import { handleAgentCard, handleJsonRpc, handleRest } from './http-handlers.js';
+const A2A_ROUTE = '/a2a/:agentName/:tail+';
+const plugin = usePlugin();
+const { root, useContext, logger, onDispose } = plugin;
+let agentStacks = new Map();
+let httpToken = '';
+let publicBaseUrl = 'http://127.0.0.1:8086';
+function rebuildAgentStacks(ai) {
+    const registry = ai.getBindingRegistry();
+    publicBaseUrl = resolvePublicBaseUrl(root.inject('config')?.get('zhin.config.yml') ?? {});
+    const runtime = getAgentRuntimeRegistry();
+    const primaryAgent = runtime.getDefault();
+    const next = new Map();
+    for (const agentName of listExposableAgentNames(registry)) {
+        const card = buildAgentCardForBinding(agentName, registry, publicBaseUrl);
+        if (!card || !primaryAgent)
+            continue;
+        const executor = new ZhinA2AExecutor({
+            agentName,
+            getAgent: () => runtime.getDefault(),
+            resolveBinding: () => registry.getBinding(agentName),
+        });
+        const requestHandler = new DefaultRequestHandler(card, new InMemoryTaskStore(), executor);
+        next.set(agentName, { agentName, requestHandler, agentCard: card });
+    }
+    agentStacks = next;
+    logger.info(formatCompact({ A2A: 'ready', agents: [...next.keys()].join(',') }));
+}
+function parseA2aTail(tail) {
+    const normalized = tail.replace(/^\/+/, '');
+    if (normalized === `.well-known/${AGENT_CARD_PATH}` || normalized === '.well-known/agent-card.json') {
+        return { kind: 'card' };
+    }
+    if (normalized === 'jsonrpc' || normalized.startsWith('jsonrpc/')) {
+        return { kind: 'jsonrpc' };
+    }
+    if (normalized === 'rest' || normalized.startsWith('rest/')) {
+        const restSubPath = normalized === 'rest' ? '' : normalized.slice('rest/'.length);
+        return { kind: 'rest', restSubPath };
+    }
+    return null;
+}
+function ensureStacks(ai) {
+    if (agentStacks.size > 0 || !ai?.isReady())
+        return;
+    rebuildAgentStacks(ai);
+}
+function sendJsonViaRawRes(ctx, status, body) {
+    ctx.respond = false;
+    ctx.res.writeHead(status, { 'Content-Type': 'application/json' });
+    ctx.res.end(JSON.stringify(body));
+}
+useContext('router', (router) => {
+    const configService = root.inject('config');
+    const appConfig = configService?.get('zhin.config.yml') ?? {};
+    httpToken = appConfig.http?.token ?? '';
+    publicBaseUrl = resolvePublicBaseUrl(appConfig);
+    const ai = root.inject('ai');
+    if (ai?.isReady())
+        rebuildAgentStacks(ai);
+    const a2aHandler = async (ctx) => {
+        const agentName = decodeURIComponent(ctx.params.agentName ?? '');
+        const parsed = parseA2aTail(paramPath(ctx, 'tail'));
+        if (!parsed) {
+            sendJsonViaRawRes(ctx, 404, { error: 'Not found' });
+            return;
+        }
+        const aiNow = root.inject('ai');
+        ensureStacks(aiNow);
+        if (httpToken && !verifyA2aBearer(ctx.req, httpToken)) {
+            sendJsonViaRawRes(ctx, 401, { error: 'Unauthorized — Bearer token required' });
+            return;
+        }
+        const stack = agentStacks.get(agentName);
+        if (!stack) {
+            sendJsonViaRawRes(ctx, 404, { error: `A2A agent "${agentName}" not found` });
+            return;
+        }
+        ctx.respond = false;
+        const preParsedBody = ctx.method === 'POST' ? ctx.request.body : undefined;
+        try {
+            if (parsed.kind === 'card') {
+                await handleAgentCard(ctx.req, ctx.res, stack.requestHandler);
+            }
+            else if (parsed.kind === 'jsonrpc') {
+                await handleJsonRpc(ctx.req, ctx.res, stack.requestHandler, preParsedBody);
+            }
+            else {
+                await handleRest(ctx.req, ctx.res, stack.requestHandler, parsed.restSubPath ?? '', preParsedBody);
+            }
+        }
+        catch (err) {
+            logger.error('A2A request error:', err);
+            if (!ctx.res.headersSent) {
+                sendJsonViaRawRes(ctx, 500, { error: 'Internal server error' });
+            }
+        }
+    };
+    router.all(A2A_ROUTE, a2aHandler);
+    logger.info(formatCompact({ A2A: 'listening', base: `${publicBaseUrl}${a2aAgentBasePath('{agent}')}` }));
+    onDispose(() => {
+        agentStacks.clear();
+    });
+});
+// Rebuild when AI service becomes ready (late init)
+useContext('ai', (ai) => {
+    if (ai.isReady())
+        rebuildAgentStacks(ai);
+    return () => {
+        agentStacks.clear();
+    };
+});
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EACL,qBAAqB,EACrB,iBAAiB,GAElB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAQhF,MAAM,SAAS,GAAG,wBAAwB,CAAC;AAE3C,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;AAC3B,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;AAEvD,IAAI,WAAW,GAAG,IAAI,GAAG,EAAyB,CAAC;AACnD,IAAI,SAAS,GAAG,EAAE,CAAC;AACnB,IAAI,aAAa,GAAG,uBAAuB,CAAC;AAE5C,SAAS,kBAAkB,CAAC,EAAa;IACvC,MAAM,QAAQ,GAAG,EAAE,CAAC,kBAAkB,EAAE,CAAC;IACzC,aAAa,GAAG,oBAAoB,CAClC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAkE,iBAAiB,CAAC,IAAI,EAAE,CACrH,CAAC;IACF,MAAM,OAAO,GAAG,uBAAuB,EAAE,CAAC;IAC1C,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAC1C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAyB,CAAC;IAE9C,KAAK,MAAM,SAAS,IAAI,uBAAuB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,GAAG,wBAAwB,CAAC,SAAS,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QAC1E,IAAI,CAAC,IAAI,IAAI,CAAC,YAAY;YAAE,SAAS;QAErC,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC;YACnC,SAAS;YACT,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE;YACpC,cAAc,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC;SACrD,CAAC,CAAC;QAEH,MAAM,cAAc,GAAG,IAAI,qBAAqB,CAC9C,IAAI,EACJ,IAAI,iBAAiB,EAAE,EACvB,QAAQ,CACT,CAAC;QAEF,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,WAAW,GAAG,IAAI,CAAC;IACnB,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AACnF,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5C,IAAI,UAAU,KAAK,eAAe,eAAe,EAAE,IAAI,UAAU,KAAK,6BAA6B,EAAE,CAAC;QACpG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;IACD,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAClE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC7B,CAAC;IACD,IAAI,UAAU,KAAK,MAAM,IAAI,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5D,MAAM,WAAW,GAAG,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClF,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACvC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,YAAY,CAAC,EAAyB;IAC7C,IAAI,WAAW,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE;QAAE,OAAO;IACnD,kBAAkB,CAAC,EAAE,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAkB,EAAE,MAAc,EAAE,IAAa;IAC1E,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC;IACpB,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAClE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,UAAU,CAAC,QAAQ,EAAE,CAAC,MAAc,EAAE,EAAE;IACtC,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,aAAa,EAAE,GAAG,CAAkF,iBAAiB,CAAC,IAAI,EAAE,CAAC;IAC/I,SAAS,GAAG,SAAS,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;IACxC,aAAa,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAEhD,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAA0B,CAAC;IACtD,IAAI,EAAE,EAAE,OAAO,EAAE;QAAE,kBAAkB,CAAC,EAAE,CAAC,CAAC;IAE1C,MAAM,UAAU,GAAG,KAAK,EAAE,GAAkB,EAAiB,EAAE;QAC7D,MAAM,SAAS,GAAG,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QACjE,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;QACpD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;YACpD,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAA0B,CAAC;QACzD,YAAY,CAAC,KAAK,CAAC,CAAC;QAEpB,IAAI,SAAS,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,CAAC;YACtD,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC,CAAC;YAC/E,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,cAAc,SAAS,aAAa,EAAE,CAAC,CAAC;YAC7E,OAAO;QACT,CAAC;QAED,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QAE3E,IAAI,CAAC;YACH,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC3B,MAAM,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;YAChE,CAAC;iBAAM,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBACrC,MAAM,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;YAC7E,CAAC;iBAAM,CAAC;gBACN,MAAM,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,cAAc,EAAE,MAAM,CAAC,WAAW,IAAI,EAAE,EAAE,aAAa,CAAC,CAAC;YACpG,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE,GAAG,CAAC,CAAC;YACxC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;gBACzB,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAElC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,aAAa,GAAG,gBAAgB,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAEzG,SAAS,CAAC,GAAG,EAAE;QACb,WAAW,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,oDAAoD;AACpD,UAAU,CAAC,IAAI,EAAE,CAAC,EAAa,EAAE,EAAE;IACjC,IAAI,EAAE,CAAC,OAAO,EAAE;QAAE,kBAAkB,CAAC,EAAE,CAAC,CAAC;IACzC,OAAO,GAAG,EAAE;QACV,WAAW,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/lib/message-parts.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Convert A2A Message parts to a delegation prompt for ZhinAgent.
+ */
+import type { Message } from '@a2a-js/sdk';
+export { partsToPromptText } from './a2a-parts.js';
+export declare function extractSkillId(message: Message): string | undefined;
+//# sourceMappingURL=message-parts.d.ts.map

package/lib/message-parts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-parts.d.ts","sourceRoot":"","sources":["../src/message-parts.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAInE"}

package/lib/message-parts.js

@@ -0,0 +1,7 @@
+export { partsToPromptText } from './a2a-parts.js';
+export function extractSkillId(message) {
+    const meta = message.metadata;
+    const skill = meta?.skillId ?? meta?.skill_id;
+    return typeof skill === 'string' && skill.trim() ? skill.trim() : undefined;
+}
+//# sourceMappingURL=message-parts.js.map

package/lib/message-parts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-parts.js","sourceRoot":"","sources":["../src/message-parts.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC;IAC9B,MAAM,KAAK,GAAG,IAAI,EAAE,OAAO,IAAI,IAAI,EAAE,QAAQ,CAAC;IAC9C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9E,CAAC"}

package/lib/rest-transport-handler.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Thin REST transport wrapper over A2ARequestHandler.
+ */
+import type { SendMessageRequest } from '@a2a-js/sdk';
+import type { A2ARequestHandler } from '@a2a-js/sdk/server';
+import type { ServerCallContext } from '@a2a-js/sdk/server';
+export declare class RestTransportHandler {
+    private readonly requestHandler;
+    constructor(requestHandler: A2ARequestHandler);
+    getAgentCard(): Promise<import("@a2a-js/sdk").AgentCard>;
+    sendMessage(params: SendMessageRequest, context: ServerCallContext): Promise<import("@a2a-js/sdk").Message | import("@a2a-js/sdk").Task>;
+    sendMessageStream(params: SendMessageRequest, context: ServerCallContext): Promise<AsyncGenerator<import("@a2a-js/sdk").StreamResponse, void, undefined>>;
+    getTask(taskId: string, context: ServerCallContext, historyLength?: string): Promise<import("@a2a-js/sdk").Task>;
+    cancelTask(taskId: string, context: ServerCallContext): Promise<import("@a2a-js/sdk").Task>;
+    listTasks(query: Record<string, string | undefined>, context: ServerCallContext): Promise<import("@a2a-js/sdk").ListTasksResponse>;
+    private validateSendMessageRequest;
+    private requireCapability;
+    private parseHistoryLength;
+}
+//# sourceMappingURL=rest-transport-handler.d.ts.map

package/lib/rest-transport-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-transport-handler.d.ts","sourceRoot":"","sources":["../src/rest-transport-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAIV,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAKrB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG5D,qBAAa,oBAAoB;IACnB,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAAd,cAAc,EAAE,iBAAiB;IAExD,YAAY;IAIZ,WAAW,CAAC,MAAM,EAAE,kBAAkB,EAAE,OAAO,EAAE,iBAAiB;IAKlE,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,EAAE,OAAO,EAAE,iBAAiB;IAMxE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,aAAa,CAAC,EAAE,MAAM;IAQ1E,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB;IAKrD,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,iBAAiB;IAarF,OAAO,CAAC,0BAA0B;YAKpB,iBAAiB;IAO/B,OAAO,CAAC,kBAAkB;CAO3B"}

package/lib/rest-transport-handler.js

@@ -0,0 +1,65 @@
+import { RequestMalformedError, UnsupportedOperationError, } from '@a2a-js/sdk/server';
+import { TaskState } from '@a2a-js/sdk';
+export class RestTransportHandler {
+    requestHandler;
+    constructor(requestHandler) {
+        this.requestHandler = requestHandler;
+    }
+    async getAgentCard() {
+        return this.requestHandler.getAgentCard();
+    }
+    async sendMessage(params, context) {
+        this.validateSendMessageRequest(params);
+        return this.requestHandler.sendMessage(params, context);
+    }
+    async sendMessageStream(params, context) {
+        await this.requireCapability('streaming');
+        this.validateSendMessageRequest(params);
+        return this.requestHandler.sendMessageStream(params, context);
+    }
+    async getTask(taskId, context, historyLength) {
+        const params = { id: taskId, tenant: '' };
+        if (historyLength !== undefined) {
+            params.historyLength = this.parseHistoryLength(historyLength);
+        }
+        return this.requestHandler.getTask(params, context);
+    }
+    async cancelTask(taskId, context) {
+        const params = { id: taskId, tenant: '', metadata: {} };
+        return this.requestHandler.cancelTask(params, context);
+    }
+    async listTasks(query, context) {
+        const params = {
+            tenant: query.tenant ?? '',
+            contextId: query.contextId ?? '',
+            pageToken: query.pageToken ?? '',
+            status: TaskState.TASK_STATE_UNSPECIFIED,
+            statusTimestampAfter: undefined,
+        };
+        if (query.pageSize)
+            params.pageSize = Number(query.pageSize);
+        if (query.historyLength)
+            params.historyLength = Number(query.historyLength);
+        return this.requestHandler.listTasks(params, context);
+    }
+    validateSendMessageRequest(params) {
+        if (!params.message)
+            throw new RequestMalformedError('message is required');
+        if (!params.message.messageId)
+            throw new RequestMalformedError('message.messageId is required');
+    }
+    async requireCapability(capability) {
+        const card = await this.getAgentCard();
+        if (!card.capabilities?.[capability]) {
+            throw new UnsupportedOperationError(`Agent does not support ${capability}`);
+        }
+    }
+    parseHistoryLength(value) {
+        const parsed = parseInt(value, 10);
+        if (Number.isNaN(parsed) || parsed < 0) {
+            throw new RequestMalformedError('historyLength must be a non-negative integer');
+        }
+        return parsed;
+    }
+}
+//# sourceMappingURL=rest-transport-handler.js.map

package/lib/rest-transport-handler.js.map

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

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@zhin.js/a2a",
+  "version": "1.0.0",
+  "description": "A2A Protocol server for Zhin.js — multi-agent Agent Cards and task delegation",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "development": "./src/index.ts",
+      "import": "./lib/index.js"
+    }
+  },
+  "keywords": [
+    "zhin",
+    "a2a",
+    "agent2agent",
+    "agent-mesh"
+  ],
+  "author": {
+    "name": "lc-cn",
+    "email": "admin@liucl.cn",
+    "url": "https://github.com/lc-cn"
+  },
+  "license": "MIT",
+  "repository": {
+    "url": "git+https://github.com/zhinjs/zhin.git",
+    "type": "git",
+    "directory": "packages/host/a2a"
+  },
+  "dependencies": {
+    "@a2a-js/sdk": "1.0.0-beta.0",
+    "@zhin.js/core": "1.3.2",
+    "@zhin.js/logger": "1.0.72"
+  },
+  "peerDependencies": {
+    "@zhin.js/host-router": "2.0.1",
+    "zhin.js": "4.1.0",
+    "@zhin.js/agent": "1.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.2",
+    "rimraf": "^6.0.0",
+    "typescript": "^6.0.3",
+    "@zhin.js/agent": "1.0.1",
+    "@zhin.js/host-router": "2.0.1",
+    "zhin.js": "4.1.0"
+  },
+  "files": [
+    "src",
+    "lib",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rimraf lib"
+  }
+}

package/src/a2a-parts.ts

@@ -0,0 +1,73 @@
+/**
+ * A2A v1.0 proto-shaped Part/Message helpers.
+ */
+import type { Part } from '@a2a-js/sdk';
+import { Role } from '@a2a-js/sdk';
+
+export function textPart(text: string, mediaType = 'text/plain'): Part {
+  return {
+    content: { $case: 'text', value: text },
+    metadata: undefined,
+    filename: '',
+    mediaType,
+  };
+}
+
+export function dataPart(data: unknown): Part {
+  return {
+    content: { $case: 'data', value: data },
+    metadata: undefined,
+    filename: '',
+    mediaType: 'application/json',
+  };
+}
+
+export function partsToPromptText(parts: Part[]): string {
+  const lines: string[] = [];
+  for (const part of parts) {
+    if (part.content?.$case === 'text') {
+      lines.push(part.content.value);
+    } else if (part.content?.$case === 'data') {
+      lines.push('```json', JSON.stringify(part.content.value, null, 2), '```');
+    } else if (part.content?.$case === 'url') {
+      lines.push(`[file: ${part.content.value}]`);
+    }
+  }
+  return lines.join('\n').trim();
+}
+
+export function agentTextMessage(
+  messageId: string,
+  contextId: string,
+  text: string,
+  taskId = '',
+): import('@a2a-js/sdk').Message {
+  return {
+    messageId,
+    contextId,
+    taskId,
+    role: Role.ROLE_AGENT,
+    parts: [textPart(text)],
+    metadata: undefined,
+    extensions: [],
+    referenceTaskIds: [],
+  };
+}
+
+export function userTextMessage(
+  messageId: string,
+  contextId: string,
+  parts: Part[],
+  metadata?: Record<string, unknown>,
+): import('@a2a-js/sdk').Message {
+  return {
+    messageId,
+    contextId,
+    taskId: '',
+    role: Role.ROLE_USER,
+    parts,
+    metadata,
+    extensions: [],
+    referenceTaskIds: [],
+  };
+}