@tbox.cn/app-template-agent 0.10.18 → 0.10.20

package/.gitignore

@@ -18,7 +18,7 @@ dist-ssr
 .env.*
 !.env.example
 
-# 本地评测产物（tbox-app eval / start -d；报告与轨迹不进版本库）
+# 本地评测产物（仓内 QA 经 tbox-app-dev eval / start -d 驱动；报告与轨迹不进版本库）
 .eval/
 .tbox-server.json
 .tbox-server.log

package/.tbox/miniapp-containers.json

@@ -1,6 +1,6 @@
 [
   {
     "platform": "alipay",
-    "source": "@tbox.cn/app-miniapp-container-alipay@0.2.5"
+    "source": "@tbox.cn/app-miniapp-container-alipay@0.2.6"
   }
 ]

package/AGENTS.md

@@ -84,7 +84,7 @@ CLI 免安装，命令均经 `npx --yes @tbox.cn/app-cli <cmd>` 运行（下表
 | `module list` / `sync` / `diff` / `doctor` | 已装清单 / 增量装配 / 漂移对比 / 结构校验 |
 | `module update <module>` | 升级模块（codegen → 3-way merge） |
 | `new <module\|provider\|theme> <name>` | 应用内脚手架（生成 `packages/<id>` 并完成装配） |
-| `provider use / bind / unbind / unuse` | 集成绑定（写 `config/integrations.json`；仅字符串厂商——自定义 API 声明直接编辑该文件；bind/use 整槽覆盖既有 provider，含内联声明） |
+| `provider use / bind / unbind / unuse` | 集成绑定（写 `config/integrations.json`；v8 起自定义 API 统一 `provider-custom` 字符串厂商——CLI 全覆盖三层，含 `--module` 模块级单点绑定；bind/use 整槽覆盖既有 provider） |
 | `theme use <id>` / `theme list` | 主题接线 / 状态 |
 | `starter --list` / `starter --type <type>` | starter 文档查询（商圈模块清单见 `--type agent-mall`） |
 

package/ENV.md

@@ -133,11 +133,6 @@ dev/src 与 prod/dist bundle 形态恒等）：
 | `AUTH_TOKEN_ISSUER` | token issuer(默认 `agent`；如需 mall 独立身份可显式设 `agent-mall`) |
 | `AUTH_EMBED_EXTERNAL_TOKEN` | 是否把外部原始 token 内嵌进自有 JWT(external claim,默认 `true`;`false` 则上游调用需另取) |
 | `AUTH_EXTERNAL_TOKEN_MAX_BYTES` | external 原始 token 上限(bytes,默认 16KB=Node http header 上限)。external claim 使自有 JWT 膨胀 ~1.4x,生产网关 header 上限需 ≥16KB |
-| `AUTH_EXTERNAL_EXCHANGE_URL` | 外部 provider 换发地址;配置后 `/api/auth/login(platform=external)` 走 HMAC 转发换发 |
-| `AUTH_EXTERNAL_SECRET` | 外部换发 HMAC 密钥 |
-| `AUTH_EXTERNAL_PROVIDER` | 外部 provider 名(默认 `external`) |
-| `AUTH_EXTERNAL_JWT_PUBLIC_KEY` | 外部已签 JWT 验签公钥(PEM,RS256):外部返回 `{ jwt }` 且无 identity 时解 `sub`;未配置则解码 `payload.sub` |
-| `AUTH_EXTERNAL_TIMEOUT_MS` | 外部换发请求超时(毫秒,默认 3000) |
 
 ### 真实支付宝登录链路(provider 包换码器自注册)
 
@@ -150,8 +145,6 @@ dev/src 与 prod/dist bundle 形态恒等）：
   appId 字段已配(漏配 → 该 mall 503,字段名见各 provider 包)。
 - 登录双形态与复合凭证语义由各 provider 包承载;`AUTH_TOKEN_TTL_MS` 保守建议 ≤2h
   (上游 Token 寿命未知;自有 JWT 过期即重登换新)。
-- ⚠️ 与 `VITE_AUTH_PROVIDER=external` **互斥**:设 external 走 `AUTH_EXTERNAL_*` HMAC 转发旁路,
-  换码器被 platform 路由绕过,两者勿同时启用。
 - 裸跑(无登录槽配置):无换码器注册 → 内置 alipay/weapp;未配 env → **200 guest 降级**
   (Fix D——内置换码器声明 allowsGuestLogin,`[AUTH] login failed (downgraded to guest)` warn
   可观测;意图真实支付宝登录却恒 guest 时查该日志)或 browser 轴 guest,匿名降级属预期行为。
@@ -164,7 +157,6 @@ dev/src 与 prod/dist bundle 形态恒等）：
 
 | 变量 | 说明 |
 |---|---|
-| `VITE_AUTH_PROVIDER` | 登录平台:外部 provider 场景设 `external`(壳内 `getAuthCode` → `/api/auth/login(platform=external)` 转发外部);缺省 `alipay`(本地换码)。消费方:`platform/agent-runtime.ts` 的 `createAuthClient({ loginPlatform })` |
 | `VITE_API_URL` | 前端 API 地址覆盖(默认同源相对路径,开发期可指向 server)。消费方:`main.tsx` 的 `configureRuntime({ apiBaseUrl })`（007：SDK 零 Vite 依赖，环境值由模板注入） |
 
 ## 可选
