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

package/apps/server/src/dev.ts

@@ -41,17 +41,32 @@ const vite = await createViteServer({
   appType: 'custom',
 });
 
-// 升级委托：与 vite hmrServerWsListener 同条件（协议整串匹配 + pathname === 认领路径）。
-// viteHmrPath 与 vite 同一 resolved config、同式 posix.join 派生——恒等无漂移（字面比较
-// 在未来设 base 时有悬挂方向：delegate 认领转发而 vite 不接，socket 无人销毁）。协议轴
-// 必须保留：hub 是纯事件载体无 destroy，仅匹配 path 的非 vite 协议升级会转发后无人认领。
+// 升级委托：pathname === 认领路径（与 vite 同一 resolved config 同式 posix.join 派生——
+// 恒等无漂移，字面比较在未来设 base 时有悬挂方向：delegate 认领转发而 vite 不接，socket
+// 无人销毁）；协议轴 = 子协议补写 + 白名单（见下）。
+// 子协议补写（2026-09-21，详见 .agents/notes/implemented/bug-fix/
+// 2026-09-21-spanner-ws-subprotocol-strip-reload-loop.md）：Spanner 网关（*.coding.tboxpro.cn
+// 车道）把 WS 升级的 Sec-WebSocket-Protocol 视为 hop-by-hop 在下游拨号时剥除（2026-09-09
+// Terminal Note 同源实证：Authorization/Cookie/子协议均剥、query 唯一存活）。剥除后的拨号
+// 无协议头——原逻辑不认领 → 回落 app upgrade destroy → 网关报 "unexpected EOF"；WebKit
+// （Safari/iOS 支付宝·微信）宽松接受网关乐观 101（无协议回显），hmr WS open 即断 → vite
+// client vite:ws:disconnect → vite-ping 探测又被乐观 101 放行（成功判据 = open 事件，先于
+// 下游拨号结果）→ location.reload() 无限循环（Chrome/Blink 严格校验协议回显恒不 open，
+// 走静默分支免疫）。补写让下游握手成立：vite 101 带协议回显 + connected → 连接保持 →
+// 无 disconnect/ping/reload，WebKit 下 HMR 恢复可用。补写在网关透传修复（agtchannel spec
+// 2026-09-21 close/握手头透传，1b）落地后自动退化为死分支——长留不移除（sync 覆盖 + DRM
+// 回滚场景防回归载体）。其余非 vite 协议值仍不认领（smoke ⑤⑥ 语义不变）。
 // 未认领的升级回落 app 路由（业务 /ws、根路径归还业务、fail-fast 语义不变）。
 const viteHmrPath = path.posix.join(vite.config.base, HMR_WS_PATH);
 registerUpgradeDelegate((request, socket, head) => {
-  const protocol = request.headers['sec-websocket-protocol'];
-  if (protocol !== 'vite-hmr' && protocol !== 'vite-ping') return false;
   const { pathname } = new URL(request.url || '/', 'http://localhost');
   if (pathname !== viteHmrPath) return false;
+  const protocol = request.headers['sec-websocket-protocol'];
+  if (!protocol) {
+    request.headers['sec-websocket-protocol'] = 'vite-hmr';
+  } else if (protocol !== 'vite-hmr' && protocol !== 'vite-ping') {
+    return false;
+  }
   hmrHub.emit('upgrade', request, socket, head);
   return true;
 });

package/package.json

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

package/pnpm-lock.template.yaml

@@ -19,11 +19,11 @@ catalogs:
       specifier: 0.1.1
       version: 0.1.1
     '@tbox.cn/app-agent-sdk-server':
-      specifier: 0.1.1
-      version: 0.1.1
+      specifier: 0.1.2
+      version: 0.1.2
     '@tbox.cn/app-contracts':
-      specifier: 0.12.0
-      version: 0.12.0
+      specifier: 0.12.1
+      version: 0.12.1
     '@tbox.cn/app-contracts-mall':
       specifier: 0.12.1
       version: 0.12.1
