chainlesschain 0.162.2 → 0.162.7

package/src/assets/web-panel/assets/{statusUtils-nHmUS8yg.js → statusUtils-BnIQmxwT.js}

@@ -1 +1 @@
-import{i as e}from"./index-BAy0ks7N.js";function r(a,s,t){return e({[`${a}-status-success`]:s==="success",[`${a}-status-warning`]:s==="warning",[`${a}-status-error`]:s==="error",[`${a}-status-validating`]:s==="validating",[`${a}-has-feedback`]:t})}const c=(a,s)=>s||a;export{c as a,r as g};
+import{i as e}from"./index-19d37fVJ.js";function r(a,s,t){return e({[`${a}-status-success`]:s==="success",[`${a}-status-warning`]:s==="warning",[`${a}-status-error`]:s==="error",[`${a}-status-validating`]:s==="validating",[`${a}-has-feedback`]:t})}const c=(a,s)=>s||a;export{c as a,r as g};

package/src/assets/web-panel/assets/{styleChecker-DgazP1mu.js → styleChecker-BMXx5Ie5.js}

@@ -1 +1 @@
-import{A as d}from"./index-BAy0ks7N.js";const i=()=>d()&&window.document.documentElement,c=e=>{if(d()&&window.document.documentElement){const t=Array.isArray(e)?e:[e],{documentElement:n}=window.document;return t.some(r=>r in n.style)}return!1},u=(e,t)=>{if(!c(e))return!1;const n=document.createElement("div"),r=n.style[e];return n.style[e]=t,n.style[e]!==r};function s(e,t){return!Array.isArray(e)&&t!==void 0?u(e,t):c(e)}let o;const p=()=>{if(!i())return!1;if(o!==void 0)return o;const e=document.createElement("div");return e.style.display="flex",e.style.flexDirection="column",e.style.rowGap="1px",e.appendChild(document.createElement("div")),e.appendChild(document.createElement("div")),document.body.appendChild(e),o=e.scrollHeight===1,document.body.removeChild(e),o};export{i as c,p as d,s as i};
+import{A as d}from"./index-19d37fVJ.js";const i=()=>d()&&window.document.documentElement,c=e=>{if(d()&&window.document.documentElement){const t=Array.isArray(e)?e:[e],{documentElement:n}=window.document;return t.some(r=>r in n.style)}return!1},u=(e,t)=>{if(!c(e))return!1;const n=document.createElement("div"),r=n.style[e];return n.style[e]=t,n.style[e]!==r};function s(e,t){return!Array.isArray(e)&&t!==void 0?u(e,t):c(e)}let o;const p=()=>{if(!i())return!1;if(o!==void 0)return o;const e=document.createElement("div");return e.style.display="flex",e.style.flexDirection="column",e.style.rowGap="1px",e.appendChild(document.createElement("div")),e.appendChild(document.createElement("div")),document.body.appendChild(e),o=e.scrollHeight===1,document.body.removeChild(e),o};export{i as c,p as d,s as i};

package/src/assets/web-panel/assets/{useFlexGapSupport-BQ4jJS_s.js → useFlexGapSupport-DSJ4Pl17.js}

@@ -1 +1 @@
-import{d as o}from"./styleChecker-DgazP1mu.js";import{o as t,s}from"./vendor-M5lGV-wr.js";const r=(()=>{const e=s(!1);return t(()=>{e.value=o()}),e});export{r as u};
+import{d as o}from"./styleChecker-BMXx5Ie5.js";import{o as t,s}from"./vendor-M5lGV-wr.js";const r=(()=>{const e=s(!1);return t(()=>{e.value=o()}),e});export{r as u};

package/src/assets/web-panel/assets/{useFs-C8aeIQfU.js → useFs-BPbHm7Yn.js}