@@ -178,7 +170,7 @@ dev/src 与 prod/dist bundle 形态恒等）：
 | `TBOX_PRE_TOOL_TIMEOUT_MS` | 前置工具(010)单工具总预算 ms(decide+execute 共享):默认 `2000`;`0` = 整体禁用(预执行全关,行为与未启用逐字节一致)。非法值回退默认 |
 | `TBOX_TOOL_DEBUG` | 工具调试视图(018):`1` 开 / `0` 关;缺省 = 非 `NODE_ENV=production` 开启。开启时 memory 召回/silent 前置工具以伪工具事件下发前端(不持久化)且 HELLO_ACK 携带旗标解锁客户端 dev 工具视图(出入参展开+技术名+紧凑格式)。**生产勿开**——测试环境开启会使 silent 检索 query 与用户记忆预览(截断 200 字符)对页面访问者可见。非法值回退缺省 |
 | `TBOX_EARLY_TOOL_EXECUTION` | 尽早工具执行(缺省 `off`):`1`/`true` 开启。模型流中白名单工具(只读查询类,`withEarlyExecution` 标记)参数流完即预执行,多工具轮延迟优化;收益依赖 `parallelToolCalls` 开启;参数漂移自动作废重执行(正确性无损);单工具轮行为等价现状。仅显式 opt-in,观测 journal `tool_preexec` |
-| `MALL_HOME_DEV_SERVICES` | 首页「常用服务」开发测试入口展示开关:`true`/`1` 展示,`false`/`0`/缺席隐藏(fail-closed,正式用户零透出;生产部署不配置即隐藏态)。server 启动期解析,经 `GET /api/m/mall-core/config` 下发前端(响应 `{ showDevServices: boolean }`);env 变更需重启进程。注入走外层 source(档位 env 文件/启动器 scripts/app-dev.mjs),`tbox-app dev` 不注入 env 值 |
+| `MALL_HOME_DEV_SERVICES` | 首页「常用服务」开发测试入口展示开关:`true`/`1` 展示,`false`/`0`/缺席隐藏(fail-closed,正式用户零透出;生产部署不配置即隐藏态)。server 启动期解析,经 `GET /api/m/mall-core/config` 下发前端(响应 `{ showDevServices: boolean }`);env 变更需重启进程。注入走外层 source(档位 env 文件/启动器 scripts/app-dev.mjs),`tbox-app-dev dev` 不注入 env 值 |
 | `HOST` | 服务监听地址(默认 `0.0.0.0`) |
 | `PORT` | 服务监听端口(默认 `8000`) |
 | `TBOX_DEV_TOKEN` | 沙箱 dev server 鉴权 token(方案 W;平台运行时注入,**本地无需设置**):形状 `^[A-Za-z0-9_-]{20,128}$`。在场 → protected 双面裁决——dev 面(凭据 + 浏览器导航/同源信号)完整 vite 能力,static 面(无凭据/跨源子资源)dist 静态 + SPA fallback catch-all(GET/HEAD 未命中恒回入口页,对齐生产)+ SSE 刷新,零源码泄漏;缺席 → classic(与历史行为字节级等价)。在场但形状不合规 → fail-closed 全 static。配套:`GET /__tbox_dev_hot_reload`(static 面刷新 SSE,凭据无关);HMR WS 凭据走 query(`tbox_dev_token`,页面 bootstrap 自动补参);protected 面 vite `fs.allow` 收窄(client 源 + 工作区依赖真源)+ `fs.deny` 保留 |
