@harrylabsj/kiwi 0.6.0

package/dist/fanout/orchestrator.js

@@ -0,0 +1,439 @@
+/**
+ * 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 { ChannelError } from "../counterparty/index.js";
+import { finalizeEnvelope, validateEnvelope, verifyEnvelopeDigest, } from "../negotiation/domain/envelope.js";
+import { newExchangeId, newMessageId, newNegotiationId, } from "../negotiation/domain/identifiers.js";
+import { validateOffer } from "../negotiation/domain/objects.js";
+export const DEFAULT_FANOUT_TIMEOUT_MS = 30_000;
+export const DEFAULT_POLL_INTERVAL_MS = 100;
+export const DEFAULT_FANOUT_CAPABILITY = "knp.a2a.direct";
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * 缺省入站提取器：从 A2A task.status.message 的 data part 取 `knp_envelope`
+ * （§24.3 约定）。hosted 通道的调用方注入自己的 extractEnvelope。
+ */
+export function extractKnpEnvelopeFromState(state) {
+    const message = state.task?.status?.message;
+    if (message === undefined)
+        return null;
+    for (const part of message.parts) {
+        if (part.kind === "data") {
+            const data = part.data;
+            if (data !== null && typeof data === "object" && "knp_envelope" in data) {
+                const candidate = data["knp_envelope"];
+                if (candidate !== null && typeof candidate === "object") {
+                    return candidate;
+                }
+            }
+        }
+    }
+    return null;
+}
+/** 入站 envelope fail-closed（§4.5 Remote Content Is Untrusted）：schema + digest。 */
+function validateIncoming(envelope) {
+    const validated = validateEnvelope(envelope);
+    if (!verifyEnvelopeDigest(validated)) {
+        throw new Error("incoming KNP envelope digest mismatch (integrity failure)");
+    }
+    return validated;
+}
+function errorCode(err) {
+    if (err instanceof ChannelError)
+        return err.code;
+    if (err instanceof Error) {
+        const code = err.code;
+        if (typeof code === "string" && code.length > 0)
+            return code;
+        return "leg_error";
+    }
+    return "unknown";
+}
+function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+// ---------------------------------------------------------------------------
+// Offer 维度提取与比较集聚合
+// ---------------------------------------------------------------------------
+/** 从 Offer terms 提取 unit price（items[0].unit_price 优先，其次 price_terms.unit_price）。 */
+export function extractUnitPrice(terms) {
+    const first = terms.items?.[0];
+    if (first?.unit_price !== undefined)
+        return first.unit_price;
+    const price = terms.price_terms;
+    if (price !== undefined && typeof price === "object") {
+        const up = price["unit_price"];
+        if (up !== null && typeof up === "object") {
+            const candidate = up;
+            if (typeof candidate["currency"] === "string" &&
+                typeof candidate["amount_minor"] === "number") {
+                return { currency: candidate["currency"], amount_minor: candidate["amount_minor"] };
+            }
+        }
+    }
+    return null;
+}
+/** 从 Offer terms 提取交期维度。 */
+export function extractDelivery(terms) {
+    const fulfillment = terms.fulfillment_terms;
+    if (fulfillment === undefined || typeof fulfillment !== "object")
+        return {};
+    const out = {};
+    if (typeof fulfillment["delivery_before"] === "string") {
+        out.delivery_before = fulfillment["delivery_before"];
+    }
+    return out;
+}
+/**
+ * 比较集排序（确定性）：
+ *   1. 有价格在前；2. 货币分组（不同货币不做数值比较，按货币码排序）；
+ *   3. 同货币价格升序；4. 交期早优先（ISO 字符串排序 = 时间排序）；
+ *   5. identity 升序 tie-break。
+ */
+export function compareRows(a, b) {
+    const aHasPrice = a.price !== null;
+    const bHasPrice = b.price !== null;
+    if (aHasPrice !== bHasPrice)
+        return aHasPrice ? -1 : 1;
+    const aPrice = a.price;
+    const bPrice = b.price;
+    if (aPrice !== null && bPrice !== null) {
+        if (aPrice.currency !== bPrice.currency) {
+            return aPrice.currency < bPrice.currency ? -1 : 1;
+        }
+        const amountDelta = aPrice.amount_minor - bPrice.amount_minor;
+        if (amountDelta !== 0)
+            return amountDelta;
+    }
+    const aDelivery = a.delivery_before ?? "";
+    const bDelivery = b.delivery_before ?? "";
+    if (aDelivery !== bDelivery)
+        return aDelivery < bDelivery ? -1 : 1;
+    return a.identity < b.identity ? -1 : a.identity > b.identity ? 1 : 0;
+}
+/** 把各腿结果聚合为比较集（price / delivery / terms 结构化；无 Offer 的腿不进入）。 */
+export function buildComparisonSet(legs) {
+    const rows = [];
+    for (const leg of legs) {
+        if (leg.offer === undefined)
+            continue;
+        const price = extractUnitPrice(leg.offer.terms);
+        const delivery = extractDelivery(leg.offer.terms);
+        rows.push({
+            identity: leg.identity,
+            negotiation_id: leg.negotiation_id,
+            offer_id: leg.offer.offer_id,
+            price,
+            delivery_before: delivery.delivery_before,
+            terms: leg.offer.terms,
+            valid_until: leg.offer.terms.valid_until,
+        });
+    }
+    rows.sort(compareRows);
+    return rows;
+}
+// ---------------------------------------------------------------------------
+// 编排器
+// ---------------------------------------------------------------------------
+export class FanoutOrchestrator {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    clock() {
+        return this.deps.clock?.() ?? Date.now();
+    }
+    now() {
+        return this.deps.now?.() ?? new Date().toISOString();
+    }
+    capability() {
+        return this.deps.capability ?? DEFAULT_FANOUT_CAPABILITY;
+    }
+    identitySnapshot(counterparty, actor) {
+        return {
+            sender_identity: this.deps.sender_identity,
+            counterparty_identity: counterparty,
+            actor,
+        };
+    }
+    capabilitySnapshot() {
+        return { capability: this.capability(), protocol_version: "1.0" };
+    }
+    /** 每腿独立落账；缺省 Ledger 为 no-op。append 失败向上抛（audit trail 损坏 = fail-closed）。 */
+    appendLedger(content) {
+        if (this.deps.ledger === undefined)
+            return;
+        this.deps.ledger.append(content);
+    }
+    /**
+     * 向 N 个通道并行发 RFQ。Promise.allSettled 保证单腿崩溃不吞掉其他腿结果
+     * （部分失败容忍，§19）。每腿独立 negotiation_id / message_id。
+     */
+    async fanout(legs) {
+        const started_at = this.now();
+        const settled = await Promise.allSettled(legs.map((leg) => this.runLeg(leg)));
+        const legResults = settled.map((result, i) => {
+            if (result.status === "fulfilled")
+                return result.value;
+            const spec = legs[i];
+            return {
+                identity: spec?.profile.identity ?? "unknown",
+                negotiation_id: spec?.negotiation_id ?? "",
+                message_id: "",
+                outcome: "failed",
+                error: { code: "leg_crash", message: errorMessage(result.reason) },
+                elapsed_ms: 0,
+            };
+        });
+        return {
+            offers: buildComparisonSet(legResults),
+            legs: legResults,
+            offer_count: legResults.filter((leg) => leg.offer !== undefined).length,
+            started_at,
+            completed_at: this.now(),
+        };
+    }
+    async runLeg(spec) {
+        const identity = spec.profile.identity;
+        const negotiation_id = spec.negotiation_id ?? newNegotiationId();
+        const messageId = newMessageId();
+        const timeoutMs = spec.timeoutMs ?? DEFAULT_FANOUT_TIMEOUT_MS;
+        const started = this.clock();
+        const occurredAt = this.now();
+        const envelope = finalizeEnvelope({
+            capability: this.capability(),
+            protocol_version: "1.0",
+            negotiation_id,
+            exchange_id: newExchangeId(),
+            message_id: messageId,
+            actor: "buyer",
+            action: "rfq",
+            created_at: occurredAt,
+            payload: spec.payload.rfq,
+        });
+        // 落账 fan-out 起点（每腿独立链）。失败 fail-closed。
+        try {
+            this.appendLedger({
+                event_kind: "system",
+                negotiation_id,
+                message_id: messageId,
+                identity: this.identitySnapshot(identity, "buyer"),
+                capability: this.capabilitySnapshot(),
+                wire_digest: envelope.digest,
+                wire_payload: envelope,
+                outcome: { kind: "ok", result: { phase: "fanout_round_send", tier: spec.payload.tier } },
+                occurred_at: occurredAt,
+            });
+        }
+        catch (err) {
+            return {
+                identity,
+                negotiation_id,
+                message_id: messageId,
+                outcome: "failed",
+                error: { code: "ledger_append_failed", message: errorMessage(err) },
+                elapsed_ms: this.clock() - started,
+            };
+        }
+        let handle = null;
+        try {
+            handle = await this.deps.openChannel(spec.profile, {
+                negotiation_id,
+                sender_identity: this.deps.sender_identity,
+                identity,
+                timeoutMs,
+            });
+            const sendResult = await handle.send({
+                envelope,
+                ref: { negotiation_id },
+            });
+            const wait = await this.waitForOffer(handle, sendResult.ref, timeoutMs, messageId, negotiation_id);
+            return this.resolveWait(identity, negotiation_id, messageId, started, wait);
+        }
+        catch (err) {
+            return {
+                identity,
+                negotiation_id,
+                message_id: messageId,
+                outcome: "failed",
+                error: { code: errorCode(err), message: errorMessage(err) },
+                elapsed_ms: this.clock() - started,
+            };
+        }
+        finally {
+            if (handle !== null) {
+                await handle.close().catch(() => undefined);
+            }
+        }
+    }
+    /** 带超时的 Offer 收集：轮询 getState 直到 deadline / 收到新 envelope / 终态。 */
+    async waitForOffer(handle, ref, timeoutMs, sentMessageId, negotiationId) {
+        const deadline = this.clock() + timeoutMs;
+        const pollInterval = this.deps.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+        const extract = this.deps.extractEnvelope ?? extractKnpEnvelopeFromState;
+        for (;;) {
+            if (this.clock() >= deadline) {
+                return { kind: "timeout" };
+            }
+            const state = await handle.getState(ref);
+            if (state.state === "failed") {
+                return { kind: "task_failed", state: state.state };
+            }
+            if (state.state === "canceled") {
+                return { kind: "terminal_no_offer", reason: "canceled" };
+            }
+            const envelope = extract(state);
+            if (envelope !== null &&
+                envelope.message_id !== sentMessageId &&
+                // 关联校验（评审项 P3-6）：只接受本腿 negotiation 的 envelope——对端
+                // 回传旧 round 或另一磋商的 offer 会污染比较集与审计链（此前只排除
+                // 自身回声，任一格式合法 envelope 都被当本腿报价接受）。无关
+                // envelope 忽略并继续轮询：deadline 兜底，绝不采用无关数据。
+                envelope.negotiation_id === negotiationId) {
+                return { kind: "envelope", envelope };
+            }
+            if (state.stable) {
+                return { kind: "terminal_no_offer", reason: "stable_without_envelope" };
+            }
+            await sleep(pollInterval);
+        }
+    }
+    /** 把 wait 结果解析为 leg outcome，并落账该腿结果（fail-closed）。 */
+    resolveWait(identity, negotiation_id, messageId, started, wait) {
+        const elapsed = this.clock() - started;
+        const occurredAt = this.now();
+        const identitySnapshot = this.identitySnapshot(identity, "buyer");
+        const capability = this.capabilitySnapshot();
+        const record = (content) => {
+            this.appendLedger({ ...content, negotiation_id, identity: identitySnapshot, capability });
+        };
+        switch (wait.kind) {
+            case "envelope": {
+                // 入站 envelope fail-closed：schema + digest（§4.5）。
+                const incoming = validateIncoming(wait.envelope);
+                // 归属校验防御纵深（评审项 P3-6）：waitForOffer 已过滤无关 negotiation
+                // 的 envelope，独立入口再核对一次——任何路径都不采用不属于本腿的
+                // 数据（校验失败抛错 → leg failed，fail-closed）。
+                if (incoming.negotiation_id !== negotiation_id) {
+                    throw new Error(`incoming envelope belongs to negotiation ${incoming.negotiation_id}, expected ${negotiation_id}`);
+                }
+                if (incoming.action === "offer") {
+                    const offer = validateOffer(incoming.payload);
+                    record({
+                        event_kind: "system",
+                        message_id: messageId,
+                        wire_digest: incoming.digest,
+                        wire_payload: incoming,
+                        outcome: {
+                            kind: "ok",
+                            result: { leg_outcome: "offer_received", offer_id: offer.offer_id },
+                        },
+                        occurred_at: occurredAt,
+                    });
+                    return {
+                        identity,
+                        negotiation_id,
+                        message_id: messageId,
+                        outcome: "offer_received",
+                        offer,
+                        elapsed_ms: elapsed,
+                    };
+                }
+                if (incoming.action === "decline") {
+                    record({
+                        event_kind: "system",
+                        message_id: messageId,
+                        wire_digest: incoming.digest,
+                        wire_payload: incoming,
+                        outcome: { kind: "ok", result: { leg_outcome: "declined" } },
+                        occurred_at: occurredAt,
+                    });
+                    return {
+                        identity,
+                        negotiation_id,
+                        message_id: messageId,
+                        outcome: "declined",
+                        elapsed_ms: elapsed,
+                    };
+                }
+                record({
+                    event_kind: "system",
+                    message_id: messageId,
+                    wire_digest: incoming.digest,
+                    wire_payload: incoming,
+                    outcome: { kind: "ok", result: { leg_outcome: "no_offer", action: incoming.action } },
+                    occurred_at: occurredAt,
+                });
+                return {
+                    identity,
+                    negotiation_id,
+                    message_id: messageId,
+                    outcome: "no_offer",
+                    elapsed_ms: elapsed,
+                };
+            }
+            case "timeout": {
+                record({
+                    event_kind: "error",
+                    message_id: messageId,
+                    outcome: { kind: "error", code: "timeout", message: "no offer received within timeout" },
+                    occurred_at: occurredAt,
+                });
+                return {
+                    identity,
+                    negotiation_id,
+                    message_id: messageId,
+                    outcome: "timed_out",
+                    error: { code: "timeout", message: "no offer received within timeout" },
+                    elapsed_ms: elapsed,
+                };
+            }
+            case "task_failed": {
+                record({
+                    event_kind: "error",
+                    message_id: messageId,
+                    outcome: { kind: "error", code: "remote_task_failed", message: wait.state },
+                    occurred_at: occurredAt,
+                });
+                return {
+                    identity,
+                    negotiation_id,
+                    message_id: messageId,
+                    outcome: "failed",
+                    error: { code: "remote_task_failed", message: wait.state },
+                    elapsed_ms: elapsed,
+                };
+            }
+            case "terminal_no_offer": {
+                record({
+                    event_kind: "system",
+                    message_id: messageId,
+                    outcome: { kind: "ok", result: { leg_outcome: "no_offer", reason: wait.reason } },
+                    occurred_at: occurredAt,
+                });
+                return {
+                    identity,
+                    negotiation_id,
+                    message_id: messageId,
+                    outcome: "no_offer",
+                    elapsed_ms: elapsed,
+                };
+            }
+        }
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/fanout/orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../../src/fanout/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA4BH,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,aAAa,EACb,YAAY,EACZ,gBAAgB,GACjB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAMjE,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC;AAChD,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAC5C,MAAM,CAAC,MAAM,yBAAyB,GAAG,gBAAgB,CAAC;AA4E1D,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CAAC,KAAkB;IAC5D,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC;IAC5C,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACjC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;YACvB,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,cAAc,IAAI,IAAI,EAAE,CAAC;gBACxE,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC;gBACvC,IAAI,SAAS,KAAK,IAAI,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;oBACxD,OAAO,SAAgC,CAAC;gBAC1C,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,iFAAiF;AACjF,SAAS,gBAAgB,CAAC,QAA6B;IACrD,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC7C,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,SAAS,CAAC,GAAY;IAC7B,IAAI,GAAG,YAAY,YAAY;QAAE,OAAO,GAAG,CAAC,IAAI,CAAC;IACjD,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAI,GAA0B,CAAC,IAAI,CAAC;QAC9C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAC7D,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,YAAY,CAAC,GAAY;IAChC,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,qFAAqF;AACrF,MAAM,UAAU,gBAAgB,CAC9B,KAAc;IAEd,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/B,IAAI,KAAK,EAAE,UAAU,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,UAAU,CAAC;IAC7D,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,CAAC;IAChC,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrD,MAAM,EAAE,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC;QAC/B,IAAI,EAAE,KAAK,IAAI,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC1C,MAAM,SAAS,GAAG,EAA6B,CAAC;YAChD,IACE,OAAO,SAAS,CAAC,UAAU,CAAC,KAAK,QAAQ;gBACzC,OAAO,SAAS,CAAC,cAAc,CAAC,KAAK,QAAQ,EAC7C,CAAC;gBACD,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,UAAU,CAAC,EAAE,YAAY,EAAE,SAAS,CAAC,cAAc,CAAC,EAAE,CAAC;YACtF,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,MAAM,WAAW,GAAG,KAAK,CAAC,iBAAiB,CAAC;IAC5C,IAAI,WAAW,KAAK,SAAS,IAAI,OAAO,WAAW,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAC5E,MAAM,GAAG,GAAiC,EAAE,CAAC;IAC7C,IAAI,OAAO,WAAW,CAAC,iBAAiB,CAAC,KAAK,QAAQ,EAAE,CAAC;QACvD,GAAG,CAAC,eAAe,GAAG,WAAW,CAAC,iBAAiB,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,CAAsB,EAAE,CAAsB;IACxE,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC;IACnC,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC;IACnC,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC;IACvB,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC;IACvB,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACvC,IAAI,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ,EAAE,CAAC;YACxC,OAAO,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpD,CAAC;QACD,MAAM,WAAW,GAAG,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QAC9D,IAAI,WAAW,KAAK,CAAC;YAAE,OAAO,WAAW,CAAC;IAC5C,CAAC;IACD,MAAM,SAAS,GAAG,CAAC,CAAC,eAAe,IAAI,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAG,CAAC,CAAC,eAAe,IAAI,EAAE,CAAC;IAC1C,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,OAAO,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACxE,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,kBAAkB,CAAC,IAAuB;IACxD,MAAM,IAAI,GAA0B,EAAE,CAAC;IACvC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS;YAAE,SAAS;QACtC,MAAM,KAAK,GAAG,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,CAAC;YACR,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,cAAc,EAAE,GAAG,CAAC,cAAc;YAClC,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,QAAQ;YAC5B,KAAK;YACL,eAAe,EAAE,QAAQ,CAAC,eAAe;YACzC,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,KAA2C;YAC5D,WAAW,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW;SACzC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACvB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8EAA8E;AAC9E,MAAM;AACN,8EAA8E;AAE9E,MAAM,OAAO,kBAAkB;IACZ,IAAI,CAAyB;IAE9C,YAAY,IAA4B;QACtC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAEO,KAAK;QACX,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;IAC3C,CAAC;IAEO,GAAG;QACT,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACvD,CAAC;IAEO,UAAU;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,yBAAyB,CAAC;IAC3D,CAAC;IAEO,gBAAgB,CACtB,YAAoB,EACpB,KAAwB;QAExB,OAAO;YACL,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,eAAe;YAC1C,qBAAqB,EAAE,YAAY;YACnC,KAAK;SACN,CAAC;IACJ,CAAC;IAEO,kBAAkB;QACxB,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC;IACpE,CAAC;IAED,2EAA2E;IACnE,YAAY,CAAC,OAA2B;QAC9C,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO;QAC3C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,IAAqB;QAChC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC9E,MAAM,UAAU,GAAsB,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YAC9D,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW;gBAAE,OAAO,MAAM,CAAC,KAAK,CAAC;YACvD,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACrB,OAAO;gBACL,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,IAAI,SAAS;gBAC7C,cAAc,EAAE,IAAI,EAAE,cAAc,IAAI,EAAE;gBAC1C,UAAU,EAAE,EAAE;gBACd,OAAO,EAAE,QAAiB;gBAC1B,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;gBAClE,UAAU,EAAE,CAAC;aACd,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,OAAO;YACL,MAAM,EAAE,kBAAkB,CAAC,UAAU,CAAC;YACtC,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,MAAM;YACvE,UAAU;YACV,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE;SACzB,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,IAAmB;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;QACvC,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,IAAI,gBAAgB,EAAE,CAAC;QACjE,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,yBAAyB,CAAC;QAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE9B,MAAM,QAAQ,GAAG,gBAAgB,CAAC;YAChC,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE;YAC7B,gBAAgB,EAAE,KAAK;YACvB,cAAc;YACd,WAAW,EAAE,aAAa,EAAE;YAC5B,UAAU,EAAE,SAAS;YACrB,KAAK,EAAE,OAAO;YACd,MAAM,EAAE,KAAK;YACb,UAAU,EAAE,UAAU;YACtB,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG;SAC1B,CAAC,CAAC;QAEH,uCAAuC;QACvC,IAAI,CAAC;YACH,IAAI,CAAC,YAAY,CAAC;gBAChB,UAAU,EAAE,QAAQ;gBACpB,cAAc;gBACd,UAAU,EAAE,SAAS;gBACrB,QAAQ,EAAE,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC;gBAClD,UAAU,EAAE,IAAI,CAAC,kBAAkB,EAAE;gBACrC,WAAW,EAAE,QAAQ,CAAC,MAAM;gBAC5B,YAAY,EAAE,QAA8C;gBAC5D,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE;gBACxF,WAAW,EAAE,UAAU;aACxB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,QAAQ;gBACR,cAAc;gBACd,UAAU,EAAE,SAAS;gBACrB,OAAO,EAAE,QAAQ;gBACjB,KAAK,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE;gBACnE,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,OAAO;aACnC,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,GAAyB,IAAI,CAAC;QACxC,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE;gBACjD,cAAc;gBACd,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,eAAe;gBAC1C,QAAQ;gBACR,SAAS;aACV,CAAC,CAAC;YACH,MAAM,UAAU,GAAsB,MAAM,MAAM,CAAC,IAAI,CAAC;gBACtD,QAAQ;gBACR,GAAG,EAAE,EAAE,cAAc,EAAE;aACxB,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;YACnG,OAAO,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAC9E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,QAAQ;gBACR,cAAc;gBACd,UAAU,EAAE,SAAS;gBACrB,OAAO,EAAE,QAAQ;gBACjB,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE;gBAC3D,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,OAAO;aACnC,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;IACH,CAAC;IAED,iEAAiE;IACzD,KAAK,CAAC,YAAY,CACxB,MAAqB,EACrB,GAAc,EACd,SAAiB,EACjB,aAAqB,EACrB,aAAqB;QAErB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,SAAS,CAAC;QAC1C,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,IAAI,wBAAwB,CAAC;QAC1E,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,IAAI,2BAA2B,CAAC;QACzE,SAAS,CAAC;YACR,IAAI,IAAI,CAAC,KAAK,EAAE,IAAI,QAAQ,EAAE,CAAC;gBAC7B,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;YAC7B,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YACzC,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC7B,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;YACrD,CAAC;YACD,IAAI,KAAK,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;gBAC/B,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;YAC3D,CAAC;YACD,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;YAChC,IACE,QAAQ,KAAK,IAAI;gBACjB,QAAQ,CAAC,UAAU,KAAK,aAAa;gBACrC,kDAAkD;gBAClD,0CAA0C;gBAC1C,qCAAqC;gBACrC,yCAAyC;gBACzC,QAAQ,CAAC,cAAc,KAAK,aAAa,EACzC,CAAC;gBACD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;YACxC,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjB,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,yBAAyB,EAAE,CAAC;YAC1E,CAAC;YACD,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,qDAAqD;IAC7C,WAAW,CACjB,QAAgB,EAChB,cAAsB,EACtB,SAAiB,EACjB,OAAe,EACf,IAAiB;QAEjB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,OAAO,CAAC;QACvC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC9B,MAAM,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAClE,MAAM,UAAU,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAG,CACb,OAA+E,EAC/E,EAAE;YACF,IAAI,CAAC,YAAY,CAAC,EAAE,GAAG,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,gBAAgB,EAAE,UAAU,EAAE,CAAC,CAAC;QAC5F,CAAC,CAAC;QAEF,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,UAAU,CAAC,CAAC,CAAC;gBAChB,iDAAiD;gBACjD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACjD,oDAAoD;gBACpD,uCAAuC;gBACvC,uCAAuC;gBACvC,IAAI,QAAQ,CAAC,cAAc,KAAK,cAAc,EAAE,CAAC;oBAC/C,MAAM,IAAI,KAAK,CACb,4CAA4C,QAAQ,CAAC,cAAc,cAAc,cAAc,EAAE,CAClG,CAAC;gBACJ,CAAC;gBACD,IAAI,QAAQ,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;oBAChC,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;oBAC9C,MAAM,CAAC;wBACL,UAAU,EAAE,QAAQ;wBACpB,UAAU,EAAE,SAAS;wBACrB,WAAW,EAAE,QAAQ,CAAC,MAAM;wBAC5B,YAAY,EAAE,QAA8C;wBAC5D,OAAO,EAAE;4BACP,IAAI,EAAE,IAAI;4BACV,MAAM,EAAE,EAAE,WAAW,EAAE,gBAAgB,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE;yBACpE;wBACD,WAAW,EAAE,UAAU;qBACxB,CAAC,CAAC;oBACH,OAAO;wBACL,QAAQ;wBACR,cAAc;wBACd,UAAU,EAAE,SAAS;wBACrB,OAAO,EAAE,gBAAgB;wBACzB,KAAK;wBACL,UAAU,EAAE,OAAO;qBACpB,CAAC;gBACJ,CAAC;gBACD,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;oBAClC,MAAM,CAAC;wBACL,UAAU,EAAE,QAAQ;wBACpB,UAAU,EAAE,SAAS;wBACrB,WAAW,EAAE,QAAQ,CAAC,MAAM;wBAC5B,YAAY,EAAE,QAA8C;wBAC5D,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE;wBAC5D,WAAW,EAAE,UAAU;qBACxB,CAAC,CAAC;oBACH,OAAO;wBACL,QAAQ;wBACR,cAAc;wBACd,UAAU,EAAE,SAAS;wBACrB,OAAO,EAAE,UAAU;wBACnB,UAAU,EAAE,OAAO;qBACpB,CAAC;gBACJ,CAAC;gBACD,MAAM,CAAC;oBACL,UAAU,EAAE,QAAQ;oBACpB,UAAU,EAAE,SAAS;oBACrB,WAAW,EAAE,QAAQ,CAAC,MAAM;oBAC5B,YAAY,EAAE,QAA8C;oBAC5D,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,EAAE;oBACrF,WAAW,EAAE,UAAU;iBACxB,CAAC,CAAC;gBACH,OAAO;oBACL,QAAQ;oBACR,cAAc;oBACd,UAAU,EAAE,SAAS;oBACrB,OAAO,EAAE,UAAU;oBACnB,UAAU,EAAE,OAAO;iBACpB,CAAC;YACJ,CAAC;YACD,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,MAAM,CAAC;oBACL,UAAU,EAAE,OAAO;oBACnB,UAAU,EAAE,SAAS;oBACrB,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,kCAAkC,EAAE;oBACxF,WAAW,EAAE,UAAU;iBACxB,CAAC,CAAC;gBACH,OAAO;oBACL,QAAQ;oBACR,cAAc;oBACd,UAAU,EAAE,SAAS;oBACrB,OAAO,EAAE,WAAW;oBACpB,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,kCAAkC,EAAE;oBACvE,UAAU,EAAE,OAAO;iBACpB,CAAC;YACJ,CAAC;YACD,KAAK,aAAa,CAAC,CAAC,CAAC;gBACnB,MAAM,CAAC;oBACL,UAAU,EAAE,OAAO;oBACnB,UAAU,EAAE,SAAS;oBACrB,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE;oBAC3E,WAAW,EAAE,UAAU;iBACxB,CAAC,CAAC;gBACH,OAAO;oBACL,QAAQ;oBACR,cAAc;oBACd,UAAU,EAAE,SAAS;oBACrB,OAAO,EAAE,QAAQ;oBACjB,KAAK,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE;oBAC1D,UAAU,EAAE,OAAO;iBACpB,CAAC;YACJ,CAAC;YACD,KAAK,mBAAmB,CAAC,CAAC,CAAC;gBACzB,MAAM,CAAC;oBACL,UAAU,EAAE,QAAQ;oBACpB,UAAU,EAAE,SAAS;oBACrB,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE;oBACjF,WAAW,EAAE,UAAU;iBACxB,CAAC,CAAC;gBACH,OAAO;oBACL,QAAQ;oBACR,cAAc;oBACd,UAAU,EAAE,SAAS;oBACrB,OAAO,EAAE,UAAU;oBACnB,UAAU,EAAE,OAAO;iBACpB,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/fanout/policy.d.ts

@@ -0,0 +1,128 @@
+/**
+ * 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.
+ */
+/**
+ * fanout — RFQ Fan-out 隐私策略（基线 §30）。
+ *
+ * Fan-out 受 max_recipients / minimum_trust / disclosure_profile /
+ * anonymous_first_round / category_sensitivity 控制（§30）。本模块实现
+ * FanoutPolicy 类型 + 确定性判定函数 judgeFanout：
+ *
+ *   输入候选 CounterpartyProfile 集合（含每人的 TrustRecord 推导 trust level）
+ *   → 输出接受者集合 + 每人的披露档位（DisclosureTier）。
+ *
+ * 判定规则确定、可测、无模型参与：
+ *   - minimum_trust 过滤（eligibility，§30）：record 缺失按 T0 判定；rejected
+ *     对端直接排除（fail-closed，§4.6）；只按 base minimum_trust 过滤，敏感品类
+ *     不改变谁能收 RFQ；
+ *   - category_sensitivity 提升披露门槛（disclosure gate）：命中敏感品类时
+ *     round 1 强制匿名首轮；round 2 对信任低于 sensitivity.minimum_trust 的
+ *     接收者封顶为匿名档（拿不到精确数量/交期）；
+ *   - max_recipients 截断：先按 trust 降序 + identity 升序确定性排序，再取前 N，
+ *     其余以 reason=truncated 记录；
+ *   - 每人的披露档位由 round（1 匿名首轮 / 2 Top N 精化）与敏感性共同决定
+ *     （§30 推荐 progressive disclosure，而非默认广播完整需求）。
+ *
+ * §28 语义沿用：trust level 只控制协议/自动化风险，不构成产品推荐等级。
+ */
+import type { CounterpartyProfile } from "../counterparty/index.js";
+import type { TrustLevel } from "../trust/identity/index.js";
+/** 披露档位：anonymous = 匿名首轮（SKU + 数量区间，无精确数量/交期/身份线索）；detailed = Top N 后的精确数量 + 交期要求。 */
+export type DisclosureTier = "anonymous" | "detailed";
+export declare const DISCLOSURE_TIERS: readonly DisclosureTier[];
+/** §29 NetworkDisclosurePolicy 控制的属性清单。 */
+export declare const DISCLOSURE_ATTRIBUTES: readonly ["location_precision", "organization_identity", "buyer_urgency", "contact_information", "purchase_quantity", "budget_hints", "customer_segment", "historical_preferences"];
+export type DisclosureAttribute = (typeof DISCLOSURE_ATTRIBUTES)[number];
+/** 披露档位（§30）：只声明「哪些 §29 属性允许公开」；余者一律私有。 */
+export interface DisclosureProfile {
+    allowed_attributes: readonly DisclosureAttribute[];
+}
+/** 默认披露档位：仅允许采购数量（round 2 精确数量）。预算/急迫度/身份等默认私有（§4.4）。 */
+export declare const DEFAULT_DISCLOSURE_PROFILE: DisclosureProfile;
+/** 敏感品类规则：匹配 category 时提升披露门槛（§30）。 */
+export interface CategorySensitivity {
+    /** 品类匹配（大小写不敏感子串；缺省匹配任意品类）。 */
+    category?: string;
+    /** 敏感品类的最低信任要求（与 policy.minimum_trust 取更严格者）。 */
+    minimum_trust?: TrustLevel;
+    /** 敏感品类是否强制匿名首轮（无论 policy.anonymous_first_round）。 */
+    anonymous_first_round?: boolean;
+}
+/** §30 五个控制字段。max_recipients 缺省不限；minimum_trust 必填。 */
+export interface FanoutPolicy {
+    /** 接收者上限；0/负数视为不限。 */
+    max_recipients?: number;
+    /** 默认最低信任要求；无 record 对端按 T0 判定。 */
+    minimum_trust: TrustLevel;
+    /** §29 属性 allowlist（detailed 档的可选项）。 */
+    disclosure_profile: DisclosureProfile;
+    /** 匿名首轮：round 1 向所有接收者发匿名档（progressive disclosure）。 */
+    anonymous_first_round?: boolean;
+    /** 敏感品类提升披露门槛。 */
+    category_sensitivity?: readonly CategorySensitivity[];
+}
+/** 默认部署策略：推荐 progressive disclosure（§30），最多 5 家、最低 T1。 */
+export declare const DEFAULT_FANOUT_POLICY: FanoutPolicy;
+/** 每人信任信号：level + rejected（来自 TrustRecord 评估）；缺省 undefined → T0 且不拒绝。 */
+export interface FanoutTrustSignal {
+    level: TrustLevel;
+    rejected?: boolean;
+}
+export type FanoutTrustInput = Readonly<Record<string, FanoutTrustSignal | undefined>>;
+export interface FanoutRecipient {
+    identity: string;
+    profile: CounterpartyProfile;
+    /** 解析后的信任等级（record 缺失 → T0）。 */
+    trust_level: TrustLevel;
+    /** 该轮次给此接收者的披露档位。 */
+    tier: DisclosureTier;
+}
+export type FanoutExcludeReason = "rejected" | "below_minimum_trust" | "truncated";
+export interface FanoutExcluded {
+    identity: string;
+    reason: FanoutExcludeReason;
+    trust_level: TrustLevel;
+}
+export interface FanoutDecision {
+    round: 1 | 2;
+    /** 通过过滤 + 截断的接收者（确定性排序：trust 降序 → identity 升序）。 */
+    recipients: FanoutRecipient[];
+    /** 被过滤/截断的候选（reason 明确，供审计）。 */
+    excluded: FanoutExcluded[];
+    /** 过滤后、截断前的候选数（diagnostic）。 */
+    eligible_count: number;
+    /** 本次判定是否命中敏感品类。 */
+    category_sensitive: boolean;
+}
+export interface FanoutJudgeInput {
+    profiles: CounterpartyProfile[];
+    /** identity → 信任信号；undefined = 无 TrustRecord → T0（§30）。 */
+    trust?: FanoutTrustInput;
+    /** 品类（category_sensitivity 匹配用）。 */
+    category?: string;
+    /** 轮次：1 = 匿名首轮，2 = Top N 后精化。决定每档 tier。 */
+    round: 1 | 2;
+}
+/** 取更严格（更高 rank）的信任要求：T3 比 T0 更严格。通用工具，供策略组合使用。 */
+export declare function stricterTrust(a: TrustLevel, b: TrustLevel): TrustLevel;
+/** 命中敏感品类规则（大小写不敏感子串匹配；缺省 rule 匹配任意品类）。 */
+export declare function matchingCategorySensitivity(policy: FanoutPolicy, category: string | undefined): CategorySensitivity | undefined;
+/**
+ * Fan-out 确定性判定（§30）。纯函数、无模型参与、无 I/O。
+ *
+ * 管线：解析信任 → 过滤（rejected / below_minimum_trust，按 base minimum_trust）
+ * → 确定性排序 → 截断（max_recipients）→ 按 round + 敏感性定每档 tier。
+ */
+export declare function judgeFanout(policy: FanoutPolicy, input: FanoutJudgeInput): FanoutDecision;