@hydra-acp/cli 0.1.22 → 0.1.24

package/dist/index.d.ts

@@ -24,10 +24,9 @@ type ExtensionConfig = ExtensionBody & {
     name: string;
 };
 declare const HydraConfig: z.ZodObject<{
-    daemon: z.ZodObject<{
+    daemon: z.ZodDefault<z.ZodObject<{
         host: z.ZodDefault<z.ZodString>;
         port: z.ZodDefault<z.ZodNumber>;
-        authToken: z.ZodString;
         logLevel: z.ZodDefault<z.ZodEnum<["debug", "info", "warn", "error"]>>;
         tls: z.ZodOptional<z.ZodObject<{
             cert: z.ZodString;
@@ -45,7 +44,6 @@ declare const HydraConfig: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         host: string;
         port: number;
-        authToken: string;
         logLevel: "info" | "debug" | "warn" | "error";
         sessionIdleTimeoutSeconds: number;
         sessionHistoryMaxEntries: number;
@@ -55,7 +53,6 @@ declare const HydraConfig: z.ZodObject<{
             key: string;
         } | undefined;
     }, {
-        authToken: string;
         host?: string | undefined;
         port?: number | undefined;
         logLevel?: "info" | "debug" | "warn" | "error" | undefined;
@@ -66,7 +63,7 @@ declare const HydraConfig: z.ZodObject<{
         sessionIdleTimeoutSeconds?: number | undefined;
         sessionHistoryMaxEntries?: number | undefined;
         agentStderrTailBytes?: number | undefined;
-    }>;
+    }>>;
     registry: z.ZodDefault<z.ZodObject<{
         url: z.ZodDefault<z.ZodString>;
         ttlHours: z.ZodDefault<z.ZodNumber>;
@@ -97,6 +94,7 @@ declare const HydraConfig: z.ZodObject<{
         env?: Record<string, string> | undefined;
         enabled?: boolean | undefined;
     }>>>;
+    npmRegistry: z.ZodOptional<z.ZodString>;
     tui: z.ZodDefault<z.ZodObject<{
         repaintThrottleMs: z.ZodDefault<z.ZodNumber>;
         maxScrollbackLines: z.ZodDefault<z.ZodNumber>;
@@ -123,7 +121,6 @@ declare const HydraConfig: z.ZodObject<{
     daemon: {
         host: string;
         port: number;
-        authToken: string;
         logLevel: "info" | "debug" | "warn" | "error";
         sessionIdleTimeoutSeconds: number;
         sessionHistoryMaxEntries: number;
@@ -155,9 +152,9 @@ declare const HydraConfig: z.ZodObject<{
     defaultModels: Record<string, string>;
     defaultCwd: string;
     sessionListColdLimit: number;
+    npmRegistry?: string | undefined;
 }, {
-    daemon: {
-        authToken: string;
+    daemon?: {
         host?: string | undefined;
         port?: number | undefined;
         logLevel?: "info" | "debug" | "warn" | "error" | undefined;
@@ -168,7 +165,7 @@ declare const HydraConfig: z.ZodObject<{
         sessionIdleTimeoutSeconds?: number | undefined;
         sessionHistoryMaxEntries?: number | undefined;
         agentStderrTailBytes?: number | undefined;
-    };
+    } | undefined;
     extensions?: Record<string, {
         command?: string[] | undefined;
         args?: string[] | undefined;
@@ -191,12 +188,11 @@ declare const HydraConfig: z.ZodObject<{
     defaultModels?: Record<string, string> | undefined;
     defaultCwd?: string | undefined;
     sessionListColdLimit?: number | undefined;
+    npmRegistry?: string | undefined;
 }>;
 type HydraConfig = z.infer<typeof HydraConfig>;
 declare function loadConfig(): Promise<HydraConfig>;
-declare function ensureConfig(): Promise<HydraConfig>;
 declare function writeConfig(config: HydraConfig): Promise<void>;
-declare function generateAuthToken(): string;
 declare function defaultConfig(): HydraConfig;
 
 declare const RegistryAgent: z.ZodObject<{
@@ -1207,10 +1203,14 @@ declare const RegistryDocument: z.ZodObject<{
     extensions?: unknown[] | undefined;
 }>;
 type RegistryDocument = z.infer<typeof RegistryDocument>;
+interface RegistryOptions {
+    onFetched?: (doc: RegistryDocument) => void | Promise<void>;
+}
 declare class Registry {
     private config;
+    private options;
     private cache;
-    constructor(config: HydraConfig);
+    constructor(config: HydraConfig, options?: RegistryOptions);
     load(): Promise<RegistryDocument>;
     refresh(): Promise<RegistryDocument>;
     getAgent(id: string): Promise<RegistryAgent | undefined>;
@@ -1223,8 +1223,11 @@ interface SpawnPlan {
     command: string;
     args: string[];
     env: Record<string, string>;
+    version: string;
 }
-declare function planSpawn(agent: RegistryAgent, callerArgs?: string[]): Promise<SpawnPlan>;
+declare function planSpawn(agent: RegistryAgent, callerArgs?: string[], options?: {
+    npmRegistry?: string;
+}): Promise<SpawnPlan>;
 
 type JsonRpcId = string | number;
 interface JsonRpcRequest {
@@ -1290,6 +1293,18 @@ declare const SessionAttachParams: z.ZodObject<{
     _meta?: Record<string, unknown> | undefined;
 }>;
 type SessionAttachParams = z.infer<typeof SessionAttachParams>;
+interface PromptOriginator {
+    clientId: string;
+    name?: string;
+    version?: string;
+}
+interface PromptQueueEntry {
+    messageId: string;
+    originator: PromptOriginator;
+    prompt: unknown[];
+    position: number;
+    enqueuedAt: number;
+}
 declare const SessionDetachParams: z.ZodObject<{
     sessionId: z.ZodString;
 }, "strip", z.ZodTypeAny, {
@@ -1497,6 +1512,28 @@ declare const SessionListResult: z.ZodObject<{
     nextCursor?: string | undefined;
 }>;
 type SessionListResult = z.infer<typeof SessionListResult>;
+declare const CancelPromptResult: z.ZodObject<{
+    cancelled: z.ZodBoolean;
+    reason: z.ZodEnum<["ok", "not_found", "already_running"]>;
+}, "strip", z.ZodTypeAny, {
+    reason: "ok" | "not_found" | "already_running";
+    cancelled: boolean;
+}, {
+    reason: "ok" | "not_found" | "already_running";
+    cancelled: boolean;
+}>;
+type CancelPromptResult = z.infer<typeof CancelPromptResult>;
+declare const UpdatePromptResult: z.ZodObject<{
+    updated: z.ZodBoolean;
+    reason: z.ZodEnum<["ok", "not_found", "already_running"]>;
+}, "strip", z.ZodTypeAny, {
+    reason: "ok" | "not_found" | "already_running";
+    updated: boolean;
+}, {
+    reason: "ok" | "not_found" | "already_running";
+    updated: boolean;
+}>;
+type UpdatePromptResult = z.infer<typeof UpdatePromptResult>;
 interface SessionCapabilities {
     attach?: Record<string, never>;
     list?: boolean;
@@ -1527,6 +1564,7 @@ interface InitializeResult {
         id: string;
         description: string;
     }>;
+    _meta?: Record<string, unknown>;
 }
 
 interface MessageStream {
@@ -1585,6 +1623,7 @@ interface AgentLogger {
 }
 declare class AgentInstance {
     readonly agentId: string;
+    readonly version: string;
     readonly cwd: string;
     readonly connection: JsonRpcConnection;
     private child;
@@ -1606,6 +1645,11 @@ interface AdvertisedCommand {
     name: string;
     description?: string;
 }
+interface AdvertisedMode {
+    id: string;
+    name?: string;
+    description?: string;
+}
 
 interface HistoryEntry {
     method: string;
@@ -1627,6 +1671,18 @@ declare class HistoryStore {
     private enqueue;
 }
 
+interface PersistedQueueEntry {
+    messageId: string;
+    originator: {
+        clientInfo: {
+            name?: string;
+            version?: string;
+        };
+    };
+    prompt: unknown[];
+    enqueuedAt: number;
+}
+
 interface AttachedClient {
     clientId: string;
     connection: JsonRpcConnection;
@@ -1674,6 +1730,7 @@ interface SessionInit {
     currentMode?: string;
     currentUsage?: UsageSnapshot;
     agentCommands?: AdvertisedCommand[];
+    agentModes?: AdvertisedMode[];
     firstPromptSeeded?: boolean;
     createdAt?: number;
 }
@@ -1699,7 +1756,9 @@ declare class Session {
     private clients;
     private historyStore;
     private promptQueue;
+    private currentEntry;
     private promptInFlight;
+    private queueWriteChain;
     private closed;
     private closeHandlers;
     private titleHandlers;
@@ -1718,12 +1777,15 @@ declare class Session {
     private logger;
     private agentChangeHandlers;
     private agentAdvertisedCommands;
+    private agentAdvertisedModes;
     private agentCommandsHandlers;
+    private agentModesHandlers;
     private modelHandlers;
     private modeHandlers;
     private usageHandlers;
     constructor(init: SessionInit);
     private broadcastMergedCommands;
+    private broadcastAvailableModes;
     private wireAgent;
     onAgentChange(handler: (info: {
         agentId: string;
@@ -1752,6 +1814,16 @@ declare class Session {
     prompt(clientId: string, params: unknown): Promise<unknown>;
     private broadcastPromptReceived;
     private broadcastTurnComplete;
+    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;
     cancel(clientId: string): Promise<void>;
     forwardRequest(method: string, params: unknown): Promise<unknown>;
     private rewriteForAgent;
@@ -1766,12 +1838,15 @@ declare class Session {
     private maybeApplyAgentMode;
     private maybeApplyAgentUsage;
     private setAgentAdvertisedCommands;
+    private setAgentAdvertisedModes;
     onAgentCommandsChange(handler: (commands: AdvertisedCommand[]) => void): void;
+    onAgentModesChange(handler: (modes: AdvertisedMode[]) => void): void;
     onModelChange(handler: (model: string) => void): void;
     onModeChange(handler: (mode: string) => void): void;
     onUsageChange(handler: (usage: UsageSnapshot) => void): void;
     mergedAvailableCommands(): AdvertisedCommand[];
     agentOnlyAdvertisedCommands(): AdvertisedCommand[];
+    availableModes(): AdvertisedMode[];
     private maybeApplyAgentSessionInfo;
     private handleSlashCommand;
     private runTitleCommand;
@@ -1792,7 +1867,11 @@ declare class Session {
     private recordAndBroadcast;
     private handlePermissionRequest;
     private enqueuePrompt;
+    private enqueueUserPrompt;
+    private persistRewrite;
+    private persistedFromEntry;
     private drainQueue;
+    private runQueueEntry;
 }
 
 declare const SessionRecord: z.ZodObject<{
@@ -1835,6 +1914,19 @@ declare const SessionRecord: z.ZodObject<{
         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">>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
@@ -1863,6 +1955,11 @@ declare const SessionRecord: z.ZodObject<{
         name: string;
         description?: string | undefined;
     }[] | undefined;
+    agentModes?: {
+        id: string;
+        name?: string | undefined;
+        description?: string | undefined;
+    }[] | undefined;
 }, {
     version: 1;
     cwd: string;
@@ -1889,6 +1986,11 @@ declare const SessionRecord: z.ZodObject<{
         name: string;
         description?: string | undefined;
     }[] | undefined;
+    agentModes?: {
+        id: string;
+        name?: string | undefined;
+        description?: string | undefined;
+    }[] | undefined;
 }>;
 type SessionRecord = z.infer<typeof SessionRecord>;
 declare class SessionStore {
@@ -1947,6 +2049,19 @@ declare const Bundle: z.ZodObject<{
             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">>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
     }, "strip", z.ZodTypeAny, {
@@ -1970,6 +2085,11 @@ declare const Bundle: z.ZodObject<{
             name: string;
             description?: string | undefined;
         }[] | undefined;
+        agentModes?: {
+            id: string;
+            name?: string | undefined;
+            description?: string | undefined;
+        }[] | undefined;
     }, {
         cwd: string;
         agentId: string;
@@ -1991,6 +2111,11 @@ declare const Bundle: z.ZodObject<{
             name: string;
             description?: string | undefined;
         }[] | undefined;
+        agentModes?: {
+            id: string;
+            name?: string | undefined;
+            description?: string | undefined;
+        }[] | undefined;
     }>;
     history: z.ZodArray<z.ZodObject<{
         method: z.ZodString;
@@ -2008,11 +2133,6 @@ declare const Bundle: z.ZodObject<{
     promptHistory: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     version: 1;
-    exportedAt: string;
-    exportedFrom: {
-        hydraVersion: string;
-        machine: string;
-    };
     session: {
         cwd: string;
         agentId: string;
@@ -2034,6 +2154,16 @@ declare const Bundle: z.ZodObject<{
             name: string;
             description?: string | undefined;
         }[] | undefined;
+        agentModes?: {
+            id: string;
+            name?: string | undefined;
+            description?: string | undefined;
+        }[] | undefined;
+    };
+    exportedAt: string;
+    exportedFrom: {
+        hydraVersion: string;
+        machine: string;
     };
     history: {
         method: string;
@@ -2043,11 +2173,6 @@ declare const Bundle: z.ZodObject<{
     promptHistory?: string[] | undefined;
 }, {
     version: 1;
-    exportedAt: string;
-    exportedFrom: {
-        hydraVersion: string;
-        machine: string;
-    };
     session: {
         cwd: string;
         agentId: string;
@@ -2069,6 +2194,16 @@ declare const Bundle: z.ZodObject<{
             name: string;
             description?: string | undefined;
         }[] | undefined;
+        agentModes?: {
+            id: string;
+            name?: string | undefined;
+            description?: string | undefined;
+        }[] | undefined;
+    };
+    exportedAt: string;
+    exportedFrom: {
+        hydraVersion: string;
+        machine: string;
     };
     history: {
         method: string;
@@ -2098,6 +2233,7 @@ interface ResurrectParams {
     currentMode?: string;
     currentUsage?: UsageSnapshot;
     agentCommands?: AdvertisedCommand[];
+    agentModes?: AdvertisedMode[];
     createdAt?: string;
 }
 type AgentSpawner = (opts: AgentInstanceOptions) => AgentInstance;
@@ -2106,6 +2242,7 @@ interface SessionManagerOptions {
     defaultModels?: Record<string, string>;
     sessionHistoryMaxEntries?: number;
     logger?: AgentLogger;
+    npmRegistry?: string;
 }
 declare class SessionManager {
     private registry;
@@ -2119,6 +2256,7 @@ declare class SessionManager {
     private sessionHistoryMaxEntries;
     private metaWriteQueues;
     private logger?;
+    private npmRegistry?;
     constructor(registry: Registry, spawner?: AgentSpawner, store?: SessionStore, options?: SessionManagerOptions);
     create(params: CreateSessionParams): Promise<Session>;
     resurrect(params: ResurrectParams): Promise<Session>;
@@ -2131,6 +2269,7 @@ declare class SessionManager {
     loadFromDisk(sessionId: string): Promise<ResurrectParams | undefined>;
     private deriveTitleFromHistory;
     get(sessionId: string): Session | undefined;
+    activeAgentVersions(): Map<string, Set<string>>;
     resolveCanonicalId(input: string): Promise<string | undefined>;
     require(sessionId: string): Session;
     list(filter?: {
@@ -2160,13 +2299,14 @@ declare class SessionManager {
     private enqueueMetaWrite;
     closeAll(): Promise<void>;
     flushMetaWrites(): Promise<void>;
+    resurrectPendingQueues(): Promise<void>;
 }
 
 interface ExtensionContext {
     daemonUrl: string;
     daemonHost: string;
     daemonPort: number;
-    daemonToken: string;
+    serviceToken: string;
     daemonWsUrl: string;
     hydraHome: string;
 }
@@ -2217,10 +2357,14 @@ interface DaemonHandle {
     extensions: ExtensionManager;
     shutdown: () => Promise<void>;
 }
-declare function startDaemon(config: HydraConfig): Promise<DaemonHandle>;
+declare function startDaemon(config: HydraConfig, serviceToken: string): Promise<DaemonHandle>;
 
 declare function wsToMessageStream(ws: WebSocket): MessageStream;
 
+declare function generateServiceToken(): string;
+declare function loadServiceToken(): Promise<string>;
+declare function ensureServiceToken(): Promise<string>;
+
 declare function hydraHome(): string;
 declare const paths: {
     home: typeof hydraHome;
@@ -2237,6 +2381,7 @@ declare const paths: {
     sessionDir: (id: string) => string;
     sessionFile: (id: string) => string;
     historyFile: (id: string) => string;
+    queueFile: (id: string) => string;
     extensionsDir: () => string;
     extensionLogFile: (name: string) => string;
     extensionPidFile: (name: string) => string;
@@ -2244,4 +2389,4 @@ declare const paths: {
     tuiLogFile: () => string;
 };
 
-export { type AgentCapabilities, AgentInstance, HistoryPolicy, HydraConfig, type InitializeResult, JsonRpcConnection, type MessageStream, Registry, Session, SessionAttachParams, type SessionCapabilities, SessionDetachParams, SessionListEntry, SessionListParams, SessionListResult, SessionManager, defaultConfig, ensureConfig, generateAuthToken, loadConfig, ndjsonStreamFromStdio, paths, planSpawn, startDaemon, writeConfig, wsToMessageStream };
+export { type AgentCapabilities, AgentInstance, HistoryPolicy, HydraConfig, type InitializeResult, JsonRpcConnection, type MessageStream, Registry, Session, SessionAttachParams, type SessionCapabilities, SessionDetachParams, SessionListEntry, SessionListParams, SessionListResult, SessionManager, defaultConfig, ensureServiceToken, generateServiceToken, loadConfig, loadServiceToken, ndjsonStreamFromStdio, paths, planSpawn, startDaemon, writeConfig, wsToMessageStream };