shennian 0.3.42 → 0.3.44

package/dist/src/session/handlers/title.js

@@ -1 +1 @@
-import{createAgent as l}from"../../agents/adapter.js";import{buildManagedAgentEnv as y}from"../../agents/config-status.js";function a(e){return typeof e=="string"?e.trim():""}async function u(e,t){const n=t.params,r=a(n.sessionId),d=a(n.title),i=a(n.agentSessionId),p=a(n.agentType),c=a(n.workDir)||process.cwd();if(!r||!d){e.client.sendRes({type:"res",id:t.id,ok:!1,error:"sessionId and title are required"});return}if(p!=="codex"||!i){e.client.sendRes({type:"res",id:t.id,ok:!0,payload:{skipped:!0}});return}const s=e.sessions.get(r);if(s?.agentType==="codex"&&s.adapter.setTitle){await s.adapter.setTitle(i,d,s.workDir||c),s.agentSessionId=i,s.lastActiveAt=Date.now(),e.client.sendRes({type:"res",id:t.id,ok:!0,payload:{synced:!0}});return}const o=l("codex");if(!o?.setTitle){e.client.sendRes({type:"res",id:t.id,ok:!1,error:"Codex adapter does not support title sync"});return}o.configure?.({sessionId:r,env:y("codex")});try{await o.start(r,c,i),await o.setTitle(i,d,c),e.client.sendRes({type:"res",id:t.id,ok:!0,payload:{synced:!0}})}finally{await o.stop().catch(()=>{})}}export{u as handleSessionTitleSet};
+import{createAgent as y}from"../../agents/adapter.js";import{buildManagedAgentEnv as g}from"../../agents/config-status.js";import{recordSession as f}from"../store.js";import{requestSessionIndexPublish as S}from"../index-publisher.js";function o(e){return typeof e=="string"?e.trim():""}async function w(e,i){const t=i.params,r=o(t.sessionId),d=o(t.title),n=o(t.agentSessionId),c=o(t.agentType),l=o(t.workDir)||process.cwd(),u=o(t.titleOriginEventId),p=t.titleRevision;if(!r||!d||!c||t.titleSource!=="shennian_manual"||!Number.isSafeInteger(p)||Number(p)<1||!u){e.client.sendRes({type:"res",id:i.id,ok:!1,error:"explicit shennian_manual title authority is required"});return}if(f({sessionId:r,agentType:c,workDir:l,agentSessionId:n||null,title:d,titleSource:"shennian_manual",titleRevision:Number(p),titleLockedByUser:!0,titleOriginEventId:u}),S(e.client),c!=="codex"||!n){e.client.sendRes({type:"res",id:i.id,ok:!0,payload:{localApplied:!0,nativeWriteback:"unsupported"}});return}const s=e.sessions.get(r);if(s?.agentType==="codex"&&s.adapter.setTitle){await s.adapter.setTitle(n,d,s.workDir||l),s.agentSessionId=n,s.lastActiveAt=Date.now(),e.client.sendRes({type:"res",id:i.id,ok:!0,payload:{synced:!0}});return}const a=y("codex");if(!a?.setTitle){e.client.sendRes({type:"res",id:i.id,ok:!1,error:"Codex adapter does not support title sync"});return}a.configure?.({sessionId:r,env:g("codex")});try{await a.start(r,l,n),await a.setTitle(n,d,l),e.client.sendRes({type:"res",id:i.id,ok:!0,payload:{synced:!0}})}finally{await a.stop().catch(()=>{})}}export{w as handleSessionTitleSet};

package/dist/src/session/handlers/tool-detail.js

