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

package/AGENTS.md

@@ -1,15 +1,6 @@
 # AGENTS.md
 
-template-agent 是多包 pnpm workspace：`apps/` 薄组装端 + `packages/` 模块。客户端同时运行在浏览器和支付宝小程序 web-view 壳中。
-
-> **唯一模板（W4 单一模板统一化）**：缺省出厂 = 空装配（chat 形态）；商圈形态经 `profiles/mall.json` 画像加装
-> （`tbox-app create --profile mall`：mall-core/mall-home + 六业务模块 + config 叠加）。历史 base/mall 双生约定退役。
-
-> **工作区上下文（发布态消费，005 v0.4.0）**：仓库内本目录是**根 workspace 成员子树**（无独立 `pnpm-workspace.yaml`），
-> 平台引用 `catalog:` + 根 `pnpm-workspace.yaml` `overrides: workspace:*` 回指根 `packages/` 真源；`pnpm` 命令在根上下文执行。
-> `tbox-app create` 从模板源（目录或 pack tgz）展开生成应用——**不拼接平台真源**：生成应用 `packages/` 仅业务/local 模块，
-> 平台包以 `catalog:` 引用，验证态经注入 overrides（`file:` 本地 tgz）、生产态经 registry 安装；`pnpm-workspace.yaml` 由
-> `pnpm-workspace.template.yaml` 改名生成。
+本应用是多包 pnpm workspace：`apps/` 薄组装端 + `packages/` 模块。客户端同时运行在浏览器和支付宝小程序 web-view 壳中；缺省为空装配（chat 形态），商圈形态为创建期 `--profile mall` 画像加装产物（应用内以已装模块为准）。
 
 ## 工程结构
 
@@ -17,10 +8,8 @@ template-agent 是多包 pnpm workspace：`apps/` 薄组装端 + `packages/` 模
 |---|---|
 | `apps/server` | Express + WS 装配入口，HTTP 路由，TTS 代理；业务工具/卡片由模块自注册（自注册闭环） |
 | `apps/client` | React/Vite 装配入口，业务页面/组件/adapters/bridge（家页 MallHome 由 mall-home 模块经 home 槽供给） |
-| `packages/` | 模块目录（空装配起点：`tbox-app new module <name>` 或 `module add` 生成 `@app/<id>` 成员；根 workspace 内平台真源在根 `packages/`） |
-
-> **画像供能（017 家族）**：mall 形态 = profiles/mall.json 声明的模块序列（mall-core 域装配 + mall-home 家页 + 六业务模块）
-> + profiles/mall/config 叠加；公共能力（协议/机制/配置链）沉淀 SDK/CLI——新增通用能力先落 SDK/kit 再被模板/模块消费。
+| `packages/` | 模块目录（`tbox-app new module <name>` 或 `module add` 生成 `@app/<id>` 成员；出厂预装 `provider-custom`（自定义 API 实施落点）、`agent-ui-kit`（组件库）与 `contracts-mall` shim） |
+| `profiles/` | 创建期画像（`--profile` 加装计划；应用内不再消费，可忽略） |
 
 ## 模块开发（双端自注册闭环，逐行同构）
 
@@ -60,29 +49,95 @@ apps/client/src/cards/registry.ts             # 卡片注册表快照（CardType
 apps/server/src/index.ts                      # 服务端入口（HTTP + WS + Vite middleware + createServerContext + createEngineFromContext）
 apps/server/src/modules.ts                    # 服务端模块装配（registerAll）
 apps/server/src/module-ports.ts               # 模块 ports 动态装配（LinkedPanel/bumpin 数据源；契约派生 + 漂移守卫）
-packages/app-sdk/src/server/chat-engine.ts    # ChatEngine 工厂
-packages/app-sdk/src/server/context.ts        # ServerContext（注册表聚合 + createServerContext）
-packages/app-sdk/src/server/build-engine.ts   # createEngineFromContext / createSdkToolRuntime（出卡 capture 在 engine 构造期包装，见 tool-cards.ts）
-packages/app-sdk/src/client/chat-store.ts     # ChatStore 工厂
-packages/contracts/src/                       # 跨端类型契约
+packages/provider-custom/src/server/index.ts  # 自定义 API adapter 实施落点（步骤见该包 AGENTS.md）
 config/                                       # chat/model/plugin 配置
 ```
 
-## 常用命令
+## 运行与验证（平台沙箱）
+
+应用构建与运行在平台沙箱中，启动/停止/重启由平台负责——不要运行 `pnpm dev`、`pnpm start`
+等长驻进程命令（沙箱规则 `config/rules/no-persistent-process.md`）；`scripts/` 下生命周期
+脚本（prepare/dev/start/stop/build）同样由平台调用。你只改代码与配置，用一次性命令验证：
 
 ```sh
-pnpm install
-pnpm dev              # 单进程 localhost:8000（API + WS + 页面 + HMR）
+pnpm install                     # 会话开始时 node_modules 缺失先装
 pnpm typecheck
 pnpm test
 pnpm build
