@tbox.cn/app-template-agent 0.8.0 → 0.10.0

package/pnpm-lock.template.yaml

@@ -15,21 +15,24 @@ catalogs:
     '@tbox.cn/agent-plugin':
       specifier: 0.1.0
       version: 0.1.0
+    '@tbox.cn/app-agent-sdk-client':
+      specifier: 0.1.0
+      version: 0.1.0
+    '@tbox.cn/app-agent-sdk-server':
+      specifier: 0.1.0
+      version: 0.1.0
     '@tbox.cn/app-contracts':
-      specifier: 0.10.0
-      version: 0.10.0
+      specifier: 0.12.0
+      version: 0.12.0
     '@tbox.cn/app-contracts-mall':
-      specifier: 0.10.0
-      version: 0.10.0
-    '@tbox.cn/app-sdk':
-      specifier: 0.19.0
-      version: 0.19.0
+      specifier: 0.12.0
+      version: 0.12.0
+    '@tbox.cn/app-sdk-server':
+      specifier: 0.21.0
+      version: 0.21.0
     '@tbox.cn/app-theme-tbox':
-      specifier: 0.1.0
-      version: 0.1.0
-    '@types/cors':
-      specifier: 2.8.19
-      version: 2.8.19
+      specifier: 0.1.1
+      version: 0.1.1
     '@types/express':
       specifier: 4.17.25
       version: 4.17.25
@@ -48,9 +51,6 @@ catalogs:
     antd-mobile:
       specifier: 5.42.3
       version: 5.42.3
-    cors:
-      specifier: 2.8.6
-      version: 2.8.6
     eslint:
       specifier: 9.39.5
       version: 9.39.5
@@ -113,9 +113,9 @@ importers:
 
   .:
     devDependencies:
-      '@tbox.cn/app-sdk':
+      '@tbox.cn/app-sdk-server':
         specifier: 'catalog:'
-        version: 0.19.0(@types/react@18.3.31)(rxjs@7.8.1)
+        version: 0.21.0
       eslint:
         specifier: 'catalog:'
         version: 9.39.5
@@ -140,15 +140,15 @@ importers:
       '@app/provider-custom':
         specifier: workspace:*
         version: link:../../packages/provider-custom
-      '@tbox.cn/app-contracts':
+      '@tbox.cn/app-agent-sdk-client':
         specifier: 'catalog:'
-        version: 0.10.0
-      '@tbox.cn/app-sdk':
+        version: 0.1.0(@types/react@18.3.31)
+      '@tbox.cn/app-contracts':
         specifier: 'catalog:'
-        version: 0.19.0(@types/react@18.3.31)(rxjs@7.8.1)
+        version: 0.12.0
       '@tbox.cn/app-theme-tbox':
         specifier: 'catalog:'
-        version: 0.1.0
+        version: 0.1.1
       react:
         specifier: 'catalog:'
         version: 18.3.1
@@ -204,15 +204,12 @@ importers:
       '@tbox.cn/agent-plugin':
         specifier: 'catalog:'
         version: 0.1.0(@mastra/core@1.59.0(ai@6.0.246(zod@3.25.76))(express@4.22.2)(rxjs@7.8.1)(zod@3.25.76))(@tbox-dev-js/sdk@0.1.18)(zod@3.25.76)
-      '@tbox.cn/app-contracts':
-        specifier: 'catalog:'
-        version: 0.10.0
-      '@tbox.cn/app-sdk':
+      '@tbox.cn/app-agent-sdk-server':
         specifier: 'catalog:'
-        version: 0.19.0(@types/react@18.3.31)(rxjs@7.8.1)
-      cors:
+        version: 0.1.0(@tbox-dev-js/sdk@0.1.18)(rxjs@7.8.1)
+      '@tbox.cn/app-contracts':
         specifier: 'catalog:'
-        version: 2.8.6
+        version: 0.12.0
       express:
         specifier: 'catalog:'
         version: 4.22.2
@@ -220,9 +217,6 @@ importers:
         specifier: 'catalog:'
         version: 3.25.76
     devDependencies:
-      '@types/cors':
-        specifier: 'catalog:'
-        version: 2.8.19
       '@types/express':
         specifier: 'catalog:'
         version: 4.17.25
@@ -250,12 +244,12 @@ importers:
       '@phosphor-icons/react':
         specifier: 'catalog:'
         version: 2.1.10(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
-      '@tbox.cn/app-contracts':
+      '@tbox.cn/app-agent-sdk-client':
         specifier: 'catalog:'
-        version: 0.10.0
-      '@tbox.cn/app-sdk':
+        version: 0.1.0(@types/react@18.3.31)
+      '@tbox.cn/app-contracts':
         specifier: 'catalog:'
-        version: 0.19.0(@types/react@18.3.31)(rxjs@7.8.1)
+        version: 0.12.0
       antd-mobile:
         specifier: 'catalog:'
         version: 5.42.3(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
@@ -304,7 +298,7 @@ importers:
     dependencies:
       '@tbox.cn/app-contracts-mall':
         specifier: 'catalog:'
-        version: 0.10.0
+        version: 0.12.0
     devDependencies:
       '@types/node':
         specifier: 24.13.3
@@ -318,12 +312,15 @@ importers:
 
   packages/provider-custom:
     dependencies:
-      '@tbox.cn/app-contracts':
+      '@tbox.cn/app-agent-sdk-client':
         specifier: 'catalog:'
-        version: 0.10.0
-      '@tbox.cn/app-sdk':
+        version: 0.1.0(@types/react@18.3.31)
+      '@tbox.cn/app-agent-sdk-server':
         specifier: 'catalog:'
-        version: 0.19.0(@types/react@18.3.31)(rxjs@7.8.1)
+        version: 0.1.0(@tbox-dev-js/sdk@0.1.18)(rxjs@7.8.1)
+      '@tbox.cn/app-contracts':
+        specifier: 'catalog:'
+        version: 0.12.0
     devDependencies:
       '@types/node':
         specifier: 24.13.3
@@ -1338,24 +1335,40 @@ packages:
       '@tbox-dev-js/sdk': '>=0.1.18 <0.2.0'
       zod: '>=3.24.0 <4.0.0'
 
-  '@tbox.cn/app-contracts-mall@0.10.0':
-    resolution: {integrity: sha512-DdV+kptnbjTzFwJA6xnXbeEwyxcmPD3x/SgU+nO0pDQHFVNjq7dzjmYRxI1KrhaX39MmqrS+MNFkLb/xkdlPXA==}
+  '@tbox.cn/app-agent-sdk-client@0.1.0':
+    resolution: {integrity: sha512-3DciSzYfOqqVFS2zn5ZCrqu8DC/0zQK8HF1l6cR2U9MYW7mrGPto0CwiPtduYPVwte4j0gzTJ1hrQLjAEG9zig==}
+    engines: {node: '>=20.0.0'}
+
+  '@tbox.cn/app-agent-sdk-server@0.1.0':
+    resolution: {integrity: sha512-ucqYVJ17Go2BsDdPUxC/oS7XXvOjQEcRYjqUNzKWRLXfeSWi4JmAfGy0dyhQ+OOCAPM3vZk42UpdemFshed0Ag==}
     engines: {node: '>=20.0.0'}
 
-  '@tbox.cn/app-contracts@0.10.0':
-    resolution: {integrity: sha512-BvuGPsxv7adbcdlEcoBF7pDbgOvzZs0kQgGlmtD3AWWnf+o+hVimVDSda0HKOubwTvyG9yEwdUxU9IFngSpo8w==}
+  '@tbox.cn/app-contracts-mall@0.12.0':
+    resolution: {integrity: sha512-rtWX8+1A57TabWdJl6jchZJAeZj5xYaiwxXhE6S9jra2gcZXBeFnwlDEbfA2IjpXPlrA9cmcC7kbmmXiM6yITg==}
     engines: {node: '>=20.0.0'}
 
-  '@tbox.cn/app-sdk@0.19.0':
-    resolution: {integrity: sha512-tG4IdqtszIkOfpycm6Zz/CCSRcUbXS6zfNTmddi1THzNC8hJy7Cr31l/GP7x54k7mWQcbJjksqR8Mmd6UBzy7Q==}
+  '@tbox.cn/app-contracts@0.12.0':
+    resolution: {integrity: sha512-GFthajvUSE7tY6Y5kLJgg2dRuZQdLfxq/WAEHOh+Q7RTwg7mpuLsWiNhXISkXMAtpxg0RkSgtwyRq33QS0ay3w==}
+    engines: {node: '>=20.0.0'}
+
+  '@tbox.cn/app-sdk-client@0.21.0':
+    resolution: {integrity: sha512-xN7b8ttJLKfEsN6FdC+BUsq2rz4zQ6KXCrf59Hzr9pNIuiVDqM5zr1tqenfD9xQDu1iQmFrbNKI/QEM035AjQw==}
+    engines: {node: '>=20.0.0'}
+
+  '@tbox.cn/app-sdk-core@0.20.0':
+    resolution: {integrity: sha512-hvdcXntg4iJniVu9LEwo5A/vov3L08kRlJLTgStYRdAlH9AJXWLDxFITMNf7YJX8W+j9wjJmmS7Sv88iswxM+w==}
+    engines: {node: '>=20.0.0'}
+
+  '@tbox.cn/app-sdk-server@0.21.0':
+    resolution: {integrity: sha512-buiwhnT46Jb1P99UJN1p0ATjRzhFIXIgqIYQDT4aT3fVbmMxWUuAPpFYhM3uTFGx5oPh18/ju3MVz0FxZ5DMCg==}
     engines: {node: '>=20.0.0'}
     hasBin: true
 
-  '@tbox.cn/app-theme-tbox@0.1.0':
-    resolution: {integrity: sha512-Na72n+Wr+GhEn5WQtrKDhAVTY8dS+gq3Kw1/a4mSrvgONRQqT6bwtBlrfr1vpHMTSzIXZrFk6V+0hUIJqo5i7A==}
+  '@tbox.cn/app-theme-tbox@0.1.1':
+    resolution: {integrity: sha512-g4150ksl35yZLMSezeMrtqj281Ly2RcX7qJCYQql0oDMHczlBXu2lpKuzOZ2GUdCnfT61wdmuahb7jPuyg6o7A==}
 
-  '@tbox.cn/app-toolkit@0.3.0':
-    resolution: {integrity: sha512-xjI58ULGi1NXyRpOOGSzBVUZzlwji/BkU+0EiqgZZ5CFO2TbR5b1aDOVKFvMUpLAOfvYzJpVhSy8iZ88j5hpMQ==}
+  '@tbox.cn/app-toolkit@0.5.0':
+    resolution: {integrity: sha512-ShLYwxsMzhr8V5sjixo4GFGBZbAw4/8CoTnCigrbBcRLtydf2ezLrLDR9jHfi/d5fQworFR5ZBzI7xDSjvR2zA==}
     engines: {node: '>=20.0.0'}
 
   '@types/babel__core@7.20.5':
@@ -1379,9 +1392,6 @@ packages:
   '@types/connect@3.4.38':
     resolution: {integrity: sha512-K6uROf1LD88uDQqJCktA4yzL1YYAK6NgfsI0v/mTgyPKWsX1CnJ0XPSDhViejru1GcRkLWb8RlzFYJRqGUbaug==}
 
-  '@types/cors@2.8.19':
-    resolution: {integrity: sha512-mFNylyeyqN93lfe/9CSxOGREz8cpzAhH+E93xJ4xWQf62V8sQ/24reV2nyzUWM6H6Xji+GGHpkbLe7pVoUEskg==}
-
   '@types/debug@4.1.13':
     resolution: {integrity: sha512-KSVgmQmzMwPlmtljOomayoR89W4FynCAi3E8PPs7vmDVPe84hT+vGPKkJfThkmXs0x0jAaa9U8uW8bbfyS2fWw==}
 
@@ -1809,10 +1819,6 @@ packages:
     resolution: {integrity: sha512-yCEafptTtb4bk7GLEQoM8KVJpxAfdBJYaXyzQEgQQQgYrZiDp8SJmGKlYza6CYjEDNstAdNdKA3UuoULlEbS6w==}
     engines: {node: '>=12.13'}
 
-  cors@2.8.6:
-    resolution: {integrity: sha512-tJtZBBHA6vjIAaF6EnIaq6laBBP9aq/Y3ouVJjEfoHbRBcHBAHYcMh/w8LDrk2PvIMMq8gmopa5D4V8RmbrxGw==}
-    engines: {node: '>= 0.10'}
-
   croner@10.0.1:
     resolution: {integrity: sha512-ixNtAJndqh173VQ4KodSdJEI6nuioBWI0V1ITNKhZZsO0pEMoDxz539T4FTTbSZ/xIOSuDnzxLVRqBVSvPNE2g==}
     engines: {node: '>=18.0'}
@@ -4063,53 +4069,83 @@ snapshots:
       '@tbox-dev-js/sdk': 0.1.18
       zod: 3.25.76
 
-  '@tbox.cn/app-contracts-mall@0.10.0':
+  '@tbox.cn/app-agent-sdk-client@0.1.0(@types/react@18.3.31)':
     dependencies:
-      '@tbox.cn/app-contracts': 0.10.0
-      zod: 3.25.76
-
-  '@tbox.cn/app-contracts@0.10.0':
-    dependencies:
-      '@ag-ui/core': 0.0.47
+      '@tbox.cn/app-contracts': 0.12.0
+      '@tbox.cn/app-sdk-client': 0.21.0
+      '@tbox.cn/app-sdk-core': 0.20.0
       react: 18.3.1
-      zod: 3.25.76
+      react-dom: 18.3.1(react@18.3.1)
+      zustand: 4.5.7(@types/react@18.3.31)(react@18.3.1)
+    transitivePeerDependencies:
+      - '@types/react'
+      - immer
 
-  '@tbox.cn/app-sdk@0.19.0(@types/react@18.3.31)(rxjs@7.8.1)':
+  '@tbox.cn/app-agent-sdk-server@0.1.0(@tbox-dev-js/sdk@0.1.18)(rxjs@7.8.1)':
     dependencies:
       '@ag-ui/core': 0.0.47
       '@ai-sdk/openai-compatible': 2.0.68(zod@3.25.76)
       '@ai-sdk/provider': 3.0.15
       '@mastra/core': 1.59.0(ai@6.0.246(zod@3.25.76))(express@4.22.2)(rxjs@7.8.1)(zod@3.25.76)
       '@mastra/observability': 1.16.5(@mastra/core@1.59.0(ai@6.0.246(zod@3.25.76))(express@4.22.2)(rxjs@7.8.1)(zod@3.25.76))(zod@3.25.76)
-      '@tbox-dev-js/sdk': 0.1.18
       '@tbox.cn/agent-plugin': 0.1.0(@mastra/core@1.59.0(ai@6.0.246(zod@3.25.76))(express@4.22.2)(rxjs@7.8.1)(zod@3.25.76))(@tbox-dev-js/sdk@0.1.18)(zod@3.25.76)
-      '@tbox.cn/app-contracts': 0.10.0
-      '@tbox.cn/app-toolkit': 0.3.0
+      '@tbox.cn/app-contracts': 0.12.0
+      '@tbox.cn/app-sdk-core': 0.20.0
+      '@tbox.cn/app-sdk-server': 0.21.0
       ai: 6.0.246(zod@3.25.76)
       express: 4.22.2
       gray-matter: 4.0.3
-      jose: 6.2.8
       jsonc-parser: 3.3.1
-      react: 18.3.1
-      react-dom: 18.3.1(react@18.3.1)
       undici: 7.29.0
       ws: 8.21.3
       zod: 3.25.76
-      zustand: 4.5.7(@types/react@18.3.31)(react@18.3.1)
     transitivePeerDependencies:
       - '@bufbuild/protobuf'
       - '@grpc/grpc-js'
-      - '@types/react'
+      - '@tbox-dev-js/sdk'
       - bufferutil
-      - immer
       - rxjs
       - supports-color
       - utf-8-validate
       - workflow
 
-  '@tbox.cn/app-theme-tbox@0.1.0': {}
+  '@tbox.cn/app-contracts-mall@0.12.0':
+    dependencies:
+      '@tbox.cn/app-contracts': 0.12.0
+      zod: 3.25.76
+
+  '@tbox.cn/app-contracts@0.12.0':
+    dependencies:
+      '@ag-ui/core': 0.0.47
+      react: 18.3.1
+      zod: 3.25.76
+
+  '@tbox.cn/app-sdk-client@0.21.0':
+    dependencies:
+      '@tbox.cn/app-contracts': 0.12.0
+      '@tbox.cn/app-sdk-core': 0.20.0
+      react: 18.3.1
+      react-dom: 18.3.1(react@18.3.1)
 
-  '@tbox.cn/app-toolkit@0.3.0':
+  '@tbox.cn/app-sdk-core@0.20.0':
+    dependencies:
+      '@tbox.cn/app-contracts': 0.12.0
+
+  '@tbox.cn/app-sdk-server@0.21.0':
+    dependencies:
+      '@ag-ui/core': 0.0.47
+      '@tbox.cn/app-contracts': 0.12.0
+      '@tbox.cn/app-sdk-core': 0.20.0
+      '@tbox.cn/app-toolkit': 0.5.0
+      express: 4.22.2
+      jose: 6.2.8
+      zod: 3.25.76
+    transitivePeerDependencies:
+      - supports-color
+
+  '@tbox.cn/app-theme-tbox@0.1.1': {}
+
+  '@tbox.cn/app-toolkit@0.5.0':
     dependencies:
       ajv: 8.20.0
       zod: 3.25.76
@@ -4149,10 +4185,6 @@ snapshots:
     dependencies:
       '@types/node': 24.13.3
 
-  '@types/cors@2.8.19':
-    dependencies:
-      '@types/node': 24.13.3
-
   '@types/debug@4.1.13':
     dependencies:
       '@types/ms': 2.1.0
@@ -4640,11 +4672,6 @@ snapshots:
     dependencies:
       is-what: 4.1.16
 
-  cors@2.8.6:
-    dependencies:
-      object-assign: 4.1.1
-      vary: 1.1.2
-
   croner@10.0.1: {}
 
   cross-spawn@7.0.6:

package/pnpm-workspace.template.yaml

@@ -38,10 +38,14 @@ catalog:
   ws: 8.21.3
   "@types/ws": 8.18.1
   "@tbox.cn/agent-plugin": 0.1.0
-  "@tbox.cn/app-sdk": 0.19.0
-  "@tbox.cn/app-contracts": 0.10.0
-  "@tbox.cn/app-contracts-mall": 0.10.0
-  "@tbox.cn/app-theme-tbox": 0.1.0
+  "@tbox.cn/app-sdk-core": 0.20.0
+  "@tbox.cn/app-sdk-client": 0.21.0
+  "@tbox.cn/app-sdk-server": 0.21.0
+  "@tbox.cn/app-agent-sdk-server": 0.1.0
+  "@tbox.cn/app-agent-sdk-client": 0.1.0
+  "@tbox.cn/app-contracts": 0.12.0
+  "@tbox.cn/app-contracts-mall": 0.12.0
+  "@tbox.cn/app-theme-tbox": 0.1.1
   zustand: 4.5.7
   eslint: 9.39.5
   typescript-eslint: 8.67.0

package/profiles/mall/TEMPLATE.md

@@ -0,0 +1,42 @@
+# 商圈智能体应用 · 使用指南
+
+本应用已内置商圈智能体全套能力：商圈家页、商圈信息，以及导购、会员、停车、营销、碰一下活动、客服六大业务组件。
+开箱即为演示态——业务数据使用内置模拟数据，无需接入真实服务即可体验完整流程；正式上线按以下四步推进。
+
+## 第一步 · 接入业务服务
+
+将各业务组件连接到商场的真实服务：通过自定义服务实现对完成对接与联调。
+
+| 业务组件 | 配置内容 |
+|---|---|
+| 商圈信息 | 商场名称、地址与位置信息（可直填，或配置商圈信息获取接口） |
+| 会员积分 | 会员服务地址、应用凭证、入会落地页链接 |
+| 停车缴费 | 停车服务地址、应用凭证（含支付密钥）、车场标识 |
+| 智能导购 | 导购服务地址、应用凭证、商户图片资源域名 |
+| 营销优惠 | 营销服务地址、应用凭证、商场映射标识与领券方式 |
+| 支付宝碰一下 | 活动服务网关地址、活动方案标识 |
+| 客服问答 | 客服知识库来源（知识内容在第三步配置） |
+
+商圈家页无需单独接入，其数据聚合自以上组件，接入完成后自动生效。
+
+## 第二步 · 调试业务卡片
+
+在对话中逐组件试用，预览卡片返回结果，校验业务数据展示，并按需调整交互与样式（品牌视觉可随商场形象更换主题）。
+
+- 「帮我找商场里的美食」→ 导购检索与商户卡片
+- 「我的积分有多少」→ 会员积分卡片
+- 「停车费多少」→ 停车费用卡片
+
+## 第三步 · 配置业务知识
+
+- **客服知识**：商场常见问题、服务政策、退换货与发票规则等
+- **业务规则与口吻**：智能体的服务范围、回答风格与兜底引导
+- **常用指令**：对话首页的快捷入口（如「今日优惠」「品牌导览」）
+
+## 第四步 · 测试并部署
+
+- **多场景验证**：覆盖各业务组件的典型对话与操作链路，确认数据准确、卡片正常
+- **发布上线**：完成验证后部署发布；所需环境变量（模型服务等）可在平台页面配置
+- **小程序接入**：应用嵌入支付宝小程序，服务到店顾客
+
+完成以上四步后，应用即可稳定上线，为顾客提供导购、会员、停车与优惠等智能服务。

package/profiles/mall.json

@@ -1,5 +1,5 @@
 {
-  "$comment": "mall 画像（单一模板统一化 W4）：create --profile mall 执行器（W5 接线）按 modules 序列加装 + configOverlay 叠加（--config-dir 通道）。provider 轴独立（缺省 mock-only 演示态；vendor 档由部署者后续 add）。",
+  "$comment": "mall 画像（单一模板统一化 W4）：create --profile mall 执行器（W5 接线）按 modules 序列加装 + configOverlay 叠加（--config-dir 通道）+ rootFiles 根文件落地（TEMPLATE.md 使用指南 → 应用根）。provider 轴独立（缺省 mock-only 演示态；vendor 档由部署者后续 add）。",
   "name": "mall",
   "description": "商圈 AI Agent：家页形态（home 槽）+ 域装配 + 六业务域（导购/会员/停车/营销/活动/客服）",
   "modules": [
@@ -12,5 +12,6 @@
     "@tbox.cn/app-module-alipay-activity",
     "@tbox.cn/app-module-customer-service"
   ],
-  "configOverlay": "profiles/mall/config"
+  "configOverlay": "profiles/mall/config",
+  "rootFiles": ["TEMPLATE.md"]
 }

package/apps/client/src/shims/node-stub.ts

@@ -1,14 +0,0 @@
-/**
- * 浏览器端 fs / path 桩。
- *
- * @tbox-dev-js/sdk 的 ESM 顶层静态 import 了 Node 的 fs/path（用于 Node 环境的代码路径，
- * 浏览器不会执行到），但静态 import 会让 vite 生产构建因"命名导出不存在"而失败。
- * 用本桩 alias 掉 fs/path，提供同名空实现即可（浏览器永不调用这些路径）。
- */
-export const existsSync = (): boolean => false;
-export const readFileSync = (): string => '';
-export const resolve = (...p: string[]): string => p.join('/');
-export const join = (...p: string[]): string => p.join('/');
-export const dirname = (p = ''): string => p.split('/').slice(0, -1).join('/');
-
-export default { existsSync, readFileSync, resolve, join, dirname };