@hydra-acp/cli 0.1.87 → 0.1.89

package/dist/index.d.ts

@@ -141,7 +141,37 @@ declare const HydraConfig: z.ZodObject<{
     defaultModels: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
     synopsisAgent: z.ZodOptional<z.ZodString>;
     synopsisModel: z.ZodOptional<z.ZodString>;
-    synopsisOnClose: z.ZodDefault<z.ZodBoolean>;
+    compaction: z.ZodDefault<z.ZodObject<{
+        agent: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+        tailK: z.ZodDefault<z.ZodNumber>;
+        maxIterations: z.ZodDefault<z.ZodNumber>;
+        contextFraction: z.ZodDefault<z.ZodNumber>;
+        hardCeilingFraction: z.ZodDefault<z.ZodNumber>;
+        absoluteFallback: z.ZodDefault<z.ZodNumber>;
+        idleBeforePromptMs: z.ZodDefault<z.ZodNumber>;
+        modelContextWindows: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        tailK: number;
+        maxIterations: number;
+        contextFraction: number;
+        hardCeilingFraction: number;
+        absoluteFallback: number;
+        idleBeforePromptMs: number;
+        modelContextWindows: Record<string, number>;
+        agent?: string | undefined;
+        model?: string | undefined;
+    }, {
+        agent?: string | undefined;
+        model?: string | undefined;
+        tailK?: number | undefined;
+        maxIterations?: number | undefined;
+        contextFraction?: number | undefined;
+        hardCeilingFraction?: number | undefined;
+        absoluteFallback?: number | undefined;
+        idleBeforePromptMs?: number | undefined;
+        modelContextWindows?: Record<string, number> | undefined;
+    }>>;
     defaultCwd: z.ZodDefault<z.ZodString>;
     compressToolContent: z.ZodDefault<z.ZodBoolean>;
     sessionListColdLimit: z.ZodDefault<z.ZodNumber>;
@@ -191,7 +221,7 @@ declare const HydraConfig: z.ZodObject<{
         progressIndicator: z.ZodDefault<z.ZodBoolean>;
         defaultEnterAction: z.ZodDefault<z.ZodEnum<["enqueue", "amend"]>>;
         showThoughts: z.ZodDefault<z.ZodBoolean>;
-        ambiguousWidth: z.ZodDefault<z.ZodEnum<["narrow", "wide"]>>;
+        ambiguousWidth: z.ZodDefault<z.ZodEnum<["auto", "narrow", "wide"]>>;
         toolContent: z.ZodDefault<z.ZodEnum<["inline", "references"]>>;
         diffContextLines: z.ZodDefault<z.ZodNumber>;
         promptHistoryMaxEntries: z.ZodDefault<z.ZodNumber>;
@@ -209,7 +239,7 @@ declare const HydraConfig: z.ZodObject<{
         progressIndicator: boolean;
         defaultEnterAction: "enqueue" | "amend";
         showThoughts: boolean;
-        ambiguousWidth: "narrow" | "wide";
+        ambiguousWidth: "auto" | "narrow" | "wide";
         toolContent: "inline" | "references";
         diffContextLines: number;
         promptHistoryMaxEntries: number;
@@ -231,7 +261,7 @@ declare const HydraConfig: z.ZodObject<{
         progressIndicator?: boolean | undefined;
         defaultEnterAction?: "enqueue" | "amend" | undefined;
         showThoughts?: boolean | undefined;
-        ambiguousWidth?: "narrow" | "wide" | undefined;
+        ambiguousWidth?: "auto" | "narrow" | "wide" | undefined;
         toolContent?: "inline" | "references" | undefined;
         diffContextLines?: number | undefined;
         promptHistoryMaxEntries?: number | undefined;
@@ -251,7 +281,7 @@ declare const HydraConfig: z.ZodObject<{
         progressIndicator: boolean;
         defaultEnterAction: "enqueue" | "amend";
         showThoughts: boolean;
-        ambiguousWidth: "narrow" | "wide";
+        ambiguousWidth: "auto" | "narrow" | "wide";
         toolContent: "inline" | "references";
         diffContextLines: number;
         promptHistoryMaxEntries: number;
@@ -307,7 +337,17 @@ declare const HydraConfig: z.ZodObject<{
     }>;
     defaultAgent: string;
     defaultModels: Record<string, string>;
-    synopsisOnClose: boolean;
+    compaction: {
+        tailK: number;
+        maxIterations: number;
+        contextFraction: number;
+        hardCeilingFraction: number;
+        absoluteFallback: number;
+        idleBeforePromptMs: number;
+        modelContextWindows: Record<string, number>;
+        agent?: string | undefined;
+        model?: string | undefined;
+    };
     defaultCwd: string;
     compressToolContent: boolean;
     sessionListColdLimit: number;
@@ -328,7 +368,7 @@ declare const HydraConfig: z.ZodObject<{
         progressIndicator?: boolean | undefined;
         defaultEnterAction?: "enqueue" | "amend" | undefined;
         showThoughts?: boolean | undefined;
-        ambiguousWidth?: "narrow" | "wide" | undefined;
+        ambiguousWidth?: "auto" | "narrow" | "wide" | undefined;
         toolContent?: "inline" | "references" | undefined;
         diffContextLines?: number | undefined;
         promptHistoryMaxEntries?: number | undefined;
@@ -384,7 +424,17 @@ declare const HydraConfig: z.ZodObject<{
     defaultModels?: Record<string, string> | undefined;
     synopsisAgent?: string | undefined;
     synopsisModel?: string | undefined;
-    synopsisOnClose?: boolean | undefined;
+    compaction?: {
+        agent?: string | undefined;
+        model?: string | undefined;
+        tailK?: number | undefined;
+        maxIterations?: number | undefined;
+        contextFraction?: number | undefined;
+        hardCeilingFraction?: number | undefined;
+        absoluteFallback?: number | undefined;
+        idleBeforePromptMs?: number | undefined;
+        modelContextWindows?: Record<string, number> | undefined;
+    } | undefined;
     defaultCwd?: string | undefined;
     compressToolContent?: boolean | undefined;
     sessionListColdLimit?: number | undefined;
@@ -789,6 +839,7 @@ declare const RegistryAgent: z.ZodObject<{
         url?: string | undefined;
         description?: string | undefined;
     }>>;
+    requiredEnv: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     id: string;
@@ -860,6 +911,7 @@ declare const RegistryAgent: z.ZodObject<{
         url?: string | undefined;
         description?: string | undefined;
     } | undefined;
+    requiredEnv?: string[] | undefined;
 }, {
     name: string;
     id: string;
@@ -931,6 +983,7 @@ declare const RegistryAgent: z.ZodObject<{
         url?: string | undefined;
         description?: string | undefined;
     } | undefined;
+    requiredEnv?: string[] | undefined;
 }>;
 type RegistryAgent = z.infer<typeof RegistryAgent>;
 declare const RegistryDocument: z.ZodObject<{
@@ -1284,6 +1337,7 @@ declare const RegistryDocument: z.ZodObject<{
             url?: string | undefined;
             description?: string | undefined;
         }>>;
+        requiredEnv: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
         name: string;
         id: string;
@@ -1355,6 +1409,7 @@ declare const RegistryDocument: z.ZodObject<{
             url?: string | undefined;
             description?: string | undefined;
         } | undefined;
+        requiredEnv?: string[] | undefined;
     }, {
         name: string;
         id: string;
@@ -1426,6 +1481,7 @@ declare const RegistryDocument: z.ZodObject<{
             url?: string | undefined;
             description?: string | undefined;
         } | undefined;
+        requiredEnv?: string[] | undefined;
     }>, "many">;
     extensions: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
 }, "strip", z.ZodTypeAny, {
@@ -1501,6 +1557,7 @@ declare const RegistryDocument: z.ZodObject<{
             url?: string | undefined;
             description?: string | undefined;
         } | undefined;
+        requiredEnv?: string[] | undefined;
     }[];
     extensions?: unknown[] | undefined;
 }, {
@@ -1576,6 +1633,7 @@ declare const RegistryDocument: z.ZodObject<{
             url?: string | undefined;
             description?: string | undefined;
         } | undefined;
+        requiredEnv?: string[] | undefined;
     }[];
     extensions?: unknown[] | undefined;
 }>;
@@ -1741,6 +1799,7 @@ declare const SessionListEntry: z.ZodObject<{
     status: z.ZodDefault<z.ZodEnum<["live", "cold"]>>;
     busy: z.ZodDefault<z.ZodBoolean>;
     awaitingInput: z.ZodDefault<z.ZodBoolean>;
+    compactionState: z.ZodOptional<z.ZodAny>;
     _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
     sessionId: string;
@@ -1772,6 +1831,7 @@ declare const SessionListEntry: z.ZodObject<{
     } | undefined;
     interactive?: boolean | undefined;
     priority?: number | undefined;
+    compactionState?: any;
 }, {
     sessionId: string;
     cwd: string;
@@ -1802,6 +1862,7 @@ declare const SessionListEntry: z.ZodObject<{
     priority?: number | undefined;
     busy?: boolean | undefined;
     awaitingInput?: boolean | undefined;
+    compactionState?: any;
 }>;
 type SessionListEntry = z.infer<typeof SessionListEntry>;
 declare const SessionListResult: z.ZodObject<{
@@ -2023,6 +2084,7 @@ declare class AgentInstance {
     readonly connection: JsonRpcConnection;
     authMethods?: AuthMethod[];
     private child;
+    get pid(): number | undefined;
     private exited;
     private killed;
     private stderrTail;
@@ -2285,527 +2347,271 @@ declare class HistoryStore {
     compact(sessionId: string, maxEntries: number): Promise<void>;
     load(sessionId: string, opts?: {
         tools?: "inline" | "references";
+        maxEntries?: number;
     }): Promise<HistoryEntry[]>;
     flushAll(): Promise<void>;
     delete(sessionId: string): Promise<void>;
     private enqueue;
 }
 
-interface PersistedQueueEntry {
-    messageId: string;
-    originator: {
-        clientInfo: {
-            name?: string;
-            version?: string;
-        };
-    };
-    prompt: unknown[];
-    enqueuedAt: number;
-}
+declare const CompactionState: z.ZodObject<{
+    status: z.ZodEnum<["requested", "running", "swap_pending", "swap_deferred", "failed"]>;
+    requestedAt: z.ZodNumber;
+    iter: z.ZodOptional<z.ZodNumber>;
+    attempts: z.ZodOptional<z.ZodNumber>;
+    lastError: z.ZodOptional<z.ZodString>;
+    worker: z.ZodOptional<z.ZodObject<{
+        upstreamSessionId: z.ZodString;
+        pid: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        pid: number;
+        upstreamSessionId: string;
+    }, {
+        pid: number;
+        upstreamSessionId: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    status: "requested" | "running" | "swap_pending" | "swap_deferred" | "failed";
+    requestedAt: number;
+    iter?: number | undefined;
+    attempts?: number | undefined;
+    lastError?: string | undefined;
+    worker?: {
+        pid: number;
+        upstreamSessionId: string;
+    } | undefined;
+}, {
+    status: "requested" | "running" | "swap_pending" | "swap_deferred" | "failed";
+    requestedAt: number;
+    iter?: number | undefined;
+    attempts?: number | undefined;
+    lastError?: string | undefined;
+    worker?: {
+        pid: number;
+        upstreamSessionId: string;
+    } | undefined;
+}>;
+type CompactionState = z.infer<typeof CompactionState>;
+declare const SessionSynopsis: z.ZodObject<{
+    goal: z.ZodOptional<z.ZodString>;
+    outcome: z.ZodOptional<z.ZodString>;
+    files_touched: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    tools_used: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    rejected_approaches: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    open_threads: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    decisions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    file_edit_intentions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    unresolved_errors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    tool_state: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    goal?: string | undefined;
+    outcome?: string | undefined;
+    files_touched?: string[] | undefined;
+    tools_used?: string[] | undefined;
+    rejected_approaches?: string[] | undefined;
+    open_threads?: string[] | undefined;
+    decisions?: string[] | undefined;
+    file_edit_intentions?: string[] | undefined;
+    unresolved_errors?: string[] | undefined;
+    tool_state?: string[] | undefined;
+}, {
+    goal?: string | undefined;
+    outcome?: string | undefined;
+    files_touched?: string[] | undefined;
+    tools_used?: string[] | undefined;
+    rejected_approaches?: string[] | undefined;
+    open_threads?: string[] | undefined;
+    decisions?: string[] | undefined;
+    file_edit_intentions?: string[] | undefined;
+    unresolved_errors?: string[] | undefined;
+    tool_state?: string[] | undefined;
+}>;
+type SessionSynopsis = z.infer<typeof SessionSynopsis>;
 
-interface AttachedClient {
-    clientId: string;
-    connection: JsonRpcConnection;
-    clientInfo?: {
+declare const RollbackBreadcrumb: z.ZodObject<{
+    previousUpstreamSessionId: z.ZodString;
+    previousSummarizedThroughEntry: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    previousUpstreamSessionId: string;
+    previousSummarizedThroughEntry?: number | undefined;
+}, {
+    previousUpstreamSessionId: string;
+    previousSummarizedThroughEntry?: number | undefined;
+}>;
+type RollbackBreadcrumb = z.infer<typeof RollbackBreadcrumb>;
+declare const SessionRecord: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    sessionId: z.ZodString;
+    lineageId: z.ZodOptional<z.ZodString>;
+    upstreamSessionId: z.ZodString;
+    importedFromSessionId: z.ZodOptional<z.ZodString>;
+    importedFromUpstreamSessionId: z.ZodOptional<z.ZodString>;
+    importedFromMachine: z.ZodOptional<z.ZodString>;
+    agentId: z.ZodString;
+    cwd: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    synopsis: z.ZodOptional<z.ZodObject<{
+        goal: z.ZodOptional<z.ZodString>;
+        outcome: z.ZodOptional<z.ZodString>;
+        files_touched: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        tools_used: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        rejected_approaches: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        open_threads: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        decisions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        file_edit_intentions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        unresolved_errors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        tool_state: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        goal?: string | undefined;
+        outcome?: string | undefined;
+        files_touched?: string[] | undefined;
+        tools_used?: string[] | undefined;
+        rejected_approaches?: string[] | undefined;
+        open_threads?: string[] | undefined;
+        decisions?: string[] | undefined;
+        file_edit_intentions?: string[] | undefined;
+        unresolved_errors?: string[] | undefined;
+        tool_state?: string[] | undefined;
+    }, {
+        goal?: string | undefined;
+        outcome?: string | undefined;
+        files_touched?: string[] | undefined;
+        tools_used?: string[] | undefined;
+        rejected_approaches?: string[] | undefined;
+        open_threads?: string[] | undefined;
+        decisions?: string[] | undefined;
+        file_edit_intentions?: string[] | undefined;
+        unresolved_errors?: string[] | undefined;
+        tool_state?: string[] | undefined;
+    }>>;
+    compactionState: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<["requested", "running", "swap_pending", "swap_deferred", "failed"]>;
+        requestedAt: z.ZodNumber;
+        iter: z.ZodOptional<z.ZodNumber>;
+        attempts: z.ZodOptional<z.ZodNumber>;
+        lastError: z.ZodOptional<z.ZodString>;
+        worker: z.ZodOptional<z.ZodObject<{
+            upstreamSessionId: z.ZodString;
+            pid: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            pid: number;
+            upstreamSessionId: string;
+        }, {
+            pid: number;
+            upstreamSessionId: string;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        status: "requested" | "running" | "swap_pending" | "swap_deferred" | "failed";
+        requestedAt: number;
+        iter?: number | undefined;
+        attempts?: number | undefined;
+        lastError?: string | undefined;
+        worker?: {
+            pid: number;
+            upstreamSessionId: string;
+        } | undefined;
+    }, {
+        status: "requested" | "running" | "swap_pending" | "swap_deferred" | "failed";
+        requestedAt: number;
+        iter?: number | undefined;
+        attempts?: number | undefined;
+        lastError?: string | undefined;
+        worker?: {
+            pid: number;
+            upstreamSessionId: string;
+        } | undefined;
+    }>>;
+    rollbackBreadcrumb: z.ZodOptional<z.ZodObject<{
+        previousUpstreamSessionId: z.ZodString;
+        previousSummarizedThroughEntry: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        previousUpstreamSessionId: string;
+        previousSummarizedThroughEntry?: number | undefined;
+    }, {
+        previousUpstreamSessionId: string;
+        previousSummarizedThroughEntry?: number | undefined;
+    }>>;
+    summarizedThroughEntry: z.ZodOptional<z.ZodNumber>;
+    agentArgs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    currentModel: z.ZodOptional<z.ZodString>;
+    currentMode: z.ZodOptional<z.ZodString>;
+    currentUsage: z.ZodOptional<z.ZodObject<{
+        used: z.ZodOptional<z.ZodNumber>;
+        size: z.ZodOptional<z.ZodNumber>;
+        costAmount: z.ZodOptional<z.ZodNumber>;
+        costCurrency: z.ZodOptional<z.ZodString>;
+        cumulativeCost: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        used?: number | undefined;
+        size?: number | undefined;
+        costAmount?: number | undefined;
+        costCurrency?: string | undefined;
+        cumulativeCost?: number | undefined;
+    }, {
+        used?: number | undefined;
+        size?: number | undefined;
+        costAmount?: number | undefined;
+        costCurrency?: string | undefined;
+        cumulativeCost?: number | undefined;
+    }>>;
+    agentCommands: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
         name: string;
-        version?: string;
-    };
-    readonly?: boolean;
-}
-type CachedNotification = HistoryEntry;
-interface SpawnReplacementAgentParams {
-    agentId: string;
-    cwd: string;
-    agentArgs?: string[];
-    forwardedEnv?: Record<string, string>;
-}
-interface SpawnReplacementAgentResult {
-    agent: AgentInstance;
-    upstreamSessionId: string;
-    agentMeta?: Record<string, unknown>;
-    agentCapabilities?: AgentCapabilities;
-    initialModel?: string;
-    initialModels?: AdvertisedModel[];
-    initialMode?: string;
-    initialModes?: AdvertisedMode[];
-}
-type SpawnReplacementAgent = (params: SpawnReplacementAgentParams) => Promise<SpawnReplacementAgentResult>;
-interface UsageSnapshot {
-    used?: number;
-    size?: number;
-    costAmount?: number;
-    costCurrency?: string;
-    cumulativeCost?: number;
-}
-interface SessionInit {
-    cwd: string;
-    agentId: string;
-    agent: AgentInstance;
-    upstreamSessionId: string;
-    title?: string;
-    sessionId?: string;
-    agentMeta?: Record<string, unknown>;
-    agentCapabilities?: AgentCapabilities;
-    agentArgs?: string[];
-    idleTimeoutMs?: number;
-    logger?: {
-        info: (msg: string) => void;
-        warn: (msg: string) => void;
-    };
-    spawnReplacementAgent?: SpawnReplacementAgent;
-    historyStore?: HistoryStore;
-    historyMaxEntries?: number;
-    currentModel?: string;
-    currentMode?: string;
-    currentUsage?: UsageSnapshot;
-    agentCommands?: AdvertisedCommand[];
-    agentModes?: AdvertisedMode[];
-    agentModels?: AdvertisedModel[];
-    firstPromptSeeded?: boolean;
-    scheduleSynopsis?: () => void;
-    createdAt?: number;
-    transformChain?: TransformerRef[];
-    idleEventTimeoutMs?: number;
-    parentSessionId?: string;
-    forkedFromSessionId?: string;
-    forkedFromMessageId?: string;
-    originatingClient?: {
-        name: string;
-        version?: string;
-    };
-    interactive?: boolean;
-    priority?: number;
-    forwardedEnv?: Record<string, string>;
-    listSessions?: () => Promise<{
-        sessionId: string;
-        title?: string;
-        cwd: string;
-        agentId?: string;
-        currentModel?: string;
-    }[]>;
-    extensionCommands?: ExtensionCommandRegistry;
-    availableAgents?: () => Array<{
-        id: string;
-        name?: string;
-        description?: string;
-    }>;
-}
-interface CloseOptions {
-    deleteRecord?: boolean;
-}
-declare class Session {
-    readonly sessionId: string;
-    readonly cwd: string;
-    agentId: string;
-    agent: AgentInstance;
-    upstreamSessionId: string;
-    agentMeta: Record<string, unknown> | undefined;
-    agentCapabilities: AgentCapabilities | undefined;
-    readonly agentArgs: string[] | undefined;
-    readonly parentSessionId: string | undefined;
-    readonly forkedFromSessionId: string | undefined;
-    readonly forkedFromMessageId: string | undefined;
-    readonly originatingClient: {
-        name: string;
-        version?: string;
-    } | undefined;
-    private _interactive;
-    get interactive(): boolean | undefined;
-    private _priority;
-    get priority(): number | undefined;
-    title: string | undefined;
-    currentModel: string | undefined;
-    currentMode: string | undefined;
-    private _currentUsage;
-    updatedAt: number;
-    readonly createdAt: number;
-    private clients;
-    private historyStore;
-    private promptQueue;
-    private currentEntry;
-    private promptInFlight;
-    private queueWriteChain;
-    private closed;
-    private closing;
-    private closeInFlight;
-    private closeHandlers;
-    private titleHandlers;
-    private scheduleSynopsisHook?;
-    private broadcastHandlers;
-    private lastCancelAt;
-    private static readonly CANCEL_ERROR_WINDOW_MS;
-    private forceCancelling;
-    private _firstPromptSeeded;
-    get firstPromptSeeded(): boolean;
-    private promptStartedAt;
-    private appendCount;
-    private historyMaxEntries;
-    private compactEvery;
-    private inFlightPermissions;
-    private internalPromptCapture;
-    private idleTimeoutMs;
-    private idleTimer;
-    private idleEventTimer;
-    private idleEventTimeoutMs;
-    private lastRecordedAt;
-    private spawnReplacementAgent;
-    forwardedEnv: Record<string, string> | undefined;
-    private listSessions;
-    private logger;
-    private transformChain;
-    private extensionCommands;
-    private extensionCommandsUnsub;
-    private pendingClaims;
-    private agentChangeHandlers;
-    private agentAdvertisedCommands;
-    private agentAdvertisedModes;
-    private agentAdvertisedModels;
-    private agentAdvertisedConfigOptions;
-    private agentCommandsHandlers;
-    private agentModesHandlers;
-    private agentModelsHandlers;
-    private availableAgentsFn?;
-    private modelHandlers;
-    private modeHandlers;
-    private interactiveHandlers;
-    private priorityHandlers;
-    private usageHandlers;
-    private cumulativeCost;
-    get currentUsage(): UsageSnapshot | undefined;
-    private amendInProgress;
-    private inFlightExtensionDispatches;
-    private recentlyTerminal;
-    private streamBuffer;
-    private streamFilePath;
-    constructor(init: SessionInit);
-    private broadcastMergedCommands;
-    private broadcastAvailableModes;
-    private broadcastAvailableModels;
-    private wireAgent;
-    private handleOrphanError;
-    private runResponseChain;
-    onAgentChange(handler: (info: {
-        agentId: string;
-        upstreamSessionId: string;
-    }) => void): void;
-    get attachedCount(): number;
-    connectedClients(excludeClientId?: string): Array<{
-        clientId: string;
-        name?: string;
-        version?: string;
-    }>;
-    get turnStartedAt(): number | undefined;
-    get awaitingInput(): boolean;
-    getHistorySnapshot(tools?: "inline" | "references"): Promise<CachedNotification[]>;
-    onBroadcast(handler: (entry: CachedNotification) => void): () => void;
-    attach(client: AttachedClient, historyPolicy: HistoryPolicy, opts?: {
-        afterMessageId?: string;
-        raw?: boolean;
-        toolContent?: "inline" | "references";
-    }): Promise<{
-        entries: CachedNotification[];
-        appliedPolicy: HistoryPolicy;
-    }>;
-    private loadReplay;
-    private buildStateSnapshotReplay;
-    replayPendingPermissions(client: AttachedClient): void;
-    detach(clientId: string): void;
-    private broadcastClientDisconnected;
-    prompt(clientId: string, params: unknown): Promise<unknown>;
-    private broadcastPromptReceived;
-    private broadcastTurnComplete;
-    private recordTerminal;
-    private broadcastPromptAmended;
-    private findUserEntry;
-    private visibleQueueDepth;
-    private broadcastQueueAdded;
-    private broadcastQueueUpdated;
-    private broadcastQueueRemoved;
-    private broadcastQueueNotification;
-    queueSnapshot(): PromptQueueEntry[];
-    flushPersistWrites(): Promise<void>;
-    replayPersistedQueue(entries: PersistedQueueEntry[]): void;
-    cancelQueuedPrompt(messageId: string): CancelPromptResult;
-    updateQueuedPrompt(messageId: string, prompt: unknown[]): UpdatePromptResult;
-    amendPrompt(clientId: string, params: AmendPromptParams): AmendPromptResult;
-    private amendOnHead;
-    private enqueueAmendmentAsFollowUp;
-    cancel(clientId: string): Promise<void>;
-    addTransformer(ref: TransformerRef): void;
-    forwardRequest(method: string, params: unknown, originatedBy?: Set<string>, startIdx?: number, tailKind?: "request" | "notification"): Promise<unknown>;
-    dischargeClaim(token: string, result: unknown): boolean;
-    keepAliveClaim(token: string, estimatedRemainingMs?: number): boolean;
-    emitToChain(emitterName: string, method: string, envelope: unknown): Promise<unknown>;
-    private rewriteForAgent;
-    close(opts?: CloseOptions): Promise<void>;
-    private doClose;
-    onClose(handler: (opts: {
-        deleteRecord: boolean;
-    }) => void): () => void;
-    onTitleChange(handler: (title: string) => void): void;
-    retitle(title: string): Promise<unknown>;
-    retitleFromAgent(): Promise<unknown>;
-    private setTitle;
-    private maybeSeedTitleFromPrompt;
-    private maybeApplyAgentModel;
-    private maybeApplyAgentConfigOption;
-    private maybeApplyAgentMode;
-    private maybeApplyAgentUsage;
-    private accumulateAndResetCost;
-    private injectCumulativeCost;
-    get totalUsage(): UsageSnapshot | undefined;
-    private setAgentAdvertisedCommands;
-    private setAgentAdvertisedModes;
-    private setAgentAdvertisedModels;
-    onAgentCommandsChange(handler: (commands: AdvertisedCommand[]) => void): void;
-    onAgentModesChange(handler: (modes: AdvertisedMode[]) => void): void;
-    onAgentModelsChange(handler: (models: AdvertisedModel[]) => void): void;
-    onModelChange(handler: (model: string) => void): void;
-    onModeChange(handler: (mode: string) => void): void;
-    onInteractiveChange(handler: (interactive: boolean) => void): void;
-    onPriorityChange(handler: (priority: number | undefined) => void): void;
-    setPriority(priority: number | undefined): void;
-    applyModelChange(modelId: string): void;
-    applyModeChange(modeId: string): void;
-    buildConfigOptions(): ConfigOption[];
-    private broadcastConfigOptions;
-    private mergeAgentOptionIntoEnvelope;
-    onUsageChange(handler: (usage: UsageSnapshot) => void): void;
-    mergedAvailableCommands(): AdvertisedCommand[];
-    agentOnlyAdvertisedCommands(): AdvertisedCommand[];
-    availableModes(): AdvertisedMode[];
-    availableModels(): AdvertisedModel[];
-    private maybeApplyAgentSessionInfo;
-    private handleSlashCommand;
-    private runExtensionCommand;
-    private runExtensionCommandInline;
-    private cancelExtensionDispatch;
-    private emitExtensionReply;
-    private handleSessionsCommand;
-    private handleHelpCommand;
-    private handleModelCommand;
-    private handleModeCommand;
-    private handleConfigCommand;
-    private runTitleCommand;
-    private runTitleCommandInline;
-    private runInternalPrompt;
-    setAgent(newAgentId: string): Promise<unknown>;
-    private runAgentCommand;
-    private runAgentCommandInline;
-    private runKillCommand;
-    private runRestartCommand;
-    private runRestartCommandInline;
-    forceCancel(): Promise<{
-        stopReason: string;
-    }>;
-    private respawnAgent;
-    private buildSwitchTranscript;
-    seedFromImport(): Promise<void>;
-    private broadcastAgentSwitch;
-    hasStreamBuffer(): boolean;
-    get streamPath(): string | undefined;
-    openStream(opts: {
-        mode?: "memory" | "file";
-        capacityBytes?: number;
-        fileCapBytes?: number;
-        filePathFor?: (sessionId: string) => string;
-    }): {
-        filePath?: string;
-        capacityBytes: number;
-        fileCapBytes?: number;
-    };
-    streamWrite(chunkB64: string, eof?: boolean): {
-        writeCursor: number;
-    };
-    streamRead(cursor: number, maxBytes: number | undefined, waitMs: number | undefined): Promise<{
-        bytes: string;
-        nextCursor: number;
-        gap?: number;
-        eof?: boolean;
-    }>;
-    streamTail(bytes: number): {
-        bytes: string;
-        startCursor: number;
-        endCursor: number;
-        truncated: boolean;
-    };
-    streamHead(bytes: number): {
-        bytes: string;
-        startCursor: number;
-        endCursor: number;
-        truncated: boolean;
-    };
-    streamWaitFor(cursor: number, timeoutMs: number): Promise<"data" | "eof" | "timeout">;
-    streamGrep(opts: StreamGrepOptions): StreamGrepResult;
-    streamInfo(): {
-        writeCursor: number;
-        oldestAvailable: number;
-        capacity: number;
-        closed: boolean;
-    };
-    private requireStreamBuffer;
-    private markClosed;
-    private get lastActivityAt();
-    private scheduleIdleCheck;
-    private armIdleTimer;
-    private checkIdle;
-    private cancelIdleTimer;
-    private scheduleIdleEvent;
-    private cancelIdleEventTimer;
-    private notifyChain;
-    private rewriteForClient;
-    private recordAndBroadcast;
-    requestPermissionFromClients(params: unknown): Promise<unknown>;
-    private handlePermissionRequest;
-    private enqueuePrompt;
-    private enqueueUserPrompt;
-    private parseQueuePosition;
-    private insertEntryAt;
-    private persistRewrite;
-    private persistedFromEntry;
-    private drainQueue;
-    private runQueueEntry;
-    private clearAmendIfMatches;
-}
-
-declare const SessionSynopsis: z.ZodObject<{
-    goal: z.ZodOptional<z.ZodString>;
-    outcome: z.ZodOptional<z.ZodString>;
-    files_touched: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    tools_used: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    rejected_approaches: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    open_threads: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-}, "strip", z.ZodTypeAny, {
-    outcome?: string | undefined;
-    goal?: string | undefined;
-    files_touched?: string[] | undefined;
-    tools_used?: string[] | undefined;
-    rejected_approaches?: string[] | undefined;
-    open_threads?: string[] | undefined;
-}, {
-    outcome?: string | undefined;
-    goal?: string | undefined;
-    files_touched?: string[] | undefined;
-    tools_used?: string[] | undefined;
-    rejected_approaches?: string[] | undefined;
-    open_threads?: string[] | undefined;
-}>;
-type SessionSynopsis = z.infer<typeof SessionSynopsis>;
-
-declare const SessionRecord: z.ZodObject<{
-    version: z.ZodLiteral<1>;
-    sessionId: z.ZodString;
-    lineageId: z.ZodOptional<z.ZodString>;
-    upstreamSessionId: z.ZodString;
-    importedFromSessionId: z.ZodOptional<z.ZodString>;
-    importedFromUpstreamSessionId: z.ZodOptional<z.ZodString>;
-    importedFromMachine: z.ZodOptional<z.ZodString>;
-    agentId: z.ZodString;
-    cwd: z.ZodString;
-    title: z.ZodOptional<z.ZodString>;
-    synopsis: z.ZodOptional<z.ZodObject<{
-        goal: z.ZodOptional<z.ZodString>;
-        outcome: z.ZodOptional<z.ZodString>;
-        files_touched: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        tools_used: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        rejected_approaches: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        open_threads: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, "strip", z.ZodTypeAny, {
-        outcome?: string | undefined;
-        goal?: string | undefined;
-        files_touched?: string[] | undefined;
-        tools_used?: string[] | undefined;
-        rejected_approaches?: string[] | undefined;
-        open_threads?: string[] | undefined;
-    }, {
-        outcome?: string | undefined;
-        goal?: string | undefined;
-        files_touched?: string[] | undefined;
-        tools_used?: string[] | undefined;
-        rejected_approaches?: string[] | undefined;
-        open_threads?: string[] | undefined;
-    }>>;
-    summarizedThroughEntry: z.ZodOptional<z.ZodNumber>;
-    agentArgs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    currentModel: z.ZodOptional<z.ZodString>;
-    currentMode: z.ZodOptional<z.ZodString>;
-    currentUsage: z.ZodOptional<z.ZodObject<{
-        used: z.ZodOptional<z.ZodNumber>;
-        size: z.ZodOptional<z.ZodNumber>;
-        costAmount: z.ZodOptional<z.ZodNumber>;
-        costCurrency: z.ZodOptional<z.ZodString>;
-        cumulativeCost: z.ZodOptional<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        used?: number | undefined;
-        size?: number | undefined;
-        costAmount?: number | undefined;
-        costCurrency?: string | undefined;
-        cumulativeCost?: number | undefined;
-    }, {
-        used?: number | undefined;
-        size?: number | undefined;
-        costAmount?: number | undefined;
-        costCurrency?: string | undefined;
-        cumulativeCost?: number | undefined;
-    }>>;
-    agentCommands: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        name: z.ZodString;
-        description: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        name: string;
-        description?: string | undefined;
-    }, {
-        name: string;
-        description?: string | undefined;
-    }>, "many">>;
-    agentModes: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        name: z.ZodOptional<z.ZodString>;
-        description: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        id: string;
-        name?: string | undefined;
-        description?: string | undefined;
-    }, {
-        id: string;
-        name?: string | undefined;
-        description?: string | undefined;
-    }>, "many">>;
-    agentModels: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        modelId: z.ZodString;
-        name: z.ZodOptional<z.ZodString>;
-        description: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        modelId: string;
-        name?: string | undefined;
-        description?: string | undefined;
-    }, {
-        modelId: string;
-        name?: string | undefined;
-        description?: string | undefined;
-    }>, "many">>;
-    pendingHistorySync: z.ZodOptional<z.ZodBoolean>;
-    parentSessionId: z.ZodOptional<z.ZodString>;
-    forkedFromSessionId: z.ZodOptional<z.ZodString>;
-    forkedFromMessageId: z.ZodOptional<z.ZodString>;
-    originatingClient: z.ZodOptional<z.ZodObject<{
-        name: z.ZodString;
-        version: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        name: string;
-        version?: string | undefined;
-    }, {
-        name: string;
-        version?: string | undefined;
-    }>>;
-    interactive: z.ZodOptional<z.ZodBoolean>;
-    priority: z.ZodOptional<z.ZodNumber>;
-    forwardedEnv: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    createdAt: z.ZodString;
-    updatedAt: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    sessionId: string;
-    version: 1;
+        description?: string | undefined;
+    }, {
+        name: string;
+        description?: string | undefined;
+    }>, "many">>;
+    agentModes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name?: string | undefined;
+        description?: string | undefined;
+    }, {
+        id: string;
+        name?: string | undefined;
+        description?: string | undefined;
+    }>, "many">>;
+    agentModels: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        modelId: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        modelId: string;
+        name?: string | undefined;
+        description?: string | undefined;
+    }, {
+        modelId: string;
+        name?: string | undefined;
+        description?: string | undefined;
+    }>, "many">>;
+    pendingHistorySync: z.ZodOptional<z.ZodBoolean>;
+    parentSessionId: z.ZodOptional<z.ZodString>;
+    forkedFromSessionId: z.ZodOptional<z.ZodString>;
+    forkedFromMessageId: z.ZodOptional<z.ZodString>;
+    originatingClient: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        version?: string | undefined;
+    }, {
+        name: string;
+        version?: string | undefined;
+    }>>;
+    interactive: z.ZodOptional<z.ZodBoolean>;
+    priority: z.ZodOptional<z.ZodNumber>;
+    forwardedEnv: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    sessionId: string;
+    version: 1;
     cwd: string;
     upstreamSessionId: string;
     agentId: string;
@@ -2813,6 +2619,18 @@ declare const SessionRecord: z.ZodObject<{
     createdAt: string;
     title?: string | undefined;
     agentArgs?: string[] | undefined;
+    synopsis?: {
+        goal?: string | undefined;
+        outcome?: string | undefined;
+        files_touched?: string[] | undefined;
+        tools_used?: string[] | undefined;
+        rejected_approaches?: string[] | undefined;
+        open_threads?: string[] | undefined;
+        decisions?: string[] | undefined;
+        file_edit_intentions?: string[] | undefined;
+        unresolved_errors?: string[] | undefined;
+        tool_state?: string[] | undefined;
+    } | undefined;
     currentModel?: string | undefined;
     currentUsage?: {
         used?: number | undefined;
@@ -2832,18 +2650,24 @@ declare const SessionRecord: z.ZodObject<{
     } | undefined;
     interactive?: boolean | undefined;
     priority?: number | undefined;
-    currentMode?: string | undefined;
-    forwardedEnv?: Record<string, string> | undefined;
-    synopsis?: {
-        outcome?: string | undefined;
-        goal?: string | undefined;
-        files_touched?: string[] | undefined;
-        tools_used?: string[] | undefined;
-        rejected_approaches?: string[] | undefined;
-        open_threads?: string[] | undefined;
+    compactionState?: {
+        status: "requested" | "running" | "swap_pending" | "swap_deferred" | "failed";
+        requestedAt: number;
+        iter?: number | undefined;
+        attempts?: number | undefined;
+        lastError?: string | undefined;
+        worker?: {
+            pid: number;
+            upstreamSessionId: string;
+        } | undefined;
     } | undefined;
+    currentMode?: string | undefined;
     lineageId?: string | undefined;
     importedFromSessionId?: string | undefined;
+    rollbackBreadcrumb?: {
+        previousUpstreamSessionId: string;
+        previousSummarizedThroughEntry?: number | undefined;
+    } | undefined;
     summarizedThroughEntry?: number | undefined;
     agentCommands?: {
         name: string;
@@ -2860,6 +2684,7 @@ declare const SessionRecord: z.ZodObject<{
         description?: string | undefined;
     }[] | undefined;
     pendingHistorySync?: boolean | undefined;
+    forwardedEnv?: Record<string, string> | undefined;
 }, {
     sessionId: string;
     version: 1;
@@ -2870,6 +2695,18 @@ declare const SessionRecord: z.ZodObject<{
     createdAt: string;
     title?: string | undefined;
     agentArgs?: string[] | undefined;
+    synopsis?: {
+        goal?: string | undefined;
+        outcome?: string | undefined;
+        files_touched?: string[] | undefined;
+        tools_used?: string[] | undefined;
+        rejected_approaches?: string[] | undefined;
+        open_threads?: string[] | undefined;
+        decisions?: string[] | undefined;
+        file_edit_intentions?: string[] | undefined;
+        unresolved_errors?: string[] | undefined;
+        tool_state?: string[] | undefined;
+    } | undefined;
     currentModel?: string | undefined;
     currentUsage?: {
         used?: number | undefined;
@@ -2889,18 +2726,24 @@ declare const SessionRecord: z.ZodObject<{
     } | undefined;
     interactive?: boolean | undefined;
     priority?: number | undefined;
-    currentMode?: string | undefined;
-    forwardedEnv?: Record<string, string> | undefined;
-    synopsis?: {
-        outcome?: string | undefined;
-        goal?: string | undefined;
-        files_touched?: string[] | undefined;
-        tools_used?: string[] | undefined;
-        rejected_approaches?: string[] | undefined;
-        open_threads?: string[] | undefined;
+    compactionState?: {
+        status: "requested" | "running" | "swap_pending" | "swap_deferred" | "failed";
+        requestedAt: number;
+        iter?: number | undefined;
+        attempts?: number | undefined;
+        lastError?: string | undefined;
+        worker?: {
+            pid: number;
+            upstreamSessionId: string;
+        } | undefined;
     } | undefined;
+    currentMode?: string | undefined;
     lineageId?: string | undefined;
     importedFromSessionId?: string | undefined;
+    rollbackBreadcrumb?: {
+        previousUpstreamSessionId: string;
+        previousSummarizedThroughEntry?: number | undefined;
+    } | undefined;
     summarizedThroughEntry?: number | undefined;
     agentCommands?: {
         name: string;
@@ -2917,6 +2760,7 @@ declare const SessionRecord: z.ZodObject<{
         description?: string | undefined;
     }[] | undefined;
     pendingHistorySync?: boolean | undefined;
+    forwardedEnv?: Record<string, string> | undefined;
 }>;
 type SessionRecord = z.infer<typeof SessionRecord>;
 declare class SessionStore {
@@ -2927,6 +2771,429 @@ declare class SessionStore {
     list(): Promise<SessionRecord[]>;
 }
 
+interface PersistedQueueEntry {
+    messageId: string;
+    originator: {
+        clientInfo: {
+            name?: string;
+            version?: string;
+        };
+    };
+    prompt: unknown[];
+    enqueuedAt: number;
+}
+
+interface AttachedClient {
+    clientId: string;
+    connection: JsonRpcConnection;
+    clientInfo?: {
+        name: string;
+        version?: string;
+    };
+    readonly?: boolean;
+}
+type CachedNotification = HistoryEntry;
+interface SpawnReplacementAgentParams {
+    agentId: string;
+    cwd: string;
+    agentArgs?: string[];
+    forwardedEnv?: Record<string, string>;
+    mcpServers?: unknown[];
+}
+interface SpawnReplacementAgentResult {
+    agent: AgentInstance;
+    upstreamSessionId: string;
+    agentMeta?: Record<string, unknown>;
+    agentCapabilities?: AgentCapabilities;
+    initialModel?: string;
+    initialModels?: AdvertisedModel[];
+    initialMode?: string;
+    initialModes?: AdvertisedMode[];
+}
+type SpawnReplacementAgent = (params: SpawnReplacementAgentParams) => Promise<SpawnReplacementAgentResult>;
+type LoadExistingAgentSession = (upstreamSessionId: string, params: SpawnReplacementAgentParams) => Promise<SpawnReplacementAgentResult>;
+interface UsageSnapshot {
+    used?: number;
+    size?: number;
+    costAmount?: number;
+    costCurrency?: string;
+    cumulativeCost?: number;
+}
+interface SessionInit {
+    cwd: string;
+    agentId: string;
+    agent: AgentInstance;
+    upstreamSessionId: string;
+    title?: string;
+    sessionId?: string;
+    agentMeta?: Record<string, unknown>;
+    agentCapabilities?: AgentCapabilities;
+    agentArgs?: string[];
+    idleTimeoutMs?: number;
+    logger?: {
+        info: (msg: string) => void;
+        warn: (msg: string) => void;
+    };
+    spawnReplacementAgent?: SpawnReplacementAgent;
+    mintMcpServersForSwap?: (session: Session) => Promise<unknown[]>;
+    historyStore?: HistoryStore;
+    historyMaxEntries?: number;
+    currentModel?: string;
+    currentMode?: string;
+    currentUsage?: UsageSnapshot;
+    agentCommands?: AdvertisedCommand[];
+    agentModes?: AdvertisedMode[];
+    agentModels?: AdvertisedModel[];
+    firstPromptSeeded?: boolean;
+    scheduleSynopsis?: () => void;
+    scheduleCompaction?: () => void;
+    getCompactionState?: () => Promise<CompactionState | undefined>;
+    createdAt?: number;
+    transformChain?: TransformerRef[];
+    idleEventTimeoutMs?: number;
+    parentSessionId?: string;
+    forkedFromSessionId?: string;
+    forkedFromMessageId?: string;
+    originatingClient?: {
+        name: string;
+        version?: string;
+    };
+    interactive?: boolean;
+    priority?: number;
+    forwardedEnv?: Record<string, string>;
+    listSessions?: () => Promise<{
+        sessionId: string;
+        title?: string;
+        cwd: string;
+        agentId?: string;
+        currentModel?: string;
+    }[]>;
+    extensionCommands?: ExtensionCommandRegistry;
+    availableAgents?: () => Array<{
+        id: string;
+        name?: string;
+        description?: string;
+    }>;
+    summarizedThroughEntry?: number;
+    compactionState?: CompactionState;
+    mcpServers?: unknown[];
+    loadExistingAgentSession?: LoadExistingAgentSession;
+    clearRollbackBreadcrumbHook?: () => void;
+    onCompactionSwapHook?: (breadcrumb: RollbackBreadcrumb) => void;
+    uncompactHook?: () => Promise<void>;
+}
+interface CloseOptions {
+    deleteRecord?: boolean;
+}
+declare class Session {
+    readonly sessionId: string;
+    readonly cwd: string;
+    agentId: string;
+    agent: AgentInstance;
+    upstreamSessionId: string;
+    agentMeta: Record<string, unknown> | undefined;
+    agentCapabilities: AgentCapabilities | undefined;
+    readonly agentArgs: string[] | undefined;
+    readonly parentSessionId: string | undefined;
+    readonly forkedFromSessionId: string | undefined;
+    readonly forkedFromMessageId: string | undefined;
+    readonly originatingClient: {
+        name: string;
+        version?: string;
+    } | undefined;
+    private _interactive;
+    get interactive(): boolean | undefined;
+    private _priority;
+    get priority(): number | undefined;
+    title: string | undefined;
+    private _summarizedThroughEntry;
+    get summarizedThroughEntry(): number | undefined;
+    set summarizedThroughEntry(value: number | undefined);
+    currentModel: string | undefined;
+    currentMode: string | undefined;
+    compactionState: CompactionState | undefined;
+    private _currentUsage;
+    updatedAt: number;
+    readonly createdAt: number;
+    private clients;
+    private historyStore;
+    private promptQueue;
+    private currentEntry;
+    private promptInFlight;
+    private modeChangeInFlight;
+    private modelChangeInFlight;
+    private queueWriteChain;
+    private closed;
+    private closing;
+    private closeInFlight;
+    private closeHandlers;
+    private titleHandlers;
+    private scheduleSynopsisHook?;
+    private scheduleCompactionHook?;
+    private getCompactionStateHook?;
+    private _liveCompactionPhase;
+    private broadcastHandlers;
+    private lastCancelAt;
+    private static readonly CANCEL_ERROR_WINDOW_MS;
+    private forceCancelling;
+    private _firstPromptSeeded;
+    get firstPromptSeeded(): boolean;
+    private promptStartedAt;
+    private appendCount;
+    private historyMaxEntries;
+    private compactEvery;
+    private inFlightPermissions;
+    private internalPromptCapture;
+    private idleTimeoutMs;
+    private idleTimer;
+    private idleEventTimer;
+    private idleEventTimeoutMs;
+    private lastRecordedAt;
+    private spawnReplacementAgent;
+    private mintMcpServersForSwap;
+    private loadExistingAgentSession;
+    private clearRollbackBreadcrumbHook;
+    private onCompactionSwapHook;
+    private uncompactHook;
+    private readonly mcpServersConfig;
+    forwardedEnv: Record<string, string> | undefined;
+    private listSessions;
+    private logger;
+    private transformChain;
+    private extensionCommands;
+    private extensionCommandsUnsub;
+    private pendingClaims;
+    private agentChangeHandlers;
+    private agentAdvertisedCommands;
+    private agentAdvertisedModes;
+    private agentAdvertisedModels;
+    private agentAdvertisedConfigOptions;
+    private agentCommandsHandlers;
+    private agentModesHandlers;
+    private agentModelsHandlers;
+    private availableAgentsFn?;
+    private modelHandlers;
+    private modeHandlers;
+    private interactiveHandlers;
+    private priorityHandlers;
+    private usageHandlers;
+    private cumulativeCost;
+    get currentUsage(): UsageSnapshot | undefined;
+    private amendInProgress;
+    private inFlightExtensionDispatches;
+    private recentlyTerminal;
+    private streamBuffer;
+    private streamFilePath;
+    constructor(init: SessionInit);
+    private broadcastMergedCommands;
+    private broadcastAvailableModes;
+    private broadcastAvailableModels;
+    private wireAgent;
+    private handleOrphanError;
+    private runResponseChain;
+    onAgentChange(handler: (info: {
+        agentId: string;
+        upstreamSessionId: string;
+    }) => void): void;
+    get attachedCount(): number;
+    connectedClients(excludeClientId?: string): Array<{
+        clientId: string;
+        name?: string;
+        version?: string;
+    }>;
+    get turnStartedAt(): number | undefined;
+    get awaitingInput(): boolean;
+    isQuiescedForSwap(): Promise<boolean>;
+    swapUpstream(opts: {
+        artifact: SessionSynopsis;
+        title?: string;
+        tailK: number;
+        summarizedThroughEntry?: number;
+    }): Promise<void>;
+    rollbackToUpstream(opts: {
+        previousUpstreamSessionId: string;
+        previousSummarizedThroughEntry?: number;
+    }): Promise<void>;
+    private _hasOpenToolCall;
+    getHistorySnapshot(tools?: "inline" | "references"): Promise<CachedNotification[]>;
+    onBroadcast(handler: (entry: CachedNotification) => void): () => void;
+    broadcastCompactionPhase(update: Record<string, unknown>): void;
+    attach(client: AttachedClient, historyPolicy: HistoryPolicy, opts?: {
+        afterMessageId?: string;
+        raw?: boolean;
+        toolContent?: "inline" | "references";
+    }): Promise<{
+        entries: CachedNotification[];
+        appliedPolicy: HistoryPolicy;
+    }>;
+    private loadReplay;
+    private buildStateSnapshotReplay;
+    replayPendingPermissions(client: AttachedClient): void;
+    detach(clientId: string): void;
+    private broadcastClientDisconnected;
+    prompt(clientId: string, params: unknown): Promise<unknown>;
+    private broadcastPromptReceived;
+    private recordCurrentUsageSnapshot;
+    private broadcastTurnComplete;
+    private recordTerminal;
+    private broadcastPromptAmended;
+    private findUserEntry;
+    private visibleQueueDepth;
+    private broadcastQueueAdded;
+    private broadcastQueueUpdated;
+    private broadcastQueueRemoved;
+    private broadcastQueueNotification;
+    queueSnapshot(): PromptQueueEntry[];
+    flushPersistWrites(): Promise<void>;
+    replayPersistedQueue(entries: PersistedQueueEntry[]): void;
+    cancelQueuedPrompt(messageId: string): CancelPromptResult;
+    updateQueuedPrompt(messageId: string, prompt: unknown[]): UpdatePromptResult;
+    amendPrompt(clientId: string, params: AmendPromptParams): AmendPromptResult;
+    private amendOnHead;
+    private enqueueAmendmentAsFollowUp;
+    cancel(clientId: string): Promise<void>;
+    addTransformer(ref: TransformerRef): void;
+    forwardRequest(method: string, params: unknown, originatedBy?: Set<string>, startIdx?: number, tailKind?: "request" | "notification"): Promise<unknown>;
+    dischargeClaim(token: string, result: unknown): boolean;
+    keepAliveClaim(token: string, estimatedRemainingMs?: number): boolean;
+    emitToChain(emitterName: string, method: string, envelope: unknown): Promise<unknown>;
+    private rewriteForAgent;
+    close(opts?: CloseOptions): Promise<void>;
+    private doClose;
+    onClose(handler: (opts: {
+        deleteRecord: boolean;
+    }) => void): () => void;
+    onTitleChange(handler: (title: string) => void): void;
+    retitle(title: string): Promise<unknown>;
+    retitleFromAgent(): Promise<unknown>;
+    private setTitle;
+    private maybeSeedTitleFromPrompt;
+    private maybeApplyAgentModel;
+    private maybeApplyAgentConfigOption;
+    private maybeApplyAgentMode;
+    private maybeApplyAgentUsage;
+    private accumulateAndResetCost;
+    private injectCumulativeCost;
+    get totalUsage(): UsageSnapshot | undefined;
+    private setAgentAdvertisedCommands;
+    private setAgentAdvertisedModes;
+    private setAgentAdvertisedModels;
+    onAgentCommandsChange(handler: (commands: AdvertisedCommand[]) => void): void;
+    onAgentModesChange(handler: (modes: AdvertisedMode[]) => void): void;
+    onAgentModelsChange(handler: (models: AdvertisedModel[]) => void): void;
+    onModelChange(handler: (model: string) => void): void;
+    onModeChange(handler: (mode: string) => void): void;
+    onInteractiveChange(handler: (interactive: boolean) => void): void;
+    onPriorityChange(handler: (priority: number | undefined) => void): void;
+    setPriority(priority: number | undefined): void;
+    applyModelChange(modelId: string): void;
+    applyModeChange(modeId: string): void;
+    buildConfigOptions(): ConfigOption[];
+    private broadcastConfigOptions;
+    private mergeAgentOptionIntoEnvelope;
+    onUsageChange(handler: (usage: UsageSnapshot) => void): void;
+    mergedAvailableCommands(): AdvertisedCommand[];
+    agentOnlyAdvertisedCommands(): AdvertisedCommand[];
+    availableModes(): AdvertisedMode[];
+    availableModels(): AdvertisedModel[];
+    private maybeApplyAgentSessionInfo;
+    private handleSlashCommand;
+    private runExtensionCommand;
+    private runExtensionCommandInline;
+    private cancelExtensionDispatch;
+    private emitExtensionReply;
+    private handleSessionsCommand;
+    private handleHelpCommand;
+    private handleModelCommand;
+    private handleModeCommand;
+    private handleConfigCommand;
+    private runTitleCommand;
+    private runTitleCommandInline;
+    private runInternalPrompt;
+    setAgent(newAgentId: string): Promise<unknown>;
+    private runAgentCommand;
+    private runAgentCommandInline;
+    private runKillCommand;
+    private runRestartCommand;
+    private runRestartCommandInline;
+    private runCompactCommand;
+    private runCompactCommandInline;
+    private runCompactStatusCommandInline;
+    private runUncompactCommand;
+    private runUncompactCommandInline;
+    forceCancel(): Promise<{
+        stopReason: string;
+    }>;
+    private respawnAgent;
+    private buildSwitchTranscript;
+    seedFromImport(): Promise<void>;
+    private broadcastAgentSwitch;
+    hasStreamBuffer(): boolean;
+    get streamPath(): string | undefined;
+    openStream(opts: {
+        mode?: "memory" | "file";
+        capacityBytes?: number;
+        fileCapBytes?: number;
+        filePathFor?: (sessionId: string) => string;
+    }): {
+        filePath?: string;
+        capacityBytes: number;
+        fileCapBytes?: number;
+    };
+    streamWrite(chunkB64: string, eof?: boolean): {
+        writeCursor: number;
+    };
+    streamRead(cursor: number, maxBytes: number | undefined, waitMs: number | undefined): Promise<{
+        bytes: string;
+        nextCursor: number;
+        gap?: number;
+        eof?: boolean;
+    }>;
+    streamTail(bytes: number): {
+        bytes: string;
+        startCursor: number;
+        endCursor: number;
+        truncated: boolean;
+    };
+    streamHead(bytes: number): {
+        bytes: string;
+        startCursor: number;
+        endCursor: number;
+        truncated: boolean;
+    };
+    streamWaitFor(cursor: number, timeoutMs: number): Promise<"data" | "eof" | "timeout">;
+    streamGrep(opts: StreamGrepOptions): StreamGrepResult;
+    streamInfo(): {
+        writeCursor: number;
+        oldestAvailable: number;
+        capacity: number;
+        closed: boolean;
+    };
+    private requireStreamBuffer;
+    private markClosed;
+    private get lastActivityAt();
+    private scheduleIdleCheck;
+    private armIdleTimer;
+    private checkIdle;
+    private cancelIdleTimer;
+    private scheduleIdleEvent;
+    private cancelIdleEventTimer;
+    private notifyChain;
+    private rewriteForClient;
+    private recordAndBroadcast;
+    requestPermissionFromClients(params: unknown): Promise<unknown>;
+    private handlePermissionRequest;
+    private enqueuePrompt;
+    private enqueueUserPrompt;
+    private parseQueuePosition;
+    private insertEntryAt;
+    private persistRewrite;
+    private persistedFromEntry;
+    private drainQueue;
+    private runQueueEntry;
+    private clearAmendIfMatches;
+}
+
 declare const Tombstone: z.ZodObject<{
     version: z.ZodLiteral<1>;
     agentId: z.ZodString;
@@ -2998,20 +3265,32 @@ declare const Bundle: z.ZodObject<{
             tools_used: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             rejected_approaches: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             open_threads: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            decisions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            file_edit_intentions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            unresolved_errors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            tool_state: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         }, "strip", z.ZodTypeAny, {
-            outcome?: string | undefined;
             goal?: string | undefined;
+            outcome?: string | undefined;
             files_touched?: string[] | undefined;
             tools_used?: string[] | undefined;
             rejected_approaches?: string[] | undefined;
             open_threads?: string[] | undefined;
+            decisions?: string[] | undefined;
+            file_edit_intentions?: string[] | undefined;
+            unresolved_errors?: string[] | undefined;
+            tool_state?: string[] | undefined;
         }, {
-            outcome?: string | undefined;
             goal?: string | undefined;
+            outcome?: string | undefined;
             files_touched?: string[] | undefined;
             tools_used?: string[] | undefined;
             rejected_approaches?: string[] | undefined;
             open_threads?: string[] | undefined;
+            decisions?: string[] | undefined;
+            file_edit_intentions?: string[] | undefined;
+            unresolved_errors?: string[] | undefined;
+            tool_state?: string[] | undefined;
         }>>;
         summarizedThroughEntry: z.ZodOptional<z.ZodNumber>;
         currentModel: z.ZodOptional<z.ZodString>;
@@ -3081,6 +3360,18 @@ declare const Bundle: z.ZodObject<{
         lineageId: string;
         title?: string | undefined;
         upstreamSessionId?: string | undefined;
+        synopsis?: {
+            goal?: string | undefined;
+            outcome?: string | undefined;
+            files_touched?: string[] | undefined;
+            tools_used?: string[] | undefined;
+            rejected_approaches?: string[] | undefined;
+            open_threads?: string[] | undefined;
+            decisions?: string[] | undefined;
+            file_edit_intentions?: string[] | undefined;
+            unresolved_errors?: string[] | undefined;
+            tool_state?: string[] | undefined;
+        } | undefined;
         currentModel?: string | undefined;
         currentUsage?: {
             used?: number | undefined;
@@ -3096,14 +3387,6 @@ declare const Bundle: z.ZodObject<{
         interactive?: boolean | undefined;
         priority?: number | undefined;
         currentMode?: string | undefined;
-        synopsis?: {
-            outcome?: string | undefined;
-            goal?: string | undefined;
-            files_touched?: string[] | undefined;
-            tools_used?: string[] | undefined;
-            rejected_approaches?: string[] | undefined;
-            open_threads?: string[] | undefined;
-        } | undefined;
         summarizedThroughEntry?: number | undefined;
         agentCommands?: {
             name: string;
@@ -3123,6 +3406,18 @@ declare const Bundle: z.ZodObject<{
         lineageId: string;
         title?: string | undefined;
         upstreamSessionId?: string | undefined;
+        synopsis?: {
+            goal?: string | undefined;
+            outcome?: string | undefined;
+            files_touched?: string[] | undefined;
+            tools_used?: string[] | undefined;
+            rejected_approaches?: string[] | undefined;
+            open_threads?: string[] | undefined;
+            decisions?: string[] | undefined;
+            file_edit_intentions?: string[] | undefined;
+            unresolved_errors?: string[] | undefined;
+            tool_state?: string[] | undefined;
+        } | undefined;
         currentModel?: string | undefined;
         currentUsage?: {
             used?: number | undefined;
@@ -3138,14 +3433,6 @@ declare const Bundle: z.ZodObject<{
         interactive?: boolean | undefined;
         priority?: number | undefined;
         currentMode?: string | undefined;
-        synopsis?: {
-            outcome?: string | undefined;
-            goal?: string | undefined;
-            files_touched?: string[] | undefined;
-            tools_used?: string[] | undefined;
-            rejected_approaches?: string[] | undefined;
-            open_threads?: string[] | undefined;
-        } | undefined;
         summarizedThroughEntry?: number | undefined;
         agentCommands?: {
             name: string;
@@ -3183,6 +3470,18 @@ declare const Bundle: z.ZodObject<{
         lineageId: string;
         title?: string | undefined;
         upstreamSessionId?: string | undefined;
+        synopsis?: {
+            goal?: string | undefined;
+            outcome?: string | undefined;
+            files_touched?: string[] | undefined;
+            tools_used?: string[] | undefined;
+            rejected_approaches?: string[] | undefined;
+            open_threads?: string[] | undefined;
+            decisions?: string[] | undefined;
+            file_edit_intentions?: string[] | undefined;
+            unresolved_errors?: string[] | undefined;
+            tool_state?: string[] | undefined;
+        } | undefined;
         currentModel?: string | undefined;
         currentUsage?: {
             used?: number | undefined;
@@ -3198,14 +3497,6 @@ declare const Bundle: z.ZodObject<{
         interactive?: boolean | undefined;
         priority?: number | undefined;
         currentMode?: string | undefined;
-        synopsis?: {
-            outcome?: string | undefined;
-            goal?: string | undefined;
-            files_touched?: string[] | undefined;
-            tools_used?: string[] | undefined;
-            rejected_approaches?: string[] | undefined;
-            open_threads?: string[] | undefined;
-        } | undefined;
         summarizedThroughEntry?: number | undefined;
         agentCommands?: {
             name: string;
@@ -3241,6 +3532,18 @@ declare const Bundle: z.ZodObject<{
         lineageId: string;
         title?: string | undefined;
         upstreamSessionId?: string | undefined;
+        synopsis?: {
+            goal?: string | undefined;
+            outcome?: string | undefined;
+            files_touched?: string[] | undefined;
+            tools_used?: string[] | undefined;
+            rejected_approaches?: string[] | undefined;
+            open_threads?: string[] | undefined;
+            decisions?: string[] | undefined;
+            file_edit_intentions?: string[] | undefined;
+            unresolved_errors?: string[] | undefined;
+            tool_state?: string[] | undefined;
+        } | undefined;
         currentModel?: string | undefined;
         currentUsage?: {
             used?: number | undefined;
@@ -3256,14 +3559,6 @@ declare const Bundle: z.ZodObject<{
         interactive?: boolean | undefined;
         priority?: number | undefined;
         currentMode?: string | undefined;
-        synopsis?: {
-            outcome?: string | undefined;
-            goal?: string | undefined;
-            files_touched?: string[] | undefined;
-            tools_used?: string[] | undefined;
-            rejected_approaches?: string[] | undefined;
-            open_threads?: string[] | undefined;
-        } | undefined;
         summarizedThroughEntry?: number | undefined;
         agentCommands?: {
             name: string;
@@ -3307,6 +3602,7 @@ interface CreateSessionParams {
     };
     interactive?: boolean;
     forwardedEnv?: Record<string, string>;
+    mintMcpServersForSwap?: (session: Session) => Promise<unknown[]>;
 }
 interface ResurrectParams {
     hydraSessionId: string;
@@ -3336,6 +3632,8 @@ interface ResurrectParams {
     forkedFromMessageId?: string;
     mcpServers?: unknown[];
     forwardedEnv?: Record<string, string>;
+    compactionState?: CompactionState;
+    mintMcpServersForSwap?: (session: Session) => Promise<unknown[]>;
 }
 type AgentSpawner = (opts: AgentInstanceOptions) => AgentInstance;
 interface SessionManagerOptions {
@@ -3343,7 +3641,8 @@ interface SessionManagerOptions {
     defaultModels?: Record<string, string>;
     synopsisAgent?: string;
     synopsisModel?: string;
-    synopsisOnClose?: boolean;
+    compactionAgent?: string;
+    compactionModel?: string;
     sessionHistoryMaxEntries?: number;
     defaultTransformers?: string[];
     idleEventTimeoutMs?: number;
@@ -3352,6 +3651,10 @@ interface SessionManagerOptions {
     extensionCommands?: ExtensionCommandRegistry;
     defaultCwd?: string;
     tombstones?: TombstoneStore;
+    compaction?: {
+        tailK?: number;
+        maxIterations?: number;
+    };
 }
 declare class SessionManager {
     private registry;
@@ -3366,7 +3669,8 @@ declare class SessionManager {
     private defaultModels;
     private synopsisAgent?;
     private synopsisModel?;
-    private synopsisOnClose;
+    private compactionAgent?;
+    private compactionModel?;
     readonly defaultTransformers: string[];
     private idleEventTimeoutMs;
     private sessionHistoryMaxEntries;
@@ -3378,8 +3682,12 @@ declare class SessionManager {
     private extensionCommands?;
     private defaultCwd;
     private synopsisCoordinator;
+    private compactionDeferrals;
+    private rollbackLocks;
+    private compactionTailK;
     private agentCatalog;
     constructor(registry: Registry, spawner?: AgentSpawner, store?: SessionStore, options?: SessionManagerOptions);
+    private retrySwap;
     private refreshAgentCatalog;
     create(params: CreateSessionParams): Promise<Session>;
     resurrect(params: ResurrectParams): Promise<Session>;
@@ -3395,6 +3703,8 @@ declare class SessionManager {
     private collectAgentSessions;
     private applySeedModel;
     private bootstrapAgent;
+    private bootstrapAgentLoad;
+    performUncompact(sessionId: string): Promise<void>;
     bootstrapAgentForAuth(agentId: string, cwd?: string): Promise<AgentInstance>;
     planSpawnForAgent(agentId: string): Promise<SpawnPlan>;
     consumePendingAuthAgent(agentId: string): AgentInstance | undefined;
@@ -3464,8 +3774,15 @@ declare class SessionManager {
     flushSynopsis(timeoutMs: number): Promise<void>;
     shutdownSynopsis(): Promise<void>;
     scheduleSynopsis(sessionId: string): void;
+    scheduleCompaction(sessionId: string): void;
+    getCompactionInFlight(): boolean;
+    getCompactionState(sessionId: string): Promise<CompactionState | undefined>;
+    getRollbackBreadcrumb(sessionId: string): Promise<RollbackBreadcrumb | undefined>;
+    private broadcastHydraCompaction;
+    getSummarizedThroughEntry(sessionId: string): Promise<number | undefined>;
     flushMetaWrites(): Promise<void>;
     flushHistoryWrites(): Promise<void>;
+    resumePendingCompactions(): Promise<void>;
     resurrectPendingQueues(): Promise<void>;
 }