@@ -199,7 +191,7 @@ export TTS_APPKEY=your-tts-appkey   # 敏感值勿提交;本地 shell export 注
 export MALL_HOME_DEV_SERVICES=true
 ```
 
-# tbox-app dev 配置面
+# tbox-app-dev dev 配置面
 
 - `TBOX_CONFIG_DIR`：dev 命令注入的配置目录覆盖（preset `configDir` / `--config-dir` 旗标显式指定的目录绝对路径——config 恒显式）；未设时使用默认 `config/`。
   覆盖面含 `llm_provider.json`（`modelName`/`thinking`）：注入时 LLM 装配读档位目录文件，

package/INTEGRATION.md

@@ -66,21 +66,25 @@
 
 ## 声明落点
 
-| 维度 | 声明范围 | 共享连接参数落点 |
-|---|---|---|
-| 指定服务 | `services.<slot>` 单槽 | 槽/实例级 `config` |
-| 指定模块 | 模块 `declare.owns` 全部服务槽（snapshot 除外） | `modules[<install id>].config` |
-| 应用 | 已装业务模块 owns 并集（空装配不适用） | root `config` |
+| 维度 | 绑定（单点） | 激活 | 共享连接参数落点 |
+|---|---|---|---|
+| 指定服务 | `services.<slot>.provider = "provider-custom"` | 节点本身 | 槽/实例级 `config` |
+| 指定模块 | `modules[<install id>].provider = "provider-custom"`（**单点作用于全部 ownedServices**） | owned 槽补 `{}` 通配节点 | `modules[<install id>].config` |
+| 应用 | root `provider = "provider-custom"` | 同左逐槽 | root `config` |
+
+推荐 CLI（等价路径）：`tbox-app provider use provider-custom --module <install id>`（模块）/
+`provider use provider-custom`（应用）/ `provider bind <slot> provider-custom`（服务）。
 
 关键形态约束：
 
-- **内联 provider 声明（对象形态）恒槽级合法**——`modules[].provider` 与 root
-  `provider` 只接受字符串厂商名（zod 直接拒，fail-visible）。模块/应用维度 = 逐槽落
-  对象声明，共享的是 `config` 层。
-- `implementation` 写 `<provider名>@1` 字面量（槽级兄弟键，不在 provider 对象内）。
+- **绑定与激活正交**：provider 选择单点落绑定层；激活 = `services[<slot>]` 节点在场
+  （`{}` 空槽 = 通配激活，实例差异化再补 instances 键）。只写绑定不写激活 → 服务保持
+  `service-not-configured`（诚实暴露，非错误）。
+- **内联 provider 声明（对象形态）已弃用（v8）**：存量兼容读；迁移 =
+  `tbox-app provider migrate --write`（内联 → provider-custom 统一落点，迁移后 ⚠ 待接入，
+  按 provider-custom/INTEGRATION.md 实施转 ok）。
 - 完整字段语义（各层级联、instances 激活等）单源 = `@tbox.cn/app-contracts` 的
-  integrations-config（zod 校验，与运行时同一解析面）；可复制片段见
-  `packages/provider-custom/INTEGRATION.md`「内联声明 JSON 片段」。
+  integrations-config（zod 校验，与运行时同一解析面）。
 - **provider 名三处一致**（声明/注册/凭据）规则与失败信号见
   `packages/provider-custom/INTEGRATION.md`「provider 名三处一致」。
 

package/README.md

@@ -182,7 +182,7 @@ definePreTool(findStoreTool, {
 | `getToolRequestContext` / `requireToolRequestContext` | `@tbox.cn/app-sdk/server` | 工具 execute 第二参读取运行上下文（fail-soft / 缺失抛 AUTH_FORBIDDEN；上下文统一化） |
 | `createToolExecContext(reqCtx)` | `@tbox.cn/app-sdk/server` | 测试/直调助手：构造工具 execute 第二参（散键与引擎同构） |
 | `createPlatformAdapters(session, overrides)` | `@tbox.cn/app-sdk/client` | 自定义 ASR/TTS/upload/feedback 实现（contracts 接口，UI 零改动） |
-| `createAuthClient({ loginPlatform, scopeKey })` | `@tbox.cn/app-sdk/client` | 客户端登录配置（`main.tsx`/`platform/agent-runtime.ts`）；**应用级单例**——重复调用幂等返回首建实例，首建选项生效 |
+| `createAuthClient({ scopeKey })` | `@tbox.cn/app-sdk/client` | 客户端登录配置（`platform/agent-runtime.ts`）；**应用级单例**——重复调用幂等返回首建实例，首建选项生效 |
 | `configureRuntime({ apiBaseUrl })` | `@tbox.cn/app-sdk/client` | API/WS 地址注入（`main.tsx`；对应 `VITE_API_URL`） |
 | bridge 透传 | `@tbox.cn/app-sdk/client` 的 `callJsapi` | 业务新能力（扫码/导航/分享等，壳子补 JSAPI 白名单） |
 

package/apps/client/src/platform/agent-runtime.ts

@@ -1,17 +1,13 @@
 /**
  * 平台运行时装配（client 平台轴，已下沉 @tbox.cn/app-agent-sdk-client）。
  * 模板唯一的 SDK 单例持有点：authClient（鉴权）+ platformApi（能力凭证/会话/历史）。
- * 环境值（VITE_API_URL / VITE_AUTH_PROVIDER）由 main.tsx 经 configureRuntime / 选项注入（H1）。
+ * 环境值（VITE_API_URL）由 main.tsx 经 configureRuntime 注入（H1）。
  */
 import { createAuthClient, createPlatformApi } from '@tbox.cn/app-agent-sdk-client';
 // 读源归位 TIER1（）：mall-scope-url 契约助手（search-only 语义；壳 URL 改写层契约见包注释）
 import { readMallIdFromUrl } from '@app/contracts-mall';
 
-/** VITE_AUTH_PROVIDER=external 时壳内换码登录转发外部（服务端需同步配置 AUTH_EXTERNAL_*） */
-const AUTH_PROVIDER = import.meta.env.VITE_AUTH_PROVIDER as string | undefined;
-
 export const authClient = createAuthClient({
-  ...(AUTH_PROVIDER === 'external' ? { loginPlatform: 'external' } : {}),
   // SPEZ-017：token 缓存域键——URL mallId 变更即失效旧 token 重登（跨 mall 防串域）。
   // 读源与 chat.ts configureHelloContext 逐字符同源（mall-scope-url.ts 唯一真源，search-only）
   scopeKey: () => readMallIdFromUrl() ?? '',

package/apps/client/vite.config.ts

@@ -27,8 +27,8 @@ const pxToRemPlugin = pxToRem({
 });
 
 export default defineConfig(async ({ command }) => {
-  // tbox-app dev 探测行（dev 探针常量；构件区在位时启用原地装配改指，缺席零行为变化。
-  // guard 断言本标记在场——重定位需同步 cli 探针与 guard 两处）
+  // tbox-app-dev dev 探测行（dev 探针常量；构件区在位时启用原地装配改指，缺席零行为变化。
+  // guard 断言本标记在场——重定位需同步 dev 探针（cli-dev）与 guard 两处）
   // __dirname 基准 = apps/client：构件区在模板根（上一级×2）
   const devOverridePath = resolve(__dirname, '../../.tbox-dev.local/vite-override.mjs');
   const devPlugins: Plugin[] = [];

package/apps/server/src/app.ts

@@ -74,7 +74,7 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url));
 // entry 即 bundle 实文件：src/dist 平级，dev/prod 恒等。被 tsup 内联的模块禁止
 // 基于自身 import.meta.url 做层级解析（bundle 后层级漂移——config 曾因此解析到
 // 应用根上一级）。同族锚点：../skills、../../client/dist。
-// TBOX_CONFIG_DIR 为 tbox-app dev 的配置面注入锚点（dev 探针常量，guard 守护）：
+// TBOX_CONFIG_DIR 为 tbox-app-dev dev 的配置面注入锚点（dev 探针常量，guard 守护）：
 // 注入时为 real-env 档位目录绝对路径；未注入维持默认相对解析。
 const CONFIG_DIR = process.env.TBOX_CONFIG_DIR
   ? path.resolve(process.env.TBOX_CONFIG_DIR)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tbox.cn/app-template-agent",
-  "version": "0.10.18",
+  "version": "0.10.20",
   "description": "tbox AI Agent 全栈模板（多包 pnpm workspace）：apps/client + apps/server。唯一模板（W4 单一模板统一化：缺省带 AI 支付体验的 chat 形态；mall 能力经 profiles/mall 加装），能力经 tbox-app module add 模块扩展（shopping-guide/member 等）。",
   "engines": {
     "node": ">=24.0.0 <25.0.0"
@@ -37,7 +37,7 @@
     "typescript-eslint": "8.67.0",
     "eslint-plugin-react-hooks": "5.2.0",
     "vite": "6.4.3",
-    "@tbox.cn/app-sdk-server": "0.25.0"
+    "@tbox.cn/app-sdk-server": "0.26.0"
   },
   "license": "MIT",
   "publishConfig": {

package/packages/provider-custom/INTEGRATION.md

@@ -35,8 +35,10 @@
 | 内联对象 `{ provider, credentialType }` | **本包**（provider-custom） | 未注册 → `PROVIDER_NOT_IMPLEMENTED` |
 | 字符串厂商名（如 `"mall-demo"`） | 对应正式 provider 包（catalog 来源；`packages/provider-mock` 为样例） | catalog 无此厂商 → **`PROVIDER_NOT_FOUND`** |
 
-**本包 adapter 禁止配字符串声明**：本包零贡献（manifest 无
-`declare.providers.slots`），永不进 provider catalog——字符串声明运行时按
+**v8 起：字符串声明 `"provider-custom"` = 唯一推荐声明形态**——本包经
+`declare.providers.id` 自声明入 provider catalog（零槽起步，AI 实施即补槽声明：
+`{ service, provider: 'provider-custom', implementation, credentialType, configSchema? }`）。
+历史条款「禁止配字符串声明」随零槽形态退役。存量内联对象声明运行时按
 catalog 查表，必报 `PROVIDER_NOT_FOUND`（错误文案「provider 未命中
 catalog」≠ 名字拼错，是**形态落错**）。
 
@@ -62,7 +64,7 @@ catalog」≠ 名字拼错，是**形态落错**）。
 
 | ❌ 错误 | 原因 |
 |---|---|
-| `"provider": { "provider": "my-api", "implementation": "my-api@1" }` | `implementation` 不是内联对象字段（zod 拒） |
+| `"provider": { "provider": "my-api", "implementation": "my-api@1" }` | `implementation` 不是内联对象字段（zod 拒）——v8 弃用形态，存量迁移 `tbox-app provider migrate --write` |
 | `"provider": "my-api"` 而 adapter 在本包 | catalog 查表失配 → `PROVIDER_NOT_FOUND`（见上节） |
 | `"instances": {}` | 零激活（省略 = 通配激活） |
 
@@ -117,7 +119,7 @@ import type { ServerContext } from '@tbox.cn/app-agent-sdk-server';
 import { myApiFactory } from './my-api';
 
 // register(ctx) 内：
-ctx.integrations?.registerAdapter('my-api', 'inline', myApiFactory);
+ctx.integrations?.registerAdapter('provider-custom', '<implementation>', myApiFactory);
 ```
 
 单 factory 多服务：按 `input.service` 分支返回不同 Port 实现（服务清单见

