@hydra-acp/cli 0.1.44 → 0.1.45

package/dist/index.d.ts

@@ -23,6 +23,26 @@ type ExtensionBody = z.infer<typeof ExtensionBody>;
 type ExtensionConfig = ExtensionBody & {
     name: string;
 };
+declare const TransformerBody: z.ZodObject<{
+    command: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    args: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    command: string[];
+    args: string[];
+    env: Record<string, string>;
+    enabled: boolean;
+}, {
+    command?: string[] | undefined;
+    args?: string[] | undefined;
+    env?: Record<string, string> | undefined;
+    enabled?: boolean | undefined;
+}>;
+type TransformerBody = z.infer<typeof TransformerBody>;
+type TransformerConfig = TransformerBody & {
+    name: string;
+};
 declare const HydraConfig: z.ZodObject<{
     daemon: z.ZodDefault<z.ZodObject<{
         host: z.ZodDefault<z.ZodString>;
@@ -97,6 +117,23 @@ declare const HydraConfig: z.ZodObject<{
         env?: Record<string, string> | undefined;
         enabled?: boolean | undefined;
     }>>>;
+    transformers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        command: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        args: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        enabled: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        command: string[];
+        args: string[];
+        env: Record<string, string>;
+        enabled: boolean;
+    }, {
+        command?: string[] | undefined;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+        enabled?: boolean | undefined;
+    }>>>;
+    defaultTransformers: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     npmRegistry: z.ZodOptional<z.ZodString>;
     tui: z.ZodDefault<z.ZodObject<{
         repaintThrottleMs: z.ZodDefault<z.ZodNumber>;
@@ -156,6 +193,12 @@ declare const HydraConfig: z.ZodObject<{
         env: Record<string, string>;
         enabled: boolean;
     }>;
+    transformers: Record<string, {
+        command: string[];
+        args: string[];
+        env: Record<string, string>;
+        enabled: boolean;
+    }>;
     registry: {
         url: string;
         ttlHours: number;
@@ -164,6 +207,7 @@ declare const HydraConfig: z.ZodObject<{
     defaultModels: Record<string, string>;
     defaultCwd: string;
     sessionListColdLimit: number;
+    defaultTransformers: string[];
     npmRegistry?: string | undefined;
 }, {
     tui?: {
@@ -195,6 +239,12 @@ declare const HydraConfig: z.ZodObject<{
         env?: Record<string, string> | undefined;
         enabled?: boolean | undefined;
     }> | undefined;
+    transformers?: Record<string, {
+        command?: string[] | undefined;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+        enabled?: boolean | undefined;
+    }> | undefined;
     registry?: {
         url?: string | undefined;
         ttlHours?: number | undefined;
@@ -203,6 +253,7 @@ declare const HydraConfig: z.ZodObject<{
     defaultModels?: Record<string, string> | undefined;
     defaultCwd?: string | undefined;
     sessionListColdLimit?: number | undefined;
+    defaultTransformers?: string[] | undefined;
     npmRegistry?: string | undefined;
 }>;
 type HydraConfig = z.infer<typeof HydraConfig>;
@@ -1412,6 +1463,7 @@ declare const SessionListEntry: z.ZodObject<{
     }>>;
     importedFromMachine: z.ZodOptional<z.ZodString>;
     importedFromUpstreamSessionId: z.ZodOptional<z.ZodString>;
+    parentSessionId: z.ZodOptional<z.ZodString>;
     updatedAt: z.ZodString;
     attachedClients: z.ZodNumber;
     status: z.ZodDefault<z.ZodEnum<["live", "cold"]>>;
@@ -1437,6 +1489,7 @@ declare const SessionListEntry: z.ZodObject<{
     } | undefined;
     importedFromMachine?: string | undefined;
     importedFromUpstreamSessionId?: string | undefined;
+    parentSessionId?: string | undefined;
 }, {
     sessionId: string;
     cwd: string;
@@ -1456,6 +1509,7 @@ declare const SessionListEntry: z.ZodObject<{
     } | undefined;
     importedFromMachine?: string | undefined;
     importedFromUpstreamSessionId?: string | undefined;
+    parentSessionId?: string | undefined;
     busy?: boolean | undefined;
 }>;
 type SessionListEntry = z.infer<typeof SessionListEntry>;
@@ -1663,6 +1717,83 @@ declare class AgentInstance {
     kill(signal?: NodeJS.Signals): Promise<void>;
 }
 
+interface TokenValidator {
+    validate(token: string): Promise<string | undefined>;
+}
+declare module "fastify" {
+    interface FastifyRequest {
+        authIdentity?: string;
+    }
+}
+interface ProcessIdentity {
+    name: string;
+    kind: "extension" | "transformer";
+}
+declare class ProcessTokenRegistry implements TokenValidator {
+    private tokens;
+    mint(name: string, kind: "extension" | "transformer"): string;
+    revoke(name: string): void;
+    resolve(token: string): ProcessIdentity | undefined;
+    validate(token: string): Promise<string | undefined>;
+}
+
+interface TransformerRef {
+    name: string;
+    intercepts: Set<string>;
+    connection: JsonRpcConnection;
+}
+interface TransformerContext {
+    daemonUrl: string;
+    daemonHost: string;
+    daemonPort: number;
+    serviceToken: string;
+    daemonWsUrl: string;
+    hydraHome: string;
+}
+type TransformerStatus = "running" | "stopped" | "restarting" | "disabled";
+interface TransformerInfo {
+    name: string;
+    status: TransformerStatus;
+    pid: number | undefined;
+    enabled: boolean;
+    restartCount: number;
+    startedAt: number | undefined;
+    lastExitCode: number | undefined;
+    logPath: string;
+    version: string | undefined;
+}
+declare class TransformerManager {
+    private entries;
+    private connected;
+    private stopping;
+    private context;
+    private tokenRegistry;
+    constructor(transformers: TransformerConfig[], context?: TransformerContext, options?: {
+        tokenRegistry?: ProcessTokenRegistry;
+    });
+    setContext(context: TransformerContext): 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;
+    has(name: string): boolean;
+    startByName(name: string): Promise<TransformerInfo>;
+    stopByName(name: string): Promise<TransformerInfo>;
+    restartByName(name: string): Promise<TransformerInfo>;
+    register(config: TransformerConfig): TransformerInfo;
+    unregister(name: string): Promise<void>;
+    private terminate;
+    private infoFor;
+    private makeEntry;
+    private reapOrphans;
+    private spawn;
+    private scheduleRestart;
+}
+
 interface AdvertisedCommand {
     name: string;
     description?: string;
@@ -1729,6 +1860,7 @@ interface SpawnReplacementAgentResult {
     agent: AgentInstance;
     upstreamSessionId: string;
     agentMeta?: Record<string, unknown>;
+    agentCapabilities?: AgentCapabilities;
 }
 type SpawnReplacementAgent = (params: SpawnReplacementAgentParams) => Promise<SpawnReplacementAgentResult>;
 interface UsageSnapshot {
@@ -1736,6 +1868,7 @@ interface UsageSnapshot {
     size?: number;
     costAmount?: number;
     costCurrency?: string;
+    cumulativeCost?: number;
 }
 interface SessionInit {
     cwd: string;
@@ -1745,6 +1878,7 @@ interface SessionInit {
     title?: string;
     sessionId?: string;
     agentMeta?: Record<string, unknown>;
+    agentCapabilities?: AgentCapabilities;
     agentArgs?: string[];
     idleTimeoutMs?: number;
     logger?: {
@@ -1762,6 +1896,9 @@ interface SessionInit {
     agentModels?: AdvertisedModel[];
     firstPromptSeeded?: boolean;
     createdAt?: number;
+    transformChain?: TransformerRef[];
+    idleEventTimeoutMs?: number;
+    parentSessionId?: string;
 }
 interface CloseOptions {
     deleteRecord?: boolean;
@@ -1775,7 +1912,9 @@ declare class Session {
     agent: AgentInstance;
     upstreamSessionId: string;
     agentMeta: Record<string, unknown> | undefined;
+    agentCapabilities: AgentCapabilities | undefined;
     readonly agentArgs: string[] | undefined;
+    readonly parentSessionId: string | undefined;
     title: string | undefined;
     currentModel: string | undefined;
     currentMode: string | undefined;
@@ -1801,9 +1940,13 @@ declare class Session {
     private internalPromptCapture;
     private idleTimeoutMs;
     private idleTimer;
+    private idleEventTimer;
+    private idleEventTimeoutMs;
     private lastRecordedAt;
     private spawnReplacementAgent;
     private logger;
+    private transformChain;
+    private pendingClaims;
     private agentChangeHandlers;
     private agentAdvertisedCommands;
     private agentAdvertisedModes;
@@ -1814,13 +1957,17 @@ declare class Session {
     private modelHandlers;
     private modeHandlers;
     private usageHandlers;
+    private cumulativeCost;
     private amendInProgress;
     private recentlyTerminal;
+    private streamBuffer;
+    private streamFilePath;
     constructor(init: SessionInit);
     private broadcastMergedCommands;
     private broadcastAvailableModes;
     private broadcastAvailableModels;
     private wireAgent;
+    private runResponseChain;
     onAgentChange(handler: (info: {
         agentId: string;
         upstreamSessionId: string;
@@ -1865,7 +2012,10 @@ declare class Session {
     private amendOnHead;
     private enqueueAmendmentAsFollowUp;
     cancel(clientId: string): Promise<void>;
-    forwardRequest(method: string, params: unknown): Promise<unknown>;
+    forwardRequest(method: string, params: unknown, originatedBy?: Set<string>, startIdx?: number): Promise<unknown>;
+    dischargeClaim(token: string, result: unknown): boolean;
+    keepAliveClaim(token: string, estimatedRemainingMs?: number): boolean;
+    emitToChain(emitterName: string, method: string, envelope: unknown): Promise<void>;
     private rewriteForAgent;
     close(opts?: CloseOptions): Promise<void>;
     onClose(handler: (opts: {
@@ -1880,6 +2030,9 @@ declare class Session {
     private maybeApplyAgentConfigOption;
     private maybeApplyAgentMode;
     private maybeApplyAgentUsage;
+    private accumulateAndResetCost;
+    private injectCumulativeCost;
+    get totalUsage(): UsageSnapshot | undefined;
     private setAgentAdvertisedCommands;
     private setAgentAdvertisedModes;
     private setAgentAdvertisedModels;
@@ -1903,12 +2056,37 @@ declare class Session {
     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;
+    }>;
+    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;
     private handlePermissionRequest;
@@ -1940,16 +2118,19 @@ declare const SessionRecord: z.ZodObject<{
         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;
@@ -1988,6 +2169,7 @@ declare const SessionRecord: z.ZodObject<{
         description?: string | undefined;
     }>, "many">>;
     pendingHistorySync: z.ZodOptional<z.ZodBoolean>;
+    parentSessionId: z.ZodOptional<z.ZodString>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
@@ -2007,9 +2189,11 @@ declare const SessionRecord: z.ZodObject<{
         size?: number | undefined;
         costAmount?: number | undefined;
         costCurrency?: string | undefined;
+        cumulativeCost?: number | undefined;
     } | undefined;
     importedFromMachine?: string | undefined;
     importedFromUpstreamSessionId?: string | undefined;
+    parentSessionId?: string | undefined;
     lineageId?: string | undefined;
     importedFromSessionId?: string | undefined;
     agentCommands?: {
@@ -2044,9 +2228,11 @@ declare const SessionRecord: z.ZodObject<{
         size?: number | undefined;
         costAmount?: number | undefined;
         costCurrency?: string | undefined;
+        cumulativeCost?: number | undefined;
     } | undefined;
     importedFromMachine?: string | undefined;
     importedFromUpstreamSessionId?: string | undefined;
+    parentSessionId?: string | undefined;
     lineageId?: string | undefined;
     importedFromSessionId?: string | undefined;
     agentCommands?: {
@@ -2080,12 +2266,15 @@ declare const Bundle: z.ZodObject<{
     exportedFrom: z.ZodObject<{
         hydraVersion: z.ZodString;
         machine: z.ZodString;
+        hydraHost: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         hydraVersion: string;
         machine: string;
+        hydraHost?: string | undefined;
     }, {
         hydraVersion: string;
         machine: string;
+        hydraHost?: string | undefined;
     }>;
     session: z.ZodObject<{
         sessionId: z.ZodString;
@@ -2101,16 +2290,19 @@ declare const Bundle: z.ZodObject<{
             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;
@@ -2142,8 +2334,8 @@ declare const Bundle: z.ZodObject<{
         cwd: string;
         agentId: string;
         updatedAt: string;
-        lineageId: string;
         createdAt: string;
+        lineageId: string;
         upstreamSessionId?: string | undefined;
         title?: string | undefined;
         currentModel?: string | undefined;
@@ -2153,6 +2345,7 @@ declare const Bundle: z.ZodObject<{
             size?: number | undefined;
             costAmount?: number | undefined;
             costCurrency?: string | undefined;
+            cumulativeCost?: number | undefined;
         } | undefined;
         agentCommands?: {
             name: string;
@@ -2168,8 +2361,8 @@ declare const Bundle: z.ZodObject<{
         cwd: string;
         agentId: string;
         updatedAt: string;
-        lineageId: string;
         createdAt: string;
+        lineageId: string;
         upstreamSessionId?: string | undefined;
         title?: string | undefined;
         currentModel?: string | undefined;
@@ -2179,6 +2372,7 @@ declare const Bundle: z.ZodObject<{
             size?: number | undefined;
             costAmount?: number | undefined;
             costCurrency?: string | undefined;
+            cumulativeCost?: number | undefined;
         } | undefined;
         agentCommands?: {
             name: string;
@@ -2211,8 +2405,8 @@ declare const Bundle: z.ZodObject<{
         cwd: string;
         agentId: string;
         updatedAt: string;
-        lineageId: string;
         createdAt: string;
+        lineageId: string;
         upstreamSessionId?: string | undefined;
         title?: string | undefined;
         currentModel?: string | undefined;
@@ -2222,6 +2416,7 @@ declare const Bundle: z.ZodObject<{
             size?: number | undefined;
             costAmount?: number | undefined;
             costCurrency?: string | undefined;
+            cumulativeCost?: number | undefined;
         } | undefined;
         agentCommands?: {
             name: string;
@@ -2237,6 +2432,7 @@ declare const Bundle: z.ZodObject<{
     exportedFrom: {
         hydraVersion: string;
         machine: string;
+        hydraHost?: string | undefined;
     };
     history: {
         method: string;
@@ -2251,8 +2447,8 @@ declare const Bundle: z.ZodObject<{
         cwd: string;
         agentId: string;
         updatedAt: string;
-        lineageId: string;
         createdAt: string;
+        lineageId: string;
         upstreamSessionId?: string | undefined;
         title?: string | undefined;
         currentModel?: string | undefined;
@@ -2262,6 +2458,7 @@ declare const Bundle: z.ZodObject<{
             size?: number | undefined;
             costAmount?: number | undefined;
             costCurrency?: string | undefined;
+            cumulativeCost?: number | undefined;
         } | undefined;
         agentCommands?: {
             name: string;
@@ -2277,6 +2474,7 @@ declare const Bundle: z.ZodObject<{
     exportedFrom: {
         hydraVersion: string;
         machine: string;
+        hydraHost?: string | undefined;
     };
     history: {
         method: string;
@@ -2295,6 +2493,8 @@ interface CreateSessionParams {
     agentArgs?: string[];
     model?: string;
     onInstallProgress?: AgentInstallProgressCallback;
+    transformChain?: TransformerRef[];
+    parentSessionId?: string;
 }
 interface ResurrectParams {
     hydraSessionId: string;
@@ -2318,6 +2518,8 @@ interface SessionManagerOptions {
     idleTimeoutMs?: number;
     defaultModels?: Record<string, string>;
     sessionHistoryMaxEntries?: number;
+    defaultTransformers?: string[];
+    idleEventTimeoutMs?: number;
     logger?: AgentLogger;
     npmRegistry?: string;
 }
@@ -2330,6 +2532,8 @@ declare class SessionManager {
     private histories;
     private idleTimeoutMs;
     private defaultModels;
+    readonly defaultTransformers: string[];
+    private idleEventTimeoutMs;
     private sessionHistoryMaxEntries;
     private metaWriteQueues;
     private logger?;
@@ -2405,13 +2609,18 @@ interface ExtensionInfo {
     startedAt: number | undefined;
     lastExitCode: number | undefined;
     logPath: string;
+    version: string | undefined;
 }
 declare class ExtensionManager {
     private entries;
     private stopping;
     private context;
-    constructor(extensions: ExtensionConfig[], context?: ExtensionContext);
+    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[];
@@ -2440,6 +2649,7 @@ interface DaemonHandle {
     manager: SessionManager;
     registry: Registry;
     extensions: ExtensionManager;
+    transformers: TransformerManager;
     shutdown: () => Promise<void>;
 }
 declare function startDaemon(config: HydraConfig, serviceToken: string): Promise<DaemonHandle>;
@@ -2471,6 +2681,10 @@ declare const paths: {
     extensionsDir: () => string;
     extensionLogFile: (name: string) => string;
     extensionPidFile: (name: string) => string;
+    transformersDir: () => string;
+    transformerLogFile: (name: string) => string;
+    transformerPidFile: (name: string) => string;
+    transformerState: (sessionId: string, transformerName: string) => string;
     tuiHistoryFile: (id: string) => string;
     globalTuiHistoryFile: () => string;
     tuiLogFile: () => string;