@adhdev/session-host-core 0.9.81 → 0.9.82-rc.453

package/dist/index.d.mts

@@ -30,6 +30,25 @@ interface SessionBufferSnapshot {
     cols?: number;
     rows?: number;
 }
+interface SessionTerminalState {
+    cursor: {
+        row: number;
+        col: number;
+    };
+    altScreen: boolean;
+    pasteMode: boolean;
+    rawMode: boolean;
+    scrollRegion: {
+        top: number;
+        bot: number;
+    };
+    cols: number;
+    rows: number;
+}
+interface SessionTerminalSnapshot {
+    text: string;
+    state: SessionTerminalState;
+}
 interface SessionBufferState {
     scrollbackBytes: number;
     snapshotSeq: number;
@@ -115,6 +134,9 @@ interface GetSnapshotPayload {
     sessionId: string;
     sinceSeq?: number;
 }
+interface GetTerminalSnapshotPayload {
+    sessionId: string;
+}
 interface ClearSessionBufferPayload {
     sessionId: string;
 }
@@ -229,6 +251,9 @@ type SessionHostRequest = {
 } | {
     type: 'get_snapshot';
     payload: GetSnapshotPayload;
+} | {
+    type: 'get_terminal_snapshot';
+    payload: GetTerminalSnapshotPayload;
 } | {
     type: 'clear_session_buffer';
     payload: ClearSessionBufferPayload;
@@ -398,6 +423,12 @@ declare function isSessionHostLiveRuntime(record: SessionHostSurfaceRecordLike |
 declare function getSessionHostRecoveryLabel(meta: Record<string, unknown> | null | undefined): string | null;
 declare function isSessionHostRecoverySnapshot(record: SessionHostSurfaceRecordLike | null | undefined): boolean;
 declare function getSessionHostSurfaceKind(record: SessionHostSurfaceRecordLike | null | undefined): SessionHostSurfaceKind;
+declare function partitionSessionHostRecords<T extends SessionHostSurfaceRecordLike>(records: T[]): {
+    liveRuntimes: T[];
+    recoverySnapshots: T[];
+    inactiveRecords: T[];
+};
+declare function partitionSessionHostDiagnosticsSessions(records: SessionHostRecord[] | null | undefined): ReturnType<typeof partitionSessionHostRecords<SessionHostRecord>>;
 declare function resolveAttachableRuntimeRecord(records: SessionHostRecord[], identifier: string): SessionHostRecord;
 declare function resolveRuntimeRecord(records: SessionHostRecord[], identifier: string): SessionHostRecord;
 declare function formatRuntimeOwner(record: Pick<SessionHostRecord, 'writeOwner'>): string;
@@ -455,4 +486,48 @@ declare function applyTerminalColorEnv(env: Record<string, string>): void;
  */
 declare function ensureNodePtySpawnHelperPermissions(logFn?: (msg: string) => void): void;
 
-export { type AcquireWritePayload, type AttachSessionPayload, type ClearSessionBufferPayload, type CreateSessionPayload, DEFAULT_SESSION_RING_BUFFER_MAX_BYTES, type DetachSessionPayload, type ForceDetachClientPayload, type GetHostDiagnosticsPayload, type GetSnapshotPayload, 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 SessionHostDiagnostics, type SessionHostDuplicateSessionGroup, type SessionHostEndpoint, 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 SessionHostWireEnvelope, type SessionLaunchCommand, type SessionLifecycle, type SessionOwnerType, SessionRingBuffer, type SessionRingBufferOptions, type SessionTransport, type SessionWriteOwner, type StopSessionPayload, type UpdateSessionMetaPayload, applyTerminalColorEnv, buildRuntimeDisplayName, buildRuntimeKey, createLineParser, createResponseEnvelope, ensureNodePtySpawnHelperPermissions, formatRuntimeOwner, getDefaultSessionHostEndpoint, getSessionHostRecoveryLabel, getSessionHostSurfaceKind, getWorkspaceLabel, isSessionHostLiveRuntime, isSessionHostRecoverySnapshot, resolveAttachableRuntimeRecord, resolveRuntimeRecord, sanitizeSpawnEnv, writeEnvelope };
+/**
+ * The 11-method 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
+ * daemon IPC contract and MUST match what the session-host daemon accepts.
+ */
+interface SessionHostControlPlane {
+    getDiagnostics(payload?: GetHostDiagnosticsPayload): Promise<SessionHostDiagnostics>;
+    listSessions(): Promise<SessionHostRecord[]>;
+    stopSession(sessionId: string): Promise<SessionHostRecord | null>;
+    deleteSession(sessionId: string, opts?: {
+        force?: boolean;
+    }): Promise<SessionHostRecord | null>;
+    resumeSession(sessionId: string): Promise<SessionHostRecord | null>;
+    restartSession(sessionId: string): Promise<SessionHostRecord | null>;
+    sendSignal(sessionId: string, signal: string): Promise<SessionHostRecord | null>;
+    forceDetachClient(sessionId: string, clientId: string): Promise<SessionHostRecord | null>;
+    pruneDuplicateSessions(payload?: PruneDuplicateSessionsPayload): Promise<SessionHostPruneDuplicatesResult>;
+    acquireWrite(payload: AcquireWritePayload): Promise<SessionHostRecord | null>;
+    releaseWrite(payload: ReleaseWritePayload): Promise<SessionHostRecord | null>;
+}
+/**
+ * Minimal request transport the control-plane factory needs. Each daemon injects
+ * its own implementation:
+ *   - cloud reuses a single persistent SessionHostClient (with reconnect); its
+ *     `request` calls `ensureConnected()` then the shared client.
+ *   - standalone opens a fresh client per request and closes it in `finally`.
+ *
+ * The factory below owns ONLY the type/payload dispatch table; the connection
+ * lifecycle and success/error unwrapping stay in each daemon's transport so the
+ * observable behavior of both paths is preserved exactly.
+ */
+interface SessionHostControlTransport {
+    request<T>(type: SessionHostRequestType, payload: Record<string, unknown>): Promise<T>;
+}
+/**
+ * Build the shared 11-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_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 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 SessionTransport, type SessionWriteOwner, type StopSessionPayload, type UpdateSessionMetaPayload, applyTerminalColorEnv, buildRuntimeDisplayName, buildRuntimeKey, createLineParser, createResponseEnvelope, createSessionHostControlPlane, ensureNodePtySpawnHelperPermissions, formatRuntimeOwner, getDefaultSessionHostEndpoint, getSessionHostRecoveryLabel, getSessionHostSurfaceKind, getWorkspaceLabel, isSessionHostLiveRuntime, isSessionHostRecoverySnapshot, partitionSessionHostDiagnosticsSessions, partitionSessionHostRecords, resolveAttachableRuntimeRecord, resolveRuntimeRecord, sanitizeSpawnEnv, writeEnvelope };

package/dist/index.d.ts

@@ -30,6 +30,25 @@ interface SessionBufferSnapshot {
     cols?: number;
     rows?: number;
 }
+interface SessionTerminalState {
+    cursor: {
+        row: number;
+        col: number;
+    };
+    altScreen: boolean;
+    pasteMode: boolean;
+    rawMode: boolean;
+    scrollRegion: {
+        top: number;
+        bot: number;
+    };
+    cols: number;
+    rows: number;
+}
+interface SessionTerminalSnapshot {
+    text: string;
+    state: SessionTerminalState;
+}
 interface SessionBufferState {
     scrollbackBytes: number;
     snapshotSeq: number;
@@ -115,6 +134,9 @@ interface GetSnapshotPayload {
     sessionId: string;
     sinceSeq?: number;
 }
+interface GetTerminalSnapshotPayload {
+    sessionId: string;
+}
 interface ClearSessionBufferPayload {
     sessionId: string;
 }
@@ -229,6 +251,9 @@ type SessionHostRequest = {
 } | {
     type: 'get_snapshot';
     payload: GetSnapshotPayload;
+} | {
+    type: 'get_terminal_snapshot';
+    payload: GetTerminalSnapshotPayload;
 } | {
     type: 'clear_session_buffer';
     payload: ClearSessionBufferPayload;
@@ -398,6 +423,12 @@ declare function isSessionHostLiveRuntime(record: SessionHostSurfaceRecordLike |
 declare function getSessionHostRecoveryLabel(meta: Record<string, unknown> | null | undefined): string | null;
 declare function isSessionHostRecoverySnapshot(record: SessionHostSurfaceRecordLike | null | undefined): boolean;
 declare function getSessionHostSurfaceKind(record: SessionHostSurfaceRecordLike | null | undefined): SessionHostSurfaceKind;
+declare function partitionSessionHostRecords<T extends SessionHostSurfaceRecordLike>(records: T[]): {
+    liveRuntimes: T[];
+    recoverySnapshots: T[];
+    inactiveRecords: T[];
+};
+declare function partitionSessionHostDiagnosticsSessions(records: SessionHostRecord[] | null | undefined): ReturnType<typeof partitionSessionHostRecords<SessionHostRecord>>;
 declare function resolveAttachableRuntimeRecord(records: SessionHostRecord[], identifier: string): SessionHostRecord;
 declare function resolveRuntimeRecord(records: SessionHostRecord[], identifier: string): SessionHostRecord;
 declare function formatRuntimeOwner(record: Pick<SessionHostRecord, 'writeOwner'>): string;
@@ -455,4 +486,48 @@ declare function applyTerminalColorEnv(env: Record<string, string>): void;
  */
 declare function ensureNodePtySpawnHelperPermissions(logFn?: (msg: string) => void): void;
 
-export { type AcquireWritePayload, type AttachSessionPayload, type ClearSessionBufferPayload, type CreateSessionPayload, DEFAULT_SESSION_RING_BUFFER_MAX_BYTES, type DetachSessionPayload, type ForceDetachClientPayload, type GetHostDiagnosticsPayload, type GetSnapshotPayload, 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 SessionHostDiagnostics, type SessionHostDuplicateSessionGroup, type SessionHostEndpoint, 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 SessionHostWireEnvelope, type SessionLaunchCommand, type SessionLifecycle, type SessionOwnerType, SessionRingBuffer, type SessionRingBufferOptions, type SessionTransport, type SessionWriteOwner, type StopSessionPayload, type UpdateSessionMetaPayload, applyTerminalColorEnv, buildRuntimeDisplayName, buildRuntimeKey, createLineParser, createResponseEnvelope, ensureNodePtySpawnHelperPermissions, formatRuntimeOwner, getDefaultSessionHostEndpoint, getSessionHostRecoveryLabel, getSessionHostSurfaceKind, getWorkspaceLabel, isSessionHostLiveRuntime, isSessionHostRecoverySnapshot, resolveAttachableRuntimeRecord, resolveRuntimeRecord, sanitizeSpawnEnv, writeEnvelope };
+/**
+ * The 11-method 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
+ * daemon IPC contract and MUST match what the session-host daemon accepts.
+ */
+interface SessionHostControlPlane {
+    getDiagnostics(payload?: GetHostDiagnosticsPayload): Promise<SessionHostDiagnostics>;
+    listSessions(): Promise<SessionHostRecord[]>;
+    stopSession(sessionId: string): Promise<SessionHostRecord | null>;
+    deleteSession(sessionId: string, opts?: {
+        force?: boolean;
+    }): Promise<SessionHostRecord | null>;
+    resumeSession(sessionId: string): Promise<SessionHostRecord | null>;
+    restartSession(sessionId: string): Promise<SessionHostRecord | null>;
+    sendSignal(sessionId: string, signal: string): Promise<SessionHostRecord | null>;
+    forceDetachClient(sessionId: string, clientId: string): Promise<SessionHostRecord | null>;
+    pruneDuplicateSessions(payload?: PruneDuplicateSessionsPayload): Promise<SessionHostPruneDuplicatesResult>;
+    acquireWrite(payload: AcquireWritePayload): Promise<SessionHostRecord | null>;
+    releaseWrite(payload: ReleaseWritePayload): Promise<SessionHostRecord | null>;
+}
+/**
+ * Minimal request transport the control-plane factory needs. Each daemon injects
+ * its own implementation:
+ *   - cloud reuses a single persistent SessionHostClient (with reconnect); its
+ *     `request` calls `ensureConnected()` then the shared client.
+ *   - standalone opens a fresh client per request and closes it in `finally`.
+ *
+ * The factory below owns ONLY the type/payload dispatch table; the connection
+ * lifecycle and success/error unwrapping stay in each daemon's transport so the
+ * observable behavior of both paths is preserved exactly.
+ */
+interface SessionHostControlTransport {
+    request<T>(type: SessionHostRequestType, payload: Record<string, unknown>): Promise<T>;
+}
+/**
+ * Build the shared 11-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_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 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 SessionTransport, type SessionWriteOwner, type StopSessionPayload, type UpdateSessionMetaPayload, applyTerminalColorEnv, buildRuntimeDisplayName, buildRuntimeKey, createLineParser, createResponseEnvelope, createSessionHostControlPlane, ensureNodePtySpawnHelperPermissions, formatRuntimeOwner, getDefaultSessionHostEndpoint, getSessionHostRecoveryLabel, getSessionHostSurfaceKind, getWorkspaceLabel, isSessionHostLiveRuntime, isSessionHostRecoverySnapshot, partitionSessionHostDiagnosticsSessions, partitionSessionHostRecords, resolveAttachableRuntimeRecord, resolveRuntimeRecord, sanitizeSpawnEnv, writeEnvelope };

package/dist/index.js

@@ -42,6 +42,7 @@ __export(index_exports, {
   buildRuntimeKey: () => buildRuntimeKey,
   createLineParser: () => createLineParser,
   createResponseEnvelope: () => createResponseEnvelope,
+  createSessionHostControlPlane: () => createSessionHostControlPlane,
   ensureNodePtySpawnHelperPermissions: () => ensureNodePtySpawnHelperPermissions,
   formatRuntimeOwner: () => formatRuntimeOwner,
   getDefaultSessionHostEndpoint: () => getDefaultSessionHostEndpoint,
@@ -50,6 +51,8 @@ __export(index_exports, {
   getWorkspaceLabel: () => getWorkspaceLabel,
   isSessionHostLiveRuntime: () => isSessionHostLiveRuntime,
   isSessionHostRecoverySnapshot: () => isSessionHostRecoverySnapshot,
+  partitionSessionHostDiagnosticsSessions: () => partitionSessionHostDiagnosticsSessions,
+  partitionSessionHostRecords: () => partitionSessionHostRecords,
   resolveAttachableRuntimeRecord: () => resolveAttachableRuntimeRecord,
   resolveRuntimeRecord: () => resolveRuntimeRecord,
   resolveSessionHostCols: () => resolveSessionHostCols,
@@ -72,6 +75,7 @@ var SESSION_HOST_SUPPORTED_REQUEST_TYPES = [
   "acquire_write",
   "release_write",
   "get_snapshot",
+  "get_terminal_snapshot",
   "clear_session_buffer",
   "update_session_meta",
   "get_host_diagnostics",
@@ -234,6 +238,29 @@ function getSessionHostSurfaceKind(record) {
   if (isSessionHostRecoverySnapshot(record)) return "recovery_snapshot";
   return "inactive_record";
 }
+function partitionSessionHostRecords(records) {
+  const liveRuntimes = [];
+  const recoverySnapshots = [];
+  const inactiveRecords = [];
+  for (const record of records) {
+    const kind = getSessionHostSurfaceKind(record);
+    if (kind === "live_runtime") {
+      liveRuntimes.push(record);
+    } else if (kind === "recovery_snapshot") {
+      recoverySnapshots.push(record);
+    } else {
+      inactiveRecords.push(record);
+    }
+  }
+  return {
+    liveRuntimes,
+    recoverySnapshots,
+    inactiveRecords
+  };
+}
+function partitionSessionHostDiagnosticsSessions(records) {
+  return partitionSessionHostRecords(records || []);
+}
 function resolveAttachableRuntimeRecord(records, identifier) {
   const record = resolveRuntimeRecord(records, identifier);
   const surfaceKind = getSessionHostSurfaceKind(record);
@@ -680,6 +707,16 @@ function sanitizeSpawnEnv(baseEnv, overrides) {
   }
   delete env.CODEX_THREAD_ID;
   delete env.CODEX_INTERNAL_ORIGINATOR_OVERRIDE;
+  delete env.CODEX_SANDBOX_NETWORK_DISABLED;
+  delete env.NO_COLOR;
+  delete env.COLOR;
+  if (process.platform === "win32") {
+    delete env.CLAUDECODE;
+    delete env.CLAUDE_CODE_CHILD_SESSION;
+    delete env.CLAUDE_CODE_ENTRYPOINT;
+    delete env.CLAUDE_CODE_SESSION_ID;
+    delete env.CLAUDE_CODE_EXECPATH;
+  }
   applyTerminalColorEnv(env);
   return env;
 }
@@ -711,6 +748,45 @@ function ensureNodePtySpawnHelperPermissions(logFn) {
   } catch {
   }
 }
+
+// src/control-plane.ts
+function createSessionHostControlPlane(transport) {
+  return {
+    getDiagnostics(payload = {}) {
+      return transport.request("get_host_diagnostics", payload);
+    },
+    listSessions() {
+      return transport.request("list_sessions", {});
+    },
+    stopSession(sessionId) {
+      return transport.request("stop_session", { sessionId });
+    },
+    deleteSession(sessionId, opts = {}) {
+      return transport.request("delete_session", { sessionId, force: opts.force === true });
+    },
+    resumeSession(sessionId) {
+      return transport.request("resume_session", { sessionId });
+    },
+    restartSession(sessionId) {
+      return transport.request("restart_session", { sessionId });
+    },
+    sendSignal(sessionId, signal) {
+      return transport.request("send_signal", { sessionId, signal });
+    },
+    forceDetachClient(sessionId, clientId) {
+      return transport.request("force_detach_client", { sessionId, clientId });
+    },
+    pruneDuplicateSessions(payload = {}) {
+      return transport.request("prune_duplicate_sessions", payload);
+    },
+    acquireWrite(payload) {
+      return transport.request("acquire_write", payload);
+    },
+    releaseWrite(payload) {
+      return transport.request("release_write", payload);
+    }
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   DEFAULT_SESSION_HOST_COLS,
@@ -725,6 +801,7 @@ function ensureNodePtySpawnHelperPermissions(logFn) {
   buildRuntimeKey,
   createLineParser,
   createResponseEnvelope,
+  createSessionHostControlPlane,
   ensureNodePtySpawnHelperPermissions,
   formatRuntimeOwner,
   getDefaultSessionHostEndpoint,
@@ -733,6 +810,8 @@ function ensureNodePtySpawnHelperPermissions(logFn) {
   getWorkspaceLabel,
   isSessionHostLiveRuntime,
   isSessionHostRecoverySnapshot,
+  partitionSessionHostDiagnosticsSessions,
+  partitionSessionHostRecords,
   resolveAttachableRuntimeRecord,
   resolveRuntimeRecord,
   resolveSessionHostCols,