shennian 0.3.1 → 0.3.3

package/dist/src/room/room-action-client.d.ts

@@ -0,0 +1,210 @@
+import type { RoomActivationMode, RoomMessageView } from '@shennian/wire';
+type FetchLike = typeof fetch;
+type BindingTarget = {
+    machineToken: string;
+    roomId: string;
+    bindingId: string;
+};
+export type RemoteRoomAgentStatus = {
+    bindingId: string;
+    roomId: string;
+    agentIdentityId: string;
+    agentMembershipId: string | null;
+    status: 'pending_approval' | 'active' | 'paused' | 'detached';
+    activationMode: RoomActivationMode;
+    lastDeliveredSequence: string;
+    lastActivatedSequence: string;
+    room: {
+        name: string;
+        status: string;
+        lastSequence: string;
+    };
+};
+export type RemoteRoomJoinResult = {
+    outcome: 'joined' | 'pending_approval';
+    room: {
+        id: string;
+        name: string;
+        webUrl: string;
+    };
+    agentIdentity: {
+        id: string;
+        displayName: string;
+    };
+    binding: {
+        id: string;
+        roomId: string;
+        agentIdentityId: string;
+        agentMembershipId: string | null;
+        status: 'pending_approval' | 'active' | 'paused';
+        activationMode: RoomActivationMode;
+    };
+    joinRequestId?: string;
+    idempotent: boolean;
+};
+export type RemoteRoomAttachmentCapability = {
+    attachmentId: string;
+    roomId: string;
+    safeName: string;
+    mimeType: string;
+    byteSize: string;
+    sha256: string;
+    downloadUrl: string;
+    expiresAt: string;
+};
+export type RemoteRoomAttachmentUpload = {
+    attachment: {
+        id: string;
+        roomId: string;
+        name: string;
+        mimeType: string;
+        byteSize: string;
+        sha256: string;
+        status: 'pending' | 'uploaded';
+    };
+    upload: {
+        method: 'PUT';
+        url: string;
+        headers: Record<string, string>;
+        expiresAt: string;
+    };
+    idempotent: boolean;
+};
+export type RemoteRoomCreateResult = {
+    outcome: 'created';
+    room: {
+        id: string;
+        name: string;
+        visibility: 'private';
+        joinPolicy: 'approval';
+        webUrl: string;
+        inviteUrl: string;
+    };
+    agentIdentity: {
+        id: string;
+        displayName: string;
+    };
+    binding: {
+        id: string;
+        roomId: string;
+        agentIdentityId: string;
+        agentMembershipId: string;
+        status: 'active' | 'paused';
+        activationMode: RoomActivationMode;
+    };
+    idempotent: boolean;
+};
+export type RemoteOperatorRoomCreateResult = {
+    outcome: 'created';
+    room: {
+        id: string;
+        name: string;
+        visibility: 'private';
+        joinPolicy: 'approval';
+        webUrl: string;
+    };
+};
+export declare class RoomActionHttpError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare class HttpRoomActionClient {
+    private readonly fetchImpl;
+    private readonly baseUrl;
+    constructor(serverUrl: string, fetchImpl?: FetchLike);
+    createOperatorRoom(input: {
+        machineToken: string;
+        name: string;
+    }): Promise<RemoteOperatorRoomCreateResult>;
+    resolveNativeSession(input: {
+        machineToken: string;
+        runtimeAdapter: 'codex' | 'claude_code' | 'workbuddy';
+        sourceSessionKey: string;
+    }): Promise<{
+        nianSessionId: string;
+        created: boolean;
+    }>;
+    createRoom(input: {
+        machineToken: string;
+        bindingIntentId: string;
+        nianSessionId: string;
+        runtimeAdapter: 'codex' | 'claude_code' | 'workbuddy';
+        sessionRegistryKey: string;
+        name: string;
+        agentAlias: string;
+        agentDescription?: string;
+        activationCapability: 'managed' | 'idle_resume' | 'notify_only';
+        activationMode: RoomActivationMode;
+    }): Promise<RemoteRoomCreateResult>;
+    joinRoom(input: {
+        machineToken: string;
+        bindingIntentId: string;
+        nianSessionId: string;
+        runtimeAdapter: 'codex' | 'claude_code' | 'workbuddy';
+        sessionRegistryKey: string;
+        inviteToken: string;
+        message?: string;
+        agentAlias: string;
+        agentDescription?: string;
+        activationCapability: 'managed' | 'idle_resume' | 'notify_only';
+        activationMode: RoomActivationMode;
+    }): Promise<RemoteRoomJoinResult>;
+    status(target: BindingTarget): Promise<RemoteRoomAgentStatus>;
+    getAttachmentCapability(target: BindingTarget & {
+        attachmentId: string;
+    }): Promise<RemoteRoomAttachmentCapability>;
+    initializeAttachment(target: BindingTarget & {
+        clientUploadId: string;
+        name: string;
+        mediaKind: 'image' | 'audio' | 'file';
+        mimeType: string;
+        byteSize: number;
+        sha256: string;
+    }): Promise<RemoteRoomAttachmentUpload>;
+    completeAttachment(target: BindingTarget & {
+        attachmentId: string;
+    }): Promise<{
+        attachment: {
+            attachmentId: string;
+            mediaKind: 'image' | 'audio' | 'file';
+            name: string;
+            mimeType: string;
+            byteSize: string;
+            sha256: string;
+            status: 'ready';
+        };
+        idempotent: boolean;
+    }>;
+    read(target: BindingTarget & {
+        afterSequence: string;
+        limit: number;
+    }): Promise<{
+        messages: RoomMessageView[];
+        nextSequence: string;
+        hasMore: boolean;
+        historyFromSequence: string;
+        roomName: string;
+    }>;
+    send(target: BindingTarget & {
+        clientMessageId: string;
+        text: string;
+        mentionMembershipIds?: string[];
+        replyToMessageId?: string;
+        activationCauseMessageId?: string;
+        attachmentIds?: string[];
+    }): Promise<{
+        message: RoomMessageView;
+        idempotent: boolean;
+    }>;
+    mode(target: BindingTarget & {
+        activationMode: RoomActivationMode;
+    }): Promise<{
+        bindingId: string;
+        roomId: string;
+        status: 'active' | 'paused';
+        activationMode: RoomActivationMode;
+        idempotent: boolean;
+    }>;
+    private request;
+}
+export {};

package/dist/src/room/room-action-client.js