@@ -1 +1 @@
-import{isSystemControlPayload as h}from"@shennian/wire";import{readMessages as x}from"../store.js";const q=2e3,D=8e3,C=/(?:token|api[-_]?key|password|passwd|pwd|secret|authorization|cookie|credential|private[-_]?key)/i,M=/\b([A-Z0-9_]*(?:TOKEN|KEY|SECRET|PASSWORD|PASSWD|PWD|AUTH)[A-Z0-9_]*)=("[^"]*"|'[^']*'|[^\s]+)/gi,N=/\bBearer\s+[A-Za-z0-9._~+/=-]+/gi,k=/\bsk-[A-Za-z0-9_-]{12,}\b/g;function R(e){return e&&typeof e=="object"&&!Array.isArray(e)?e:null}function l(e){if(!e)return null;if(typeof e=="string")try{return l(JSON.parse(e))}catch{return null}const t=R(e);if(!t)return null;const n=typeof t.runId=="string"?t.runId:void 0,r=typeof t.sourceSeq=="number"?t.sourceSeq:typeof t.seq=="number"?t.seq:void 0,s=typeof t.toolIndex=="number"?t.toolIndex:void 0;return{...n?{runId:n}:{},...r!=null?{sourceSeq:r}:{},...s!=null?{toolIndex:s}:{}}}function f(e){return/^agent-(.+)-\d+$/.exec(e)?.[1]??null}function m(e){const t=/^agent-.+-(\d+)$/.exec(e);return t?Number(t[1]):null}function E(e){const t=typeof e=="number"?e:Number(e);return!Number.isFinite(t)||t<=0?q:Math.min(Math.max(200,Math.floor(t)),D)}function d(e,t){if(h(e))return"[SYSTEM CONTEXT REDACTED]";const n=e.replace(M,"$1=[REDACTED]").replace(N,"Bearer [REDACTED]").replace(k,"sk-[REDACTED]");return n.length>t?`${n.slice(0,t)}\u2026`:n}function p(e,t,n=0){if(e==null)return e;if(typeof e=="string")return d(e,t);if(typeof e=="number"||typeof e=="boolean")return e;if(n>=4)return"[Truncated]";if(Array.isArray(e))return e.slice(0,20).map(r=>p(r,t,n+1));if(typeof e=="object"){const r={};for(const[s,o]of Object.entries(e).slice(0,50)){if(C.test(s)){r[s]="[REDACTED]";continue}r[s]=p(o,t,n+1)}return r}return String(e)}function O(e,t){const r=R(e)?.command;if(typeof r=="string")return d(r,t);if(Array.isArray(r)){const s=r.map(o=>String(o)).join(" ");return d(s,t)}}function A(e){const t=x(e),n=[];for(const r of t)if(!(r.role!=="agent"||!r.payload.trim().startsWith("{")))try{const s=JSON.parse(r.payload),o=s.type;if(o!=="tool"&&o!=="tool_use"&&o!=="tool_result")continue;const i=typeof s.name=="string"&&s.name.trim()?s.name.trim():"tool";n.push({id:r.id,ts:r.ts,name:i,args:s.args,result:s.result,status:o==="tool_result"||Object.prototype.hasOwnProperty.call(s,"result")?"completed":s.status==="completed"||s.status==="failed"||s.status==="running"?s.status:"running",detailRef:l(s.detailRef)})}catch{}return n}function w(e,t,n){let r=0;e.id===t.messageId&&(r+=100),t.name&&e.name===t.name&&(r+=20);const s=n?.runId??t.runId??f(t.messageId),o=n?.sourceSeq??t.sourceSeq??m(t.messageId)??void 0;return s&&(e.detailRef?.runId??f(e.id))===s&&(r+=20),o!=null&&(e.detailRef?.sourceSeq??m(e.id))===o&&(r+=80),e.args!=null&&(r+=5),r}function P(e){const t=l(e.detailRef)??l({runId:e.runId,sourceSeq:e.sourceSeq,toolIndex:e.toolIndex}),n=A(e.sessionId);return n.length===0?null:n.map(s=>({candidate:s,score:w(s,e,t)})).filter(s=>s.score>0).sort((s,o)=>o.score-s.score||o.candidate.ts-s.candidate.ts)[0]?.candidate??null}function b(e){return e.detailRef?.runId??f(e.id)}function I(e){return e.detailRef?.sourceSeq??m(e.id)}function F(e,t,n){if(n.result!=null)return n;const r=b(n)??t.runId??f(t.messageId),s=I(n)??t.sourceSeq??m(t.messageId);return A(e).filter(o=>{if(o.id===n.id||o.name!==n.name||o.result==null||r&&b(o)!==r)return!1;const i=I(o);return s!=null&&i!=null?i>=s:o.ts>=n.ts}).sort((o,i)=>{const u=I(o),a=I(i);return s!=null&&u!=null&&a!=null?Math.abs(u-s)-Math.abs(a-s):o.ts-i.ts})[0]??null}async function K(e,t){const n=t.params,r=typeof n.sessionId=="string"?n.sessionId:"",s=typeof n.messageId=="string"?n.messageId:"";if(!r||!s){e.client.sendRes({type:"res",id:t.id,ok:!1,error:"sessionId and messageId are required"});return}const o={sessionId:r,messageId:s,...typeof n.name=="string"?{name:n.name}:{},...typeof n.toolIndex=="number"?{toolIndex:n.toolIndex}:{},...typeof n.runId=="string"?{runId:n.runId}:{},...typeof n.sourceSeq=="number"?{sourceSeq:n.sourceSeq}:{},...n.detailRef!==void 0?{detailRef:n.detailRef}:{},maxChars:E(n.maxChars)},i=E(o.maxChars),u=P(o);if(!u||u.args==null&&u.result==null){const T={detailStatus:"not_found",messageId:s,toolIndex:o.toolIndex??0,name:o.name,resultOmitted:!0,source:"unavailable",reason:"tool detail is not available on this machine"};e.client.sendRes({type:"res",id:t.id,ok:!0,payload:T});return}const a=u.args==null?void 0:p(u.args,i),S=O(u.args,i),g=F(r,o,u),c=g?.result??u.result,y=typeof c=="string"?d(c,i):c==null?void 0:d(JSON.stringify(p(c,i)),i),_={detailStatus:"available",messageId:s,toolIndex:o.toolIndex??0,name:u.name,status:g?.status??u.status,...a!==void 0?{argsSummary:a}:{},...S?{command:S}:{},...y!==void 0?{result:y}:{},resultOmitted:y===void 0,source:"local-session-store"};e.client.sendRes({type:"res",id:t.id,ok:!0,payload:_})}export{K as handleSessionToolDetail};
+import{isSystemControlPayload as I,SESSION_TOOL_DETAIL_LIMITS as l}from"@shennian/wire";import{readToolDetail as g}from"../tool-detail-store.js";const A=/(?:token|api[-_]?key|password|passwd|pwd|secret|authorization|cookie|credential|private[-_]?key)/i,_=/\b([A-Z0-9_]*(?:TOKEN|KEY|SECRET|PASSWORD|PASSWD|PWD|AUTH)[A-Z0-9_]*)=("[^"]*"|'[^']*'|[^\s]+)/gi,T=/\bBearer\s+[A-Za-z0-9._~+/=-]+/gi,D=/\bsk-[A-Za-z0-9_-]{12,}\b/g;function O(e){return e&&typeof e=="object"&&!Array.isArray(e)?e:null}function M(e){const n=typeof e=="number"?e:Number(e);return!Number.isFinite(n)||n<=0?l.defaultMaxBytes:Math.min(Math.max(l.minMaxBytes,Math.floor(n)),l.maxMaxBytes)}function u(e,n){if(I(e))return"[SYSTEM CONTEXT REDACTED]";const t=e.replace(_,"$1=[REDACTED]").replace(T,"Bearer [REDACTED]").replace(D,"sk-[REDACTED]");return t.length>n?`${t.slice(0,n)}\u2026`:t}function f(e,n,t=0){if(e==null)return e;if(typeof e=="string")return u(e,n);if(typeof e=="number"||typeof e=="boolean")return e;if(t>=4)return"[Truncated]";if(Array.isArray(e))return e.slice(0,20).map(r=>f(r,n,t+1));if(typeof e=="object"){const r={};for(const[o,a]of Object.entries(e).slice(0,50))r[o]=A.test(o)?"[REDACTED]":f(a,n,t+1);return r}return String(e)}function z(e,n){const t=O(e)?.command;if(typeof t=="string")return u(t,n);if(Array.isArray(t))return u(t.map(String).join(" "),n)}function N(e){return Buffer.byteLength(JSON.stringify(e),"utf8")}function p(e){for(let n=0;n<3;n++){const t=N(e);if(t===e.byteSize)break;e.byteSize=t}return e}function E(e,n){const t={sessionId:e.sessionId,toolCallId:e.toolCallId,detailRevision:e.detailRevision,detailStatus:n==="not_found"?"not_found":"unavailable",resultOmitted:!0,redacted:!0,byteSize:0,expiresAt:new Date(Date.now()+l.responseTtlMs).toISOString(),source:"unavailable",reason:n};return p(t)}async function C(e,n){const t=n.params,r=typeof t.sessionId=="string"?t.sessionId:"",o=typeof t.toolCallId=="string"?t.toolCallId:"",a=typeof t.detailRevision=="number"&&Number.isSafeInteger(t.detailRevision)?t.detailRevision:-1;if(!r||!o||a<0){e.client.sendRes({type:"res",id:n.id,ok:!1,error:"upgrade_required: sessionId, toolCallId and detailRevision are required"});return}const c=M(t.maxBytes),y={sessionId:r,toolCallId:o,detailRevision:a,maxBytes:c},i=g(r,o);if(!i){e.client.sendRes({type:"res",id:n.id,ok:!0,payload:E(y,"not_found")});return}if(i.detailRevision!==a){e.client.sendRes({type:"res",id:n.id,ok:!0,payload:E(y,"revision_mismatch")});return}const d=Math.max(512,Math.floor(c/4)),m=i.args==null?void 0:f(i.args,d),b=z(i.args,d),S=typeof i.result=="string"?u(i.result,d):i.result==null?void 0:u(JSON.stringify(f(i.result,d)),d),R=new Date(Date.now()+l.responseTtlMs).toISOString();let s={sessionId:r,toolCallId:o,detailRevision:a,detailStatus:"available",status:i.status,...b?{command:b}:{},...m!==void 0?{argsSummary:m}:{},...S!==void 0?{result:S}:{},resultOmitted:S===void 0,redacted:!0,byteSize:0,expiresAt:R,source:"local-tool-index"};p(s),s.byteSize>c&&(delete s.result,s.resultOmitted=!0,p(s)),s.byteSize>c&&(s=E(y,"response_too_large")),e.client.sendRes({type:"res",id:n.id,ok:!0,payload:s})}export{C as handleSessionToolDetail};

package/dist/src/session/handlers/voice-window.d.ts

@@ -0,0 +1,3 @@
+import { type ReqFrame } from '@shennian/wire';
+import type { SessionManagerRuntime } from '../types.js';
+export declare function handleVoiceSessionBodyWindow(runtime: SessionManagerRuntime, req: ReqFrame): void;

package/dist/src/session/handlers/voice-window.js

@@ -0,0 +1 @@
+import{extractPayloadText as m,isAgentHiddenPayload as h,isSystemControlPayload as g,isToolPayload as p}from"@shennian/wire";import{getCanonicalSessionStore as I}from"../store.js";const S=8,y=32*1024;function M(e,i){const t=i.params;if(!t?.sessionId?.trim()||!t.callId?.trim())throw new Error("sessionId and callId are required");const d=u(t.limit,4,S),l=u(t.maxBytes,y,y),o=I().readRecent(t.sessionId,Math.min(d*6,48)),s=o.messages.filter(b),n=[];let c=0;for(let r=s.length-1;r>=0&&n.length<d;r-=1){const f=s[r],a=Buffer.byteLength(JSON.stringify(f),"utf8");if(n.length>0&&c+a>l)break;a>l||(n.push(f),c+=a)}n.reverse(),e.client.sendRes({type:"res",id:i.id,ok:!0,payload:{sessionId:t.sessionId,callId:t.callId,bodyRevision:o.bodyRevision,messages:n,truncated:o.hasOlder||n.length<s.length}})}function b(e){return e.role!=="user"&&e.role!=="agent"||p(e.payload)||g(e.payload)||h(e.payload)?!1:m(e.payload).trim().length>0}function u(e,i,t){if(e===void 0)return i;if(!Number.isSafeInteger(e)||e<1)throw new Error("invalid voice window limit");return Math.min(e,t)}export{M as handleVoiceSessionBodyWindow};

package/dist/src/session/history-subscriptions.d.ts

@@ -0,0 +1,17 @@
+import { type ReqFrame } from '@shennian/wire';
+import type { CliRelayClient } from '../relay/client.js';
+import type { CanonicalSessionStore } from './canonical-store.js';
+export declare class PersonalHistorySubscriptions {
+    private client;
+    private store;
+    private subscriptions;
+    private unsubscribeStore;
+    constructor(client: Pick<CliRelayClient, 'sendRes' | 'sendEvent'>, store?: CanonicalSessionStore);
+    handleOpen(req: ReqFrame): void;
+    handlePage(req: ReqFrame): void;
+    handleClose(req: ReqFrame): void;
+    closeAll(): void;
+    private handleMutation;
+    private publishMutation;
+    private requireSubscription;
+}

package/dist/src/session/history-subscriptions.js

@@ -0,0 +1 @@
+import{SESSION_HISTORY_LIMITS as r}from"@shennian/wire";import{getCanonicalSessionStore as u}from"./store.js";class b{client;store;subscriptions=new Map;unsubscribeStore;constructor(i,s=u()){this.client=i,this.store=s,this.unsubscribeStore=s.subscribe(o=>this.handleMutation(o))}handleOpen(i){const s=i.params;if(a(s.sessionId,s.subscriptionId),this.subscriptions.has(s.subscriptionId))throw new Error("subscription already exists");if([...this.subscriptions.values()].filter(t=>t.sessionId===s.sessionId).length>=r.maxSubscriptionsPerSession)throw new Error("subscription_limit_exceeded");const e={sessionId:s.sessionId,subscriptionId:s.subscriptionId,snapshotRevision:0,lastSentRevision:0,active:!1,buffered:[]};this.subscriptions.set(s.subscriptionId,e);try{const t=this.store.readPage(s.sessionId,{limit:d(s.limit,r.defaultSnapshotMessages),...s.beforeSequence===void 0?{}:{beforeSequence:s.beforeSequence}});e.snapshotRevision=t.bodyRevision,e.lastSentRevision=t.bodyRevision,this.client.sendRes({type:"res",id:i.id,ok:!0,payload:{sessionId:s.sessionId,subscriptionId:s.subscriptionId,storageMode:"machine_local",snapshotRevision:t.bodyRevision,firstAvailableSeq:t.firstAvailableSeq,lastAvailableSeq:t.lastAvailableSeq,hasOlder:t.hasOlder,messages:t.entries}}),e.active=!0;for(const c of e.buffered)this.publishMutation(e,c);e.buffered=[]}catch(t){throw this.subscriptions.delete(s.subscriptionId),t}}handlePage(i){const s=i.params,o=this.requireSubscription(s.sessionId,s.subscriptionId);let e;try{e=this.store.readPageAtRevision(s.sessionId,{beforeSequence:s.beforeSequence,limit:d(s.limit,r.defaultPageMessages),revision:o.snapshotRevision})}catch{throw new Error("snapshot_compacted")}this.client.sendRes({type:"res",id:i.id,ok:!0,payload:{sessionId:s.sessionId,subscriptionId:s.subscriptionId,snapshotRevision:o.snapshotRevision,firstAvailableSeq:e.firstAvailableSeq,hasOlder:e.hasOlder,messages:e.entries}})}handleClose(i){const s=i.params;a(s.sessionId,s.subscriptionId),this.subscriptions.get(s.subscriptionId)?.sessionId===s.sessionId&&this.subscriptions.delete(s.subscriptionId),this.client.sendRes({type:"res",id:i.id,ok:!0,payload:{sessionId:s.sessionId,subscriptionId:s.subscriptionId,closed:!0}})}closeAll(){this.subscriptions.clear(),this.unsubscribeStore()}handleMutation(i){for(const s of this.subscriptions.values())s.sessionId===i.sessionId&&(s.active?this.publishMutation(s,i):s.buffered.push(i))}publishMutation(i,s){s.revision<=i.lastSentRevision||(this.client.sendEvent({type:"event",event:"session.body.delta",payload:{sessionId:i.sessionId,subscriptionId:i.subscriptionId,fromRevision:i.lastSentRevision,toRevision:s.revision,mutations:[{...s,subscriptionId:i.subscriptionId}]}}),i.lastSentRevision=s.revision)}requireSubscription(i,s){a(i,s);const o=this.subscriptions.get(s);if(!o||o.sessionId!==i)throw new Error("subscription_not_found");return o}}function a(n,i){if(typeof n!="string"||!n||typeof i!="string"||!i)throw new Error("invalid history subscription identity")}function d(n,i){const s=n??i;if(!Number.isSafeInteger(s)||s<1||s>r.maxPageMessages)throw new Error("invalid history limit");return s}export{b as PersonalHistorySubscriptions};

package/dist/src/session/index-publisher.d.ts

@@ -0,0 +1,3 @@
+import type { CliRelayClient } from '../relay/client.js';
+export declare function publishPendingSessionIndexes(client: Pick<CliRelayClient, 'sendBufferedEvent'>): Promise<void>;
+export declare function requestSessionIndexPublish(client: Pick<CliRelayClient, 'sendBufferedEvent'>): void;

package/dist/src/session/index-publisher.js

@@ -0,0 +1 @@
+import{acknowledgeSessionIndexUpdate as d,listPendingSessionIndexUpdates as r}from"./store.js";const i=new WeakMap,t=new WeakSet;function a(s){const e=s,n=i.get(e);if(n)return t.add(e),n;const o=c(s).finally(()=>{i.get(e)===o&&i.delete(e),t.delete(e)&&f(s)});return i.set(e,o),o}async function c(s){const e=r();for(const n of e)await s.sendBufferedEvent({type:"event",event:"session.index.updated",id:`session-index-${n.daemonInstallationId}-${n.session.id}-${n.session.indexRevision}`,payload:n},6e4),d(n.session.id,n.session.indexRevision)}function f(s){a(s).catch(e=>{console.error("[session-index] sync failed; dirty revisions retained for retry",e)})}export{a as publishPendingSessionIndexes,f as requestSessionIndexPublish};

package/dist/src/session/manager.d.ts

@@ -27,7 +27,9 @@ export declare class SessionManager {
     private pendingTransfers;
     private managerRuntime;
     private chatQueue;
+    private historySubscriptions;
     private activityProbeTimer;
+    private attachmentCleanupTimer;
     private activeRequests;
     constructor(client: CliRelayClient, nativeFusion?: NativeSessionFusionService | null, cliVersion?: string | undefined, upgradePolicyController?: UpgradePolicyController | null, managedRoomBinder?: ManagedRoomBinder | null);
     private getRuntime;

package/dist/src/session/manager.js

@@ -1 +1 @@
-import u from"node:crypto";import{getRegisteredAgents as m,unregisterAgent as p}from"../agents/adapter.js";import{loadConfig as f}from"../config/index.js";import{handleUpgradeStart as g,handleUpgradeStatus as b}from"../commands/upgrade.js";import{handleAgentsRefresh as w,handleModelsRefresh as v}from"./handlers/agents.js";import{handleAgentCapabilitiesList as k}from"./handlers/agent-capabilities.js";import{handleAgentConfigClear as R,handleAgentConfigGet as y,handleAgentConfigTest as S,handleAgentConfigUpsert as A}from"./handlers/agent-config.js";import{handleChatAbort as c,handleChatSend as l}from"./handlers/chat.js";import{handleSessionRefresh as I}from"./handlers/session-refresh.js";import{handleSessionToolDetail as T}from"./handlers/tool-detail.js";import{handleSessionTitleSet as P}from"./handlers/title.js";import{cleanupPendingTransfers as C,handleFsLs as M,handleFsRead as F,handleFsRename as x,handleFsWrite as D,handleFsTransfer as E,handleFsTransferAbort as Q,handleFsTransferChunk as z,handleFsTransferFinish as U,handleFsTransferStart as W,handleFsExportMarkdownPdf as _,handleFsExportMarkdownPdfSetup as O,handleFsArchiveZip as V}from"./handlers/fs.js";import{handleRegionProbe as B,handleRegionSwitch as $,handleUpgradeSetPolicy as j}from"./handlers/control.js";import{ManagerRuntimeService as L,setManagerRuntimeService as h}from"../manager/runtime.js";import{ChatQueueManager as G}from"./queue.js";import{createAuthorizedFsRoot as N,resolveAuthorizedPath as X,resolveSessionWorkDir as Z}from"../fs/boundary.js";import"../agents/claude.js";import"../agents/codex.js";import"../agents/workbuddy.js";import"../agents/gemini.js";import"../agents/cursor.js";import"../agents/opencode.js";import"../agents/manager.js";import{registerCustomAgent as H}from"../agents/custom.js";import{handleManagedRoomBind as J,handleManagedRoomRestart as K}from"./handlers/room-managed.js";import{listSessionRecords as Y}from"./store.js";const q=50;import{resolveSessionWorkDir as Fe}from"../fs/boundary.js";class Pe{client;nativeFusion;cliVersion;upgradePolicyController;managedRoomBinder;sessions=new Map;processedReqIds=new Set;runTextAcc=new Map;pendingTransfers=new Map;managerRuntime;chatQueue;activityProbeTimer=null;activeRequests=0;constructor(e,t=null,a,i=null,n=null){this.client=e,this.nativeFusion=t,this.cliVersion=a,this.upgradePolicyController=i,this.managedRoomBinder=n,this.managerRuntime=new L({getRuntime:()=>this.getRuntime(),dispatchReq:s=>this.handleReq(s)}),this.chatQueue=new G({getRuntime:()=>this.getRuntime(),dispatchReq:s=>this.handleReq(s)}),h(this.managerRuntime),this.managerRuntime.start(),this.reloadCustomAgents(),this.activityProbeTimer=setInterval(()=>{this.publishManagedActivitySnapshots().catch(s=>{console.error("[session.activity] managed probe failed",s)})},15e3),this.activityProbeTimer.unref?.()}getRuntime(){return{client:this.client,pendingTransfers:this.pendingTransfers,processedReqIds:this.processedReqIds,reloadCustomAgents:()=>this.reloadCustomAgents(),resolvePath:e=>this.resolvePath(e),resolveAuthorizedPath:(e,t)=>this.resolveAuthorizedPath(e,t),runTextAcc:this.runTextAcc,sessions:this.sessions,evictIdleSessions:()=>this.evictIdleSessions(),nativeFusion:this.nativeFusion,managerRuntime:this.managerRuntime,chatQueue:this.chatQueue,activityPublisher:{publish:(e,t)=>this.publishSessionActivity(e,t)},upgradePolicyController:this.upgradePolicyController}}getUpgradeIdleState(){const e=[];return[...this.sessions.values()].some(t=>t.currentRunId!==null)&&e.push("active-agent-turn"),this.pendingTransfers.size>0&&e.push("file-transfer"),this.activeRequests>0&&e.push("active-daemon-request"),{idle:e.length===0,reasons:e}}async activateRoomSession(e){const t=Y().find(s=>s.sessionId===e.sessionId),a=t?.agentType===e.agentType?t.modelId??void 0:void 0,i={value:null},n=new Proxy(this.client,{get:(s,o)=>{if(o==="sendRes")return d=>{i.value=d};const r=Reflect.get(s,o,s);return typeof r=="function"?r.bind(s):r}});return await l({...this.getRuntime(),client:n},{type:"req",id:e.clientMessageId,method:"chat.send",params:{...e,modelId:a,sessionMode:t?.sessionMode??(t?.agentType==="manager"?"manager":"standard"),managerConfig:t?.managerConfig??null,managerDefaultWorkerAgentType:t?.managerDefaultWorkerAgentType??null,managerDefaultWorkerModelId:t?.managerDefaultWorkerModelId??null,waitForDispatch:!0,suppressExternalOwnerEcho:!0}},{source:"room_activation"}),{externalOwnerQueued:i.value?.ok===!0&&i.value.payload?.deliveryMode==="external_owner_queue"}}async abortRoomSession(e){const t=new Proxy(this.client,{get:(a,i)=>{if(i==="sendRes")return()=>{};const n=Reflect.get(a,i,a);return typeof n=="function"?n.bind(a):n}});await c({...this.getRuntime(),client:t},{type:"req",id:`room-activation-abort-${u.randomUUID()}`,method:"chat.abort",params:{sessionId:e.sessionId}})}publishSessionActivity(e,t){this.client.sendEvent({type:"event",event:"session.activity",payload:{sessionId:e,activity:t}})}async publishManagedActivitySnapshots(){for(const[e,t]of this.sessions.entries()){if(t.heartbeatTimer||!t.currentRunId||!t.adapter.getStatus)continue;const a=await t.adapter.getStatus().catch(()=>null);if(!a?.active||!a.runPhase)continue;const i=new Date().toISOString();this.publishSessionActivity(e,{sessionId:e,runId:a.runId||t.currentRunId,runPhase:a.runPhase,startedAt:new Date(t.lastActiveAt).toISOString(),updatedAt:i,canStop:a.canStop??!0});const n=t.heartbeatSeq++;this.client.sendAgentEvent({type:"event",event:"agent",payload:{state:"heartbeat",sessionId:e,runId:a.runId||t.currentRunId,seq:n,runPhase:a.runPhase,canStop:a.canStop??!0},seq:n,id:`agent-status-${a.runId||t.currentRunId}-${Date.now()}`})}}reloadCustomAgents(){for(const t of m())t.startsWith("custom:")&&p(t);const e=f();for(const[t,a]of Object.entries(e.customAgents??{}))H(t,a)}async handleReq(e){const t=this.getRuntime();this.activeRequests++;try{switch(e.method){case"chat.send":await l(t,e);break;case"chat.enqueue":await this.chatQueue.handleEnqueue(e);break;case"chat.queue.get":await this.chatQueue.handleGet(e);break;case"chat.queue.edit":await this.chatQueue.handleEdit(e);break;case"chat.queue.delete":await this.chatQueue.handleDelete(e);break;case"chat.abort":await c(t,e);break;case"session.refresh":await I(t,e);break;case"session.tool.detail":await T(t,e);break;case"session.title.set":await P(t,e);break;case"room.agent.bind-managed":await J(t,this.managedRoomBinder,e);break;case"room.agent.restart-managed":await K(t,this.managedRoomBinder,e);break;case"fs.ls":await M(t,e);break;case"fs.read":await F(t,e);break;case"fs.write":await D(t,e);break;case"fs.export.markdown-pdf":await _(t,e);break;case"fs.export.markdown-pdf.setup":await O(t,e);break;case"fs.archive.zip":await V(t,e);break;case"fs.rename":await x(t,e);break;case"fs.transfer":await E(t,e);break;case"fs.transfer.start":await W(t,e);break;case"fs.transfer.chunk":await z(t,e);break;case"fs.transfer.finish":await U(t,e);break;case"fs.transfer.abort":await Q(t,e);break;case"region.probe":await B(t,e);break;case"region.switch":await $(t,e);break;case"upgrade.start":await g(this.client,e.id,e.params.version,{currentVersion:this.cliVersion,confirmedMajor:e.params.confirmedMajor===!0});break;case"upgrade.status":await b(this.client,e.id,{currentVersion:this.cliVersion});break;case"upgrade.set-policy":await j(t,e);break;case"agents.refresh":await w(t,e);break;case"models.refresh":await v(t,e);break;case"agent.config.get":await y(t,e);break;case"agent.config.upsert":await A(t,e);break;case"agent.config.clear":await R(t,e);break;case"agent.config.test":await S(t,e);break;case"agent.capabilities.list":await k(t,e);break;case"skill.list":case"skill.install":case"skill.doctor":case"skill.setup":case"skill.use":this.client.sendRes({type:"res",id:e.id,ok:!1,error:"feature_retired"});break;case"session.wechat-rpa.channel.get":case"session.wechat-rpa.channel.upsert":case"session.wechat-rpa.channel.sync":case"manager.wechat-rpa.channel.get":case"manager.wechat-rpa.channel.upsert":case"manager.wechat-rpa.channel.sync":this.client.sendRes({type:"res",id:e.id,ok:!1,error:"feature_retired"});break;default:this.client.sendRes({type:"res",id:e.id,ok:!1,error:`Unknown method: ${e.method}`})}}catch(a){this.client.sendRes({type:"res",id:e.id,ok:!1,error:a instanceof Error?a.message:String(a)})}finally{this.activeRequests--}}evictIdleSessions(){if(this.sessions.size<q)return;let e=null;for(const[t,a]of this.sessions)(!e||a.lastActiveAt<e.session.lastActiveAt)&&(e={key:t,session:a});e&&(e.session.heartbeatTimer&&(clearInterval(e.session.heartbeatTimer),e.session.heartbeatTimer=null),e.session.adapter.removeAllListeners(),e.session.adapter.stop().catch(()=>{}),this.sessions.delete(e.key))}resolvePath(e){return Z(e)}resolveAuthorizedPath(e,t){return X(e,N(t))}async cleanup(){this.activityProbeTimer&&(clearInterval(this.activityProbeTimer),this.activityProbeTimer=null);for(const[,e]of this.sessions)e.heartbeatTimer&&(clearInterval(e.heartbeatTimer),e.heartbeatTimer=null),await e.adapter.stop().catch(()=>{});this.sessions.clear(),this.runTextAcc.clear(),C(this.getRuntime()),await this.managerRuntime.stop(),h(null)}}export{Pe as SessionManager,Fe as resolveSessionWorkDir};
+import m from"node:crypto";import{getRegisteredAgents as p,unregisterAgent as f}from"../agents/adapter.js";import{loadConfig as g}from"../config/index.js";import{handleUpgradeStart as b,handleUpgradeStatus as w}from"../commands/upgrade.js";import{handleAgentsRefresh as v,handleModelsRefresh as k}from"./handlers/agents.js";import{handleAgentCapabilitiesList as y}from"./handlers/agent-capabilities.js";import{handleAgentConfigClear as R,handleAgentConfigGet as S,handleAgentConfigTest as A,handleAgentConfigUpsert as T}from"./handlers/agent-config.js";import{handleChatAbort as c,handleChatSend as l}from"./handlers/chat.js";import{handleSessionRefresh as I}from"./handlers/session-refresh.js";import{handleSessionToolDetail as P}from"./handlers/tool-detail.js";import{handleSessionTitleSet as C}from"./handlers/title.js";import{handleSessionMessageStatus as M}from"./handlers/message-status.js";import{handleVoiceSessionBodyWindow as F}from"./handlers/voice-window.js";import{cleanupPendingTransfers as D,handleFsLs as x,handleFsRead as E,handleFsRename as Q,handleFsWrite as W,handleFsTransferAbort as _,handleFsTransferChunk as z,handleFsTransferFinish as U,handleFsTransferStart as O,handleFsExportMarkdownPdf as V,handleFsExportMarkdownPdfSetup as B,handleFsArchiveZip as $}from"./handlers/fs.js";import{handleRegionProbe as j,handleRegionSwitch as L,handleUpgradeSetPolicy as G}from"./handlers/control.js";import{ManagerRuntimeService as H,setManagerRuntimeService as h}from"../manager/runtime.js";import{ChatQueueManager as N}from"./queue.js";import{createAuthorizedFsRoot as X,resolveAuthorizedPath as Z,resolveSessionWorkDir as J}from"../fs/boundary.js";import"../agents/claude.js";import"../agents/codex.js";import"../agents/workbuddy.js";import"../agents/gemini.js";import"../agents/cursor.js";import"../agents/opencode.js";import"../agents/manager.js";import{registerCustomAgent as K}from"../agents/custom.js";import{handleManagedRoomBind as Y,handleManagedRoomRestart as q}from"./handlers/room-managed.js";import{listSessionRecords as d}from"./store.js";import{PersonalHistorySubscriptions as ee}from"./history-subscriptions.js";import{sweepAttachmentTransfers as te}from"./attachment-transfer-store.js";const se=50;import{resolveSessionWorkDir as ze}from"../fs/boundary.js";class Qe{client;nativeFusion;cliVersion;upgradePolicyController;managedRoomBinder;sessions=new Map;processedReqIds=new Set;runTextAcc=new Map;pendingTransfers=new Map;managerRuntime;chatQueue;historySubscriptions;activityProbeTimer=null;attachmentCleanupTimer=null;activeRequests=0;constructor(e,t=null,s,i=null,n=null){this.client=e,this.nativeFusion=t,this.cliVersion=s,this.upgradePolicyController=i,this.managedRoomBinder=n,this.managerRuntime=new H({getRuntime:()=>this.getRuntime(),dispatchReq:a=>this.handleReq(a)}),this.chatQueue=new N({getRuntime:()=>this.getRuntime(),dispatchReq:a=>this.handleReq(a)}),this.historySubscriptions=new ee(this.client),h(this.managerRuntime),this.managerRuntime.start(),this.reloadCustomAgents(),this.activityProbeTimer=setInterval(()=>{this.publishManagedActivitySnapshots().catch(a=>{console.error("[session.activity] managed probe failed",a)})},15e3),this.activityProbeTimer.unref?.(),this.attachmentCleanupTimer=setInterval(()=>{const a=new Set([...d().map(r=>r.workDir),...Array.from(this.pendingTransfers.values()).map(r=>r.rootPath)]);for(const r of a)try{te(this.resolvePath(r))}catch(o){console.error("[attachment.cleanup] failed",o instanceof Error?o.message:String(o))}},6e4),this.attachmentCleanupTimer.unref?.()}getRuntime(){return{client:this.client,pendingTransfers:this.pendingTransfers,processedReqIds:this.processedReqIds,reloadCustomAgents:()=>this.reloadCustomAgents(),resolvePath:e=>this.resolvePath(e),resolveAuthorizedPath:(e,t)=>this.resolveAuthorizedPath(e,t),runTextAcc:this.runTextAcc,sessions:this.sessions,evictIdleSessions:()=>this.evictIdleSessions(),nativeFusion:this.nativeFusion,managerRuntime:this.managerRuntime,chatQueue:this.chatQueue,activityPublisher:{publish:(e,t)=>this.publishSessionActivity(e,t)},upgradePolicyController:this.upgradePolicyController}}getUpgradeIdleState(){const e=[];return[...this.sessions.values()].some(t=>t.currentRunId!==null)&&e.push("active-agent-turn"),this.pendingTransfers.size>0&&e.push("file-transfer"),this.activeRequests>0&&e.push("active-daemon-request"),{idle:e.length===0,reasons:e}}async activateRoomSession(e){const t=d().find(a=>a.sessionId===e.sessionId),s=t?.agentType===e.agentType?t.modelId??void 0:void 0,i={value:null},n=new Proxy(this.client,{get:(a,r)=>{if(r==="sendRes")return u=>{i.value=u};const o=Reflect.get(a,r,a);return typeof o=="function"?o.bind(a):o}});return await l({...this.getRuntime(),client:n},{type:"req",id:e.clientMessageId,method:"chat.send",params:{...e,modelId:s,sessionMode:t?.sessionMode??(t?.agentType==="manager"?"manager":"standard"),managerConfig:t?.managerConfig??null,managerDefaultWorkerAgentType:t?.managerDefaultWorkerAgentType??null,managerDefaultWorkerModelId:t?.managerDefaultWorkerModelId??null,waitForDispatch:!0,suppressExternalOwnerEcho:!0}},{source:"room_activation"}),{externalOwnerQueued:i.value?.ok===!0&&i.value.payload?.deliveryMode==="external_owner_queue"}}async abortRoomSession(e){const t=new Proxy(this.client,{get:(s,i)=>{if(i==="sendRes")return()=>{};const n=Reflect.get(s,i,s);return typeof n=="function"?n.bind(s):n}});await c({...this.getRuntime(),client:t},{type:"req",id:`room-activation-abort-${m.randomUUID()}`,method:"chat.abort",params:{sessionId:e.sessionId}})}publishSessionActivity(e,t){this.client.sendEvent({type:"event",event:"session.activity",payload:{sessionId:e,activity:t}})}async publishManagedActivitySnapshots(){for(const[e,t]of this.sessions.entries()){if(t.heartbeatTimer||!t.currentRunId||!t.adapter.getStatus)continue;const s=await t.adapter.getStatus().catch(()=>null);if(!s?.active||!s.runPhase)continue;const i=new Date().toISOString();this.publishSessionActivity(e,{sessionId:e,runId:s.runId||t.currentRunId,runPhase:s.runPhase,startedAt:new Date(t.lastActiveAt).toISOString(),updatedAt:i,canStop:s.canStop??!0});const n=t.heartbeatSeq++;this.client.sendAgentEvent({type:"event",event:"agent",payload:{state:"heartbeat",sessionId:e,runId:s.runId||t.currentRunId,seq:n,runPhase:s.runPhase,canStop:s.canStop??!0},seq:n,id:`agent-status-${s.runId||t.currentRunId}-${Date.now()}`})}}reloadCustomAgents(){for(const t of p())t.startsWith("custom:")&&f(t);const e=g();for(const[t,s]of Object.entries(e.customAgents??{}))K(t,s)}async handleReq(e){const t=this.getRuntime();this.activeRequests++;try{switch(e.method){case"chat.send":await l(t,e);break;case"chat.enqueue":await this.chatQueue.handleEnqueue(e);break;case"chat.queue.get":await this.chatQueue.handleGet(e);break;case"chat.queue.edit":await this.chatQueue.handleEdit(e);break;case"chat.queue.delete":await this.chatQueue.handleDelete(e);break;case"chat.abort":await c(t,e);break;case"session.refresh":await I(t,e);break;case"session.history.open":this.historySubscriptions.handleOpen(e);break;case"session.history.page":this.historySubscriptions.handlePage(e);break;case"session.history.close":this.historySubscriptions.handleClose(e);break;case"session.history":this.client.sendRes({type:"res",id:e.id,ok:!1,error:"upgrade_required"});break;case"session.message.status":M(t,e);break;case"session.tool.detail":await P(t,e);break;case"voice.session.body.window":F(t,e);break;case"session.title.set":await C(t,e);break;case"room.agent.bind-managed":await Y(t,this.managedRoomBinder,e);break;case"room.agent.restart-managed":await q(t,this.managedRoomBinder,e);break;case"fs.ls":await x(t,e);break;case"fs.read":await E(t,e);break;case"fs.write":await W(t,e);break;case"fs.export.markdown-pdf":await V(t,e);break;case"fs.export.markdown-pdf.setup":await B(t,e);break;case"fs.archive.zip":await $(t,e);break;case"fs.rename":await Q(t,e);break;case"fs.transfer.start":await O(t,e);break;case"fs.transfer.chunk":await z(t,e);break;case"fs.transfer.finish":await U(t,e);break;case"fs.transfer.abort":await _(t,e);break;case"region.probe":await j(t,e);break;case"region.switch":await L(t,e);break;case"upgrade.start":await b(this.client,e.id,e.params.version,{currentVersion:this.cliVersion,confirmedMajor:e.params.confirmedMajor===!0});break;case"upgrade.status":await w(this.client,e.id,{currentVersion:this.cliVersion});break;case"upgrade.set-policy":await G(t,e);break;case"agents.refresh":await v(t,e);break;case"models.refresh":await k(t,e);break;case"agent.config.get":await S(t,e);break;case"agent.config.upsert":await T(t,e);break;case"agent.config.clear":await R(t,e);break;case"agent.config.test":await A(t,e);break;case"agent.capabilities.list":await y(t,e);break;case"skill.list":case"skill.install":case"skill.doctor":case"skill.setup":case"skill.use":this.client.sendRes({type:"res",id:e.id,ok:!1,error:"feature_retired"});break;case"session.wechat-rpa.channel.get":case"session.wechat-rpa.channel.upsert":case"session.wechat-rpa.channel.sync":case"manager.wechat-rpa.channel.get":case"manager.wechat-rpa.channel.upsert":case"manager.wechat-rpa.channel.sync":this.client.sendRes({type:"res",id:e.id,ok:!1,error:"feature_retired"});break;default:this.client.sendRes({type:"res",id:e.id,ok:!1,error:`Unknown method: ${e.method}`})}}catch(s){this.client.sendRes({type:"res",id:e.id,ok:!1,error:s instanceof Error?s.message:String(s)})}finally{this.activeRequests--}}evictIdleSessions(){if(this.sessions.size<se)return;let e=null;for(const[t,s]of this.sessions)(!e||s.lastActiveAt<e.session.lastActiveAt)&&(e={key:t,session:s});e&&(e.session.heartbeatTimer&&(clearInterval(e.session.heartbeatTimer),e.session.heartbeatTimer=null),e.session.adapter.removeAllListeners(),e.session.adapter.stop().catch(()=>{}),this.sessions.delete(e.key))}resolvePath(e){return J(e)}resolveAuthorizedPath(e,t){return Z(e,X(t))}async cleanup(){this.historySubscriptions.closeAll(),this.activityProbeTimer&&(clearInterval(this.activityProbeTimer),this.activityProbeTimer=null),this.attachmentCleanupTimer&&(clearInterval(this.attachmentCleanupTimer),this.attachmentCleanupTimer=null);for(const[,e]of this.sessions)e.heartbeatTimer&&(clearInterval(e.heartbeatTimer),e.heartbeatTimer=null),await e.adapter.stop().catch(()=>{});this.sessions.clear(),this.runTextAcc.clear(),D(this.getRuntime()),await this.managerRuntime.stop(),h(null)}}export{Qe as SessionManager,ze as resolveSessionWorkDir};

package/dist/src/session/queue.d.ts

@@ -1,4 +1,4 @@
-import type { ChatQueueSnapshot, ReqFrame } from '@shennian/wire';
+import { type ChatQueueSnapshot, type ReqFrame } from '@shennian/wire';
 import type { LocalReqDispatcher } from '../manager/runtime.js';
 import type { SessionManagerRuntime } from './types.js';
 export declare class ChatQueueManager {

package/dist/src/session/queue.js

@@ -1,4 +1,5 @@
-import h from"node:fs";import{randomUUID as y}from"node:crypto";import{resolveShennianPath as I}from"../config/index.js";import{mergeProjectedSessions as M}from"./projection.js";import{materializeRemoteChatAttachments as k}from"./remote-attachments.js";const x=I("chat-queue.json");function w(){return{sessions:{}}}function f(){return new Date().toISOString()}function S(s){return`enqueue-send-${s}-${y()}`}function d(){try{const s=JSON.parse(h.readFileSync(x,"utf-8"));return{sessions:s.sessions&&typeof s.sessions=="object"?s.sessions:{}}}catch{return w()}}function u(s){h.mkdirSync(I(""),{recursive:!0}),h.writeFileSync(x,JSON.stringify(s,null,2))}function p(s){if(!Array.isArray(s))return;const e=s.map(n=>{if(!n||typeof n!="object")return null;const t=n,i={path:typeof t.path=="string"?t.path:"",name:typeof t.name=="string"?t.name:"",mimeType:typeof t.mimeType=="string"?t.mimeType:"",...typeof t.previewData=="string"&&t.previewData.trim()?{previewData:t.previewData.trim()}:{}};return i.path&&i.name&&i.mimeType?i:null}).filter(n=>n!=null);return e.length?e:void 0}function D(s){const e=f();return{id:s.queueMessageId||s.clientMessageId||`queue-${y()}`,sessionId:s.sessionId,text:s.text,agentType:s.agentType,sessionMode:s.sessionMode,managerConfig:s.managerConfig,workDir:s.workDir,agentSessionId:s.agentSessionId??null,modelId:s.modelId??null,systemPrompt:s.systemPrompt??null,managerDefaultWorkerAgentType:s.managerDefaultWorkerAgentType??null,managerDefaultWorkerModelId:s.managerDefaultWorkerModelId??null,reasoningEffort:s.reasoningEffort??null,clientMessageId:s.clientMessageId??null,attachments:p(s.attachments),externalChannel:s.externalChannel??null,replyTarget:s.replyTarget??null,origin:s.origin,createdAt:e,updatedAt:e}}class C{opts;draining=new Set;constructor(e){this.opts=e,setTimeout(()=>this.drainIdleQueues(),0).unref?.()}getSnapshot(e){return{sessionId:e,busy:!!this.opts.getRuntime().sessions.get(e)?.currentRunId,pending:d().sessions[e]??[]}}async handleEnqueue(e){const n=this.opts.getRuntime(),t=e.params;if(M(t.sessionListProjection),!t.sessionId||!t.text||!t.agentType||!t.workDir){n.client.sendRes({type:"res",id:e.id,ok:!1,error:"sessionId, text, agentType and workDir are required"});return}const i=p(t.attachments),r=i?.length?await k({text:t.text,attachments:i,workDir:t.workDir}):{text:t.text,attachments:i,localized:!1},a=await this.isSessionBusy(t.sessionId),o=d(),c=o.sessions[t.sessionId]??[];if(!a&&!c.length){await this.opts.dispatchReq({...e,id:S(e.id),method:"chat.send",params:{...t,text:r.text,responseId:e.id,clientMessageId:t.clientMessageId??t.queueMessageId,waitForDispatch:!0,attachments:r.attachments}});return}const l=D({...t,text:r.text,attachments:r.attachments}),m=t.origin==="external"?q(c,l):null;m||(o.sessions[t.sessionId]=[...c,l],u(o)),this.broadcast(t.sessionId),n.client.sendRes({type:"res",id:e.id,ok:!0,payload:{queued:!0,queueMessageId:m?.id??l.id,queue:this.getSnapshot(t.sessionId),...r.localized?{localizedAttachments:!0}:{}}}),a||this.drainNext(t.sessionId)}async handleGet(e){const n=this.opts.getRuntime(),t=e.params;if(!t.sessionId){n.client.sendRes({type:"res",id:e.id,ok:!1,error:"sessionId is required"});return}n.client.sendRes({type:"res",id:e.id,ok:!0,payload:{queue:this.getSnapshot(t.sessionId)}}),this.getSnapshot(t.sessionId).busy||this.drainNext(t.sessionId)}async handleEdit(e){const n=this.opts.getRuntime(),t=e.params;if(!t.sessionId||!t.queueMessageId||!t.text){n.client.sendRes({type:"res",id:e.id,ok:!1,error:"sessionId, queueMessageId and text are required"});return}const i=d(),r=i.sessions[t.sessionId]??[],a=r.findIndex(o=>o.id===t.queueMessageId);if(a<0){n.client.sendRes({type:"res",id:e.id,ok:!1,error:"Queued message not found"});return}r[a]={...r[a],text:t.text,attachments:p(t.attachments),updatedAt:f()},i.sessions[t.sessionId]=r,u(i),this.broadcast(t.sessionId),n.client.sendRes({type:"res",id:e.id,ok:!0,payload:{queue:this.getSnapshot(t.sessionId)}})}async handleDelete(e){const n=this.opts.getRuntime(),t=e.params;if(!t.sessionId||!t.queueMessageId){n.client.sendRes({type:"res",id:e.id,ok:!1,error:"sessionId and queueMessageId are required"});return}const i=d(),r=i.sessions[t.sessionId]??[],a=r.filter(o=>o.id!==t.queueMessageId);if(a.length===r.length){n.client.sendRes({type:"res",id:e.id,ok:!1,error:"Queued message not found"});return}a.length?i.sessions[t.sessionId]=a:delete i.sessions[t.sessionId],u(i),this.broadcast(t.sessionId),n.client.sendRes({type:"res",id:e.id,ok:!0,payload:{queue:this.getSnapshot(t.sessionId)}})}noteTerminal(e){this.drainNext(e)}drainIdleQueues(){const e=d();for(const n of Object.keys(e.sessions))this.drainNext(n)}async drainNext(e){if(this.draining.has(e)||await this.isSessionBusy(e))return;const n=d(),t=n.sessions[e]??[],i=t.shift();if(!i){this.broadcast(e);return}const r=i.origin==="external"?this.mergeExternalMessages(i,t):i;t.length?n.sessions[e]=t:delete n.sessions[e],u(n),this.broadcast(e),this.draining.add(e);try{await this.dispatchQueuedMessage(r)}finally{this.draining.delete(e)}}mergeExternalMessages(e,n){const t=[e];for(;n[0]?.origin==="external";)t.push(n.shift());const i=R(t);return i.length===1?i[0]:{...e,id:`external-batch-${e.id}`,text:i.map(r=>r.text).filter(Boolean).join(`
+import c from"node:fs";import{randomUUID as p}from"node:crypto";import{buildUserMessagePayload as R}from"@shennian/wire";import{mergeProjectedSessions as T}from"./projection.js";import{parsePersonalAttachmentReferences as m}from"./attachment-reference.js";import{assertFinishedAttachmentReferences as k,markAttachmentReferences as q}from"./attachment-transfer-store.js";import{resolvePersonalSyncV1Path as w}from"../personal-sync/paths.js";import{appendMessage as b,getMessageDeliveryStatus as E,recordSession as v,tombstoneMessage as P,upsertMessage as D}from"./store.js";import{requestSessionIndexPublish as y}from"./index-publisher.js";const I=w("outbound-queue.json");function A(){return{sessions:{}}}function M(){return new Date().toISOString()}function Q(s){return`enqueue-send-${s}-${p()}`}function l(){try{const s=JSON.parse(c.readFileSync(I,"utf-8"));return{sessions:s.sessions&&typeof s.sessions=="object"?s.sessions:{}}}catch(s){if(s.code==="ENOENT"||s instanceof Error&&s.message.startsWith("ENOENT:"))return A();throw s}}function g(s){const e=w();c.mkdirSync(e,{recursive:!0,mode:448});const n=`${I}.tmp-${process.pid}-${p()}`;try{c.writeFileSync(n,`${JSON.stringify(s,null,2)}
+`,{encoding:"utf8",mode:384,flag:"wx"});const t=c.openSync(n,"r");if(typeof t=="number")try{c.fsyncSync(t)}finally{c.closeSync(t)}c.renameSync(n,I)}finally{try{c.unlinkSync(n)}catch{}}}function $(s){const e=M();return{id:s.queueMessageId||s.clientMessageId||`queue-${p()}`,sessionId:s.sessionId,text:s.text,agentType:s.agentType,sessionMode:s.sessionMode,managerConfig:s.managerConfig,workDir:s.workDir,agentSessionId:s.agentSessionId??null,modelId:s.modelId??null,systemPrompt:s.systemPrompt??null,managerDefaultWorkerAgentType:s.managerDefaultWorkerAgentType??null,managerDefaultWorkerModelId:s.managerDefaultWorkerModelId??null,reasoningEffort:s.reasoningEffort??null,clientMessageId:s.clientMessageId??null,attachments:m(s.attachments),externalChannel:s.externalChannel??null,replyTarget:s.replyTarget??null,origin:s.origin,createdAt:e,updatedAt:e}}function x(s){return{id:s.clientMessageId??s.id,sessionId:s.sessionId,role:"user",ts:Date.parse(s.createdAt),payload:R(s.text,s.attachments)}}class _{opts;draining=new Set;constructor(e){this.opts=e,setTimeout(()=>this.drainIdleQueues(),0).unref?.()}getSnapshot(e){return{sessionId:e,busy:!!this.opts.getRuntime().sessions.get(e)?.currentRunId,pending:l().sessions[e]??[]}}async handleEnqueue(e){const n=this.opts.getRuntime(),t=e.params;if(T(t.sessionListProjection),!t.sessionId||!t.text||!t.agentType||!t.workDir){n.client.sendRes({type:"res",id:e.id,ok:!1,error:"sessionId, text, agentType and workDir are required"});return}const i=n.resolvePath(t.workDir),o=m(t.attachments);o?.length&&k(i,o);const r={text:t.text,attachments:o,localized:!1},d=await this.isSessionBusy(t.sessionId),u=l(),h=u.sessions[t.sessionId]??[];if(!d&&!h.length){await this.opts.dispatchReq({...e,id:Q(e.id),method:"chat.send",params:{...t,text:r.text,responseId:e.id,clientMessageId:t.clientMessageId??t.queueMessageId,waitForDispatch:!0,attachments:r.attachments}});return}const a=$({...t,text:r.text,attachments:r.attachments}),f=t.origin==="external"?C(h,a):null;f||(u.sessions[t.sessionId]=[...h,a],g(u),v({sessionId:a.sessionId,agentType:a.agentType,sessionMode:a.sessionMode,managerConfig:a.managerConfig,workDir:a.workDir,agentSessionId:a.agentSessionId,modelId:a.modelId}),b(a.sessionId,x(a),"queued"),q(i,a.attachments??[]),y(n.client)),this.broadcast(t.sessionId),n.client.sendRes({type:"res",id:e.id,ok:!0,payload:{queued:!0,queueMessageId:f?.id??a.id,...E(t.sessionId,f?.clientMessageId??f?.id??a.clientMessageId??a.id),queue:this.getSnapshot(t.sessionId),...r.localized?{localizedAttachments:!0}:{}}}),d||this.drainNext(t.sessionId)}async handleGet(e){const n=this.opts.getRuntime(),t=e.params;if(!t.sessionId){n.client.sendRes({type:"res",id:e.id,ok:!1,error:"sessionId is required"});return}n.client.sendRes({type:"res",id:e.id,ok:!0,payload:{queue:this.getSnapshot(t.sessionId)}}),this.getSnapshot(t.sessionId).busy||this.drainNext(t.sessionId)}async handleEdit(e){const n=this.opts.getRuntime(),t=e.params;if(!t.sessionId||!t.queueMessageId||!t.text){n.client.sendRes({type:"res",id:e.id,ok:!1,error:"sessionId, queueMessageId and text are required"});return}const i=l(),o=i.sessions[t.sessionId]??[],r=o.findIndex(h=>h.id===t.queueMessageId);if(r<0){n.client.sendRes({type:"res",id:e.id,ok:!1,error:"Queued message not found"});return}const d=m(t.attachments),u=n.resolvePath(o[r].workDir);d?.length&&k(u,d),o[r]={...o[r],text:t.text,attachments:d,updatedAt:M()},i.sessions[t.sessionId]=o,g(i),D(t.sessionId,x(o[r]),"queued"),o[r].attachments?.length&&q(u,o[r].attachments??[]),y(n.client),this.broadcast(t.sessionId),n.client.sendRes({type:"res",id:e.id,ok:!0,payload:{queue:this.getSnapshot(t.sessionId)}})}async handleDelete(e){const n=this.opts.getRuntime(),t=e.params;if(!t.sessionId||!t.queueMessageId){n.client.sendRes({type:"res",id:e.id,ok:!1,error:"sessionId and queueMessageId are required"});return}const i=l(),o=i.sessions[t.sessionId]??[],r=o.find(u=>u.id===t.queueMessageId),d=o.filter(u=>u.id!==t.queueMessageId);if(d.length===o.length){n.client.sendRes({type:"res",id:e.id,ok:!1,error:"Queued message not found"});return}d.length?i.sessions[t.sessionId]=d:delete i.sessions[t.sessionId],g(i),P(t.sessionId,r?.clientMessageId??r?.id??t.queueMessageId),y(n.client),this.broadcast(t.sessionId),n.client.sendRes({type:"res",id:e.id,ok:!0,payload:{queue:this.getSnapshot(t.sessionId)}})}noteTerminal(e){this.drainNext(e)}drainIdleQueues(){const e=l();for(const n of Object.keys(e.sessions))this.drainNext(n)}async drainNext(e){if(this.draining.has(e)||await this.isSessionBusy(e))return;const i=(l().sessions[e]??[])[0];if(!i){this.broadcast(e);return}const o=i;this.draining.add(e);try{D(e,x(o),"queued"),await this.dispatchQueuedMessage(o);const r=l(),d=(r.sessions[e]??[]).filter(u=>u.id!==i.id);d.length?r.sessions[e]=d:delete r.sessions[e],g(r),this.broadcast(e)}finally{this.draining.delete(e)}}mergeExternalMessages(e,n){const t=[e];for(;n[0]?.origin==="external";)t.push(n.shift());const i=W(t);return i.length===1?i[0]:{...e,id:`external-batch-${e.id}`,text:i.map(o=>o.text).filter(Boolean).join(`
 
-`),attachments:b(i.flatMap(r=>r.attachments??[])),updatedAt:f()}}async dispatchQueuedMessage(e){await this.opts.dispatchReq({type:"req",id:`queue-send-${e.id}-${Date.now()}`,method:"chat.send",params:{sessionId:e.sessionId,text:e.text,agentType:e.agentType,sessionMode:e.sessionMode,managerConfig:e.managerConfig,workDir:e.workDir,agentSessionId:e.agentSessionId??null,modelId:e.modelId??void 0,systemPrompt:e.systemPrompt??null,managerDefaultWorkerAgentType:e.managerDefaultWorkerAgentType,managerDefaultWorkerModelId:e.managerDefaultWorkerModelId,reasoningEffort:e.reasoningEffort??void 0,clientMessageId:e.clientMessageId??e.id,attachments:e.attachments,externalChannel:e.externalChannel,replyTarget:e.replyTarget,waitForDispatch:!0}})}async isSessionBusy(e){const n=this.opts.getRuntime().sessions.get(e);if(!n)return!1;if(n.currentRunId)return!0;if(!n.adapter.getStatus)return!1;const t=await n.adapter.getStatus().catch(()=>null);return t?.active?(t.runId&&(n.currentRunId=t.runId,n.currentRunPhase=t.runPhase??n.currentRunPhase),!0):!1}broadcast(e){this.opts.getRuntime().client.sendEvent({type:"event",event:"session.queue.update",payload:{queue:this.getSnapshot(e)}})}}function R(s){const e=new Set,n=[];for(const t of s){const i=g(t);e.has(i)||(e.add(i),n.push(t))}return n}function q(s,e){const n=g(e);return s.find(t=>g(t)===n)??null}function g(s){const e=T(s);return e?`id:${e}`:["body",A(s.text),...(s.attachments??[]).map(n=>n.path||`${n.name}:${n.mimeType}`)].join(`
-`)}function T(s){const e=typeof s.clientMessageId=="string"?s.clientMessageId.trim():"";if(e)return e;const n=typeof s.id=="string"?s.id.trim():"";return n&&!n.startsWith("queue-")?n:""}function b(s){const e=new Set,n=[];for(const t of s){const i=t.path||`${t.name}:${t.mimeType}`;e.has(i)||(e.add(i),n.push(t))}return n.length?n:void 0}function A(s){return String(s||"").replace(/\s+/g," ").trim()}export{C as ChatQueueManager};
+`),attachments:B(i.flatMap(o=>o.attachments??[])),updatedAt:M()}}async dispatchQueuedMessage(e){await this.opts.dispatchReq({type:"req",id:`queue-send-${e.id}-${Date.now()}`,method:"chat.send",params:{sessionId:e.sessionId,text:e.text,agentType:e.agentType,sessionMode:e.sessionMode,managerConfig:e.managerConfig,workDir:e.workDir,agentSessionId:e.agentSessionId??null,modelId:e.modelId??void 0,systemPrompt:e.systemPrompt??null,managerDefaultWorkerAgentType:e.managerDefaultWorkerAgentType,managerDefaultWorkerModelId:e.managerDefaultWorkerModelId,reasoningEffort:e.reasoningEffort??void 0,clientMessageId:e.clientMessageId??e.id,attachments:e.attachments,externalChannel:e.externalChannel,replyTarget:e.replyTarget,waitForDispatch:!0}})}async isSessionBusy(e){const n=this.opts.getRuntime().sessions.get(e);if(!n)return!1;if(n.currentRunId)return!0;if(!n.adapter.getStatus)return!1;const t=await n.adapter.getStatus().catch(()=>null);return t?.active?(t.runId&&(n.currentRunId=t.runId,n.currentRunPhase=t.runPhase??n.currentRunPhase),!0):!1}broadcast(e){this.opts.getRuntime().client.sendEvent({type:"event",event:"session.queue.update",payload:{queue:this.getSnapshot(e)}})}}function W(s){const e=new Set,n=[];for(const t of s){const i=S(t);e.has(i)||(e.add(i),n.push(t))}return n}function C(s,e){const n=S(e);return s.find(t=>S(t)===n)??null}function S(s){const e=N(s);return e?`id:${e}`:["body",j(s.text),...(s.attachments??[]).map(n=>n.path||`${n.name}:${n.mimeType}`)].join(`
+`)}function N(s){const e=typeof s.clientMessageId=="string"?s.clientMessageId.trim():"";if(e)return e;const n=typeof s.id=="string"?s.id.trim():"";return n&&!n.startsWith("queue-")?n:""}function B(s){const e=new Set,n=[];for(const t of s){const i=t.path||`${t.name}:${t.mimeType}`;e.has(i)||(e.add(i),n.push(t))}return n.length?n:void 0}function j(s){return String(s||"").replace(/\s+/g," ").trim()}export{_ as ChatQueueManager};

package/dist/src/session/store.d.ts

@@ -1,4 +1,7 @@
-import type { AgentType, Envelope, ManagerConfig, SessionMode } from '@shennian/wire';
+import { type AgentType, type Envelope, type ManagerConfig, type SessionIndexUpdate, type SessionDeliveryState, type SessionMessageStatusResponse, type SessionMode, type SessionTitleSource } from '@shennian/wire';
+import { PERSONAL_SYNC_V1_ROOT_NAME } from '../personal-sync/paths.js';
+import { CanonicalSessionStore } from './canonical-store.js';
+export { PERSONAL_SYNC_V1_ROOT_NAME };
 export type LocalSessionRecord = {
     sessionId: string;
     agentType: AgentType;
@@ -14,7 +17,22 @@ export type LocalSessionRecord = {
     updatedAt: string;
     lastActivityAt: string;
     lastMessagePreview?: string | null;
+    bodyRevision: number;
+    indexRevision: number;
+    title: string;
+    titleSource: SessionTitleSource;
+    titleRevision: number;
+    titleLockedByUser: boolean;
+    titleOriginEventId: string | null;
+    firstAvailableSeq: number | null;
+    visibleMessageCount: number;
+    lastVisibleMessageId: string | null;
+    lastBodyCommittedAt: string | null;
+    deletionRevision: number;
+    deletedAt: string | null;
+    syncedIndexRevision: number;
 };
+export declare function getDaemonInstallationId(): string;
 export declare function recordSession(input: {
     sessionId: string;
     agentType: AgentType;
@@ -28,11 +46,23 @@ export declare function recordSession(input: {
     status?: 'active' | 'completed' | 'failed';
     lastActivityAt?: string;
     lastMessagePreview?: string | null;
-}): void;
+    title?: string;
+    titleSource?: SessionTitleSource;
+    titleRevision?: number;
+    titleLockedByUser?: boolean;
+    titleOriginEventId?: string | null;
+    deletedAt?: string | null;
+}): LocalSessionRecord;
 export declare function listSessionRecords(): LocalSessionRecord[];
-export declare function appendMessage(sessionId: string, envelope: Envelope): void;
+export declare function listPendingSessionIndexUpdates(): SessionIndexUpdate[];
+export declare function acknowledgeSessionIndexUpdate(sessionId: string, indexRevision: number): void;
+export declare function appendMessage(sessionId: string, envelope: Envelope, deliveryState?: SessionDeliveryState): number;
+export declare function upsertMessage(sessionId: string, envelope: Envelope, deliveryState?: SessionDeliveryState): number;
+export declare function getMessageDeliveryStatus(sessionId: string, clientMessageId: string): SessionMessageStatusResponse;
+export declare function tombstoneMessage(sessionId: string, messageId: string): number;
 export declare function readMessages(sessionId: string, opts?: {
     limit?: number;
     before?: number;
 }): Envelope[];
 export declare function listSessions(): string[];
+export declare function getCanonicalSessionStore(): CanonicalSessionStore;

package/dist/src/session/store.js

@@ -1,3 +1,2 @@
-import i from"node:fs";import f from"node:path";import{resolveShennianPath as g}from"../config/index.js";const l=g("sessions"),c=g("sessions-index.json");function u(){i.mkdirSync(l,{recursive:!0})}function S(e){return f.join(l,`${e}.jsonl`)}function d(){try{const e=JSON.parse(i.readFileSync(c,"utf-8"));return e&&typeof e=="object"?e:{}}catch{return{}}}function m(e){i.mkdirSync(f.dirname(c),{recursive:!0}),i.writeFileSync(c,JSON.stringify(e,null,2))}function I(e){const t=e.payload.replace(/\s+/g," ").trim();return!t||t.startsWith('{"v":1,"type":"tool')?null:t.length>120?`${t.slice(0,120)}...`:t}function A(e){try{const t=d(),n=t[e.sessionId],r=new Date().toISOString();t[e.sessionId]={sessionId:e.sessionId,agentType:e.agentType,sessionMode:e.sessionMode??n?.sessionMode,managerConfig:e.managerConfig??n?.managerConfig??null,workDir:e.workDir,agentSessionId:e.agentSessionId??n?.agentSessionId??null,modelId:e.modelId??n?.modelId??null,managerDefaultWorkerAgentType:e.managerDefaultWorkerAgentType??n?.managerDefaultWorkerAgentType??null,managerDefaultWorkerModelId:e.managerDefaultWorkerModelId??n?.managerDefaultWorkerModelId??null,status:e.status??n?.status??"active",createdAt:n?.createdAt??r,updatedAt:r,lastActivityAt:e.lastActivityAt??n?.lastActivityAt??r,lastMessagePreview:e.lastMessagePreview??n?.lastMessagePreview??null},m(t)}catch{}}function x(){return Object.values(d())}function D(e,t){try{u();const n=JSON.stringify(t)+`
-`;i.appendFileSync(S(e),n,"utf-8");const r=d(),a=r[e];if(a){const s=I(t);r[e]={...a,updatedAt:new Date().toISOString(),lastActivityAt:new Date(t.ts).toISOString(),lastMessagePreview:s??a.lastMessagePreview??null},m(r)}}catch{}}function M(e,t){const n=S(e);if(!i.existsSync(n))return[];const a=i.readFileSync(n,"utf-8").split(`
-`).filter(o=>o.trim().length>0);let s=[];for(const o of a)try{s.push(JSON.parse(o))}catch{}return s.sort((o,y)=>y.ts-o.ts),t?.before!==void 0&&(s=s.filter(o=>o.ts<t.before)),t?.limit!==void 0&&t.limit>0&&(s=s.slice(0,t.limit)),s}function h(){return u(),i.readdirSync(l).filter(e=>e.endsWith(".jsonl")).map(e=>e.replace(/\.jsonl$/,""))}export{D as appendMessage,x as listSessionRecords,h as listSessions,M as readMessages,A as recordSession};
+import v from"node:crypto";import l from"node:fs";import f from"node:path";import{SESSION_SYNC_PROTOCOL_VERSION as M,SESSION_TITLE_SOURCE_PRIORITY as y}from"@shennian/wire";import{PERSONAL_SYNC_V1_ROOT_NAME as w,resolvePersonalSyncV1Path as p}from"../personal-sync/paths.js";import{CanonicalSessionStore as k}from"./canonical-store.js";let S=null,I=null;function m(){return p()}function r(){const t=f.join(m(),"canonical");return(!S||I!==t)&&(S=new k(t,c()),I=t),S}function R(){return f.join(m(),"session-index.json")}function u(){const t=R();if(!l.existsSync(t))return{};const e=JSON.parse(l.readFileSync(t,"utf8"));if(!e||typeof e!="object"||Array.isArray(e))throw new Error(`invalid personal session index: ${t}`);return e}function g(t){b(R(),t)}function O(t){const e=t.payload.replace(/\s+/g," ").trim();return!e||e.startsWith('{"v":1,"type":"tool')?null:e.length>120?`${e.slice(0,120)}...`:e}function c(){const t=f.join(m(),"installation.json");if(l.existsSync(t)){const i=JSON.parse(l.readFileSync(t,"utf8"));if(i.schemaVersion!==1||!i.daemonInstallationId)throw new Error(`invalid daemon installation identity: ${t}`);return i.daemonInstallationId}const e={schemaVersion:1,daemonInstallationId:v.randomUUID(),createdAt:new Date().toISOString()};return b(t,e),e.daemonInstallationId}function U(t){c();const e=u(),i=e[t.sessionId],n=new Date().toISOString(),s=r().getManifest(t.sessionId)?.bodyRevision??i?.bodyRevision??0,o=r().getManifest(t.sessionId),a=D(i,t),d={sessionId:t.sessionId,agentType:t.agentType,sessionMode:t.sessionMode??i?.sessionMode,managerConfig:t.managerConfig??i?.managerConfig??null,workDir:t.workDir,agentSessionId:t.agentSessionId??i?.agentSessionId??null,modelId:t.modelId??i?.modelId??null,managerDefaultWorkerAgentType:t.managerDefaultWorkerAgentType??i?.managerDefaultWorkerAgentType??null,managerDefaultWorkerModelId:t.managerDefaultWorkerModelId??i?.managerDefaultWorkerModelId??null,status:t.status??i?.status??"active",createdAt:i?.createdAt??n,updatedAt:n,lastActivityAt:t.lastActivityAt??i?.lastActivityAt??n,lastMessagePreview:t.lastMessagePreview??i?.lastMessagePreview??null,bodyRevision:s,indexRevision:(i?.indexRevision??0)+1,...a,firstAvailableSeq:o?.firstAvailableSeq??i?.firstAvailableSeq??null,visibleMessageCount:o?.visibleMessageCount??i?.visibleMessageCount??0,lastVisibleMessageId:o?.lastVisibleMessageId??i?.lastVisibleMessageId??null,lastBodyCommittedAt:o?.lastBodyCommittedAt??i?.lastBodyCommittedAt??null,deletionRevision:i?.deletionRevision??0,deletedAt:t.deletedAt??i?.deletedAt??null,syncedIndexRevision:i?.syncedIndexRevision??0};return e[t.sessionId]=d,g(e),d}function C(){return Object.values(u())}function V(){const t=c();return C().filter(e=>e.indexRevision>e.syncedIndexRevision).sort((e,i)=>e.indexRevision-i.indexRevision).map(e=>({protocolVersion:M,daemonInstallationId:t,session:{id:e.sessionId,agentType:e.agentType,sessionMode:e.sessionMode,managerConfig:e.managerConfig,agentSessionId:e.agentSessionId??null,modelId:e.modelId??null,managerDefaultWorkerAgentType:e.managerDefaultWorkerAgentType??null,managerDefaultWorkerModelId:e.managerDefaultWorkerModelId??null,title:e.title,titleSource:e.titleSource,titleRevision:e.titleRevision,titleLockedByUser:e.titleLockedByUser,titleOriginEventId:e.titleOriginEventId,status:e.status??"active",workDir:e.workDir,lastMessagePreview:e.lastMessagePreview??null,bodyStorageMode:"machine_local",bodyRevision:e.bodyRevision,indexRevision:e.indexRevision,firstAvailableSeq:e.firstAvailableSeq,visibleMessageCount:e.visibleMessageCount,lastVisibleMessageId:e.lastVisibleMessageId,lastBodyCommittedAt:e.lastBodyCommittedAt,deletionRevision:e.deletionRevision,lastActivityAt:e.lastActivityAt,createdAt:e.createdAt,updatedAt:e.updatedAt,deletedAt:e.deletedAt}}))}function L(t,e){const i=u(),n=i[t];if(!(!n||e<=n.syncedIndexRevision)){if(e>n.indexRevision)throw new Error(`cannot acknowledge future index revision ${e} for ${t}`);i[t]={...n,syncedIndexRevision:e},g(i)}}function W(t,e,i){c();const n=r().append(t,e,i);return A(t,e,n.bodyRevision),n.bodyRevision}function N(t,e,i){c();const n=r().upsert(t,e,i);return A(t,e,n.bodyRevision),n.bodyRevision}function q(t,e){const i=r().getMessageState(t,e);return!i||i.tombstoned||!i.message||!i.deliveryState?{state:"not_found",sessionId:t,clientMessageId:e}:{state:i.deliveryState,sessionId:t,clientMessageId:e,messageId:i.message.id,deliveryState:i.deliveryState,bodyRevision:i.lastRevision,committedAt:new Date(i.message.ts).toISOString()}}function $(t,e){c();const i=r().tombstone(t,e),n=u(),s=n[t];return s&&(n[t]={...s,bodyRevision:i.bodyRevision,indexRevision:s.indexRevision+1,updatedAt:new Date().toISOString()},g(n)),i.bodyRevision}function A(t,e,i){const n=u(),s=n[t];if(!s)return;const o=O(e),a=r().getManifest(t),d=e.role==="user"&&o&&!s.title?{title:o,titleSource:"first_user_fallback",titleRevision:s.titleRevision+1,titleLockedByUser:!1,titleOriginEventId:e.id}:null;n[t]={...s,...d??{},bodyRevision:i,indexRevision:s.indexRevision+1,updatedAt:new Date().toISOString(),lastActivityAt:new Date(e.ts).toISOString(),lastMessagePreview:o??s.lastMessagePreview??null,firstAvailableSeq:a?.firstAvailableSeq??s.firstAvailableSeq,visibleMessageCount:a?.visibleMessageCount??s.visibleMessageCount,lastVisibleMessageId:a?.lastVisibleMessageId??s.lastVisibleMessageId,lastBodyCommittedAt:a?.lastBodyCommittedAt??s.lastBodyCommittedAt},g(n)}function D(t,e){const i={title:t?.title??"",titleSource:t?.titleSource??"first_user_fallback",titleRevision:t?.titleRevision??0,titleLockedByUser:t?.titleLockedByUser??!1,titleOriginEventId:t?.titleOriginEventId??null},n=e.title?.trim()??"";if(!n)return i;if(!e.titleSource)throw new Error("titleSource is required with title");const s=e.titleSource==="shennian_manual";if(e.titleLockedByUser!==void 0&&e.titleLockedByUser!==s)throw new Error("titleLockedByUser conflicts with titleSource");const o=n===i.title&&e.titleSource===i.titleSource,a=e.titleRevision??i.titleRevision+(o?0:1);if(!Number.isSafeInteger(a)||a<0)throw new Error("invalid titleRevision");const d=y[e.titleSource],x=y[i.titleSource];return d<x||a<i.titleRevision||a===i.titleRevision&&!o?i:{title:n,titleSource:e.titleSource,titleRevision:a,titleLockedByUser:s,titleOriginEventId:e.titleOriginEventId??i.titleOriginEventId}}function j(t,e){const i=e?.limit&&e.limit>0?Math.min(e.limit,500):500;let s=r().readRecent(t,i).messages;return e?.before!==void 0&&(s=s.filter(o=>o.ts<e.before)),[...s].sort((o,a)=>a.ts-o.ts)}function F(){return r().listSessionIds()}function J(){return r()}function b(t,e){const i=f.dirname(t);l.mkdirSync(i,{recursive:!0,mode:448});const n=`${t}.tmp-${process.pid}-${v.randomBytes(6).toString("hex")}`;let s;try{if(s=l.openSync(n,"wx",384),l.writeFileSync(s,`${JSON.stringify(e,null,2)}
+`,"utf8"),l.fsyncSync(s),l.closeSync(s),s=void 0,l.renameSync(n,t),process.platform!=="win32"){const o=l.openSync(i,"r");try{l.fsyncSync(o)}finally{l.closeSync(o)}}}finally{s!==void 0&&l.closeSync(s);try{l.unlinkSync(n)}catch{}}}export{w as PERSONAL_SYNC_V1_ROOT_NAME,L as acknowledgeSessionIndexUpdate,W as appendMessage,J as getCanonicalSessionStore,c as getDaemonInstallationId,q as getMessageDeliveryStatus,V as listPendingSessionIndexUpdates,C as listSessionRecords,F as listSessions,j as readMessages,U as recordSession,$ as tombstoneMessage,N as upsertMessage};

package/dist/src/session/tool-detail-store.d.ts

@@ -0,0 +1,16 @@
+import type { ToolDetailRef } from '@shennian/wire';
+export type LocalToolDetail = {
+    schemaVersion: 1;
+    sessionId: string;
+    toolCallId: string;
+    detailRevision: number;
+    ts: number;
+    name: string;
+    args?: unknown;
+    result?: unknown;
+    status: 'running' | 'completed' | 'failed';
+    durationMs?: number;
+    detailRef: ToolDetailRef;
+};
+export declare function writeToolDetail(detail: Omit<LocalToolDetail, 'schemaVersion'>): void;
+export declare function readToolDetail(sessionId: string, toolCallId: string): LocalToolDetail | null;

package/dist/src/session/tool-detail-store.js

@@ -0,0 +1,2 @@
+import m from"node:crypto";import n from"node:fs";import r from"node:path";import{resolvePersonalSyncV1Path as a}from"../personal-sync/paths.js";const f=200,u=25*1024*1024;function I(e){const o=y(e.sessionId);n.mkdirSync(o,{recursive:!0,mode:448}),S(r.join(o,`${c(e.toolCallId)}.json`),{schemaVersion:1,...e}),d(o)}function j(e,o){const s=r.join(y(e),`${c(o)}.json`);if(!n.existsSync(s))return null;try{const t=JSON.parse(n.readFileSync(s,"utf8"));return t.schemaVersion===1&&t.sessionId===e&&t.toolCallId===o?t:null}catch{return null}}function y(e){return a("tool-details",c(e))}function c(e){return m.createHash("sha256").update(e).digest("hex")}function S(e,o){const s=`${e}.tmp-${process.pid}-${m.randomBytes(6).toString("hex")}`;let t;try{t=n.openSync(s,"wx",384),n.writeFileSync(t,`${JSON.stringify(o)}
+`,"utf8"),n.fsyncSync(t),n.closeSync(t),t=void 0,n.renameSync(s,e)}finally{t!==void 0&&n.closeSync(t);try{n.unlinkSync(s)}catch{}}}function d(e){const o=n.readdirSync(e).filter(t=>t.endsWith(".json")).map(t=>{const i=r.join(e,t),l=n.statSync(i);return{file:i,bytes:l.size,mtimeMs:l.mtimeMs}}).sort((t,i)=>t.mtimeMs-i.mtimeMs);let s=o.reduce((t,i)=>t+i.bytes,0);for(;o.length>f||s>u;){const t=o.shift();if(!t)return;n.unlinkSync(t.file),s-=t.bytes}}export{j as readToolDetail,I as writeToolDetail};

package/dist/src/session/types.d.ts

@@ -27,19 +27,9 @@ export type ActiveSession = {
     externalReplyTarget?: string | null;
 };
 export type PendingTransfer = {
-    tempPath: string;
-    targetPath: string;
-    totalSize: number;
-    kind?: 'file' | 'folder';
-    rootPath?: string;
-    targetDir?: string;
-    files?: Map<string, PendingTransferFile>;
-};
-export type PendingTransferFile = {
-    relativePath: string;
-    tempPath: string;
-    targetPath: string;
-    size: number;
+    transferId: string;
+    rootPath: string;
+    lastActivityAt: number;
 };
 export type ChatQueueService = {
     handleEnqueue(req: import('@shennian/wire').ReqFrame): Promise<void>;

package/node_modules/@shennian/wire/dist/events.d.ts

@@ -68,6 +68,7 @@ export type AgentEventPayload = {
     name: string;
     args?: Record<string, unknown>;
     detailRef?: ToolDetailRef;
+    durationMs?: number;
 } | {
     state: 'tool-result';
     sessionId?: string;
@@ -76,6 +77,7 @@ export type AgentEventPayload = {
     name: string;
     result?: string;
     detailRef?: ToolDetailRef;
+    durationMs?: number;
 } | {
     state: 'notify';
     source: string;

package/node_modules/@shennian/wire/dist/fs.d.ts

@@ -25,9 +25,54 @@ export type FsChunk = {
 export type FsTransferManifestEntry = {
     relativePath: string;
     size: number;
+    sha256: string;
     mimeType?: string;
     modifiedAt?: number;
 };
+export type FsTransferStartParams = {
+    transferId: string;
+    rootPath: string;
+    name: string;
+    totalSize: number;
+    sha256: string;
+    mimeType: string;
+    kind: 'file' | 'folder';
+    manifest?: FsTransferManifestEntry[];
+};
+export type FsTransferStartResult = {
+    transferId: string;
+    path: string;
+    reused: boolean;
+    offsets: Record<string, number>;
+    attachment?: FsTransferFinishResult;
+};
+export type FsTransferChunkParams = {
+    transferId: string;
+    rootPath: string;
+    offset: number;
+    data: string;
+    relativePath?: string;
+};
+export type FsTransferFinishParams = {
+    transferId: string;
+    rootPath: string;
+};
+export type FsTransferFinishResult = {
+    transferId: string;
+    path: string;
+    name: string;
+    mimeType: string;
+    kind: 'file' | 'folder';
+    byteSize: number;
+    sha256: string;
+    reused: boolean;
+};
+export type FsTransferAbortParams = {
+    transferId: string;
+    rootPath: string;
+};
+/** Stable input for the aggregate hash of a folder transfer. */
+export declare function serializeFsTransferManifest(entries: readonly FsTransferManifestEntry[]): string;
 export type FsRenameResult = {
     oldPath: string;
     newPath: string;

package/node_modules/@shennian/wire/dist/fs.js

@@ -1 +1,7 @@
-export {};
+/** Stable input for the aggregate hash of a folder transfer. */
+export function serializeFsTransferManifest(entries) {
+    return [...entries]
+        .sort((left, right) => left.relativePath.localeCompare(right.relativePath))
+        .map((entry) => `${entry.relativePath}\0${entry.size}\0${entry.sha256.toLowerCase()}`)
+        .join('\n');
+}

package/node_modules/@shennian/wire/dist/index.d.ts

@@ -5,6 +5,7 @@ export * from './methods.ts';
 export * from './frames.ts';
 export * from './fs.ts';
 export * from './session.ts';
+export * from './session-sync.ts';
 export * from './message-payload.ts';
 export * from './external-message-format.ts';
 export * from './native-session.ts';

package/node_modules/@shennian/wire/dist/index.js

@@ -5,6 +5,7 @@ export * from "./methods.js";
 export * from "./frames.js";
 export * from "./fs.js";
 export * from "./session.js";
+export * from "./session-sync.js";
 export * from "./message-payload.js";
 export * from "./external-message-format.js";
 export * from "./native-session.js";

package/node_modules/@shennian/wire/dist/machine.d.ts

@@ -14,6 +14,12 @@ export type Machine = {
     region?: string;
     /** CLI version currently running on this machine */
     cliVersion?: string;
+    /** Stable identity of the daemon data root. It is not the mobile installationId. */
+    daemonInstallationId?: string;
+    /** Personal Session sync protocol understood by this daemon. */
+    sessionSyncProtocolVersion?: import('./session-sync.ts').SessionSyncProtocolVersion;
+    /** Full capability set required by the hard-cutover personal Session protocol. */
+    sessionSyncCapabilities?: import('./session-sync.ts').SessionSyncCapability[];
     /** Auto-upgrade policy configured on this machine */
     autoUpgrade?: AutoUpgradePolicy;
     /** Ownership role — absent means owner (backward-compatible) */

package/node_modules/@shennian/wire/dist/message-payload.d.ts

@@ -4,6 +4,8 @@ export type ChatAttachmentMeta = {
     name: string;
     mimeType: string;
     kind: ChatAttachmentKind;
+    byteSize?: number;
+    sha256?: string;
     previewData?: string;
 };
 export type StructuredUserMessagePayload = {

package/node_modules/@shennian/wire/dist/message-payload.js

@@ -52,7 +52,21 @@ function parseAttachmentMeta(value) {
     if (!path || !name || !mimeType || !kind)
         return null;
     const previewData = typeof entry.previewData === 'string' && entry.previewData.trim() ? entry.previewData.trim() : undefined;
-    return { path, name, mimeType, kind, ...(previewData ? { previewData } : {}) };
+    const byteSize = typeof entry.byteSize === 'number' && Number.isSafeInteger(entry.byteSize) && entry.byteSize >= 0
+        ? entry.byteSize
+        : undefined;
+    const sha256 = typeof entry.sha256 === 'string' && /^[a-f0-9]{64}$/i.test(entry.sha256)
+        ? entry.sha256.toLowerCase()
+        : undefined;
+    return {
+        path,
+        name,
+        mimeType,
+        kind,
+        ...(byteSize !== undefined ? { byteSize } : {}),
+        ...(sha256 ? { sha256 } : {}),
+        ...(previewData ? { previewData } : {}),
+    };
 }
 export function parseStructuredMessagePayload(payload) {
     const parsed = parseObjectPayload(payload);

package/node_modules/@shennian/wire/dist/methods.d.ts

@@ -1 +1 @@
-export type ReqMethod = 'chat.send' | 'chat.enqueue' | 'chat.queue.get' | 'chat.queue.edit' | 'chat.queue.delete' | 'chat.abort' | 'session.resume' | 'session.history' | 'session.refresh' | 'session.tool.detail' | 'session.title.set' | 'fs.ls' | 'fs.read' | 'fs.write' | 'fs.export.markdown-pdf' | 'fs.export.markdown-pdf.setup' | 'fs.archive.zip' | 'fs.transfer' | 'fs.transfer.start' | 'fs.transfer.chunk' | 'fs.transfer.finish' | 'fs.transfer.abort' | 'fs.rename' | 'skill.list' | 'skill.install' | 'skill.doctor' | 'skill.setup' | 'skill.use' | 'region.probe' | 'region.switch' | 'upgrade.start' | 'upgrade.status' | 'upgrade.set-policy' | 'agents.refresh' | 'models.refresh' | 'agent.config.get' | 'agent.config.upsert' | 'agent.config.clear' | 'agent.config.test' | 'agent.capabilities.list' | 'manager.channel.get' | 'manager.channel.upsert' | 'session.wechat-rpa.channel.get' | 'session.wechat-rpa.channel.upsert' | 'session.wechat-rpa.channel.sync' | 'session.wechat-rpa.outbound.cancel' | 'manager.wechat-rpa.channel.get' | 'manager.wechat-rpa.channel.upsert' | 'manager.wechat-rpa.channel.sync' | 'manager.wechat-rpa.outbound.cancel' | 'wechat-rpa.helper.runtime' | 'wecom.send' | 'external.send' | 'room.sync' | 'room.send' | 'room.bind' | 'room.agent.bind-managed' | 'room.agent.restart-managed' | 'room.unbind';
+export type ReqMethod = 'chat.send' | 'chat.enqueue' | 'chat.queue.get' | 'chat.queue.edit' | 'chat.queue.delete' | 'chat.abort' | 'session.resume' | 'session.history' | 'session.history.open' | 'session.history.page' | 'session.history.close' | 'session.index.update' | 'session.message.status' | 'voice.session.body.window' | 'session.refresh' | 'session.tool.detail' | 'session.title.set' | 'fs.ls' | 'fs.read' | 'fs.write' | 'fs.export.markdown-pdf' | 'fs.export.markdown-pdf.setup' | 'fs.archive.zip' | 'fs.transfer.start' | 'fs.transfer.chunk' | 'fs.transfer.finish' | 'fs.transfer.abort' | 'fs.rename' | 'skill.list' | 'skill.install' | 'skill.doctor' | 'skill.setup' | 'skill.use' | 'region.probe' | 'region.switch' | 'upgrade.start' | 'upgrade.status' | 'upgrade.set-policy' | 'agents.refresh' | 'models.refresh' | 'agent.config.get' | 'agent.config.upsert' | 'agent.config.clear' | 'agent.config.test' | 'agent.capabilities.list' | 'manager.channel.get' | 'manager.channel.upsert' | 'session.wechat-rpa.channel.get' | 'session.wechat-rpa.channel.upsert' | 'session.wechat-rpa.channel.sync' | 'session.wechat-rpa.outbound.cancel' | 'manager.wechat-rpa.channel.get' | 'manager.wechat-rpa.channel.upsert' | 'manager.wechat-rpa.channel.sync' | 'manager.wechat-rpa.outbound.cancel' | 'wechat-rpa.helper.runtime' | 'wecom.send' | 'external.send' | 'room.sync' | 'room.send' | 'room.bind' | 'room.agent.bind-managed' | 'room.agent.restart-managed' | 'room.unbind';