@love-moon/conductor-sdk 0.2.39 → 0.2.41

package/dist/client.d.ts

@@ -27,6 +27,7 @@ export interface ConductorClientConnectOptions {
     onPong?: (event: WebSocketPongEvent) => void;
     onStopTask?: (event: StopTaskEvent) => Promise<void> | void;
     onInterruptTurn?: (event: InterruptTurnEvent) => Promise<boolean | void> | boolean | void;
+    onRefreshSession?: (event: RefreshSessionEvent) => Promise<boolean | void> | boolean | void;
 }
 interface ConductorClientInit {
     config: ConductorConfig;
@@ -43,6 +44,7 @@ interface ConductorClientInit {
     agentHost: string;
     onStopTask?: (event: StopTaskEvent) => Promise<void> | void;
     onInterruptTurn?: (event: InterruptTurnEvent) => Promise<boolean | void> | boolean | void;
+    onRefreshSession?: (event: RefreshSessionEvent) => Promise<boolean | void> | boolean | void;
 }
 export interface StopTaskEvent {
     taskId: string;
@@ -55,6 +57,13 @@ export interface InterruptTurnEvent {
     reason?: string;
     targetReplyTo: string;
 }
+export interface RefreshSessionEvent {
+    taskId: string;
+    requestId?: string;
+    reason?: string;
+    sessionId: string;
+    sessionFilePath?: string;
+}
 export interface FlushPendingUpstreamEventsOptions {
     timeoutMs?: number;
     retryIntervalMs?: number;
@@ -73,6 +82,7 @@ export declare class ConductorClient {
     private readonly agentHost;
     private readonly onStopTask?;
     private readonly onInterruptTurn?;
+    private readonly onRefreshSession?;
     private deliveryScopeId;
     private closed;
     private durableOutboxFlushPromise;
@@ -126,7 +136,9 @@ export declare class ConductorClient {
     private handleStopTaskCommand;
     private invokeStopTaskHandler;
     private handleInterruptTurnCommand;
+    private handleRefreshSessionCommand;
     private invokeInterruptTurnHandler;
+    private invokeRefreshSessionHandler;
     private persistAndCommitUpstreamEvent;
     private requestDurableOutboxFlush;
     private hasEarlierPendingSdkMessage;

package/dist/client.js

@@ -24,6 +24,7 @@ export class ConductorClient {
     agentHost;
     onStopTask;
     onInterruptTurn;
+    onRefreshSession;
     deliveryScopeId;
     closed = false;
     durableOutboxFlushPromise = null;
@@ -43,6 +44,7 @@ export class ConductorClient {
         this.agentHost = init.agentHost;
         this.onStopTask = init.onStopTask;
         this.onInterruptTurn = init.onInterruptTurn;
+        this.onRefreshSession = init.onRefreshSession;
         this.deliveryScopeId = init.deliveryScopeId;
         this.wsClient.registerHandler(this.handleBackendEvent);
     }
@@ -86,6 +88,7 @@ export class ConductorClient {
             agentHost,
             onStopTask: options.onStopTask,
             onInterruptTurn: options.onInterruptTurn,
+            onRefreshSession: options.onRefreshSession,
         });
         await client.wsClient.connect();
         if (client.shouldAutoFlushDurableOutbox()) {
@@ -536,6 +539,17 @@ export class ConductorClient {
         };
     }
     handleBackendEvent = async (payload) => {
+        if (typeof payload?.type === 'string' && payload.type === 'refresh_session') {
+            void this.handleRefreshSessionCommand(payload).catch((error) => {
+                const data = payload?.payload && typeof payload.payload === 'object'
+                    ? payload.payload
+                    : null;
+                const taskId = typeof data?.task_id === 'string' ? data.task_id.trim() : '';
+                const message = error instanceof Error ? error.message : String(error);
+                console.warn(`[sdk] refresh_session dispatch failed${taskId ? ` for task ${taskId}` : ''}: ${message}`);
+            });
+            return;
+        }
         if (typeof payload?.type === 'string' && payload.type === 'interrupt_turn') {
             await this.handleInterruptTurnCommand(payload);
             return;
@@ -641,6 +655,10 @@ export class ConductorClient {
         const accepted = await this.invokeInterruptTurnHandler(payload);
         await this.maybeAckInboundCommand(payload, { accepted });
     }
+    async handleRefreshSessionCommand(payload) {
+        const accepted = await this.invokeRefreshSessionHandler(payload);
+        await this.maybeAckInboundCommand(payload, { accepted });
+    }
     async invokeInterruptTurnHandler(payload) {
         const data = payload?.payload && typeof payload.payload === 'object'
             ? payload.payload
@@ -677,6 +695,48 @@ export class ConductorClient {
             return false;
         }
     }
+    async invokeRefreshSessionHandler(payload) {
+        const data = payload?.payload && typeof payload.payload === 'object'
+            ? payload.payload
+            : null;
+        if (!data) {
+            return false;
+        }
+        const taskId = typeof data.task_id === 'string' ? data.task_id.trim() : '';
+        const requestId = typeof data.request_id === 'string' ? data.request_id.trim() : '';
+        const reason = typeof data.reason === 'string' ? data.reason.trim() : '';
+        const sessionId = typeof data.session_id === 'string'
+            ? data.session_id.trim()
+            : typeof data.sessionId === 'string'
+                ? data.sessionId.trim()
+                : '';
+        const sessionFilePath = typeof data.session_file_path === 'string'
+            ? data.session_file_path.trim()
+            : typeof data.sessionFilePath === 'string'
+                ? data.sessionFilePath.trim()
+                : '';
+        if (!taskId || !sessionId) {
+            return false;
+        }
+        if (!this.onRefreshSession) {
+            return false;
+        }
+        try {
+            const accepted = await this.onRefreshSession({
+                taskId,
+                requestId: requestId || undefined,
+                reason: reason || undefined,
+                sessionId,
+                sessionFilePath: sessionFilePath || undefined,
+            });
+            return accepted !== false;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.warn(`[sdk] refresh_session callback failed for task ${taskId}: ${message}`);
+            return false;
+        }
+    }
     async persistAndCommitUpstreamEvent(entry) {
         const stored = this.upstreamOutbox.upsert(entry);
         if (stored.eventType === 'sdk_message' && this.hasEarlierPendingSdkMessage(stored.stableId)) {
@@ -843,7 +903,10 @@ export class ConductorClient {
     }
     async maybeAckInboundCommand(payload, options = {}) {
         const eventType = typeof payload?.type === 'string' ? payload.type : '';
-        if (eventType !== 'task_user_message' && eventType !== 'task_action' && eventType !== 'interrupt_turn') {
+        if (eventType !== 'task_user_message' &&
+            eventType !== 'task_action' &&
+            eventType !== 'interrupt_turn' &&
+            eventType !== 'refresh_session') {
             return;
         }
         const data = payload?.payload && typeof payload.payload === 'object'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@love-moon/conductor-sdk",
-  "version": "0.2.39",
+  "version": "0.2.41",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -27,5 +27,5 @@
     "typescript": "^5.6.3",
     "vitest": "^2.1.4"
   },
-  "gitCommitId": "30204c8"
+  "gitCommitId": "89ac834"
 }