package/packages/provider-custom/tbox.module.json

@@ -22,8 +22,10 @@
     "pages": [],
     "tabs": [],
     "providers": {
-      "slots": []
+      "slots": [],
+      "id": "provider-custom"
     },
     "consumes": []
-  }
+  },
+  "name": "自定义 API"
 }

package/pnpm-lock.template.yaml

@@ -6,9 +6,6 @@ settings:
 
 catalogs:
   default:
-    '@phosphor-icons/react':
-      specifier: 2.1.10
-      version: 2.1.10
     '@tbox-dev-js/sdk':
       specifier: 0.1.18
       version: 0.1.18
@@ -16,23 +13,20 @@ catalogs:
       specifier: 0.1.0
       version: 0.1.0
     '@tbox.cn/app-agent-sdk-client':
-      specifier: 0.1.6
-      version: 0.1.6
+      specifier: 0.2.0
+      version: 0.2.0
     '@tbox.cn/app-agent-sdk-server':
-      specifier: 0.2.3
-      version: 0.2.3
+      specifier: 0.3.0
+      version: 0.3.0
     '@tbox.cn/app-contracts':
-      specifier: 0.13.0
-      version: 0.13.0
-    '@tbox.cn/app-contracts-mall':
-      specifier: 0.13.0
-      version: 0.13.0
+      specifier: 0.13.1
+      version: 0.13.1
     '@tbox.cn/app-sdk-client':
       specifier: 0.21.3
       version: 0.21.3
     '@tbox.cn/app-sdk-server':
