@harrylabsj/kiwi 0.7.21 → 0.8.0

package/dist/product-supplier.d.ts

@@ -0,0 +1,148 @@
+/**
+ * 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 SupplierRelationshipType } from "./agent/supplier/store.js";
+export interface SupplierCommandOptions {
+    dataDir?: string;
+    agentId?: string;
+}
+export interface SupplierSummary {
+    relationship_id: string;
+    merchant_id: string;
+    canonical_domain: string;
+    relationship_type: SupplierRelationshipType;
+    status: string;
+    consent_source: string;
+    scope: Record<string, unknown>;
+    policy: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+    expires_at?: string;
+}
+export interface SupplierSaveOptions extends SupplierCommandOptions {
+    merchantId: string;
+    catalogUrl?: string;
+}
+/** `kiwi buyer supplier save <merchant-id>`：保存身份，不轮询（§2.1）。 */
+export declare function supplierSave(options: SupplierSaveOptions): Promise<SupplierSummary>;
+export interface SupplierWatchOptions extends SupplierCommandOptions {
+    merchantId: string;
+    catalogUrl?: string;
+    query?: string;
+    region?: string;
+    /** 轮询间隔（秒）；缺省 6h，下限 1h（§8：不做分钟级轮询）。 */
+    intervalSeconds?: number;
+    /** 如 "90d"；缺省 90d，主动观察关系不允许无限期。 */
+    expires?: string;
+    yes?: boolean;
+    confirm?: () => Promise<boolean>;
+}
+/** `kiwi buyer supplier watch <merchant-id>`：建立主动观察规则（§2.2）。 */
+export declare function supplierWatch(options: SupplierWatchOptions): Promise<SupplierSummary>;
+export interface SupplierPreferOptions extends SupplierCommandOptions {
+    merchantId: string;
+    catalogUrl?: string;
+    scope?: string;
+    /** 如 "90d"（§11 CLI 形式）。 */
+    expires?: string;
+    yes?: boolean;
+    confirm?: () => Promise<boolean>;
+}
+/** `kiwi buyer supplier prefer <merchant-id>`：采购范围内的软偏好（§2.3）。 */
+export declare function supplierPrefer(options: SupplierPreferOptions): Promise<SupplierSummary>;
+/** `kiwi buyer supplier list`。 */
+export declare function supplierList(options: SupplierCommandOptions): Promise<SupplierSummary[]>;
+export interface SupplierIdOptions extends SupplierCommandOptions {
+    relationshipId: string;
+}
+/** `kiwi buyer supplier pause <relationship-id>`。 */
+export declare function supplierPause(options: SupplierIdOptions): Promise<SupplierSummary>;
+/**
+ * `kiwi buyer supplier remove <relationship-id>`：软删——立即停止后续拉取并
+ * 清除未来调度（§11）。M3 之前 receipt_status 恒为 none，无需远端 revoke；
+ * 若将来存在有效 receipt，先 best-effort revoke 但远端不可达不阻塞本地删除。
+ */
+export declare function supplierRemove(options: SupplierIdOptions): Promise<SupplierSummary>;
+export interface SupplierMetricsOptions extends SupplierCommandOptions {
+    /** 测试注入时钟；缺省真实时间。 */
+    now?: () => string;
+}
+/** 比率指标：永远给出分子/分母；分母为 0 时 value=null（不虚报 0 或 1）。 */
+export interface RatioMetric {
+    value: number | null;
+    numerator: number;
+    denominator: number;
+    note?: string;
+}
+export interface SupplierMetricsReport {
+    generated_at: string;
+    principal_id: string;
+    /** Qualified RFQ 的可计算代理口径（仓库内无更严格定义）。 */
+    qualified_rfq_definition: string;
+    successful_rfqs: number;
+    failed_rfqs: number;
+    /** §14 save-after-RFQ conversion：7 天内同 merchant 建立关系的建议占比。 */
+    save_after_rfq: RatioMetric;
+    /** §14 active watched/preferred relationships + 全量 type×status 分布。 */
+    relationships_by_type_status: {
+        total: number;
+        active_watched_preferred: number;
+        buckets: {
+            relationship_type: string;
+            status: string;
+            count: number;
+        }[];
+    };
+    /** §14 7/30 天关系复用率（分母=建立已满窗口的关系，避免新关系虚低）。 */
+    reuse_7d: RatioMetric;
+    reuse_30d: RatioMetric;
+    /** §14 relationship-assisted Qualified RFQ。 */
+    relationship_assisted_rfq: RatioMetric;
+    /** §14 重复 Merchant / Buyer（单 principal 本地视角，buyer 恒为 1）。 */
+    repeat_merchants: {
+        merchants_with_successful_rfq: number;
+        merchants_with_repeat_rfq: number;
+        successful_rfqs: number;
+        unidentified_merchant_rfqs: number;
+    };
+    observations: {
+        total: number;
+        by_kind: Record<string, number>;
+        /** 可计算代理：observation 对应关系当前仍是 active watched 的占比。 */
+        on_active_watched: RatioMetric;
+        /** 严格通知命中率本地无记录，恒 null。 */
+        notification_hit_rate: {
+            value: null;
+            note: string;
+        };
+    };
+    /** §14 暂停率和删除率（占全部关系，含 deleted）。 */
+    lifecycle: {
+        paused: RatioMetric;
+        deleted: RatioMetric;
+    };
+    /** §14 identity-change review 与 stale/unreachable 代理。 */
+    health: {
+        review_required: RatioMetric;
+        degraded_sources: RatioMetric;
+    };
+}
+/**
+ * `kiwi buyer supplier metrics`（§13 M0 / §14）：Buyer 本地只读指标。全部数据
+ * 来自本机 state.sqlite（supplier_relationships / supplier_observations /
+ * supplier_observation_state / task_events），单 principal 视角。算不出来的
+ * 指标如实给 null + 原因，不编造。
+ */
+export declare function supplierMetrics(options?: SupplierMetricsOptions): Promise<SupplierMetricsReport>;