@@ -0,0 +1 @@
+class c extends Error{code;constructor(e,o){super(o),this.code=e,this.name="RoomActionHttpError"}}class j{fetchImpl;baseUrl;constructor(e,o=fetch){this.fetchImpl=o,this.baseUrl=e.replace(/\/+$/,"")}async createOperatorRoom(e){let o;try{o=await this.fetchImpl(`${this.baseUrl}/api/rooms/actions/operator/create`,{method:"POST",headers:{authorization:`Bearer ${e.machineToken}`,"content-type":"application/json"},body:JSON.stringify({name:e.name}),signal:AbortSignal.timeout(1e4)})}catch{throw new c("room_action_server_unavailable","Shennian Room service is unavailable.")}const t=await m(o);if(!o.ok)throw p(o.status,t);return I(t,e,this.baseUrl)}async resolveNativeSession(e){let o;try{o=await this.fetchImpl(`${this.baseUrl}/api/rooms/actions/resolve-session`,{method:"POST",headers:{authorization:`Bearer ${e.machineToken}`,"content-type":"application/json"},body:JSON.stringify({runtimeAdapter:e.runtimeAdapter,sourceSessionKey:e.sourceSessionKey}),signal:AbortSignal.timeout(1e4)})}catch{throw new c("room_action_server_unavailable","Shennian Room service is unavailable.")}const t=await m(o);if(!o.ok)throw p(o.status,t);(!t||typeof t!="object")&&a();const n=t;return(typeof n.nianSessionId!="string"||!/^[A-Za-z0-9_.:@/-]{1,512}$/.test(n.nianSessionId)||typeof n.created!="boolean")&&a(),n}async createRoom(e){let o;try{o=await this.fetchImpl(`${this.baseUrl}/api/rooms/actions/create`,{method:"POST",headers:{authorization:`Bearer ${e.machineToken}`,"content-type":"application/json"},body:JSON.stringify({bindingIntentId:e.bindingIntentId,nianSessionId:e.nianSessionId,runtimeAdapter:e.runtimeAdapter,sessionRegistryKey:e.sessionRegistryKey,name:e.name,agentAlias:e.agentAlias,agentDescription:e.agentDescription,activationCapability:e.activationCapability,activationMode:e.activationMode}),signal:AbortSignal.timeout(1e4)})}catch{throw new c("room_action_server_unavailable","Shennian Room service is unavailable.")}const t=await m(o);if(!o.ok)throw p(o.status,t);return g(t,e,this.baseUrl)}async joinRoom(e){let o;try{o=await this.fetchImpl(`${this.baseUrl}/api/rooms/actions/join`,{method:"POST",headers:{authorization:`Bearer ${e.machineToken}`,"content-type":"application/json"},body:JSON.stringify({bindingIntentId:e.bindingIntentId,nianSessionId:e.nianSessionId,runtimeAdapter:e.runtimeAdapter,sessionRegistryKey:e.sessionRegistryKey,inviteToken:e.inviteToken,message:e.message,agentAlias:e.agentAlias,agentDescription:e.agentDescription,activationCapability:e.activationCapability,activationMode:e.activationMode}),signal:AbortSignal.timeout(1e4)})}catch{throw new c("room_action_server_unavailable","Shennian Room service is unavailable.")}const t=await m(o);if(!o.ok)throw p(o.status,t);return v(t,e,this.baseUrl)}async status(e){const o=await this.request(e,"status");return b(o,e)}async getAttachmentCapability(e){const o=await this.request(e,`attachments/${encodeURIComponent(e.attachmentId)}/download-capability`);(!o||typeof o!="object")&&a();const t=o;return(t.attachmentId!==e.attachmentId||t.roomId!==e.roomId||typeof t.safeName!="string"||!S(t.safeName)||typeof t.mimeType!="string"||t.mimeType.length<1||t.mimeType.length>191||typeof t.byteSize!="string"||!d(t.byteSize)||typeof t.sha256!="string"||!/^[a-f0-9]{64}$/.test(t.sha256)||!h(t.downloadUrl)||typeof t.expiresAt!="string"||!Number.isFinite(Date.parse(t.expiresAt)))&&a(),t}async initializeAttachment(e){const o=await this.request(e,"attachments/init",{method:"POST",body:JSON.stringify({clientUploadId:e.clientUploadId,name:e.name,mediaKind:e.mediaKind,mimeType:e.mimeType,byteSize:e.byteSize,sha256:e.sha256})});(!o||typeof o!="object")&&a();const t=o,n=t.attachment,r=t.upload;return(!n||typeof n.id!="string"||n.roomId!==e.roomId||n.name.length<1||n.mimeType!==e.mimeType||n.byteSize!==String(e.byteSize)||n.sha256!==e.sha256||n.status!=="pending"&&n.status!=="uploaded"||!r||r.method!=="PUT"||!h(r.url)||!r.headers||r.headers["content-type"]!==e.mimeType||r.headers["x-oss-meta-sha256"]!==e.sha256||typeof r.expiresAt!="string"||Date.parse(r.expiresAt)<=Date.now()||typeof t.idempotent!="boolean")&&a(),t}async completeAttachment(e){const o=await this.request(e,`attachments/${encodeURIComponent(e.attachmentId)}/complete`,{method:"POST"});(!o||typeof o!="object")&&a();const t=o;typeof t.idempotent!="boolean"&&a();const n=t.attachment;return(!n||n.attachmentId!==e.attachmentId||n.mediaKind!=="image"&&n.mediaKind!=="audio"&&n.mediaKind!=="file"||typeof n.name!="string"||typeof n.mimeType!="string"||typeof n.byteSize!="string"||!d(n.byteSize)||typeof n.sha256!="string"||!/^[a-f0-9]{64}$/.test(n.sha256)||n.status!=="ready")&&a(),{attachment:n,idempotent:t.idempotent}}async read(e){const o=new URLSearchParams({after:e.afterSequence,limit:String(e.limit)}),t=await this.request(e,`messages?${o}`);(!t||typeof t!="object")&&a();const n=t;return(!Array.isArray(n.messages)||typeof n.nextSequence!="string"||!d(n.nextSequence)||typeof n.hasMore!="boolean"||typeof n.historyFromSequence!="string"||!d(n.historyFromSequence)||typeof n.roomName!="string")&&a(),{messages:n.messages.map(s=>l(s,e.roomId)),nextSequence:n.nextSequence,hasMore:n.hasMore,historyFromSequence:n.historyFromSequence,roomName:n.roomName}}async send(e){const o=await this.request(e,"messages",{method:"POST",body:JSON.stringify({clientMessageId:e.clientMessageId,text:e.text,mentionMembershipIds:e.mentionMembershipIds,replyToMessageId:e.replyToMessageId,activationCauseMessageId:e.activationCauseMessageId,attachmentIds:e.attachmentIds})});(!o||typeof o!="object")&&a();const t=o;return typeof t.idempotent!="boolean"&&a(),{message:l(t.message,e.roomId),idempotent:t.idempotent}}async mode(e){const o=await this.request(e,"mode",{method:"PATCH",body:JSON.stringify({activationMode:e.activationMode})});(!o||typeof o!="object")&&a();const t=o;return(t.bindingId!==e.bindingId||t.roomId!==e.roomId||t.status!=="active"&&t.status!=="paused"||!f(t.activationMode)||t.activationMode!==e.activationMode||typeof t.idempotent!="boolean")&&a(),t}async request(e,o,t={}){let n;try{n=await this.fetchImpl(`${this.baseUrl}/api/rooms/${encodeURIComponent(e.roomId)}/bindings/${encodeURIComponent(e.bindingId)}/${o}`,{...t,headers:{authorization:`Bearer ${e.machineToken}`,...t.body?{"content-type":"application/json"}:{}},signal:AbortSignal.timeout(1e4)})}catch{throw new c("room_action_server_unavailable","Shennian Room service is unavailable.")}if(!n.ok){let r=`room_action_http_${n.status}`;try{const s=await n.json();typeof s.error=="string"&&/^[a-z0-9_-]{1,80}$/.test(s.error)&&(r=s.error)}catch{}throw new c(r,"Shennian Room action failed.")}try{return await n.json()}catch{a()}}}function b(i,e){(!i||typeof i!="object")&&a();const o=i,t=o.room;(o.bindingId!==e.bindingId||o.roomId!==e.roomId||typeof o.agentIdentityId!="string"||o.agentMembershipId!==null&&typeof o.agentMembershipId!="string"||o.status!=="pending_approval"&&o.status!=="active"&&o.status!=="paused"&&o.status!=="detached"||!f(o.activationMode)||typeof o.lastDeliveredSequence!="string"||!d(o.lastDeliveredSequence)||typeof o.lastActivatedSequence!="string"||!d(o.lastActivatedSequence)||!t||typeof t!="object")&&a(),(o.status==="pending_approval"&&o.agentMembershipId!==null||(o.status==="active"||o.status==="paused")&&typeof o.agentMembershipId!="string")&&a();const n=t;return(typeof n.name!="string"||typeof n.status!="string"||typeof n.lastSequence!="string"||!d(n.lastSequence))&&a(),o}function l(i,e){(!i||typeof i!="object")&&a();const o=i;if((typeof o.id!="string"||o.roomId!==e||typeof o.sequence!="string"||!d(o.sequence)||!o.author||typeof o.author.membershipId!="string"||!Array.isArray(o.attachments)||typeof o.createdAt!="string")&&a(),o.activationCause!=null){const t=o.activationCause;(typeof t.causeMessageId!="string"||typeof t.rootCauseMessageId!="string"||!Number.isInteger(t.hopCount)||t.hopCount<1||t.hopCount>32)&&a()}return o}function g(i,e,o){(!i||typeof i!="object")&&a();const t=i,n=t.room,r=t.agentIdentity,s=t.binding;return(t.outcome!=="created"||!n||typeof n.id!="string"||n.name!==e.name||n.visibility!=="private"||n.joinPolicy!=="approval"||!y(n.webUrl,o,`/spaces/${n.id}`)||!w(n.inviteUrl,o)||!r||typeof r.id!="string"||r.displayName!==e.agentAlias||!s||typeof s.id!="string"||s.roomId!==n.id||s.agentIdentityId!==r.id||typeof s.agentMembershipId!="string"||s.status!=="active"&&s.status!=="paused"||s.activationMode!==e.activationMode||typeof t.idempotent!="boolean")&&a(),t}function I(i,e,o){(!i||typeof i!="object")&&a();const t=i,n=t.room;return(t.outcome!=="created"||!n||typeof n.id!="string"||n.name!==e.name||n.visibility!=="private"||n.joinPolicy!=="approval"||!y(n.webUrl,o,`/spaces/${n.id}`))&&a(),t}function v(i,e,o){(!i||typeof i!="object")&&a();const t=i,n=t.room,r=t.agentIdentity,s=t.binding;return(t.outcome!=="joined"&&t.outcome!=="pending_approval"||!n||typeof n.id!="string"||typeof n.name!="string"||!y(n.webUrl,o,`/spaces/${n.id}`)||!r||typeof r.id!="string"||r.displayName!==e.agentAlias||!s||typeof s.id!="string"||s.roomId!==n.id||s.agentIdentityId!==r.id||s.activationMode!==e.activationMode||typeof t.idempotent!="boolean")&&a(),(t.outcome==="pending_approval"&&(s.status!=="pending_approval"||s.agentMembershipId!==null||typeof t.joinRequestId!="string")||t.outcome==="joined"&&(s.status!=="active"&&s.status!=="paused"||typeof s.agentMembershipId!="string"||t.joinRequestId!==void 0))&&a(),t}function d(i){return/^(0|[1-9]\d{0,19})$/.test(i)}function S(i){return i.length<=255&&i===i.trim()&&i!=="."&&i!==".."&&!/[\\/\0-\x1f\x7f]/.test(i)}function h(i){if(typeof i!="string")return!1;try{const e=new URL(i);return e.protocol==="https:"&&!e.username&&!e.password&&!e.hash}catch{return!1}}function f(i){return i==="auto_follow"||i==="mention_only"||i==="paused"}function a(){throw new c("invalid_room_action_response","Invalid Room action response.")}async function m(i){try{return await i.json()}catch{a()}}function p(i,e){let o=`room_action_http_${i}`;if(e&&typeof e=="object"){const t=e.error;typeof t=="string"&&/^[a-z0-9_-]{1,80}$/.test(t)&&(o=t)}return new c(o,"Shennian Room action failed.")}function y(i,e,o){return u(i,e,t=>t.pathname===o)}function w(i,e){return u(i,e,o=>/^\/spaces\/join\/[A-Za-z0-9_-]{43}$/.test(o.pathname))}function u(i,e,o){if(typeof i!="string")return!1;try{const t=new URL(i),n=new URL(e);return t.hostname===n.hostname&&(t.protocol==="https:"||n.protocol==="http:"&&t.protocol==="http:")&&!t.username&&!t.password&&!t.search&&!t.hash&&o(t)}catch{return!1}}export{j as HttpRoomActionClient,c as RoomActionHttpError};

