@dreb/coding-agent 2.66.3 → 2.68.0

package/dist/core/tools/subagent.d.ts

@@ -99,7 +99,9 @@ export declare function handleChildJsonlLine(line: string, sinks: ChildLineSinks
  * present this recurses one level into step-* directories and returns one file
  * per step in numeric step order.
  */
-export declare function discoverSessionFiles(sessionDir: string, agentName: string): string[];
+export declare function discoverSessionFiles(sessionDir: string, agentName: string, options?: {
+    throwOnOperationalError?: boolean;
+}): string[];
 /**
  * Find the most recently modified .jsonl file in a session directory.
  * Returns the full path, or undefined if no session file was written
@@ -216,15 +218,17 @@ export interface BackgroundAgentInfo {
     arbitrations?: DispatchArbitrationRecord[];
 }
 /**
- * Best-effort recovery for completed background subagents after a dashboard/RPC
- * process resumes an existing parent session. Live background-agent state is an
- * in-memory registry, while child sessions are durable JSONL files under the
- * subagent sessions directory.
+ * Recover completed background subagents after a dashboard/RPC process resumes
+ * an existing parent session. Live background-agent state is an in-memory
+ * registry, while child sessions are durable JSONL files under the subagent
+ * sessions directory.
  *
- * Returns the number of newly registered agents. Expected filesystem and JSONL
- * parse failures are skipped; unexpected programming errors are allowed to throw.
+ * The first root is authoritative: absence races and malformed JSON are skipped,
+ * while operational filesystem failures throw. Later roots are compatibility
+ * stores, so their operational filesystem failures are warned and skipped.
+ * Returns the number of newly registered agents.
  */
-export declare function rehydrateBackgroundAgentsFromDisk(parentSessionFile: string | undefined, subagentSessionsBase?: string): number;
+export declare function rehydrateBackgroundAgentsFromDisk(parentSessionFile: string | undefined, subagentSessionRoots?: string | readonly string[]): number;
 /** Get a snapshot of all tracked background agents (running and recently completed). Returns readonly clones. */
 export declare function getBackgroundAgents(): readonly Readonly<BackgroundAgentInfo>[];
 /** Get only currently running background agents. Returns readonly clones. */
@@ -241,6 +245,8 @@ export declare function abortBackgroundAgents(): void;
 /** Remove completed/failed entries older than the given age (ms). Default: 5 minutes. */
 export declare function pruneBackgroundAgents(maxAgeMs?: number): void;
 export interface SubagentToolOptions {
+    /** Resolved root for new subagent child-session directories. Defaults to the legacy agent root. */
+    subagentSessionsDir?: string;
     /** Called when a background subagent starts. Used by TUI to show status indicators. */
     onBackgroundStart?: (agentId: string, agentType: string, taskSummary: string, sessionDir?: string) => void;
     /** Called when a background subagent completes with its result. `cancelled` is true if the user aborted it. */