-pnpm verify           # typecheck + test + build + verify:generated
-pnpm verify:generated # 装配一致 + 锚点完整 + 无裸露 import
-pnpm plugin:doctor
+pnpm verify                      # typecheck + test + lint + build + verify:generated + check:inspector
+pnpm verify:generated            # 装配一致 + 锚点完整 + 无裸露 import
+pnpm plugin:doctor               # 插件排障
 pnpm plugin:inspect <pluginId> <toolId>
 ```
 
-starter 文档：`tbox-app starter --type agent-mall`；可用类型：`tbox-app starter --list`。在沙箱中使用 `tbox-app create . --name <app-name> --source @tbox.cn/app-template-agent --profile mall` 原地初始化（缺省不带 --profile = 空装配 chat 形态），应用模板的 `AGENTS.md` 会覆盖 starter seed。模块安装/装配由 `tbox-app` CLI（`@tbox.cn/app-cli`）管理：`new <module|provider|theme> <name>`（应用内脚手架）/ `module add --mode local|codegen|sdk --source <路径|tgz|registry包> / remove / list / sync / diff / doctor / update / publish`。add/remove/sync 后需 `pnpm install`。未安装 CLI 时：`pnpm add -g @tbox.cn/app-cli`（registry 安装）。
+环境变量与配置面（`config/`）见 `ENV.md`。
+
+## tbox-app CLI（模块与装配管理）
+
+CLI 免安装，命令均经 `npx --yes @tbox.cn/app-cli <cmd>` 运行（下表简写 `tbox-app`；完整
+命令面 `tbox-app --help`）。add/remove/sync 后需 `pnpm install`：
+
+| 命令 | 用途 |
+|---|---|
+| `module add <pkg> --mode codegen --source <pkg\|路径\|tgz>` | 安装模块（codegen 展开 / local 本地目录 / sdk registry 安装） |
+| `module remove <id>` | 卸载模块（见「删除模块」） |
+| `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，含内联声明） |
+| `theme use <id>` / `theme list` | 主题接线 / 状态 |
+| `starter --list` / `starter --type <type>` | starter 文档查询（商圈模块清单见 `--type agent-mall`） |
+
+## 自定义服务集成（provider-custom）
+
+自定义 API = 服务的真实后端由你自己对接：声明住在 `config/integrations.json`，adapter
+代码住在 `packages/provider-custom/`。服务后端三选一：Mock（演示数据，装 provider-mock
+即用）/ 自定义 API（你自己的后端接口——本节流程）/ 服务商集成（官方 provider 包，
+`module add` + `provider bind`）。收到「为某服务/模块/应用接入自定义 API」（或「对接
+我的 API」等同义说法）的请求时按四步走：
+
+1. **说明并收集信息**：目标不在已装模块服务槽词汇内 → 说明未装该模块，引导
+   `module add` 或 `new module`，不进入后续步骤。在词汇内 → 简要说明目标——服务 = 槽
+   展示名与描述 + Port 能力（消费模块 `src/server/ports.ts`（或 `ports/` 目录）或
+   `@app/contracts-mall`）；模块 = `tbox.module.json` `declare.owns` 清单逐个一句
+   （`*.snapshot` 聚合槽在清单内，数据随底层服务派生——落声明时跳过）；应用 = 已装业务模块服务清单概览
+   （空装配 chat 形态无业务服务，不适用）。再向用户收集：API 地址、认证方式（密钥值经
+   平台凭据引用，不进 prompt/代码/配置明文）、可选连接参数。用户已给出的不重复问。
+   未实施前调用报 `PROVIDER_NOT_IMPLEMENTED` 属预期中间态。
+2. **落声明**：目标槽已有内联声明则跳过；否则直接编辑 `config/integrations.json`
+   （CLI provider 命令仅支持字符串厂商）按下表范围写入槽级声明（`{ provider,
+   credentialType, configSchema? }` + implementation 字面量，仅槽级合法；provider 名自定
+   语义化短标识，同一后端的多服务共用同一 provider 名——单键注册，见
+   `packages/provider-custom/AGENTS.md`；凭据接线见同文件）：
+
+   | 维度 | 声明范围 | 共享连接参数落点 |
+   |---|---|---|
+   | 指定服务 | `services.<slot>` 单槽 | 槽/实例级 `config` |
+   | 指定模块 | 模块 `declare.owns` 全部服务槽（snapshot 除外） | `modules[<install id>].config` |
+   | 应用 | 已装业务模块 owns 并集（空装配不适用） | root `config` |
+
+3. **实施 adapter**：按 `packages/provider-custom/AGENTS.md` 实施（注册键 implementation
+   段 = `'inline'`）。
+4. **验收**：`pnpm typecheck && pnpm build` 通过 + `npx --yes @tbox.cn/app-cli module
+   doctor`；平台重启后该服务的调用不再报 `PROVIDER_NOT_IMPLEMENTED`（resolveService
+   惰性——调用时观测；doctor 对通配槽凭据不设防，运行时判据为最终裁判）。
+
+## 删除模块
+
+模块装卸一律走 CLI——不要手动删 `packages/<id>` 目录或改装配锚点区：
+
+```sh
+npx --yes @tbox.cn/app-cli module list      # 确认模块 id（= packages/ 目录名）
+npx --yes @tbox.cn/app-cli module remove <id>
+pnpm install
+```
+
+- `remove` 自动完成：删包（或恢复 `contracts-mall` SDK shim）+ 清锚点装配 + 清理集成绑定
+  死项 + doctor 复查。
+- 被其他模块 required 依赖时会阻止并列出依赖方：先删依赖方；`--force` 仅确认知情时使用。
+- 删除后跑 `pnpm typecheck`：`CardType` 随装配自动收缩，残留消费方会编译报错——按报错
+  清理引用后 `pnpm verify` 收尾。
+- 提示「contracts-mall 已无依赖者」时可再 `module remove contracts-mall` 恢复 SDK shim。
 
 ## 平台基础设施
 
