praxis-agent 0.33.0 → 0.35.0

package/dist/application/managed-worktree.js

@@ -1,6 +1,6 @@
 import { execFile } from 'node:child_process';
-import { lstat, mkdir } from 'node:fs/promises';
-import { join, resolve } from 'node:path';
+import { lstat, mkdir, realpath } from 'node:fs/promises';
+import { isAbsolute, join, resolve } from 'node:path';
 import { promisify } from 'node:util';
 const execFileAsync = promisify(execFile);
 async function git(cwd, args) {
@@ -124,4 +124,56 @@ export async function createManagedWorktree(options) {
         },
     };
 }
+/** Reattaches only to a real, registered Git worktree. Persisted metadata is
+ * untrusted input, so an arbitrary directory can never become an execution
+ * cwd merely because it exists. Restored worktrees are retained for audit. */
+export async function restoreManagedWorktree(options) {
+    if (!isAbsolute(options.path) || options.path.includes('\0')) {
+        throw new Error(`Invalid retained ${options.label.toLowerCase()} worktree path`);
+    }
+    const path = resolve(options.path);
+    let entry;
+    try {
+        entry = await lstat(path);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            throw new Error(`Retained ${options.label.toLowerCase()} worktree is missing: ${path}`);
+        }
+        throw error;
+    }
+    if (entry.isSymbolicLink() || !entry.isDirectory()) {
+        throw new Error(`Retained ${options.label.toLowerCase()} worktree must be a real directory: ${path}`);
+    }
+    let root;
+    let registered;
+    let canonicalPath;
+    try {
+        ;
+        [root, canonicalPath] = await Promise.all([
+            git(options.cwd, ['rev-parse', '--show-toplevel']),
+            realpath(path),
+        ]);
+        registered = await registeredWorktrees(root);
+    }
+    catch (error) {
+        throw new Error(`Could not inspect retained ${options.label.toLowerCase()} worktree ${path}: ${error.message}`);
+    }
+    if (!registered.has(path) && !registered.has(canonicalPath)) {
+        throw new Error(`Retained ${options.label.toLowerCase()} worktree is not registered: ${path}`);
+    }
+    const worktreeRoot = await realpath(resolve(await git(path, ['rev-parse', '--show-toplevel'])));
+    if (worktreeRoot !== canonicalPath) {
+        throw new Error(`Retained ${options.label.toLowerCase()} worktree path is not its root: ${path}`);
+    }
+    return {
+        cwd: path,
+        async cleanup() {
+            return {
+                retained: true,
+                reason: `${options.label} worktree was restored and retained at ${path}`,
+            };
+        },
+    };
+}
 //# sourceMappingURL=managed-worktree.js.map

package/dist/application/session-service.d.ts

@@ -197,8 +197,14 @@ export declare class ClaudeSessionService {
     private readonly explicitResumeLeafUuids;
     private readonly sessionPermissionUpdates;
     private readonly hostedSubagents;
+    private readonly subagentExecutors;
     private readonly hostedSubagentsByRegistry;
+    private readonly subagentExecutorSessions;
+    private readonly hostedSubagentNotificationPumps;
+    private readonly hostedSubagentPumpPromises;
+    private readonly hostedSubagentNotificationReservations;
     private readonly backgroundNotificationWrites;
+    private closing;
     private readonly downloadedFileResourceSessions;
     private readonly detachedHookRuns;
     private activeProvider;
@@ -227,6 +233,10 @@ export declare class ClaudeSessionService {
     private requireMcp;
     taskSnapshots(sessionId: string): Promise<BackgroundTaskSnapshot>;
     stopTask(sessionId: string, taskId: string): Promise<void>;
+    backgroundForegroundTask(sessionId: string): import("./background-agent-manager.js").BackgroundAgentSnapshot;
+    private sendOwnedBackgroundAgent;
+    private sessionSubagentExecutors;
+    private collectSubagentNotifications;
     private applyPermissionUpdates;
     close(): Promise<void>;
     transitionHookSession(sessionId: string, reason: Exclude<HookSessionEndReason, 'other'>): Promise<void>;
@@ -255,6 +265,7 @@ export declare class ClaudeSessionService {
     resumeShell(sessionId: string, command: string, signal?: AbortSignal, name?: string, resumeSessionAt?: string): Promise<SessionRunResult>;
     answerSideQuestion(sessionId: string | undefined, question: string, signal?: AbortSignal, onDelta?: (delta: string) => void, permissionMode?: ClaudePermissionMode): Promise<SideQuestionResult>;
     forkSideQuestion(sessionId: string, question: string, signal?: AbortSignal): Promise<SideQuestionForkResult>;
+    private startHostedSubagentNotificationPump;
     promptSuggestion(sessionId: string, signal?: AbortSignal): Promise<string | null>;
     sessionNameSuggestion(sessionId: string, signal?: AbortSignal): Promise<string | null>;
     sessions(): Promise<SessionSummary[]>;
@@ -288,6 +299,7 @@ export declare class ClaudeSessionService {
     private persistActiveSessionCost;
     private recordAuxiliaryMetrics;
     costSnapshot(sessionId: string): Promise<ClaudeSessionCostSnapshot>;
+    private withDetachedSubagentUsage;
     private executeTurn;
     private ensureFileResources;
     private translationContext;
@@ -338,7 +350,6 @@ export declare class ClaudeSessionService {
     private providerForAgent;
     private resolveAgent;
     private mainAgentSystemPrompt;
-    private assembledSystemMessages;
     private contextBudget;
     private sessionMemoryEnabled;
     private sessionMemoryController;