@hydra-acp/cli 0.1.53 → 0.1.54

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 import { FastifyInstance } from 'fastify';
 import { z } from 'zod';
 import { Readable, Writable } from 'node:stream';
+import { ChildProcess } from 'node:child_process';
+import * as fs from 'node:fs';
 import { WebSocket } from 'ws';
 
 declare const ExtensionBody: z.ZodObject<{
@@ -102,6 +104,9 @@ declare const HydraConfig: z.ZodObject<{
     }>>;
     defaultAgent: z.ZodDefault<z.ZodString>;
     defaultModels: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    synopsisAgent: z.ZodOptional<z.ZodString>;
+    synopsisModel: z.ZodOptional<z.ZodString>;
+    synopsisOnClose: z.ZodDefault<z.ZodBoolean>;
     defaultCwd: z.ZodDefault<z.ZodString>;
     sessionListColdLimit: z.ZodDefault<z.ZodNumber>;
     extensions: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -159,7 +164,7 @@ declare const HydraConfig: z.ZodObject<{
         defaultEnterAction: "enqueue" | "amend";
         showThoughts: boolean;
         promptHistoryMaxEntries: number;
-        showFileUpdates: "none" | "edit" | "diff";
+        showFileUpdates: "diff" | "none" | "edit";
     }, {
         repaintThrottleMs?: number | undefined;
         maxScrollbackLines?: number | undefined;
@@ -170,7 +175,7 @@ declare const HydraConfig: z.ZodObject<{
         defaultEnterAction?: "enqueue" | "amend" | undefined;
         showThoughts?: boolean | undefined;
         promptHistoryMaxEntries?: number | undefined;
-        showFileUpdates?: "none" | "edit" | "diff" | undefined;
+        showFileUpdates?: "diff" | "none" | "edit" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     tui: {
@@ -183,7 +188,7 @@ declare const HydraConfig: z.ZodObject<{
         defaultEnterAction: "enqueue" | "amend";
         showThoughts: boolean;
         promptHistoryMaxEntries: number;
-        showFileUpdates: "none" | "edit" | "diff";
+        showFileUpdates: "diff" | "none" | "edit";
     };
     daemon: {
         host: string;
@@ -217,9 +222,12 @@ declare const HydraConfig: z.ZodObject<{
     };
     defaultAgent: string;
     defaultModels: Record<string, string>;
+    synopsisOnClose: boolean;
     defaultCwd: string;
     sessionListColdLimit: number;
     defaultTransformers: string[];
+    synopsisAgent?: string | undefined;
+    synopsisModel?: string | undefined;
     npmRegistry?: string | undefined;
 }, {
     tui?: {
@@ -232,7 +240,7 @@ declare const HydraConfig: z.ZodObject<{
         defaultEnterAction?: "enqueue" | "amend" | undefined;
         showThoughts?: boolean | undefined;
         promptHistoryMaxEntries?: number | undefined;
-        showFileUpdates?: "none" | "edit" | "diff" | undefined;
+        showFileUpdates?: "diff" | "none" | "edit" | undefined;
     } | undefined;
     daemon?: {
         host?: string | undefined;
@@ -266,6 +274,9 @@ declare const HydraConfig: z.ZodObject<{
     } | undefined;
     defaultAgent?: string | undefined;
     defaultModels?: Record<string, string> | undefined;
+    synopsisAgent?: string | undefined;
+    synopsisModel?: string | undefined;
+    synopsisOnClose?: boolean | undefined;
     defaultCwd?: string | undefined;
     sessionListColdLimit?: number | undefined;
     defaultTransformers?: string[] | undefined;
@@ -1748,8 +1759,10 @@ declare class AgentInstance {
     private stderrTail;
     private stderrTailBytes;
     private logger?;
+    private fileLog?;
     private exitHandlers;
     private constructor();
+    private writeLog;
     private formatFailure;
     static spawn(opts: AgentInstanceOptions): AgentInstance;
     onExit(handler: (code: number | null, signal: NodeJS.Signals | null) => void): void;
@@ -1777,12 +1790,34 @@ declare class ProcessTokenRegistry implements TokenValidator {
     validate(token: string): Promise<string | undefined>;
 }
 
-interface TransformerRef {
+interface BreakerOptions {
+    windowMs?: number;
+    maxFailuresInWindow?: number;
+    now?: () => number;
+}
+type BreakerDecision = "restart" | {
+    tripped: string;
+};
+declare class RestartBreaker {
+    private readonly windowMs;
+    private readonly maxFailures;
+    private readonly now;
+    private recentExits;
+    private tripped_;
+    constructor(opts?: BreakerOptions);
+    recordExit(code: number | null, name: string, kind: string): BreakerDecision;
+    reset(): void;
+    get tripped(): string | undefined;
+}
+
+interface BaseChildConfig {
     name: string;
-    intercepts: Set<string>;
-    connection: JsonRpcConnection;
+    command: string[];
+    args: string[];
+    env: Record<string, string>;
+    enabled: boolean;
 }
-interface TransformerContext {
+interface BaseChildContext {
     daemonUrl: string;
     daemonHost: string;
     daemonPort: number;
@@ -1790,10 +1825,10 @@ interface TransformerContext {
     daemonWsUrl: string;
     hydraHome: string;
 }
-type TransformerStatus = "running" | "stopped" | "restarting" | "disabled";
-interface TransformerInfo {
+type BaseChildStatus = "running" | "stopped" | "restarting" | "disabled" | "failed";
+interface BaseChildInfo {
     name: string;
-    status: TransformerStatus;
+    status: BaseChildStatus;
     pid: number | undefined;
     enabled: boolean;
     restartCount: number;
@@ -1801,37 +1836,83 @@ interface TransformerInfo {
     lastExitCode: number | undefined;
     logPath: string;
     version: string | undefined;
+    failureReason: string | undefined;
 }
-declare class TransformerManager {
-    private entries;
-    private connected;
+interface SupervisorAdapter {
+    kind: "extension" | "transformer";
+    nameEnvVar: string;
+    tokenRole: "extension" | "transformer";
+    paths: {
+        dir: () => string;
+        logFile: (name: string) => string;
+        pidFile: (name: string) => string;
+    };
+}
+interface ChildEntry<TConfig extends BaseChildConfig> {
+    config: TConfig;
+    child: ChildProcess | undefined;
+    logStream: fs.WriteStream | undefined;
+    restartTimer: NodeJS.Timeout | undefined;
+    pid: number | undefined;
+    startedAt: number | undefined;
+    restartCount: number;
+    lastExitCode: number | undefined;
+    manuallyStopped: boolean;
+    exitWaiters: Array<() => void>;
+    version: string | undefined;
+    processToken: string | undefined;
+    breaker: RestartBreaker;
+    failureReason: string | undefined;
+}
+interface ChildSupervisorOptions {
+    tokenRegistry?: ProcessTokenRegistry;
+    breakerOptions?: BreakerOptions;
+    restartBaseMs?: number;
+    restartCapMs?: number;
+}
+declare class ChildSupervisor<TConfig extends BaseChildConfig> {
+    protected entries: Map<string, ChildEntry<TConfig>>;
     private stopping;
     private context;
     private tokenRegistry;
-    constructor(transformers: TransformerConfig[], context?: TransformerContext, options?: {
-        tokenRegistry?: ProcessTokenRegistry;
-    });
-    setContext(context: TransformerContext): void;
+    private breakerOptions;
+    private restartBaseMs;
+    private restartCapMs;
+    private adapter;
+    constructor(configs: TConfig[], adapter: SupervisorAdapter, context?: BaseChildContext, options?: ChildSupervisorOptions);
+    setContext(context: BaseChildContext): void;
     reportVersion(name: string, version: string): void;
-    registerConnection(name: string, connection: JsonRpcConnection, intercepts: string[]): void;
-    deregisterConnection(name: string): void;
-    resolveChain(names: string[]): TransformerRef[];
     start(): Promise<void>;
     stop(): Promise<void>;
-    list(): TransformerInfo[];
-    get(name: string): TransformerInfo | undefined;
+    list(): BaseChildInfo[];
+    get(name: string): BaseChildInfo | undefined;
     has(name: string): boolean;
-    startByName(name: string): Promise<TransformerInfo>;
-    stopByName(name: string): Promise<TransformerInfo>;
-    restartByName(name: string): Promise<TransformerInfo>;
-    register(config: TransformerConfig): TransformerInfo;
+    startByName(name: string): Promise<BaseChildInfo>;
+    stopByName(name: string): Promise<BaseChildInfo>;
+    restartByName(name: string): Promise<BaseChildInfo>;
+    register(config: TConfig): BaseChildInfo;
     unregister(name: string): Promise<void>;
     private terminate;
-    private infoFor;
+    protected infoFor(entry: ChildEntry<TConfig>): BaseChildInfo;
     private makeEntry;
     private reapOrphans;
     private spawn;
     private scheduleRestart;
+    private managerName;
+}
+
+type TransformerContext = BaseChildContext;
+interface TransformerRef {
+    name: string;
+    intercepts: Set<string>;
+    connection: JsonRpcConnection;
+}
+declare class TransformerManager extends ChildSupervisor<TransformerConfig> {
+    private connected;
+    constructor(transformers: TransformerConfig[], context?: TransformerContext, options?: ChildSupervisorOptions);
+    registerConnection(name: string, connection: JsonRpcConnection, intercepts: string[]): void;
+    deregisterConnection(name: string): void;
+    resolveChain(names: string[]): TransformerRef[];
 }
 
 interface StreamGrepLine {
@@ -1988,6 +2069,7 @@ interface SessionInit {
     agentModes?: AdvertisedMode[];
     agentModels?: AdvertisedModel[];
     firstPromptSeeded?: boolean;
+    scheduleSynopsis?: () => void;
     createdAt?: number;
     transformChain?: TransformerRef[];
     idleEventTimeoutMs?: number;
@@ -2009,8 +2091,6 @@ interface SessionInit {
 }
 interface CloseOptions {
     deleteRecord?: boolean;
-    regenTitle?: boolean;
-    regenTitleTimeoutMs?: number;
 }
 declare class Session {
     readonly sessionId: string;
@@ -2042,10 +2122,13 @@ declare class Session {
     private queueWriteChain;
     private closed;
     private closing;
+    private closeInFlight;
     private closeHandlers;
     private titleHandlers;
+    private scheduleSynopsisHook?;
     private broadcastHandlers;
-    private firstPromptSeeded;
+    private _firstPromptSeeded;
+    get firstPromptSeeded(): boolean;
     private promptStartedAt;
     private appendCount;
     private historyMaxEntries;
@@ -2137,6 +2220,7 @@ declare class Session {
     emitToChain(emitterName: string, method: string, envelope: unknown): Promise<void>;
     private rewriteForAgent;
     close(opts?: CloseOptions): Promise<void>;
+    private doClose;
     onClose(handler: (opts: {
         deleteRecord: boolean;
     }) => void): void;
@@ -2175,7 +2259,6 @@ declare class Session {
     private handleHelpCommand;
     private handleModelCommand;
     private runTitleCommand;
-    private runTitleRegen;
     private runInternalPrompt;
     private runAgentCommand;
     private runKillCommand;
@@ -2246,6 +2329,30 @@ declare class Session {
     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;
@@ -2257,6 +2364,29 @@ declare const SessionRecord: z.ZodObject<{
     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>;
@@ -2359,8 +2489,17 @@ declare const SessionRecord: z.ZodObject<{
         name: string;
         version?: string | undefined;
     } | 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;
     lineageId?: string | undefined;
     importedFromSessionId?: string | undefined;
+    summarizedThroughEntry?: number | undefined;
     agentCommands?: {
         name: string;
         description?: string | undefined;
@@ -2404,8 +2543,17 @@ declare const SessionRecord: z.ZodObject<{
         name: string;
         version?: string | undefined;
     } | 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;
     lineageId?: string | undefined;
     importedFromSessionId?: string | undefined;
+    summarizedThroughEntry?: number | undefined;
     agentCommands?: {
         name: string;
         description?: string | undefined;
@@ -2454,6 +2602,29 @@ declare const Bundle: z.ZodObject<{
         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>;
         currentModel: z.ZodOptional<z.ZodString>;
         currentMode: z.ZodOptional<z.ZodString>;
         currentUsage: z.ZodOptional<z.ZodObject<{
@@ -2518,6 +2689,15 @@ declare const Bundle: z.ZodObject<{
             costCurrency?: string | undefined;
             cumulativeCost?: number | undefined;
         } | 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;
             description?: string | undefined;
@@ -2545,6 +2725,15 @@ declare const Bundle: z.ZodObject<{
             costCurrency?: string | undefined;
             cumulativeCost?: number | undefined;
         } | 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;
             description?: string | undefined;
@@ -2589,6 +2778,15 @@ declare const Bundle: z.ZodObject<{
             costCurrency?: string | undefined;
             cumulativeCost?: number | undefined;
         } | 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;
             description?: string | undefined;
@@ -2631,6 +2829,15 @@ declare const Bundle: z.ZodObject<{
             costCurrency?: string | undefined;
             cumulativeCost?: number | undefined;
         } | 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;
             description?: string | undefined;
@@ -2677,6 +2884,8 @@ interface ResurrectParams {
     agentId: string;
     cwd: string;
     title?: string;
+    synopsis?: SessionSynopsis;
+    summarizedThroughEntry?: number;
     agentArgs?: string[];
     onInstallProgress?: AgentInstallProgressCallback;
     currentModel?: string;
@@ -2698,6 +2907,9 @@ type AgentSpawner = (opts: AgentInstanceOptions) => AgentInstance;
 interface SessionManagerOptions {
     idleTimeoutMs?: number;
     defaultModels?: Record<string, string>;
+    synopsisAgent?: string;
+    synopsisModel?: string;
+    synopsisOnClose?: boolean;
     sessionHistoryMaxEntries?: number;
     defaultTransformers?: string[];
     idleEventTimeoutMs?: number;
@@ -2714,6 +2926,9 @@ declare class SessionManager {
     private histories;
     private idleTimeoutMs;
     private defaultModels;
+    private synopsisAgent?;
+    private synopsisModel?;
+    private synopsisOnClose;
     readonly defaultTransformers: string[];
     private idleEventTimeoutMs;
     private sessionHistoryMaxEntries;
@@ -2721,6 +2936,7 @@ declare class SessionManager {
     private logger?;
     private npmRegistry?;
     private extensionCommands?;
+    private synopsisCoordinator;
     constructor(registry: Registry, spawner?: AgentSpawner, store?: SessionStore, options?: SessionManagerOptions);
     create(params: CreateSessionParams): Promise<Session>;
     resurrect(params: ResurrectParams): Promise<Session>;
@@ -2776,61 +2992,22 @@ declare class SessionManager {
     hasRecord(sessionId: string): Promise<boolean>;
     setTitle(sessionId: string, title: string): Promise<boolean>;
     private persistTitle;
+    private persistSynopsis;
     private persistAgentChange;
     private persistSnapshot;
     private enqueueMetaWrite;
     closeAll(): Promise<void>;
+    flushSynopsis(timeoutMs: number): Promise<void>;
+    shutdownSynopsis(): Promise<void>;
+    scheduleSynopsis(sessionId: string): void;
     flushMetaWrites(): Promise<void>;
     flushHistoryWrites(): Promise<void>;
     resurrectPendingQueues(): Promise<void>;
 }
 
-interface ExtensionContext {
-    daemonUrl: string;
-    daemonHost: string;
-    daemonPort: number;
-    serviceToken: string;
-    daemonWsUrl: string;
-    hydraHome: string;
-}
-type ExtensionStatus = "running" | "stopped" | "restarting" | "disabled";
-interface ExtensionInfo {
-    name: string;
-    status: ExtensionStatus;
-    pid: number | undefined;
-    enabled: boolean;
-    restartCount: number;
-    startedAt: number | undefined;
-    lastExitCode: number | undefined;
-    logPath: string;
-    version: string | undefined;
-}
-declare class ExtensionManager {
-    private entries;
-    private stopping;
-    private context;
-    private tokenRegistry;
-    constructor(extensions: ExtensionConfig[], context?: ExtensionContext, options?: {
-        tokenRegistry?: ProcessTokenRegistry;
-    });
-    setContext(context: ExtensionContext): void;
-    reportVersion(name: string, version: string): void;
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    list(): ExtensionInfo[];
-    get(name: string): ExtensionInfo | undefined;
-    has(name: string): boolean;
-    startByName(name: string): Promise<ExtensionInfo>;
-    stopByName(name: string): Promise<ExtensionInfo>;
-    restartByName(name: string): Promise<ExtensionInfo>;
-    register(config: ExtensionConfig): ExtensionInfo;
-    unregister(name: string): Promise<void>;
-    private terminate;
-    private infoFor;
-    private makeEntry;
-    private reapOrphans;
-    private spawn;
-    private scheduleRestart;
+type ExtensionContext = BaseChildContext;
+declare class ExtensionManager extends ChildSupervisor<ExtensionConfig> {
+    constructor(extensions: ExtensionConfig[], context?: ExtensionContext, options?: ChildSupervisorOptions);
 }
 
 interface TokenReservation {
@@ -2910,6 +3087,7 @@ declare const paths: {
     currentLogFile: () => string;
     registryCache: () => string;
     agentsDir: () => string;
+    agentLogFile: (id: string) => string;
     agentInstallDir: (id: string, platformKey: string, version: string) => string;
     agentNpmInstallDir: (id: string, platformKey: string, version: string) => string;
     sessionsDir: () => string;