package/dist/src/room/room-action-ipc.d.ts

@@ -0,0 +1,33 @@
+import type { DaemonIpcHandler } from '../daemon-ipc/server.js';
+import { RoomInvocationTokenAuthority } from './invocation-token.js';
+import type { RoomAttachmentCache } from './attachment-cache.js';
+import { HttpRoomActionClient } from './room-action-client.js';
+import { RoomSessionRegistry } from './session-registry.js';
+import type { RoomAttachmentUploader } from './attachment-upload.js';
+import type { RoomHostSessionObservationStore } from './host-session-observations.js';
+type RoomMirrorWriter = {
+    append(input: {
+        messages: Awaited<ReturnType<HttpRoomActionClient['read']>>['messages'];
+        historyFromSequence: string;
+        roomName?: string | null;
+    }): unknown;
+    markAccessRevoked(): void;
+    search(input: {
+        query: string;
+        limit?: number;
+    }): unknown;
+};
+export declare function createRoomActionIpcHandlers(input: {
+    authority: RoomInvocationTokenAuthority;
+    registry: RoomSessionRegistry;
+    actionClient: Pick<HttpRoomActionClient, 'createRoom' | 'joinRoom' | 'read' | 'send' | 'mode' | 'status'>;
+    getMachineCredentials: () => {
+        machineId?: string;
+        machineToken?: string;
+    };
+    mirrorFactory?: (roomId: string) => RoomMirrorWriter;
+    attachmentCache?: Pick<RoomAttachmentCache, 'materialize'>;
+    attachmentUploader?: Pick<RoomAttachmentUploader, 'upload'>;
+    observations?: RoomHostSessionObservationStore;
+}): Record<string, DaemonIpcHandler>;
+export {};

package/dist/src/room/room-action-ipc.js

@@ -0,0 +1 @@
+import{DaemonIpcError as a}from"../daemon-ipc/protocol.js";import{normalizeRoomActionParameters as R}from"./room-action-schema.js";function B(e){return{"room-action.execute":async o=>{const h=T(o),l=e.getMachineCredentials();if(!l.machineId?.trim()||!l.machineToken?.trim())throw new a("machine_not_authorized","This machine is not authorized yet.");const s=w(h.registryKey,"registryKey",64),A=w(h.invocationToken,"invocationToken",128),d=S(h.action),u=R(d,h.actionParameters);return e.registry.runExclusive(s,async()=>{let y;try{y=e.authority.consume({invocationToken:A,machineId:l.machineId,machineCredential:l.machineToken,registryKey:s,action:d,targetTool:"shennian_room",actionParameters:u})}catch(t){throw C(t)}const r=e.registry.getByRegistryKey(s),i=r?.binding;if(!r)throw new a("room_session_unavailable","The exact Agent session is unavailable.");if(d==="room.create"){if(i&&i.status!=="detached")throw new a("session_already_bound","This Agent session is already bound to a Room.");if(!y.bindingIntentId)throw new a("binding_intent_missing","Room create intent is missing.");const t=u,n=await e.actionClient.createRoom({machineToken:l.machineToken,bindingIntentId:y.bindingIntentId,nianSessionId:r.nianSessionId,runtimeAdapter:r.runtimeAdapter,sessionRegistryKey:s,name:t.name,agentAlias:t.agentAlias,agentDescription:t.agentDescription,activationCapability:_(r.capabilities),activationMode:t.activationMode});return e.registry.setBinding({registryKey:s,bindingId:n.binding.id,roomId:n.room.id,agentIdentityId:n.binding.agentIdentityId,agentMembershipId:n.binding.agentMembershipId,status:n.binding.status,activationMode:n.binding.activationMode}),g(n)}if(d==="room.join"){if(i&&i.status!=="detached")throw new a("session_already_bound","This Agent session is already bound to a Room.");if(!y.bindingIntentId)throw new a("binding_intent_missing","Room join intent is missing.");const t=u,n=await e.actionClient.joinRoom({machineToken:l.machineToken,bindingIntentId:y.bindingIntentId,nianSessionId:r.nianSessionId,runtimeAdapter:r.runtimeAdapter,sessionRegistryKey:s,inviteToken:k(t.inviteUrl),message:t.message,agentAlias:t.agentAlias,agentDescription:t.agentDescription,activationCapability:_(r.capabilities),activationMode:t.activationMode});return e.registry.setBinding({registryKey:s,bindingId:n.binding.id,roomId:n.room.id,agentIdentityId:n.binding.agentIdentityId,agentMembershipId:n.binding.agentMembershipId,status:n.binding.status,activationMode:n.binding.activationMode}),g(n)}if(!i)throw new a("room_not_bound","This Agent session is not bound to a Room.");if(d!=="room.status"&&(i.status==="detached"||i.status==="pending_approval"))throw new a(i.status==="pending_approval"?"room_binding_pending_approval":"room_binding_detached",i.status==="pending_approval"?"This Agent is waiting for Room approval.":"This Agent Room binding must be repaired before use.");const I={machineToken:l.machineToken,roomId:i.roomId,bindingId:i.bindingId};if(d==="room.status"){const t=await e.actionClient.status(I);e.registry.setBinding({registryKey:s,bindingId:t.bindingId,roomId:t.roomId,agentIdentityId:t.agentIdentityId,agentMembershipId:t.agentMembershipId,status:t.status,activationMode:t.activationMode}),t.status==="detached"&&e.mirrorFactory?.(t.roomId).markAccessRevoked();const n=e.registry.getByRegistryKey(s),c=n?.binding,m=e.observations?.getBySource(r);return g({...t,hostSession:{state:n?.lifecycleState??"closed",lastReportedEvent:m?.lastEventName??null,lastActiveAt:m?.lastActiveAt??null,lastIdleAt:m?.lastIdleAt??null,closedAt:m?.closedAt??null,closedConfirmed:m?.lifecycleState==="closed",activationCapability:_(r.capabilities)},localActivation:{queued:c?.activationQueue.length??0,inFlight:!!c?.activeActivation,pausedUntil:c?.loopBreaker.pausedUntil??null}})}if(d==="room.read"){const t=u;if(t.query){const b=e.mirrorFactory?.(i.roomId);if(!b)throw new a("room_mirror_unavailable","Room mirror is unavailable.");return g({source:"local_mirror",matches:b.search({query:t.query,limit:t.limit})})}const n=await e.actionClient.read({...I,afterSequence:t.afterSequence,limit:t.limit});e.mirrorFactory?.(i.roomId).append({messages:n.messages,historyFromSequence:n.historyFromSequence,roomName:n.roomName});const c=BigInt(n.nextSequence)>BigInt(i.lastDeliveredSequence)?n.nextSequence:i.lastDeliveredSequence;e.registry.advanceCursor({registryKey:s,cursor:"delivered",sequence:c});const m=[];for(const b of t.attachmentIds??[]){const v=n.messages.flatMap(p=>p.attachments).find(p=>p.attachmentId===b);if(!v||v.status!=="ready")throw new a("attachment_not_in_read_result","Requested attachment is not available in this read result.");if(!e.attachmentCache)throw new a("attachment_cache_unavailable","Room attachment cache is unavailable.");m.push({attachmentId:b,...await e.attachmentCache.materialize({...I,attachmentId:b,expected:{downloadRef:v.downloadRef,byteSize:v.byteSize,sha256:v.sha256}})})}return g({...n,materializedAttachments:m})}if(d==="room.send"){const t=u;let n;if(t.files?.length){const c=e.observations?.getBySource(r);if(!c?.workspacePath||!e.attachmentUploader)throw new a("room_attachment_upload_unavailable","The exact Agent workspace is unavailable for attachment upload.");n=await e.attachmentUploader.upload({...I,workspacePath:c.workspacePath,clientMessageId:t.clientMessageId,files:t.files})}return g(await e.actionClient.send({...I,clientMessageId:t.clientMessageId,text:t.text,mentionMembershipIds:t.mentionMembershipIds,replyToMessageId:t.replyToMessageId,attachmentIds:n,activationCauseMessageId:i.activeActivation?.causeMessageId}))}const M=u,f=await e.actionClient.mode({...I,...M});return e.registry.setBinding({registryKey:s,bindingId:i.bindingId,roomId:i.roomId,agentIdentityId:i.agentIdentityId,agentMembershipId:i.agentMembershipId,status:f.status,activationMode:f.activationMode}),g(f)})}}}function T(e){if(!e||Array.isArray(e)||typeof e!="object")throw new a("invalid_params","Room action parameters are required.");return e}function w(e,o,h){if(typeof e!="string"||!e.trim()||e.length>h)throw new a("invalid_params",`${o} is invalid.`);return e.trim()}function S(e){const o=w(e,"action",64);if(o!=="room.read"&&o!=="room.create"&&o!=="room.join"&&o!=="room.send"&&o!=="room.mode"&&o!=="room.status")throw new a("room_action_not_implemented","Room action is not available yet.");return o}function k(e){const o=new URL(e).pathname.split("/").at(-1);if(!o||!/^[A-Za-z0-9_-]{43}$/.test(o))throw new a("invalid_params","inviteUrl is invalid.");return o}function _(e){return e.canResumeIdleSession||e.canActivateWhileHostOpen?"idle_resume":"notify_only"}function C(e){return e&&typeof e=="object"&&"code"in e&&typeof e.code=="string"&&"message"in e&&typeof e.message=="string"?new a(e.code,e.message):new a("room_invocation_failed","Room invocation failed.")}function g(e){return JSON.parse(JSON.stringify(e))}export{B as createRoomActionIpcHandlers};