@@ -1 +1 @@
-import{u as d}from"./index-BAy0ks7N.js";import{u as c}from"./useShellMode-CgR0wCYM.js";function u({accept:l=""}={}){return new Promise(a=>{if(typeof document>"u"){a({canceled:!0,path:null,content:null});return}const n=document.createElement("input");n.type="file",l&&(n.accept=l),n.style.display="none",document.body.appendChild(n);let o=!1;const i=()=>{n.parentNode&&n.parentNode.removeChild(n)},r=()=>{if(o)return;o=!0;const e=n.files&&n.files[0];if(!e){i(),a({canceled:!0,path:null,content:null});return}const t=new FileReader;t.onload=()=>{i(),a({canceled:!1,path:e.name,size:e.size,content:typeof t.result=="string"?t.result:""})},t.onerror=()=>{i(),a({canceled:!1,path:e.name,size:e.size,content:null,reason:"read_failed"})},t.readAsText(e)};n.addEventListener("change",r),n.click()})}function f(l,{defaultPath:a="download.txt"}={}){if(typeof document>"u")return{canceled:!0,path:null};const n=new Blob([l],{type:"text/plain"}),o=URL.createObjectURL(n),i=document.createElement("a");return i.href=o,i.download=a,document.body.appendChild(i),i.click(),document.body.removeChild(i),URL.revokeObjectURL(o),{canceled:!1,path:a}}function p(l){if(!Array.isArray(l))return"";const a=[];for(const n of l)if(Array.isArray(n.extensions))for(const o of n.extensions)a.push(`.${o.replace(/^\./,"")}`);return a.join(",")}function m(){const l=d();async function a(r={}){if(c().isEmbedded){const e=await l.sendRaw({type:"fs.openDialog",title:r.title,filters:r.filters},6e4);if(e&&e.ok===!1)throw new Error(e.error||"fs.openDialog failed");const t=e?.result??e;return{canceled:!!t.canceled,path:t.path??null,content:t.content??null,size:t.size,reason:t.reason}}return u({accept:p(r.filters)})}async function n(r,e={}){if(typeof r!="string")throw new Error("content must be a string");if(c().isEmbedded){const t=await l.sendRaw({type:"fs.saveDialog",title:e.title,defaultPath:e.defaultPath,filters:e.filters,content:r},6e4);if(t&&t.ok===!1)throw new Error(t.error||"fs.saveDialog failed");const s=t?.result??t;return{canceled:!!s.canceled,path:s.path??null}}return f(r,{defaultPath:e.defaultPath})}async function o(r,e={}){const t=JSON.stringify(r,null,2),s={...e,defaultPath:e.defaultPath||"data.json",filters:e.filters||[{name:"JSON",extensions:["json"]}]};return n(t,s)}async function i(r={}){if(!c().isEmbedded)return{canceled:!0,path:null,initialized:!1,unsupported:!0};const e=await l.sendRaw({type:"fs.openDirectory",title:r.title},6e4);if(e&&e.ok===!1)throw new Error(e.error||"fs.openDirectory failed");const t=e?.result??e;return{canceled:!!t.canceled,path:t.path??null,initialized:!!t.initialized}}return{pickFileText:a,saveText:n,saveJson:o,pickDirectory:i}}export{m as u};
+import{u as d}from"./index-19d37fVJ.js";import{u as c}from"./useShellMode-CgR0wCYM.js";function u({accept:l=""}={}){return new Promise(a=>{if(typeof document>"u"){a({canceled:!0,path:null,content:null});return}const n=document.createElement("input");n.type="file",l&&(n.accept=l),n.style.display="none",document.body.appendChild(n);let o=!1;const i=()=>{n.parentNode&&n.parentNode.removeChild(n)},r=()=>{if(o)return;o=!0;const e=n.files&&n.files[0];if(!e){i(),a({canceled:!0,path:null,content:null});return}const t=new FileReader;t.onload=()=>{i(),a({canceled:!1,path:e.name,size:e.size,content:typeof t.result=="string"?t.result:""})},t.onerror=()=>{i(),a({canceled:!1,path:e.name,size:e.size,content:null,reason:"read_failed"})},t.readAsText(e)};n.addEventListener("change",r),n.click()})}function f(l,{defaultPath:a="download.txt"}={}){if(typeof document>"u")return{canceled:!0,path:null};const n=new Blob([l],{type:"text/plain"}),o=URL.createObjectURL(n),i=document.createElement("a");return i.href=o,i.download=a,document.body.appendChild(i),i.click(),document.body.removeChild(i),URL.revokeObjectURL(o),{canceled:!1,path:a}}function p(l){if(!Array.isArray(l))return"";const a=[];for(const n of l)if(Array.isArray(n.extensions))for(const o of n.extensions)a.push(`.${o.replace(/^\./,"")}`);return a.join(",")}function m(){const l=d();async function a(r={}){if(c().isEmbedded){const e=await l.sendRaw({type:"fs.openDialog",title:r.title,filters:r.filters},6e4);if(e&&e.ok===!1)throw new Error(e.error||"fs.openDialog failed");const t=e?.result??e;return{canceled:!!t.canceled,path:t.path??null,content:t.content??null,size:t.size,reason:t.reason}}return u({accept:p(r.filters)})}async function n(r,e={}){if(typeof r!="string")throw new Error("content must be a string");if(c().isEmbedded){const t=await l.sendRaw({type:"fs.saveDialog",title:e.title,defaultPath:e.defaultPath,filters:e.filters,content:r},6e4);if(t&&t.ok===!1)throw new Error(t.error||"fs.saveDialog failed");const s=t?.result??t;return{canceled:!!s.canceled,path:s.path??null}}return f(r,{defaultPath:e.defaultPath})}async function o(r,e={}){const t=JSON.stringify(r,null,2),s={...e,defaultPath:e.defaultPath||"data.json",filters:e.filters||[{name:"JSON",extensions:["json"]}]};return n(t,s)}async function i(r={}){if(!c().isEmbedded)return{canceled:!0,path:null,initialized:!1,unsupported:!0};const e=await l.sendRaw({type:"fs.openDirectory",title:r.title},6e4);if(e&&e.ok===!1)throw new Error(e.error||"fs.openDirectory failed");const t=e?.result??e;return{canceled:!!t.canceled,path:t.path??null,initialized:!!t.initialized}}return{pickFileText:a,saveText:n,saveJson:o,pickDirectory:i}}export{m as u};