@@ -96,17 +151,17 @@ starter 文档：`tbox-app starter --type agent-mall`；可用类型：`tbox-app
 
 ## 双运行时与插件
 
-- 原生能力统一走 `@tbox.cn/app-sdk/client` 的 `createPlatformAdapters()`（ASR/TTS/upload/feedback；007 下沉）；业务/UI 不直接判断支付宝壳。
-- API/WS 地址由 `@tbox.cn/app-sdk/client` 的 `configureRuntime({ apiBaseUrl })` 注入（`main.tsx`），不得硬编码 host；不直接读 `import.meta.env` 之外的环境（H1）。
+- 原生能力统一走 `@tbox.cn/app-sdk/client` 的 `createPlatformAdapters()`（ASR/TTS/upload/feedback）；业务/UI 不直接判断支付宝壳。
+- API/WS 地址由 `@tbox.cn/app-sdk/client` 的 `configureRuntime({ apiBaseUrl })` 注入（`main.tsx`），不得硬编码 host；不直接读 `import.meta.env` 之外的环境。
 - **不直接 import `@tbox-dev-js/sdk`（全禁）**——平台能力（auth/会话/TTS/LLM/插件/能力适配器/协议客户端）一律经 `@tbox.cn/app-sdk` 公开 API。
 - 平台"插件"页添加插件时只改 `config/plugins.json`。应用代码不复制插件鉴权、参数注入、runtime ID 或 SDK 客户端。
-- 插件结果出卡时按 `packages/contracts/src/cards.ts` 注册 schema，在模块包内注册 adapter 和 client 组件。
+- 插件结果出卡时按 `@tbox.cn/app-contracts` 的 cards schema 注册，在模块包内注册 adapter 和 client 组件。
 
-## web-view 样式约定（014，POC 沉淀）
+## web-view 样式约定
 
 客户端同时跑浏览器与支付宝小程序 web-view 壳（组件挂载于 H5 视口，非小程序原生渲染），样式遵守：
 
-0. **视觉体系 = mall-vis 蓝系**（视觉真源：仓库 `docs/reference/templates.md`——换肤面四级级联/域色矩阵 member 金 · parking 藏蓝 · sg 蓝 · promotion 红/UI 模式）；视觉值只住 kit tokens / 模块域变量块 / 素材变量消费三层（品牌视觉经主题包覆写——出厂接线 `@tbox.cn/app-theme-tbox` 三行，见 `apps/client/src/main.tsx`），平台 token 名字零增减。
+0. **视觉体系 = mall-vis 蓝系**（换肤面四级级联；域色矩阵 member 金 · parking 藏蓝 · sg 蓝 · promotion 红/UI 模式）；视觉值只住 kit tokens / 模块域变量块 / 素材变量消费三层（品牌视觉经主题包覆写——出厂接线 `@tbox.cn/app-theme-tbox` 三行，见 `apps/client/src/main.tsx`），平台 token 名字零增减。
 1. **长度单位 PX 大写**（如 `800PX`）——web-view 内联字体放大：小写 `px` 被浏览器 rem 缩放改写，大写跳过改写保持视觉尺寸。
 2. **flex 子项设 `flex-shrink: 0`**——壳内内容宽度不定，防元素被压缩变形。
 3. **滚动容器隐藏滚动条**（`::-webkit-scrollbar { display: none }`）——web-view 无原生滚动条，出现即破相。
@@ -115,6 +170,6 @@ starter 文档：`tbox-app starter --type agent-mall`；可用类型：`tbox-app
 ## 工程边界（check-workspace 校验）
 
 - `packages/*` 业务包必须有 `tbox.module.json`；SDK/契约（`app-sdk` / `contracts*` / `shared`）豁免。
-- `scripts/` 下所有文件保持可执行位（git 100755；CLI create 后 chmod 兜底）；双模板 scripts 文件集合镜像全等（guard-workspace R4）。
+- `scripts/` 下所有文件保持可执行位（git 100755；CLI create 后 chmod 兜底）。
 - 装配文件不得裸 import（全部 import 行在锚区内）；模块包不得 import SDK/契约内部路径（仅公开入口 `@tbox.cn/app-sdk{/server,/client,/platform}` 与 `@tbox.cn/app-contracts`）。