package/dist/src/room/room-action-schema.d.ts

@@ -0,0 +1,3 @@
+import type { RoomInvocationAction } from './invocation-token.js';
+import type { JsonValue } from './pending-authorized-actions.js';
+export declare function normalizeRoomActionParameters(action: Exclude<RoomInvocationAction, 'room.bind'>, value: JsonValue | undefined): JsonValue;

package/dist/src/room/room-action-schema.js

@@ -0,0 +1 @@
+import{DaemonIpcError as l}from"../daemon-ipc/protocol.js";function I(t,n){const e=h(n);switch(t){case"room.status":return d(e,[]),{};case"room.read":{d(e,["afterSequence","limit","attachmentIds","query"]);const s=o(e.query,"query",200),i=e.afterSequence??"0",a=e.limit??50;(typeof i!="string"||!/^(0|[1-9]\d{0,19})$/.test(i))&&r("afterSequence"),(typeof a!="number"||!Number.isInteger(a)||a<1||a>100)&&r("limit");const m=g(e.attachmentIds,"attachmentIds",10);return s&&(e.afterSequence!=null||m)&&r("parameters"),s?{query:s,limit:a}:{afterSequence:i,limit:a,...m?{attachmentIds:m}:{}}}case"room.send":{d(e,["clientMessageId","text","files","mentionMembershipIds","replyToMessageId"]);const s=c(e.clientMessageId,"clientMessageId",191),i=o(e.text,"text",2e4),a=u(e.files,"files",10);!i&&!a&&r("parameters");const m=g(e.mentionMembershipIds,"mentionMembershipIds",20),p=o(e.replyToMessageId,"replyToMessageId",191);return{clientMessageId:s,text:i??"",...a?{files:a}:{},...m?{mentionMembershipIds:m}:{},...p?{replyToMessageId:p}:{}}}case"room.mode":return d(e,["activationMode"]),{activationMode:f(e.activationMode)};case"room.create":return d(e,["name","agentAlias","agentDescription","activationMode"]),{name:c(e.name,"name",80),agentAlias:c(e.agentAlias,"agentAlias",80),...o(e.agentDescription,"agentDescription",1e3)?{agentDescription:o(e.agentDescription,"agentDescription",1e3)}:{},activationMode:f(e.activationMode??"auto_follow")};case"room.join":return d(e,["inviteUrl","agentAlias","agentDescription","message","activationMode"]),{inviteUrl:y(e.inviteUrl),agentAlias:c(e.agentAlias,"agentAlias",80),...o(e.agentDescription,"agentDescription",1e3)?{agentDescription:o(e.agentDescription,"agentDescription",1e3)}:{},activationMode:f(e.activationMode??"auto_follow"),...o(e.message,"message",500)?{message:o(e.message,"message",500)}:{}}}}function u(t,n,e){return t==null?void 0:((!Array.isArray(t)||t.length<1||t.length>e)&&r(n),t.map(i=>((typeof i!="string"||!i.trim()||i.length>4096||/[\0\r\n]/.test(i))&&r(n),i.trim())))}function h(t){return t==null?{}:((Array.isArray(t)||typeof t!="object")&&r("parameters"),t)}function d(t,n){const e=new Set(n);Object.keys(t).some(s=>!e.has(s))&&r("parameters")}function c(t,n,e){return(typeof t!="string"||!t.trim()||t.length>e||/[\0\r]/.test(t))&&r(n),t.trim()}function o(t,n,e){if(!(t==null||t===""))return c(t,n,e)}function g(t,n,e){if(t==null)return;(!Array.isArray(t)||t.length>e)&&r(n);const s=t.map(i=>c(i,n,191));return new Set(s).size!==s.length&&r(n),s.length>0?s:void 0}function f(t){if(t==="auto"||t==="auto_follow")return"auto_follow";if(t==="mention"||t==="mention_only")return"mention_only";if(t==="paused")return"paused";r("activationMode")}function y(t){const n=c(t,"inviteUrl",2048);let e;try{e=new URL(n)}catch{r("inviteUrl")}return(e.protocol!=="https:"||e.hostname!=="shennian.net"||!/^\/spaces\/join\/[A-Za-z0-9_-]{43}$/.test(e.pathname)||e.username||e.password||e.search||e.hash)&&r("inviteUrl"),e.toString()}function r(t){throw new l("invalid_params",`${t} is invalid.`)}export{I as normalizeRoomActionParameters};

package/dist/src/room/room-authorized-action-executor.d.ts

@@ -0,0 +1,23 @@
+import type { AuthorizedActionExecutor } from './authorized-action-coordinator.js';
+import type { RoomHostSessionObservationStore } from './host-session-observations.js';
+import type { HttpRoomBindingClient } from './room-binding-client.js';
+import type { JsonValue, PendingAuthorizedAction } from './pending-authorized-actions.js';
+import type { RoomSessionRegistry } from './session-registry.js';
+type Credentials = {
+    machineId: string;
+    machineToken: string;
+};
+export declare class RoomAuthorizedActionExecutor implements AuthorizedActionExecutor {
+    private readonly deps;
+    constructor(deps: {
+        registry: RoomSessionRegistry;
+        observations: RoomHostSessionObservationStore;
+        actionClient: Pick<HttpRoomBindingClient, 'resolveNativeSession' | 'createRoom' | 'joinRoom'>;
+        getMachineCredentials: () => {
+            machineId?: string;
+            machineToken?: string;
+        };
+    });
+    execute(action: PendingAuthorizedAction, claimed?: Credentials): Promise<JsonValue>;
+}
+export {};

package/dist/src/room/room-authorized-action-executor.js