@@ -31,8 +31,8 @@ catalogs:
       specifier: 0.21.0
       version: 0.21.0
     '@tbox.cn/app-theme-tbox':
-      specifier: 0.1.2
-      version: 0.1.2
+      specifier: 0.1.3
+      version: 0.1.3
     '@types/express':
       specifier: 4.17.25
       version: 4.17.25
@@ -145,10 +145,10 @@ importers:
         version: 0.1.1(@types/react@18.3.31)
       '@tbox.cn/app-contracts':
         specifier: 'catalog:'
-        version: 0.12.0
+        version: 0.12.1
       '@tbox.cn/app-theme-tbox':
         specifier: 'catalog:'
-        version: 0.1.2
+        version: 0.1.3
       react:
         specifier: 'catalog:'
         version: 18.3.1
@@ -206,10 +206,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.1.1(@tbox-dev-js/sdk@0.1.18)(rxjs@7.8.1)
+        version: 0.1.2(@tbox-dev-js/sdk@0.1.18)(rxjs@7.8.1)
       '@tbox.cn/app-contracts':
         specifier: 'catalog:'
-        version: 0.12.0
+        version: 0.12.1
       express:
         specifier: 'catalog:'
         version: 4.22.2
@@ -249,7 +249,7 @@ importers:
         version: 0.1.1(@types/react@18.3.31)
       '@tbox.cn/app-contracts':
         specifier: 'catalog:'