package/src/assets/web-panel/assets/{vnode-DMH0ymoP.js → vnode-HDTJKu2B.js}

@@ -1 +1 @@
-import{M as i,h as a,w as l}from"./index-BAy0ks7N.js";import{a5 as o,k as d,C as g,F as f,A as p}from"./vendor-M5lGV-wr.js";function c(e){let r=arguments.length>1&&arguments[1]!==void 0?arguments[1]:{},t=arguments.length>2&&arguments[2]!==void 0?arguments[2]:!0,s=arguments.length>3&&arguments[3]!==void 0?arguments[3]:!1,u=e;if(Array.isArray(e)&&(u=i(e)[0]),!u)return null;const n=o(u,r,s);return n.props=t?a(a({},n.props),r):n.props,l(typeof n.props.class!="object"),n}function v(e){let r=arguments.length>1&&arguments[1]!==void 0?arguments[1]:{},t=arguments.length>2&&arguments[2]!==void 0?arguments[2]:!0;return e.map(s=>c(s,r,t))}function N(e,r,t){p(o(e,a({},r)),t)}const m=e=>(e||[]).some(r=>d(r)?!(r.type===g||r.type===f&&!m(r.children)):!0)?e:null;function h(e,r,t,s){var u;const n=(u=e[r])===null||u===void 0?void 0:u.call(e,t);return m(n)?n:s?.()}export{h as a,v as b,c,N as t};
+import{M as i,h as a,w as l}from"./index-19d37fVJ.js";import{a5 as o,k as d,C as g,F as f,A as p}from"./vendor-M5lGV-wr.js";function c(e){let r=arguments.length>1&&arguments[1]!==void 0?arguments[1]:{},t=arguments.length>2&&arguments[2]!==void 0?arguments[2]:!0,s=arguments.length>3&&arguments[3]!==void 0?arguments[3]:!1,u=e;if(Array.isArray(e)&&(u=i(e)[0]),!u)return null;const n=o(u,r,s);return n.props=t?a(a({},n.props),r):n.props,l(typeof n.props.class!="object"),n}function v(e){let r=arguments.length>1&&arguments[1]!==void 0?arguments[1]:{},t=arguments.length>2&&arguments[2]!==void 0?arguments[2]:!0;return e.map(s=>c(s,r,t))}function N(e,r,t){p(o(e,a({},r)),t)}const m=e=>(e||[]).some(r=>d(r)?!(r.type===g||r.type===f&&!m(r.children)):!0)?e:null;function h(e,r,t,s){var u;const n=(u=e[r])===null||u===void 0?void 0:u.call(e,t);return m(n)?n:s?.()}export{h as a,v as b,c,N as t};

package/src/assets/web-panel/assets/{zoom-DRmMxFNC.js → zoom-BqKDJys9.js}

