chatroom-cli 1.31.1 → 1.32.1

package/dist/infrastructure/retry-queue.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Retry Queue — wraps async calls with retry-with-backoff.
+ *
+ * Designed for lifecycle mutations where transient failures (network blips,
+ * Convex cold starts) are expected and safe to retry.
+ */
+export interface RetryOptions {
+    maxRetries?: number;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+}
+/**
+ * Execute an async function with exponential backoff.
+ * Returns the result on success, or undefined after all retries are exhausted.
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, opts?: RetryOptions): Promise<T | undefined>;
+//# sourceMappingURL=retry-queue.d.ts.map

package/dist/infrastructure/retry-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-queue.d.ts","sourceRoot":"","sources":["../../src/infrastructure/retry-queue.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAQD;;;GAGG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,IAAI,CAAC,EAAE,YAAY,GAClB,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAoBxB"}

package/dist/infrastructure/retry-queue.js

@@ -0,0 +1,33 @@
+/**
+ * Retry Queue — wraps async calls with retry-with-backoff.
+ *
+ * Designed for lifecycle mutations where transient failures (network blips,
+ * Convex cold starts) are expected and safe to retry.
+ */
+const DEFAULTS = {
+    maxRetries: 3,
+    baseDelayMs: 500,
+    maxDelayMs: 5_000,
+};
+/**
+ * Execute an async function with exponential backoff.
+ * Returns the result on success, or undefined after all retries are exhausted.
+ */
+export async function withRetry(fn, opts) {
+    const { maxRetries, baseDelayMs, maxDelayMs } = { ...DEFAULTS, ...opts };
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (e) {
+            if (attempt === maxRetries) {
+                console.warn(`[retry-queue] All ${maxRetries + 1} attempts exhausted: ${e.message}`);
+                return undefined;
+            }
+            const delay = Math.min(baseDelayMs * 2 ** attempt, maxDelayMs);
+            await new Promise((resolve) => setTimeout(resolve, delay));
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=retry-queue.js.map

package/dist/infrastructure/retry-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-queue.js","sourceRoot":"","sources":["../../src/infrastructure/retry-queue.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,QAAQ,GAA2B;IACvC,UAAU,EAAE,CAAC;IACb,WAAW,EAAE,GAAG;IAChB,UAAU,EAAE,KAAK;CAClB,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,EAAoB,EACpB,IAAmB;IAEnB,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,IAAI,EAAE,CAAC;IAEzE,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;gBAC3B,OAAO,CAAC,IAAI,CACV,qBAAqB,UAAU,GAAG,CAAC,wBAAyB,CAAW,CAAC,OAAO,EAAE,CAClF,CAAC;gBACF,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,GAAG,CAAC,IAAI,OAAO,EAAE,UAAU,CAAC,CAAC;YAC/D,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/infrastructure/services/agent-process-manager/agent-process-manager.d.ts

@@ -0,0 +1,142 @@
+/**
+ * AgentProcessManager — single authority for agent lifecycle management.
+ *
+ * Owns all state transitions, PID tracking, process spawning/killing,
+ * crash loop protection, rate limiting, and backend event emission.
+ *
+ * State model per (chatroomId, role):
+ *   idle → spawning → running → idle (on exit)
+ *                  ↘ idle (on failure)
+ *   running → stopping → idle (on stop)
+ *
+ * Phase 1: standalone, no caller changes. Built and tested in isolation.
+ */
+import type { CrashLoopTracker } from '../../machine/crash-loop-tracker.js';
+import type { StopReason } from '../../machine/stop-reason.js';
+import type { AgentHarness } from '../../machine/types.js';
+import type { RemoteAgentService } from '../remote-agents/remote-agent-service.js';
+export type AgentSlotState = 'idle' | 'spawning' | 'running' | 'stopping';
+export interface AgentSlot {
+    state: AgentSlotState;
+    pid?: number;
+    harness?: AgentHarness;
+    model?: string;
+    workingDir?: string;
+    startedAt?: number;
+    /** Promise that resolves when a pending spawn or stop completes */
+    pendingOperation?: Promise<OperationResult>;
+}
+export interface OperationResult {
+    success: boolean;
+    pid?: number;
+    error?: string;
+}
+export interface EnsureRunningOpts {
+    chatroomId: string;
+    role: string;
+    agentHarness: AgentHarness;
+    model?: string;
+    workingDir: string;
+    reason: string;
+}
+export interface StopOpts {
+    chatroomId: string;
+    role: string;
+    reason: StopReason;
+    /** PID from the backend event — used as fallback when the daemon has no slot PID (e.g. after restart). */
+    pid?: number;
+}
+export interface HandleExitOpts {
+    chatroomId: string;
+    role: string;
+    pid: number;
+    code: number | null;
+    signal: string | null;
+}
+export interface AgentProcessManagerDeps {
+    agentServices: Map<string, RemoteAgentService>;
+    /**
+     * Backend client for Convex queries/mutations.
+     * Uses `any` because the Convex client type is complex and varies by context.
+     * All call sites use typed `api.*` references which provide compile-time safety.
+     */
+    backend: {
+        query: (fn: any, args: any) => Promise<any>;
+        mutation: (fn: any, args: any) => Promise<any>;
+    };
+    sessionId: string;
+    machineId: string;
+    processes: {
+        kill: (pid: number, signal?: number | NodeJS.Signals) => void;
+    };
+    clock: {
+        delay: (ms: number) => Promise<void>;
+        now: () => number;
+    };
+    fs: {
+        stat: (path: string) => Promise<{
+            isDirectory: () => boolean;
+        }>;
+    };
+    persistence: {
+        persistAgentPid: (machineId: string, chatroomId: string, role: string, pid: number, harness: AgentHarness) => void;
+        clearAgentPid: (machineId: string, chatroomId: string, role: string) => void;
+        listAgentEntries: (machineId: string) => Array<{
+            chatroomId: string;
+            role: string;
+            entry: {
+                pid: number;
+                harness: AgentHarness;
+            };
+        }>;
+    };
+    spawning: {
+        shouldAllowSpawn: (chatroomId: string, reason: string, options?: {
+            bypassConcurrentLimit?: boolean;
+        }) => {
+            allowed: boolean;
+            retryAfterMs?: number;
+        };
+        recordSpawn: (chatroomId: string) => void;
+        recordExit: (chatroomId: string) => void;
+    };
+    crashLoop: CrashLoopTracker;
+    convexUrl: string;
+}
+export declare class AgentProcessManager {
+    private readonly deps;
+    private readonly slots;
+    /** Queue of failed recordAgentExited calls awaiting retry. */
+    private readonly exitRetryQueue;
+    /** Active retry interval timer handle, or null if queue is empty. */
+    private exitRetryTimer;
+    constructor(deps: AgentProcessManagerDeps);
+    ensureRunning(opts: EnsureRunningOpts): Promise<OperationResult>;
+    stop(opts: StopOpts): Promise<{
+        success: boolean;
+    }>;
+    handleExit(opts: HandleExitOpts): void;
+    getSlot(chatroomId: string, role: string): AgentSlot | undefined;
+    listActive(): Array<{
+        chatroomId: string;
+        role: string;
+        slot: AgentSlot;
+    }>;
+    recover(): Promise<void>;
+    private getOrCreateSlot;
+    /**
+     * Queue a failed recordAgentExited call for retry.
+     * Starts the retry interval timer if not already running.
+     */
+    private queueExitRetry;
+    /**
+     * Attempt to flush all queued agent exit events.
+     * Successful items are removed; failures remain for the next cycle.
+     * When the queue is empty, the retry interval is stopped.
+     */
+    private drainExitRetryQueue;
+    private stopExitRetryTimer;
+    private doEnsureRunning;
+    private doStop;
+}
+//# sourceMappingURL=agent-process-manager.d.ts.map

package/dist/infrastructure/services/agent-process-manager/agent-process-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-process-manager.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/services/agent-process-manager/agent-process-manager.ts"],"names":[],"mappings":"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"}