@harrylabsj/kiwi 0.6.0

package/dist/a2a/server/merchant-handler.js

@@ -0,0 +1,316 @@
+/**
+ * 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 { LedgerStore } from "../../negotiation/ledger/index.js";
+import { newAgreementId, newExchangeId, newMessageId, newOfferId, } from "../../negotiation/domain/identifiers.js";
+import { finalizeEnvelope } from "../../negotiation/domain/envelope.js";
+import { contentDigest } from "../../negotiation/jcs.js";
+import { evaluateConditionalOffer } from "../../negotiation/condition/evaluator.js";
+export const MERCHANT_CAPABILITY = "com.harrylabsj.kiwi.shopping.negotiation";
+export const MERCHANT_SKU = "SKU-001";
+export const MERCHANT_CURRENCY = "CNY";
+export const MERCHANT_OFFER_PRICE_MINOR = 85_000; // CNY 850.00
+export const MERCHANT_DEAL_PRICE_MINOR = 83_500; // CNY 835.00
+export const MERCHANT_QUANTITY = 200;
+export const MERCHANT_DELIVERY_BEFORE = "2026-08-20T18:00:00Z";
+/**
+ * 把 CommerceDataSource（v0.7.0 数据侧边界）适配成 MerchantProductSource。
+ * price_minor（分）→ 元（major）转换在此完成，与接口"元"单位约定一致；
+ * 未知 SKU → 抛错（resolveProduct 回退演示价，缺省行为不变）。
+ */
+export function dataSourceProductSource(dataSource) {
+    return {
+        async getProduct(sku) {
+            const fact = await dataSource.getProduct(sku);
+            if (fact === undefined || fact.price_minor === undefined || fact.currency === undefined) {
+                throw new Error(`product source has no price for SKU ${sku}`);
+            }
+            return {
+                price: fact.price_minor / 100,
+                currency: fact.currency,
+                ...(fact.title !== undefined ? { title: fact.title } : {}),
+                ...(fact.stock !== undefined ? { stock: fact.stock } : {}),
+            };
+        },
+    };
+}
+function seedEnvelope(seed) {
+    return finalizeEnvelope({
+        capability: MERCHANT_CAPABILITY,
+        protocol_version: "1.0",
+        exchange_id: seed.exchange_id ?? newExchangeId(),
+        message_id: seed.message_id ?? newMessageId(),
+        ...seed,
+    });
+}
+function offerTerms(opts) {
+    return {
+        items: [
+            {
+                sku: opts.sku ?? MERCHANT_SKU,
+                quantity: { value: opts.quantity, unit: "piece" },
+                unit_price: { currency: opts.currency ?? MERCHANT_CURRENCY, amount_minor: opts.priceMinor },
+            },
+        ],
+        fulfillment_terms: { delivery_before: MERCHANT_DELIVERY_BEFORE },
+        valid_until: "2099-12-31T23:59:59Z",
+    };
+}
+function buildAgreement(input) {
+    return {
+        type: "accepted_nonbinding_agreement",
+        agreement_id: newAgreementId(),
+        negotiation_id: input.negotiation_id,
+        accepted_offer_id: input.accepted_offer_id,
+        agreed_terms: input.agreed_terms,
+        terms_digest: contentDigest(input.agreed_terms),
+        accepted_by: ["buyer", "merchant"],
+        created_at: input.created_at,
+        binding_effect: "nonbinding",
+        creates_order: false,
+        reserves_inventory: false,
+        authorizes_payment: false,
+    };
+}
+const textReply = (text, taskState = "working") => ({
+    kind: "accepted",
+    taskState,
+    message: {
+        role: "agent",
+        parts: [{ kind: "text", text }],
+        // newMessageId 已带 msg_ 前缀（此前 msg_${newMessageId()} 产生
+        // msg_msg_<uuid> 双重前缀，跨端对账隐患）。
+        messageId: newMessageId(),
+    },
+});
+const envelopeReply = (reply) => ({
+    kind: "accepted",
+    taskState: "working",
+    message: {
+        role: "agent",
+        parts: [{ kind: "data", data: { knp_envelope: reply } }],
+        messageId: reply.message_id,
+    },
+});
+/** 构造生产 merchant KNP handler。 */
+export function createMerchantHandler(options) {
+    const { ledger, now, sender, counterparty } = options;
+    const offerPriceMinor = options.offerPriceMinor ?? MERCHANT_OFFER_PRICE_MINOR;
+    const conditionalByNegotiation = new Map();
+    // 每 negotiation 已解析的真实商品价（sku → {priceMinor, currency}），带
+    // TTL（评审项 L3：此前永久累积、价格永不刷新——长驻 merchant 节点内存
+    // 单调增长且价目陈旧）。
+    const PRICE_CACHE_TTL_MS = 10 * 60 * 1000;
+    const priceBySku = new Map();
+    /** 从真实商品源解析 SKU 价目；源不可用/查不到时回退演示价并返回注记。 */
+    const resolveProduct = async (sku) => {
+        const cached = priceBySku.get(sku);
+        if (cached !== undefined) {
+            if (Date.parse(now()) - cached.at <= PRICE_CACHE_TTL_MS)
+                return cached;
+            priceBySku.delete(sku); // TTL 过期：重新解析（价格会变）
+        }
+        if (options.productSource !== undefined) {
+            try {
+                const product = await options.productSource.getProduct(sku);
+                const resolved = {
+                    priceMinor: Math.round(product.price * 100),
+                    currency: product.currency,
+                    at: Date.parse(now()),
+                };
+                priceBySku.set(sku, resolved);
+                return resolved;
+            }
+            catch {
+                // 失败回退**不写缓存**：一次性故障（超时/重启）不得让该 SKU 从此
+                // 永久按演示价报价（长驻进程里源恢复后价格仍错）。下一轮重试真实源。
+                return {
+                    priceMinor: offerPriceMinor,
+                    currency: MERCHANT_CURRENCY,
+                    note: `商品源不可用（${sku}），本回合使用演示价`,
+                };
+            }
+        }
+        return { priceMinor: offerPriceMinor, currency: MERCHANT_CURRENCY };
+    };
+    const appendSent = async (reply) => {
+        await ledger.append({
+            event_kind: "message_sent",
+            negotiation_id: reply.negotiation_id,
+            exchange_id: reply.exchange_id,
+            message_id: reply.message_id,
+            in_reply_to: reply.in_reply_to,
+            identity: {
+                sender_identity: sender,
+                counterparty_identity: counterparty,
+                actor: reply.actor,
+            },
+            capability: {
+                capability: reply.capability,
+                protocol_version: reply.protocol_version,
+            },
+            wire_digest: reply.digest,
+            wire_payload: reply,
+            outcome: { kind: "ok" },
+            occurred_at: reply.created_at,
+        });
+    };
+    return {
+        name: "kiwi-agent-serve-merchant",
+        async handle(ctx) {
+            const envelope = ctx.envelope;
+            const negotiationId = envelope.negotiation_id;
+            const inReplyTo = envelope.message_id;
+            switch (envelope.action) {
+                case "inquiry": {
+                    // 入站消息由 A2A pipeline 统一落 message_received（§22）；这里不再
+                    // 重复落账——此前 appendSent(envelope) 把买家的 inquiry 记为 merchant
+                    // 自己"发送"（sender=merchant），审计语义错位且重复。
+                    return textReply(`We carry ${MERCHANT_SKU} at ${(offerPriceMinor / 100).toFixed(2)} ${MERCHANT_CURRENCY}/piece; ask for delivery details.`);
+                }
+                case "rfq": {
+                    const payload = envelope.payload;
+                    const sku = payload.items?.[0]?.sku ?? MERCHANT_SKU;
+                    const quantity = payload.items?.[0]?.quantity?.value ?? MERCHANT_QUANTITY;
+                    const { priceMinor, currency, note } = await resolveProduct(sku);
+                    const reply = seedEnvelope({
+                        negotiation_id: negotiationId,
+                        in_reply_to: inReplyTo,
+                        actor: "merchant",
+                        action: "offer",
+                        created_at: now(),
+                        payload: {
+                            type: "offer",
+                            offer_id: newOfferId(),
+                            terms: offerTerms({ sku, priceMinor, quantity, currency }),
+                        },
+                        ...(note !== undefined ? { public_message: note } : {}),
+                    });
+                    await appendSent(reply);
+                    return envelopeReply(reply);
+                }
+                case "offer": {
+                    // 商家还价：对 buyer 的 offer 回 counter_offer（真实商品价）。
+                    const buyerOffer = envelope.payload;
+                    const sku = buyerOffer.terms?.items?.[0]?.sku ?? MERCHANT_SKU;
+                    const quantity = buyerOffer.terms?.items?.[0]?.quantity?.value ?? MERCHANT_QUANTITY;
+                    const { priceMinor, currency, note } = await resolveProduct(sku);
+                    const reply = seedEnvelope({
+                        negotiation_id: negotiationId,
+                        in_reply_to: inReplyTo,
+                        actor: "merchant",
+                        action: "counter_offer",
+                        created_at: now(),
+                        payload: {
+                            type: "counter_offer",
+                            offer_id: newOfferId(),
+                            responding_to_offer_id: buyerOffer.offer_id ?? "",
+                            proposed_terms: offerTerms({ sku, priceMinor, quantity, currency }),
+                        },
+                        ...(note !== undefined ? { public_message: note } : {}),
+                    });
+                    await appendSent(reply);
+                    return envelopeReply(reply);
+                }
+                case "counter_offer": {
+                    const counter = envelope.payload;
+                    const sku = counter.proposed_terms?.items?.[0]?.sku ?? MERCHANT_SKU;
+                    const quantity = counter.proposed_terms?.items?.[0]?.quantity?.value ?? MERCHANT_QUANTITY;
+                    const { priceMinor, currency, note } = await resolveProduct(sku);
+                    // 条件成交价 = base × (1 - 折扣%)：批量确实更便宜。
+                    const discountPercent = options.dealDiscountPercent ?? 5;
+                    const dealPriceMinor = Math.round((priceMinor * (100 - discountPercent)) / 100);
+                    const reply = seedEnvelope({
+                        negotiation_id: negotiationId,
+                        in_reply_to: inReplyTo,
+                        actor: "merchant",
+                        action: "conditional_offer",
+                        created_at: now(),
+                        payload: {
+                            type: "conditional_offer",
+                            offer_id: newOfferId(),
+                            responding_to_offer_id: counter.offer_id,
+                            base_terms: offerTerms({ sku, priceMinor, quantity, currency }),
+                            conditions: [
+                                {
+                                    when: { all: [{ field: "aggregate.total_quantity", op: "gte", value: 100 }] },
+                                    then_terms: offerTerms({ sku, priceMinor: dealPriceMinor, quantity, currency }),
+                                },
+                            ],
+                        },
+                        ...(note !== undefined ? { public_message: note } : {}),
+                    });
+                    conditionalByNegotiation.set(negotiationId, {
+                        conditional: reply.payload,
+                        quantity,
+                    });
+                    await appendSent(reply);
+                    return envelopeReply(reply);
+                }
+                case "clarification": {
+                    const field = envelope.payload.questions?.[0]?.field;
+                    return textReply(`Regarding "${field ?? "…"}": delivery before ${MERCHANT_DELIVERY_BEFORE}, payment terms negotiable (nonbinding).`);
+                }
+                case "accept_nonbinding": {
+                    const stored = conditionalByNegotiation.get(negotiationId);
+                    const acceptedOfferId = envelope.payload.offer_id ?? "";
+                    // 成交价必须来自本磋商已发出的 conditional_offer：无前置 conditional
+                    // 或 accept 的 offer_id 与所存 conditional 不匹配 → 用基础价成交
+                    // （无折扣），绝不发 DEAL 价。此前无前置时直接给 DEAL 价，任何 buyer
+                    // 在 conditional_offer 之前发 accept 即可拿到折扣价。
+                    const storedOfferId = stored?.conditional?.offer_id ?? "";
+                    const acceptedConditional = stored !== undefined && acceptedOfferId !== "" && acceptedOfferId === storedOfferId
+                        ? stored
+                        : undefined;
+                    const agreedTerms = acceptedConditional === undefined
+                        ? offerTerms({
+                            priceMinor: (await resolveProduct(MERCHANT_SKU)).priceMinor,
+                            quantity: MERCHANT_QUANTITY,
+                        })
+                        : evaluateConditionalOffer(acceptedConditional.conditional, {
+                            "aggregate.total_quantity": acceptedConditional.quantity,
+                        });
+                    const agreement = buildAgreement({
+                        negotiation_id: negotiationId,
+                        accepted_offer_id: envelope.payload.offer_id,
+                        agreed_terms: agreedTerms,
+                        created_at: now(),
+                    });
+                    const artifactPart = { kind: "data", data: { agreement } };
+                    const message = {
+                        role: "agent",
+                        parts: [{ kind: "text", text: "Agreement reached (nonbinding)." }],
+                        messageId: newMessageId(),
+                    };
+                    // 协商终态：conditional 不再需要（评审项 L3：此前永久累积）
+                    conditionalByNegotiation.delete(negotiationId);
+                    return { kind: "accepted", taskState: "completed", artifactParts: [artifactPart], message };
+                }
+                case "withdraw":
+                    conditionalByNegotiation.delete(negotiationId);
+                    return textReply(`Withdrawn (scope=${envelope.payload.scope ?? "offer"}).`);
+                case "decline":
+                    conditionalByNegotiation.delete(negotiationId);
+                    return textReply(`Declined (scope=${envelope.payload.scope ?? "offer"}).`);
+                case "cancel":
+                    conditionalByNegotiation.delete(negotiationId);
+                    return textReply("Negotiation cancelled.");
+                default:
+                    return { kind: "declined", reasonCode: "unsupported_action" };
+            }
+        },
+    };
+}
+//# sourceMappingURL=merchant-handler.js.map

