@adhdev/session-host-core 1.0.58-rc.1 → 1.0.58-rc.3

package/dist/index.d.mts

@@ -538,12 +538,43 @@ interface SessionHostClientOptions {
     endpoint?: SessionHostEndpoint;
     appName?: string;
 }
+/**
+ * Why an established session-host connection went away.
+ * - `error`  — socket emitted 'error' (includes ECONNRESET on abrupt host death)
+ * - `ended`  — peer sent FIN ('end'): the host closed the connection cleanly
+ * - `closed` — socket fully closed ('close') without a preceding error/end
+ */
+type SessionHostDisconnectReason = 'error' | 'ended' | 'closed';
+interface SessionHostDisconnectInfo {
+    reason: SessionHostDisconnectReason;
+    endpointPath: string;
+    /** In-flight requests abandoned by this disconnect (they were rejected). */
+    pendingRequests: number;
+    error?: Error;
+}
 declare class SessionHostClient {
     readonly endpoint: SessionHostEndpoint;
     private socket;
     private requestWaiters;
     private eventListeners;
+    private disconnectListeners;
+    /** Guards against emitting both an 'error'-path and a 'close'-path disconnect for one socket. */
+    private disconnectedSockets;
     constructor(options?: SessionHostClientOptions);
+    /**
+     * Fires when an established connection to the session host goes away.
+     *
+     * Before this existed the client registered only 'data' and 'error' handlers,
+     * so a *clean* FIN — the host process exiting normally, or dying to an
+     * uncaught exception that took the socket down without an error event on our
+     * end — ran nothing at all: `this.socket` stayed non-null pointing at a dead
+     * socket, in-flight waiters hung to their 30s timeout, and no caller was told.
+     * That silence is what let a session-host death present downstream as an
+     * unrelated application-level fault (a missing completion marker) instead of
+     * "the host is gone".
+     */
+    onDisconnect(listener: (info: SessionHostDisconnectInfo) => void): () => void;
+    private handleDisconnect;
     connect(): Promise<void>;
     onEvent(listener: (event: SessionHostEvent) => void): () => void;
     request<T = unknown>(request: SessionHostRequest): Promise<SessionHostResponse<T>>;
@@ -683,4 +714,4 @@ interface SessionHostControlTransport {
  */
 declare function createSessionHostControlPlane(transport: SessionHostControlTransport): SessionHostControlPlane;
 
-export { type AcquireWritePayload, type AttachSessionPayload, type ClearSessionBufferPayload, type CreateSessionPayload, DEFAULT_CONFIG_DIR_NAME, DEFAULT_SESSION_RING_BUFFER_MAX_BYTES, type DetachSessionPayload, type ForceDetachClientPayload, type GetHostDiagnosticsPayload, type GetSnapshotPayload, type GetTerminalSnapshotPayload, type PruneDuplicateSessionsPayload, type ReleaseWritePayload, type ResizeSessionPayload, type RestartSessionPayload, type ResumeSessionPayload, SESSION_HOST_SUPPORTED_REQUEST_TYPES, type SendInputPayload, type SendSignalPayload, type SessionAttachedClient, type SessionBufferSnapshot, type SessionClientType, type SessionHostCategory, SessionHostClient, type SessionHostClientOptions, type SessionHostControlPlane, type SessionHostControlTransport, type SessionHostDiagnostics, type SessionHostDuplicateSessionGroup, type SessionHostEndpoint, type SessionHostEndpointOptions, type SessionHostEvent, type SessionHostEventEnvelope, type SessionHostLogEntry, type SessionHostPruneDuplicatesResult, type SessionHostRecord, SessionHostRegistry, type SessionHostRequest, type SessionHostRequestEnvelope, type SessionHostRequestTrace, type SessionHostRequestType, type SessionHostResponse, type SessionHostResponseEnvelope, type SessionHostRuntimeTransition, type SessionHostSurfaceKind, type SessionHostSurfaceRecordLike, type SessionHostWireEnvelope, type SessionLaunchCommand, type SessionLifecycle, type SessionOwnerType, SessionRingBuffer, type SessionRingBufferOptions, type SessionTerminalSnapshot, type SessionTerminalState, type SessionTermination, type SessionTransport, type SessionWriteOwner, type StopSessionPayload, type UpdateSessionMetaPayload, applyTerminalColorEnv, buildRuntimeDisplayName, buildRuntimeKey, canonicalizeInstancePath, classifyTermination, createLineParser, createResponseEnvelope, createSessionHostControlPlane, ensureNodePtySpawnHelperPermissions, formatRuntimeOwner, getDefaultSessionHostEndpoint, getSessionHostRecoveryLabel, getSessionHostSurfaceKind, getWorkspaceLabel, isDefaultInstanceConfigDir, isSessionHostLiveRuntime, isSessionHostRecoverySnapshot, isTerminalRecord, partitionSessionHostDiagnosticsSessions, partitionSessionHostRecords, resolveAttachableRuntimeRecord, resolveInstanceConfigDir, resolveRuntimeRecord, resolveSessionHostIpcKey, sanitizeSpawnEnv, writeEnvelope };
+export { type AcquireWritePayload, type AttachSessionPayload, type ClearSessionBufferPayload, type CreateSessionPayload, DEFAULT_CONFIG_DIR_NAME, DEFAULT_SESSION_RING_BUFFER_MAX_BYTES, type DetachSessionPayload, type ForceDetachClientPayload, type GetHostDiagnosticsPayload, type GetSnapshotPayload, type GetTerminalSnapshotPayload, type PruneDuplicateSessionsPayload, type ReleaseWritePayload, type ResizeSessionPayload, type RestartSessionPayload, type ResumeSessionPayload, SESSION_HOST_SUPPORTED_REQUEST_TYPES, type SendInputPayload, type SendSignalPayload, type SessionAttachedClient, type SessionBufferSnapshot, type SessionClientType, type SessionHostCategory, SessionHostClient, type SessionHostClientOptions, type SessionHostControlPlane, type SessionHostControlTransport, type SessionHostDiagnostics, type SessionHostDisconnectInfo, type SessionHostDisconnectReason, type SessionHostDuplicateSessionGroup, type SessionHostEndpoint, type SessionHostEndpointOptions, type SessionHostEvent, type SessionHostEventEnvelope, type SessionHostLogEntry, type SessionHostPruneDuplicatesResult, type SessionHostRecord, SessionHostRegistry, type SessionHostRequest, type SessionHostRequestEnvelope, type SessionHostRequestTrace, type SessionHostRequestType, type SessionHostResponse, type SessionHostResponseEnvelope, type SessionHostRuntimeTransition, type SessionHostSurfaceKind, type SessionHostSurfaceRecordLike, type SessionHostWireEnvelope, type SessionLaunchCommand, type SessionLifecycle, type SessionOwnerType, SessionRingBuffer, type SessionRingBufferOptions, type SessionTerminalSnapshot, type SessionTerminalState, type SessionTermination, type SessionTransport, type SessionWriteOwner, type StopSessionPayload, type UpdateSessionMetaPayload, applyTerminalColorEnv, buildRuntimeDisplayName, buildRuntimeKey, canonicalizeInstancePath, classifyTermination, createLineParser, createResponseEnvelope, createSessionHostControlPlane, ensureNodePtySpawnHelperPermissions, formatRuntimeOwner, getDefaultSessionHostEndpoint, getSessionHostRecoveryLabel, getSessionHostSurfaceKind, getWorkspaceLabel, isDefaultInstanceConfigDir, isSessionHostLiveRuntime, isSessionHostRecoverySnapshot, isTerminalRecord, partitionSessionHostDiagnosticsSessions, partitionSessionHostRecords, resolveAttachableRuntimeRecord, resolveInstanceConfigDir, resolveRuntimeRecord, resolveSessionHostIpcKey, sanitizeSpawnEnv, writeEnvelope };

package/dist/index.d.ts

@@ -538,12 +538,43 @@ interface SessionHostClientOptions {
     endpoint?: SessionHostEndpoint;
     appName?: string;
 }
+/**
+ * Why an established session-host connection went away.
+ * - `error`  — socket emitted 'error' (includes ECONNRESET on abrupt host death)
+ * - `ended`  — peer sent FIN ('end'): the host closed the connection cleanly
+ * - `closed` — socket fully closed ('close') without a preceding error/end
+ */
+type SessionHostDisconnectReason = 'error' | 'ended' | 'closed';
+interface SessionHostDisconnectInfo {
+    reason: SessionHostDisconnectReason;
+    endpointPath: string;
+    /** In-flight requests abandoned by this disconnect (they were rejected). */
+    pendingRequests: number;
+    error?: Error;
+}
 declare class SessionHostClient {
     readonly endpoint: SessionHostEndpoint;
     private socket;
     private requestWaiters;
     private eventListeners;
+    private disconnectListeners;
+    /** Guards against emitting both an 'error'-path and a 'close'-path disconnect for one socket. */
+    private disconnectedSockets;
     constructor(options?: SessionHostClientOptions);
+    /**
+     * Fires when an established connection to the session host goes away.
+     *
+     * Before this existed the client registered only 'data' and 'error' handlers,
+     * so a *clean* FIN — the host process exiting normally, or dying to an
+     * uncaught exception that took the socket down without an error event on our
+     * end — ran nothing at all: `this.socket` stayed non-null pointing at a dead
+     * socket, in-flight waiters hung to their 30s timeout, and no caller was told.
+     * That silence is what let a session-host death present downstream as an
+     * unrelated application-level fault (a missing completion marker) instead of
+     * "the host is gone".
+     */
+    onDisconnect(listener: (info: SessionHostDisconnectInfo) => void): () => void;
+    private handleDisconnect;
     connect(): Promise<void>;
     onEvent(listener: (event: SessionHostEvent) => void): () => void;
     request<T = unknown>(request: SessionHostRequest): Promise<SessionHostResponse<T>>;
@@ -683,4 +714,4 @@ interface SessionHostControlTransport {
  */
 declare function createSessionHostControlPlane(transport: SessionHostControlTransport): SessionHostControlPlane;
 
-export { type AcquireWritePayload, type AttachSessionPayload, type ClearSessionBufferPayload, type CreateSessionPayload, DEFAULT_CONFIG_DIR_NAME, DEFAULT_SESSION_RING_BUFFER_MAX_BYTES, type DetachSessionPayload, type ForceDetachClientPayload, type GetHostDiagnosticsPayload, type GetSnapshotPayload, type GetTerminalSnapshotPayload, type PruneDuplicateSessionsPayload, type ReleaseWritePayload, type ResizeSessionPayload, type RestartSessionPayload, type ResumeSessionPayload, SESSION_HOST_SUPPORTED_REQUEST_TYPES, type SendInputPayload, type SendSignalPayload, type SessionAttachedClient, type SessionBufferSnapshot, type SessionClientType, type SessionHostCategory, SessionHostClient, type SessionHostClientOptions, type SessionHostControlPlane, type SessionHostControlTransport, type SessionHostDiagnostics, type SessionHostDuplicateSessionGroup, type SessionHostEndpoint, type SessionHostEndpointOptions, type SessionHostEvent, type SessionHostEventEnvelope, type SessionHostLogEntry, type SessionHostPruneDuplicatesResult, type SessionHostRecord, SessionHostRegistry, type SessionHostRequest, type SessionHostRequestEnvelope, type SessionHostRequestTrace, type SessionHostRequestType, type SessionHostResponse, type SessionHostResponseEnvelope, type SessionHostRuntimeTransition, type SessionHostSurfaceKind, type SessionHostSurfaceRecordLike, type SessionHostWireEnvelope, type SessionLaunchCommand, type SessionLifecycle, type SessionOwnerType, SessionRingBuffer, type SessionRingBufferOptions, type SessionTerminalSnapshot, type SessionTerminalState, type SessionTermination, type SessionTransport, type SessionWriteOwner, type StopSessionPayload, type UpdateSessionMetaPayload, applyTerminalColorEnv, buildRuntimeDisplayName, buildRuntimeKey, canonicalizeInstancePath, classifyTermination, createLineParser, createResponseEnvelope, createSessionHostControlPlane, ensureNodePtySpawnHelperPermissions, formatRuntimeOwner, getDefaultSessionHostEndpoint, getSessionHostRecoveryLabel, getSessionHostSurfaceKind, getWorkspaceLabel, isDefaultInstanceConfigDir, isSessionHostLiveRuntime, isSessionHostRecoverySnapshot, isTerminalRecord, partitionSessionHostDiagnosticsSessions, partitionSessionHostRecords, resolveAttachableRuntimeRecord, resolveInstanceConfigDir, resolveRuntimeRecord, resolveSessionHostIpcKey, sanitizeSpawnEnv, writeEnvelope };
+export { type AcquireWritePayload, type AttachSessionPayload, type ClearSessionBufferPayload, type CreateSessionPayload, DEFAULT_CONFIG_DIR_NAME, DEFAULT_SESSION_RING_BUFFER_MAX_BYTES, type DetachSessionPayload, type ForceDetachClientPayload, type GetHostDiagnosticsPayload, type GetSnapshotPayload, type GetTerminalSnapshotPayload, type PruneDuplicateSessionsPayload, type ReleaseWritePayload, type ResizeSessionPayload, type RestartSessionPayload, type ResumeSessionPayload, SESSION_HOST_SUPPORTED_REQUEST_TYPES, type SendInputPayload, type SendSignalPayload, type SessionAttachedClient, type SessionBufferSnapshot, type SessionClientType, type SessionHostCategory, SessionHostClient, type SessionHostClientOptions, type SessionHostControlPlane, type SessionHostControlTransport, type SessionHostDiagnostics, type SessionHostDisconnectInfo, type SessionHostDisconnectReason, type SessionHostDuplicateSessionGroup, type SessionHostEndpoint, type SessionHostEndpointOptions, type SessionHostEvent, type SessionHostEventEnvelope, type SessionHostLogEntry, type SessionHostPruneDuplicatesResult, type SessionHostRecord, SessionHostRegistry, type SessionHostRequest, type SessionHostRequestEnvelope, type SessionHostRequestTrace, type SessionHostRequestType, type SessionHostResponse, type SessionHostResponseEnvelope, type SessionHostRuntimeTransition, type SessionHostSurfaceKind, type SessionHostSurfaceRecordLike, type SessionHostWireEnvelope, type SessionLaunchCommand, type SessionLifecycle, type SessionOwnerType, SessionRingBuffer, type SessionRingBufferOptions, type SessionTerminalSnapshot, type SessionTerminalState, type SessionTermination, type SessionTransport, type SessionWriteOwner, type StopSessionPayload, type UpdateSessionMetaPayload, applyTerminalColorEnv, buildRuntimeDisplayName, buildRuntimeKey, canonicalizeInstancePath, classifyTermination, createLineParser, createResponseEnvelope, createSessionHostControlPlane, ensureNodePtySpawnHelperPermissions, formatRuntimeOwner, getDefaultSessionHostEndpoint, getSessionHostRecoveryLabel, getSessionHostSurfaceKind, getWorkspaceLabel, isDefaultInstanceConfigDir, isSessionHostLiveRuntime, isSessionHostRecoverySnapshot, isTerminalRecord, partitionSessionHostDiagnosticsSessions, partitionSessionHostRecords, resolveAttachableRuntimeRecord, resolveInstanceConfigDir, resolveRuntimeRecord, resolveSessionHostIpcKey, sanitizeSpawnEnv, writeEnvelope };

package/dist/index.js

@@ -627,14 +627,77 @@ function createLineParser(onEnvelope) {
     }
   };
 }
+var establishedSockets = /* @__PURE__ */ new WeakSet();
 var SessionHostClient = class {
   endpoint;
   socket = null;
   requestWaiters = /* @__PURE__ */ new Map();
   eventListeners = /* @__PURE__ */ new Set();
+  disconnectListeners = /* @__PURE__ */ new Set();
+  /** Guards against emitting both an 'error'-path and a 'close'-path disconnect for one socket. */
+  disconnectedSockets = /* @__PURE__ */ new WeakSet();
   constructor(options = {}) {
     this.endpoint = options.endpoint || getDefaultSessionHostEndpoint(options.appName || "adhdev");
   }
+  /**
+   * Fires when an established connection to the session host goes away.
+   *
+   * Before this existed the client registered only 'data' and 'error' handlers,
+   * so a *clean* FIN — the host process exiting normally, or dying to an
+   * uncaught exception that took the socket down without an error event on our
+   * end — ran nothing at all: `this.socket` stayed non-null pointing at a dead
+   * socket, in-flight waiters hung to their 30s timeout, and no caller was told.
+   * That silence is what let a session-host death present downstream as an
+   * unrelated application-level fault (a missing completion marker) instead of
+   * "the host is gone".
+   */
+  onDisconnect(listener) {
+    this.disconnectListeners.add(listener);
+    return () => {
+      this.disconnectListeners.delete(listener);
+    };
+  }
+  handleDisconnect(socket, reason, error) {
+    if (this.disconnectedSockets.has(socket)) return;
+    this.disconnectedSockets.add(socket);
+    const wasEstablished = establishedSockets.has(socket);
+    if (!wasEstablished) {
+      if (this.socket === socket) this.socket = null;
+      try {
+        socket.destroy();
+      } catch {
+      }
+      const failure2 = error || new Error(`Session host connect failed (${this.endpoint.path})`);
+      for (const waiter of this.requestWaiters.values()) waiter.reject(failure2);
+      this.requestWaiters.clear();
+      return;
+    }
+    const pendingRequests = this.requestWaiters.size;
+    const failure = error || new Error(`Session host connection ${reason} (${this.endpoint.path})`);
+    for (const waiter of this.requestWaiters.values()) {
+      waiter.reject(failure);
+    }
+    this.requestWaiters.clear();
+    if (this.socket === socket) {
+      this.socket = null;
+    }
+    try {
+      socket.destroy();
+    } catch {
+    }
+    const info = {
+      reason,
+      endpointPath: this.endpoint.path,
+      pendingRequests,
+      error
+    };
+    for (const listener of this.disconnectListeners) {
+      try {
+        listener(info);
+      } catch {
+      }
+    }
+  }
   async connect() {
     if (this.socket && !this.socket.destroyed) return;
     if (this.socket) {
@@ -660,20 +723,19 @@ var SessionHostClient = class {
       }
     }));
     socket.on("error", (error) => {
-      for (const waiter of this.requestWaiters.values()) {
-        waiter.reject(error);
-      }
-      this.requestWaiters.clear();
-      if (this.socket === socket) {
-        this.socket = null;
-      }
-      try {
-        socket.destroy();
-      } catch {
-      }
+      this.handleDisconnect(socket, "error", error);
+    });
+    socket.on("close", () => {
+      this.handleDisconnect(socket, "closed");
+    });
+    socket.on("end", () => {
+      this.handleDisconnect(socket, "ended");
     });
     await new Promise((resolve3, reject) => {
-      socket.once("connect", () => resolve3());
+      socket.once("connect", () => {
+        establishedSockets.add(socket);
+        resolve3();
+      });
       socket.once("error", reject);
     });
   }
@@ -715,6 +777,7 @@ var SessionHostClient = class {
     if (!this.socket) return;
     const socket = this.socket;
     this.socket = null;
+    this.disconnectedSockets.add(socket);
     for (const waiter of this.requestWaiters.values()) {
       waiter.reject(new Error("Session host client closed"));
     }