@adhdev/daemon-core 0.9.75 → 0.9.76-rc.2

package/dist/repo-mesh-types.d.ts

@@ -144,6 +144,7 @@ export interface LocalMeshNodeEntry {
     id: string;
     workspace: string;
     repoRoot?: string;
+    daemonId?: string;
     userOverrides: Partial<RepoMeshNodeCapabilities>;
     policy: RepoMeshNodePolicy;
     /** For single-machine mesh: same daemon, different worktree */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@adhdev/daemon-core",
-  "version": "0.9.75",
-  "description": "ADHDev daemon core \u2014 CDP, IDE detection, providers, command execution",
+  "version": "0.9.76-rc.2",
+  "description": "ADHDev daemon core — CDP, IDE detection, providers, command execution",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {

package/src/cli-adapters/provider-cli-adapter.ts

@@ -266,10 +266,16 @@ export class ProviderCliAdapter implements CliAdapter {
         const currentSnapshot = normalizeScreenSnapshot(screenText);
         const lastSnapshot = this.lastScreenSnapshot;
         if (!lastSnapshot || lastSnapshot === currentSnapshot) return screenText;
+        const staleSnapshotLooksActive = /\besc to (?:interrupt|stop)\b|Enter to interrupt, Ctrl\+C to cancel/i.test(lastSnapshot);
+        const currentScreenLooksIdle = /(?:^|\n|\r)\s*[❯›>]\s*(?:\n|\r|$)/.test(screenText)
+            && !/\besc to (?:interrupt|stop)\b|Enter to interrupt, Ctrl\+C to cancel/i.test(screenText);
+        if (staleSnapshotLooksActive && currentScreenLooksIdle) return screenText;
+        if (currentSnapshot.length >= lastSnapshot.length) return screenText;
         // Terminal screen reads can miss a just-rendered completed Hermes box while
         // the normalized snapshot captured during output still has it. Feed both
         // views to provider parsers so flattened snapshot-only final bubbles do
-        // not disappear from read_chat/chat_tail.
+        // not disappear from read_chat/chat_tail, but only when the older snapshot
+        // carries extra content instead of stale status chrome.
         return `${screenText}\n${lastSnapshot}`;
     }
 

package/src/mesh/coordinator-prompt.ts

@@ -92,7 +92,7 @@ function buildNodeConfigSection(mesh: LocalMeshEntry): string {
     for (const n of mesh.nodes) {
         const labels: string[] = [];
         if (n.isLocalWorktree) labels.push('worktree');
-        if (n.policy.readOnly) labels.push('read-only');
+        if (n.policy?.readOnly) labels.push('read-only');
         const suffix = labels.length ? ` [${labels.join(', ')}]` : '';
         lines.push(`- **${n.workspace}** (${n.id})${suffix}`);
     }
@@ -139,7 +139,7 @@ const WORKFLOW_SECTION = `## Orchestration Workflow
 3. **Delegate** — For each task:
    a. Pick the best node (consider: health, dirty state, current workload).
    b. If no session exists, call \`mesh_launch_session\` to start one.
-   c. Call \`mesh_send_task\` with a clear, self-contained natural-language instruction.
+   c. Call \`mesh_send_task\` with a **complete, self-contained** instruction that includes all context the agent needs (file paths, line numbers, what to change, why). Do not send partial instructions expecting future follow-up.
 4. **Monitor** — Periodically call \`mesh_read_chat\` to check progress. Handle approvals via \`mesh_approve\`.
 5. **Verify** — When a task reports completion, call \`mesh_git_status\` to verify changes were made.
 6. **Checkpoint** — Call \`mesh_checkpoint\` to save the work.
@@ -147,10 +147,12 @@ const WORKFLOW_SECTION = `## Orchestration Workflow
 
 const RULES_SECTION = `## Rules
 
-- **Be conversational.** Delegate work the way a tech lead would — clear, specific instructions in natural language.
-- **Don't inspect code.** Trust the agent's output. Verify via git diff/status, not by reading source files.
+- **Minimize coordinator context.** The coordinator's job is routing, not implementing. Do not read source files, run commands, or analyze code directly — delegate all of that to node agents. Your context should stay lean.
+- **Delegate analysis too.** If you need to understand a bug or explore the codebase, send that investigation as a task to a node. Do not do it yourself.
+- **Front-load the task message.** When calling \`mesh_send_task\`, include everything the agent needs: what files to touch, what the problem is, what the fix should look like. The agent won't ask follow-up questions.
+- **Don't inspect code.** Trust the agent's output. Verify via \`mesh_git_status\`, not by reading source files.
 - **Don't over-parallelize.** Start with 1-2 concurrent tasks. Scale up if they succeed.
 - **Handle failures gracefully.** If a task fails, read the chat to understand why, then retry or reassign.
-- **Keep the user informed.** Report progress after each delegation round.
+- **Keep the user informed.** Report progress after each delegation round — one or two sentences, not a narration.
 - **Respect node capabilities.** Don't send build tasks to read-only nodes. Don't push from nodes that aren't allowed to.
 - **Never fabricate tool results.** Always call the actual tool; never pretend you did.`;

package/src/repo-mesh-types.ts

@@ -184,6 +184,7 @@ export interface LocalMeshNodeEntry {
     id: string;
     workspace: string;
     repoRoot?: string;
+    daemonId?: string;
     userOverrides: Partial<RepoMeshNodeCapabilities>;
     policy: RepoMeshNodePolicy;
     /** For single-machine mesh: same daemon, different worktree */

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

@@ -1,6 +0,0 @@
-declare const DEFAULT_SESSION_HOST_COLS = 80;
-declare const DEFAULT_SESSION_HOST_ROWS = 32;
-declare function resolveSessionHostCols(value: number | undefined): number;
-declare function resolveSessionHostRows(value: number | undefined): number;
-
-export { DEFAULT_SESSION_HOST_COLS, DEFAULT_SESSION_HOST_ROWS, resolveSessionHostCols, resolveSessionHostRows };

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

@@ -1,6 +0,0 @@
-declare const DEFAULT_SESSION_HOST_COLS = 80;
-declare const DEFAULT_SESSION_HOST_ROWS = 32;
-declare function resolveSessionHostCols(value: number | undefined): number;
-declare function resolveSessionHostRows(value: number | undefined): number;
-
-export { DEFAULT_SESSION_HOST_COLS, DEFAULT_SESSION_HOST_ROWS, resolveSessionHostCols, resolveSessionHostRows };

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

@@ -1,49 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/defaults.ts
-var defaults_exports = {};
-__export(defaults_exports, {
-  DEFAULT_SESSION_HOST_COLS: () => DEFAULT_SESSION_HOST_COLS,
-  DEFAULT_SESSION_HOST_ROWS: () => DEFAULT_SESSION_HOST_ROWS,
-  resolveSessionHostCols: () => resolveSessionHostCols,
-  resolveSessionHostRows: () => resolveSessionHostRows
-});
-module.exports = __toCommonJS(defaults_exports);
-var DEFAULT_SESSION_HOST_COLS = 80;
-var DEFAULT_SESSION_HOST_ROWS = 32;
-function normalizeSessionHostDimension(value, fallback) {
-  if (typeof value !== "number" || !Number.isFinite(value)) return fallback;
-  const rounded = Math.floor(value);
-  return rounded > 0 ? rounded : fallback;
-}
-function resolveSessionHostCols(value) {
-  return normalizeSessionHostDimension(value, DEFAULT_SESSION_HOST_COLS);
-}
-function resolveSessionHostRows(value) {
-  return normalizeSessionHostDimension(value, DEFAULT_SESSION_HOST_ROWS);
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  DEFAULT_SESSION_HOST_COLS,
-  DEFAULT_SESSION_HOST_ROWS,
-  resolveSessionHostCols,
-  resolveSessionHostRows
-});
-//# sourceMappingURL=defaults.js.map

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

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/defaults.ts"],"sourcesContent":["export const DEFAULT_SESSION_HOST_COLS = 80;\nexport const DEFAULT_SESSION_HOST_ROWS = 32;\n\nfunction normalizeSessionHostDimension(value: number | undefined, fallback: number): number {\n  if (typeof value !== 'number' || !Number.isFinite(value)) return fallback;\n  const rounded = Math.floor(value);\n  return rounded > 0 ? rounded : fallback;\n}\n\nexport function resolveSessionHostCols(value: number | undefined): number {\n  return normalizeSessionHostDimension(value, DEFAULT_SESSION_HOST_COLS);\n}\n\nexport function resolveSessionHostRows(value: number | undefined): number {\n  return normalizeSessionHostDimension(value, DEFAULT_SESSION_HOST_ROWS);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAO,IAAM,4BAA4B;AAClC,IAAM,4BAA4B;AAEzC,SAAS,8BAA8B,OAA2B,UAA0B;AAC1F,MAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,KAAK,EAAG,QAAO;AACjE,QAAM,UAAU,KAAK,MAAM,KAAK;AAChC,SAAO,UAAU,IAAI,UAAU;AACjC;AAEO,SAAS,uBAAuB,OAAmC;AACxE,SAAO,8BAA8B,OAAO,yBAAyB;AACvE;AAEO,SAAS,uBAAuB,OAAmC;AACxE,SAAO,8BAA8B,OAAO,yBAAyB;AACvE;","names":[]}

package/node_modules/@adhdev/session-host-core/dist/defaults.mjs

@@ -1,21 +0,0 @@
-// src/defaults.ts
-var DEFAULT_SESSION_HOST_COLS = 80;
-var DEFAULT_SESSION_HOST_ROWS = 32;
-function normalizeSessionHostDimension(value, fallback) {
-  if (typeof value !== "number" || !Number.isFinite(value)) return fallback;
-  const rounded = Math.floor(value);
-  return rounded > 0 ? rounded : fallback;
-}
-function resolveSessionHostCols(value) {
-  return normalizeSessionHostDimension(value, DEFAULT_SESSION_HOST_COLS);
-}
-function resolveSessionHostRows(value) {
-  return normalizeSessionHostDimension(value, DEFAULT_SESSION_HOST_ROWS);
-}
-export {
-  DEFAULT_SESSION_HOST_COLS,
-  DEFAULT_SESSION_HOST_ROWS,
-  resolveSessionHostCols,
-  resolveSessionHostRows
-};
-//# sourceMappingURL=defaults.mjs.map

package/node_modules/@adhdev/session-host-core/dist/defaults.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/defaults.ts"],"sourcesContent":["export const DEFAULT_SESSION_HOST_COLS = 80;\nexport const DEFAULT_SESSION_HOST_ROWS = 32;\n\nfunction normalizeSessionHostDimension(value: number | undefined, fallback: number): number {\n  if (typeof value !== 'number' || !Number.isFinite(value)) return fallback;\n  const rounded = Math.floor(value);\n  return rounded > 0 ? rounded : fallback;\n}\n\nexport function resolveSessionHostCols(value: number | undefined): number {\n  return normalizeSessionHostDimension(value, DEFAULT_SESSION_HOST_COLS);\n}\n\nexport function resolveSessionHostRows(value: number | undefined): number {\n  return normalizeSessionHostDimension(value, DEFAULT_SESSION_HOST_ROWS);\n}\n"],"mappings":";AAAO,IAAM,4BAA4B;AAClC,IAAM,4BAA4B;AAEzC,SAAS,8BAA8B,OAA2B,UAA0B;AAC1F,MAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,KAAK,EAAG,QAAO;AACjE,QAAM,UAAU,KAAK,MAAM,KAAK;AAChC,SAAO,UAAU,IAAI,UAAU;AACjC;AAEO,SAAS,uBAAuB,OAAmC;AACxE,SAAO,8BAA8B,OAAO,yBAAyB;AACvE;AAEO,SAAS,uBAAuB,OAAmC;AACxE,SAAO,8BAA8B,OAAO,yBAAyB;AACvE;","names":[]}

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

@@ -1,444 +0,0 @@
-import * as net from 'net';
-export { DEFAULT_SESSION_HOST_COLS, DEFAULT_SESSION_HOST_ROWS, resolveSessionHostCols, resolveSessionHostRows } from './defaults.mjs';
-
-type SessionTransport = 'pty';
-type SessionHostCategory = 'cli' | 'acp' | 'shell';
-type SessionLifecycle = 'starting' | 'running' | 'stopping' | 'stopped' | 'failed' | 'interrupted';
-type SessionClientType = 'daemon' | 'web' | 'local-terminal';
-type SessionOwnerType = 'agent' | 'user';
-interface SessionLaunchCommand {
-    command: string;
-    args: string[];
-    env?: Record<string, string>;
-}
-interface SessionWriteOwner {
-    clientId: string;
-    ownerType: SessionOwnerType;
-    acquiredAt: number;
-}
-interface SessionAttachedClient {
-    clientId: string;
-    type: SessionClientType;
-    readOnly: boolean;
-    attachedAt: number;
-    lastSeenAt: number;
-}
-interface SessionBufferSnapshot {
-    seq: number;
-    text: string;
-    truncated: boolean;
-    cols?: number;
-    rows?: number;
-}
-interface SessionBufferState {
-    scrollbackBytes: number;
-    snapshotSeq: number;
-}
-type SessionHostSurfaceKind = 'live_runtime' | 'recovery_snapshot' | 'inactive_record';
-interface SessionHostRecord {
-    sessionId: string;
-    runtimeKey: string;
-    displayName: string;
-    workspaceLabel: string;
-    transport: SessionTransport;
-    providerType: string;
-    category: SessionHostCategory;
-    workspace: string;
-    launchCommand: SessionLaunchCommand;
-    osPid?: number;
-    createdAt: number;
-    startedAt?: number;
-    lastActivityAt: number;
-    lifecycle: SessionLifecycle;
-    surfaceKind?: SessionHostSurfaceKind;
-    writeOwner: SessionWriteOwner | null;
-    attachedClients: SessionAttachedClient[];
-    buffer: SessionBufferState;
-    meta: Record<string, unknown>;
-}
-interface CreateSessionPayload {
-    sessionId?: string;
-    runtimeKey?: string;
-    displayName?: string;
-    providerType: string;
-    category: SessionHostCategory;
-    workspace: string;
-    launchCommand: SessionLaunchCommand;
-    cols?: number;
-    rows?: number;
-    clientId?: string;
-    clientType?: SessionClientType;
-    meta?: Record<string, unknown>;
-}
-interface AttachSessionPayload {
-    sessionId: string;
-    clientId: string;
-    clientType: SessionClientType;
-    readOnly?: boolean;
-}
-interface DetachSessionPayload {
-    sessionId: string;
-    clientId: string;
-}
-interface SendInputPayload {
-    sessionId: string;
-    clientId: string;
-    data: string;
-}
-interface ResizeSessionPayload {
-    sessionId: string;
-    cols: number;
-    rows: number;
-}
-interface StopSessionPayload {
-    sessionId: string;
-}
-interface ResumeSessionPayload {
-    sessionId: string;
-}
-interface AcquireWritePayload {
-    sessionId: string;
-    clientId: string;
-    ownerType: SessionOwnerType;
-    force?: boolean;
-}
-interface ReleaseWritePayload {
-    sessionId: string;
-    clientId: string;
-}
-interface GetSnapshotPayload {
-    sessionId: string;
-    sinceSeq?: number;
-}
-interface ClearSessionBufferPayload {
-    sessionId: string;
-}
-interface UpdateSessionMetaPayload {
-    sessionId: string;
-    meta: Record<string, unknown>;
-    replace?: boolean;
-}
-interface GetHostDiagnosticsPayload {
-    includeSessions?: boolean;
-    limit?: number;
-}
-interface ForceDetachClientPayload {
-    sessionId: string;
-    clientId: string;
-}
-interface SendSignalPayload {
-    sessionId: string;
-    signal: string;
-}
-interface RestartSessionPayload {
-    sessionId: string;
-}
-interface PruneDuplicateSessionsPayload {
-    providerType?: string;
-    workspace?: string;
-    dryRun?: boolean;
-}
-interface SessionHostDuplicateSessionGroup {
-    bindingKey: string;
-    providerType: string;
-    workspace: string;
-    providerSessionId: string;
-    keptSessionId: string;
-    prunedSessionIds: string[];
-}
-interface SessionHostPruneDuplicatesResult {
-    duplicateGroupCount: number;
-    keptSessionIds: string[];
-    prunedSessionIds: string[];
-    groups: SessionHostDuplicateSessionGroup[];
-}
-interface SessionHostLogEntry {
-    timestamp: number;
-    level: 'debug' | 'info' | 'warn' | 'error';
-    message: string;
-    sessionId?: string;
-    data?: Record<string, unknown>;
-}
-interface SessionHostRequestTrace {
-    timestamp: number;
-    requestId: string;
-    type: SessionHostRequest['type'];
-    sessionId?: string;
-    clientId?: string;
-    success: boolean;
-    durationMs: number;
-    error?: string;
-}
-interface SessionHostRuntimeTransition {
-    timestamp: number;
-    sessionId: string;
-    action: string;
-    lifecycle?: SessionLifecycle;
-    detail?: string;
-    success?: boolean;
-    error?: string;
-}
-interface SessionHostDiagnostics {
-    hostStartedAt: number;
-    endpoint: string;
-    runtimeCount: number;
-    sessions?: SessionHostRecord[];
-    liveRuntimes?: SessionHostRecord[];
-    recoverySnapshots?: SessionHostRecord[];
-    inactiveRecords?: SessionHostRecord[];
-    recentLogs: SessionHostLogEntry[];
-    recentRequests: SessionHostRequestTrace[];
-    recentTransitions: SessionHostRuntimeTransition[];
-}
-type SessionHostRequest = {
-    type: 'create_session';
-    payload: CreateSessionPayload;
-} | {
-    type: 'attach_session';
-    payload: AttachSessionPayload;
-} | {
-    type: 'detach_session';
-    payload: DetachSessionPayload;
-} | {
-    type: 'send_input';
-    payload: SendInputPayload;
-} | {
-    type: 'resize_session';
-    payload: ResizeSessionPayload;
-} | {
-    type: 'stop_session';
-    payload: StopSessionPayload;
-} | {
-    type: 'resume_session';
-    payload: ResumeSessionPayload;
-} | {
-    type: 'acquire_write';
-    payload: AcquireWritePayload;
-} | {
-    type: 'release_write';
-    payload: ReleaseWritePayload;
-} | {
-    type: 'get_snapshot';
-    payload: GetSnapshotPayload;
-} | {
-    type: 'clear_session_buffer';
-    payload: ClearSessionBufferPayload;
-} | {
-    type: 'update_session_meta';
-    payload: UpdateSessionMetaPayload;
-} | {
-    type: 'get_host_diagnostics';
-    payload?: GetHostDiagnosticsPayload;
-} | {
-    type: 'force_detach_client';
-    payload: ForceDetachClientPayload;
-} | {
-    type: 'send_signal';
-    payload: SendSignalPayload;
-} | {
-    type: 'restart_session';
-    payload: RestartSessionPayload;
-} | {
-    type: 'prune_duplicate_sessions';
-    payload?: PruneDuplicateSessionsPayload;
-} | {
-    type: 'list_sessions';
-    payload?: {};
-};
-interface SessionHostResponse<T = unknown> {
-    success: boolean;
-    result?: T;
-    error?: string;
-}
-type SessionHostEvent = {
-    type: 'session_created';
-    sessionId: string;
-    record: SessionHostRecord;
-} | {
-    type: 'session_started';
-    sessionId: string;
-    pid?: number;
-} | {
-    type: 'session_resumed';
-    sessionId: string;
-    pid?: number;
-} | {
-    type: 'session_output';
-    sessionId: string;
-    seq: number;
-    data: string;
-} | {
-    type: 'session_cleared';
-    sessionId: string;
-} | {
-    type: 'session_exit';
-    sessionId: string;
-    exitCode: number | null;
-} | {
-    type: 'session_stopped';
-    sessionId: string;
-} | {
-    type: 'session_resized';
-    sessionId: string;
-    cols: number;
-    rows: number;
-} | {
-    type: 'write_owner_changed';
-    sessionId: string;
-    owner: SessionWriteOwner | null;
-} | {
-    type: 'client_attached';
-    sessionId: string;
-    client: SessionAttachedClient;
-} | {
-    type: 'client_detached';
-    sessionId: string;
-    clientId: string;
-} | {
-    type: 'host_log';
-    entry: SessionHostLogEntry;
-} | {
-    type: 'request_trace';
-    trace: SessionHostRequestTrace;
-} | {
-    type: 'runtime_transition';
-    transition: SessionHostRuntimeTransition;
-};
-interface SessionHostRequestEnvelope {
-    kind: 'request';
-    requestId: string;
-    request: SessionHostRequest;
-}
-interface SessionHostResponseEnvelope {
-    kind: 'response';
-    requestId: string;
-    response: SessionHostResponse;
-}
-interface SessionHostEventEnvelope {
-    kind: 'event';
-    event: SessionHostEvent;
-}
-type SessionHostWireEnvelope = SessionHostRequestEnvelope | SessionHostResponseEnvelope | SessionHostEventEnvelope;
-
-interface SessionRingBufferOptions {
-    maxBytes?: number;
-}
-declare const DEFAULT_SESSION_RING_BUFFER_MAX_BYTES: number;
-declare class SessionRingBuffer {
-    private maxBytes;
-    private chunks;
-    private nextSeq;
-    private totalBytes;
-    constructor(options?: SessionRingBufferOptions);
-    append(data: string): number;
-    snapshot(sinceSeq?: number): SessionBufferSnapshot;
-    getState(): {
-        scrollbackBytes: number;
-        snapshotSeq: number;
-    };
-    clear(): void;
-    restore(snapshot: {
-        seq: number;
-        text: string;
-    }): void;
-    private trim;
-}
-
-declare class SessionHostRegistry {
-    private sessions;
-    createSession(payload: CreateSessionPayload): SessionHostRecord;
-    restoreSession(record: SessionHostRecord, snapshot?: {
-        seq: number;
-        text: string;
-    } | null): SessionHostRecord;
-    listSessions(): SessionHostRecord[];
-    getSession(sessionId: string): SessionHostRecord | null;
-    attachClient(payload: AttachSessionPayload): SessionHostRecord;
-    detachClient(payload: DetachSessionPayload): SessionHostRecord;
-    acquireWrite(payload: AcquireWritePayload): SessionHostRecord;
-    releaseWrite(payload: ReleaseWritePayload): SessionHostRecord;
-    appendOutput(sessionId: string, data: string): {
-        record: SessionHostRecord;
-        seq: number;
-    };
-    getSnapshot(sessionId: string, sinceSeq?: number): SessionBufferSnapshot;
-    clearBuffer(sessionId: string): SessionHostRecord;
-    updateSessionMeta(sessionId: string, meta: Record<string, unknown>, replace?: boolean): SessionHostRecord;
-    markStarted(sessionId: string, pid?: number): SessionHostRecord;
-    markStopped(sessionId: string, lifecycle?: 'stopped' | 'failed'): SessionHostRecord;
-    setLifecycle(sessionId: string, lifecycle: 'starting' | 'running' | 'stopping' | 'stopped' | 'failed' | 'interrupted'): SessionHostRecord;
-    deleteSession(sessionId: string): boolean;
-    private requireSession;
-    private cloneRecord;
-}
-
-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;
-
-interface SessionHostEndpoint {
-    kind: 'unix' | 'pipe';
-    path: string;
-}
-declare function getDefaultSessionHostEndpoint(appName?: string): SessionHostEndpoint;
-declare function createLineParser(onEnvelope: (envelope: SessionHostWireEnvelope) => void): (chunk: Buffer | string) => void;
-interface SessionHostClientOptions {
-    endpoint?: SessionHostEndpoint;
-    appName?: string;
-}
-declare class SessionHostClient {
-    readonly endpoint: SessionHostEndpoint;
-    private socket;
-    private requestWaiters;
-    private eventListeners;
-    constructor(options?: SessionHostClientOptions);
-    connect(): Promise<void>;
-    onEvent(listener: (event: SessionHostEvent) => void): () => void;
-    request<T = unknown>(request: SessionHostRequest): Promise<SessionHostResponse<T>>;
-    close(): Promise<void>;
-}
-declare function createResponseEnvelope(requestId: string, response: SessionHostResponse): SessionHostResponseEnvelope;
-declare function writeEnvelope(socket: Pick<net.Socket, 'write'>, envelope: SessionHostWireEnvelope): void;
-
-/**
- * Shared PTY spawn environment utilities.
- *
- * Centralises npm/pnpm/yarn env variable stripping, terminal colour env
- * injection, and node-pty spawn-helper permission fixing.
- *
- * Used by daemon-core (provider-cli-adapter), session-host-daemon (runtime),
- * and daemon-cloud (session-host).
- */
-/**
- * Strip package-manager injected environment variables that can interfere
- * with child CLI processes and apply terminal colour defaults.
- */
-declare function sanitizeSpawnEnv(baseEnv: NodeJS.ProcessEnv, overrides?: Record<string, string>): Record<string, string>;
-/**
- * Apply preferred terminal colour environment variables.
- * Ensures TERM is set to xterm-256color and enables colour on Windows.
- */
-declare function applyTerminalColorEnv(env: Record<string, string>): void;
-/**
- * Ensure node-pty's spawn-helper binary has execute permissions.
- *
- * npm's default umask can strip +x from the prebuilt spawn-helper on macOS/Linux,
- * causing EACCES when node-pty tries to fork. Best-effort fix.
- *
- * @param logFn Optional log callback for reporting the fix.
- */
-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, 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 };