@harrylabsj/kiwi 0.7.4 → 0.7.5

package/dist/a2a/server/throttle.js

@@ -71,6 +71,8 @@ export const DEFAULT_THROTTLE_TIERS = {
 };
 export const DEFAULT_WINDOW_MS = 60_000;
 export const DEFAULT_UNVERIFIED_SCALE = 0.5;
+/** 审查 K-L3：限流 Map 全量清扫周期（毫秒，默认 60s）。 */
+export const THROTTLE_SWEEP_INTERVAL_MS = 60_000;
 // ---------------------------------------------------------------------------
 // 工具
 // ---------------------------------------------------------------------------
@@ -126,11 +128,17 @@ export class A2AServerThrottle {
     malformedWindow = new Map();
     /** per-identity 主键 → 当前在途任务数。 */
     inflight = new Map();
+    sweepIntervalMs;
+    lastSweepAt = 0;
     constructor(options = {}) {
         this.windowMs = options.windowMs ?? DEFAULT_WINDOW_MS;
         if (!Number.isFinite(this.windowMs) || this.windowMs <= 0) {
             throw new TypeError("A2AServerThrottle: windowMs must be a positive number");
         }
+        this.sweepIntervalMs = options.sweepIntervalMs ?? THROTTLE_SWEEP_INTERVAL_MS;
+        if (!Number.isFinite(this.sweepIntervalMs) || this.sweepIntervalMs <= 0) {
+            throw new TypeError("A2AServerThrottle: sweepIntervalMs must be a positive number");
+        }
         this.unverifiedScale = options.unverifiedIdentityScale ?? DEFAULT_UNVERIFIED_SCALE;
         if (!Number.isFinite(this.unverifiedScale) ||
             this.unverifiedScale <= 0 ||
@@ -201,14 +209,41 @@ export class A2AServerThrottle {
         arr.push(now);
         map.set(key, arr);
     }
+    /** 审查 K-L3：全量清扫已过期窗口的键——windowEntries 只在再次访问该键时
+     *  修剪，一次性身份轮换的键永不再次访问、永久残留（长驻服务内存无界增长）。
+     *  每 sweepIntervalMs 调一次，Map 有界于「最近活跃身份」。 */
+    sweep(now) {
+        const cutoff = now - this.windowMs;
+        for (const map of [this.identityWindow, this.domainWindow, this.malformedWindow]) {
+            for (const [key, arr] of map) {
+                let start = 0;
+                while (start < arr.length && arr[start] <= cutoff)
+                    start += 1;
+                if (start === 0)
+                    continue;
+                const kept = arr.slice(start);
+                if (kept.length === 0)
+                    map.delete(key);
+                else
+                    map.set(key, kept);
+            }
+        }
+    }
+    sweepIfDue(now) {
+        if (now - this.lastSweepAt >= this.sweepIntervalMs) {
+            this.lastSweepAt = now;
+            this.sweep(now);
+        }
+    }
     // -- 公开判定 --------------------------------------------------------------
     /**
      * 限流判定（consume：允许的请求计入各自窗口）。判定顺序：malformed budget 阻断 →
      * per-identity → per-domain。拒绝携带档位 retry_after。
      */
     check(req) {
-        const tier = this.resolveTier(req);
         const now = this.now();
+        this.sweepIfDue(now); // 审查 K-L3：限流 Map 有界
+        const tier = this.resolveTier(req);
         const idKey = this.identityKeyOf(req);
         if (this.isMalformedBlocked(idKey, tier.malformedBudget, now)) {
             return {
@@ -251,6 +286,7 @@ export class A2AServerThrottle {
      */
     recordMalformed(req) {
         const now = this.now();
+        this.sweepIfDue(now); // 审查 K-L3
         this.record(this.malformedWindow, this.identityKeyOf(req), now);
         if (req.domain !== undefined) {
             this.record(this.malformedWindow, this.domainKeyOf(req.domain), now);
@@ -285,5 +321,9 @@ export class A2AServerThrottle {
     isMalformedBlocked(key, budget, now) {
         return this.windowEntries(this.malformedWindow, key, now).length >= budget;
     }
+    /** 诊断：当前 identity 窗口键数（审查 K-L3 内存有界性验证/监控用）。 */
+    get debugIdentityWindowSize() {
+        return this.identityWindow.size;
+    }
 }
 //# sourceMappingURL=throttle.js.map

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

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

package/dist/a2a/server/types.d.ts

@@ -34,6 +34,7 @@ import type { LedgerStore } from "../../negotiation/ledger/index.js";
 import type { UcpPublishOptions } from "./ucp.js";
 import type { A2AServerThrottle, ThrottleOptions } from "./throttle.js";
 import type { TrustLevel } from "../../trust/identity/trust-policy.js";
+import type { GenericMessageResponder } from "./generic-responder.js";
 /** Agent Card 本地配置（基线 §26 / 子规范 §24.1 Discovery）。 */
 export interface AgentCardConfig {
     /** Agent 名称。 */
@@ -188,4 +189,9 @@ export interface A2AServerOptions {
      * 传 ThrottleOptions 由 server 构造；也可直接注入 A2AServerThrottle 实例（测试用）。
      */
     throttle?: ThrottleOptions | A2AServerThrottle;
+    /**
+     * 通用（非 KNP）A2A 消息响应器（issue 10 / TCK）。缺省用 spec 一致的回显；
+     * conformance SUT 注入 TCK 参考场景（messageId 前缀路由）。
+     */
+    genericResponder?: GenericMessageResponder;
 }

package/dist/a2a/v1/headers.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 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.
+ */
+export declare const A2A_VERSION_HEADER = "A2A-Version";
+export declare const A2A_EXTENSIONS_HEADER = "A2A-Extensions";
+/** 支持的最高协议版本（本实现）。 */
+export declare const SUPPORTED_A2A_VERSION = "1.0";
+/** KNP extension path（与 Agent Card 声明单一来源）。 */
+export declare const KNP_EXTENSION_PATH = "/a2a/extensions/negotiation/1.0";
+/** 解析 `A2A-Version` 头：空/缺省 → undefined；否则 trim 后返回。 */
+export declare function parseVersion(header: string | undefined): string | undefined;
+/** 解析 `A2A-Extensions` 头：逗号分隔 URI，去空白，过滤空。 */
+export declare function parseExtensions(header: string | undefined): string[];
+/**
+ * 激活/拒绝扩展（fail-closed）：
+ * - 请求声明了服务器**不支持的扩展** → 抛错（未知扩展拒绝）；
+ * - 支持集内含 KNP extension path → `knpActive: true`。
+ */
+export declare function activateKnp(extensions: string[], supportedUris: ReadonlySet<string>): {
+    knpActive: boolean;
+};

package/dist/a2a/v1/headers.js

@@ -0,0 +1,56 @@
+/**
+ * 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 请求头（issue 05）：`A2A-Version` 解析/校验、`A2A-Extensions` 激活 KNP /
+ * 未知扩展 fail-closed。KNP extension path 与 Card 声明单一来源
+ * （`discovery/agent-card/types.ts` 的 `KIWI_NEGOTIATION_EXTENSION_PATH`）。
+ */
+import { KIWI_NEGOTIATION_EXTENSION_PATH } from "../../discovery/agent-card/index.js";
+export const A2A_VERSION_HEADER = "A2A-Version";
+export const A2A_EXTENSIONS_HEADER = "A2A-Extensions";
+/** 支持的最高协议版本（本实现）。 */
+export const SUPPORTED_A2A_VERSION = "1.0";
+/** KNP extension path（与 Agent Card 声明单一来源）。 */
+export const KNP_EXTENSION_PATH = KIWI_NEGOTIATION_EXTENSION_PATH;
+/** 解析 `A2A-Version` 头：空/缺省 → undefined；否则 trim 后返回。 */
+export function parseVersion(header) {
+    if (header === undefined)
+        return undefined;
+    const v = header.trim();
+    return v === "" ? undefined : v;
+}
+/** 解析 `A2A-Extensions` 头：逗号分隔 URI，去空白，过滤空。 */
+export function parseExtensions(header) {
+    if (header === undefined || header.trim() === "")
+        return [];
+    return header
+        .split(",")
+        .map((s) => s.trim())
+        .filter((s) => s !== "");
+}
+/**
+ * 激活/拒绝扩展（fail-closed）：
+ * - 请求声明了服务器**不支持的扩展** → 抛错（未知扩展拒绝）；
+ * - 支持集内含 KNP extension path → `knpActive: true`。
+ */
+export function activateKnp(extensions, supportedUris) {
+    const unknown = extensions.filter((uri) => !supportedUris.has(uri));
+    if (unknown.length > 0) {
+        throw new Error(`unsupported A2A extension(s): ${unknown.join(", ")}`);
+    }
+    return { knpActive: extensions.some((uri) => uri.endsWith(KNP_EXTENSION_PATH)) };
+}
+//# sourceMappingURL=headers.js.map

package/dist/a2a/v1/headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.js","sourceRoot":"","sources":["../../../src/a2a/v1/headers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;GAIG;AAEH,OAAO,EAAE,+BAA+B,EAAE,MAAM,qCAAqC,CAAC;AAEtF,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAC;AAChD,MAAM,CAAC,MAAM,qBAAqB,GAAG,gBAAgB,CAAC;AACtD,sBAAsB;AACtB,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAE3C,+CAA+C;AAC/C,MAAM,CAAC,MAAM,kBAAkB,GAAG,+BAA+B,CAAC;AAElE,uDAAuD;AACvD,MAAM,UAAU,YAAY,CAAC,MAA0B;IACrD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IACxB,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AAClC,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,eAAe,CAAC,MAA0B;IACxD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAC5D,OAAO,MAAM;SACV,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CACzB,UAAoB,EACpB,aAAkC;IAElC,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACpE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,iCAAiC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC;AACnF,CAAC"}

package/dist/a2a/v1/methods.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 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 JSON-RPC 方法名（issue 03）。
+ *
+ * 1.0 方法名与 0.3 legacy 不同：`SendMessage` vs `message/send`、`GetTask` vs
+ * `tasks/get` 等。本文件是方法名 + v1↔legacy 映射的单一来源——声明门禁
+ * （tests/a2a-version-declaration.test.ts）与双栈 client/server 都从这读取。
+ */
+/** A2A 1.0 方法名常量。 */
+export declare const METHOD_SEND_MESSAGE = "SendMessage";
+export declare const METHOD_GET_TASK = "GetTask";
+export declare const METHOD_LIST_TASKS = "ListTasks";
+export declare const METHOD_CANCEL_TASK = "CancelTask";
+export declare const METHOD_SUBSCRIBE_TO_TASK = "SubscribeToTask";
+/** A2A 1.0: GetExtendedAgentCard（issue 10 / TCK CARD-EXT-001）。 */
+export declare const METHOD_GET_EXTENDED_AGENT_CARD = "GetExtendedAgentCard";
+/** A2A 1.0: SendStreamingMessage（issue 10 / TCK JSONRPC-SSE-002：不支持流式 → -32004）。 */
+export declare const METHOD_SEND_STREAMING_MESSAGE = "SendStreamingMessage";
+/** A2A 1.0 push 通知配置方法（issue 10 / TCK JSONRPC-SSE-002：不支持推送 → -32003）。 */
+export declare const METHOD_CREATE_PUSH_CONFIG = "CreateTaskPushNotificationConfig";
+export declare const METHOD_GET_PUSH_CONFIG = "GetTaskPushNotificationConfig";
+export declare const METHOD_LIST_PUSH_CONFIGS = "ListTaskPushNotificationConfigs";
+export declare const METHOD_DELETE_PUSH_CONFIG = "DeleteTaskPushNotificationConfig";
+/** A2A 0.3 legacy 方法名常量。 */
+export declare const LEGACY_METHOD_SEND_MESSAGE = "message/send";
+export declare const LEGACY_METHOD_GET_TASK = "tasks/get";
+/** 1.0 → legacy 映射（1.0 方法名 → 0.3 方法名）。 */
+export declare const V1_TO_LEGACY: Readonly<Record<string, string>>;
+/** legacy → 1.0 映射（0.3 方法名 → 1.0 方法名）。 */
+export declare const LEGACY_TO_V1: Readonly<Record<string, string>>;
+/** 全部 1.0 方法名集合。 */
+export declare const V1_METHODS: ReadonlySet<string>;
+/** 全部 0.3 legacy 方法名集合。 */
+export declare const LEGACY_METHODS: ReadonlySet<string>;
+/** 给定方法名是否为 1.0 方法。 */
+export declare function isV1Method(method: string): boolean;
+/** 给定方法名是否为 0.3 legacy 方法。 */
+export declare function isLegacyMethod(method: string): boolean;

package/dist/a2a/v1/methods.js

@@ -0,0 +1,75 @@
+/**
+ * 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 JSON-RPC 方法名（issue 03）。
+ *
+ * 1.0 方法名与 0.3 legacy 不同：`SendMessage` vs `message/send`、`GetTask` vs
+ * `tasks/get` 等。本文件是方法名 + v1↔legacy 映射的单一来源——声明门禁
+ * （tests/a2a-version-declaration.test.ts）与双栈 client/server 都从这读取。
+ */
+/** A2A 1.0 方法名常量。 */
+export const METHOD_SEND_MESSAGE = "SendMessage";
+export const METHOD_GET_TASK = "GetTask";
+export const METHOD_LIST_TASKS = "ListTasks";
+export const METHOD_CANCEL_TASK = "CancelTask";
+export const METHOD_SUBSCRIBE_TO_TASK = "SubscribeToTask";
+/** A2A 1.0: GetExtendedAgentCard（issue 10 / TCK CARD-EXT-001）。 */
+export const METHOD_GET_EXTENDED_AGENT_CARD = "GetExtendedAgentCard";
+/** A2A 1.0: SendStreamingMessage（issue 10 / TCK JSONRPC-SSE-002：不支持流式 → -32004）。 */
+export const METHOD_SEND_STREAMING_MESSAGE = "SendStreamingMessage";
+/** A2A 1.0 push 通知配置方法（issue 10 / TCK JSONRPC-SSE-002：不支持推送 → -32003）。 */
+export const METHOD_CREATE_PUSH_CONFIG = "CreateTaskPushNotificationConfig";
+export const METHOD_GET_PUSH_CONFIG = "GetTaskPushNotificationConfig";
+export const METHOD_LIST_PUSH_CONFIGS = "ListTaskPushNotificationConfigs";
+export const METHOD_DELETE_PUSH_CONFIG = "DeleteTaskPushNotificationConfig";
+/** A2A 0.3 legacy 方法名常量。 */
+export const LEGACY_METHOD_SEND_MESSAGE = "message/send";
+export const LEGACY_METHOD_GET_TASK = "tasks/get";
+/** 1.0 → legacy 映射（1.0 方法名 → 0.3 方法名）。 */
+export const V1_TO_LEGACY = {
+    [METHOD_SEND_MESSAGE]: LEGACY_METHOD_SEND_MESSAGE,
+    [METHOD_GET_TASK]: LEGACY_METHOD_GET_TASK,
+};
+/** legacy → 1.0 映射（0.3 方法名 → 1.0 方法名）。 */
+export const LEGACY_TO_V1 = Object.fromEntries(Object.entries(V1_TO_LEGACY).map(([v1, legacy]) => [legacy, v1]));
+/** 全部 1.0 方法名集合。 */
+export const V1_METHODS = new Set([
+    METHOD_SEND_MESSAGE,
+    METHOD_GET_TASK,
+    METHOD_LIST_TASKS,
+    METHOD_CANCEL_TASK,
+    METHOD_SUBSCRIBE_TO_TASK,
+    METHOD_GET_EXTENDED_AGENT_CARD,
+    METHOD_SEND_STREAMING_MESSAGE,
+    METHOD_CREATE_PUSH_CONFIG,
+    METHOD_GET_PUSH_CONFIG,
+    METHOD_LIST_PUSH_CONFIGS,
+    METHOD_DELETE_PUSH_CONFIG,
+]);
+/** 全部 0.3 legacy 方法名集合。 */
+export const LEGACY_METHODS = new Set([
+    LEGACY_METHOD_SEND_MESSAGE,
+    LEGACY_METHOD_GET_TASK,
+]);
+/** 给定方法名是否为 1.0 方法。 */
+export function isV1Method(method) {
+    return V1_METHODS.has(method);
+}
+/** 给定方法名是否为 0.3 legacy 方法。 */
+export function isLegacyMethod(method) {
+    return LEGACY_METHODS.has(method);
+}
+//# sourceMappingURL=methods.js.map

package/dist/a2a/v1/methods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"methods.js","sourceRoot":"","sources":["../../../src/a2a/v1/methods.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;GAMG;AAEH,qBAAqB;AACrB,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC;AACjD,MAAM,CAAC,MAAM,eAAe,GAAG,SAAS,CAAC;AACzC,MAAM,CAAC,MAAM,iBAAiB,GAAG,WAAW,CAAC;AAC7C,MAAM,CAAC,MAAM,kBAAkB,GAAG,YAAY,CAAC;AAC/C,MAAM,CAAC,MAAM,wBAAwB,GAAG,iBAAiB,CAAC;AAC1D,kEAAkE;AAClE,MAAM,CAAC,MAAM,8BAA8B,GAAG,sBAAsB,CAAC;AACrE,oFAAoF;AACpF,MAAM,CAAC,MAAM,6BAA6B,GAAG,sBAAsB,CAAC;AACpE,0EAA0E;AAC1E,MAAM,CAAC,MAAM,yBAAyB,GAAG,kCAAkC,CAAC;AAC5E,MAAM,CAAC,MAAM,sBAAsB,GAAG,+BAA+B,CAAC;AACtE,MAAM,CAAC,MAAM,wBAAwB,GAAG,iCAAiC,CAAC;AAC1E,MAAM,CAAC,MAAM,yBAAyB,GAAG,kCAAkC,CAAC;AAE5E,4BAA4B;AAC5B,MAAM,CAAC,MAAM,0BAA0B,GAAG,cAAc,CAAC;AACzD,MAAM,CAAC,MAAM,sBAAsB,GAAG,WAAW,CAAC;AAElD,0CAA0C;AAC1C,MAAM,CAAC,MAAM,YAAY,GAAqC;IAC5D,CAAC,mBAAmB,CAAC,EAAE,0BAA0B;IACjD,CAAC,eAAe,CAAC,EAAE,sBAAsB;CAC1C,CAAC;AAEF,0CAA0C;AAC1C,MAAM,CAAC,MAAM,YAAY,GAAqC,MAAM,CAAC,WAAW,CAC9E,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CACjE,CAAC;AAEF,oBAAoB;AACpB,MAAM,CAAC,MAAM,UAAU,GAAwB,IAAI,GAAG,CAAC;IACrD,mBAAmB;IACnB,eAAe;IACf,iBAAiB;IACjB,kBAAkB;IAClB,wBAAwB;IACxB,8BAA8B;IAC9B,6BAA6B;IAC7B,yBAAyB;IACzB,sBAAsB;IACtB,wBAAwB;IACxB,yBAAyB;CAC1B,CAAC,CAAC;AAEH,2BAA2B;AAC3B,MAAM,CAAC,MAAM,cAAc,GAAwB,IAAI,GAAG,CAAC;IACzD,0BAA0B;IAC1B,sBAAsB;CACvB,CAAC,CAAC;AAEH,uBAAuB;AACvB,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,OAAO,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,8BAA8B;AAC9B,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC"}

package/dist/a2a/v1/part.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 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 Part 编解码 + KNP DataPart 映射（issue 04，高风险点）。
+ *
+ * 0.3（`{kind:"text"|"data"}`）↔ 1.0（统一 Part，字段存在性判别）双向转换。
+ * KNP 载荷（`knp_envelope` / `agreement`）必须无损往返——磋商内核（envelope
+ * 解析/相位机）100% 复用，只在传输帧层转换。
+ */
+import type { A2APart } from "../client/types.js";
+import type { A2AV1Part, DataPart } from "./types.js";
+/** KNP 载荷承载的 mediaType（KNP envelope 是 JSON）。 */
+export declare const KNP_DATA_MEDIA_TYPE = "application/json";
+/**
+ * 0.3 Part → 1.0 统一 Part。
+ * - text → TextPart；
+ * - data → DataPart（data 原样 + KNP mediaType）。
+ */
+export declare function encodeV1Part(legacy: A2APart): A2AV1Part;
+/**
+ * 1.0 统一 Part → 0.3 Part。
+ * - TextPart → text；
+ * - DataPart → data（原样还原）。
+ * - URLPart/FilePart 在 0.3 模型无等价（0.3 只建模 text/data）→ fail-closed。
+ */
+export declare function decodeV1Part(v1: A2AV1Part): A2APart;
+/** 识别 KNP 载荷 Part（data 内含 knp_envelope 或 agreement）。 */
+export declare function isKnpDataPart(part: A2AV1Part): part is DataPart;
+/**
+ * 输入 Part 是否受支持（issue 10 / TCK CORE-SEND-003）。fail-closed：未知
+ * 形状一律不支持。TextPart 直接支持；DataPart 仅当 mediaType 为
+ * application/json（含 KNP）；带其他 mediaType（如 raw/file/url）不支持 →
+ * server 返回 ContentTypeNotSupportedError（-32005），而非内部错误。
+ */
+export declare function isV1InputPartSupported(part: A2AV1Part): boolean;

package/dist/a2a/v1/part.js

@@ -0,0 +1,63 @@
+/**
+ * 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.
+ */
+/** KNP 载荷承载的 mediaType（KNP envelope 是 JSON）。 */
+export const KNP_DATA_MEDIA_TYPE = "application/json";
+/**
+ * 0.3 Part → 1.0 统一 Part。
+ * - text → TextPart；
+ * - data → DataPart（data 原样 + KNP mediaType）。
+ */
+export function encodeV1Part(legacy) {
+    if (legacy.kind === "text")
+        return { text: legacy.text };
+    return { data: legacy.data, mediaType: KNP_DATA_MEDIA_TYPE };
+}
+/**
+ * 1.0 统一 Part → 0.3 Part。
+ * - TextPart → text；
+ * - DataPart → data（原样还原）。
+ * - URLPart/FilePart 在 0.3 模型无等价（0.3 只建模 text/data）→ fail-closed。
+ */
+export function decodeV1Part(v1) {
+    if ("text" in v1)
+        return { kind: "text", text: v1.text };
+    if ("data" in v1)
+        return { kind: "data", data: v1.data };
+    throw new Error(`v1 Part 无法映射到 0.3 模型（0.3 只建模 text/data）：${JSON.stringify(v1).slice(0, 200)}`);
+}
+/** 识别 KNP 载荷 Part（data 内含 knp_envelope 或 agreement）。 */
+export function isKnpDataPart(part) {
+    if (!("data" in part))
+        return false;
+    return "knp_envelope" in part.data || "agreement" in part.data;
+}
+/**
+ * 输入 Part 是否受支持（issue 10 / TCK CORE-SEND-003）。fail-closed：未知
+ * 形状一律不支持。TextPart 直接支持；DataPart 仅当 mediaType 为
+ * application/json（含 KNP）；带其他 mediaType（如 raw/file/url）不支持 →
+ * server 返回 ContentTypeNotSupportedError（-32005），而非内部错误。
+ */
+export function isV1InputPartSupported(part) {
+    if (typeof part !== "object" || part === null)
+        return false;
+    if ("text" in part)
+        return true;
+    const mediaType = "mediaType" in part && typeof part.mediaType === "string" ? part.mediaType : undefined;
+    if (mediaType === undefined)
+        return false;
+    return mediaType.startsWith("text/") || mediaType === "application/json";
+}
+//# sourceMappingURL=part.js.map

package/dist/a2a/v1/part.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"part.js","sourceRoot":"","sources":["../../../src/a2a/v1/part.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAaH,gDAAgD;AAChD,MAAM,CAAC,MAAM,mBAAmB,GAAG,kBAAkB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAAe;IAC1C,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;IACzD,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,mBAAmB,EAAE,CAAC;AAC/D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,EAAa;IACxC,IAAI,MAAM,IAAI,EAAE;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;IACzD,IAAI,MAAM,IAAI,EAAE;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;IACzD,MAAM,IAAI,KAAK,CACb,2CAA2C,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAC9E,CAAC;AACJ,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,aAAa,CAAC,IAAe;IAC3C,IAAI,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACpC,OAAO,cAAc,IAAI,IAAI,CAAC,IAAI,IAAI,WAAW,IAAI,IAAI,CAAC,IAAI,CAAC;AACjE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAe;IACpD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC5D,IAAI,MAAM,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,SAAS,GACb,WAAW,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IACzF,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC1C,OAAO,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,SAAS,KAAK,kBAAkB,CAAC;AAC3E,CAAC"}

package/dist/a2a/v1/types.d.ts

@@ -0,0 +1,94 @@
+/**
+ * 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 1.0 域模型（issue 02）。
+ *
+ * 与 0.3（`src/a2a/client/types.ts`）的差异：
+ * - **统一 Part**：字段存在性判别（有 `text`=Text / `data`=Data / `url`=URL /
+ *   `raw`=File），**无 `kind` 字段**；`mimeType` → `mediaType`；
+ * - **Role**：`ROLE_AGENT` / `ROLE_USER` 命名常量；
+ * - **TaskState**：大写下划线枚举，含 1.0 新增 `REJECTED` / `AUTH_REQUIRED` /
+ *   `UNSPECIFIED`（0.3 的 `unknown` 在 1.0 语义为 `UNSPECIFIED`）。
+ *
+ * 词表单一来源（仿照 `handoff/destination.ts` 纪律）：本文件是 v1 词表的唯一
+ * 权威，编解码/双栈/TCK 全部从这里导入，不散落字符串。
+ */
+/**
+ * A2A 1.0 Role（wire 值 = proto 枚举名，官方 SDK `@a2a-js/sdk` 如此序列化）。
+ * 输入侧兼容小写 `user`/`agent`（server 归一化，见 normalizeV1Role）。
+ */
+export declare const ROLE_AGENT: "ROLE_AGENT";
+export declare const ROLE_USER: "ROLE_USER";
+export type A2ARole = typeof ROLE_AGENT | typeof ROLE_USER;
+/**
+ * A2A 1.0 TaskState（wire 值 = proto 枚举名 `TASK_STATE_*`，官方 SDK 如此）。
+ * 0.3 `unknown` → 1.0 `TASK_STATE_UNSPECIFIED`。
+ */
+export declare const A2A_TASK_STATES: readonly ["TASK_STATE_SUBMITTED", "TASK_STATE_WORKING", "TASK_STATE_INPUT_REQUIRED", "TASK_STATE_COMPLETED", "TASK_STATE_CANCELED", "TASK_STATE_FAILED", "TASK_STATE_REJECTED", "TASK_STATE_AUTH_REQUIRED", "TASK_STATE_UNSPECIFIED"];
+export type A2ATaskState = (typeof A2A_TASK_STATES)[number];
+/** 0.3 内部小写状态 → 1.0 wire TaskState（server 出站用）。 */
+export declare const LEGACY_TO_V1_STATE: Readonly<Record<string, string>>;
+/** 1.0 wire TaskState → 0.3 内部小写状态（client 入站用）。 */
+export declare const V1_STATE_TO_LEGACY: Readonly<Record<string, string>>;
+/** A2A 1.0 统一 Part：字段存在性判别（无 `kind`）。 */
+export type A2AV1Part = TextPart | DataPart | FilePart | URLPart;
+/** Text Part（有 `text` 字段即判别）。 */
+export interface TextPart {
+    text: string;
+}
+/** Data Part（有 `data` 字段即判别；KNP 载荷载体，`mediaType` 可选）。 */
+export interface DataPart {
+    data: Record<string, unknown>;
+    mediaType?: string;
+}
+/** File Part（有 `raw` 字段即判别；`raw` 为 base64，必须带 `mediaType`）。 */
+export interface FilePart {
+    raw: string;
+    mediaType: string;
+}
+/** URL Part（有 `url` 字段即判别）。 */
+export interface URLPart {
+    url: string;
+}
+/** A2A 1.0 Message。 */
+export interface A2AV1Message {
+    role: A2ARole;
+    parts: A2AV1Part[];
+    messageId: string;
+    taskId?: string;
+    contextId?: string;
+    metadata?: Record<string, unknown>;
+}
+/** A2A 1.0 TaskStatus。 */
+export interface A2AV1TaskStatus {
+    state: A2ATaskState;
+    message?: A2AV1Message;
+    timestamp?: string;
+}
+/** A2A 1.0 Artifact。 */
+export interface A2AV1Artifact {
+    parts: A2AV1Part[];
+    artifactId?: string;
+    metadata?: Record<string, unknown>;
+}
+/** A2A 1.0 Task。 */
+export interface A2AV1Task {
+    id: string;
+    status: A2AV1TaskStatus;
+    artifacts?: A2AV1Artifact[];
+    contextId?: string;
+    metadata?: Record<string, unknown>;
+}

package/dist/a2a/v1/types.js

@@ -0,0 +1,62 @@
+/**
+ * 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 1.0 域模型（issue 02）。
+ *
+ * 与 0.3（`src/a2a/client/types.ts`）的差异：
+ * - **统一 Part**：字段存在性判别（有 `text`=Text / `data`=Data / `url`=URL /
+ *   `raw`=File），**无 `kind` 字段**；`mimeType` → `mediaType`；
+ * - **Role**：`ROLE_AGENT` / `ROLE_USER` 命名常量；
+ * - **TaskState**：大写下划线枚举，含 1.0 新增 `REJECTED` / `AUTH_REQUIRED` /
+ *   `UNSPECIFIED`（0.3 的 `unknown` 在 1.0 语义为 `UNSPECIFIED`）。
+ *
+ * 词表单一来源（仿照 `handoff/destination.ts` 纪律）：本文件是 v1 词表的唯一
+ * 权威，编解码/双栈/TCK 全部从这里导入，不散落字符串。
+ */
+/**
+ * A2A 1.0 Role（wire 值 = proto 枚举名，官方 SDK `@a2a-js/sdk` 如此序列化）。
+ * 输入侧兼容小写 `user`/`agent`（server 归一化，见 normalizeV1Role）。
+ */
+export const ROLE_AGENT = "ROLE_AGENT";
+export const ROLE_USER = "ROLE_USER";
+/**
+ * A2A 1.0 TaskState（wire 值 = proto 枚举名 `TASK_STATE_*`，官方 SDK 如此）。
+ * 0.3 `unknown` → 1.0 `TASK_STATE_UNSPECIFIED`。
+ */
+export const A2A_TASK_STATES = [
+    "TASK_STATE_SUBMITTED",
+    "TASK_STATE_WORKING",
+    "TASK_STATE_INPUT_REQUIRED",
+    "TASK_STATE_COMPLETED",
+    "TASK_STATE_CANCELED",
+    "TASK_STATE_FAILED",
+    "TASK_STATE_REJECTED",
+    "TASK_STATE_AUTH_REQUIRED",
+    "TASK_STATE_UNSPECIFIED",
+];
+/** 0.3 内部小写状态 → 1.0 wire TaskState（server 出站用）。 */
+export const LEGACY_TO_V1_STATE = {
+    submitted: "TASK_STATE_SUBMITTED",
+    working: "TASK_STATE_WORKING",
+    "input-required": "TASK_STATE_INPUT_REQUIRED",
+    completed: "TASK_STATE_COMPLETED",
+    canceled: "TASK_STATE_CANCELED",
+    failed: "TASK_STATE_FAILED",
+    unknown: "TASK_STATE_UNSPECIFIED",
+};
+/** 1.0 wire TaskState → 0.3 内部小写状态（client 入站用）。 */
+export const V1_STATE_TO_LEGACY = Object.fromEntries(Object.entries(LEGACY_TO_V1_STATE).map(([legacy, v1]) => [v1, legacy]));
+//# sourceMappingURL=types.js.map