@adhdev/session-host-core 1.0.60-rc.6 → 1.0.60-rc.60

package/dist/index.d.mts

@@ -549,8 +549,16 @@ declare function getDefaultSessionHostEndpoint(appName?: string, options?: Sessi
  * finish it arrive, which is the only correct way to turn a byte stream into
  * text. String chunks bypass it: they are already decoded, and feeding them
  * through `Buffer.from` would re-encode text the caller never asked us to touch.
+ *
+ * The envelope type is a parameter (defaulting to this package's own wire type)
+ * purely so sibling newline-framed sockets can REUSE this decoder rather than
+ * re-deriving it. `@adhdev/terminal-mux-control`'s control socket carried a
+ * verbatim `chunk.toString()` copy of the pre-fix parser and inherited the same
+ * silent corruption; it now shares this implementation. Nothing about the
+ * framing is session-host-specific — only the payload type was, and that is now
+ * the caller's to name.
  */
-declare function createLineParser(onEnvelope: (envelope: SessionHostWireEnvelope) => void): {
+declare function createLineParser<TEnvelope = SessionHostWireEnvelope>(onEnvelope: (envelope: TEnvelope) => void): {
     (chunk: Buffer | string): void;
     end(): string;
 };
@@ -700,8 +708,16 @@ declare function applyTerminalColorEnv(env: Record<string, string>): void;
  */
 declare function ensureNodePtySpawnHelperPermissions(logFn?: (msg: string) => void): void;
 
+/** Response shape of the `get_snapshot` wire request — a PTY snapshot for a session. */
+interface SessionHostSnapshot {
+    seq: number;
+    text: string;
+    truncated: boolean;
+    cols?: number;
+    rows?: number;
+}
 /**
- * The 11-method session-host control-plane surface shared by the cloud and
+ * The session-host control-plane surface shared by the cloud and
  * standalone daemons. Both daemons used to carry a byte-for-byte copy of this
  * dispatch table plus the identical throw strings; this is the single source of
  * truth for that mapping. The wire `type` strings and error text here are the
@@ -721,6 +737,14 @@ interface SessionHostControlPlane {
     pruneDuplicateSessions(payload?: PruneDuplicateSessionsPayload): Promise<SessionHostPruneDuplicatesResult>;
     acquireWrite(payload: AcquireWritePayload): Promise<SessionHostRecord | null>;
     releaseWrite(payload: ReleaseWritePayload): Promise<SessionHostRecord | null>;
+    /**
+     * A PTY snapshot for `sessionId` (optionally only the tail since `sinceSeq`),
+     * over wire type `get_snapshot`. Mirrors the shape daemon-core's local
+     * `SessionHostControlPlane` interface (`commands/router.ts`) and cloud's
+     * former `cloud-command-transports.ts` P2P-only `get_runtime_snapshot` case
+     * both already used against a raw `SessionHostClient`.
+     */
+    getSnapshot(sessionId: string, sinceSeq?: number): Promise<SessionHostSnapshot | null>;
 }
 /**
  * Minimal request transport the control-plane factory needs. Each daemon injects
@@ -737,11 +761,11 @@ interface SessionHostControlTransport {
     request<T>(type: SessionHostRequestType, payload: Record<string, unknown>): Promise<T>;
 }
 /**
- * Build the shared 11-method control-plane over an injected request transport.
+ * Build the shared 12-method control-plane over an injected request transport.
  * The (type string, payload shape) pairs are verbatim what both daemons emitted
  * previously — do not reword them without matching the session-host daemon's
  * request handlers.
  */
 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 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 };
+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 SessionHostSnapshot, 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

@@ -549,8 +549,16 @@ declare function getDefaultSessionHostEndpoint(appName?: string, options?: Sessi
  * finish it arrive, which is the only correct way to turn a byte stream into
  * text. String chunks bypass it: they are already decoded, and feeding them
  * through `Buffer.from` would re-encode text the caller never asked us to touch.
+ *
+ * The envelope type is a parameter (defaulting to this package's own wire type)
+ * purely so sibling newline-framed sockets can REUSE this decoder rather than
+ * re-deriving it. `@adhdev/terminal-mux-control`'s control socket carried a
+ * verbatim `chunk.toString()` copy of the pre-fix parser and inherited the same
+ * silent corruption; it now shares this implementation. Nothing about the
+ * framing is session-host-specific — only the payload type was, and that is now
+ * the caller's to name.
  */
-declare function createLineParser(onEnvelope: (envelope: SessionHostWireEnvelope) => void): {
+declare function createLineParser<TEnvelope = SessionHostWireEnvelope>(onEnvelope: (envelope: TEnvelope) => void): {
     (chunk: Buffer | string): void;
     end(): string;
 };
@@ -700,8 +708,16 @@ declare function applyTerminalColorEnv(env: Record<string, string>): void;
  */
 declare function ensureNodePtySpawnHelperPermissions(logFn?: (msg: string) => void): void;
 
+/** Response shape of the `get_snapshot` wire request — a PTY snapshot for a session. */
+interface SessionHostSnapshot {
+    seq: number;
+    text: string;
+    truncated: boolean;
+    cols?: number;
+    rows?: number;
+}
 /**
- * The 11-method session-host control-plane surface shared by the cloud and
+ * The session-host control-plane surface shared by the cloud and
  * standalone daemons. Both daemons used to carry a byte-for-byte copy of this
  * dispatch table plus the identical throw strings; this is the single source of
  * truth for that mapping. The wire `type` strings and error text here are the
@@ -721,6 +737,14 @@ interface SessionHostControlPlane {
     pruneDuplicateSessions(payload?: PruneDuplicateSessionsPayload): Promise<SessionHostPruneDuplicatesResult>;
     acquireWrite(payload: AcquireWritePayload): Promise<SessionHostRecord | null>;
     releaseWrite(payload: ReleaseWritePayload): Promise<SessionHostRecord | null>;
+    /**
+     * A PTY snapshot for `sessionId` (optionally only the tail since `sinceSeq`),
+     * over wire type `get_snapshot`. Mirrors the shape daemon-core's local
+     * `SessionHostControlPlane` interface (`commands/router.ts`) and cloud's
+     * former `cloud-command-transports.ts` P2P-only `get_runtime_snapshot` case
+     * both already used against a raw `SessionHostClient`.
+     */
+    getSnapshot(sessionId: string, sinceSeq?: number): Promise<SessionHostSnapshot | null>;
 }
 /**
  * Minimal request transport the control-plane factory needs. Each daemon injects
@@ -737,11 +761,11 @@ interface SessionHostControlTransport {
     request<T>(type: SessionHostRequestType, payload: Record<string, unknown>): Promise<T>;
 }
 /**
- * Build the shared 11-method control-plane over an injected request transport.
+ * Build the shared 12-method control-plane over an injected request transport.
  * The (type string, payload shape) pairs are verbatim what both daemons emitted
  * previously — do not reword them without matching the session-host daemon's
  * request handlers.
  */
 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 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 };
+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 SessionHostSnapshot, 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

@@ -571,10 +571,21 @@ var SessionHostRegistry = class {
       writeOwner: record.writeOwner ? { ...record.writeOwner } : null,
       attachedClients: record.attachedClients.map((client) => ({ ...client })),
       buffer: { ...record.buffer },
-      meta: { ...record.meta }
+      // Deep: meta carries nested records (e.g. the daemon's `launchRecord`,
+      // wiring-unification Phase E), and a caller mutating a returned record
+      // must never reach into the registry's own copy.
+      meta: cloneMeta(record.meta)
     };
   }
 };
+function cloneMeta(meta) {
+  if (!meta) return {};
+  try {
+    return structuredClone(meta);
+  } catch {
+    return { ...meta };
+  }
+}
 
 // src/ipc.ts
 var os = __toESM(require("os"));
@@ -960,6 +971,9 @@ function createSessionHostControlPlane(transport) {
     },
     releaseWrite(payload) {
       return transport.request("release_write", payload);
+    },
+    getSnapshot(sessionId, sinceSeq) {
+      return transport.request("get_snapshot", { sessionId, sinceSeq });
     }
   };
 }