@seasonkoh/webaz 0.1.14 → 0.1.15

package/dist/layer0-foundation/L0-2-state-machine/engine.js

@@ -151,12 +151,29 @@ export function getOrderStatus(db, orderId) {
     const responsibleTable = isSelfFulfill ? CURRENT_RESPONSIBLE_SELF_FULFILL : CURRENT_RESPONSIBLE;
     const currentResponsible = responsibleTable[order.status] ?? null;
     const activeDeadline = getActiveDeadline(order, db);
+    // 2026-05-31 透传 Phase 1 兜底语义给 agent — 当 fulfillment_mode='shipping' 但 logistics_id NULL,
+    // 实际是"协议 Phase 1 没物流市场,seller 自履行兜底"。agent 看到 responsible=seller 容易误解为
+    // "卖家本来就要自履行",所以加显式 phase + context 让 agent 明白这是 Phase 1 临时兜底。
+    // 真正面交(fulfillment_mode='in_person')才是 self-fulfill 本意。
+    const mode = order.fulfillment_mode;
+    const isInPerson = mode === 'in_person';
+    const isPhase1Fallback = isSelfFulfill && !isInPerson && (mode === 'shipping' || !mode);
+    const fulfillmentPhase = isPhase1Fallback
+        ? 'phase_1_no_logistics_market'
+        : (isInPerson ? 'in_person' : (order.logistics_id ? 'phase_2_logistics_assigned' : 'unknown'));
+    const responsibleContext = isPhase1Fallback
+        ? `Phase 1 fallback: 协议物流市场未启用,logistics_id 未绑定。seller 自履行兜底(自己揽收/运输/送达),超时按 fault_seller 处置。Phase 2 logistics 市场上线后会自动派单给 logistics 角色,届时 shipped/picked_up/in_transit → logistics 负责。`
+        : (isInPerson
+            ? '面交模式(fulfillment_mode=in_person):seller 与 buyer 当面交接,无第三方物流'
+            : (order.logistics_id ? '已绑定物流方,按 logistics 责任流转(market-fulfill)' : null));
     return {
         order,
         history,
         currentResponsible,
         activeDeadline,
-        isOverdue: activeDeadline ? new Date() > new Date(activeDeadline.deadline) : false
+        isOverdue: activeDeadline ? new Date() > new Date(activeDeadline.deadline) : false,
+        fulfillmentPhase,
+        responsibleContext,
     };
 }
 // ─── 超时判责资金处置 ────────────────────────────────────────

package/dist/layer1-agent/L1-1-mcp-server/server.js

@@ -1579,6 +1579,23 @@ function handleInfo() {
             reviewer: '1. webaz_register(role=reviewer) → 2. webaz_claim_verify(action=apply) 申请测评免单 → 3. 收货后写真实评价',
             arbitrator: '1. webaz_register(role=arbitrator) → 2. webaz_dispute(action=list_open) 看待裁案件 → 3. webaz_dispute(action=arbitrate) — ⚠️ 需 PWA + Passkey（Iron-Rule）',
         },
