@hydra-acp/cli 0.1.60 → 0.1.62

package/dist/index.d.ts

@@ -95,13 +95,42 @@ declare const HydraConfig: z.ZodObject<{
     registry: z.ZodDefault<z.ZodObject<{
         url: z.ZodDefault<z.ZodString>;
         ttlHours: z.ZodDefault<z.ZodNumber>;
+        pinned: z.ZodDefault<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         url: string;
         ttlHours: number;
+        pinned: boolean;
     }, {
         url?: string | undefined;
         ttlHours?: number | undefined;
+        pinned?: boolean | undefined;
     }>>;
+    agents: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        command: z.ZodOptional<z.ZodString>;
+        args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        name?: string | undefined;
+        args?: string[] | undefined;
+        command?: string | undefined;
+        env?: Record<string, string> | undefined;
+        description?: string | undefined;
+    }, {
+        name?: string | undefined;
+        args?: string[] | undefined;
+        command?: string | undefined;
+        env?: Record<string, string> | undefined;
+        description?: string | undefined;
+    }>>>;
+    agentOverrides: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        packageSpec: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        packageSpec?: string | undefined;
+    }, {
+        packageSpec?: string | undefined;
+    }>>>;
     defaultAgent: z.ZodDefault<z.ZodString>;
     defaultModels: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
     synopsisAgent: z.ZodOptional<z.ZodString>;
@@ -228,10 +257,21 @@ declare const HydraConfig: z.ZodObject<{
         env: Record<string, string>;
         enabled: boolean;
     }>;
+    agents: Record<string, {
+        name?: string | undefined;
+        args?: string[] | undefined;
+        command?: string | undefined;
+        env?: Record<string, string> | undefined;
+        description?: string | undefined;
+    }>;
     registry: {
         url: string;
         ttlHours: number;
+        pinned: boolean;
     };
+    agentOverrides: Record<string, {
+        packageSpec?: string | undefined;
+    }>;
     defaultAgent: string;
     defaultModels: Record<string, string>;
     synopsisOnClose: boolean;
@@ -283,10 +323,21 @@ declare const HydraConfig: z.ZodObject<{
         env?: Record<string, string> | undefined;
         enabled?: boolean | undefined;
     }> | undefined;
+    agents?: Record<string, {
+        name?: string | undefined;
+        args?: string[] | undefined;
+        command?: string | undefined;
+        env?: Record<string, string> | undefined;
+        description?: string | undefined;
+    }> | undefined;
     registry?: {
         url?: string | undefined;
         ttlHours?: number | undefined;
+        pinned?: boolean | undefined;
     } | undefined;
+    agentOverrides?: Record<string, {
+        packageSpec?: string | undefined;
+    }> | undefined;
     defaultAgent?: string | undefined;
     defaultModels?: Record<string, string> | undefined;
     synopsisAgent?: string | undefined;
@@ -558,6 +609,19 @@ declare const RegistryAgent: z.ZodObject<{
             args?: string[] | undefined;
             env?: Record<string, string> | undefined;
         }>>;