package/dist/a2a/server/merchant-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merchant-handler.js","sourceRoot":"","sources":["../../../src/a2a/server/merchant-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAeH,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAChE,OAAO,EACL,cAAc,EACd,aAAa,EACb,YAAY,EACZ,UAAU,GACX,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AAQpF,MAAM,CAAC,MAAM,mBAAmB,GAAG,0CAA0C,CAAC;AAC9E,MAAM,CAAC,MAAM,YAAY,GAAG,SAAS,CAAC;AACtC,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,CAAC;AACvC,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC,CAAC,aAAa;AAC/D,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC,CAAC,aAAa;AAC9D,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AACrC,MAAM,CAAC,MAAM,wBAAwB,GAAG,sBAAsB,CAAC;AA0B/D;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,UAA8B;IAE9B,OAAO;QACL,KAAK,CAAC,UAAU,CAAC,GAAW;YAC1B,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YAC9C,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACxF,MAAM,IAAI,KAAK,CAAC,uCAAuC,GAAG,EAAE,CAAC,CAAC;YAChE,CAAC;YACD,OAAO;gBACL,KAAK,EAAE,IAAI,CAAC,WAAW,GAAG,GAAG;gBAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1D,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC3D,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAQD,SAAS,YAAY,CAAC,IAAkB;IACtC,OAAO,gBAAgB,CAAC;QACtB,UAAU,EAAE,mBAAmB;QAC/B,gBAAgB,EAAE,KAAK;QACvB,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,aAAa,EAAE;QAChD,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,YAAY,EAAE;QAC7C,GAAG,IAAI;KACR,CAAC,CAAC;AACL,CAAC;AAED,SAAS,UAAU,CAAC,IAA+E;IACjG,OAAO;QACL,KAAK,EAAE;YACL;gBACE,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,YAAY;gBAC7B,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE;gBACjD,UAAU,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,iBAAiB,EAAE,YAAY,EAAE,IAAI,CAAC,UAAU,EAAE;aAC5F;SACF;QACD,iBAAiB,EAAE,EAAE,eAAe,EAAE,wBAAwB,EAAE;QAChE,WAAW,EAAE,sBAAsB;KACpC,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,KAKvB;IACC,OAAO;QACL,IAAI,EAAE,+BAA+B;QACrC,YAAY,EAAE,cAAc,EAAE;QAC9B,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;QAC1C,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,YAAY,EAAE,aAAa,CAAC,KAAK,CAAC,YAAqB,CAAC;QACxD,WAAW,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC;QAClC,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,cAAc,EAAE,YAAY;QAC5B,aAAa,EAAE,KAAK;QACpB,kBAAkB,EAAE,KAAK;QACzB,kBAAkB,EAAE,KAAK;KAC1B,CAAC;AACJ,CAAC;AAED,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,YAAqC,SAAS,EAA4B,EAAE,CAAC,CAAC;IAC7G,IAAI,EAAE,UAAU;IAChB,SAAS;IACT,OAAO,EAAE;QACP,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC/B,sDAAsD;QACtD,+BAA+B;QAC/B,SAAS,EAAE,YAAY,EAAE;KAC1B;CACF,CAAC,CAAC;AAEH,MAAM,aAAa,GAAG,CAAC,KAA0C,EAA4B,EAAE,CAAC,CAAC;IAC/F,IAAI,EAAE,UAAU;IAChB,SAAS,EAAE,SAAS;IACpB,OAAO,EAAE;QACP,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,CAAC;QACxD,SAAS,EAAE,KAAK,CAAC,UAAU;KAC5B;CACF,CAAC,CAAC;AAEH,iCAAiC;AACjC,MAAM,UAAU,qBAAqB,CACnC,OAA+B;IAE/B,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IACtD,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,0BAA0B,CAAC;IAC9E,MAAM,wBAAwB,GAAG,IAAI,GAAG,EAAsE,CAAC;IAC/G,0DAA0D;IAC1D,6CAA6C;IAC7C,cAAc;IACd,MAAM,kBAAkB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC1C,MAAM,UAAU,GAAG,IAAI,GAAG,EAAgE,CAAC;IAE3F,2CAA2C;IAC3C,MAAM,cAAc,GAAG,KAAK,EAC1B,GAAW,EACuD,EAAE;QACpE,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,EAAE,IAAI,kBAAkB;gBAAE,OAAO,MAAM,CAAC;YACvE,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,oBAAoB;QAC9C,CAAC;QACD,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACxC,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;gBAC5D,MAAM,QAAQ,GAAG;oBACf,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,GAAG,GAAG,CAAC;oBAC3C,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;iBACtB,CAAC;gBACF,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;gBAC9B,OAAO,QAAQ,CAAC;YAClB,CAAC;YAAC,MAAM,CAAC;gBACP,uCAAuC;gBACvC,oCAAoC;gBACpC,OAAO;oBACL,UAAU,EAAE,eAAe;oBAC3B,QAAQ,EAAE,iBAAiB;oBAC3B,IAAI,EAAE,UAAU,GAAG,YAAY;iBAChC,CAAC;YACJ,CAAC;QACH,CAAC;QACD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IACtE,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,KAAK,EAAE,KAA0C,EAAiB,EAAE;QACrF,MAAM,MAAM,CAAC,MAAM,CAAC;YAClB,UAAU,EAAE,cAAc;YAC1B,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,QAAQ,EAAE;gBACR,eAAe,EAAE,MAAM;gBACvB,qBAAqB,EAAE,YAAY;gBACnC,KAAK,EAAE,KAAK,CAAC,KAAK;aACnB;YACD,UAAU,EAAE;gBACV,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;aACzC;YACD,WAAW,EAAE,KAAK,CAAC,MAAM;YACzB,YAAY,EAAE,KAA2C;YACzD,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;YACvB,WAAW,EAAE,KAAK,CAAC,UAAU;SAC9B,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,2BAA2B;QACjC,KAAK,CAAC,MAAM,CAAC,GAA8B;YACzC,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;YAC9B,MAAM,aAAa,GAAG,QAAQ,CAAC,cAAc,CAAC;YAC9C,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAU,CAAC;YAEtC,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACxB,KAAK,SAAS,CAAC,CAAC,CAAC;oBACf,oDAAoD;oBACpD,yDAAyD;oBACzD,qCAAqC;oBACrC,OAAO,SAAS,CACd,YAAY,YAAY,OAAO,CAAC,eAAe,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,iBAAiB,mCAAmC,CAC1H,CAAC;gBACJ,CAAC;gBACD,KAAK,KAAK,CAAC,CAAC,CAAC;oBACX,MAAM,OAAO,GAAG,QAAQ,CAAC,OAExB,CAAC;oBACF,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,YAAY,CAAC;oBACpD,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,IAAI,iBAAiB,CAAC;oBAC1E,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,CAAC;oBACjE,MAAM,KAAK,GAAG,YAAY,CAAC;wBACzB,cAAc,EAAE,aAAa;wBAC7B,WAAW,EAAE,SAAS;wBACtB,KAAK,EAAE,UAAU;wBACjB,MAAM,EAAE,OAAO;wBACf,UAAU,EAAE,GAAG,EAAE;wBACjB,OAAO,EAAE;4BACP,IAAI,EAAE,OAAO;4BACb,QAAQ,EAAE,UAAU,EAAE;4BACtB,KAAK,EAAE,UAAU,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;yBAC3D;wBACD,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBACxD,CAAC,CAAC;oBACH,MAAM,UAAU,CAAC,KAAK,CAAC,CAAC;oBACxB,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;gBAC9B,CAAC;gBACD,KAAK,OAAO,CAAC,CAAC,CAAC;oBACb,+CAA+C;oBAC/C,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAuG,CAAC;oBACpI,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,YAAY,CAAC;oBAC9D,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,IAAI,iBAAiB,CAAC;oBACpF,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,CAAC;oBACjE,MAAM,KAAK,GAAG,YAAY,CAAC;wBACzB,cAAc,EAAE,aAAa;wBAC7B,WAAW,EAAE,SAAS;wBACtB,KAAK,EAAE,UAAU;wBACjB,MAAM,EAAE,eAAe;wBACvB,UAAU,EAAE,GAAG,EAAE;wBACjB,OAAO,EAAE;4BACP,IAAI,EAAE,eAAe;4BACrB,QAAQ,EAAE,UAAU,EAAE;4BACtB,sBAAsB,EAAE,UAAU,CAAC,QAAQ,IAAI,EAAE;4BACjD,cAAc,EAAE,UAAU,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;yBACpE;wBACD,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBACxD,CAAC,CAAC;oBACH,MAAM,UAAU,CAAC,KAAK,CAAC,CAAC;oBACxB,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;gBAC9B,CAAC;gBACD,KAAK,eAAe,CAAC,CAAC,CAAC;oBACrB,MAAM,OAAO,GAAG,QAAQ,CAAC,OAGxB,CAAC;oBACF,MAAM,GAAG,GAAG,OAAO,CAAC,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,YAAY,CAAC;oBACpE,MAAM,QAAQ,GAAG,OAAO,CAAC,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,IAAI,iBAAiB,CAAC;oBAC1F,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,CAAC;oBACjE,oCAAoC;oBACpC,MAAM,eAAe,GAAG,OAAO,CAAC,mBAAmB,IAAI,CAAC,CAAC;oBACzD,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,CAAC,GAAG,GAAG,eAAe,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;oBAChF,MAAM,KAAK,GAAG,YAAY,CAAC;wBACzB,cAAc,EAAE,aAAa;wBAC7B,WAAW,EAAE,SAAS;wBACtB,KAAK,EAAE,UAAU;wBACjB,MAAM,EAAE,mBAAmB;wBAC3B,UAAU,EAAE,GAAG,EAAE;wBACjB,OAAO,EAAE;4BACP,IAAI,EAAE,mBAAmB;4BACzB,QAAQ,EAAE,UAAU,EAAE;4BACtB,sBAAsB,EAAE,OAAO,CAAC,QAAQ;4BACxC,UAAU,EAAE,UAAU,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;4BAC/D,UAAU,EAAE;gCACV;oCACE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,0BAA0B,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE;oCAC7E,UAAU,EAAE,UAAU,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;iCAChF;6BACF;yBACF;wBACD,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBACxD,CAAC,CAAC;oBACH,wBAAwB,CAAC,GAAG,CAAC,aAAa,EAAE;wBAC1C,WAAW,EAAE,KAAK,CAAC,OAA6C;wBAChE,QAAQ;qBACT,CAAC,CAAC;oBACH,MAAM,UAAU,CAAC,KAAK,CAAC,CAAC;oBACxB,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;gBAC9B,CAAC;gBACD,KAAK,eAAe,CAAC,CAAC,CAAC;oBACrB,MAAM,KAAK,GAAI,QAAQ,CAAC,OAAgD,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC;oBAC/F,OAAO,SAAS,CACd,cAAc,KAAK,IAAI,GAAG,sBAAsB,wBAAwB,0CAA0C,CACnH,CAAC;gBACJ,CAAC;gBACD,KAAK,mBAAmB,CAAC,CAAC,CAAC;oBACzB,MAAM,MAAM,GAAG,wBAAwB,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;oBAC3D,MAAM,eAAe,GAAI,QAAQ,CAAC,OAAiC,CAAC,QAAQ,IAAI,EAAE,CAAC;oBACnF,mDAAmD;oBACnD,mDAAmD;oBACnD,6CAA6C;oBAC7C,0CAA0C;oBAC1C,MAAM,aAAa,GAAI,MAAM,EAAE,WAAiD,EAAE,QAAQ,IAAI,EAAE,CAAC;oBACjG,MAAM,mBAAmB,GACvB,MAAM,KAAK,SAAS,IAAI,eAAe,KAAK,EAAE,IAAI,eAAe,KAAK,aAAa;wBACjF,CAAC,CAAC,MAAM;wBACR,CAAC,CAAC,SAAS,CAAC;oBAChB,MAAM,WAAW,GACf,mBAAmB,KAAK,SAAS;wBAC/B,CAAC,CAAC,UAAU,CAAC;4BACT,UAAU,EAAE,CAAC,MAAM,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU;4BAC3D,QAAQ,EAAE,iBAAiB;yBAC5B,CAAC;wBACJ,CAAC,CAAC,wBAAwB,CAAC,mBAAmB,CAAC,WAAoB,EAAE;4BACjE,0BAA0B,EAAE,mBAAmB,CAAC,QAAQ;yBACzD,CAAC,CAAC;oBACT,MAAM,SAAS,GAAG,cAAc,CAAC;wBAC/B,cAAc,EAAE,aAAa;wBAC7B,iBAAiB,EAAG,QAAQ,CAAC,OAAgC,CAAC,QAAQ;wBACtE,YAAY,EAAE,WAAW;wBACzB,UAAU,EAAE,GAAG,EAAE;qBAClB,CAAC,CAAC;oBACH,MAAM,YAAY,GAAY,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,EAAE,CAAC;oBACpE,MAAM,OAAO,GAAe;wBAC1B,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iCAAiC,EAAE,CAAC;wBAClE,SAAS,EAAE,YAAY,EAAE;qBAC1B,CAAC;oBACF,uCAAuC;oBACvC,wBAAwB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;oBAC/C,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC;gBAC9F,CAAC;gBACD,KAAK,UAAU;oBACb,wBAAwB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;oBAC/C,OAAO,SAAS,CAAC,oBAAqB,QAAQ,CAAC,OAA8B,CAAC,KAAK,IAAI,OAAO,IAAI,CAAC,CAAC;gBACtG,KAAK,SAAS;oBACZ,wBAAwB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;oBAC/C,OAAO,SAAS,CAAC,mBAAoB,QAAQ,CAAC,OAA8B,CAAC,KAAK,IAAI,OAAO,IAAI,CAAC,CAAC;gBACrG,KAAK,QAAQ;oBACX,wBAAwB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;oBAC/C,OAAO,SAAS,CAAC,wBAAwB,CAAC,CAAC;gBAC7C;oBACE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,oBAAoB,EAAE,CAAC;YAClE,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,69 @@
+/**
+ * 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 { IdempotencyStore } from "../../negotiation/idempotency/index.js";
+import { LedgerStore } from "../../negotiation/ledger/index.js";
+import type { LedgerEvent } from "../../negotiation/ledger/index.js";
+import type { A2ATask } from "../client/index.js";
+import { A2AServerThrottle } from "./throttle.js";
+import type { TrustLevel } from "../../trust/identity/trust-policy.js";
+import { TaskRegistry } from "./task-registry.js";
+import type { NegotiationHandler } from "./types.js";
+export interface InboundPipelineOptions {
+    handler: NegotiationHandler;
+    idempotency: IdempotencyStore;
+    ledger: LedgerStore;
+    tasks: TaskRegistry;
+    now: () => string;
+    logError: (message: string, err: unknown) => void;
+    /** WP3 §31 反滥用限流（可选；配置后判定在认证之后、schema 校验之前）。 */
+    throttle?: A2AServerThrottle;
+}
+export interface SendMessageCaller {
+    senderIdentity: string;
+    remoteAddress?: string;
+    /** 对端 UCP-Agent 头声明的 platform profile URI（WP3 §25.1，可选）。 */
+    ucpAgentProfile?: string;
+    /** 对端 trust level（throttle 档位映射，缺省 T0）。 */
+    trustLevel?: TrustLevel;
+    /** 身份是否经过验签（缺省 false → throttle 按 remoteAddress 且限额更严）。 */
+    identityVerified?: boolean;
+    /** WP1 指纹变更短期降档信号。 */
+    fingerprintChanged?: boolean;
+}
+export interface SendMessageInput {
+    message: unknown;
+    contextId?: unknown;
+}
+export interface SendMessageResult {
+    task: A2ATask;
+    /** 新处理的落账事件；幂等重放时为 undefined。 */
+    ledgerEvent?: LedgerEvent;
+}
+export declare class InboundPipeline {
+    private readonly handler;
+    private readonly idempotency;
+    private readonly ledger;
+    private readonly tasks;
+    private readonly now;
+    private readonly logError;
+    private readonly throttle;
+    constructor(options: InboundPipelineOptions);
+    private toThrottleRequest;
+    /** message/send 入站处理（限流 → 校验 → 幂等 → handler → Ledger → 幂等 commit）。 */
+    sendMessage(input: SendMessageInput, caller: SendMessageCaller): Promise<SendMessageResult>;
+    /** tasks/get：内存优先，miss 时回退 Ledger 视图（§23 恢复第 4 步）。 */
+    getTask(taskId: string): Promise<A2ATask | null>;
+}