@@ -0,0 +1 @@
+import g from"node:path";import{normalizeRoomActionParameters as f}from"./room-action-schema.js";class H{deps;constructor(e){this.deps=e}async execute(e,m){const s=I(m??this.deps.getMachineCredentials()),n=A(e),r=this.deps.observations.observe({machineId:s.machineId,runtimeAdapter:n.runtimeAdapter,sourceSessionKey:n.sourceSessionKey,hostContextHash:n.hostContextHash,workspaceHash:n.workspaceHash,workspacePath:n.workspacePath,lifecycleState:"active",eventName:"PreToolUse"}),c=await this.deps.actionClient.resolveNativeSession({machineToken:s.machineToken,runtimeAdapter:n.runtimeAdapter,sourceSessionKey:n.sourceSessionKey}),i=!!r.workspacePath,p=this.deps.registry.register({machineId:s.machineId,runtimeAdapter:n.runtimeAdapter,sourceSessionKey:n.sourceSessionKey,nianSessionId:c.nianSessionId,hostProcessIdentity:`${n.runtimeAdapter}:${r.hostContextHash}:${r.registrationEpoch}`,capabilities:{canIdentifySession:!0,canBindAutomatically:!0,canOpenEmbeddedRoomPage:!1,canResumeIdleSession:i,canActivateWhileHostOpen:!1}}),y=i?"idle_resume":"notify_only",l=`${n.action.replace(".","-")}:${e.id}`,h={machineToken:s.machineToken,bindingIntentId:l,nianSessionId:c.nianSessionId,runtimeAdapter:n.runtimeAdapter,sessionRegistryKey:p.registryKey,agentAlias:n.parameters.agentAlias,agentDescription:n.parameters.agentDescription,activationCapability:y,activationMode:n.parameters.activationMode},o=n.action==="room.create"?await this.deps.actionClient.createRoom({...h,name:n.parameters.name}):await this.deps.actionClient.joinRoom({...h,inviteToken:w(n.parameters.inviteUrl),message:n.parameters.message});return this.deps.registry.setBinding({registryKey:p.registryKey,bindingId:o.binding.id,roomId:o.room.id,agentIdentityId:o.binding.agentIdentityId,agentMembershipId:o.binding.agentMembershipId,status:o.binding.status,activationMode:o.binding.activationMode}),JSON.parse(JSON.stringify(o))}}function A(t){const e=t.canonicalActionPayload;(!e||Array.isArray(e)||typeof e!="object"||e.schemaVersion!==1)&&a();const m=k(e.runtimeAdapter),s=d(e.sourceSessionKey,1024),n=u(e.hostContextHash),r=e.workspaceHash==null?null:u(e.workspaceHash),c=S(e.workspacePath);e.lifecycleState!=="active"&&a(),(e.action!==t.actionType||e.action!=="room.create"&&e.action!=="room.join")&&a();const i=f(e.action,e.actionParameters);return(!i||Array.isArray(i)||typeof i!="object")&&a(),{runtimeAdapter:m,sourceSessionKey:s,hostContextHash:n,workspaceHash:r,workspacePath:c,action:e.action,parameters:{name:typeof i.name=="string"?i.name:"",inviteUrl:typeof i.inviteUrl=="string"?i.inviteUrl:"",agentAlias:d(i.agentAlias,80),...typeof i.agentDescription=="string"?{agentDescription:i.agentDescription}:{},activationMode:b(i.activationMode),...typeof i.message=="string"?{message:i.message}:{}}}}function I(t){if(!t.machineId?.trim()||!t.machineToken?.trim())throw new Error("machine_credentials_unavailable");return{machineId:t.machineId.trim(),machineToken:t.machineToken.trim()}}function k(t){return t!=="codex"&&t!=="claude_code"&&t!=="workbuddy"&&a(),t}function b(t){return t!=="auto_follow"&&t!=="mention_only"&&t!=="paused"&&a(),t}function d(t,e){return(typeof t!="string"||!t.trim()||t.length>e||/[\0\r\n]/.test(t))&&a(),t.trim()}function u(t){const e=d(t,64);return/^[a-f0-9]{64}$/.test(e)||a(),e}function S(t){if(t==null||t==="")return null;const e=d(t,4096);return g.isAbsolute(e)||a(),e}function w(t){const e=/^https:\/\/shennian\.net\/spaces\/join\/([A-Za-z0-9_-]{43})$/.exec(t);return e||a(),e[1]}function a(){throw new Error("invalid_room_authorized_action")}export{H as RoomAuthorizedActionExecutor};

package/dist/src/room/room-binding-client.d.ts

@@ -0,0 +1,51 @@
+import type { RoomActivationCapability, RoomActivationMode, RoomBindingStatus, RoomRuntimeAdapter } from '@shennian/wire';
+import { HttpRoomActionClient } from './room-action-client.js';
+type FetchLike = typeof fetch;
+export type CreateRemoteRoomBindingInput = {
+    machineToken: string;
+    bindingIntentId: string;
+    roomId: string;
+    agentIdentityId: string;
+    nianSessionId: string;
+    runtimeAdapter: RoomRuntimeAdapter;
+    sessionRegistryKey: string;
+    activationCapability: RoomActivationCapability;
+    activationMode: RoomActivationMode;
+};
+export type RemoteRoomBinding = {
+    id: string;
+    roomId: string;
+    agentIdentityId: string;
+    agentMembershipId: string;
+    nianSessionId: string;
+    runtimeAdapter: RoomRuntimeAdapter;
+    activationCapability: RoomActivationCapability;
+    activationMode: RoomActivationMode;
+    status: RoomBindingStatus;
+};
+export declare class RoomBindingHttpError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare class HttpRoomBindingClient {
+    private readonly fetchImpl;
+    private readonly baseUrl;
+    private readonly actionClient;
+    constructor(serverUrl: string, fetchImpl?: FetchLike);
+    status: HttpRoomActionClient['status'];
+    getAttachmentCapability: HttpRoomActionClient['getAttachmentCapability'];
+    initializeAttachment: HttpRoomActionClient['initializeAttachment'];
+    completeAttachment: HttpRoomActionClient['completeAttachment'];
+    createRoom: HttpRoomActionClient['createRoom'];
+    createOperatorRoom: HttpRoomActionClient['createOperatorRoom'];
+    resolveNativeSession: HttpRoomActionClient['resolveNativeSession'];
+    joinRoom: HttpRoomActionClient['joinRoom'];
+    read: HttpRoomActionClient['read'];
+    send: HttpRoomActionClient['send'];
+    mode: HttpRoomActionClient['mode'];
+    create(input: CreateRemoteRoomBindingInput): Promise<{
+        binding: RemoteRoomBinding;
+        idempotent: boolean;
+    }>;
+}
+export {};

package/dist/src/room/room-binding-client.js

@@ -0,0 +1 @@
+import{HttpRoomActionClient as r}from"./room-action-client.js";class o extends Error{code;constructor(t,e){super(e),this.code=t,this.name="RoomBindingHttpError"}}class l{fetchImpl;baseUrl;actionClient;constructor(t,e=fetch){this.fetchImpl=e,this.baseUrl=t.replace(/\/+$/,""),this.actionClient=new r(t,e)}status=t=>this.actionClient.status(t);getAttachmentCapability=t=>this.actionClient.getAttachmentCapability(t);initializeAttachment=t=>this.actionClient.initializeAttachment(t);completeAttachment=t=>this.actionClient.completeAttachment(t);createRoom=t=>this.actionClient.createRoom(t);createOperatorRoom=t=>this.actionClient.createOperatorRoom(t);resolveNativeSession=t=>this.actionClient.resolveNativeSession(t);joinRoom=t=>this.actionClient.joinRoom(t);read=t=>this.actionClient.read(t);send=t=>this.actionClient.send(t);mode=t=>this.actionClient.mode(t);async create(t){let e;try{e=await this.fetchImpl(`${this.baseUrl}/api/rooms/${encodeURIComponent(t.roomId)}/bindings`,{method:"POST",headers:{authorization:`Bearer ${t.machineToken}`,"content-type":"application/json"},body:JSON.stringify({bindingIntentId:t.bindingIntentId,agentIdentityId:t.agentIdentityId,nianSessionId:t.nianSessionId,runtimeAdapter:t.runtimeAdapter,sessionRegistryKey:t.sessionRegistryKey,activationCapability:t.activationCapability,activationMode:t.activationMode}),signal:AbortSignal.timeout(1e4)})}catch{throw new o("room_binding_server_unavailable","Shennian Room service is unavailable.")}if(!e.ok){let s=`room_binding_http_${e.status}`;try{const a=await e.json();typeof a.error=="string"&&/^[a-z0-9_-]{1,80}$/.test(a.error)&&(s=a.error)}catch{}throw new o(s,"Shennian Room binding request failed.")}let i;try{i=await e.json()}catch{throw new o("invalid_room_binding_response","Invalid Room binding response.")}return d(i,t)}}function d(n,t){if(!n||typeof n!="object")throw new o("invalid_room_binding_response","Invalid Room binding response.");const e=n,i=e.binding;if(!i||typeof i.id!="string"||typeof i.agentMembershipId!="string"||i.roomId!==t.roomId||i.agentIdentityId!==t.agentIdentityId||i.nianSessionId!==t.nianSessionId||i.runtimeAdapter!==t.runtimeAdapter||i.activationCapability!==t.activationCapability||i.activationMode!==t.activationMode||!["pending_approval","active","paused","detached"].includes(i.status??"")||typeof e.idempotent!="boolean")throw new o("invalid_room_binding_response","Room binding response does not match the request.");return{binding:i,idempotent:e.idempotent}}export{l as HttpRoomBindingClient,o as RoomBindingHttpError};

package/dist/src/room/room-binding-ipc.d.ts

@@ -0,0 +1,29 @@
+import type { RoomActivationCapability, RoomActivationMode } from '@shennian/wire';
+import type { DaemonIpcHandler } from '../daemon-ipc/server.js';
+import type { JsonValue } from './pending-authorized-actions.js';
+import { RoomInvocationTokenAuthority } from './invocation-token.js';
+import { HttpRoomBindingClient } from './room-binding-client.js';
+import { RoomSessionRegistry } from './session-registry.js';
+import type { RoomJsonlMirror } from './jsonl-mirror.js';
+import type { RoomAttachmentCache } from './attachment-cache.js';
+import type { RoomAttachmentUploader } from './attachment-upload.js';
+import type { RoomHostSessionObservationStore } from './host-session-observations.js';
+export declare function createRoomBindingIpcHandlers(input: {
+    authority: RoomInvocationTokenAuthority;
+    registry: RoomSessionRegistry;
+    bindingClient: HttpRoomBindingClient;
+    getMachineCredentials: () => {
+        machineId?: string;
+        machineToken?: string;
+    };
+    mirrorFactory?: (roomId: string) => Pick<RoomJsonlMirror, 'append' | 'markAccessRevoked' | 'search'>;
+    attachmentCache?: Pick<RoomAttachmentCache, 'materialize'>;
+    attachmentUploader?: Pick<RoomAttachmentUploader, 'upload'>;
+    observations?: RoomHostSessionObservationStore;
+}): Record<string, DaemonIpcHandler>;
+export declare function buildRoomBindingActionParameters(input: {
+    roomId: string;
+    agentIdentityId: string;
+    activationCapability?: RoomActivationCapability;
+    activationMode?: RoomActivationMode;
+}): JsonValue;

