@tbox.cn/app-template-agent 0.9.0 → 0.10.1

package/pnpm-lock.template.yaml

@@ -15,18 +15,24 @@ catalogs:
     '@tbox.cn/agent-plugin':
       specifier: 0.1.0
       version: 0.1.0
+    '@tbox.cn/app-agent-sdk-client':
+      specifier: 0.1.1
+      version: 0.1.1
+    '@tbox.cn/app-agent-sdk-server':
+      specifier: 0.1.1
+      version: 0.1.1
     '@tbox.cn/app-contracts':
-      specifier: 0.11.0
-      version: 0.11.0
+      specifier: 0.12.0
+      version: 0.12.0
     '@tbox.cn/app-contracts-mall':
-      specifier: 0.11.0
-      version: 0.11.0
-    '@tbox.cn/app-sdk':
-      specifier: 0.20.0
-      version: 0.20.0
+      specifier: 0.12.1
+      version: 0.12.1
+    '@tbox.cn/app-sdk-server':
+      specifier: 0.21.0
+      version: 0.21.0
     '@tbox.cn/app-theme-tbox':
-      specifier: 0.1.1
-      version: 0.1.1
+      specifier: 0.1.2
+      version: 0.1.2
     '@types/express':
       specifier: 4.17.25
       version: 4.17.25
@@ -107,9 +113,9 @@ importers:
 
   .:
     devDependencies:
-      '@tbox.cn/app-sdk':
+      '@tbox.cn/app-sdk-server':
         specifier: 'catalog:'
-        version: 0.20.0(@types/react@18.3.31)(rxjs@7.8.1)
+        version: 0.21.0
       eslint:
         specifier: 'catalog:'
         version: 9.39.5
@@ -134,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.11.0
-      '@tbox.cn/app-sdk':
+        version: 0.1.1(@types/react@18.3.31)
+      '@tbox.cn/app-contracts':
         specifier: 'catalog:'
-        version: 0.20.0(@types/react@18.3.31)(rxjs@7.8.1)
+        version: 0.12.0
       '@tbox.cn/app-theme-tbox':
         specifier: 'catalog:'
-        version: 0.1.1
+        version: 0.1.2
       react:
         specifier: 'catalog:'
         version: 18.3.1
@@ -198,12 +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':
+      '@tbox.cn/app-agent-sdk-server':
         specifier: 'catalog:'
-        version: 0.11.0
-      '@tbox.cn/app-sdk':
+        version: 0.1.1(@tbox-dev-js/sdk@0.1.18)(rxjs@7.8.1)
+      '@tbox.cn/app-contracts':
         specifier: 'catalog:'
-        version: 0.20.0(@types/react@18.3.31)(rxjs@7.8.1)
+        version: 0.12.0
       express:
         specifier: 'catalog:'
         version: 4.22.2
@@ -238,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.11.0
-      '@tbox.cn/app-sdk':
+        version: 0.1.1(@types/react@18.3.31)
+      '@tbox.cn/app-contracts':
         specifier: 'catalog:'
-        version: 0.20.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)
@@ -292,7 +298,7 @@ importers:
     dependencies:
       '@tbox.cn/app-contracts-mall':
         specifier: 'catalog:'
-        version: 0.11.0
+        version: 0.12.1
     devDependencies:
       '@types/node':
         specifier: 24.13.3
@@ -306,12 +312,15 @@ importers:
 
   packages/provider-custom:
     dependencies:
-      '@tbox.cn/app-contracts':
+      '@tbox.cn/app-agent-sdk-client':
+        specifier: 'catalog:'
+        version: 0.1.1(@types/react@18.3.31)
+      '@tbox.cn/app-agent-sdk-server':
         specifier: 'catalog:'
-        version: 0.11.0
-      '@tbox.cn/app-sdk':
+        version: 0.1.1(@tbox-dev-js/sdk@0.1.18)(rxjs@7.8.1)
+      '@tbox.cn/app-contracts':
         specifier: 'catalog:'
-        version: 0.20.0(@types/react@18.3.31)(rxjs@7.8.1)
+        version: 0.12.0
     devDependencies:
       '@types/node':
         specifier: 24.13.3
@@ -1326,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.11.0':
-    resolution: {integrity: sha512-4BpbtZAif2zmYlMJ2M1wF03yTs3n4w5eFBZKFlA3yGeAfjpODyUy4OTRmRMaFfz4dHBichQF3n30A0RgS/h0Eg==}
+  '@tbox.cn/app-agent-sdk-client@0.1.1':
+    resolution: {integrity: sha512-+HynOgllJS7dupTYTQ5R/5Ajpp5ErOVvGl/dz0wNBb/oZQxKgV0/ePQSxrlS1YnFXsiA9mzELdASz6CudOP/4A==}
     engines: {node: '>=20.0.0'}
 