-        version: 0.12.0
+        version: 0.12.1
       antd-mobile:
         specifier: 'catalog:'
         version: 5.42.3(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
@@ -317,10 +317,10 @@ importers:
         version: 0.1.1(@types/react@18.3.31)
       '@tbox.cn/app-agent-sdk-server':
         specifier: 'catalog:'
-        version: 0.1.1(@tbox-dev-js/sdk@0.1.18)(rxjs@7.8.1)
+        version: 0.1.2(@tbox-dev-js/sdk@0.1.18)(rxjs@7.8.1)
       '@tbox.cn/app-contracts':
         specifier: 'catalog:'
-        version: 0.12.0
+        version: 0.12.1
     devDependencies:
       '@types/node':
         specifier: 24.13.3
@@ -1339,8 +1339,8 @@ packages:
     resolution: {integrity: sha512-+HynOgllJS7dupTYTQ5R/5Ajpp5ErOVvGl/dz0wNBb/oZQxKgV0/ePQSxrlS1YnFXsiA9mzELdASz6CudOP/4A==}
     engines: {node: '>=20.0.0'}
 
-  '@tbox.cn/app-agent-sdk-server@0.1.1':
-    resolution: {integrity: sha512-0KmAWR+wZODm5oRJ6IPgKfFFz49V8ACnetaFShgl5HI2HSianWWMECAWdyxdwp4hBOAMQU+IG6t2sz0gyE0UNQ==}
+  '@tbox.cn/app-agent-sdk-server@0.1.2':
+    resolution: {integrity: sha512-qS9RDPAGHiFB+FesBtgc2QLZnGNgXrG62fCyPQ663Cb9xfF0Fs0r+fTPXpG2ewsBkoST7c1oy/ZlfMO85o7/pw==}
     engines: {node: '>=20.0.0'}
 
   '@tbox.cn/app-contracts-mall@0.12.1':
@@ -1351,6 +1351,10 @@ packages:
     resolution: {integrity: sha512-GFthajvUSE7tY6Y5kLJgg2dRuZQdLfxq/WAEHOh+Q7RTwg7mpuLsWiNhXISkXMAtpxg0RkSgtwyRq33QS0ay3w==}
     engines: {node: '>=20.0.0'}
 
+  '@tbox.cn/app-contracts@0.12.1':
+    resolution: {integrity: sha512-h5HXIfk5frNx6hufY2IBE+hISCk3/2n8A7G3EtnAF4JsR91Pm/uwdmn4zYtZOz0r9cL7Wk1SrUMcokMZ9HkbLw==}
+    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'}
@@ -1359,13 +1363,17 @@ packages:
     resolution: {integrity: sha512-hvdcXntg4iJniVu9LEwo5A/vov3L08kRlJLTgStYRdAlH9AJXWLDxFITMNf7YJX8W+j9wjJmmS7Sv88iswxM+w==}
     engines: {node: '>=20.0.0'}
 
+  '@tbox.cn/app-sdk-core@0.20.1':
+    resolution: {integrity: sha512-OSncc0sjhcuEQAlcANLCKNP0V+hgVhP0qol6pIyYSxSUUVLf69naiGWC4CBtY7PTIYlhximMw6bIn8tqNYKFXg==}
+    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.2':
-    resolution: {integrity: sha512-/0x1XjcE1dDgQ4CTaqcXFZjWS47JQ2u7JS2jAbORTqrSmo7F0X/3m4LsH+WHAn+2r709KIRFh99NT3iMYqci2g==}
+  '@tbox.cn/app-theme-tbox@0.1.3':
+    resolution: {integrity: sha512-Wf2umpT/k+Ppy1oKuCDqe6M5yvp4F/tjdGpU7uygGWMaEduwFnoK0EVh4eDcA6dMlERLCAjxFlEUY68xXGq99A==}
 
   '@tbox.cn/app-toolkit@0.5.0':
     resolution: {integrity: sha512-ShLYwxsMzhr8V5sjixo4GFGBZbAw4/8CoTnCigrbBcRLtydf2ezLrLDR9jHfi/d5fQworFR5ZBzI7xDSjvR2zA==}
@@ -4081,7 +4089,7 @@ snapshots:
       - '@types/react'
       - immer
 
-  '@tbox.cn/app-agent-sdk-server@0.1.1(@tbox-dev-js/sdk@0.1.18)(rxjs@7.8.1)':
+  '@tbox.cn/app-agent-sdk-server@0.1.2(@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)
@@ -4089,8 +4097,8 @@ 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.12.0
-      '@tbox.cn/app-sdk-core': 0.20.0
+      '@tbox.cn/app-contracts': 0.12.1
+      '@tbox.cn/app-sdk-core': 0.20.1
       '@tbox.cn/app-sdk-server': 0.21.0
       ai: 6.0.246(zod@3.25.76)
       express: 4.22.2
@@ -4120,6 +4128,12 @@ snapshots:
       react: 18.3.1
       zod: 3.25.76
 
+  '@tbox.cn/app-contracts@0.12.1':
+    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
@@ -4131,6 +4145,10 @@ snapshots:
     dependencies:
       '@tbox.cn/app-contracts': 0.12.0
 
+  '@tbox.cn/app-sdk-core@0.20.1':
+    dependencies:
+      '@tbox.cn/app-contracts': 0.12.1
+
   '@tbox.cn/app-sdk-server@0.21.0':
     dependencies:
       '@ag-ui/core': 0.0.47
@@ -4143,7 +4161,7 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
-  '@tbox.cn/app-theme-tbox@0.1.2': {}
+  '@tbox.cn/app-theme-tbox@0.1.3': {}
 
   '@tbox.cn/app-toolkit@0.5.0':
     dependencies:

package/pnpm-workspace.template.yaml

@@ -38,14 +38,14 @@ catalog:
   ws: 8.21.3
   "@types/ws": 8.18.1
   "@tbox.cn/agent-plugin": 0.1.0
-  "@tbox.cn/app-sdk-core": 0.20.0
+  "@tbox.cn/app-sdk-core": 0.20.1
   "@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-server": 0.1.2
   "@tbox.cn/app-agent-sdk-client": 0.1.1
-  "@tbox.cn/app-contracts": 0.12.0
+  "@tbox.cn/app-contracts": 0.12.1
   "@tbox.cn/app-contracts-mall": 0.12.1
-  "@tbox.cn/app-theme-tbox": 0.1.2
+  "@tbox.cn/app-theme-tbox": 0.1.3
   zustand: 4.5.7
   eslint: 9.39.5
   typescript-eslint: 8.67.0