package/dist/src/room/room-binding-ipc.js

@@ -0,0 +1 @@
+import{DaemonIpcError as a}from"../daemon-ipc/protocol.js";import{createRoomActionIpcHandlers as b}from"./room-action-ipc.js";function _(n){return{...b({authority:n.authority,registry:n.registry,actionClient:n.bindingClient,getMachineCredentials:n.getMachineCredentials,mirrorFactory:n.mirrorFactory,attachmentCache:n.attachmentCache,attachmentUploader:n.attachmentUploader,observations:n.observations}),"room-binding.execute":async i=>{const e=v(i),r=n.getMachineCredentials();if(!r.machineId?.trim()||!r.machineToken?.trim())throw new a("machine_not_authorized","This machine is not authorized yet.");const l=c(e.invocationToken,"invocationToken",128),m=c(e.registryKey,"registryKey",64),d=c(e.roomId,"roomId",191),s=c(e.agentIdentityId,"agentIdentityId",191),g=p(e.activationCapability),y=u(e.activationMode),h=f({roomId:d,agentIdentityId:s,activationCapability:g,activationMode:y});return n.registry.runExclusive(m,async()=>{const o=n.authority.consume({invocationToken:l,machineId:r.machineId,machineCredential:r.machineToken,registryKey:m,action:"room.bind",targetTool:"shennian_room",actionParameters:h});if(!o.bindingIntentId)throw new a("binding_intent_missing","Room Binding intent is missing.");const t=await n.bindingClient.create({machineToken:r.machineToken,bindingIntentId:o.bindingIntentId,roomId:d,agentIdentityId:s,nianSessionId:o.nianSessionId,runtimeAdapter:o.runtimeAdapter,sessionRegistryKey:o.registryKey,activationCapability:g,activationMode:y}),I=n.registry.setBinding({registryKey:m,bindingId:t.binding.id,roomId:d,agentIdentityId:s,agentMembershipId:t.binding.agentMembershipId,status:t.binding.status,activationMode:t.binding.activationMode});return{binding:{id:t.binding.id,roomId:d,agentIdentityId:s,agentMembershipId:t.binding.agentMembershipId,nianSessionId:o.nianSessionId,runtimeAdapter:o.runtimeAdapter,activationCapability:g,activationMode:t.binding.activationMode,status:t.binding.status},idempotent:t.idempotent,panelContextKey:I.panelContextKey}})}}}function f(n){return{roomId:n.roomId,agentIdentityId:n.agentIdentityId,activationCapability:n.activationCapability??"notify_only",activationMode:n.activationMode??"auto_follow"}}function v(n){if(!n||Array.isArray(n)||typeof n!="object")throw new a("invalid_params","Room Binding parameters are required.");return n}function c(n,i,e){if(typeof n!="string"||!n.trim()||n.length>e)throw new a("invalid_params",`${i} is invalid.`);return n.trim()}function p(n){const i=n??"notify_only";if(i!=="managed"&&i!=="idle_resume"&&i!=="notify_only")throw new a("invalid_params","activationCapability is invalid.");return i}function u(n){const i=n??"auto_follow";if(i!=="auto_follow"&&i!=="mention_only"&&i!=="paused")throw new a("invalid_params","activationMode is invalid.");return i}export{f as buildRoomBindingActionParameters,_ as createRoomBindingIpcHandlers};

package/dist/src/room/session-registry-ipc.d.ts

@@ -0,0 +1,14 @@
+import type { DaemonIpcHandler } from '../daemon-ipc/server.js';
+import type { RoomHostSessionObservationStore } from './host-session-observations.js';
+import type { HttpRoomActionClient } from './room-action-client.js';
+import { RoomSessionRegistry } from './session-registry.js';
+export declare function createRoomSessionRegistryIpcHandlers(input: {
+    registry: RoomSessionRegistry;
+    observations?: RoomHostSessionObservationStore;
+    sessionResolver?: Pick<HttpRoomActionClient, 'resolveNativeSession'>;
+    getMachineCredentials?: () => {
+        machineId?: string;
+        machineToken?: string;
+    };
+    getMachineId?: () => string | undefined;
+}): Record<string, DaemonIpcHandler>;

package/dist/src/room/session-registry-ipc.js

@@ -0,0 +1 @@
+import{DaemonIpcError as o}from"../daemon-ipc/protocol.js";function I(e){return{"room-session.register":t=>{const i=h(t),s=u(e).machineId?.trim();if(!s)throw new o("machine_not_authorized","This machine is not authorized yet.");const n=e.registry.register({machineId:s,runtimeAdapter:f(i.runtimeAdapter),sourceSessionKey:c(i.sourceSessionKey,"sourceSessionKey",1024),nianSessionId:c(i.nianSessionId,"nianSessionId",512),hostProcessIdentity:c(i.hostProcessIdentity,"hostProcessIdentity",512),capabilities:S(i.capabilities)});return m(n)},"room-session.resolve":async t=>{const i=h(t),s=u(e),n=s.machineId?.trim();if(!n)throw new o("machine_not_authorized","This machine is not authorized yet.");const a=f(i.runtimeAdapter),d=c(i.sourceSessionKey,"sourceSessionKey",1024),y=e.registry.getBySource({machineId:n,runtimeAdapter:a,sourceSessionKey:d});if(y)return m(y);if(!s.machineToken?.trim())throw new o("machine_not_authorized","This machine is not authorized yet.");const r=e.observations?.getBySource({machineId:n,runtimeAdapter:a,sourceSessionKey:d});if(!r||r.lifecycleState==="closed")throw new o("room_session_not_observed","The exact native Agent session has not been observed on this machine.");if(!e.sessionResolver)throw new o("room_session_not_found","Native Agent session is not registered.");const g=await e.sessionResolver.resolveNativeSession({machineToken:s.machineToken,runtimeAdapter:a,sourceSessionKey:d}),p=!!r.workspacePath,l=e.registry.register({machineId:n,runtimeAdapter:a,sourceSessionKey:d,nianSessionId:g.nianSessionId,hostProcessIdentity:`${a}:${r.hostContextHash}:${r.registrationEpoch}`,capabilities:{canIdentifySession:!0,canBindAutomatically:!0,canOpenEmbeddedRoomPage:!1,canResumeIdleSession:p,canActivateWhileHostOpen:!1}});return r.lifecycleState==="idle"&&e.registry.updateLifecycle(l.registryKey,"inactive"),m(e.registry.getByRegistryKey(l.registryKey))}}}function u(e){return e.getMachineCredentials?.()??{machineId:e.getMachineId?.()}}function m(e){return{registryKey:e.registryKey,nianSessionId:e.nianSessionId,panelContextKey:e.panelContextKey,runtimeAdapter:e.runtimeAdapter,registrationEpoch:e.registrationEpoch,lifecycleState:e.lifecycleState,capabilities:e.capabilities,binding:e.binding,lastSeenAt:e.lastSeenAt}}function h(e){if(!e||Array.isArray(e)||typeof e!="object")throw new o("invalid_params","Room session parameters are required.");return e}function c(e,t,i){if(typeof e!="string"||!e.trim()||e.length>i)throw new o("invalid_params",`${t} is invalid.`);return e.trim()}function f(e){const t=c(e,"runtimeAdapter",32);if(t!=="codex"&&t!=="claude_code"&&t!=="workbuddy")throw new o("invalid_params","runtimeAdapter is unsupported.");return t}function S(e){const t=h(e),i=["canIdentifySession","canBindAutomatically","canOpenEmbeddedRoomPage","canResumeIdleSession","canActivateWhileHostOpen"],s={};for(const n of i){if(typeof t[n]!="boolean")throw new o("invalid_params",`${n} must be boolean.`);s[n]=t[n]}return s}export{I as createRoomSessionRegistryIpcHandlers};

package/dist/src/room/session-registry.d.ts