-  '@tbox.cn/app-contracts@0.11.0':
-    resolution: {integrity: sha512-ePyJwpfmWwyOx1BrSoAWZpwEI7xB8b2wFliR+uaAQfyGvbOfvKbaWJXOt/qPJh+PlYgUGvGLGvntnX2m2YC6BA==}
+  '@tbox.cn/app-agent-sdk-server@0.1.1':
+    resolution: {integrity: sha512-0KmAWR+wZODm5oRJ6IPgKfFFz49V8ACnetaFShgl5HI2HSianWWMECAWdyxdwp4hBOAMQU+IG6t2sz0gyE0UNQ==}
     engines: {node: '>=20.0.0'}
 
-  '@tbox.cn/app-sdk@0.20.0':
-    resolution: {integrity: sha512-r6Jx/ciA+UWZ8rOlaAs94Et98g/n9NBIMoaXy3jpnUNs8zFrBTrViVYGaQvBMqL4yvDLcJBjOJQ2oSF7h1MJGQ==}
+  '@tbox.cn/app-contracts-mall@0.12.1':
+    resolution: {integrity: sha512-5A85jjdsvxDTAHWwGGruVTkd/106p1soo1mIWFSarXNkZi97dVmJjYxDaHb8v1yBdLXWZ1kb2yp9/oA2qZy/uQ==}
+    engines: {node: '>=20.0.0'}
+
+  '@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.1':
+    resolution: {integrity: sha512-hN+tIj8kh11PD0HMhq5KUs/nZYjxS+ps3F3HTTmOHWXNXzilYafFxeIWJ1bXKVm1Di5EUIjNaRPUDkP6HAcHvw==}
+    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.1':
-    resolution: {integrity: sha512-g4150ksl35yZLMSezeMrtqj281Ly2RcX7qJCYQql0oDMHczlBXu2lpKuzOZ2GUdCnfT61wdmuahb7jPuyg6o7A==}
+  '@tbox.cn/app-theme-tbox@0.1.2':
+    resolution: {integrity: sha512-/0x1XjcE1dDgQ4CTaqcXFZjWS47JQ2u7JS2jAbORTqrSmo7F0X/3m4LsH+WHAn+2r709KIRFh99NT3iMYqci2g==}
 
-  '@tbox.cn/app-toolkit@0.4.0':
-    resolution: {integrity: sha512-b4ha8IonQKu2M9O/EHrUqUZh7ReiMfryNojptytRsnAOiJnTyRIQeChrDxEDHfb5ZS8AAJ0Prb5/ofxvqd7uqg==}
+  '@tbox.cn/app-toolkit@0.5.0':
+    resolution: {integrity: sha512-ShLYwxsMzhr8V5sjixo4GFGBZbAw4/8CoTnCigrbBcRLtydf2ezLrLDR9jHfi/d5fQworFR5ZBzI7xDSjvR2zA==}
     engines: {node: '>=20.0.0'}
 
   '@types/babel__core@7.20.5':
@@ -4044,53 +4069,83 @@ snapshots:
       '@tbox-dev-js/sdk': 0.1.18
       zod: 3.25.76
 
-  '@tbox.cn/app-contracts-mall@0.11.0':
+  '@tbox.cn/app-agent-sdk-client@0.1.1(@types/react@18.3.31)':
     dependencies:
-      '@tbox.cn/app-contracts': 0.11.0
-      zod: 3.25.76
-
-  '@tbox.cn/app-contracts@0.11.0':
-    dependencies:
-      '@ag-ui/core': 0.0.47
+      '@tbox.cn/app-contracts': 0.12.0
+      '@tbox.cn/app-sdk-client': 0.21.1
+      '@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.20.0(@types/react@18.3.31)(rxjs@7.8.1)':
+  '@tbox.cn/app-agent-sdk-server@0.1.1(@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.11.0
-      '@tbox.cn/app-toolkit': 0.4.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.1': {}
+  '@tbox.cn/app-contracts-mall@0.12.1':
+    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.1':
+    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-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.2': {}
 
-  '@tbox.cn/app-toolkit@0.4.0':
+  '@tbox.cn/app-toolkit@0.5.0':
     dependencies:
       ajv: 8.20.0
       zod: 3.25.76

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.20.0
-  "@tbox.cn/app-contracts": 0.11.0
-  "@tbox.cn/app-contracts-mall": 0.11.0
-  "@tbox.cn/app-theme-tbox": 0.1.1
+  "@tbox.cn/app-sdk-core": 0.20.0
+  "@tbox.cn/app-sdk-client": 0.21.1
+  "@tbox.cn/app-sdk-server": 0.21.0
+  "@tbox.cn/app-agent-sdk-server": 0.1.1
+  "@tbox.cn/app-agent-sdk-client": 0.1.1
+  "@tbox.cn/app-contracts": 0.12.0
+  "@tbox.cn/app-contracts-mall": 0.12.1
+  "@tbox.cn/app-theme-tbox": 0.1.2
   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,10 +1,9 @@
 {
-  "$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": [
     "@tbox.cn/app-module-mall-core",
-    "@tbox.cn/app-module-mall-home",
     "@tbox.cn/app-module-shopping-guide",
     "@tbox.cn/app-module-member",
     "@tbox.cn/app-module-parking",
@@ -12,5 +11,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 };