@@ -1,4 +1,4 @@
-import{K as o}from"./index-BAy0ks7N.js";import{i as f}from"./motion-yBy7l6Td.js";const c=new o("antZoomIn",{"0%":{transform:"scale(0.2)",opacity:0},"100%":{transform:"scale(1)",opacity:1}}),y=new o("antZoomOut",{"0%":{transform:"scale(1)"},"100%":{transform:"scale(0.2)",opacity:0}}),a=new o("antZoomBigIn",{"0%":{transform:"scale(0.8)",opacity:0},"100%":{transform:"scale(1)",opacity:1}}),s=new o("antZoomBigOut",{"0%":{transform:"scale(1)"},"100%":{transform:"scale(0.8)",opacity:0}}),g=new o("antZoomUpIn",{"0%":{transform:"scale(0.8)",transformOrigin:"50% 0%",opacity:0},"100%":{transform:"scale(1)",transformOrigin:"50% 0%"}}),O=new o("antZoomUpOut",{"0%":{transform:"scale(1)",transformOrigin:"50% 0%"},"100%":{transform:"scale(0.8)",transformOrigin:"50% 0%",opacity:0}}),l=new o("antZoomLeftIn",{"0%":{transform:"scale(0.8)",transformOrigin:"0% 50%",opacity:0},"100%":{transform:"scale(1)",transformOrigin:"0% 50%"}}),u=new o("antZoomLeftOut",{"0%":{transform:"scale(1)",transformOrigin:"0% 50%"},"100%":{transform:"scale(0.8)",transformOrigin:"0% 50%",opacity:0}}),p=new o("antZoomRightIn",{"0%":{transform:"scale(0.8)",transformOrigin:"100% 50%",opacity:0},"100%":{transform:"scale(1)",transformOrigin:"100% 50%"}}),z=new o("antZoomRightOut",{"0%":{transform:"scale(1)",transformOrigin:"100% 50%"},"100%":{transform:"scale(0.8)",transformOrigin:"100% 50%",opacity:0}}),K=new o("antZoomDownIn",{"0%":{transform:"scale(0.8)",transformOrigin:"50% 100%",opacity:0},"100%":{transform:"scale(1)",transformOrigin:"50% 100%"}}),w=new o("antZoomDownOut",{"0%":{transform:"scale(1)",transformOrigin:"50% 100%"},"100%":{transform:"scale(0.8)",transformOrigin:"50% 100%",opacity:0}}),I={zoom:{inKeyframes:c,outKeyframes:y},"zoom-big":{inKeyframes:a,outKeyframes:s},"zoom-big-fast":{inKeyframes:a,outKeyframes:s},"zoom-left":{inKeyframes:l,outKeyframes:u},"zoom-right":{inKeyframes:p,outKeyframes:z},"zoom-up":{inKeyframes:g,outKeyframes:O},"zoom-down":{inKeyframes:K,outKeyframes:w}},h=(n,r)=>{const{antCls:m}=n,t=`${m}-${r}`,{inKeyframes:i,outKeyframes:e}=I[r];return[f(t,i,e,r==="zoom-big-fast"?n.motionDurationFast:n.motionDurationMid),{[`
+import{K as o}from"./index-19d37fVJ.js";import{i as f}from"./motion-VM5YQ6Mf.js";const c=new o("antZoomIn",{"0%":{transform:"scale(0.2)",opacity:0},"100%":{transform:"scale(1)",opacity:1}}),y=new o("antZoomOut",{"0%":{transform:"scale(1)"},"100%":{transform:"scale(0.2)",opacity:0}}),a=new o("antZoomBigIn",{"0%":{transform:"scale(0.8)",opacity:0},"100%":{transform:"scale(1)",opacity:1}}),s=new o("antZoomBigOut",{"0%":{transform:"scale(1)"},"100%":{transform:"scale(0.8)",opacity:0}}),g=new o("antZoomUpIn",{"0%":{transform:"scale(0.8)",transformOrigin:"50% 0%",opacity:0},"100%":{transform:"scale(1)",transformOrigin:"50% 0%"}}),O=new o("antZoomUpOut",{"0%":{transform:"scale(1)",transformOrigin:"50% 0%"},"100%":{transform:"scale(0.8)",transformOrigin:"50% 0%",opacity:0}}),l=new o("antZoomLeftIn",{"0%":{transform:"scale(0.8)",transformOrigin:"0% 50%",opacity:0},"100%":{transform:"scale(1)",transformOrigin:"0% 50%"}}),u=new o("antZoomLeftOut",{"0%":{transform:"scale(1)",transformOrigin:"0% 50%"},"100%":{transform:"scale(0.8)",transformOrigin:"0% 50%",opacity:0}}),p=new o("antZoomRightIn",{"0%":{transform:"scale(0.8)",transformOrigin:"100% 50%",opacity:0},"100%":{transform:"scale(1)",transformOrigin:"100% 50%"}}),z=new o("antZoomRightOut",{"0%":{transform:"scale(1)",transformOrigin:"100% 50%"},"100%":{transform:"scale(0.8)",transformOrigin:"100% 50%",opacity:0}}),K=new o("antZoomDownIn",{"0%":{transform:"scale(0.8)",transformOrigin:"50% 100%",opacity:0},"100%":{transform:"scale(1)",transformOrigin:"50% 100%"}}),w=new o("antZoomDownOut",{"0%":{transform:"scale(1)",transformOrigin:"50% 100%"},"100%":{transform:"scale(0.8)",transformOrigin:"50% 100%",opacity:0}}),I={zoom:{inKeyframes:c,outKeyframes:y},"zoom-big":{inKeyframes:a,outKeyframes:s},"zoom-big-fast":{inKeyframes:a,outKeyframes:s},"zoom-left":{inKeyframes:l,outKeyframes:u},"zoom-right":{inKeyframes:p,outKeyframes:z},"zoom-up":{inKeyframes:g,outKeyframes:O},"zoom-down":{inKeyframes:K,outKeyframes:w}},h=(n,r)=>{const{antCls:m}=n,t=`${m}-${r}`,{inKeyframes:i,outKeyframes:e}=I[r];return[f(t,i,e,r==="zoom-big-fast"?n.motionDurationFast:n.motionDurationMid),{[`
         ${t}-enter,
         ${t}-appear
       `]:{transform:"scale(0)",opacity:0,animationTimingFunction:n.motionEaseOutCirc,"&-prepare":{transform:"none"}},[`${t}-leave`]:{animationTimingFunction:n.motionEaseInOutCirc}}]};export{h as i,c as z};

package/src/assets/web-panel/index.html

@@ -8,9 +8,9 @@
     // Injected by web-ui-server.js at serve time
     window.__CC_CONFIG__ = __CC_CONFIG_PLACEHOLDER__;
   </script>
-  <script type="module" crossorigin src="./assets/index-BAy0ks7N.js"></script>
+  <script type="module" crossorigin src="./assets/index-19d37fVJ.js"></script>
   <link rel="modulepreload" crossorigin href="./assets/vendor-M5lGV-wr.js">
-  <link rel="modulepreload" crossorigin href="./assets/icons-DY9VpXfa.js">
+  <link rel="modulepreload" crossorigin href="./assets/icons-BFHq5fEF.js">
   <link rel="stylesheet" crossorigin href="./assets/index-CfX1DEtk.css">
 </head>
 <body>

package/src/commands/ui.js

@@ -24,12 +24,30 @@ export function registerUiCommand(program) {
     )
     .action(async (opts) => {
       try {
+        // Allow env vars to override CLI defaults — host/token/port/uiMode.
+        // Use case: Android local terminal app pre-injects CC_UI_HOST=0.0.0.0
+        // + a per-install CC_UI_TOKEN so `cc ui` is reachable from other
+        // devices on the LAN without the user typing flags every time.
+        // Explicit CLI flags still win (commander stamps defaults if missing,
+        // so we treat the literal default-string as "unset" and pick env up).
+        const hostEnv = process.env.CC_UI_HOST;
+        const tokenEnv = process.env.CC_UI_TOKEN;
+        const portEnv = process.env.CC_UI_PORT;
+        const host =
+          opts.host && opts.host !== "127.0.0.1"
+            ? opts.host
+            : hostEnv || opts.host;
+        const token = opts.token || tokenEnv || null;
+        const port = parseInt(
+          opts.port && opts.port !== "18810" ? opts.port : portEnv || opts.port,
+          10,
+        );
         const runtime = createAgentRuntimeFactory().createUiRuntime({
-          port: parseInt(opts.port, 10),
+          port,
           wsPort: parseInt(opts.wsPort, 10),
-          host: opts.host,
+          host,
           open: opts.open,
-          token: opts.token || null,
+          token,
           webPanelDir: opts.webPanelDir || null,
           uiMode: opts.uiMode || "auto",
         });

package/src/gateways/ws/message-dispatcher.js

@@ -3,6 +3,10 @@ import {
   SESSION_CORE_STREAMING_HANDLERS,
 } from "./session-core-protocol.js";
 import { VIDEO_HANDLERS, VIDEO_STREAMING_HANDLERS } from "./video-protocol.js";
+import {
+  PERSONAL_DATA_HUB_HANDLERS,
+  PERSONAL_DATA_HUB_STREAMING_HANDLERS,
+} from "./personal-data-hub-protocol.js";
 
 export function createWsMessageDispatcher(server) {
   return {
@@ -194,6 +198,70 @@ export function createWsMessageDispatcher(server) {
         };
       }
 
+      // Personal Data Hub topics — same 10 surfaces as the Electron IPC
+      // (see desktop-app-vue/src/main/ipc/personal-data-hub-ipc.js). Each
+      // handler returns { result } or { error }; we wrap with the standard
+      // response envelope so renderer code is shell-agnostic.
+      for (const hubType of Object.keys(PERSONAL_DATA_HUB_HANDLERS)) {
+        routes[hubType] = async () => {
+          try {
+            const out = await PERSONAL_DATA_HUB_HANDLERS[hubType](message);
+            if (out && out.error) {
+              server._send(ws, {
+                id,
+                type: "error",
+                code: "PERSONAL_DATA_HUB_ERROR",
+                message: out.error,
+              });
+            } else {
+              server._send(ws, {
+                id,
+                type: `${hubType}.response`,
+                result: out && out.result !== undefined ? out.result : out,
+              });
+            }
+          } catch (err) {
+            server._send(ws, {
+              id,
+              type: "error",
+              code: "PERSONAL_DATA_HUB_ERROR",
+              message: err?.message || String(err),
+            });
+          }
+        };
+      }
+
+      // Phase 5.7 — streaming sync routes. Adapter progress events are
+      // pushed as `<topic>.event` messages tagged with the request id;
+      // the final report comes as `<topic>.end`.
+      for (const streamType of Object.keys(
+        PERSONAL_DATA_HUB_STREAMING_HANDLERS,
+      )) {
+        routes[streamType] = async () => {
+          const sender = (payload) => server._send(ws, { id, ...payload });
+          try {
+            const out = await PERSONAL_DATA_HUB_STREAMING_HANDLERS[streamType](
+              message,
+              sender,
+            );
+            server._send(ws, {
+              id,
+              type: `${streamType}.end`,
+              ...(out && out.result !== undefined
+                ? { result: out.result }
+                : out || {}),
+            });
+          } catch (err) {
+            server._send(ws, {
+              id,
+              type: "error",
+              code: "PERSONAL_DATA_HUB_STREAM_ERROR",
+              message: err?.message || String(err),
+            });
+          }
+        };
+      }
+
       // Phase I — Hosted Session API (session-core, memory, beta, usage)
       for (const sessionCoreType of Object.keys(SESSION_CORE_HANDLERS)) {
         routes[sessionCoreType] = async () => {

package/src/gateways/ws/personal-data-hub-protocol.js

@@ -0,0 +1,264 @@
+/**
+ * Personal Data Hub — WS protocol handlers.
+ *
+ * Mirrors the 10 IPC channels in
+ * desktop-app-vue/src/main/ipc/personal-data-hub-ipc.js so cc ui / web-shell
+ * users get the same surface. Per memory feedback_cross_shell_feature_pattern,
+ * any hub-facing renderer code can target EITHER:
+ *
+ *   electron: window.electron.invoke("personal-data-hub:ask", {...})
+ *   cc ui:    ws.executeJson({ type: "personal-data-hub.ask", ... })
+ *
+ * Topic names use dot-case here (cc WS convention) vs the colon-style IPC.
+ * The renderer shell-helpers layer reconciles the two so SPA code can be
+ * shell-agnostic.
+ *
+ * Each handler returns { result } or { error }. The dispatcher wraps that
+ * with the standard envelope (id + type) before sending.
+ */
+
+import { getHub } from "../../lib/personal-data-hub-wiring.js";
+
+async function withHub(fn) {
+  try {
+    const hub = await getHub();
+    const result = await fn(hub);
+    return { result };
+  } catch (err) {
+    return { error: err && err.message ? err.message : String(err) };
+  }
+}
+
+export const PERSONAL_DATA_HUB_HANDLERS = {
+  "personal-data-hub.ask": async (msg) =>
+    withHub(async (hub) => {
+      if (!hub.engine) throw new Error("Analysis engine unavailable");
+      return await hub.engine.ask(msg.question, msg.options || {});
+    }),
+
+  "personal-data-hub.stats": async () =>
+    withHub((hub) => ({
+      vault: hub.vault.stats(),
+      adapters: hub.registry.list(),
+      hubDir: hub.hubDir,
+      llm: hub.llm ? { name: hub.llm.name, isLocal: hub.llm.isLocal } : null,
+    })),
+
+  "personal-data-hub.health": async () =>
+    withHub((hub) => ({
+      vault: { ok: !!hub.vault.db, schemaVersion: hub.vault.schemaVersion() },
+      llm: hub.llm
+        ? { ok: true, isLocal: hub.llm.isLocal, name: hub.llm.name }
+        : { ok: false, reason: "LLM unavailable" },
+      kgSink: { ok: !!hub.kgSink },
+      ragSink: { ok: !!hub.ragSink },
+    })),
+
+  "personal-data-hub.list-adapters": async () =>
+    withHub((hub) => hub.registry.list()),
+
+  "personal-data-hub.sync-adapter": async (msg) =>
+    withHub(
+      async (hub) =>
+        await hub.registry.syncAdapter(msg.name, msg.options || {}),
+    ),
+
+  "personal-data-hub.sync-all": async (msg) =>
+    withHub(async (hub) => await hub.registry.syncAll(msg.options || {})),
+
+  "personal-data-hub.register-mock": async (msg) =>
+    withHub((hub) => {
+      const a = hub.registerMockAdapter({
+        name: msg.name || "mock",
+        count: typeof msg.count === "number" ? msg.count : 20,
+        seed: typeof msg.seed === "number" ? msg.seed : 1,
+      });
+      return { name: a.name, version: a.version };
+    }),
+
+  "personal-data-hub.unregister": async (msg) =>
+    withHub((hub) => ({ ok: hub.registry.unregister(msg.name) })),
+
+  "personal-data-hub.query-events": async (msg) =>
+    withHub((hub) =>
+      hub.vault.queryEvents({
+        subtype: msg.subtype,
+        since: msg.since,
+        until: msg.until,
+        actor: msg.actor,
+        adapter: msg.adapter,
+        limit: msg.limit,
+      }),
+    ),
+
+  "personal-data-hub.recent-audit": async (msg) =>
+    withHub((hub) =>
+      hub.vault.queryAudit({
+        since: msg.since,
+        action: msg.action,
+        limit: msg.limit,
+      }),
+    ),
+
+  // ─── Phase 5.6 — email config + event detail ─────────────────────────
+
+  "personal-data-hub.test-email-auth": async (msg) =>
+    withHub(async (hub) => await hub.testEmailAuth({ account: msg.account })),
+
+  "personal-data-hub.register-email": async (msg) =>
+    withHub(
+      async (hub) =>
+        await hub.registerEmailAdapter({
+          account: msg.account,
+          opts: msg.opts || {},
+        }),
+    ),
+
+  "personal-data-hub.unregister-email": async (msg) =>
+    withHub(async (hub) => await hub.unregisterEmailAdapter(msg.email)),
+
+  "personal-data-hub.list-email-accounts": async () =>
+    withHub((hub) => hub.listEmailAccounts()),
+
+  "personal-data-hub.event-detail": async (msg) =>
+    withHub((hub) => hub.eventDetail(msg.eventId)),
+
+  // ─── Phase 6 — Alipay bill import ─────────────────────────────────────
+
+  "personal-data-hub.register-alipay": async (msg) =>
+    withHub(
+      async (hub) =>
+        await hub.registerAlipayAdapter({
+          account: msg.account,
+          opts: msg.opts || {},
+        }),
+    ),
+
+  "personal-data-hub.unregister-alipay": async (msg) =>
+    withHub(async (hub) => await hub.unregisterAlipayAdapter(msg.email)),
+
+  "personal-data-hub.list-alipay-accounts": async () =>
+    withHub((hub) => hub.listAlipayAccounts()),
+
+  "personal-data-hub.import-alipay-bill": async (msg) =>
+    withHub(
+      async (hub) =>
+        await hub.importAlipayBill({
+          zipPath: msg.zipPath,
+          csvPath: msg.csvPath,
+          zipPassword: msg.zipPassword,
+        }),
+    ),
+
+  // ─── Phase 8 — EntityResolver review / merge / unmerge ───────────────
+
+  "personal-data-hub.review-queue-list": async (msg) =>
+    withHub((hub) => hub.vault.listReviewQueue({ limit: msg.limit || 50 })),
+
+  "personal-data-hub.review-decision": async (msg) =>
+    withHub((hub) => {
+      if (!hub.entityResolver) throw new Error("EntityResolver not wired");
+      return hub.entityResolver.applyUserDecision({
+        reviewId: msg.reviewId,
+        decision: msg.decision,
+      });
+    }),
+
+  "personal-data-hub.manual-merge": async (msg) =>
+    withHub((hub) => {
+      if (!hub.entityResolver) throw new Error("EntityResolver not wired");
+      return hub.entityResolver.manualMerge({ aId: msg.aId, bId: msg.bId });
+    }),
+
+  "personal-data-hub.manual-unmerge": async (msg) =>
+    withHub((hub) => {
+      if (!hub.entityResolver) throw new Error("EntityResolver not wired");
+      return hub.entityResolver.manualUnmerge(msg.personId);
+    }),
+
+  "personal-data-hub.resolver-drain": async (msg) =>
+    withHub(async (hub) => {
+      if (!hub.entityResolver) throw new Error("EntityResolver not wired");
+      return await hub.entityResolver.drain({ limit: msg.limit || 50 });
+    }),
+
+  "personal-data-hub.resolver-stats": async () =>
+    withHub((hub) => ({
+      queue: hub.vault.resolveQueueStats(),
+      mergeGroups: hub.vault.stats().mergeGroups,
+      reviewQueue:
+        hub.vault.listReviewQueue({ limit: 1 }).length > 0
+          ? hub.vault.listReviewQueue({ limit: 1000 }).length
+          : 0,
+    })),
+
+  "personal-data-hub.merge-group-members": async (msg) =>
+    withHub((hub) => hub.vault.getMergeGroupMembers(msg.personId)),
+};
+
+/**
+ * Phase 5.7 — streaming handlers. Same call pattern as session-core
+ * streaming: handler receives `sender(payload)` to push intermediate
+ * `{ type: "personal-data-hub.<topic>.event", ... }` messages while
+ * sync is in flight, then the dispatcher wraps the final return with
+ * `.end`. Adapter progress phases (connecting / fetching / done / error)
+ * surface here; UI subscribes via the composable.
+ */
+export const PERSONAL_DATA_HUB_STREAMING_HANDLERS = {
+  "personal-data-hub.sync-adapter-stream": async (msg, sender) => {
+    const hub = await getHub();
+    const original = hub.registry.onSyncEvent;
+    hub.registry.onSyncEvent = (evt) => {
+      try {
+        sender({
+          type: "personal-data-hub.sync-adapter-stream.event",
+          event: evt,
+        });
+      } catch (_e) {}
+      if (typeof original === "function") {
+        try {
+          original(evt);
+        } catch (_e) {}
+      }
+    };
+    try {
+      const report = await hub.registry.syncAdapter(
+        msg.name,
+        msg.options || {},
+      );
+      return { result: report };
+    } finally {
+      hub.registry.onSyncEvent = original;
+    }
+  },
+
+  "personal-data-hub.sync-all-stream": async (msg, sender) => {
+    const hub = await getHub();
+    const original = hub.registry.onSyncEvent;
+    hub.registry.onSyncEvent = (evt) => {
+      try {
+        sender({ type: "personal-data-hub.sync-all-stream.event", event: evt });
+      } catch (_e) {}
+      if (typeof original === "function") {
+        try {
+          original(evt);
+        } catch (_e) {}
+      }
+    };
+    try {
+      const reports = await hub.registry.syncAll(msg.options || {});
+      return { result: reports };
+    } finally {
+      hub.registry.onSyncEvent = original;
+    }
+  },
+};
+
+/**
+ * Topic names this protocol owns — exported so the dispatcher can list /
+ * advertise them to clients via a capabilities probe.
+ */
+export const PERSONAL_DATA_HUB_TOPICS = Object.freeze([
+  ...Object.keys(PERSONAL_DATA_HUB_HANDLERS),
+  ...Object.keys(PERSONAL_DATA_HUB_STREAMING_HANDLERS),
+]);