-      specifier: 0.25.0
-      version: 0.25.0
+      specifier: 0.26.0
+      version: 0.26.0
     '@tbox.cn/app-theme-tbox':
       specifier: 0.1.4
       version: 0.1.4
@@ -51,9 +45,6 @@ catalogs:
     '@vitejs/plugin-react':
       specifier: 4.7.0
       version: 4.7.0
-    antd-mobile:
-      specifier: 5.42.3
-      version: 5.42.3
     eslint:
       specifier: 9.39.5
       version: 9.39.5
@@ -78,12 +69,6 @@ catalogs:
     react-dom:
       specifier: 18.3.1
       version: 18.3.1
-    react-markdown:
-      specifier: 9.1.0
-      version: 9.1.0
-    remark-gfm:
-      specifier: 4.0.1
-      version: 4.0.1
     tsup:
       specifier: 8.5.1
       version: 8.5.1
@@ -118,7 +103,7 @@ importers:
     devDependencies:
       '@tbox.cn/app-sdk-server':
         specifier: 'catalog:'
-        version: 0.25.0
+        version: 0.26.0
       eslint:
         specifier: 'catalog:'
         version: 9.39.5
@@ -140,15 +125,18 @@ importers:
       '@app/contracts-mall':
         specifier: workspace:*
         version: link:../../packages/contracts-mall
+      '@app/module-ai-payment':
+        specifier: workspace:*
+        version: link:../../packages/module-ai-payment
       '@app/provider-custom':
         specifier: workspace:*
         version: link:../../packages/provider-custom
       '@tbox.cn/app-agent-sdk-client':
         specifier: 'catalog:'
-        version: 0.1.6(@types/react@18.3.31)
+        version: 0.2.0(@types/react@18.3.31)
       '@tbox.cn/app-contracts':
         specifier: 'catalog:'
-        version: 0.13.0
+        version: 0.13.1
       '@tbox.cn/app-theme-tbox':
         specifier: 'catalog:'
         version: 0.1.4
@@ -203,7 +191,7 @@ importers:
         version: 0.21.3
       '@tbox.cn/app-sdk-server':
         specifier: 'catalog:'
-        version: 0.25.0
+        version: 0.26.0
       typescript:
         specifier: 'catalog:'
         version: 5.9.3
@@ -216,6 +204,9 @@ importers:
       '@app/contracts-mall':
         specifier: workspace:*
         version: link:../../packages/contracts-mall
+      '@app/module-ai-payment':
+        specifier: workspace:*
+        version: link:../../packages/module-ai-payment
       '@app/provider-custom':
         specifier: workspace:*
         version: link:../../packages/provider-custom
@@ -227,10 +218,10 @@ importers:
         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-agent-sdk-server':
         specifier: 'catalog:'
-        version: 0.2.3(@tbox-dev-js/sdk@0.1.18)(rxjs@7.8.1)
+        version: 0.3.0(@tbox-dev-js/sdk@0.1.18)(rxjs@7.8.1)
       '@tbox.cn/app-contracts':
         specifier: 'catalog:'
-        version: 0.13.0
+        version: 0.13.1
       express:
         specifier: 'catalog:'
         version: 4.22.2
@@ -263,85 +254,140 @@ importers:
   packages/agent-ui-kit:
     dependencies:
       '@phosphor-icons/react':