@@ -0,0 +1,128 @@
+import type { RoomActivationMode, RoomBindingStatus, RoomRuntimeAdapter } from '@shennian/wire';
+export type RoomSessionCapabilities = {
+    canIdentifySession: boolean;
+    canBindAutomatically: boolean;
+    canOpenEmbeddedRoomPage: boolean;
+    canResumeIdleSession: boolean;
+    canActivateWhileHostOpen: boolean;
+};
+export type RoomSessionBindingState = {
+    bindingId: string;
+    roomId: string;
+    agentIdentityId: string;
+    agentMembershipId: string | null;
+    status: RoomBindingStatus;
+    activationMode: RoomActivationMode;
+    lastDeliveredSequence: string;
+    lastActivatedSequence: string;
+    activationQueue: RoomActivationQueueItem[];
+    activeActivation: RoomActivationQueueItem | null;
+    loopBreaker: {
+        windowStartedAt: string | null;
+        activationCount: number;
+        pausedUntil: string | null;
+    };
+};
+export type RoomActivationQueueItem = {
+    causeMessageId: string;
+    rootCauseMessageId: string;
+    sequence: string;
+    hopCount: number;
+    enqueuedAt: string;
+    attempts: number;
+};
+export type RoomSessionRegistration = {
+    schemaVersion: 1;
+    registryKey: string;
+    machineId: string;
+    runtimeAdapter: RoomRuntimeAdapter;
+    sourceSessionKey: string;
+    nianSessionId: string;
+    panelContextKey: string;
+    hostProcessIdentity: string;
+    registrationEpoch: number;
+    lifecycleState: 'active' | 'inactive' | 'closed';
+    capabilities: RoomSessionCapabilities;
+    binding: RoomSessionBindingState | null;
+    registeredAt: string;
+    lastSeenAt: string;
+    updatedAt: string;
+};
+type RegisterInput = {
+    machineId: string;
+    runtimeAdapter: RoomRuntimeAdapter;
+    sourceSessionKey: string;
+    nianSessionId: string;
+    hostProcessIdentity: string;
+    capabilities: RoomSessionCapabilities;
+    now?: Date;
+};
+export declare class RoomSessionRegistryError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare class RoomSessionRegistry {
+    readonly filePath: string;
+    private state;
+    private readonly mutexTails;
+    constructor(filePath?: string);
+    register(input: RegisterInput): RoomSessionRegistration;
+    getBySource(input: Pick<RegisterInput, 'machineId' | 'runtimeAdapter' | 'sourceSessionKey'>): RoomSessionRegistration | null;
+    getByNianSessionId(nianSessionId: string): RoomSessionRegistration | null;
+    getByRegistryKey(registryKey: string): RoomSessionRegistration | null;
+    list(): RoomSessionRegistration[];
+    setBinding(input: {
+        registryKey: string;
+        bindingId: string;
+        roomId: string;
+        agentIdentityId: string;
+        agentMembershipId: string | null;
+        status: RoomBindingStatus;
+        activationMode?: RoomActivationMode;
+        now?: Date;
+    }): RoomSessionRegistration;
+    detachBinding(registryKey: string, now?: Date): RoomSessionRegistration;
+    advanceCursor(input: {
+        registryKey: string;
+        cursor: 'delivered' | 'activated';
+        sequence: string;
+        now?: Date;
+    }): RoomSessionRegistration;
+    enqueueActivation(registryKey: string, item: RoomActivationQueueItem, now?: Date): RoomSessionRegistration;
+    dequeueActivation(registryKey: string, causeMessageId: string, now?: Date): RoomSessionRegistration;
+    markActivationDispatching(registryKey: string, causeMessageId: string, now?: Date): RoomSessionRegistration;
+    clearActiveActivation(registryKey: string, now?: Date): RoomSessionRegistration;
+    retryActiveActivation(input: {
+        registryKey: string;
+        maxAttempts: number;
+        pauseMs: number;
+        now?: Date;
+    }): {
+        queued: boolean;
+        attempts: number;
+    };
+    claimActivation(input: {
+        registryKey: string;
+        windowMs: number;
+        maxActivations: number;
+        pauseMs: number;
+        now?: Date;
+    }): {
+        allowed: boolean;
+        pausedUntil: string | null;
+        newlyPaused?: boolean;
+    };
+    updateLifecycle(registryKey: string, lifecycleState: 'active' | 'inactive' | 'closed', now?: Date): RoomSessionRegistration;
+    runExclusive<T>(registryKey: string, operation: () => Promise<T>): Promise<T>;
+    private requireRecord;
+    private requireBoundRecord;
+    private touchAndPersist;
+    private load;
+    private persist;
+}
+export declare function buildRoomSessionRegistryKey(input: {
+    machineId: string;
+    runtimeAdapter: RoomRuntimeAdapter;
+    sourceSessionKey: string;
+}): string;
+export {};

package/dist/src/room/session-registry.js

