praxis-agent 0.32.0 → 0.34.0

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

@@ -5,7 +5,7 @@ import { type ClaudeAgentRuntimeDefinition, type ClaudeExtensionCatalog } from '
 import type { ClaudeHookRunner } from '../hooks/claude-hooks.js';
 import type { ClaudeMcpRuntime } from '../mcp/claude-mcp-tools.js';
 import { type DataPlane } from '../persistence/data-plane.js';
-import { type BackgroundAgentSnapshot } from './background-agent-manager.js';
+import { type BackgroundAgentNotificationIdentity, type BackgroundAgentSnapshot } from './background-agent-manager.js';
 export interface WorkflowAgentRunOptions {
     sessionId: string;
     promptId: string;
@@ -76,6 +76,17 @@ export interface ClaudeSubagentExecutorOptions {
     providerForModel?: (model: string) => ModelProvider;
     toolNames?: readonly string[];
     backgroundTaskNotifications?: (waitForRunning: boolean) => Promise<string[]>;
+    notificationDelivered?: (notification: {
+        agentId: string;
+        toolUseId: string;
+        status: 'completed' | 'failed' | 'killed';
+    }) => boolean;
+    stopOwnedBackgroundAgent?: (sessionId: string, agentId: string) => Promise<string | null>;
+    outputOwnedBackgroundAgent?: (sessionId: string, agentId: string, options: {
+        block: boolean;
+        timeout: number;
+    }) => Promise<string | null>;
+    sendOwnedBackgroundAgent?: (sessionId: string, agentId: string, message: string, summary: string | undefined, toolUseId: string) => string | null;
     persistence?: 'disk' | 'memory';
     onLineChanges?: (changes: {
         readonly linesAdded: number;
@@ -88,34 +99,50 @@ export declare class ClaudeSubagentExecutor {
     private calls;
     private readonly background;
     private readonly ephemeralSidechains;
+    private readonly foreground;
     isEnabled(name: string): boolean;
     constructor(options: ClaudeSubagentExecutorOptions);
     close(): Promise<void>;
     backgroundSnapshots(): readonly BackgroundAgentSnapshot[];
-    stopBackgroundTask(taskId: string): string;
+    hasForegroundTask(): boolean;
+    backgroundForegroundTask(identifier?: string): BackgroundAgentSnapshot;
+    stopBackgroundTask(taskId: string): Promise<string>;
+    outputBackgroundTask(taskId: string, options: {
+        block: boolean;
+        timeout: number;
+    }): Promise<string>;
+    sendBackgroundMessage(agentId: string, message: string, summary: string | undefined, toolUseId: string): string;
+    stopAllBackgroundTasks(): readonly string[];
     private cwd;
     private agentDefinition;
     private resolveAgentInput;
-    registry(sessionId: string, depth: number, promptIdForCall: (callId: string) => string | null): ToolRegistry;
+    registry(sessionId: string, depth: number, promptIdForCall: (callId: string) => string | null, parentAgentId?: string): ToolRegistry;
     definitions(): ModelToolDefinition;
     managementDefinitions(): readonly ModelToolDefinition[];
     prepare(call: ModelToolCall, depth: number): ModelToolCall;
-    execute(call: ModelToolCall, sessionId: string, depth: number, promptId: string, context: ToolExecutionContext): Promise<ToolExecutionResult>;
+    execute(call: ModelToolCall, sessionId: string, depth: number, promptId: string, context: ToolExecutionContext, parentAgentId?: string): Promise<ToolExecutionResult>;
     private sidechainStore;
     private sessionPaths;
     private createAgentWorktree;
     private createBackgroundAgentRun;
     runWorkflowAgent(options: WorkflowAgentRunOptions): Promise<WorkflowAgentRunResult>;
     prepareManagement(call: ModelToolCall): ModelToolCall;
-    executeManagement(call: ModelToolCall, sessionId: string): Promise<ToolExecutionResult>;
-    notifications(waitForRunning: boolean): Promise<{
+    executeManagement(call: ModelToolCall, sessionId: string, context: ToolExecutionContext): Promise<ToolExecutionResult>;
+    notifications(waitForRunning: boolean, consume?: boolean): Promise<{
         messages: string[];
         usage: ModelUsage;
         modelUsage?: ModelUsageByModel;
         durationApiMs?: number;
         durationApiWithoutRetriesMs?: number;
     }>;
-    private hydrateCompletedTask;
+    acknowledgeNotifications(messages: readonly string[]): Promise<void>;
+    prepareNotificationsDetached(messages: readonly string[]): Promise<void>;
+    confirmNotificationsDetached(messages: readonly string[]): Promise<void>;
+    reconcileDeliveredNotifications(delivered?: (notification: BackgroundAgentNotificationIdentity) => boolean): Promise<void>;
+    reconcileDetachedNotifications(delivered: (notification: BackgroundAgentNotificationIdentity) => boolean): Promise<void>;
+    notificationClaimAgentIds(): string[];
+    hydratePersistedTasks(sessionId: string, parentCwd: string, excludedAgentIds?: ReadonlySet<string>): Promise<void>;
+    private hydratePersistedTask;
     private resolvePersistedSidechain;
     private discoverSidechainCandidates;
     private asyncLaunchResult;