-        specifier: 'catalog:'
+        specifier: 2.1.10
         version: 2.1.10(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
       '@tbox.cn/app-agent-sdk-client':
         specifier: 'catalog:'
-        version: 0.1.6(@types/react@18.3.31)
+        version: 0.2.0(@types/react@18.3.31)
       '@tbox.cn/app-contracts':
         specifier: 'catalog:'
-        version: 0.13.0
+        version: 0.13.1
       antd-mobile:
-        specifier: 'catalog:'
+        specifier: 5.42.3
         version: 5.42.3(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
       react-markdown:
-        specifier: 'catalog:'
+        specifier: 9.1.0
         version: 9.1.0(@types/react@18.3.31)(react@18.3.1)
       remark-gfm:
-        specifier: 'catalog:'
+        specifier: 4.0.1
         version: 4.0.1
       zustand:
-        specifier: 'catalog:'
+        specifier: 4.5.7
         version: 4.5.7(@types/react@18.3.31)(react@18.3.1)
     devDependencies:
       '@types/node':
-        specifier: 'catalog:'
+        specifier: 24.13.3
         version: 24.13.3
       '@types/react':
-        specifier: 'catalog:'
+        specifier: 18.3.31
         version: 18.3.31
       '@types/react-dom':
-        specifier: 'catalog:'
+        specifier: 18.3.7
         version: 18.3.7(@types/react@18.3.31)
       happy-dom:
-        specifier: 'catalog:'
+        specifier: 20.11.2
         version: 20.11.2
       less:
-        specifier: 'catalog:'
+        specifier: 4.8.1
         version: 4.8.1
       react:
-        specifier: 'catalog:'
+        specifier: 18.3.1
         version: 18.3.1
       react-dom:
-        specifier: 'catalog:'
+        specifier: 18.3.1
         version: 18.3.1(react@18.3.1)
       typescript:
-        specifier: 'catalog:'
+        specifier: 5.9.3
         version: 5.9.3
       vite:
-        specifier: 'catalog:'
+        specifier: 6.4.3
         version: 6.4.3(@types/node@24.13.3)(less@4.8.1)(tsx@4.23.11)
       vitest:
-        specifier: 'catalog:'
+        specifier: 4.1.10
         version: 4.1.10(@opentelemetry/api@1.9.1)(@types/node@24.13.3)(happy-dom@20.11.2)(vite@6.4.3(@types/node@24.13.3)(less@4.8.1)(tsx@4.23.11))
 
   packages/contracts-mall:
     dependencies:
-      '@tbox.cn/app-contracts-mall':
+      '@tbox.cn/app-contracts':
+        specifier: 'catalog:'
+        version: 0.13.1
+      zod:
+        specifier: 3.25.76
+        version: 3.25.76
+    devDependencies:
+      happy-dom:
+        specifier: 20.11.2
+        version: 20.11.2
+      tsup:
+        specifier: 8.5.1
+        version: 8.5.1(postcss@8.5.26)(tsx@4.23.11)(typescript@5.9.3)
+      typescript:
+        specifier: 5.9.3
+        version: 5.9.3
+      vitest:
+        specifier: 4.1.10
+        version: 4.1.10(@opentelemetry/api@1.9.1)(@types/node@24.13.3)(happy-dom@20.11.2)(vite@6.4.3(@types/node@24.13.3)(less@4.8.1)(tsx@4.23.11))
+
+  packages/module-ai-payment:
+    dependencies:
+      '@app/contracts-mall':
+        specifier: workspace:*
+        version: link:../contracts-mall
+      '@phosphor-icons/react':
+        specifier: 2.1.10
+        version: 2.1.10(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      '@tbox.cn/app-agent-sdk-client':
+        specifier: 'catalog:'
+        version: 0.2.0(@types/react@18.3.31)
+      '@tbox.cn/app-agent-sdk-server':
+        specifier: 'catalog:'
+        version: 0.3.0(@tbox-dev-js/sdk@0.1.18)(rxjs@7.8.1)
+      '@tbox.cn/app-contracts':
         specifier: 'catalog:'
-        version: 0.13.0
+        version: 0.13.1
+      react:
+        specifier: 18.3.1
+        version: 18.3.1
     devDependencies:
       '@types/node':
         specifier: 24.13.3
         version: 24.13.3
+      '@types/react':
+        specifier: 18.3.31
+        version: 18.3.31
+      '@types/react-dom':
+        specifier: 18.3.7
+        version: 18.3.7(@types/react@18.3.31)
+      happy-dom:
+        specifier: 20.11.2
+        version: 20.11.2
+      react-dom:
+        specifier: 18.3.1
+        version: 18.3.1(react@18.3.1)
+      tsup:
+        specifier: 8.5.1
+        version: 8.5.1(postcss@8.5.26)(tsx@4.23.11)(typescript@5.9.3)
       typescript:
         specifier: 5.9.3
         version: 5.9.3
       vitest:
         specifier: 4.1.10
         version: 4.1.10(@opentelemetry/api@1.9.1)(@types/node@24.13.3)(happy-dom@20.11.2)(vite@6.4.3(@types/node@24.13.3)(less@4.8.1)(tsx@4.23.11))
+      zod:
+        specifier: 3.25.76
+        version: 3.25.76
 
   packages/provider-custom:
     dependencies:
       '@tbox.cn/app-agent-sdk-client':
         specifier: 'catalog:'
-        version: 0.1.6(@types/react@18.3.31)
+        version: 0.2.0(@types/react@18.3.31)
       '@tbox.cn/app-agent-sdk-server':
         specifier: 'catalog:'
-        version: 0.2.3(@tbox-dev-js/sdk@0.1.18)(rxjs@7.8.1)
+        version: 0.3.0(@tbox-dev-js/sdk@0.1.18)(rxjs@7.8.1)
       '@tbox.cn/app-contracts':
         specifier: 'catalog:'
-        version: 0.13.0
+        version: 0.13.1
     devDependencies:
       '@types/node':
         specifier: 24.13.3
@@ -1365,22 +1411,22 @@ packages:
       '@tbox-dev-js/sdk': '>=0.1.18 <0.2.0'
       zod: '>=3.24.0 <4.0.0'
 
-  '@tbox.cn/app-agent-sdk-client@0.1.6':
-    resolution: {integrity: sha512-/dCthY+JEccMPGafALYkhPRDRBPHSzPklNfXw63XQqhU7yrvqgeyuOXFrhkSYU5ZFzupZErUndXpiZz/zzJVug==}
-    engines: {node: '>=20.0.0'}
-
-  '@tbox.cn/app-agent-sdk-server@0.2.3':
-    resolution: {integrity: sha512-EeSXpW1Aoy85Z9ZXCKSlziGhxyBeQCWQDRuLdkg7ReVKthNXfFKcAiIiaZIQkSjoZB1OL3Qlg8xl2cLqiXZxHA==}
+  '@tbox.cn/app-agent-sdk-client@0.2.0':
+    resolution: {integrity: sha512-yxK5vLuERzlebTwiw8WxU6e9rm7F1L9tVW4aSUGsIxeU0y8VtRcrh7y8xKbrlXR4WL4XrmYZ6ZoDyOuro9sn5A==}
     engines: {node: '>=20.0.0'}
 
-  '@tbox.cn/app-contracts-mall@0.13.0':
-    resolution: {integrity: sha512-EzLRs93WoHbqYI9MZV555ru14jTYnUILhClFisJXd3vlXTpHw9T1annSaa4IpkHepsX6AmCT5FxwvRUZcZ6T3A==}
+  '@tbox.cn/app-agent-sdk-server@0.3.0':
+    resolution: {integrity: sha512-thnnPwA0Tkb3yf+HxmeIEDyji6myIJVKvyhzn0WWuVJN7mg9I6+juTimxwRNhqnpZBjue3kExMw75+MvTineYA==}
     engines: {node: '>=20.0.0'}
 
   '@tbox.cn/app-contracts@0.13.0':
     resolution: {integrity: sha512-8sqP/23MoUlbTX9enFNotP5bu7XKFfigDUJ6sEn1Ff2a0rRlSTWzLWmDv9lP70cfZMPjh4MHoLKFoukr8QPvMA==}
     engines: {node: '>=20.0.0'}
 
+  '@tbox.cn/app-contracts@0.13.1':
+    resolution: {integrity: sha512-Cty4qoknyihli6ZMlxOqqTgRqwg0NOh0WOMfIWdB4rHua0QzZkP1jUoeffq5imnpIh7vXdfLhDpv/JwTrHd1XQ==}
+    engines: {node: '>=20.0.0'}
+
   '@tbox.cn/app-sdk-client@0.21.3':
     resolution: {integrity: sha512-64y22k5gzCc9eEQ0IJA1izxPaosNEmoCJ4YrsfHOoHYq2UPJCCmP7RIu3Rn4stPZ4tcmRdMdAi2y5499KObYHw==}
     engines: {node: '>=20.0.0'}
@@ -1389,16 +1435,16 @@ packages:
     resolution: {integrity: sha512-4kcoxnZnPgsO0RwAsjsodOXRhZNQcr9r3INN3Z03/JR2e3E+izkW2YHsgGcdbVSVX81s8gZrkaBbE+xco3wSqg==}
     engines: {node: '>=20.0.0'}
 
-  '@tbox.cn/app-sdk-server@0.25.0':
-    resolution: {integrity: sha512-wKKbmFnY6YU+mQOoak4UADWe1nWZKKdZeGqzatWC9Ny0W05QtDGLG9ql9kP1IwN3a5S6lFf4A6OBdSwERTFqTw==}
+  '@tbox.cn/app-sdk-server@0.26.0':
+    resolution: {integrity: sha512-VpV3sf4K/2MEsnkuK5EqZUyf9KoSVHeJUm4Al0M6R4Wumg6183apnxB2f38S5wuP30JSJShN/ww63EzRniTrjw==}
     engines: {node: '>=20.0.0'}
     hasBin: true
 
   '@tbox.cn/app-theme-tbox@0.1.4':
     resolution: {integrity: sha512-VF2fjTBFKJ6x/wvM6/T0qi7dmoiN1stNIT2xDerYbBBLCggr7f+H0v6VtuFMSed6tirlcpAlqtBDOctxudHJlQ==}
 
-  '@tbox.cn/app-toolkit@0.7.5':
-    resolution: {integrity: sha512-ObVkHKElsDz/JazUHkBaIGYYDxZxvQEtjFAk77HXBc0+PSikSRmtb62F99PWGibTnOSLq6wlkGWhk/y+Iy1UOg==}
+  '@tbox.cn/app-toolkit@0.8.0':
+    resolution: {integrity: sha512-urefCf5DCWbH9wM8dSGavA9MNdY4gx7LY16+s9jIlwhahq83mfrCP2h9ombn44ljMrv04G7mnb3vMtNeWs5/Ug==}
     engines: {node: '>=20.0.0'}
 
   '@types/babel__core@7.20.5':
@@ -4108,9 +4154,10 @@ snapshots:
       '@tbox-dev-js/sdk': 0.1.18
       zod: 3.25.76
 
-  '@tbox.cn/app-agent-sdk-client@0.1.6(@types/react@18.3.31)':
+  '@tbox.cn/app-agent-sdk-client@0.2.0(@types/react@18.3.31)':
     dependencies:
-      '@tbox.cn/app-contracts': 0.13.0
+      '@phosphor-icons/react': 2.1.10(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      '@tbox.cn/app-contracts': 0.13.1
       '@tbox.cn/app-sdk-client': 0.21.3
       '@tbox.cn/app-sdk-core': 0.20.4
       react: 18.3.1
@@ -4120,7 +4167,7 @@ snapshots:
       - '@types/react'
       - immer
 
-  '@tbox.cn/app-agent-sdk-server@0.2.3(@tbox-dev-js/sdk@0.1.18)(rxjs@7.8.1)':
+  '@tbox.cn/app-agent-sdk-server@0.3.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)
@@ -4128,9 +4175,9 @@ snapshots:
       '@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.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.13.0
+      '@tbox.cn/app-contracts': 0.13.1
       '@tbox.cn/app-sdk-core': 0.20.4
-      '@tbox.cn/app-sdk-server': 0.25.0
+      '@tbox.cn/app-sdk-server': 0.26.0
       ai: 6.0.246(zod@3.25.76)
       express: 4.22.2
       gray-matter: 4.0.3
@@ -4148,12 +4195,13 @@ snapshots:
       - utf-8-validate
       - workflow
 
-  '@tbox.cn/app-contracts-mall@0.13.0':
+  '@tbox.cn/app-contracts@0.13.0':
     dependencies:
-      '@tbox.cn/app-contracts': 0.13.0
+      '@ag-ui/core': 0.0.47
+      react: 18.3.1
       zod: 3.25.76
 
-  '@tbox.cn/app-contracts@0.13.0':
+  '@tbox.cn/app-contracts@0.13.1':
     dependencies:
       '@ag-ui/core': 0.0.47
       react: 18.3.1
@@ -4170,12 +4218,12 @@ snapshots:
     dependencies:
       '@tbox.cn/app-contracts': 0.13.0
 
-  '@tbox.cn/app-sdk-server@0.25.0':
+  '@tbox.cn/app-sdk-server@0.26.0':
     dependencies:
       '@ag-ui/core': 0.0.47
-      '@tbox.cn/app-contracts': 0.13.0
+      '@tbox.cn/app-contracts': 0.13.1
       '@tbox.cn/app-sdk-core': 0.20.4
-      '@tbox.cn/app-toolkit': 0.7.5
+      '@tbox.cn/app-toolkit': 0.8.0
       express: 4.22.2
       jose: 6.2.8
       zod: 3.25.76
@@ -4184,7 +4232,7 @@ snapshots:
 
   '@tbox.cn/app-theme-tbox@0.1.4': {}
 
-  '@tbox.cn/app-toolkit@0.7.5':
+  '@tbox.cn/app-toolkit@0.8.0':
     dependencies:
       ajv: 8.20.0
       zod: 3.25.76

package/pnpm-workspace.template.yaml

@@ -40,11 +40,11 @@ catalog:
   "@tbox.cn/agent-plugin": 0.1.0
   "@tbox.cn/app-sdk-core": 0.20.4
   "@tbox.cn/app-sdk-client": 0.21.3
-  "@tbox.cn/app-sdk-server": 0.25.0
-  "@tbox.cn/app-agent-sdk-server": 0.2.3
-  "@tbox.cn/app-agent-sdk-client": 0.1.6
-  "@tbox.cn/app-contracts": 0.13.0
-  "@tbox.cn/app-contracts-mall": 0.13.0
+  "@tbox.cn/app-sdk-server": 0.26.0
+  "@tbox.cn/app-agent-sdk-server": 0.3.0
+  "@tbox.cn/app-agent-sdk-client": 0.2.0
+  "@tbox.cn/app-contracts": 0.13.1
+  "@tbox.cn/app-contracts-mall": 0.13.1
   "@tbox.cn/app-theme-tbox": 0.1.4
   zustand: 4.5.7
   eslint: 9.39.5