@@ -0,0 +1,2 @@
+import y from"node:crypto";import c from"node:fs";import b from"node:path";import{resolveShennianPath as S}from"../config/index.js";const _=500,R=/^[A-Za-z0-9_.:@/-]{1,512}$/,q=new Set(["codex","claude_code","workbuddy"]),p=new Set(["pending_approval","active","paused","detached"]),I=new Set(["auto_follow","mention_only","paused"]);class o extends Error{code;constructor(e,t){super(t),this.code=e,this.name="RoomSessionRegistryError"}}class T{filePath;state;mutexTails=new Map;constructor(e=S("runtime","room-session-registry.json")){this.filePath=e,this.state=this.load()}register(e){r(e.machineId,"machine_id"),v(e.runtimeAdapter),w(e.sourceSessionKey),r(e.nianSessionId,"nian_session_id"),r(e.hostProcessIdentity,"host_process_identity"),A(e.capabilities);const t=m(e),s=(e.now??new Date).toISOString(),n=this.state.records[t];if(Object.values(this.state.records).find(g=>g.registryKey!==t&&g.nianSessionId===e.nianSessionId&&g.lifecycleState!=="closed"))throw new o("nian_session_already_registered","This Shennian session is already registered to another native Agent session.");const u=!!(n&&n.hostProcessIdentity!==e.hostProcessIdentity),l={schemaVersion:1,registryKey:t,machineId:e.machineId,runtimeAdapter:e.runtimeAdapter,sourceSessionKey:e.sourceSessionKey,nianSessionId:e.nianSessionId,panelContextKey:e.nianSessionId,hostProcessIdentity:e.hostProcessIdentity,registrationEpoch:n?n.registrationEpoch+(u?1:0):1,lifecycleState:"active",capabilities:{...e.capabilities},binding:n?.binding??null,registeredAt:n?.registeredAt??s,lastSeenAt:s,updatedAt:s};return this.state.records[t]=l,this.persist(),d(l)}getBySource(e){const t=this.state.records[m(e)];return t?d(t):null}getByNianSessionId(e){r(e,"nian_session_id");const t=Object.values(this.state.records).find(s=>s.nianSessionId===e&&s.lifecycleState!=="closed");return t?d(t):null}getByRegistryKey(e){if(!/^[a-f0-9]{64}$/.test(e))throw new o("invalid_registry_key","Invalid Room session registry key.");const t=this.state.records[e];return t?d(t):null}list(){return Object.values(this.state.records).sort((e,t)=>e.registeredAt.localeCompare(t.registeredAt)).map(d)}setBinding(e){const t=this.requireRecord(e.registryKey);for(const[n,a]of Object.entries({binding_id:e.bindingId,room_id:e.roomId,agent_identity_id:e.agentIdentityId}))r(a,n);if(!p.has(e.status))throw new o("invalid_binding_status","Invalid binding status.");if(e.status==="pending_approval"&&e.agentMembershipId!==null||(e.status==="active"||e.status==="paused")&&e.agentMembershipId===null)throw new o("invalid_agent_membership_id","Pending Room bindings cannot claim an Agent membership.");e.agentMembershipId!==null&&r(e.agentMembershipId,"agent_membership_id");const s=e.activationMode??"auto_follow";if(!I.has(s))throw new o("invalid_activation_mode","Invalid activation mode.");if(t.binding&&t.binding.status!=="detached"&&(t.binding.bindingId!==e.bindingId||t.binding.roomId!==e.roomId))throw new o("session_already_bound","An Agent session can have only one active Room binding.");return t.binding={bindingId:e.bindingId,roomId:e.roomId,agentIdentityId:e.agentIdentityId,agentMembershipId:e.agentMembershipId,status:e.status,activationMode:s,lastDeliveredSequence:t.binding?.lastDeliveredSequence??"0",lastActivatedSequence:t.binding?.lastActivatedSequence??"0",activationQueue:t.binding?.activationQueue??[],activeActivation:t.binding?.activeActivation??null,loopBreaker:t.binding?.loopBreaker??{windowStartedAt:null,activationCount:0,pausedUntil:null}},this.touchAndPersist(t,e.now),d(t)}detachBinding(e,t=new Date){const s=this.requireRecord(e);return s.binding&&(s.binding.status="detached",s.binding.activationMode="paused",s.binding.activationQueue=[]),this.touchAndPersist(s,t),d(s)}advanceCursor(e){const t=this.requireBoundRecord(e.registryKey);h(e.sequence);const s=e.cursor==="delivered"?"lastDeliveredSequence":"lastActivatedSequence";if(BigInt(e.sequence)<BigInt(t.binding[s]))throw new o("cursor_regression","Room cursor cannot move backwards.");return t.binding[s]=e.sequence,this.touchAndPersist(t,e.now),d(t)}enqueueActivation(e,t,s=new Date){const n=this.requireBoundRecord(e);f(t);const a=n.binding.activationQueue;if(!a.some(u=>u.causeMessageId===t.causeMessageId)){if(a.length>=_)throw new o("activation_queue_full","Agent activation queue is full.");a.push(d(t))}return this.touchAndPersist(n,s),d(n)}dequeueActivation(e,t,s=new Date){const n=this.requireBoundRecord(e);return n.binding.activationQueue=n.binding.activationQueue.filter(a=>a.causeMessageId!==t),this.touchAndPersist(n,s),d(n)}markActivationDispatching(e,t,s=new Date){const n=this.requireBoundRecord(e),a=n.binding.activationQueue.find(u=>u.causeMessageId===t);if(!a)throw new o("activation_not_found","Agent activation is unavailable.");return n.binding.activeActivation=d(a),n.binding.activationQueue=n.binding.activationQueue.filter(u=>u.causeMessageId!==t),this.touchAndPersist(n,s),d(n)}clearActiveActivation(e,t=new Date){const s=this.requireBoundRecord(e);return s.binding.activeActivation=null,this.touchAndPersist(s,t),d(s)}retryActiveActivation(e){const t=this.requireBoundRecord(e.registryKey),s=t.binding.activeActivation;if(!s)return{queued:!1,attempts:0};const n=e.now??new Date,a={...s,attempts:s.attempts+1};return t.binding.activeActivation=null,a.attempts<e.maxAttempts?(t.binding.activationQueue.some(u=>u.causeMessageId===a.causeMessageId)||t.binding.activationQueue.unshift(a),this.touchAndPersist(t,n),{queued:!0,attempts:a.attempts}):(t.binding.loopBreaker.pausedUntil=new Date(n.getTime()+e.pauseMs).toISOString(),this.touchAndPersist(t,n),{queued:!1,attempts:a.attempts})}claimActivation(e){const t=this.requireBoundRecord(e.registryKey),s=e.now??new Date,n=t.binding.loopBreaker;return n.pausedUntil&&Date.parse(n.pausedUntil)>s.getTime()?{allowed:!1,pausedUntil:n.pausedUntil,newlyPaused:!1}:((!n.windowStartedAt||s.getTime()-Date.parse(n.windowStartedAt)>=e.windowMs)&&(n.windowStartedAt=s.toISOString(),n.activationCount=0,n.pausedUntil=null),n.activationCount>=e.maxActivations?(n.pausedUntil=new Date(s.getTime()+e.pauseMs).toISOString(),this.touchAndPersist(t,s),{allowed:!1,pausedUntil:n.pausedUntil,newlyPaused:!0}):(n.activationCount+=1,this.touchAndPersist(t,s),{allowed:!0,pausedUntil:null}))}updateLifecycle(e,t,s=new Date){const n=this.requireRecord(e);return n.lifecycleState=t,t==="closed"&&n.binding&&(n.binding.status="detached",n.binding.activationMode="paused",n.binding.activationQueue=[]),this.touchAndPersist(n,s),d(n)}async runExclusive(e,t){this.requireRecord(e);const s=this.mutexTails.get(e)??Promise.resolve();let n;const a=new Promise(l=>{n=l}),u=s.then(()=>a);this.mutexTails.set(e,u),await s;try{return await t()}finally{n(),this.mutexTails.get(e)===u&&this.mutexTails.delete(e)}}requireRecord(e){const t=this.state.records[e];if(!t)throw new o("session_registration_not_found","Agent session is not registered.");return t}requireBoundRecord(e){const t=this.requireRecord(e);if(!t.binding||t.binding.status!=="active"&&t.binding.status!=="paused")throw new o("session_not_bound","Agent session has no active Room binding.");return t}touchAndPersist(e,t=new Date){e.updatedAt=t.toISOString(),this.persist()}load(){try{const e=c.lstatSync(this.filePath);if(!e.isFile()||e.isSymbolicLink())throw new o("unsafe_session_registry","Room session registry is not a regular file.");process.platform!=="win32"&&(e.mode&63)!==0&&c.chmodSync(this.filePath,384);const t=JSON.parse(c.readFileSync(this.filePath,"utf8"));return P(t)}catch(e){if(B(e))return{schemaVersion:1,records:{}};throw e instanceof o?e:new o("corrupt_session_registry","Room Agent session registry is corrupt.")}}persist(){const e=b.dirname(this.filePath);c.mkdirSync(e,{recursive:!0,mode:448}),process.platform!=="win32"&&c.chmodSync(e,448);const t=`${this.filePath}.tmp-${process.pid}-${y.randomBytes(6).toString("hex")}`;try{if(c.writeFileSync(t,`${JSON.stringify(this.state,null,2)}
+`,{encoding:"utf8",mode:384,flag:"wx"}),process.platform!=="win32"&&c.chmodSync(t,384),process.platform==="win32"&&c.existsSync(this.filePath)){const s=c.lstatSync(this.filePath);if(!s.isFile()||s.isSymbolicLink())throw new o("unsafe_session_registry","Refusing to replace an unsafe Room session registry.");c.unlinkSync(this.filePath)}c.renameSync(t,this.filePath),process.platform!=="win32"&&c.chmodSync(this.filePath,384)}finally{try{c.unlinkSync(t)}catch{}}}}function m(i){return r(i.machineId,"machine_id"),v(i.runtimeAdapter),w(i.sourceSessionKey),y.createHash("sha256").update(`${i.machineId}\0${i.runtimeAdapter}\0${i.sourceSessionKey}`,"utf8").digest("hex")}function P(i){if(!i||typeof i!="object"||i.schemaVersion!==1)throw new o("corrupt_session_registry","Unsupported Room session registry.");const e=i.records;if(!e||typeof e!="object"||Array.isArray(e))throw new o("corrupt_session_registry","Room session records are invalid.");const t={};for(const[s,n]of Object.entries(e)){if(M(n),s!==n.registryKey||s!==m(n))throw new o("corrupt_session_registry","Room session registry key mismatch.");t[s]={...n,binding:n.binding?{...n.binding,activeActivation:n.binding.activeActivation??null}:null}}return{schemaVersion:1,records:t}}function M(i){if(!i||i.schemaVersion!==1)throw new o("corrupt_session_registry","Invalid registration.");if(r(i.machineId,"machine_id"),v(i.runtimeAdapter),w(i.sourceSessionKey),r(i.nianSessionId,"nian_session_id"),r(i.hostProcessIdentity,"host_process_identity"),i.panelContextKey!==i.nianSessionId)throw new o("corrupt_session_registry","Invalid panel context.");if(!Number.isInteger(i.registrationEpoch)||i.registrationEpoch<1)throw new o("corrupt_session_registry","Invalid registration epoch.");A(i.capabilities),i.binding&&x(i.binding)}function x(i){if(r(i.bindingId,"binding_id"),r(i.roomId,"room_id"),r(i.agentIdentityId,"agent_identity_id"),!p.has(i.status))throw new o("corrupt_session_registry","Invalid binding status.");if(i.status==="pending_approval"&&i.agentMembershipId!==null||(i.status==="active"||i.status==="paused")&&i.agentMembershipId===null)throw new o("corrupt_session_registry","Invalid Agent membership.");if(i.agentMembershipId!==null&&r(i.agentMembershipId,"agent_membership_id"),!I.has(i.activationMode))throw new o("corrupt_session_registry","Invalid activation mode.");if(h(i.lastDeliveredSequence),h(i.lastActivatedSequence),!Array.isArray(i.activationQueue)||i.activationQueue.length>_)throw new o("corrupt_session_registry","Invalid activation queue.");i.activationQueue.forEach(f),i.activeActivation!=null&&f(i.activeActivation)}function f(i){if(r(i.causeMessageId,"cause_message_id"),r(i.rootCauseMessageId,"root_cause_message_id"),h(i.sequence),!Number.isInteger(i.hopCount)||i.hopCount<0||i.hopCount>32)throw new o("invalid_hop_count","Invalid Agent activation hop count.");if(!Number.isInteger(i.attempts)||i.attempts<0||i.attempts>100)throw new o("invalid_activation_attempts","Invalid Agent activation attempts.");if(!Number.isFinite(new Date(i.enqueuedAt).getTime()))throw new o("invalid_activation_time","Invalid Agent activation time.")}function A(i){if(!i||["canIdentifySession","canBindAutomatically","canOpenEmbeddedRoomPage","canResumeIdleSession","canActivateWhileHostOpen"].some(t=>typeof i[t]!="boolean"))throw new o("invalid_session_capabilities","Invalid Agent session capabilities.")}function v(i){if(!q.has(i))throw new o("invalid_runtime_adapter","Unsupported Room runtime adapter.")}function w(i){if(!i||i.length>1024||/[\0\r\n]/.test(i))throw new o("invalid_source_session_key","Invalid native Agent session key.")}function r(i,e){if(!R.test(i))throw new o(`invalid_${e}`,`Invalid ${e}.`)}function h(i){if(!/^(0|[1-9]\d{0,19})$/.test(i))throw new o("invalid_room_sequence","Invalid Room sequence.")}function d(i){return structuredClone(i)}function B(i){return typeof i=="object"&&i!==null&&"code"in i&&i.code==="ENOENT"}export{T as RoomSessionRegistry,o as RoomSessionRegistryError,m as buildRoomSessionRegistryKey};