package/dist/product-supplier.js

@@ -0,0 +1,452 @@
+/**
+ * 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.
+ */
+/**
+ * 产品层 `kiwi buyer supplier` 命令实现（pull-relationship 设计 v0.1 §11，M1）。
+ *
+ * 关系是 Buyer Core 本地私有状态：save/watch/prefer 通过 kiwi-catalog 解析
+ * Merchant 公开 record（canonical_domain / agent_card_url / ucp_profile_url），
+ * 写入本地 supplier_relationships；Merchant 侧无任何写入通道。
+ *
+ * watched / preferred 默认要求人类明确确认（consent_source = human_explicit）：
+ * 非交互环境必须显式传 --yes，否则拒绝。
+ */
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { agentDataDir, openAgentDatabase } from "./agent/agent-db.js";
+import { SupplierRelationshipStore, assertSupplierEndpointAuthority, } from "./agent/supplier/store.js";
+import { KiwiCatalogSource } from "./discovery/catalog-source/kiwi-source.js";
+import { DEFAULT_CATALOG_URL } from "./product-cli.js";
+function openSupplierStore(options) {
+    const dataDir = options.dataDir ?? agentDataDir(options.agentId ?? "kiwi-assistant");
+    const dbPath = path.join(dataDir, "state.sqlite");
+    if (!existsSync(dbPath)) {
+        throw new Error(`没有 Buyer 数据（${dbPath} 不存在）——先运行 \`kiwi buyer start\` 初始化本地 Buyer Core`);
+    }
+    const db = openAgentDatabase(dbPath);
+    try {
+        const principal = db
+            .prepare("SELECT principal_id FROM principals WHERE role = 'buyer' ORDER BY created_at LIMIT 1")
+            .get();
+        if (principal === undefined) {
+            throw new Error("本地 Buyer principal 不存在——先运行 `kiwi buyer start` 完成初始化");
+        }
+        const store = new SupplierRelationshipStore({ db, principalId: principal.principal_id });
+        return { db, store, principalId: principal.principal_id };
+    }
+    catch (err) {
+        db.close();
+        throw err;
+    }
+}
+/** 从 kiwi-catalog 解析 Merchant 公开 record（save/watch/prefer 共用的身份来源）。 */
+async function resolveMerchant(catalogUrl, merchantId) {
+    const source = new KiwiCatalogSource({ baseUrl: catalogUrl });
+    const record = await source.getRecord(merchantId);
+    if (record.agent_card_url === undefined) {
+        throw new Error(`catalog record ${merchantId} 没有 agent_card_url，无法建立供应商关系`);
+    }
+    if (record.administrative_state !== "active" ||
+        record.freshness_state === "unreachable" ||
+        record.verification_level === "discovered") {
+        throw new Error(`catalog record ${merchantId} 当前不可建立自动供应商关系` +
+            `（admin=${record.administrative_state}, freshness=${record.freshness_state}, verification=${record.verification_level}）`);
+    }
+    assertSupplierEndpointAuthority(record.canonical_domain, record.agent_card_url);
+    if (record.ucp_profile_url !== undefined) {
+        assertSupplierEndpointAuthority(record.canonical_domain, record.ucp_profile_url);
+    }
+    return {
+        merchant_id: record.merchant_id ?? record.catalog_agent_id,
+        catalog_agent_id: record.catalog_agent_id,
+        canonical_domain: record.canonical_domain,
+        agent_card_url: record.agent_card_url,
+        ...(record.ucp_profile_url !== undefined ? { ucp_profile_url: record.ucp_profile_url } : {}),
+    };
+}
+/**
+ * watched/preferred 的明确同意门（§11：创建 watched/preferred 默认要求人类
+ * 明确确认）。--yes 或交互确认通过才返回；否则抛错拒绝。
+ */
+async function requireExplicitConsent(options) {
+    if (options.yes === true)
+        return;
+    if (options.confirm !== undefined && (await options.confirm()))
+        return;
+    throw new Error(`${options.action} 需要人类明确确认：交互终端请确认提示，非交互环境请显式加 --yes`);
+}
+function summarize(rel) {
+    const out = {
+        relationship_id: rel.relationship_id,
+        merchant_id: rel.merchant_id,
+        canonical_domain: rel.canonical_domain,
+        relationship_type: rel.relationship_type,
+        status: rel.status,
+        consent_source: rel.consent_source,
+        scope: rel.scope,
+        policy: rel.policy,
+        created_at: rel.created_at,
+        updated_at: rel.updated_at,
+    };
+    if (rel.expires_at !== undefined)
+        out.expires_at = rel.expires_at;
+    return out;
+}
+function parseExpiresDays(value) {
+    const match = /^(\d+)d$/.exec(value);
+    if (match === null) {
+        throw new Error("--expires 只支持 <N>d 形式（如 90d）");
+    }
+    const days = Number(match[1]);
+    if (!Number.isInteger(days) || days <= 0) {
+        throw new Error("--expires 天数必须是正整数");
+    }
+    return new Date(Date.now() + days * 24 * 3600 * 1000).toISOString();
+}
+const DEFAULT_ACTIVE_RELATIONSHIP_EXPIRY = "90d";
+/** `kiwi buyer supplier save <merchant-id>`：保存身份，不轮询（§2.1）。 */
+export async function supplierSave(options) {
+    const resolved = await resolveMerchant(options.catalogUrl ?? DEFAULT_CATALOG_URL, options.merchantId);
+    const { db, store } = openSupplierStore(options);
+    try {
+        return summarize(store.saveRelationship({
+            merchant_id: resolved.merchant_id,
+            canonical_domain: resolved.canonical_domain,
+            agent_card_url: resolved.agent_card_url,
+            ...(resolved.ucp_profile_url !== undefined
+                ? { ucp_profile_url: resolved.ucp_profile_url }
+                : {}),
+            relationship_type: "saved",
+            scope: { catalog_agent_id: resolved.catalog_agent_id },
+            consent_source: "human_explicit",
+        }));
+    }
+    finally {
+        db.close();
+    }
+}
+/** `kiwi buyer supplier watch <merchant-id>`：建立主动观察规则（§2.2）。 */
+export async function supplierWatch(options) {
+    await requireExplicitConsent({ yes: options.yes, confirm: options.confirm, action: "watch" });
+    if (options.intervalSeconds !== undefined &&
+        (!Number.isInteger(options.intervalSeconds) || options.intervalSeconds < 3600)) {
+        throw new Error("--interval 必须是 ≥3600 的整数秒（供应商观察不做分钟级轮询）");
+    }
+    const resolved = await resolveMerchant(options.catalogUrl ?? DEFAULT_CATALOG_URL, options.merchantId);
+    const { db, store } = openSupplierStore(options);
+    try {
+        return summarize(store.saveRelationship({
+            merchant_id: resolved.merchant_id,
+            canonical_domain: resolved.canonical_domain,
+            agent_card_url: resolved.agent_card_url,
+            ...(resolved.ucp_profile_url !== undefined
+                ? { ucp_profile_url: resolved.ucp_profile_url }
+                : {}),
+            relationship_type: "watched",
+            scope: {
+                catalog_agent_id: resolved.catalog_agent_id,
+                ...(options.query !== undefined ? { query: options.query } : {}),
+                ...(options.region !== undefined ? { region: options.region } : {}),
+            },
+            policy: options.intervalSeconds !== undefined
+                ? { interval_seconds: options.intervalSeconds }
+                : {},
+            consent_source: "human_explicit",
+            expires_at: parseExpiresDays(options.expires ?? DEFAULT_ACTIVE_RELATIONSHIP_EXPIRY),
+        }));
+    }
+    finally {
+        db.close();
+    }
+}
+/** `kiwi buyer supplier prefer <merchant-id>`：采购范围内的软偏好（§2.3）。 */
+export async function supplierPrefer(options) {
+    await requireExplicitConsent({ yes: options.yes, confirm: options.confirm, action: "prefer" });
+    const resolved = await resolveMerchant(options.catalogUrl ?? DEFAULT_CATALOG_URL, options.merchantId);
+    const { db, store } = openSupplierStore(options);
+    try {
+        return summarize(store.saveRelationship({
+            merchant_id: resolved.merchant_id,
+            canonical_domain: resolved.canonical_domain,
+            agent_card_url: resolved.agent_card_url,
+            ...(resolved.ucp_profile_url !== undefined
+                ? { ucp_profile_url: resolved.ucp_profile_url }
+                : {}),
+            relationship_type: "preferred",
+            scope: {
+                catalog_agent_id: resolved.catalog_agent_id,
+                ...(options.scope !== undefined ? { procurement_scope: options.scope } : {}),
+            },
+            expires_at: parseExpiresDays(options.expires ?? DEFAULT_ACTIVE_RELATIONSHIP_EXPIRY),
+            consent_source: "human_explicit",
+        }));
+    }
+    finally {
+        db.close();
+    }
+}
+/** `kiwi buyer supplier list`。 */
+export async function supplierList(options) {
+    const { db, store } = openSupplierStore(options);
+    try {
+        return store.listRelationships().map(summarize);
+    }
+    finally {
+        db.close();
+    }
+}
+/** `kiwi buyer supplier pause <relationship-id>`。 */
+export async function supplierPause(options) {
+    const { db, store } = openSupplierStore(options);
+    try {
+        return summarize(store.updateStatus(options.relationshipId, "paused"));
+    }
+    finally {
+        db.close();
+    }
+}
+/**
+ * `kiwi buyer supplier remove <relationship-id>`：软删——立即停止后续拉取并
+ * 清除未来调度（§11）。M3 之前 receipt_status 恒为 none，无需远端 revoke；
+ * 若将来存在有效 receipt，先 best-effort revoke 但远端不可达不阻塞本地删除。
+ */
+export async function supplierRemove(options) {
+    const { db, store } = openSupplierStore(options);
+    try {
+        const rel = store.getRelationship(options.relationshipId);
+        if (rel === undefined) {
+            throw new Error(`没有供应商关系 ${options.relationshipId}`);
+        }
+        if (rel.receipt_status !== "none") {
+            // M3 预留：当前版本不会进入该分支（无 receipt 发送面）。
+            throw new Error(`关系 ${options.relationshipId} 存在有效 relationship receipt（${rel.receipt_status}），` +
+                "当前版本请先等待 receipt 过期后再删除");
+        }
+        return summarize(store.updateStatus(options.relationshipId, "deleted"));
+    }
+    finally {
+        db.close();
+    }
+}
+// ---- M0 指标（pull-relationship 设计 v0.1 §13/§14） ------------------------------
+const DAY_MS = 24 * 3600 * 1000;
+function ratio(numerator, denominator, note) {
+    const m = {
+        value: denominator === 0 ? null : numerator / denominator,
+        numerator,
+        denominator,
+    };
+    if (note !== undefined)
+        m.note = note;
+    return m;
+}
+/**
+ * a2a_negotiated 事件没有 merchant_id 字段——用 catalog_agent_id（对
+ * relationship.merchant_id 或 scope.catalog_agent_id）或 agent_card_url 匹配
+ * merchant（代理口径，§14 注明）。
+ */
+function rfqMatchesRelationship(payload, rel) {
+    const caid = payload.catalog_agent_id;
+    if (typeof caid === "string" &&
+        caid !== "" &&
+        (rel.merchant_id === caid || rel.scope.catalog_agent_id === caid)) {
+        return true;
+    }
+    const cardUrl = payload.agent_card_url;
+    return typeof cardUrl === "string" && cardUrl !== "" && rel.agent_card_url === cardUrl;
+}
+/**
+ * `kiwi buyer supplier metrics`（§13 M0 / §14）：Buyer 本地只读指标。全部数据
+ * 来自本机 state.sqlite（supplier_relationships / supplier_observations /
+ * supplier_observation_state / task_events），单 principal 视角。算不出来的
+ * 指标如实给 null + 原因，不编造。
+ */
+export async function supplierMetrics(options = {}) {
+    const { db, store, principalId } = openSupplierStore(options);
+    try {
+        const now = new Date(Date.parse(options.now !== undefined ? options.now() : new Date().toISOString())).toISOString();
+        const nowMs = Date.parse(now);
+        const relationships = store.listRelationships({ includeDeleted: true });
+        const eventRows = db
+            .prepare(`SELECT e.type AS type, e.payload_json AS payload_json, e.created_at AS created_at
+         FROM task_events e JOIN buyer_tasks t ON t.task_id = e.task_id
+         WHERE t.principal_id = ? AND e.type IN ('a2a_negotiated', 'supplier_save_suggested')
+         ORDER BY e.created_at, e.event_id`)
+            .all(principalId);
+        const successfulRfqs = [];
+        let failedRfqs = 0;
+        const suggestions = [];
+        for (const row of eventRows) {
+            const payload = JSON.parse(row.payload_json);
+            if (row.type === "supplier_save_suggested") {
+                suggestions.push({ created_at: row.created_at, payload });
+            }
+            else if (payload.ok === true) {
+                successfulRfqs.push({ created_at: row.created_at, payload });
+            }
+            else {
+                failedRfqs += 1;
+            }
+        }
+        // a. save-after-RFQ conversion：建议后 7 天内同 merchant 建立关系（含已删除，
+        //    转化是历史事实；created_at 严格晚于建议时间）。
+        let converted = 0;
+        for (const s of suggestions) {
+            const merchant = s.payload.merchant_id;
+            if (typeof merchant !== "string")
+                continue;
+            const t = Date.parse(s.created_at);
+            const hit = relationships.some((r) => r.merchant_id === merchant &&
+                Date.parse(r.created_at) > t &&
+                Date.parse(r.created_at) <= t + 7 * DAY_MS);
+            if (hit)
+                converted += 1;
+        }
+        const saveAfterRfq = ratio(converted, suggestions.length, "窗口=建议事件后 7 天");
+        // b. type × status 分布。
+        const bucketMap = new Map();
+        let activeWatchedPreferred = 0;
+        for (const r of relationships) {
+            const key = `${r.relationship_type}/${r.status}`;
+            bucketMap.set(key, (bucketMap.get(key) ?? 0) + 1);
+            if (r.status === "active" &&
+                (r.relationship_type === "watched" || r.relationship_type === "preferred")) {
+                activeWatchedPreferred += 1;
+            }
+        }
+        const buckets = [...bucketMap.entries()]
+            .map(([key, count]) => {
+            const [relationship_type, status] = key.split("/");
+            return { relationship_type, status, count };
+        })
+            .sort((a, b) => `${a.relationship_type}/${a.status}`.localeCompare(`${b.relationship_type}/${b.status}`));
+        // c. 7/30 天复用：分母=建立已满窗口的关系（含非 active，复用是历史事实）。
+        const reuse = (days) => {
+            const eligible = relationships.filter((r) => Date.parse(r.created_at) + days * DAY_MS <= nowMs);
+            let reused = 0;
+            for (const r of eligible) {
+                const t0 = Date.parse(r.created_at);
+                const hit = successfulRfqs.some((e) => {
+                    const t = Date.parse(e.created_at);
+                    return t >= t0 && t <= t0 + days * DAY_MS && rfqMatchesRelationship(e.payload, r);
+                });
+                if (hit)
+                    reused += 1;
+            }
+            return ratio(reused, eligible.length, "merchant 经 catalog_agent_id/agent_card_url 匹配（a2a_negotiated 无 merchant_id，代理口径）");
+        };
+        // d. relationship-assisted：RFQ 发生前已建立且当前仍 active 的同 merchant 关系。
+        //    历史状态不可重建，用当前 status='active' 代理（口径文档注明）。
+        let assisted = 0;
+        for (const e of successfulRfqs) {
+            const t = Date.parse(e.created_at);
+            const hit = relationships.some((r) => r.status === "active" &&
+                Date.parse(r.created_at) <= t &&
+                rfqMatchesRelationship(e.payload, r));
+            if (hit)
+                assisted += 1;
+        }
+        const assistedMetric = ratio(assisted, successfulRfqs.length, "active 取当前状态（历史状态不可重建，代理口径）");
+        // e. 重复 Merchant：按 catalog_agent_id（缺省 agent_card_url）分组成功 RFQ。
+        const byMerchant = new Map();
+        let unidentified = 0;
+        for (const e of successfulRfqs) {
+            const id = e.payload.catalog_agent_id ?? e.payload.agent_card_url;
+            if (typeof id === "string" && id !== "") {
+                byMerchant.set(id, (byMerchant.get(id) ?? 0) + 1);
+            }
+            else {
+                unidentified += 1;
+            }
+        }
+        let repeatMerchants = 0;
+        for (const n of byMerchant.values()) {
+            if (n >= 2)
+                repeatMerchants += 1;
+        }
+        // f. observation 面。
+        const obsRows = db
+            .prepare(`SELECT o.kind AS kind, r.relationship_type AS relationship_type, r.status AS status
+         FROM supplier_observations o
+         JOIN supplier_relationships r ON r.relationship_id = o.relationship_id
+         WHERE r.principal_id = ?`)
+            .all(principalId);
+        const byKind = {};
+        let onActiveWatched = 0;
+        for (const o of obsRows) {
+            byKind[o.kind] = (byKind[o.kind] ?? 0) + 1;
+            if (o.status === "active" && o.relationship_type === "watched")
+                onActiveWatched += 1;
+        }
+        // g. lifecycle（分母含 deleted）。
+        const total = relationships.length;
+        const paused = relationships.filter((r) => r.status === "paused").length;
+        const deleted = relationships.filter((r) => r.status === "deleted").length;
+        // h. health。
+        const reviewRequired = relationships.filter((r) => r.status === "review_required").length;
+        const stateRows = db
+            .prepare(`SELECT s.failure_count AS failure_count, s.backoff_until AS backoff_until
+         FROM supplier_observation_state s
+         JOIN supplier_relationships r ON r.relationship_id = s.relationship_id
+         WHERE r.principal_id = ?`)
+            .all(principalId);
+        const degraded = stateRows.filter((s) => s.failure_count > 0 ||
+            (s.backoff_until !== null && Date.parse(s.backoff_until) > nowMs)).length;
+        return {
+            generated_at: now,
+            principal_id: principalId,
+            qualified_rfq_definition: "代理口径：task_events 中 type='a2a_negotiated' 且 payload.ok=true 的成功终态事件" +
+                "（仓库内无更严格的 Qualified RFQ 定义）",
+            successful_rfqs: successfulRfqs.length,
+            failed_rfqs: failedRfqs,
+            save_after_rfq: saveAfterRfq,
+            relationships_by_type_status: {
+                total,
+                active_watched_preferred: activeWatchedPreferred,
+                buckets,
+            },
+            reuse_7d: reuse(7),
+            reuse_30d: reuse(30),
+            relationship_assisted_rfq: assistedMetric,
+            repeat_merchants: {
+                merchants_with_successful_rfq: byMerchant.size,
+                merchants_with_repeat_rfq: repeatMerchants,
+                successful_rfqs: successfulRfqs.length,
+                unidentified_merchant_rfqs: unidentified,
+            },
+            observations: {
+                total: obsRows.length,
+                by_kind: byKind,
+                on_active_watched: ratio(onActiveWatched, obsRows.length, "代理口径：observation 对应关系当前仍是 active watched 的占比"),
+                notification_hit_rate: {
+                    value: null,
+                    note: "严格命中率不可计算：本地不记录通知是否触达/被用户采纳",
+                },
+            },
+            lifecycle: {
+                paused: ratio(paused, total),
+                deleted: ratio(deleted, total),
+            },
+            health: {
+                review_required: ratio(reviewRequired, total),
+                degraded_sources: ratio(degraded, stateRows.length, "stale/unreachable 代理：failure_count>0 或 backoff_until>now"),
+            },
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=product-supplier.js.map

package/dist/product-supplier.js.map

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

package/dist/runtime/fake-model.d.ts

@@ -35,7 +35,7 @@ export interface ScriptedFake {
 export declare function createScriptedFakeStreamFn(responses: FauxResponseStep[]): ScriptedFake;
 /**
  * Structured influence of applied operator strategy directives on candidate
- * generation (docs/operator-tui-v0.2.md §7). Compiled by the operator runner
+ * generation (operator control-plane design §7). Compiled by the operator runner
  * from the session's directive list; never widens HardPolicy by itself — the
  * authoritative policy gates still run on the profile at submit time.
  */

package/dist/trust/identity/jwk.d.ts

@@ -0,0 +1,11 @@
+/**
+ * JWK（RFC 7517）结构类型。
+ *
+ * @types/node ≥26 不再从 `node:crypto` 顶层导出 `JsonWebKey`，改为
+ * `crypto.webcrypto` 命名空间下的 `webcrypto.JsonWebKey`。此处集中 re-export，
+ * 并补 RFC 7517 的 `kid`（W3C JsonWebKey 未含，JWKS 接缝按 kid 匹配需要它）。
+ */
+import type { webcrypto } from "node:crypto";
+export type JsonWebKey = webcrypto.JsonWebKey & {
+    kid?: string;
+};

package/dist/trust/identity/jwk.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=jwk.js.map

package/dist/trust/identity/jwk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwk.js","sourceRoot":"","sources":["../../../src/trust/identity/jwk.ts"],"names":[],"mappings":""}

package/dist/trust/identity/jws.d.ts

@@ -24,7 +24,8 @@
  * 是否强制 JWS 由 TrustPolicy.requireCardJws(level) 决定（§31），本模块只提供
  * 「验签 + 卡片绑定」能力，不做强制决策。
  */
-import { KeyObject, type JsonWebKey } from "node:crypto";
+import { KeyObject } from "node:crypto";
+import type { JsonWebKey } from "./jwk.js";
 import type { AgentCard } from "../../discovery/agent-card/index.js";
 import { type KeyResolver, type SigningKey } from "./keys.js";
 export type JwsErrorCode = "malformed" | "unsupported_algorithm" | "missing_key" | "invalid_signature";