@harrylabsj/kiwi 0.6.0

package/dist/negotiation/domain/identifiers.js

@@ -0,0 +1,130 @@
+/**
+ * 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/1.0 Identifier 模型（子规范 §6，基线 §9）。
+ *
+ * 所有 identifier 对对手方 opaque（§6）。生成器产出 `<前缀>_<uuidv7>`：
+ * 前缀便于人读日志（neg_/ex_/msg_/off_/agr_），uuidv7 保证跨重启稳定、
+ * 碰撞抵抗且按创建时间可排序（§6 SHOULD）。
+ *
+ * 校验器只做 opaque 字符串检查——协议不强制前缀，但 MUST 非空、无前后
+ * 空白、无控制字符、长度受限。A2A `contextId` / `taskId` 同样是 opaque
+ * 字符串（§6.6/§6.7），复用同一规则。
+ */
+import { randomBytes } from "node:crypto";
+import { NegotiationValidationError, requireNonEmptyString, requireObject, schemaError, } from "./common.js";
+export const IDENTIFIER_PREFIX = {
+    negotiation: "neg",
+    exchange: "ex",
+    message: "msg",
+    offer: "off",
+    agreement: "agr",
+    // v0.7.0 KTH（KTH rev0.3 §5/§6）
+    handoff_candidate: "hcan",
+    handoff: "hnd",
+};
+const MAX_IDENTIFIER_LENGTH = 256;
+let lastMs = -1;
+let seq = 0;
+/**
+ * UUIDv7：48 位毫秒时间戳 + version(7)/variant(10) 位 + 随机尾（§6 建议可排序）。
+ * rand_a 作 12 位每毫秒计数器，保证同毫秒内也单调不减（时钟回拨时锚定 lastMs）。
+ */
+export function uuidv7() {
+    const bytes = randomBytes(16);
+    let ms = Date.now();
+    if (ms <= lastMs) {
+        ms = lastMs;
+        seq = (seq + 1) & 0xfff;
+        if (seq === 0)
+            ms = lastMs + 1;
+    }
+    else {
+        seq = 0;
+    }
+    lastMs = ms;
+    bytes[0] = Math.floor(ms / 0x10000000000) & 0xff;
+    bytes[1] = Math.floor(ms / 0x100000000) & 0xff;
+    bytes[2] = Math.floor(ms / 0x1000000) & 0xff;
+    bytes[3] = Math.floor(ms / 0x10000) & 0xff;
+    bytes[4] = Math.floor(ms / 0x100) & 0xff;
+    bytes[5] = ms & 0xff;
+    bytes[6] = ((seq >> 8) & 0x0f) | 0x70;
+    bytes[7] = seq & 0xff;
+    bytes[8] = ((bytes[8] ?? 0) & 0x3f) | 0x80;
+    const hex = bytes.toString("hex");
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+/** 生成带前缀的 identifier（`neg_<uuidv7>` 等）。 */
+export function generateId(kind) {
+    return `${IDENTIFIER_PREFIX[kind]}_${uuidv7()}`;
+}
+export const newNegotiationId = () => generateId("negotiation");
+export const newExchangeId = () => generateId("exchange");
+export const newMessageId = () => generateId("message");
+export const newOfferId = () => generateId("offer");
+export const newAgreementId = () => generateId("agreement");
+/** opaque identifier 校验：非空、无前后空白、无控制字符、长度受限。 */
+export function validateIdentifier(value, path) {
+    const s = requireNonEmptyString(value, path);
+    if (s.length > MAX_IDENTIFIER_LENGTH) {
+        throw schemaError(path, `${path} exceeds ${MAX_IDENTIFIER_LENGTH} characters`);
+    }
+    if (s !== s.trim()) {
+        throw schemaError(path, `${path} must not have surrounding whitespace`);
+    }
+    const hasControl = Array.from(s).some((ch) => ch.charCodeAt(0) < 0x20 || ch.charCodeAt(0) === 0x7f);
+    if (hasControl) {
+        throw schemaError(path, `${path} must not contain control characters`);
+    }
+    return s;
+}
+/** A2A `contextId`：对 Kiwi opaque（§6.6）。 */
+export function validateContextId(value, path) {
+    return validateIdentifier(value, path);
+}
+/** A2A `taskId`：transport/session 状态，不得替代 negotiation_id（§6.7）。 */
+export function validateTaskId(value, path) {
+    return validateIdentifier(value, path);
+}
+export function validateTargetRef(value, path) {
+    const obj = requireObject(value, path);
+    const ref = {
+        target_message_id: validateIdentifier(obj.target_message_id, `${path}/target_message_id`),
+    };
+    if (obj.target_offer_id !== undefined) {
+        ref.target_offer_id = validateIdentifier(obj.target_offer_id, `${path}/target_offer_id`);
+    }
+    return ref;
+}
+/**
+ * 用 Ledger 视图核对 TargetRef 的一致性。只有双方都能解析且发生矛盾时才抛
+ * state_conflict（§9.7）；单侧未知不属于这里可判定的矛盾，留给引擎按
+ * offer_unknown 等状态错误处理。
+ */
+export function checkTargetRefAgreement(target, resolver) {
+    if (target.target_offer_id === undefined)
+        return;
+    const messageOffer = resolver.resolveMessageOffer(target.target_message_id);
+    if (messageOffer !== null && messageOffer !== target.target_offer_id) {
+        throw new NegotiationValidationError("state_conflict", `target_message_id ${target.target_message_id} resolves to offer ${messageOffer}, not ${target.target_offer_id}`, "target_message_id");
+    }
+    const offerMessage = resolver.resolveOfferMessage(target.target_offer_id);
+    if (offerMessage !== null && offerMessage !== target.target_message_id) {
+        throw new NegotiationValidationError("state_conflict", `target_offer_id ${target.target_offer_id} resolves to message ${offerMessage}, not ${target.target_message_id}`, "target_offer_id");
+    }
+}
+//# sourceMappingURL=identifiers.js.map

package/dist/negotiation/domain/identifiers.js.map

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

package/dist/negotiation/domain/objects.d.ts

@@ -0,0 +1,149 @@
+/**
+ * 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 { LineItem, TermSet } from "./common.js";
+import type { TargetRef } from "./identifiers.js";
+export type NegotiationActor = "buyer" | "merchant";
+/** KNP/1.0 动作词表（子规范 §8.2）。 */
+export declare const KNP_ACTIONS: readonly ["inquiry", "rfq", "offer", "counter_offer", "conditional_offer", "clarification", "clarification_response", "accept_nonbinding", "withdraw", "decline", "cancel"];
+export type NegotiationAction = (typeof KNP_ACTIONS)[number];
+export declare const SCOPE_VALUES: readonly ["offer", "negotiation"];
+export type TargetScope = (typeof SCOPE_VALUES)[number];
+export interface InquiryQuestion {
+    code: string;
+}
+export interface Inquiry {
+    type: "inquiry";
+    subject?: Record<string, unknown>;
+    questions?: InquiryQuestion[];
+}
+export declare function validateInquiry(value: unknown, path?: string): Inquiry;
+export interface Rfq {
+    type: "rfq";
+    /** RFQ MUST 至少含一个 item（§10）。 */
+    items: LineItem[];
+    requested_terms?: Record<string, unknown>;
+}
+export declare function validateRfq(value: unknown, path?: string): Rfq;
+export interface Offer {
+    type: "offer";
+    offer_id: string;
+    terms: TermSet;
+}
+export declare function validateOffer(value: unknown, path?: string): Offer;
+export interface CounterOffer {
+    type: "counter_offer";
+    offer_id: string;
+    /** MUST 引用前一个 offer-like 对象（§6.4/§12）。 */
+    responding_to_offer_id: string;
+    proposed_terms: TermSet;
+}
+export declare function validateCounterOffer(value: unknown, path?: string): CounterOffer;
+export declare const CONDITION_OPERATORS: readonly ["eq", "neq", "gt", "gte", "lt", "lte", "in"];
+export type ConditionOperator = (typeof CONDITION_OPERATORS)[number];
+/** §13.5 协议治理的 field 词表。 */
+export declare const CONDITION_FIELDS: readonly ["aggregate.total_quantity", "fulfillment.batch_count", "service.warranty_months", "commercial.commitment_days"];
+export interface ConditionLeaf {
+    field: string;
+    op: ConditionOperator;
+    value: number | string | (number | string)[];
+}
+export interface ConditionAll {
+    all: ConditionNode[];
+}
+export interface ConditionAny {
+    any: ConditionNode[];
+}
+export type ConditionNode = ConditionAll | ConditionAny | ConditionLeaf;
+export interface ConditionRule {
+    when: ConditionNode;
+    then_terms: TermSet;
+}
+export interface ConditionalOffer {
+    type: "conditional_offer";
+    offer_id: string;
+    responding_to_offer_id?: string;
+    /** §13.1 示例允许空 base_terms；§12.2 要求可独立求值。 */
+    base_terms: TermSet;
+    conditions: ConditionRule[];
+}
+export declare function validateConditionalOffer(value: unknown, path?: string): ConditionalOffer;
+export interface ClarificationQuestion {
+    field: string;
+    reason?: string;
+}
+export interface Clarification {
+    type: "clarification";
+    questions: ClarificationQuestion[];
+}
+export declare function validateClarification(value: unknown, path?: string): Clarification;
+/**
+ * clarification_response：KNP/1.0 未冻结 payload 形状（§8.2/§14）。唯一约束是
+ * 携带 `type` 判别；对澄清消息的引用由 envelope `in_reply_to` 承担。
+ */
+export interface ClarificationResponse {
+    type: "clarification_response";
+    [key: string]: unknown;
+}
+export declare function validateClarificationResponse(value: unknown, path?: string): ClarificationResponse;
+export interface AcceptNonbinding {
+    type: "accept_nonbinding";
+    offer_id: string;
+    terms_digest: string;
+}
+export declare function validateAcceptNonbinding(value: unknown, path?: string): AcceptNonbinding;
+export interface Withdraw extends TargetRef {
+    type: "withdraw";
+    scope: TargetScope;
+    reason_code?: string;
+}
+export declare function validateWithdraw(value: unknown, path?: string): Withdraw;
+export interface Decline extends TargetRef {
+    type: "decline";
+    scope: TargetScope;
+    reason_code?: string;
+}
+export declare function validateDecline(value: unknown, path?: string): Decline;
+export interface Cancel {
+    type: "cancel";
+}
+export declare function validateCancel(value: unknown, path?: string): Cancel;
+export interface AcceptedNonbindingAgreement {
+    type: "accepted_nonbinding_agreement";
+    agreement_id: string;
+    negotiation_id: string;
+    accepted_offer_id: string;
+    agreed_terms: TermSet;
+    terms_digest: string;
+    accepted_by: NegotiationActor[];
+    created_at: string;
+    binding_effect: "nonbinding";
+    /** KNP/1.0 不产生订单/库存/支付副作用：三个 flag 必须恒为 false（§16/§33）。 */
+    creates_order: false;
+    reserves_inventory: false;
+    authorizes_payment: false;
+}
+export declare function validateAcceptedNonbindingAgreement(value: unknown, path?: string): AcceptedNonbindingAgreement;
+/**
+ * envelope.payload 的合法载荷。AcceptedNonbindingAgreement 不在其中：它是
+ * 响应/Task artifact（§8.2），不是 envelope action，由
+ * validateAcceptedNonbindingAgreement 单独校验。
+ */
+export type NegotiationPayload = Inquiry | Rfq | Offer | CounterOffer | ConditionalOffer | Clarification | ClarificationResponse | AcceptNonbinding | Withdraw | Decline | Cancel;
+/**
+ * 按 envelope.action 校验 payload。每个 validator 强制 payload.type 与
+ * action 一致，因此 action/payload 类型不匹配会在这里被拒绝（fail-closed）。
+ */
+export declare function validatePayloadForAction(action: NegotiationAction, value: unknown, path?: string): NegotiationPayload;

package/dist/negotiation/domain/objects.js

@@ -0,0 +1,335 @@
+/**
+ * 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/1.0 九类核心 Negotiation Objects（子规范 §9–§17，基线 §11）。
+ *
+ * 九类：Inquiry / RFQ / Offer / CounterOffer / ConditionalOffer /
+ * Clarification / Withdraw / Decline / AcceptedNonbindingAgreement。
+ * 另含协议动作对应的 payload：AcceptNonbinding（§15）、
+ * clarification_response（§8.2/§14）、Cancel（§17.4）。
+ *
+ * 每个 payload 都以 `type` 为判别字段，与 envelope.action 一一对应。
+ * 校验 fail-closed（基线 §4.6）：结构、枚举、金额整数性、Agreement 副作用
+ * flag、Condition 字段 allowlist、Withdraw/Decline scope 语义等。
+ */
+import { NegotiationValidationError, requireArray, requireDigest, requireEnum, requireIsoTimestamp, requireNonEmptyString, requireObject, requireType, schemaError, validateLineItem, validateTermSet, } from "./common.js";
+import { validateIdentifier } from "./identifiers.js";
+/** KNP/1.0 动作词表（子规范 §8.2）。 */
+export const KNP_ACTIONS = [
+    "inquiry",
+    "rfq",
+    "offer",
+    "counter_offer",
+    "conditional_offer",
+    "clarification",
+    "clarification_response",
+    "accept_nonbinding",
+    "withdraw",
+    "decline",
+    "cancel",
+];
+export const SCOPE_VALUES = ["offer", "negotiation"];
+export function validateInquiry(value, path = "/payload") {
+    const obj = requireObject(value, path);
+    requireType(obj, "inquiry", path);
+    const inquiry = { type: "inquiry" };
+    if (obj.subject !== undefined) {
+        inquiry.subject = requireObject(obj.subject, `${path}/subject`);
+    }
+    if (obj.questions !== undefined) {
+        inquiry.questions = requireArray(obj.questions, `${path}/questions`).map((q, i) => {
+            const qobj = requireObject(q, `${path}/questions/${i}`);
+            return { code: requireNonEmptyString(qobj.code, `${path}/questions/${i}/code`) };
+        });
+    }
+    return inquiry;
+}
+export function validateRfq(value, path = "/payload") {
+    const obj = requireObject(value, path);
+    requireType(obj, "rfq", path);
+    const items = requireArray(obj.items, `${path}/items`);
+    if (items.length === 0) {
+        throw schemaError(`${path}/items`, "rfq must contain at least one item");
+    }
+    const rfq = {
+        type: "rfq",
+        items: items.map((item, i) => validateLineItem(item, `${path}/items/${i}`)),
+    };
+    if (obj.requested_terms !== undefined) {
+        const requested = requireObject(obj.requested_terms, `${path}/requested_terms`);
+        if (requested.delivery_before !== undefined) {
+            requireIsoTimestamp(requested.delivery_before, `${path}/requested_terms/delivery_before`);
+        }
+        rfq.requested_terms = requested;
+    }
+    return rfq;
+}
+export function validateOffer(value, path = "/payload") {
+    const obj = requireObject(value, path);
+    requireType(obj, "offer", path);
+    return {
+        type: "offer",
+        offer_id: validateIdentifier(obj.offer_id, `${path}/offer_id`),
+        terms: validateTermSet(obj.terms, `${path}/terms`, { requireUnitPrice: true }),
+    };
+}
+export function validateCounterOffer(value, path = "/payload") {
+    const obj = requireObject(value, path);
+    requireType(obj, "counter_offer", path);
+    return {
+        type: "counter_offer",
+        offer_id: validateIdentifier(obj.offer_id, `${path}/offer_id`),
+        responding_to_offer_id: validateIdentifier(obj.responding_to_offer_id, `${path}/responding_to_offer_id`),
+        proposed_terms: validateTermSet(obj.proposed_terms, `${path}/proposed_terms`, {
+            requireUnitPrice: true,
+        }),
+    };
+}
+// ---------------------------------------------------------------------------
+// ConditionalOffer（§13）
+// ---------------------------------------------------------------------------
+export const CONDITION_OPERATORS = ["eq", "neq", "gt", "gte", "lt", "lte", "in"];
+/** §13.5 协议治理的 field 词表。 */
+export const CONDITION_FIELDS = [
+    "aggregate.total_quantity",
+    "fulfillment.batch_count",
+    "service.warranty_months",
+    "commercial.commitment_days",
+];
+function validateConditionValue(value, path, op) {
+    if (Array.isArray(value)) {
+        if (op !== "in") {
+            throw schemaError(path, `${path} array value is only valid for op=in`);
+        }
+        if (value.length === 0) {
+            throw schemaError(path, `${path} must be a non-empty array for op=in`);
+        }
+        value.forEach((v, i) => {
+            if (typeof v !== "number" && typeof v !== "string") {
+                throw schemaError(`${path}/${i}`, `${path} elements must be number or string`);
+            }
+            if (typeof v === "number" && !Number.isFinite(v)) {
+                throw schemaError(`${path}/${i}`, `${path} elements must be finite numbers`);
+            }
+        });
+        return value;
+    }
+    if (typeof value === "number") {
+        if (!Number.isFinite(value)) {
+            throw schemaError(path, `${path} must be a finite number`);
+        }
+        return value;
+    }
+    if (typeof value === "string") {
+        return value;
+    }
+    throw schemaError(path, `${path} must be a number, string, or array`);
+}
+function validateConditionLeaf(obj, path) {
+    const field = requireNonEmptyString(obj.field, `${path}/field`);
+    if (!CONDITION_FIELDS.includes(field)) {
+        throw new NegotiationValidationError("field_unsupported", `unsupported condition field: ${field}`, `${path}/field`);
+    }
+    const op = requireEnum(obj.op, CONDITION_OPERATORS, `${path}/op`);
+    return {
+        field,
+        op,
+        value: validateConditionValue(obj.value, `${path}/value`, op),
+    };
+}
+function validateConditionNode(value, path, depth) {
+    if (depth > 2) {
+        throw schemaError(path, "condition nesting must not exceed 2 levels below the root");
+    }
+    const obj = requireObject(value, path);
+    const hasAll = obj.all !== undefined;
+    const hasAny = obj.any !== undefined;
+    const isLeaf = obj.field !== undefined || obj.op !== undefined || obj.value !== undefined;
+    const present = Number(hasAll) + Number(hasAny) + Number(isLeaf);
+    if (present !== 1) {
+        throw schemaError(path, "condition node must have exactly one of all/any/leaf");
+    }
+    if (hasAll) {
+        const children = requireArray(obj.all, `${path}/all`);
+        if (children.length === 0) {
+            throw schemaError(`${path}/all`, "all must be a non-empty array");
+        }
+        return { all: children.map((c, i) => validateConditionNode(c, `${path}/all/${i}`, depth + 1)) };
+    }
+    if (hasAny) {
+        const children = requireArray(obj.any, `${path}/any`);
+        if (children.length === 0) {
+            throw schemaError(`${path}/any`, "any must be a non-empty array");
+        }
+        return { any: children.map((c, i) => validateConditionNode(c, `${path}/any/${i}`, depth + 1)) };
+    }
+    return validateConditionLeaf(obj, path);
+}
+export function validateConditionalOffer(value, path = "/payload") {
+    const obj = requireObject(value, path);
+    requireType(obj, "conditional_offer", path);
+    const conditions = (obj.conditions === undefined ? [] : requireArray(obj.conditions, `${path}/conditions`)).map((c, i) => {
+        const cobj = requireObject(c, `${path}/conditions/${i}`);
+        return {
+            when: validateConditionNode(cobj.when, `${path}/conditions/${i}/when`, 0),
+            then_terms: validateTermSet(cobj.then_terms, `${path}/conditions/${i}/then_terms`),
+        };
+    });
+    return {
+        type: "conditional_offer",
+        offer_id: validateIdentifier(obj.offer_id, `${path}/offer_id`),
+        responding_to_offer_id: obj.responding_to_offer_id === undefined
+            ? undefined
+            : validateIdentifier(obj.responding_to_offer_id, `${path}/responding_to_offer_id`),
+        base_terms: validateTermSet(obj.base_terms, `${path}/base_terms`),
+        conditions,
+    };
+}
+export function validateClarification(value, path = "/payload") {
+    const obj = requireObject(value, path);
+    requireType(obj, "clarification", path);
+    const questions = requireArray(obj.questions, `${path}/questions`);
+    if (questions.length === 0) {
+        throw schemaError(`${path}/questions`, "clarification must contain at least one question");
+    }
+    return {
+        type: "clarification",
+        questions: questions.map((q, i) => {
+            const qobj = requireObject(q, `${path}/questions/${i}`);
+            const question = {
+                field: requireNonEmptyString(qobj.field, `${path}/questions/${i}/field`),
+            };
+            if (qobj.reason !== undefined) {
+                question.reason = requireNonEmptyString(qobj.reason, `${path}/questions/${i}/reason`);
+            }
+            return question;
+        }),
+    };
+}
+export function validateClarificationResponse(value, path = "/payload") {
+    const obj = requireObject(value, path);
+    requireType(obj, "clarification_response", path);
+    return { ...obj, type: "clarification_response" };
+}
+export function validateAcceptNonbinding(value, path = "/payload") {
+    const obj = requireObject(value, path);
+    requireType(obj, "accept_nonbinding", path);
+    return {
+        type: "accept_nonbinding",
+        offer_id: validateIdentifier(obj.offer_id, `${path}/offer_id`),
+        terms_digest: requireDigest(obj.terms_digest, `${path}/terms_digest`),
+    };
+}
+export function validateWithdraw(value, path = "/payload") {
+    const obj = requireObject(value, path);
+    requireType(obj, "withdraw", path);
+    const scope = requireEnum(obj.scope, SCOPE_VALUES, `${path}/scope`);
+    const withdraw = {
+        type: "withdraw",
+        scope,
+        target_message_id: validateIdentifier(obj.target_message_id, `${path}/target_message_id`),
+    };
+    if (obj.target_offer_id !== undefined) {
+        if (scope === "negotiation") {
+            // §9.7：negotiation 级用 envelope negotiation_id，不得伪造 object id。
+            throw new NegotiationValidationError("state_conflict", `${path}/target_offer_id must be absent for scope=negotiation (envelope negotiation_id is authoritative)`, `${path}/target_offer_id`);
+        }
+        withdraw.target_offer_id = validateIdentifier(obj.target_offer_id, `${path}/target_offer_id`);
+    }
+    if (obj.reason_code !== undefined) {
+        withdraw.reason_code = requireNonEmptyString(obj.reason_code, `${path}/reason_code`);
+    }
+    return withdraw;
+}
+export function validateDecline(value, path = "/payload") {
+    const obj = requireObject(value, path);
+    requireType(obj, "decline", path);
+    const scope = requireEnum(obj.scope, SCOPE_VALUES, `${path}/scope`);
+    const decline = {
+        type: "decline",
+        scope,
+        target_message_id: validateIdentifier(obj.target_message_id, `${path}/target_message_id`),
+    };
+    if (obj.target_offer_id !== undefined) {
+        if (scope === "negotiation") {
+            // §9.7 / §17.3：negotiation 级 decline 以 envelope negotiation_id 为准。
+            throw new NegotiationValidationError("state_conflict", `${path}/target_offer_id must be absent for scope=negotiation (envelope negotiation_id is authoritative)`, `${path}/target_offer_id`);
+        }
+        decline.target_offer_id = validateIdentifier(obj.target_offer_id, `${path}/target_offer_id`);
+    }
+    if (obj.reason_code !== undefined) {
+        decline.reason_code = requireNonEmptyString(obj.reason_code, `${path}/reason_code`);
+    }
+    return decline;
+}
+export function validateCancel(value, path = "/payload") {
+    const obj = requireObject(value, path);
+    requireType(obj, "cancel", path);
+    return { type: "cancel" };
+}
+function requireFalse(value, path) {
+    if (value !== false) {
+        throw schemaError(path, `${path} must be false (KNP/1.0 produces no order/inventory/payment side effect)`);
+    }
+    return false;
+}
+export function validateAcceptedNonbindingAgreement(value, path = "/payload") {
+    const obj = requireObject(value, path);
+    requireType(obj, "accepted_nonbinding_agreement", path);
+    const acceptedBy = requireArray(obj.accepted_by, `${path}/accepted_by`);
+    if (acceptedBy.length === 0) {
+        throw schemaError(`${path}/accepted_by`, "accepted_by must not be empty");
+    }
+    return {
+        type: "accepted_nonbinding_agreement",
+        agreement_id: validateIdentifier(obj.agreement_id, `${path}/agreement_id`),
+        negotiation_id: validateIdentifier(obj.negotiation_id, `${path}/negotiation_id`),
+        accepted_offer_id: validateIdentifier(obj.accepted_offer_id, `${path}/accepted_offer_id`),
+        agreed_terms: validateTermSet(obj.agreed_terms, `${path}/agreed_terms`),
+        terms_digest: requireDigest(obj.terms_digest, `${path}/terms_digest`),
+        accepted_by: acceptedBy.map((a, i) => requireEnum(a, ["buyer", "merchant"], `${path}/accepted_by/${i}`)),
+        created_at: requireIsoTimestamp(obj.created_at, `${path}/created_at`),
+        binding_effect: requireEnum(obj.binding_effect, ["nonbinding"], `${path}/binding_effect`),
+        creates_order: requireFalse(obj.creates_order, `${path}/creates_order`),
+        reserves_inventory: requireFalse(obj.reserves_inventory, `${path}/reserves_inventory`),
+        authorizes_payment: requireFalse(obj.authorizes_payment, `${path}/authorizes_payment`),
+    };
+}
+const PAYLOAD_VALIDATORS = {
+    inquiry: validateInquiry,
+    rfq: validateRfq,
+    offer: validateOffer,
+    counter_offer: validateCounterOffer,
+    conditional_offer: validateConditionalOffer,
+    clarification: validateClarification,
+    clarification_response: validateClarificationResponse,
+    accept_nonbinding: validateAcceptNonbinding,
+    withdraw: validateWithdraw,
+    decline: validateDecline,
+    cancel: validateCancel,
+};
+/**
+ * 按 envelope.action 校验 payload。每个 validator 强制 payload.type 与
+ * action 一致，因此 action/payload 类型不匹配会在这里被拒绝（fail-closed）。
+ */
+export function validatePayloadForAction(action, value, path = "/payload") {
+    const validator = PAYLOAD_VALIDATORS[action];
+    if (validator === undefined) {
+        throw schemaError(path, `no validator registered for action ${action}`);
+    }
+    return validator(value, path);
+}
+//# sourceMappingURL=objects.js.map

package/dist/negotiation/domain/objects.js.map

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