-- 构建序列单源 = 根 `build` / `build:client` script（守卫经 `check` 组合注入）；`build.sh` 只管环境 + install + 委托——新守卫改 `check` 组合，不改 build.sh；零依赖守卫恒可 install 前（`check:workspace` 已占此位）。
+- 构建序列单源 = 根 `build` / `build:client` script；`scripts/build.sh` 只管环境 + install + 委托（平台调用）。

package/ENV.md

@@ -23,8 +23,9 @@
     无 `instances` 键 = 无参考表（动态形态）；env 未注入 → 占位 fail-fast 显性暴露。
 - 注入形态：mallId-only（miniAppId 尽力回填——root config `miniAppId` 优先、参考表
   attributes 兜底；双缺仍注入，不阻断默认商圈）。URL 显式参数 `?mallId=` 优先级更高。
-- 本地 mock 链：`tbox-app module add` 装 provider-mock → 生成器派生零拓扑 integrations.json →
-  裸跑免 mallId 全局会话或任意 `?mallId=` 均可演示。零拓扑形态下 provider-mock 于 register 期
+- 本地 mock 链：`tbox-app module add` 装 provider-mock（0.5.0 极简零配置——开箱免集成配置；
+  动态配置验证面 → provider-mocktest，内部档 `pnpm dev mall-mocktest`）→ 生成器派生零拓扑
+  integrations.json → 裸跑免 mallId 全局会话或任意 `?mallId=` 均可演示。零拓扑形态下 provider-mock 于 register 期
   声明隐式默认单实例（mall-demo / 星河 Mock 小镇）——无 URL 参数访问时默认商圈回显照常生效
   （显式 instances/defaultInstanceId 恒赢，声明仅兜底）。
 
@@ -58,7 +59,7 @@ dev/src 与 prod/dist bundle 形态恒等）：
   provider+implementation 从最特异层整组继承（instance > slot > domain > root），组内
   implementation 缺席经 catalog 派生；部署拓扑 = 顶层 `instances` 注册表 + `defaultInstanceId`；
   槽 `instances` 键缺席 = 通配激活）。模板不内置——`tbox-app module add` 装入 local 供给
-  （provider-mock）时由 CLI mock 绑定生成器自动派生零拓扑形态（root.provider + 全 local 槽
+  （provider-mock / provider-mocktest——local 供给双包同语义）时由 CLI mock 绑定生成器自动派生零拓扑形态（root.provider + 全 local 槽
   空对象）；真厂商绑定经 `tbox-app provider use/bind` 或 `--config-dir` 真实素材注入。
 - `config/integrations.json` 顶层 `modules` 节：模块资源绑定（键 = 模块 install id，如
   `module-customer-service`；`resources.<resourceId> = { type: 'knowledge', datasetId | ref, topK?, scoreThreshold? }`）。
@@ -188,7 +189,7 @@ export MALL_HOME_DEV_SERVICES=true
 
 # tbox-app dev 配置面
 
-- `TBOX_CONFIG_DIR`：dev 命令注入的配置目录覆盖（real-env 档位绝对路径）；未设时使用默认 `config/`。
+- `TBOX_CONFIG_DIR`：dev 命令注入的配置目录覆盖（preset `configDir` / `--config-dir` 旗标显式指定的目录绝对路径——config 恒显式）；未设时使用默认 `config/`。
   覆盖面含 `llm_provider.json`（`modelName`/`thinking`）：注入时 LLM 装配读档位目录文件，
   其 `modelName` 优先于 `APP_AI_MODEL_NAME`；档目录缺该文件 → 链式回退 env（config-dir 独占
   注入语义：缺文件 = 显式不指定，不落回模板默认 config）。

package/README.md