+        exec: z.ZodOptional<z.ZodObject<{
+            command: z.ZodString;
+            args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            command: string;
+            args?: string[] | undefined;
+            env?: Record<string, string> | undefined;
+        }, {
+            command: string;
+            args?: string[] | undefined;
+            env?: Record<string, string> | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
         binary?: {
             "darwin-aarch64"?: {
@@ -608,6 +672,11 @@ declare const RegistryAgent: z.ZodObject<{
             args?: string[] | undefined;
             env?: Record<string, string> | undefined;
         } | undefined;
+        exec?: {
+            command: string;
+            args?: string[] | undefined;
+            env?: Record<string, string> | undefined;
+        } | undefined;
     }, {
         binary?: {
             "darwin-aarch64"?: {
@@ -658,6 +727,11 @@ declare const RegistryAgent: z.ZodObject<{
             args?: string[] | undefined;
             env?: Record<string, string> | undefined;
         } | undefined;
+        exec?: {
+            command: string;
+            args?: string[] | undefined;
+            env?: Record<string, string> | undefined;
+        } | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
     name: string;
@@ -712,6 +786,11 @@ declare const RegistryAgent: z.ZodObject<{
             args?: string[] | undefined;
             env?: Record<string, string> | undefined;
         } | undefined;
+        exec?: {
+            command: string;
+            args?: string[] | undefined;
+            env?: Record<string, string> | undefined;
+        } | undefined;
     };
     version?: string | undefined;
     description?: string | undefined;
@@ -773,6 +852,11 @@ declare const RegistryAgent: z.ZodObject<{
             args?: string[] | undefined;
             env?: Record<string, string> | undefined;
         } | undefined;
+        exec?: {
+            command: string;
+            args?: string[] | undefined;
+            env?: Record<string, string> | undefined;
+        } | undefined;
     };
     version?: string | undefined;
     description?: string | undefined;
@@ -997,6 +1081,19 @@ declare const RegistryDocument: z.ZodObject<{
                 args?: string[] | undefined;
                 env?: Record<string, string> | undefined;
             }>>;
+            exec: z.ZodOptional<z.ZodObject<{
+                command: z.ZodString;
+                args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, "strip", z.ZodTypeAny, {
+                command: string;
+                args?: string[] | undefined;
+                env?: Record<string, string> | undefined;
+            }, {
+                command: string;
+                args?: string[] | undefined;
+                env?: Record<string, string> | undefined;
+            }>>;
         }, "strip", z.ZodTypeAny, {
             binary?: {
                 "darwin-aarch64"?: {
@@ -1047,6 +1144,11 @@ declare const RegistryDocument: z.ZodObject<{
                 args?: string[] | undefined;
                 env?: Record<string, string> | undefined;
             } | undefined;
+            exec?: {
+                command: string;
+                args?: string[] | undefined;
+                env?: Record<string, string> | undefined;
+            } | undefined;
         }, {
             binary?: {
                 "darwin-aarch64"?: {
@@ -1097,6 +1199,11 @@ declare const RegistryDocument: z.ZodObject<{
                 args?: string[] | undefined;
                 env?: Record<string, string> | undefined;
             } | undefined;
+            exec?: {
+                command: string;
+                args?: string[] | undefined;
+                env?: Record<string, string> | undefined;
+            } | undefined;
         }>;
     }, "strip", z.ZodTypeAny, {
         name: string;
@@ -1151,6 +1258,11 @@ declare const RegistryDocument: z.ZodObject<{
                 args?: string[] | undefined;
                 env?: Record<string, string> | undefined;
             } | undefined;
+            exec?: {
+                command: string;
+                args?: string[] | undefined;
+                env?: Record<string, string> | undefined;
+            } | undefined;
         };
         version?: string | undefined;
         description?: string | undefined;
@@ -1212,6 +1324,11 @@ declare const RegistryDocument: z.ZodObject<{
                 args?: string[] | undefined;
                 env?: Record<string, string> | undefined;
             } | undefined;
+            exec?: {
+                command: string;
+                args?: string[] | undefined;
+                env?: Record<string, string> | undefined;
+            } | undefined;
         };
         version?: string | undefined;
         description?: string | undefined;
@@ -1277,6 +1394,11 @@ declare const RegistryDocument: z.ZodObject<{
                 args?: string[] | undefined;
                 env?: Record<string, string> | undefined;
             } | undefined;
+            exec?: {
+                command: string;
+                args?: string[] | undefined;
+                env?: Record<string, string> | undefined;
+            } | undefined;
         };
         version?: string | undefined;
         description?: string | undefined;
@@ -1342,6 +1464,11 @@ declare const RegistryDocument: z.ZodObject<{
                 args?: string[] | undefined;
                 env?: Record<string, string> | undefined;
             } | undefined;
+            exec?: {
+                command: string;
+                args?: string[] | undefined;
+                env?: Record<string, string> | undefined;
+            } | undefined;
         };
         version?: string | undefined;
         description?: string | undefined;
@@ -1366,6 +1493,9 @@ declare class Registry {
     refresh(): Promise<RegistryDocument>;
     lastFetchedAt(): number | undefined;
     getAgent(id: string): Promise<RegistryAgent | undefined>;
+    localAgents(): RegistryAgent[];
+    private applyOverride;
+    private isPinned;
     private isFresh;
     private fetchFromNetwork;
     private readDiskCache;
@@ -1423,36 +1553,27 @@ declare const SessionAttachParams: z.ZodObject<{
         name: string;
         version?: string | undefined;
     }>>;
-    readonly: z.ZodOptional<z.ZodBoolean>;
-    replayMode: z.ZodOptional<z.ZodEnum<["instant", "drip"]>>;
-    dripSpeed: z.ZodOptional<z.ZodNumber>;
     _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
     sessionId: string;
     historyPolicy: "none" | "full" | "pending_only" | "after_message";
-    readonly?: boolean | undefined;
     clientInfo?: {
         name: string;
         version?: string | undefined;
     } | undefined;
+    _meta?: Record<string, unknown> | undefined;
     afterMessageId?: string | undefined;
     clientId?: string | undefined;
-    replayMode?: "drip" | "instant" | undefined;
-    dripSpeed?: number | undefined;
-    _meta?: Record<string, unknown> | undefined;
 }, {
     sessionId: string;
-    readonly?: boolean | undefined;
     clientInfo?: {
         name: string;
         version?: string | undefined;
     } | undefined;
+    _meta?: Record<string, unknown> | undefined;
     historyPolicy?: "none" | "full" | "pending_only" | "after_message" | undefined;
     afterMessageId?: string | undefined;
     clientId?: string | undefined;
-    replayMode?: "drip" | "instant" | undefined;
-    dripSpeed?: number | undefined;
-    _meta?: Record<string, unknown> | undefined;
 }>;
 type SessionAttachParams = z.infer<typeof SessionAttachParams>;
 interface PromptOriginator {
@@ -1535,14 +1656,14 @@ declare const SessionListEntry: z.ZodObject<{
     sessionId: string;
     cwd: string;
     status: "live" | "cold";
-    updatedAt: string;
-    attachedClients: number;
     busy: boolean;
     awaitingInput: boolean;
+    attachedClients: number;
+    updatedAt: string;
     title?: string | undefined;
-    agentId?: string | undefined;
-    upstreamSessionId?: string | undefined;
     _meta?: Record<string, unknown> | undefined;
+    upstreamSessionId?: string | undefined;
+    agentId?: string | undefined;
     currentModel?: string | undefined;
     currentUsage?: {
         used?: number | undefined;
@@ -1563,13 +1684,13 @@ declare const SessionListEntry: z.ZodObject<{
 }, {
     sessionId: string;
     cwd: string;
-    updatedAt: string;
     attachedClients: number;
+    updatedAt: string;
     status?: "live" | "cold" | undefined;
     title?: string | undefined;
-    agentId?: string | undefined;
-    upstreamSessionId?: string | undefined;
     _meta?: Record<string, unknown> | undefined;
+    upstreamSessionId?: string | undefined;
+    agentId?: string | undefined;
     currentModel?: string | undefined;
     currentUsage?: {
         used?: number | undefined;
@@ -1578,6 +1699,8 @@ declare const SessionListEntry: z.ZodObject<{
         costCurrency?: string | undefined;
     } | undefined;
     interactive?: boolean | undefined;
+    busy?: boolean | undefined;
+    awaitingInput?: boolean | undefined;
     importedFromMachine?: string | undefined;
     importedFromUpstreamSessionId?: string | undefined;
     parentSessionId?: string | undefined;
@@ -1587,8 +1710,6 @@ declare const SessionListEntry: z.ZodObject<{
         name: string;
         version?: string | undefined;
     } | undefined;
-    busy?: boolean | undefined;
-    awaitingInput?: boolean | undefined;
 }>;
 type SessionListEntry = z.infer<typeof SessionListEntry>;
 declare const SessionListResult: z.ZodObject<{
@@ -1741,12 +1862,18 @@ declare class JsonRpcConnection {
     private pending;
     private closed;
     private closeHandlers;
+    private orphanErrorHandlers;
     constructor(stream: MessageStream);
     onRequest(method: string, handler: RequestHandler): void;
     setDefaultHandler(handler: RequestHandler): void;
     onNotification(method: string, handler: NotificationHandler): void;
     drainBuffered(method: string): number;
     onClose(handler: (err?: Error) => void): void;
+    onOrphanError(handler: (error: {
+        code?: number;
+        message: string;
+        data?: unknown;
+    }) => void): void;
     request<T = unknown>(method: string, params?: unknown): Promise<T>;
     requestWithId<T = unknown>(method: string, params?: unknown): {
         id: JsonRpcId;
@@ -1984,6 +2111,20 @@ interface AdvertisedModel {
     name?: string;
     description?: string;
 }
+interface ConfigOptionValue {
+    value: string;
+    name: string;
+    description?: string;
+}
+interface ConfigOption {
+    id: string;
+    name: string;
+    description?: string;
+    category?: string;
+    type: "select";
+    currentValue: string;
+    options: ConfigOptionValue[];
+}
 
 interface ExtensionCommandSpec {
     verb: string;
@@ -2062,6 +2203,10 @@ interface SpawnReplacementAgentResult {
     upstreamSessionId: string;
     agentMeta?: Record<string, unknown>;
     agentCapabilities?: AgentCapabilities;
+    initialModel?: string;
+    initialModels?: AdvertisedModel[];
+    initialMode?: string;
+    initialModes?: AdvertisedMode[];
 }
 type SpawnReplacementAgent = (params: SpawnReplacementAgentParams) => Promise<SpawnReplacementAgentResult>;
 interface UsageSnapshot {
@@ -2116,6 +2261,11 @@ interface SessionInit {
         currentModel?: string;
     }[]>;
     extensionCommands?: ExtensionCommandRegistry;
+    availableAgents?: () => Array<{
+        id: string;
+        name?: string;
+        description?: string;
+    }>;
 }
 interface CloseOptions {
     deleteRecord?: boolean;
@@ -2157,6 +2307,9 @@ declare class Session {
     private titleHandlers;
     private scheduleSynopsisHook?;
     private broadcastHandlers;
+    private lastCancelAt;
+    private static readonly CANCEL_ERROR_WINDOW_MS;
+    private forceCancelling;
     private _firstPromptSeeded;
     get firstPromptSeeded(): boolean;
     private promptStartedAt;
@@ -2184,6 +2337,7 @@ declare class Session {
     private agentCommandsHandlers;
     private agentModesHandlers;
     private agentModelsHandlers;
+    private availableAgentsFn?;
     private modelHandlers;
     private modeHandlers;
     private interactiveHandlers;
@@ -2199,6 +2353,7 @@ declare class Session {
     private broadcastAvailableModes;
     private broadcastAvailableModels;
     private wireAgent;
+    private handleOrphanError;
     private runResponseChain;
     onAgentChange(handler: (info: {
         agentId: string;
@@ -2280,6 +2435,9 @@ declare class Session {
     onInteractiveChange(handler: (interactive: boolean) => void): 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[];
@@ -2295,9 +2453,14 @@ declare class Session {
     private handleModeCommand;
     private runTitleCommand;
     private runInternalPrompt;
+    setAgent(newAgentId: string): Promise<unknown>;
     private runAgentCommand;
     private runKillCommand;
     private runRestartCommand;
+    forceCancel(): Promise<{
+        stopReason: string;
+    }>;
+    private respawnAgent;
     private buildSwitchTranscript;
     seedFromImport(): Promise<void>;
     private broadcastAgentSwitch;
@@ -2501,8 +2664,8 @@ declare const SessionRecord: z.ZodObject<{
     sessionId: string;
     version: 1;
     cwd: string;
-    agentId: string;
     upstreamSessionId: string;
+    agentId: string;
     updatedAt: string;
     createdAt: string;
     title?: string | undefined;
@@ -2556,8 +2719,8 @@ declare const SessionRecord: z.ZodObject<{
     sessionId: string;
     version: 1;
     cwd: string;
-    agentId: string;
     upstreamSessionId: string;
+    agentId: string;
     updatedAt: string;
     createdAt: string;
     title?: string | undefined;
@@ -2617,6 +2780,44 @@ declare class SessionStore {
     list(): Promise<SessionRecord[]>;
 }
 
+declare const Tombstone: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    agentId: z.ZodString;
+    upstreamSessionId: z.ZodString;
+    deletedAt: z.ZodString;
+    upstreamUpdatedAt: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    reason: z.ZodOptional<z.ZodEnum<["user", "expired"]>>;
+}, "strip", z.ZodTypeAny, {
+    version: 1;
+    upstreamSessionId: string;
+    agentId: string;
+    deletedAt: string;
+    cwd?: string | undefined;
+    title?: string | undefined;
+    reason?: "user" | "expired" | undefined;
+    upstreamUpdatedAt?: string | undefined;
+}, {
+    version: 1;
+    upstreamSessionId: string;
+    agentId: string;
+    deletedAt: string;
+    cwd?: string | undefined;
+    title?: string | undefined;
+    reason?: "user" | "expired" | undefined;
+    upstreamUpdatedAt?: string | undefined;
+}>;
+type Tombstone = z.infer<typeof Tombstone>;
+declare class TombstoneStore {
+    add(t: Omit<Tombstone, "version">): Promise<void>;
+    has(agentId: string, upstreamSessionId: string): Promise<boolean>;
+    read(agentId: string, upstreamSessionId: string): Promise<Tombstone | undefined>;
+    remove(agentId: string, upstreamSessionId: string): Promise<void>;
+    list(agentId?: string): Promise<Tombstone[]>;
+    private listForAgent;
+}
+
 declare const Bundle: z.ZodObject<{
     version: z.ZodLiteral<1>;
     exportedAt: z.ZodString;
@@ -2988,6 +3189,7 @@ interface SessionManagerOptions {
     npmRegistry?: string;
     extensionCommands?: ExtensionCommandRegistry;
     defaultCwd?: string;
+    tombstones?: TombstoneStore;
 }
 declare class SessionManager {
     private registry;
@@ -2995,6 +3197,7 @@ declare class SessionManager {
     private resurrectionInflight;
     private spawner;
     private store;
+    private tombstones;
     private histories;
     private idleTimeoutMs;
     private defaultModels;
@@ -3010,7 +3213,9 @@ declare class SessionManager {
     private extensionCommands?;
     private defaultCwd;
     private synopsisCoordinator;
+    private agentCatalog;
     constructor(registry: Registry, spawner?: AgentSpawner, store?: SessionStore, options?: SessionManagerOptions);
+    private refreshAgentCatalog;
     create(params: CreateSessionParams): Promise<Session>;
     resurrect(params: ResurrectParams): Promise<Session>;
     private doResurrect;
@@ -3035,6 +3240,7 @@ declare class SessionManager {
     activeAgentVersions(): Map<string, Set<string>>;
     resolveCanonicalId(input: string): Promise<string | undefined>;
     require(sessionId: string): Session;
+    liveListEntry(session: Session): SessionListEntry;
     list(filter?: {
         cwd?: string;
         includeNonInteractive?: boolean;
@@ -3171,6 +3377,9 @@ declare const paths: {
     sessionFile: (id: string) => string;
     historyFile: (id: string) => string;
     queueFile: (id: string) => string;
+    tombstonesDir: () => string;
+    tombstoneAgentDir: (agentId: string) => string;
+    tombstoneFile: (agentId: string, upstreamSessionId: string) => string;
     extensionsDir: () => string;
     extensionLogFile: (name: string) => string;
     extensionPidFile: (name: string) => string;