@adhdev/daemon-core 0.8.52 → 0.8.54

package/dist/providers/acp-provider-instance.d.ts

@@ -14,8 +14,9 @@
  * 4. onEvent('send_message') → session/prompt transmit
  * 5. dispose() → kill process
  */
-import type { ProviderModule, ContentBlock } from './contracts.js';
+import type { ProviderModule, ContentBlock, InputEnvelope } from './contracts.js';
 import type { ProviderInstance, AcpProviderState, InstanceContext } from './provider-instance.js';
+export declare function buildAcpPromptParts(input: InputEnvelope, agentCapabilities?: Record<string, any>): ContentBlock[];
 export declare class AcpProviderInstance implements ProviderInstance {
     private cliArgs;
     readonly type: string;

package/dist/providers/cli-provider-instance.d.ts

@@ -4,10 +4,11 @@
  * Lifecycle layer on top of ProviderCliAdapter.
  * collectCliData() + status transition logic from daemon-status.ts moved here.
  */
-import type { ProviderModule } from './contracts.js';
+import { type ProviderModule } from './contracts.js';
 import type { ProviderInstance, ProviderState, InstanceContext } from './provider-instance.js';
 import { ProviderCliAdapter } from '../cli-adapters/provider-cli-adapter.js';
 import type { PtyTransportFactory } from '../cli-adapters/pty-transport.js';
+export declare function getForcedNewSessionScriptName(provider: ProviderModule | undefined, launchMode: 'new' | 'resume' | 'manual'): string | null;
 export declare class CliProviderInstance implements ProviderInstance {
     private provider;
     private workingDir;
@@ -62,6 +63,7 @@ export declare class CliProviderInstance implements ProviderInstance {
     dispose(): void;
     private completedDebounceTimer;
     private completedDebouncePending;
+    private enforceFreshSessionLaunchIfNeeded;
     private detectStatusTransition;
     private pushEvent;
     private flushEvents;

package/dist/providers/cli-script-results.d.ts

@@ -0,0 +1,8 @@
+export declare function parseCliScriptResult(result: unknown): {
+    success: boolean;
+    payload: any;
+};
+export declare function getCliScriptCommand(payload: any): {
+    type: string;
+    text?: string;
+} | null;

package/dist/providers/contracts.d.ts

@@ -29,7 +29,9 @@ export interface ReadChatResult {
     effects?: ProviderEffect[];
 }
 import type { ChatMessage } from '../types.js';
-export type { ChatMessage };
+export { flattenMessageParts, normalizeInputEnvelope, normalizeMessageParts, } from './io-contracts.js';
+import type { InputEnvelope, InputPart, MessagePart } from './io-contracts.js';
+export type { ChatMessage, InputEnvelope, InputPart, MessagePart };
 export type AgentStatus = 'idle' | 'generating' | 'waiting_approval' | 'error' | 'panel_hidden' | 'streaming';
 export interface ModalInfo {
     message: string;
@@ -39,7 +41,7 @@ export interface ModalInfo {
 }
 export interface ProviderEffectMessage {
     role?: 'system' | 'assistant' | 'user';
-    content: string | ContentBlock[];
+    content: string | MessagePart[];
     kind?: string;
     senderName?: string;
 }
@@ -55,7 +57,7 @@ export interface ProviderEffectNotification {
     level?: 'info' | 'success' | 'warning';
     channels?: ProviderNotificationChannel[];
     preferenceKey?: ProviderNotificationPreferenceKey;
-    bubbleContent?: string | ContentBlock[];
+    bubbleContent?: string | MessagePart[];
 }
 export interface ProviderEffect {
     type: 'message' | 'toast' | 'notification';
@@ -156,16 +158,18 @@ export interface ToolCallLocation {
     path: string;
     line?: number | null;
 }
-/** Normalize content: string → ContentBlock[] */
-export declare function normalizeContent(content: string | ContentBlock[]): ContentBlock[];
-/** Flatten ContentBlock[] → string (backward compat / plain-text extraction) */
-export declare function flattenContent(content: string | ContentBlock[]): string;
-/** SendMessage params — supports rich content (ACP PromptRequest compatible) */
+/** Normalize content into canonical message parts */
+export declare function normalizeContent(content: string | MessagePart[] | ContentBlock[]): MessagePart[];
+/** Flatten canonical/legacy content into a plain-text fallback string */
+export declare function flattenContent(content: string | MessagePart[] | ContentBlock[]): string;
+/** SendMessage params — canonical input envelope with legacy text/prompt compatibility */
 export interface SendMessageParams {
     /** Shortcut: text-only message */
     text?: string;
-    /** Rich content blocks (ACP ContentBlock[]) */
+    /** Rich content blocks (legacy ACP ContentBlock[]) */
     prompt?: ContentBlock[];
+    /** Canonical multipart runtime input */
+    input?: InputEnvelope;
 }
 export interface SendMessageResult {
     sent: boolean;
@@ -257,6 +261,12 @@ export interface ProviderModule {
     icon?: string;
     /** Display name (short name) */
     displayName?: string;
+    /** Provider-definition version maintained in adhdev-providers */
+    providerVersion?: string;
+    /** Inventory/support status label maintained in adhdev-providers */
+    status?: string;
+    /** Inventory/support detail string maintained in adhdev-providers */
+    details?: string;
     /** Install instructions (shown when command is missing) */
     install?: string;
     /** Custom version detection command (e.g. 'cursor --version', 'claude -v') */
@@ -311,6 +321,14 @@ export interface ProviderModule {
         shell?: boolean;
         env?: Record<string, string>;
     };
+    /** Delay before submitting typed CLI input (provider-specific TUI tuning) */
+    sendDelayMs?: number;
+    /** Submit key used after typing into CLI PTY (default: carriage return) */
+    sendKey?: string;
+    /** How the CLI adapter decides when to submit typed input */
+    submitStrategy?: 'wait_for_echo' | 'immediate';
+    /** Keep this provider out of the upstream auto-updated bundle */
+    disableUpstream?: boolean;
     approvalKeys?: Record<number, string>;
     patterns?: {
         prompt?: RegExp[];
@@ -376,6 +394,20 @@ export interface ProviderModule {
     spawnArgBuilder?: (config: Record<string, string>) => string[];
     /** ACP agent auth methods (multiple supported — in priority order) */
     auth?: AcpAuthMethod[];
+    contractVersion?: number;
+    capabilities?: {
+        input?: {
+            multipart?: boolean;
+            mediaTypes?: Array<'text' | 'image' | 'audio' | 'video' | 'resource'>;
+        };
+        output?: {
+            richContent?: boolean;
+            mediaTypes?: Array<'text' | 'image' | 'audio' | 'video' | 'resource'>;
+        };
+        controls?: {
+            typedResults?: boolean;
+        };
+    };
 }
 export interface ProviderResumeCapability {
     supported: boolean;
@@ -549,6 +581,23 @@ export interface ProviderControlOption {
     description?: string;
     group?: string;
 }
+export interface ControlListResult {
+    options: ProviderControlOption[];
+    currentValue?: string | number | boolean;
+    error?: string;
+}
+export interface ControlSetResult {
+    ok: boolean;
+    currentValue?: string | number | boolean;
+    effects?: ProviderEffect[];
+    error?: string;
+}
+export interface ControlInvokeResult {
+    ok: boolean;
+    currentValue?: string | number | boolean;
+    effects?: ProviderEffect[];
+    error?: string;
+}
 /**
  * ProviderControlDef — A single interactive control declared by a provider.
  *

package/dist/providers/control-effects.d.ts

@@ -1,4 +1,7 @@
-import type { ProviderControlDef, ProviderEffect } from './contracts.js';
+import type { ControlInvokeResult, ControlListResult, ControlSetResult, ProviderControlDef, ProviderEffect } from './contracts.js';
 export type ProviderControlValue = string | number | boolean;
 export declare function extractProviderControlValues(controls: ProviderControlDef[] | undefined, data: any): Record<string, ProviderControlValue> | undefined;
 export declare function normalizeProviderEffects(data: any): ProviderEffect[];
+export declare function normalizeControlListResult(data: any): ControlListResult;
+export declare function normalizeControlSetResult(data: any): ControlSetResult;
+export declare function normalizeControlInvokeResult(data: any): ControlInvokeResult;

package/dist/providers/io-contracts.d.ts

@@ -0,0 +1,91 @@
+import type { ContentAnnotations } from './contracts.js';
+export type InputPart = TextInputPart | ImageInputPart | AudioInputPart | VideoInputPart | ResourceInputPart;
+export interface TextInputPart {
+    type: 'text';
+    text: string;
+}
+export interface ImageInputPart {
+    type: 'image';
+    mimeType: string;
+    uri?: string;
+    data?: string;
+    alt?: string;
+}
+export interface AudioInputPart {
+    type: 'audio';
+    mimeType: string;
+    uri?: string;
+    data?: string;
+    transcript?: string;
+}
+export interface VideoInputPart {
+    type: 'video';
+    mimeType: string;
+    uri?: string;
+    data?: string;
+    posterUri?: string;
+}
+export interface ResourceInputPart {
+    type: 'resource';
+    uri: string;
+    mimeType?: string;
+    name?: string;
+    text?: string;
+    data?: string;
+}
+export interface InputEnvelope {
+    parts: InputPart[];
+    textFallback: string;
+    metadata?: {
+        source?: 'dashboard' | 'shortcut_api' | 'provider_script' | 'session_replay';
+        clientTimestamp?: number;
+    };
+}
+export type MessagePart = TextMessagePart | ImageMessagePart | AudioMessagePart | VideoMessagePart | ResourceLinkMessagePart | ResourceMessagePart;
+export interface TextMessagePart {
+    type: 'text';
+    text: string;
+    annotations?: ContentAnnotations;
+}
+export interface ImageMessagePart {
+    type: 'image';
+    mimeType: string;
+    uri?: string;
+    data?: string;
+    annotations?: ContentAnnotations;
+}
+export interface AudioMessagePart {
+    type: 'audio';
+    mimeType: string;
+    uri?: string;
+    data?: string;
+    transcript?: string;
+    annotations?: ContentAnnotations;
+}
+export interface VideoMessagePart {
+    type: 'video';
+    mimeType: string;
+    uri?: string;
+    data?: string;
+    posterUri?: string;
+    annotations?: ContentAnnotations;
+}
+export interface ResourceLinkMessagePart {
+    type: 'resource_link';
+    uri: string;
+    name: string;
+    mimeType?: string;
+    size?: number;
+}
+export interface ResourceMessagePart {
+    type: 'resource';
+    resource: {
+        uri: string;
+        mimeType?: string | null;
+        text?: string;
+        blob?: string;
+    };
+}
+export declare function normalizeInputEnvelope(input: unknown): InputEnvelope;
+export declare function normalizeMessageParts(content: unknown): MessagePart[];
+export declare function flattenMessageParts(parts: MessagePart[]): string;

package/dist/providers/provider-schema.d.ts

@@ -0,0 +1,5 @@
+export interface ProviderValidationResult {
+    errors: string[];
+    warnings: string[];
+}
+export declare function validateProviderDefinition(raw: unknown): ProviderValidationResult;

package/dist/session-host/runtime-surface.d.ts

@@ -0,0 +1,16 @@
+import type { SessionHostRecord } from '../shared-types.js';
+export type SessionHostSurfaceKind = 'live_runtime' | 'recovery_snapshot' | 'inactive_record';
+export interface SessionHostSurfaceRecordLike {
+    lifecycle?: string | null;
+    meta?: Record<string, unknown> | null;
+}
+export declare function isSessionHostLiveRuntime(record: SessionHostSurfaceRecordLike | null | undefined): boolean;
+export declare function getSessionHostRecoveryLabel(meta: Record<string, unknown> | null | undefined): string | null;
+export declare function isSessionHostRecoverySnapshot(record: SessionHostSurfaceRecordLike | null | undefined): boolean;
+export declare function getSessionHostSurfaceKind(record: SessionHostSurfaceRecordLike | null | undefined): SessionHostSurfaceKind;
+export declare function partitionSessionHostRecords<T extends SessionHostSurfaceRecordLike>(records: T[]): {
+    liveRuntimes: T[];
+    recoverySnapshots: T[];
+    inactiveRecords: T[];
+};
+export declare function partitionSessionHostDiagnosticsSessions(records: SessionHostRecord[] | null | undefined): ReturnType<typeof partitionSessionHostRecords<SessionHostRecord>>;

package/dist/session-host/startup-restore-policy.d.ts

@@ -0,0 +1 @@
+export declare function shouldAutoRestoreHostedSessionsOnStartup(env?: NodeJS.ProcessEnv): boolean;

package/dist/shared-types.d.ts

@@ -72,6 +72,7 @@ export interface SessionHostRecord {
     providerType: string;
     workspace: string;
     lifecycle: 'starting' | 'running' | 'stopping' | 'stopped' | 'failed' | 'interrupted';
+    surfaceKind?: 'live_runtime' | 'recovery_snapshot' | 'inactive_record';
     writeOwner: SessionHostWriteOwner | null;
     attachedClients: SessionHostAttachedClient[];
     osPid?: number;
@@ -110,6 +111,9 @@ export interface SessionHostDiagnosticsSnapshot {
     endpoint: string;
     runtimeCount: number;
     sessions?: SessionHostRecord[];
+    liveRuntimes?: SessionHostRecord[];
+    recoverySnapshots?: SessionHostRecord[];
+    inactiveRecords?: SessionHostRecord[];
     recentLogs: SessionHostLogEntry[];
     recentRequests: SessionHostRequestTrace[];
     recentTransitions: SessionHostRuntimeTransition[];
@@ -344,6 +348,8 @@ export interface ProviderControlSchema {
     step?: number;
     /** Sort order */
     order?: number;
+    /** Hide this control even if it would otherwise render */
+    hidden?: boolean;
 }
 /** Machine hardware/OS info (reported by daemon, displayed by web) */
 export interface MachineInfo {

package/dist/types.d.ts

@@ -21,8 +21,8 @@ export interface StatusResponse extends StatusReportPayload {
 }
 export interface ChatMessage {
     role: string;
-    /** Plain text (legacy) or rich content blocks (ACP standard) */
-    content: string | ContentBlock[];
+    /** Plain text (legacy) or canonical message parts */
+    content: string | MessagePart[];
     kind?: string;
     id?: string;
     index?: number;
@@ -41,7 +41,7 @@ export interface ChatMessage {
     /** Sender name for shared sessions */
     senderName?: string;
 }
-import type { ContentBlock, ToolCallInfo } from './providers/contracts.js';
+import type { MessagePart, ToolCallInfo } from './providers/contracts.js';
 export interface ExtensionInfo {
     id: string;
     type: string;

package/node_modules/@adhdev/session-host-core/dist/index.d.mts

@@ -33,6 +33,7 @@ interface SessionBufferState {
     scrollbackBytes: number;
     snapshotSeq: number;
 }
+type SessionHostSurfaceKind = 'live_runtime' | 'recovery_snapshot' | 'inactive_record';
 interface SessionHostRecord {
     sessionId: string;
     runtimeKey: string;
@@ -48,6 +49,7 @@ interface SessionHostRecord {
     startedAt?: number;
     lastActivityAt: number;
     lifecycle: SessionLifecycle;
+    surfaceKind?: SessionHostSurfaceKind;
     writeOwner: SessionWriteOwner | null;
     attachedClients: SessionAttachedClient[];
     buffer: SessionBufferState;
@@ -180,6 +182,9 @@ interface SessionHostDiagnostics {
     endpoint: string;
     runtimeCount: number;
     sessions?: SessionHostRecord[];
+    liveRuntimes?: SessionHostRecord[];
+    recoverySnapshots?: SessionHostRecord[];
+    inactiveRecords?: SessionHostRecord[];
     recentLogs: SessionHostLogEntry[];
     recentRequests: SessionHostRequestTrace[];
     recentTransitions: SessionHostRuntimeTransition[];
@@ -368,6 +373,16 @@ declare class SessionHostRegistry {
 declare function getWorkspaceLabel(workspace: string): string;
 declare function buildRuntimeDisplayName(payload: Pick<CreateSessionPayload, 'displayName' | 'providerType' | 'workspace'>): string;
 declare function buildRuntimeKey(payload: Pick<CreateSessionPayload, 'runtimeKey' | 'displayName' | 'providerType' | 'workspace'>, existingKeys: Iterable<string>): string;
+interface SessionHostSurfaceRecordLike {
+    lifecycle?: string | null;
+    surfaceKind?: SessionHostSurfaceKind | null;
+    meta?: Record<string, unknown> | null;
+}
+declare function isSessionHostLiveRuntime(record: SessionHostSurfaceRecordLike | null | undefined): boolean;
+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 resolveAttachableRuntimeRecord(records: SessionHostRecord[], identifier: string): SessionHostRecord;
 declare function resolveRuntimeRecord(records: SessionHostRecord[], identifier: string): SessionHostRecord;
 declare function formatRuntimeOwner(record: Pick<SessionHostRecord, 'writeOwner'>): string;
 
@@ -424,4 +439,4 @@ 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, type DetachSessionPayload, type ForceDetachClientPayload, type GetHostDiagnosticsPayload, type GetSnapshotPayload, type PruneDuplicateSessionsPayload, type ReleaseWritePayload, type ResizeSessionPayload, type RestartSessionPayload, type ResumeSessionPayload, 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 SessionHostResponse, type SessionHostResponseEnvelope, type SessionHostRuntimeTransition, 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, getWorkspaceLabel, resolveRuntimeRecord, sanitizeSpawnEnv, writeEnvelope };
+export { type AcquireWritePayload, type AttachSessionPayload, type ClearSessionBufferPayload, type CreateSessionPayload, type DetachSessionPayload, type ForceDetachClientPayload, type GetHostDiagnosticsPayload, type GetSnapshotPayload, type PruneDuplicateSessionsPayload, type ReleaseWritePayload, type ResizeSessionPayload, type RestartSessionPayload, type ResumeSessionPayload, 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 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 };

package/node_modules/@adhdev/session-host-core/dist/index.d.ts

@@ -33,6 +33,7 @@ interface SessionBufferState {
     scrollbackBytes: number;
     snapshotSeq: number;
 }
+type SessionHostSurfaceKind = 'live_runtime' | 'recovery_snapshot' | 'inactive_record';
 interface SessionHostRecord {
     sessionId: string;
     runtimeKey: string;
@@ -48,6 +49,7 @@ interface SessionHostRecord {
     startedAt?: number;
     lastActivityAt: number;
     lifecycle: SessionLifecycle;
+    surfaceKind?: SessionHostSurfaceKind;
     writeOwner: SessionWriteOwner | null;
     attachedClients: SessionAttachedClient[];
     buffer: SessionBufferState;
@@ -180,6 +182,9 @@ interface SessionHostDiagnostics {
     endpoint: string;
     runtimeCount: number;
     sessions?: SessionHostRecord[];
+    liveRuntimes?: SessionHostRecord[];
+    recoverySnapshots?: SessionHostRecord[];
+    inactiveRecords?: SessionHostRecord[];
     recentLogs: SessionHostLogEntry[];
     recentRequests: SessionHostRequestTrace[];
     recentTransitions: SessionHostRuntimeTransition[];
@@ -368,6 +373,16 @@ declare class SessionHostRegistry {
 declare function getWorkspaceLabel(workspace: string): string;
 declare function buildRuntimeDisplayName(payload: Pick<CreateSessionPayload, 'displayName' | 'providerType' | 'workspace'>): string;
 declare function buildRuntimeKey(payload: Pick<CreateSessionPayload, 'runtimeKey' | 'displayName' | 'providerType' | 'workspace'>, existingKeys: Iterable<string>): string;
+interface SessionHostSurfaceRecordLike {
+    lifecycle?: string | null;
+    surfaceKind?: SessionHostSurfaceKind | null;
+    meta?: Record<string, unknown> | null;
+}
+declare function isSessionHostLiveRuntime(record: SessionHostSurfaceRecordLike | null | undefined): boolean;
+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 resolveAttachableRuntimeRecord(records: SessionHostRecord[], identifier: string): SessionHostRecord;
 declare function resolveRuntimeRecord(records: SessionHostRecord[], identifier: string): SessionHostRecord;
 declare function formatRuntimeOwner(record: Pick<SessionHostRecord, 'writeOwner'>): string;
 
@@ -424,4 +439,4 @@ 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, type DetachSessionPayload, type ForceDetachClientPayload, type GetHostDiagnosticsPayload, type GetSnapshotPayload, type PruneDuplicateSessionsPayload, type ReleaseWritePayload, type ResizeSessionPayload, type RestartSessionPayload, type ResumeSessionPayload, 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 SessionHostResponse, type SessionHostResponseEnvelope, type SessionHostRuntimeTransition, 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, getWorkspaceLabel, resolveRuntimeRecord, sanitizeSpawnEnv, writeEnvelope };
+export { type AcquireWritePayload, type AttachSessionPayload, type ClearSessionBufferPayload, type CreateSessionPayload, type DetachSessionPayload, type ForceDetachClientPayload, type GetHostDiagnosticsPayload, type GetSnapshotPayload, type PruneDuplicateSessionsPayload, type ReleaseWritePayload, type ResizeSessionPayload, type RestartSessionPayload, type ResumeSessionPayload, 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 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 };

package/node_modules/@adhdev/session-host-core/dist/index.js

@@ -41,7 +41,12 @@ __export(index_exports, {
   ensureNodePtySpawnHelperPermissions: () => ensureNodePtySpawnHelperPermissions,
   formatRuntimeOwner: () => formatRuntimeOwner,
   getDefaultSessionHostEndpoint: () => getDefaultSessionHostEndpoint,
+  getSessionHostRecoveryLabel: () => getSessionHostRecoveryLabel,
+  getSessionHostSurfaceKind: () => getSessionHostSurfaceKind,
   getWorkspaceLabel: () => getWorkspaceLabel,
+  isSessionHostLiveRuntime: () => isSessionHostLiveRuntime,
+  isSessionHostRecoverySnapshot: () => isSessionHostRecoverySnapshot,
+  resolveAttachableRuntimeRecord: () => resolveAttachableRuntimeRecord,
   resolveRuntimeRecord: () => resolveRuntimeRecord,
   sanitizeSpawnEnv: () => sanitizeSpawnEnv,
   writeEnvelope: () => writeEnvelope
@@ -149,6 +154,55 @@ function buildRuntimeKey(payload, existingKeys) {
   }
   return candidate;
 }
+var LIVE_LIFECYCLES = /* @__PURE__ */ new Set(["starting", "running", "stopping", "interrupted"]);
+function isSessionHostLiveRuntime(record) {
+  if (!record) return false;
+  if (record.surfaceKind === "live_runtime") return true;
+  if (record.surfaceKind === "recovery_snapshot" || record.surfaceKind === "inactive_record") return false;
+  const lifecycle = String(record.lifecycle || "").trim();
+  return LIVE_LIFECYCLES.has(lifecycle);
+}
+function getSessionHostRecoveryLabel(meta) {
+  const recoveryState = typeof meta?.runtimeRecoveryState === "string" ? String(meta.runtimeRecoveryState).trim() : "";
+  if (!recoveryState) return null;
+  if (recoveryState === "auto_resumed") return "restored after restart";
+  if (recoveryState === "resume_failed") return "restore failed";
+  if (recoveryState === "host_restart_interrupted") return "host restart interrupted";
+  if (recoveryState === "orphan_snapshot") return "snapshot recovered";
+  return recoveryState.replace(/_/g, " ");
+}
+function isSessionHostRecoverySnapshot(record) {
+  if (!record) return false;
+  if (record.surfaceKind === "recovery_snapshot") return true;
+  if (record.surfaceKind === "live_runtime" || record.surfaceKind === "inactive_record") return false;
+  if (isSessionHostLiveRuntime(record)) return false;
+  const lifecycle = String(record.lifecycle || "").trim();
+  if (lifecycle && lifecycle !== "stopped" && lifecycle !== "failed") {
+    return false;
+  }
+  const meta = record.meta || void 0;
+  if (meta?.restoredFromStorage === true) return true;
+  return getSessionHostRecoveryLabel(meta) !== null;
+}
+function getSessionHostSurfaceKind(record) {
+  if (record?.surfaceKind === "live_runtime" || record?.surfaceKind === "recovery_snapshot" || record?.surfaceKind === "inactive_record") {
+    return record.surfaceKind;
+  }
+  if (isSessionHostLiveRuntime(record)) return "live_runtime";
+  if (isSessionHostRecoverySnapshot(record)) return "recovery_snapshot";
+  return "inactive_record";
+}
+function resolveAttachableRuntimeRecord(records, identifier) {
+  const record = resolveRuntimeRecord(records, identifier);
+  const surfaceKind = getSessionHostSurfaceKind(record);
+  if (surfaceKind === "live_runtime") {
+    return record;
+  }
+  if (surfaceKind === "recovery_snapshot") {
+    throw new Error(`Runtime ${record.runtimeKey} is a recovery snapshot, not a live attach target. Resume or recover it first.`);
+  }
+  throw new Error(`Runtime ${record.runtimeKey} is ${record.lifecycle}, not a live attach target.`);
+}
 function uniqueMatch(records, predicate) {
   const matches = records.filter(predicate);
   if (matches.length === 1) return matches[0] || null;
@@ -609,7 +663,12 @@ function ensureNodePtySpawnHelperPermissions(logFn) {
   ensureNodePtySpawnHelperPermissions,
   formatRuntimeOwner,
   getDefaultSessionHostEndpoint,
+  getSessionHostRecoveryLabel,
+  getSessionHostSurfaceKind,
   getWorkspaceLabel,
+  isSessionHostLiveRuntime,
+  isSessionHostRecoverySnapshot,
+  resolveAttachableRuntimeRecord,
   resolveRuntimeRecord,
   sanitizeSpawnEnv,
   writeEnvelope