@@ -43,7 +43,8 @@ tbox-app module doctor               # 26 条结构校验
 
 ```text
 template-agent/
-  profiles/                  模板画像（mall.json 加装计划 + config 叠加；create --profile 消费）
+  profiles/                  模板画像（mall.json 加装计划 + config 叠加 + rootFiles 根文件 TEMPLATE.md；
+                                create --profile 消费——根文件落地应用根）
   apps/
     client/                    React/Vite 装配端（业务页面/组件/hooks/样式；平台能力经 @tbox.cn/app-sdk/client）
     server/                    Express + WS 装配端（~120 行装配：auth 中间件 + 模块挂载 + 平台路由面/TTS/WS）

package/apps/client/package.json

@@ -11,7 +11,6 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@tbox.cn/app-sdk": "catalog:",
     "@tbox.cn/app-contracts": "catalog:",
     "@tbox.cn/app-theme-tbox": "catalog:",
     "react": "catalog:",
@@ -19,7 +18,8 @@
     "zustand": "catalog:",
     "@app/provider-custom": "workspace:*",
     "@app/agent-ui-kit": "workspace:*",
-    "@app/contracts-mall": "workspace:*"
+    "@app/contracts-mall": "workspace:*",
+    "@tbox.cn/app-agent-sdk-client": "catalog:"
   },
   "devDependencies": {
     "@types/node": "catalog:",

package/apps/client/src/app.tsx

@@ -11,7 +11,7 @@ const CARD_PREVIEW_PATH = '/_tbox/card-preview';
 const DevCardPreview = import.meta.env.DEV
   ? lazy(async () => {
       const [{ CardPreviewPage }, { CARD_REGISTRY }, { authClient }] = await Promise.all([
-        import('@tbox.cn/app-sdk/client/card-preview'),
+        import('@tbox.cn/app-agent-sdk-client/client/card-preview'),
         import('@/cards/registry'),
         import('@/platform/agent-runtime'),
       ]);

package/apps/client/src/cards/registry.ts

@@ -11,7 +11,7 @@
  * - CLIENT_SLOTS = 槽注册表（home 槽由模块注册）。
  */
 import type { CardComponent, TboxCardPayload } from '@tbox.cn/app-contracts';
-import { createClientContext } from '@tbox.cn/app-sdk/client';
+import { createClientContext } from '@tbox.cn/app-agent-sdk-client';
 import { registerAll, type CardType } from '../modules';
 
 /** 组装端单例：注册全部模块客户端能力（模块加载期执行一次；注册幂等告警） */

package/apps/client/src/main.tsx

@@ -1,6 +1,6 @@
 import { StrictMode } from 'react';
 import { createRoot } from 'react-dom/client';
-import { configureRuntime, createLogger, installGlobalErrorReporting } from '@tbox.cn/app-sdk/client';
+import { configureRuntime, createLogger, installGlobalErrorReporting } from '@tbox.cn/app-agent-sdk-client';
 import App from './app';
 import { configureChatConfigDefaults } from '@app/agent-ui-kit';
 import '@app/agent-ui-kit/theme/global.less';

package/apps/client/src/modules.ts

@@ -5,7 +5,7 @@
  * 锚点区：@tbox:imports-begin/end（模块 import 行）+ @tbox:register-begin/end（模块数组）
  * CLI 行为：增量插入/删除模块行，保留非标行。
  */
-import type { ClientContext, InferModuleCards } from '@tbox.cn/app-sdk/client';
+import type { ClientContext, InferModuleCards } from '@tbox.cn/app-agent-sdk-client';
 
 // @tbox:imports-begin
 // 其余能力经 `tbox-app module add` 扩展（shopping-guide/member 等商圈模块；mall-home 经 profiles/mall）

package/apps/client/src/platform/AgentChatApp.tsx

@@ -1,9 +1,9 @@
-import { createLogger } from '@tbox.cn/app-sdk/client';
+import { createLogger } from '@tbox.cn/app-agent-sdk-client';
 
 const appLogger = createLogger('AgentChatApp');
 
 import { useCallback, useEffect, useMemo, useState } from 'react';
-import { AdapterProvider, createPlatformAdapters, type AdapterContextValue } from '@tbox.cn/app-sdk/client';
+import { AdapterProvider, createPlatformAdapters, type AdapterContextValue } from '@tbox.cn/app-agent-sdk-client';
 import type { TboxSessionData } from '@tbox.cn/app-contracts';
 import IndexPage from '@/pages/index/index';
 import { authClient, platformApi } from './agent-runtime';

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

@@ -1,9 +1,9 @@
 /**
- * 平台运行时装配（client 平台轴，已下沉 @tbox.cn/app-sdk/client）。
+ * 平台运行时装配（client 平台轴，已下沉 @tbox.cn/app-agent-sdk-client）。
  * 模板唯一的 SDK 单例持有点：authClient（鉴权）+ platformApi（能力凭证/会话/历史）。
  * 环境值（VITE_API_URL / VITE_AUTH_PROVIDER）由 main.tsx 经 configureRuntime / 选项注入（H1）。
  */
-import { createAuthClient, createPlatformApi } from '@tbox.cn/app-sdk/client';
+import { createAuthClient, createPlatformApi } from '@tbox.cn/app-agent-sdk-client';
 // 读源归位 TIER1（W1-①）：mall-scope-url 契约助手（search-only 语义；壳 URL 改写层契约见包注释）
 import { readMallIdFromUrl } from '@app/contracts-mall';
 

package/apps/client/src/store/chat.ts

@@ -10,8 +10,8 @@ import {
   getLocation,
   configureHelloContext,
   subscribeSessionUpgradeDrain,
-} from '@tbox.cn/app-sdk/client';
-import type { CoreChatState } from '@tbox.cn/app-sdk/client';
+} from '@tbox.cn/app-agent-sdk-client';
+import type { CoreChatState } from '@tbox.cn/app-agent-sdk-client';
 import { toast } from '@app/agent-ui-kit';
 import { readMallIdFromUrl, readMiniAppIdFromUrl } from '@app/contracts-mall';
 import { authClient, platformApi } from '@/platform/agent-runtime';

package/apps/client/vite.config.ts

@@ -7,7 +7,7 @@ import { resolve } from 'node:path';
 import { pathToFileURL } from 'node:url';
 // 平台微调配套 babel plugin（随 @tbox.cn/app-sdk 分发）：给每个 JSX 注入 data-code-inspect-*
 // 源码位置属性，供 inspector runtime(/__vs_inspector__.js) 点选元素→定位源码。仅 dev 启用（见下）。
-import codeInspectPlugin from '@tbox.cn/app-sdk/platform/code-inspect';
+import codeInspectPlugin from '@tbox.cn/app-agent-sdk-client/platform/code-inspect';
 
 const pxToRemPlugin = pxToRem({
   rootValue: 100,
@@ -48,8 +48,6 @@ export default defineConfig(async ({ command }) => {
     resolve: {
       alias: {
         '@': resolve(__dirname, 'src'),
-        fs: resolve(__dirname, 'src/shims/node-stub.ts'),
-        path: resolve(__dirname, 'src/shims/node-stub.ts'),
       },
       // dev 域 React 单实例（G1/G2 防线）：双 dev 入口经本文件合并生效（middleware
       // dev 加载本文件且 command==='serve'）；build 恒不继承——产物位稳定性。

package/apps/server/package.json

@@ -12,13 +12,13 @@
   },
   "dependencies": {
     "@tbox.cn/agent-plugin": "catalog:",
-    "@tbox.cn/app-sdk": "catalog:",
     "@tbox.cn/app-contracts": "catalog:",
     "@app/contracts-mall": "workspace:*",
     "@tbox-dev-js/sdk": "catalog:",
     "express": "catalog:",
     "zod": "catalog:",
-    "@app/provider-custom": "workspace:*"
+    "@app/provider-custom": "workspace:*",
+    "@tbox.cn/app-agent-sdk-server": "catalog:"
   },
   "devDependencies": {
     "@types/express": "catalog:",

package/apps/server/src/app-tools.ts

@@ -1,4 +1,4 @@
-import type { ServerContext } from '@tbox.cn/app-sdk/server';
+import type { ServerContext } from '@tbox.cn/app-agent-sdk-server';
 import { translateTool } from './tools/translate.js';
 import { clockTool } from './tools/clock.js';
 

package/apps/server/src/app.ts

@@ -10,8 +10,8 @@ import path from 'path';
 import { existsSync } from 'node:fs';
 import { fileURLToPath } from 'url';
 import { registerAll } from './modules.js';
-// ===== 模板日志（@tbox.cn/app-sdk/server createLogger：本地时间 + LEVEL + [tag] + req/conv 尾缀） =====
-import { createLogger } from '@tbox.cn/app-sdk/server';
+// ===== 模板日志（@tbox.cn/app-agent-sdk-server createLogger：本地时间 + LEVEL + [tag] + req/conv 尾缀） =====
+import { createLogger } from '@tbox.cn/app-agent-sdk-server';
 const serverLogger = createLogger('server');
 const authLogger = createLogger('AUTH');
 const skillLogger = createLogger('SKILL');
@@ -24,6 +24,7 @@ import {
   createEngineFromContext,
   createIntegrationsRegistry,
   loadProviderCatalog,
+  buildOwnershipMap,
   tboxTraceExporter,
   extractImageUrls,
   TBOX_FILE_URL_PREFIX,
@@ -45,8 +46,8 @@ import {
   loadAgentPromptConfig,
   toWsChatConfig,
   installTboxDev,
-} from '@tbox.cn/app-sdk/server';
-import { installInspector } from '@tbox.cn/app-sdk/platform';
+} from '@tbox.cn/app-agent-sdk-server';
+import { installInspector } from '@tbox.cn/app-agent-sdk-server/platform';
 import { registerAppTools } from './app-tools.js';
 import { APP_PRE_TOOLS } from './pre-tools.js';
 import { INTENT_ROUTES, createAppIntentDispatcher } from './intent-routes.js';
@@ -65,7 +66,7 @@ import {
   createAuthStrategyRegistry,
   createEnvironmentSecretProvider,
   attachCardActionTokens,
-} from '@tbox.cn/app-sdk/server';
+} from '@tbox.cn/app-agent-sdk-server';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
@@ -114,7 +115,7 @@ const memory = {
 // 模板无条件透传——读取一次，改文件需重启生效）
 const AGENT_PROMPT = loadAgentPromptConfig(CONFIG_DIR);
 
-// 平台能力装配（003/006 平台轴，已下沉 @tbox.cn/app-sdk/server）
+// 平台能力装配（003/006 平台轴，已下沉 @tbox.cn/app-agent-sdk-server）
 // 011 L1 + F2/F3 + W3-1：装配序 integrations → authStrategies → auth → catalog → ctx——
 // v4：部署拓扑并入 integrations.json（单文件真源）；域投影/校验（deployment 语义）迁
 // module-mall-core（ctx.domainAssemblies 惰性查表——auth 构造先于装配，动态判定经闭包后补）。
@@ -155,6 +156,10 @@ function appRoot(): string {
 
 const providerCatalog = loadProviderCatalog(appRoot());
 
+// integrations v6 所有权模型：服务归属表（service → moduleId，declare.owns 聚合单源）——
+// modules[owner] 级绑定/配置求值的显式注入参（缺注入 + 文件含 modules 绑定 → fail-visible）
+const ownershipMap = buildOwnershipMap(appRoot());
+
 // provider 拆包 F2/F3：integrations 槽位解析轴（config/integrations.json 存在即生效；
 // 缺席 → undefined，模块槽解析与换码链 fail-fast 显性暴露——旧 ProviderRegistry 链已拆除）
 // instanceIdOf 注入 mall 语义（W3-1：沿域装配查表——mallId 派生归 module-mall-core）
@@ -163,6 +168,8 @@ const integrations = integrationsConfig
       integrations: integrationsConfig.config,
       // catalog 真源 = 应用根 .tbox/app.json（上方无条件装载）
       catalog: providerCatalog,
+      // v6：归属表显式参（装配五行 → 六行）
+      ownerOf: ownershipMap,
       authStrategies,
       secretProvider: createEnvironmentSecretProvider({
         source: process.env as Record<string, string | undefined>,

package/apps/server/src/cli/collect-registry.ts

@@ -1,4 +1,4 @@
-import { createServerContext } from '@tbox.cn/app-sdk/server';
+import { createServerContext } from '@tbox.cn/app-agent-sdk-server';
 import type { ToolCardBinding } from '@tbox.cn/agent-plugin/cards';
 import { registerAll } from '../modules.js';
 import { registerAppTools } from '../app-tools.js';

package/apps/server/src/cli/plugin-doctor.ts

@@ -3,7 +3,7 @@ import {
   type PluginDiagnostic,
 } from '@tbox.cn/agent-plugin/doctor';
 import { loadMastraPluginTools } from '@tbox.cn/agent-plugin/mastra';
-import { createPluginIntegration } from '@tbox.cn/app-sdk/server';
+import { createPluginIntegration } from '@tbox.cn/app-agent-sdk-server';
 
 import { collectRegistryState } from './collect-registry.js';
 

package/apps/server/src/cli/plugin-inspect.ts

@@ -2,7 +2,7 @@ import { inspectPluginTool } from '@tbox.cn/agent-plugin/inspect';
 // 豁免：CLI 诊断工具（plugin:inspect）直接调 @tbox-dev-js/sdk 的 TboxPluginClient 做运行时检查，
 // 非应用运行时平台能力路径（007 铁律针对平台能力调用；诊断工具保持直连）
 import { TboxPluginClient } from '@tbox-dev-js/sdk';
-import { createPluginIntegration } from '@tbox.cn/app-sdk/server';
+import { createPluginIntegration } from '@tbox.cn/app-agent-sdk-server';
 
 import { collectRegistryState } from './collect-registry.js';
 

package/apps/server/src/config/integration.ts

@@ -14,7 +14,7 @@
 import { existsSync, readFileSync } from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { expandEnvVars, parseIntegrationsConfig } from '@tbox.cn/app-sdk/server';
+import { expandEnvVars, parseIntegrationsConfig } from '@tbox.cn/app-agent-sdk-server';
 import type { IntegrationsConfig } from '@tbox.cn/app-contracts';
 
 // 默认路径 = 应用根 config/integrations.json。双态锚点探测（bundle 打平后 import.meta.url 层级漂移）：

package/apps/server/src/dev.ts

@@ -8,8 +8,8 @@ import path from 'path';
 import { readFile } from 'node:fs/promises';
 import { fileURLToPath } from 'url';
 import { createServer as createViteServer } from 'vite';
-import { injectScript, isReady } from '@tbox.cn/app-sdk/platform';
-import { createLogger } from '@tbox.cn/app-sdk/server';
+import { injectScript, isReady } from '@tbox.cn/app-agent-sdk-server/platform';
+import { createLogger } from '@tbox.cn/app-agent-sdk-server';
 import { app, registerUpgradeDelegate, start } from './app.js';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));

package/apps/server/src/index.ts

@@ -7,7 +7,7 @@ import path from 'path';
 import { existsSync } from 'node:fs';
 import { fileURLToPath } from 'url';
 import express from 'express';
-import { createLogger } from '@tbox.cn/app-sdk/server';
+import { createLogger } from '@tbox.cn/app-agent-sdk-server';
 import { app, start } from './app.js';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));

package/apps/server/src/intent-routes.ts

@@ -1,4 +1,4 @@
-import type { IntentRoute, HandlerResult, ServerContext } from '@tbox.cn/app-sdk/server';
+import type { IntentRoute, HandlerResult, ServerContext } from '@tbox.cn/app-agent-sdk-server';
 
 /**
  * 业务意图表（B21：intent-framework hybrid 接线——SDK 框架 + 源码意图表，003 §3.3）。

package/apps/server/src/modules.ts

@@ -5,11 +5,11 @@
  * 锚点区：@tbox:imports-begin/end（模块 import 行）+ @tbox:register-begin/end（模块数组）
  * CLI 行为：增量插入/删除模块行，保留非标行。
  */
-import type { ServerContext, InferModuleCards } from '@tbox.cn/app-sdk/server';
+import type { ServerContext, InferModuleCards } from '@tbox.cn/app-agent-sdk-server';
 
 // @tbox:imports-begin
 // SDK 装配框架（非模块行，CLI 增量维护保留非标行）
-import { registerServerModules } from '@tbox.cn/app-sdk/server';
+import { registerServerModules } from '@tbox.cn/app-agent-sdk-server';
 import { serverModule as providerCustom } from '@app/provider-custom/server';
 // @tbox:imports-end
 

package/apps/server/src/pre-tools.ts

@@ -1,5 +1,5 @@
-// 铁律：不直接 import @mastra/core，经 @tbox.cn/app-sdk/server 的 definePreTool 入口（单例铁律）
-import { definePreTool } from '@tbox.cn/app-sdk/server';
+// 铁律：不直接 import @mastra/core，经 @tbox.cn/app-agent-sdk-server 的 definePreTool 入口（单例铁律）
+import { definePreTool } from '@tbox.cn/app-agent-sdk-server';
 import { clockTool } from './tools/clock.js';
 
 /**

package/apps/server/src/tools/clock.ts

@@ -1,5 +1,5 @@
-// 铁律：不直接 import @mastra/core，经 @tbox.cn/app-sdk/server 的 createTool 入口（单例铁律）
-import { createTool } from '@tbox.cn/app-sdk/server';
+// 铁律：不直接 import @mastra/core，经 @tbox.cn/app-agent-sdk-server 的 createTool 入口（单例铁律）
+import { createTool } from '@tbox.cn/app-agent-sdk-server';
 import { z } from 'zod';
 
 /**

package/apps/server/src/tools/translate.ts

@@ -1,5 +1,5 @@
-// 铁律：不直接 import @mastra/core，经 @tbox.cn/app-sdk/server 的 createTool 入口（单例铁律）
-import { createTool } from '@tbox.cn/app-sdk/server';
+// 铁律：不直接 import @mastra/core，经 @tbox.cn/app-agent-sdk-server 的 createTool 入口（单例铁律）
+import { createTool } from '@tbox.cn/app-agent-sdk-server';
 import { z } from 'zod';
 
 /**

package/apps/server/tests/agent-prompt.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { loadAgentPromptConfig } from '@tbox.cn/app-sdk/server';
+import { loadAgentPromptConfig } from '@tbox.cn/app-agent-sdk-server';
 import { existsSync } from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';

package/apps/server/tests/cards-registry.test.ts

@@ -3,7 +3,7 @@
 // cards 字段运行期声明，registry 仅余 cardType 注册与 dataSchema 校验职责。
 import { describe, it, expect } from 'vitest';
 import { diagnosePlugins } from '@tbox.cn/agent-plugin/doctor';
-import { createServerContext, createPluginIntegration } from '@tbox.cn/app-sdk/server';
+import { createServerContext, createPluginIntegration } from '@tbox.cn/app-agent-sdk-server';
 import { registerAll } from '../src/modules.js';
 
 describe('工具 / 卡片 registry 一致性（自注册闭环）', () => {

package/apps/server/tests/intent-dispatcher.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { createServerContext } from '@tbox.cn/app-sdk/server';
+import { createServerContext } from '@tbox.cn/app-agent-sdk-server';
 import type { RequestContext } from '@tbox.cn/app-contracts';
 import { createAppIntentDispatcher } from '../src/intent-routes.js';
 

package/apps/server/tests/tool-runtime.test.ts

@@ -5,7 +5,7 @@ import {
   createEngineFromContext,
   createInMemoryMemoryStore,
   resolveMemoryStore,
-} from '@tbox.cn/app-sdk/server';
+} from '@tbox.cn/app-agent-sdk-server';
 import { registerAll } from '../src/modules.js';
 import { translateTool } from '../src/tools/translate.js';
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tbox.cn/app-template-agent",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "tbox AI Agent 全栈模板（多包 pnpm workspace）：apps/client + apps/server。唯一模板（W4 单一模板统一化：缺省空装配 chat 形态；mall 能力经 profiles/mall 加装），能力经 tbox-app module add 模块扩展（shopping-guide/member 等）。",
   "engines": {
     "node": ">=24.0.0 <25.0.0"
@@ -32,11 +32,11 @@
     "LICENSE"
   ],
   "devDependencies": {
-    "@tbox.cn/app-sdk": "0.20.0",
     "eslint": "9.39.5",
     "typescript-eslint": "8.67.0",
     "eslint-plugin-react-hooks": "5.2.0",
-    "vite": "6.4.3"
+    "vite": "6.4.3",
+    "@tbox.cn/app-sdk-server": "0.21.0"
   },
   "license": "MIT",
   "publishConfig": {

package/packages/agent-ui-kit/package.json

@@ -27,13 +27,13 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@tbox.cn/app-sdk": "catalog:",
     "@tbox.cn/app-contracts": "catalog:",
     "@phosphor-icons/react": "catalog:",
     "antd-mobile": "catalog:",
     "react-markdown": "catalog:",
     "remark-gfm": "catalog:",
-    "zustand": "catalog:"
+    "zustand": "catalog:",
+    "@tbox.cn/app-agent-sdk-client": "catalog:"
   },
   "peerDependencies": {
     "react": "catalog:",