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

package/apps/server/src/app.ts

@@ -4,15 +4,14 @@
  * import 本模块即完成装配（与旧单文件入口时序等价：listen 仍在 start() 内最后发生）。
  */
 import express from 'express';
-import cors from 'cors';
 import { createServer, type IncomingMessage } from 'http';
 import type { Duplex } from 'node:stream';
 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');
@@ -25,6 +24,7 @@ import {
   createEngineFromContext,
   createIntegrationsRegistry,
   loadProviderCatalog,
+  buildOwnershipMap,
   tboxTraceExporter,
   extractImageUrls,
   TBOX_FILE_URL_PREFIX,
@@ -46,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';
@@ -66,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));
 
@@ -115,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 构造先于装配，动态判定经闭包后补）。
@@ -136,7 +136,7 @@ function mallAssembly(): MallScopeAssembly | undefined {
 }
 
 // 上下文统一化 Stage 2：validateContext 域校验注入（HTTP body.context 伪冒防线：
-// mallId 形状校验（v4 恒动态）→ 403；只在全局面生效——login/dev-login 走 login-routes 独立归一化）。
+// mallId 形状校验（v4 恒动态）→ 403；只在全局面生效——login 走 login-routes 独立归一化）。
 // 与 WS validateScope 同核（isValidMallShape）；无装配 → true（非 mall 部署放行）。
 const auth = createAuthRuntime(undefined, {
   validateContext: (attributes) => mallAssembly()?.validateScope(attributes) ?? true,
@@ -156,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）
@@ -164,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>,
@@ -207,16 +213,46 @@ process.on('uncaughtException', (err) => {
 });
 
 export const app = express();
-app.use(cors());
+
+// ===== CORS allowlist（统一登录改造 T20：全开 cors() 退役） =====
+// 双轴分离：iframe 嵌入走 CSP frame-ancestors（下方中间件），跨源 fetch 走本 allowlist。
+// 三元组与 frame-ancestors 对齐（用户裁决 2026-09-13）；credentials 恒 false（token 走
+// Authorization 头，不依赖 cookie——跨源带凭据面直接关死）。
+// 生成应用可编辑此常量（长尾 origin 逃生通道）——刻意不加 env（决策权归部署面代码）。
+const CORS_ALLOWED_ORIGINS = ['https://tbox.cn', 'https://*.tbox.cn', 'http://localhost:3000'];
+function originAllowed(origin: string): boolean {
+  return CORS_ALLOWED_ORIGINS.some((pattern) =>
+    pattern.includes('*')
+      ? origin.endsWith(pattern.slice(pattern.indexOf('*') + 1))
+      : origin === pattern,
+  );
+}
+app.use((req, res, next) => {
+  const origin = req.headers.origin;
+  if (typeof origin === 'string' && originAllowed(origin)) {
+    res.setHeader('Access-Control-Allow-Origin', origin);
+    res.setHeader('Vary', 'Origin');
+  }
+  res.setHeader('Access-Control-Allow-Methods', 'GET,POST,DELETE,OPTIONS');
+  res.setHeader('Access-Control-Allow-Headers', 'Authorization,Content-Type,X-Request-ID');
+  res.setHeader('Access-Control-Allow-Credentials', 'false');
+  if (req.method === 'OPTIONS') {
+    res.sendStatus(204);
+    return;
+  }
+  next();
+});
+
 app.use(express.json());
 
 // 🔒 平台基础设施 — 禁止 AI 删除或修改（@infrastructure-locked）
 installInspector(app);
 
-// 非 prod 默认开启 dev-login：对暴露公网的实例给出可见警示（生产必须 NODE_ENV=production）
-if (auth.config.devLoginEnabled) {
+// 浏览器登录形态提示：非 prod 裸跑（无 mall 控制面）默认开放 guest 登录（内置换码器
+// allowsGuestLogin 声明）；公网实例应以 NODE_ENV=production + 换码器档位收敛（browserLoginMode: off）
+if (!isProduction) {
   authLogger.warn(
-    'dev-login 已开启（非 production 默认）。若本实例暴露公网，请设 NODE_ENV=production 或 AUTH_DEV_LOGIN_DISABLED=true。',
+    '浏览器登录（browser 轴）按换码器档位开放：裸跑/demo 默认 guest。若本实例暴露公网，请设 NODE_ENV=production 并在登录槽 config 收敛 browserLoginMode。',
   );
 }
 
@@ -237,7 +273,7 @@ const ctx = createServerContext({
 // 自动装配（W1-④：raw 派生 modules 资源节 + 源目录台账锚；无条件注册、与控制面正交，
 // 防无控制面启动静默丢失）。模板显式注册已拆（W3-1：装配默认兜底覆盖同语义）。
 
-// 全局 /api 鉴权（H2 挂载顺序契约）：除 public（login/dev-login/health）外一律要求 Bearer token；
+// 全局 /api 鉴权（H2 挂载顺序契约）：除 public（login/health）外一律要求 Bearer token；
 // optional 模式缺失 token → 匿名身份（写通道仍被 action gateway 拒绝）
 // ⚠️ 必须先于 /api/m、/api/action、createPlatformApiRouter 挂载，保证全 API 面受鉴权约束
 app.use('/api', auth.middleware);
@@ -396,9 +432,9 @@ export async function start() {
   // 默认商圈兜底/卡片动作授权/enhanceContext 全断——见 Agent Note 2026-09-17-mall-assembly-resolution-order）
   const assembly = mallAssembly();
 
-  // 011 S6：mall 装配 + 生产环境缺动作授权密钥 → 启动期提示（签发路径运行时兜底报错）
+  // 011 S6：mall 装配 + 生产环境缺动作授权密钥 → 启动期提示（≥32B TBOX_API_KEY 在场回退 apiKey 档；整链空装配期 fail-fast）
   if (assembly && isProduction && !process.env.ACTION_TOKEN_SECRET && !process.env.AUTH_TOKEN_SECRET) {
-    actionLogger.warn('生产环境未配置 ACTION_TOKEN_SECRET/AUTH_TOKEN_SECRET——卡片动作授权装配将 fail-fast 拒绝启动');
+    actionLogger.warn('生产环境未配置 ACTION_TOKEN_SECRET/AUTH_TOKEN_SECRET——TBOX_API_KEY(≥32B) 缺席时装配将 fail-fast 拒绝启动；在场则回退 apiKey 档（平台运维可伪 action token）');
   }
 
   // 011 F2/E2：mall 装配（条件）——scope 会话 + 动作授权先行（engine attacher 依赖）
@@ -456,6 +492,19 @@ export async function start() {
   const defaultContext = assembly?.defaultMallContext();
   const chatWss = createWsServer(engine, {
     auth: auth.wsAuth,
+    // 会话 β：会话建立服务（懒代理——TBOX_API_KEY 缺席时 NEW/RESUME 失败 notice，RUN 恒严格拒绝）
+    conversationService: {
+      createConversation: (agentId, userId) => {
+        const service = getConversationService();
+        if (!service) return Promise.reject(new Error('TBOX_API_KEY not configured'));
+        return service.createConversation(agentId, userId);
+      },
+      getOrCreateConversation: (agentId, userId) => {
+        const service = getConversationService();
+        if (!service) return Promise.reject(new Error('TBOX_API_KEY not configured'));
+        return service.getOrCreateConversation(agentId, userId);
+      },
+    },
     ...(scopeSessions
       ? {
           scopeSessions,
@@ -487,7 +536,7 @@ export async function start() {
     process.exit(1);
   });
 
-  httpServer.on('upgrade', (request, socket, head) => {
+  httpServer.on('upgrade', async (request, socket, head) => {
     socket.on('error', (e) => upgradeLogger.warn('socket error:', e.message));
     if (upgradeDelegate?.(request, socket, head)) return;
     const { pathname } = new URL(request.url || '/', 'http://localhost');
@@ -497,8 +546,27 @@ export async function start() {
         chatWss.emit('connection', ws, request);
       });
     } else if (pathname === '/ws/tts') {
-      // 通道门与 UI 同值同源（chat.json enableTTS 单源）：关态硬拒 upgrade，
-      // 防服务端开着 TTS 代理但 UI 已隐藏按钮的僵尸路径；destroy 于 handleUpgrade 之前
+      // 双层门 1（S5 修复，pre-101 鉴权）：token 校验先行——TTS 代理原为全开放面。
+      // 双形态载体（IP-2）：Node 客户端 = Authorization Bearer；浏览器 WebSocket 无法
+      // 自定义 header = ?token= query。无效/缺失 token 于 upgrade 前 destroy
+      // （对齐 Terminal channel 先例）。
+      const headerToken = (request.headers.authorization ?? '').replace(/^Bearer\s+/i, '');
+      const queryToken = new URL(request.url || '/', 'http://localhost').searchParams.get('token') ?? '';
+      const ttsToken = headerToken || queryToken;
+      if (!ttsToken) {
+        upgradeLogger.warn('TTS upgrade rejected: missing token');
+        socket.destroy();
+        return;
+      }
+      try {
+        await auth.tokenService.verify(ttsToken);
+      } catch {
+        upgradeLogger.warn('TTS upgrade rejected: invalid token');
+        socket.destroy();
+        return;
+      }
+      // 双层门 2（通道门与 UI 同值同源）：chat.json enableTTS 单源——关态硬拒 upgrade，
+      // 防服务端开着 TTS 代理但 UI 已隐藏按钮的僵尸路径
       if (!loadedChatConfig.enableTTS) {
         upgradeLogger.warn('TTS disabled (chat.json enableTTS:false) — /ws/tts upgrade rejected');
         socket.destroy();

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';
@@ -11,14 +11,14 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url));
  * W4 单一模板统一化双段语义：
  * - 缺省出厂 = 空装配（config/ 无 agent.jsonc）→ loader 走 SDK 默认兜底单行（chat 形态零域广告）；
  * - mall 画像 = profiles/mall/config/agent.jsonc（--profile mall 经 --config-dir 通道注入）——
- *   四章节/禁工具名/承接句/中立锚断言锚定画像资产文件（create 展开/verify-cli --mall 完整档消费）。
+ *   四章节/禁工具名/承接句/中立锚断言锚定画像资产文件（create 展开/stage mall 完整档消费）。
  *
  * 部署态让位（2026-09-10）：--config-dir 注入真实厂商档（integrations.json root provider 为
  * 真实厂商名而非 mock）时 agent.jsonc 为部署方品牌人设——中立锚仅守卫出厂/mock 态（mock 档
- * 不注入 agent.jsonc，保持出厂中立）。verify-cli --real-env 真实厂商档完整链依赖此让位。
+ * 不注入 agent.jsonc，保持出厂中立）。stage 真实厂商档完整链依赖此让位。
  *
  * 装配态感知（2026-09-17 评审修复）：第一段的 config/ 状态在生成应用是装配变量——mall 完整档
- * 素材注入、support 自含 config（出厂在场）均使 agent.jsonc 在场，恒常量断言失配（verify-cli
+ * 素材注入、support 自含 config（出厂在场）均使 agent.jsonc 在场，恒常量断言失配（stage
  * 完整档 94/95 缺口）。用例改为形态感知：缺席 → 兜底断言（出厂守卫保持）；在场 → 读文件断言。
  */
 describe('agent.jsonc（兜底语义：空装配 → SDK 默认单行；装配态注入 → 读文件）', () => {

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';
 
@@ -18,7 +18,7 @@ describe('tool runtime 宿主装配（自注册闭环）', () => {
       loadPlugins: async () => ({ tools: {}, references: [] }),
     });
 
-    // mall 模板空装配：模块工具（如 weather 系）不存在，仅 app 级工具
+    // 缺省空装配：模块工具不存在，仅 app 级工具
     expect(Object.keys(runtime.tools)).not.toEqual(
       expect.arrayContaining(['getWeather']),
     );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tbox.cn/app-template-agent",
-  "version": "0.8.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.19.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:",

package/packages/agent-ui-kit/src/ChatPage.tsx

@@ -7,7 +7,7 @@
  * - 域自持段（首屏数据/门禁/详情弹层/活动预热）经槽渲染函数自带——本页零域语义。
  */
 import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from 'react';
-import { consumeAutoSendQuery, runAutoSend } from '@tbox.cn/app-sdk/client';
+import { consumeAutoSendQuery, runAutoSend } from '@tbox.cn/app-agent-sdk-client';
 import { usePullDownHistory } from './hooks/use-pull-down-history';
 import type { TboxCardPayload } from '@tbox.cn/app-contracts';
 import { CardRenderer } from './components/CardRenderer';

package/packages/agent-ui-kit/src/chat-config.ts

@@ -6,7 +6,7 @@
  * - HELLO_ACK settings 水合：服务端单一真源（applyServerSettings；五键整组语义，禁部分水合）。
  */
 import { create } from 'zustand';
-import type { ChatUiSettings } from '@tbox.cn/app-sdk/client';
+import type { ChatUiSettings } from '@tbox.cn/app-agent-sdk-client';
 
 export interface QuickCommand {
   /** 纯文案；前导星标/图标由 QuickCommands 组件渲染，不要写进 label */

package/packages/agent-ui-kit/src/components/ActionBar/DebugButton.tsx

@@ -1,4 +1,4 @@
-import { createLogger } from '@tbox.cn/app-sdk/client';
+import { createLogger } from '@tbox.cn/app-agent-sdk-client';
 
 const debugLogger = createLogger('DebugButton');
 

package/packages/agent-ui-kit/src/components/ActionBar/index.tsx

@@ -1,11 +1,11 @@
 import { useEffect, useState, useSyncExternalStore } from 'react';
-import { createLogger } from '@tbox.cn/app-sdk/client';
+import { createLogger } from '@tbox.cn/app-agent-sdk-client';
 
 const ttsActionLogger = createLogger('tts');
 import { Copy, SpeakerHigh, ThumbsDown, ThumbsUp } from '@phosphor-icons/react';
 import { useChatStore } from '../../store-context';
 import { useChatConfigStore } from '../../chat-config';
-import { useFeedbackAdapter, useRefreshSession, useTTSAdapter } from '@tbox.cn/app-sdk/client';
+import { useFeedbackAdapter, useRefreshSession, useTTSAdapter } from '@tbox.cn/app-agent-sdk-client';
 import type { ChatMessage } from '../../types';
 import { copyText } from '../../utils/copyText';
 import { toast } from '../../utils/toast';
@@ -58,7 +58,6 @@ export function ActionBar({ message }: { message: ChatMessage }) {
   const refreshSession = useRefreshSession();
   const tts = useTTSAdapter();
   const enableTTS = useChatConfigStore((s) => s.enableTTS);
-  const conversationId = useChatStore((s) => s.conversationId);
   const submitFeedback = useChatStore((s) => s.submitFeedback);
 
   const [ttsState, setTtsState] = useState<'idle' | 'loading' | 'playing' | 'paused'>('idle');
@@ -151,7 +150,6 @@ export function ActionBar({ message }: { message: ChatMessage }) {
 
       <DebugButton
         requestId={message.requestId}
-        conversationId={conversationId ?? undefined}
         messageId={message.id}
         messageCreatedAt={new Date(message.createdAt).getTime()}
       />

package/packages/agent-ui-kit/src/components/CardRenderer.tsx

@@ -6,7 +6,7 @@
  * - CardRenderer：聊天入口（组合层覆盖注册表 cards）；
  * - RawCardRenderer：原始形态（rawCards，无覆盖）——首页详情弹层 body 等防嵌套入口。
  */
-import { CardRenderer as SdkCardRenderer } from '@tbox.cn/app-sdk/client';
+import { CardRenderer as SdkCardRenderer } from '@tbox.cn/app-agent-sdk-client';
 import type { TboxCardPayload, UiAction } from '@tbox.cn/app-contracts';
 import { useChatCards, useChatRawCards, useChatStore } from '../store-context';
 

package/packages/agent-ui-kit/src/components/ChatInput/index.test.tsx

@@ -8,7 +8,7 @@ const mocks = vi.hoisted(() => ({
   interactionState: 'idle' as VoiceInteractionState,
 }));
 
-vi.mock('@tbox.cn/app-sdk/client', () => ({
+vi.mock('@tbox.cn/app-agent-sdk-client', () => ({
   isInAlipayShell: () => false,
   useASRAdapter: () => undefined,
 }));

package/packages/agent-ui-kit/src/components/ChatInput/index.tsx

@@ -1,6 +1,6 @@
 import { useEffect, useRef, useState } from 'react';
 import { useMediaUpload } from '../../hooks/useMediaUpload';
-import { useASRAdapter, isInAlipayShell } from '@tbox.cn/app-sdk/client';
+import { useASRAdapter, isInAlipayShell } from '@tbox.cn/app-agent-sdk-client';
 import { useChatConfigStore } from '../../chat-config';
 
 import type { ChatInputMessage, InputMethod } from '../../types';

package/packages/agent-ui-kit/src/components/ChatInput/voice/useVoicePress.ts

@@ -1,6 +1,6 @@
 import { useCallback, useEffect, useRef, useState } from 'react';
-import type { IASRAdapter } from '@tbox.cn/app-sdk/client';
-import { useRefreshSession } from '@tbox.cn/app-sdk/client';
+import type { IASRAdapter } from '@tbox.cn/app-agent-sdk-client';
+import { useRefreshSession } from '@tbox.cn/app-agent-sdk-client';
 import { isSessionExpiredError } from '../../../utils/session-error';
 import { toast } from '../../../utils/toast';
 import {

package/packages/agent-ui-kit/src/components/MessageBubble/index.tsx

@@ -9,7 +9,7 @@ import ToolCallBlock from '../../components/ToolCallBlock';
 import { ActionBar, CopyButton, getMessageCopyText } from '../../components/ActionBar';
 import { DebugButton } from '../../components/ActionBar/DebugButton';
 import { CardRenderer } from '../CardRenderer';
-import { CardCarousel } from '@tbox.cn/app-sdk/client';
+import { CardCarousel } from '@tbox.cn/app-agent-sdk-client';
 import { useChatStore, useInlineCardFilter } from '../../store-context';
 import { copyText } from '../../utils/copyText';
 import { toast } from '../../utils/toast';
@@ -20,7 +20,6 @@ const TBOX_FILE_URL = 'https://mdn.alipayobjects.com/tcmarket/afts/file/';
 /** 消息气泡（对齐原模板）：meta + 思考/工具/卡片 + 气泡 + 媒体 + 操作栏。 */
 export function MessageBubble({ message }: { message: ChatMessage }) {
   const cardsByMessageId = useChatStore((s) => s.cardsByMessageId);
-  const conversationId = useChatStore((s) => s.conversationId);
   // 018 tool-debug：服务端旗标单源（HELLO_ACK；无 URL 逃逸——数据面信任锚点在服务端）
   const toolDebug = useChatStore((s) => s.helloAck?.toolDebug === true);
   const isUser = message.role === 'user';
@@ -164,7 +163,6 @@ export function MessageBubble({ message }: { message: ChatMessage }) {
               {message.requestId && (
                 <DebugButton
                   requestId={message.requestId}
-                  conversationId={conversationId ?? undefined}
                   messageId={message.id}
                   messageCreatedAt={new Date(message.createdAt).getTime()}
                 />

package/packages/agent-ui-kit/src/components/QuickCommands/index.test.tsx

@@ -8,7 +8,7 @@ import { createRoot } from 'react-dom/client';
 import { flushSync } from 'react-dom';
 import type { ReactNode } from 'react';
 import { create } from 'zustand';
-import type { CoreChatStore } from '@tbox.cn/app-sdk/client';
+import type { CoreChatStore } from '@tbox.cn/app-agent-sdk-client';
 import { configureChatConfigDefaults, useChatConfigStore } from '../../chat-config';
 import { KitChatProvider } from '../../store-context';
 import { QuickCommands } from './index';

package/packages/agent-ui-kit/src/components/ToolCallBlock/detail.test.ts

@@ -9,7 +9,7 @@ import {
   PRE_TOOL_CALL_NAME,
   SKILL_TOOL_CALL_NAME,
 } from '@tbox.cn/app-contracts';
-import type { ToolCallInfo } from '@tbox.cn/app-sdk/client';
+import type { ToolCallInfo } from '@tbox.cn/app-agent-sdk-client';
 import {
   buildSummaryText,
   deriveSummary,

package/packages/agent-ui-kit/src/components/ToolCallBlock/detail.ts

@@ -5,7 +5,7 @@
  * debug 门控在渲染层（组件 debug prop）——视图模型保持纯数据投影，不感知环境。
  */
 import { describeToolCall } from '../../utils/tool-call-display';
-import type { ToolCallInfo } from '@tbox.cn/app-sdk/client';
+import type { ToolCallInfo } from '@tbox.cn/app-agent-sdk-client';
 import {
   MEMORY_TOOL_CALL_NAME,
   parseMemoryToolCallArgs,

package/packages/agent-ui-kit/src/hooks/useMediaUpload.ts

@@ -1,9 +1,9 @@
-import { createLogger } from '@tbox.cn/app-sdk/client';
+import { createLogger } from '@tbox.cn/app-agent-sdk-client';
 
 const mediaLogger = createLogger('media');
 
 import { useCallback, useEffect, useRef, useState } from 'react';
-import { useUploadAdapter, useRefreshSession, chooseImage, chooseVideo } from '@tbox.cn/app-sdk/client';
+import { useUploadAdapter, useRefreshSession, chooseImage, chooseVideo } from '@tbox.cn/app-agent-sdk-client';
 
 import { isSessionExpiredError } from '../utils/session-error';
 import { toast } from '../utils/toast';

package/packages/agent-ui-kit/src/hooks/useTTSAutoPlay.ts

@@ -1,7 +1,7 @@
 import { useEffect } from 'react';
-import type { CoreChatState } from '@tbox.cn/app-sdk/client';
+import type { CoreChatState } from '@tbox.cn/app-agent-sdk-client';
 import { useChatStoreApi } from '../store-context';
-import { useTTSAdapter } from '@tbox.cn/app-sdk/client';
+import { useTTSAdapter } from '@tbox.cn/app-agent-sdk-client';
 
 const FLUSH_MS = 300; // 累积 delta 后批量送，避免过多 WS 消息
 

package/packages/agent-ui-kit/src/store-context.tsx

@@ -10,7 +10,7 @@
  */
 import { createContext, useContext, useMemo, type ReactNode } from 'react';
 import type { CardComponent, TboxCardPayload } from '@tbox.cn/app-contracts';
-import type { ClientSlotRegistry, CoreChatState, CoreChatStore } from '@tbox.cn/app-sdk/client';
+import type { ClientSlotRegistry, CoreChatState, CoreChatStore } from '@tbox.cn/app-agent-sdk-client';
 
 export interface KitChatContextValue {
   /** 应用注入的 chat store（zustand 绑定 hook + API） */