@harrylabsj/kiwi 0.6.0

package/dist/a2a/server/server.js

@@ -0,0 +1,420 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * A2A Server（入站侧，WP2）node:http 实现。零新增依赖。
+ *
+ * 端点面：
+ *   GET  {wellKnownPath}   Agent Card（基线 §26 / 子规范 §24.1），默认
+ *                          `/.well-known/agent-card.json`；
+ *   POST {a2aPath}         JSON-RPC A2A endpoint（默认 "/"）：message/send、
+ *                          tasks/get；其他 method → -32601。
+ *
+ * 请求路径顺序（全部 fail-closed）：
+ *   1. 路由 → 2. 认证（AuthVerifier 接缝，缺省 loopback-only）→
+ *   3. body 大小上限（默认 1 MiB）→ 4. JSON 解析（失败 400）→
+ *   5. JSON-RPC 帧校验（失败 400）→ 6. method 分发 → 7. InboundPipeline。
+ *
+ * 内部异常一律收敛为通用 "internal error"（-32603），绝不把 handler / ledger 的
+ * 内部细节回显给远端（基线 §4.5 / §36-11）。
+ */
+import http from "node:http";
+import { isJsonRpcRequest } from "../client/index.js";
+import { NegotiationValidationError } from "../../negotiation/domain/common.js";
+import { parseUcpAgentHeader, UCP_AGENT_HEADER } from "../ucp-agent.js";
+import { buildAgentCard } from "./card.js";
+import { buildUcpProfile, WELL_KNOWN_UCP_PATH } from "./ucp.js";
+import { defaultAuthVerifier } from "./auth.js";
+import { defaultHandler } from "./handler.js";
+import { InboundPipeline } from "./pipeline.js";
+import { TaskRegistry } from "./task-registry.js";
+import { A2AServerThrottle, domainFromUcpProfile } from "./throttle.js";
+import { authError, fromNegotiationError, internalServerError, JSONRPC_CODES, payloadTooLarge, rateLimited, ServerProtocolError, } from "./errors.js";
+const DEFAULT_MAX_PAYLOAD_BYTES = 1024 * 1024;
+const DEFAULT_WELL_KNOWN_PATH = "/.well-known/agent-card.json";
+function normalizePath(p) {
+    if (p === undefined || p === "")
+        return "/";
+    return p.startsWith("/") ? p : `/${p}`;
+}
+function resolveCardConfig(provider) {
+    return typeof provider === "function" ? provider() : provider;
+}
+function pathOf(url) {
+    if (url === undefined)
+        return "/";
+    const queryIndex = url.indexOf("?");
+    return queryIndex >= 0 ? url.slice(0, queryIndex) : url;
+}
+function requireParamsObject(params) {
+    if (params === null || typeof params !== "object" || Array.isArray(params)) {
+        throw new ServerProtocolError({
+            code: JSONRPC_CODES.INVALID_PARAMS,
+            message: "params must be an object",
+        });
+    }
+    return params;
+}
+function readBody(req, maxBytes) {
+    return new Promise((resolve) => {
+        const contentLength = Number(req.headers["content-length"] ?? "0");
+        if (Number.isFinite(contentLength) && contentLength > maxBytes) {
+            req.resume();
+            resolve({ ok: false });
+            return;
+        }
+        const chunks = [];
+        let total = 0;
+        let settled = false;
+        const finish = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            resolve(result);
+        };
+        req.on("data", (chunk) => {
+            if (settled)
+                return;
+            total += chunk.length;
+            if (total > maxBytes) {
+                req.pause();
+                finish({ ok: false });
+                return;
+            }
+            chunks.push(chunk);
+        });
+        req.on("end", () => finish({ ok: true, body: Buffer.concat(chunks) }));
+        req.on("error", () => finish({ ok: false }));
+    });
+}
+function sendJson(res, status, body) {
+    const payload = JSON.stringify(body);
+    res.writeHead(status, {
+        "content-type": "application/json",
+        "content-length": Buffer.byteLength(payload),
+    });
+    res.end(payload);
+}
+function sendJsonError(res, id, status, error) {
+    sendJson(res, status, { jsonrpc: "2.0", id, error });
+}
+function sendText(res, status, text) {
+    res.writeHead(status, { "content-type": "text/plain; charset=utf-8" });
+    res.end(text);
+}
+export class A2AServer {
+    cardConfig;
+    authVerifier;
+    maxPayloadBytes;
+    now;
+    wellKnownPath;
+    ucpOptions;
+    pipeline;
+    throttle;
+    constructor(options) {
+        this.cardConfig = options.card;
+        this.authVerifier = options.authVerifier ?? defaultAuthVerifier();
+        this.maxPayloadBytes = options.maxPayloadBytes ?? DEFAULT_MAX_PAYLOAD_BYTES;
+        if (this.maxPayloadBytes <= 0) {
+            throw new Error("A2AServer: maxPayloadBytes must be positive");
+        }
+        this.now = options.now ?? (() => new Date().toISOString());
+        this.wellKnownPath = options.wellKnownPath ?? DEFAULT_WELL_KNOWN_PATH;
+        const ucpOpt = options.ucp;
+        if (ucpOpt === undefined ||
+            ucpOpt === false ||
+            (typeof ucpOpt === "object" && ucpOpt.enabled === false)) {
+            this.ucpOptions = undefined;
+        }
+        else {
+            this.ucpOptions = ucpOpt === true ? {} : ucpOpt;
+        }
+        const handler = options.handler ?? defaultHandler();
+        const tasks = new TaskRegistry();
+        this.throttle =
+            options.throttle === undefined
+                ? undefined
+                : options.throttle instanceof A2AServerThrottle
+                    ? options.throttle
+                    : new A2AServerThrottle(options.throttle);
+        this.pipeline = new InboundPipeline({
+            handler,
+            idempotency: options.idempotency,
+            ledger: options.ledger,
+            tasks,
+            now: this.now,
+            logError: this.logError,
+            throttle: this.throttle,
+        });
+    }
+    logError = (message, err) => {
+        // 服务端日志；细节绝不回显给远端（§4.5）。
+        const detail = err instanceof Error ? err.message : String(err);
+        console.error(`[a2a-server] ${message}: ${detail}`);
+    };
+    /** 返回 node:http request listener。 */
+    handler() {
+        return (req, res) => {
+            void this.handleRequest(req, res);
+        };
+    }
+    /** 创建并返回绑定本 handler 的 node:http server。 */
+    createServer() {
+        const server = http.createServer(this.handler());
+        server.on("clientError", () => {
+            // 忽略畸形客户端流量（中止的 socket 等），不让其崩溃 server。
+        });
+        return server;
+    }
+    async handleRequest(req, res) {
+        try {
+            const pathname = pathOf(req.url);
+            const cardConfig = resolveCardConfig(this.cardConfig);
+            const a2aPath = normalizePath(cardConfig.a2aPath);
+            if (pathname === this.wellKnownPath) {
+                await this.handleWellKnown(req, res);
+                return;
+            }
+            // WP3 §25：UCP Profile 标准发现入口（/.well-known/ucp）。未配置发布时 404。
+            if (pathname === WELL_KNOWN_UCP_PATH) {
+                if (this.ucpOptions === undefined) {
+                    sendText(res, 404, "not found");
+                    return;
+                }
+                await this.handleUcp(req, res);
+                return;
+            }
+            if (pathname === a2aPath) {
+                await this.handleA2a(req, res);
+                return;
+            }
+            sendText(res, 404, "not found");
+        }
+        catch (err) {
+            this.logError("a2a request routing failed", err);
+            if (!res.headersSent) {
+                sendText(res, 500, "internal error");
+            }
+            else {
+                res.end();
+            }
+        }
+    }
+    async authenticate(req, body) {
+        // node:http 的 IncomingMessage.socket 静态类型是 net.Socket；TLS 下实为
+        // TLSSocket（带 encrypted）。用类型守卫读取，HTTPS 部署下 scheme 才是 https。
+        const socketTls = req.socket;
+        const result = await this.authVerifier.verify({
+            remoteAddress: req.socket.remoteAddress,
+            authorizationHeader: req.headers.authorization,
+            method: req.method ?? "",
+            url: req.url ?? "",
+            // WP5 HTTP Message Signature 需要原始头、请求体与 scheme（@target-uri 重建）。
+            scheme: socketTls.encrypted === true ? "https" : "http",
+            headers: req.headers,
+            body,
+        });
+        if (!result.authenticated) {
+            const { httpStatus, body } = authError(result.protocolCode ?? "authorization_failed");
+            return { error: { httpStatus, body } };
+        }
+        return {
+            identity: result.identity ?? "unknown",
+            remoteAddress: req.socket.remoteAddress,
+            trustLevel: result.trustLevel,
+            identityVerified: result.identityVerified,
+            fingerprintChanged: result.fingerprintChanged,
+        };
+    }
+    async handleWellKnown(req, res) {
+        if (req.method !== "GET") {
+            sendText(res, 405, "method not allowed");
+            return;
+        }
+        const auth = await this.authenticate(req);
+        if ("error" in auth) {
+            sendJsonError(res, null, auth.error.httpStatus, auth.error.body);
+            return;
+        }
+        let card;
+        try {
+            card = buildAgentCard(resolveCardConfig(this.cardConfig));
+        }
+        catch (err) {
+            this.logError("failed to build agent card", err);
+            sendText(res, 500, "internal error");
+            return;
+        }
+        sendJson(res, 200, card);
+    }
+    /**
+     * UCP Profile 端点（WP3）：GET /.well-known/ucp。
+     * 响应头 Cache-Control: public, max-age=N（N>=60，UCP 规范强制）；
+     * 内容由 buildUcpProfile 强制过 validate 自洽（fail-closed）。
+     */
+    async handleUcp(req, res) {
+        if (req.method !== "GET") {
+            sendText(res, 405, "method not allowed");
+            return;
+        }
+        const auth = await this.authenticate(req);
+        if ("error" in auth) {
+            sendJsonError(res, null, auth.error.httpStatus, auth.error.body);
+            return;
+        }
+        let built;
+        try {
+            built = buildUcpProfile(resolveCardConfig(this.cardConfig), {
+                wellKnownPath: this.wellKnownPath,
+                ...this.ucpOptions,
+            });
+        }
+        catch (err) {
+            this.logError("failed to build UCP profile", err);
+            sendText(res, 500, "internal error");
+            return;
+        }
+        const payload = JSON.stringify(built.profile);
+        res.writeHead(200, {
+            "content-type": "application/json",
+            "content-length": Buffer.byteLength(payload),
+            "cache-control": built.cacheControl,
+        });
+        res.end(payload);
+    }
+    async handleA2a(req, res) {
+        if (req.method !== "POST") {
+            sendText(res, 405, "method not allowed");
+            return;
+        }
+        // 先读 body（有大小上限）：WP5 content-digest 验签需要请求体；顺序调整对
+        // 既有认证语义无影响——认证失败仍返回 401/403，只是 body 先被读取。
+        const bodyResult = await readBody(req, this.maxPayloadBytes);
+        if (!bodyResult.ok) {
+            const { httpStatus, body } = payloadTooLarge(this.maxPayloadBytes);
+            sendJsonError(res, null, httpStatus, body);
+            return;
+        }
+        const auth = await this.authenticate(req, bodyResult.body);
+        if ("error" in auth) {
+            sendJsonError(res, null, auth.error.httpStatus, auth.error.body);
+            return;
+        }
+        // WP3 §25.1：解析对端 UCP-Agent 宣告（只读，不强制 —— 缺失/畸形不拒绝）。
+        const ucpAgentProfile = parseUcpAgentHeader(req.headers[UCP_AGENT_HEADER]);
+        let parsed;
+        try {
+            parsed = JSON.parse(bodyResult.body.toString("utf8"));
+        }
+        catch {
+            sendJsonError(res, null, 400, {
+                code: JSONRPC_CODES.PARSE_ERROR,
+                message: "request body is not valid JSON",
+            });
+            return;
+        }
+        if (!isJsonRpcRequest(parsed)) {
+            sendJsonError(res, null, 400, {
+                code: JSONRPC_CODES.INVALID_REQUEST,
+                message: "invalid JSON-RPC request",
+            });
+            return;
+        }
+        const { id, method, params } = parsed;
+        try {
+            const result = await this.dispatch(method, params, auth, ucpAgentProfile);
+            sendJson(res, 200, { jsonrpc: "2.0", id, result });
+        }
+        catch (err) {
+            sendJsonError(res, id, 200, this.toJsonRpcErrorBody(err));
+        }
+    }
+    toJsonRpcErrorBody(err) {
+        if (err instanceof ServerProtocolError)
+            return err.body;
+        if (err instanceof NegotiationValidationError)
+            return fromNegotiationError(err).body;
+        this.logError("a2a jsonrpc request failed", err);
+        return internalServerError().body;
+    }
+    async dispatch(method, params, caller, ucpAgentProfile) {
+        switch (method) {
+            case "message/send":
+                return this.handleMessageSend(params, caller, ucpAgentProfile);
+            case "tasks/get":
+                return this.handleTasksGet(params, caller, ucpAgentProfile);
+            default:
+                throw new ServerProtocolError({
+                    code: JSONRPC_CODES.METHOD_NOT_FOUND,
+                    message: `method ${method} not found`,
+                });
+        }
+    }
+    async handleMessageSend(params, caller, ucpAgentProfile) {
+        const p = requireParamsObject(params);
+        if (p.message === undefined) {
+            throw new ServerProtocolError({
+                code: JSONRPC_CODES.INVALID_PARAMS,
+                message: "params.message is required",
+            });
+        }
+        const result = await this.pipeline.sendMessage({ message: p.message, contextId: p.contextId }, {
+            senderIdentity: caller.identity,
+            remoteAddress: caller.remoteAddress,
+            ucpAgentProfile,
+            trustLevel: caller.trustLevel,
+            identityVerified: caller.identityVerified,
+            fingerprintChanged: caller.fingerprintChanged,
+        });
+        return { task: result.task };
+    }
+    async handleTasksGet(params, caller, ucpAgentProfile) {
+        const p = requireParamsObject(params);
+        const id = p.id;
+        if (typeof id !== "string" || id.length === 0) {
+            throw new ServerProtocolError({
+                code: JSONRPC_CODES.INVALID_PARAMS,
+                message: "params.id must be a non-empty string",
+            });
+        }
+        // 限流（评审项 B3）：tasks/get 对未知 id 走全 Ledger 线性扫描且此前完全
+        // 不受限流（throttle 只挂在 message/send）——认证客户端可高频刷 CPU 且
+        // 开销随 Ledger 规模线性放大。与 message/send 同档位判定（identity/
+        // domain 窗口 + malformed budget）。
+        if (this.throttle !== undefined) {
+            const decision = this.throttle.check({
+                identity: caller.identity,
+                remoteAddress: caller.remoteAddress,
+                domain: domainFromUcpProfile(ucpAgentProfile),
+                identityVerified: caller.identityVerified,
+                trustLevel: caller.trustLevel,
+                fingerprintChanged: caller.fingerprintChanged,
+            });
+            if (!decision.allowed) {
+                throw rateLimited(decision.retryAfterSeconds, decision.reason);
+            }
+        }
+        const task = await this.pipeline.getTask(id);
+        if (task === null) {
+            throw new ServerProtocolError({
+                code: JSONRPC_CODES.TASK_NOT_FOUND,
+                message: `task ${id} not found`,
+                data: { taskId: id },
+            });
+        }
+        return { task };
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/a2a/server/server.js.map

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

package/dist/a2a/server/task-registry.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { A2ATask, A2ATaskState } from "../client/index.js";
+import type { LedgerStore } from "../../negotiation/ledger/index.js";
+export declare function newTaskId(): string;
+export declare function newArtifactId(): string;
+export declare function isKnownTaskState(value: unknown): value is A2ATaskState;
+export declare class TaskRegistry {
+    private readonly tasks;
+    set(taskId: string, task: A2ATask): void;
+    get(taskId: string): A2ATask | null;
+    /**
+     * 从 Ledger 还原任务视图：扫描事件，命中 remote_task_id === taskId 的首条
+     * 记录，返回最小 A2ATask（id + status.state）。结果不依赖内存状态。
+     * 未命中返回 null。
+     */
+    resolveFromLedger(ledger: LedgerStore, taskId: string): A2ATask | null;
+}

package/dist/a2a/server/task-registry.js

@@ -0,0 +1,67 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * 任务注册表 + Ledger 视图映射（子规范 §23 A2A Message vs Task / §24.5 taskId）。
+ *
+ * message/send 会生成一个 A2A Task（task_<uuidv7>），状态记在内存注册表；
+ * tasks/get 优先查内存，miss 时回退到 Ledger 视图（§23 Recovery 第 4 步：
+ * "retrieve current remote A2A context/task state"）—— ledger 事件携带
+ * remote_task_id / task_state，即使 server 重启（内存丢失、ledger 持久）也能
+ * 还原任务状态。
+ */
+import { uuidv7 } from "../../negotiation/domain/identifiers.js";
+import { A2A_TASK_STATES } from "../client/index.js";
+export function newTaskId() {
+    return `task_${uuidv7()}`;
+}
+export function newArtifactId() {
+    return `art_${uuidv7()}`;
+}
+export function isKnownTaskState(value) {
+    return typeof value === "string" && A2A_TASK_STATES.includes(value);
+}
+export class TaskRegistry {
+    tasks = new Map();
+    set(taskId, task) {
+        this.tasks.set(taskId, task);
+    }
+    get(taskId) {
+        const task = this.tasks.get(taskId);
+        return task === undefined ? null : task;
+    }
+    /**
+     * 从 Ledger 还原任务视图：扫描事件，命中 remote_task_id === taskId 的首条
+     * 记录，返回最小 A2ATask（id + status.state）。结果不依赖内存状态。
+     * 未命中返回 null。
+     */
+    resolveFromLedger(ledger, taskId) {
+        for (const negotiationId of ledger.listNegotiations()) {
+            for (const event of ledger.events(negotiationId)) {
+                if (event.remote_task_id !== taskId)
+                    continue;
+                const result = event.outcome.kind === "ok" ? event.outcome.result : undefined;
+                const state = result === undefined ? undefined : result["task_state"];
+                if (isKnownTaskState(state)) {
+                    return { id: taskId, status: { state } };
+                }
+                // 记录存在但 task_state 不可识别 → fail-closed：不猜测状态。
+                return null;
+            }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=task-registry.js.map

package/dist/a2a/server/task-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-registry.js","sourceRoot":"","sources":["../../../src/a2a/server/task-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,yCAAyC,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAIrD,MAAM,UAAU,SAAS;IACvB,OAAO,QAAQ,MAAM,EAAE,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,OAAO,MAAM,EAAE,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,eAAqC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC7F,CAAC;AAED,MAAM,OAAO,YAAY;IACN,KAAK,GAAG,IAAI,GAAG,EAAmB,CAAC;IAEpD,GAAG,CAAC,MAAc,EAAE,IAAa;QAC/B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,GAAG,CAAC,MAAc;QAChB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpC,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACH,iBAAiB,CAAC,MAAmB,EAAE,MAAc;QACnD,KAAK,MAAM,aAAa,IAAI,MAAM,CAAC,gBAAgB,EAAE,EAAE,CAAC;YACtD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;gBACjD,IAAI,KAAK,CAAC,cAAc,KAAK,MAAM;oBAAE,SAAS;gBAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;gBAC9E,MAAM,KAAK,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;gBACtE,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC5B,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC;gBAC3C,CAAC;gBACD,6CAA6C;gBAC7C,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}