+        // 搜索/发现场景决策地图 — agent 第一次 onboard 拿到 user-scenario → tool + PWA-page 总表,
+        // 避免每次试错。每行:scenario(用户怎么说)→ tool(我用哪个 MCP 工具)+ pwa_page(没接口时让用户去哪)
+        search_routing: [
+            { scenario: '用户给出商品完整标题 / SKU / 精准描述', tool: 'webaz_search query=...', pwa_page: '#buy', note: 'STRICT 精准匹配,0 命中不降级 fuzzy' },
+            { scenario: '用户粘贴外站链接(淘宝/抖音/小红书/JD/PDD/1688/Tmall)', tool: 'webaz_search external_link=... 或 paste_text=...', pwa_page: '#buy', note: '匹配 anchor registry 精准产品指纹' },
+            { scenario: '用户要"模糊浏览"/ 关键词探索 / 不知精准 SKU', tool: '⚠️ 无 MCP 接口 — 引导用户去 PWA 自己输关键词', pwa_page: '#discover', note: 'fuzzy 是用户主动行为,不是 agent 代办,见 [protocol invariant]' },
+            { scenario: '用户问"我附近 / 同城 / 11km 范围 有人买什么"', tool: 'webaz_nearby action=query', pwa_page: '#nearby', note: 'k-anonymity ≥3 隐私保护' },
+            { scenario: '用户要二手 / 闲置 / 个人 pre-owned 商品', tool: 'webaz_secondhand action=browse', pwa_page: '#secondhand', note: '独立空间,不跟 catalog 商品混' },
+            { scenario: '用户要竞拍 / 捡漏稀有品 / English forward auction', tool: 'webaz_auction action=browse', pwa_page: '#auctions', note: '时间窗口事件,有 anti-snipe 延时' },
+            { scenario: '用户买不到,想发起求购让卖家来报价', tool: 'webaz_rfq action=create', pwa_page: '#rfqs', note: '反向匹配 — buyer 出需求 + 押金 1%' },
+            { scenario: '用户想申请试用 / 0 元拿样 / 测评免单', tool: 'webaz_trial action=get_campaign / apply', pwa_page: '#trials', note: '需 ≥1 笔订单 + ≥3 天账号' },
+            { scenario: '用户想发布或回应慈善许愿 / 捐赠社区基金', tool: 'webaz_charity action=list / create / donate', pwa_page: '#charity', note: '跟 place_order donation_pct 是不同动作' },
+            { scenario: '用户买知识技能 / Prompt / 模板 / 清单', tool: 'webaz_skill_market action=list / purchase / read', pwa_page: '#skill-market', note: '内容型,与 webaz_skill 行为插件市场不同' },
+            { scenario: '用户问某具体人 / @handle / usr_xxx 的主页或内容流', tool: 'webaz_profile action=view_user', pwa_page: '#u/:id', note: '不是关键词搜,只看指定人' },
+            { scenario: '用户想看某商家全部商品(已知 seller_id)', tool: 'webaz_search seller_id=...', pwa_page: '#shop/:id', note: 'strict 精准过滤,sort 可选 trending/newest' },
+            { scenario: '用户问什么"最热门 / 排行 / trending"', tool: 'webaz_leaderboard kind=...', pwa_page: '(无独立页,各域内置)', note: '8 类:products / value_products / creators / sellers / buyers / verifiers / arbitrators / agents' },
+        ],
         available_tools: TOOLS.map((t) => ({ name: t.name, description: t.description.split('\n')[0] })),
         full_manifest: `读取 MCP Resource "${MANIFEST_URI}" 获取完整协议规范（状态机/经济模型/争议系统/Skill 市场/声誉系统）`,
     };
@@ -2331,13 +2348,17 @@ function handleGetStatus(args) {
     const statusInfo = getOrderStatus(db, args.order_id);
     if (!statusInfo)
         return { error: `订单不存在：${args.order_id}` };
-    const { order, history, currentResponsible, activeDeadline, isOverdue } = statusInfo;
+    const { order, history, currentResponsible, activeDeadline, isOverdue, fulfillmentPhase, responsibleContext } = statusInfo;
     return {
         order_id: order.id,
         current_status: order.status,
         current_responsible: currentResponsible
             ? `${currentResponsible}（当前应由此角色操作）`
             : '无（等待系统处理）',
+        // Phase 1 兜底语义透传 — agent 看到 responsible=seller 时若不理解为什么(如 shipped 后还要 seller 揽收),
+        // 应读此字段。Phase 2 logistics 市场上线后,phase_1_no_logistics_market 会消失。
+        fulfillment_phase: fulfillmentPhase,
+        responsible_context: responsibleContext,
         deadline: activeDeadline
             ? {
                 field: activeDeadline.field,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seasonkoh/webaz",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "description": "Agent-native decentralized commerce protocol. Humans and AI agents trade on the same protocol via MCP tools.",
   "main": "dist/mcp.js",
   "bin": {