agent-afk 5.222.18 → 5.223.0

package/dist/agent/background-registry.d.ts

@@ -16,6 +16,7 @@ export interface RegisterArgs {
     provenance?: BackgroundJobProvenance;
     parentSessionId?: string | undefined;
     onCleanup?: () => Promise<void>;
+    onSettled?: () => void;
 }
 export interface BackgroundRegistryEvents {
     started: [job: BackgroundJob];
@@ -45,7 +46,6 @@ export declare class BackgroundAgentRegistry extends EventEmitter<BackgroundRegi
     getTranscript(jobId: string): string | undefined;
     getHandle(jobId: string): SubagentHandle | undefined;
     getTouchedFiles(jobId: string): readonly string[] | undefined;
-    private recordTouchedFile;
     private nextJobId;
     private markTerminal;
     private statusFromResult;

package/dist/agent/background-registry.touched-files.d.ts

@@ -0,0 +1 @@
+export declare function recordTouchedFile(touchedFiles: string[], toolInputJson: string): void;

package/dist/agent/dag-subagent.d.ts

@@ -3,6 +3,7 @@ import type { AgentModelInput, CanUseTool, IAgentSession } from './types.js';
 import type { ModelProvider } from './provider.js';
 import type { SubagentManager } from './subagent.js';
 import { type DAGEdge, type DAGRunResult } from './dag.js';
+import type { DelegationBudget } from './tools/delegation-budget.js';
 export interface SubagentDAGNode {
     id: string;
     systemPrompt: string;
@@ -27,5 +28,6 @@ export interface SubagentDAGOptions {
     edges: DAGEdge[];
     failFast?: boolean;
     nodeTimeoutMs?: number;
+    delegationBudget?: DelegationBudget;
 }
 export declare function runSubagentDAG(options: SubagentDAGOptions): Promise<DAGRunResult>;

package/dist/agent/tools/compose-executor.d.ts

@@ -20,6 +20,7 @@ export interface ComposeExecutorContext {
     maxDepth?: number;
     getReadScopeInputs?: () => ReadScopeInputs;
     workspaceStore?: WorkspaceStore;
+    delegationBudget?: import('./delegation-budget.js').DelegationBudget;
     onSubagentSucceeded?: (usage: import('../subagent/result.js').SubagentTrace['usage'], costUsd: number | undefined) => void;
 }
 export interface TruncationEvent {

package/dist/agent/tools/delegation-budget.d.ts

@@ -0,0 +1,32 @@
+export interface DelegationBudgetConfig {
+    maxChildrenPerAgent?: number;
+    maxConcurrentAgents?: number;
+    maxTotalAgents?: number;
+}
+export type BudgetRefusalReason = 'max_children_per_agent' | 'max_concurrent_agents' | 'max_total_agents';
+export interface BudgetCheckResult {
+    allowed: boolean;
+    reason?: BudgetRefusalReason;
+    detail?: string;
+}
+export declare function resolveDelegationBudgetConfig(): DelegationBudgetConfig | undefined;
+export interface DelegationBudgetSnapshot {
+    concurrent: number;
+    total: number;
+    config: DelegationBudgetConfig;
+}
+export interface SpawnReceipt {
+    release: () => void;
+    rollback: () => void;
+}
+export declare class DelegationBudget {
+    private readonly config;
+    private concurrent;
+    private total;
+    private readonly childrenByAgent;
+    constructor(config: DelegationBudgetConfig);
+    canSpawn(parentId: string): BudgetCheckResult;
+    recordSpawn(parentId: string): SpawnReceipt;
+    snapshot(): DelegationBudgetSnapshot;
+}
+export declare function buildBudgetRefusalMessage(check: BudgetCheckResult): string;

package/dist/agent/tools/nesting.d.ts

@@ -32,7 +32,7 @@ export interface CreateChildProviderFactoryOptions {
 export declare function createChildProviderFactory(opts?: CreateChildProviderFactoryOptions): (args: ChildProviderFactoryArgs) => ModelProvider;
 export declare function buildReadOnlyReconProvider(model: AgentModelInput | undefined, openaiBaseUrl?: string, allowedTools?: readonly string[]): ModelProvider;
 export declare function buildComposeNodeProvider(model: AgentModelInput | undefined, workspaceStore: WorkspaceStore, openaiBaseUrl?: string, readOnlyBash?: boolean): ModelProvider;
-export declare function createChildSkillExecutorFactory(defaultModel: AgentModelInput, apiKey: string | undefined, childProviderFactory: (args: ChildProviderFactoryArgs) => ModelProvider, baseUrl?: string, traceWriter?: TraceSink, backgroundRegistry?: BackgroundAgentRegistry, cwd?: string, resolveApiKeyForModel?: (model: string) => string | undefined, surface?: Surface, defaultSubagentModel?: AgentModelInput, agentRegistry?: AgentRegistry, openaiBaseUrl?: string, xaiBaseUrl?: string, workspaceStore?: WorkspaceStore): (depth: number, maxDepth: number, signal: AbortSignal, inheritedCwd?: string, inheritedReadScope?: ReadScopeInputs, skillDispatchName?: string) => SkillExecutor;
+export declare function createChildSkillExecutorFactory(defaultModel: AgentModelInput, apiKey: string | undefined, childProviderFactory: (args: ChildProviderFactoryArgs) => ModelProvider, baseUrl?: string, traceWriter?: TraceSink, backgroundRegistry?: BackgroundAgentRegistry, cwd?: string, resolveApiKeyForModel?: (model: string) => string | undefined, surface?: Surface, defaultSubagentModel?: AgentModelInput, agentRegistry?: AgentRegistry, openaiBaseUrl?: string, xaiBaseUrl?: string, workspaceStore?: WorkspaceStore, delegationBudget?: import('./delegation-budget.js').DelegationBudget): (depth: number, maxDepth: number, signal: AbortSignal, inheritedCwd?: string, inheritedReadScope?: ReadScopeInputs, skillDispatchName?: string) => SkillExecutor;
 export type PhaseRole = 'read-only' | 'read-write';
 export declare function buildSkillRestrictedProvider(allowedTools: string[], model: AgentModelInput | undefined, readOnlyBash?: boolean, openaiBaseUrl?: string): ModelProvider;
 export declare function buildPhaseRestrictedProvider(_role: 'read-only', model: AgentModelInput | undefined): ModelProvider;

package/dist/agent/tools/skill-executor/types.d.ts

@@ -29,6 +29,7 @@ export interface SkillExecutorContext {
     agentRegistry?: import('../../agents/index.js').AgentRegistry;
     skillDispatchName?: string;
     workspaceStore?: import('../../workspace/index.js').WorkspaceStore;
+    delegationBudget?: import('../../tools/delegation-budget.js').DelegationBudget;
 }
 export interface SkillInput {
     name: string;

package/dist/agent/tools/subagent/background-branch.d.ts

@@ -9,6 +9,7 @@ export interface RunBackgroundBranchArgs {
     model: string | undefined;
     parentSessionId: string | undefined;
     onSettled?: (isError: boolean) => void;
+    budgetRelease?: () => void;
     onCleanup?: () => Promise<void>;
     isolationTeardown?: {
         repoRoot: string;

package/dist/agent/tools/subagent/child-config.d.ts

@@ -34,6 +34,7 @@ export interface BuildChildConfigArgs {
     parentModel?: AgentModelInput;
     traceWriter?: TraceSink;
     workspaceStore?: import('../../workspace/index.js').WorkspaceStore;
+    delegationBudget?: import('../../tools/delegation-budget.js').DelegationBudget;
     createChildExecutor: (ctx: SubagentExecutorContext) => SubagentExecutor;
 }
 export interface BuildChildConfigResult {

package/dist/agent/tools/subagent/foreground-promotion.d.ts

@@ -42,5 +42,9 @@ export interface RunForegroundArgs {
         repoRoot: string;
         worktreePath: string;
     };
+    budgetRelease?: () => void;
+    promotionTookBudget?: {
+        value: boolean;
+    };
 }
 export declare function runForegroundWithPromotion(args: RunForegroundArgs): Promise<ToolResult>;

package/dist/agent/tools/subagent-executor/types.d.ts

@@ -0,0 +1,45 @@
+import type { SubagentManager } from '../../subagent.js';
+import type { ReadScopeInputs } from '../../subagent-read-scope.js';
+import type { BackgroundAgentRegistry } from '../../background-registry.js';
+import type { ModelProvider } from '../../provider.js';
+import type { AgentModelInput, IAgentSession } from '../../types.js';
+import type { AgentConfig } from '../../types/config-types.js';
+import type { ChildProviderFactoryArgs } from '../nesting.js';
+import type { AgentRegistry } from '../../agents/index.js';
+import type { SkillExecutor } from '../skill-executor.js';
+import type { Surface } from '../../awareness/types.js';
+import type { TraceSink } from '../../trace/index.js';
+import type { InboundAttachmentReader } from '../../content/attachment-registry.js';
+import type { DelegationBudget } from '../delegation-budget.js';
+import type { QueuedNoteClaim } from '../subagent/queued-note.js';
+import type { PromotedSubagentInfo } from '../subagent/foreground-promotion.js';
+export type { PromotedSubagentInfo, QueuedNoteClaim };
+export interface SubagentExecutorContext {
+    subagentManager: SubagentManager;
+    parentSession: Pick<IAgentSession, 'sessionId' | 'getInputStreamRef' | 'abortSignal'> & Partial<Pick<IAgentSession, 'hookRegistry'>>;
+    defaultConfig: Pick<AgentConfig, 'apiKey' | 'systemPrompt' | 'baseUrl' | 'openaiBaseUrl' | 'xaiBaseUrl' | 'skillDispatchName'>;
+    surface?: Surface;
+    resolveApiKeyForModel?: (model: string) => string | undefined;
+    defaultSubagentModel: AgentModelInput;
+    childProviderFactory?: (args: ChildProviderFactoryArgs) => ModelProvider;
+    childSkillExecutorFactory?: (depth: number, maxDepth: number, signal: AbortSignal, inheritedCwd?: string, inheritedReadScope?: ReadScopeInputs, skillDispatchName?: string) => SkillExecutor;
+    depth: number;
+    maxDepth?: number;
+    backgroundRegistry?: BackgroundAgentRegistry;
+    cwd?: string;
+    traceWriter?: TraceSink;
+    workspaceStore?: import('../../workspace/index.js').WorkspaceStore;
+    delegationBudget?: DelegationBudget;
+    allowedTools?: string[];
+    readOnlyBash?: boolean;
+    nestedAgentAllowlist?: readonly string[];
+    agentRegistry?: AgentRegistry;
+    inboundAttachmentRegistry?: InboundAttachmentReader;
+    parentModel?: AgentModelInput;
+}
+export interface SubagentControl {
+    hasPromotableForeground(): boolean;
+    promoteActiveForeground(queuedNote?: QueuedNoteClaim): Promise<PromotedSubagentInfo[]>;
+    hasActiveForeground(): boolean;
+    cancelActiveForeground(): Promise<number>;
+}

package/dist/agent/tools/subagent-executor.d.ts

@@ -1,50 +1,13 @@
-import { SubagentManager } from '../subagent.js';
-import { type ReadScopeInputs } from '../subagent-read-scope.js';
-import { BackgroundAgentRegistry } from '../background-registry.js';
-import type { ModelProvider } from '../provider.js';
-import type { AgentModelInput, IAgentSession } from '../types.js';
-import type { AgentConfig } from '../types/config-types.js';
-import type { AnthropicToolDef, ToolCall, ToolResult } from './types.js';
-import { type ChildProviderFactoryArgs } from './nesting.js';
-import type { AgentRegistry } from '../agents/index.js';
-import type { SkillExecutor } from './skill-executor.js';
-import type { Surface } from '../awareness/types.js';
 import type { TraceSink } from '../trace/index.js';
+import type { AnthropicToolDef, ToolCall, ToolResult } from './types.js';
 import { type AgentExecutionMode } from './subagent/input-parse.js';
-import { type PromotedSubagentInfo } from './subagent/foreground-promotion.js';
-import type { QueuedNoteClaim } from './subagent/queued-note.js';
-import { type InboundAttachmentReader } from '../content/attachment-registry.js';
+import { buildSubagentsLite } from './subagent-executor.lite-snapshot.js';
+import type { SubagentExecutorContext, SubagentControl } from './subagent-executor/types.js';
+import type { QueuedNoteClaim, PromotedSubagentInfo } from './subagent-executor/types.js';
 export { DEFAULT_MAX_NESTING_DEPTH, type ChildProviderFactoryArgs } from './nesting.js';
 export type { AgentExecutionMode };
-export interface SubagentExecutorContext {
-    subagentManager: SubagentManager;
-    parentSession: Pick<IAgentSession, 'sessionId' | 'getInputStreamRef' | 'abortSignal'> & Partial<Pick<IAgentSession, 'hookRegistry'>>;
-    defaultConfig: Pick<AgentConfig, 'apiKey' | 'systemPrompt' | 'baseUrl' | 'openaiBaseUrl' | 'xaiBaseUrl' | 'skillDispatchName'>;
-    surface?: Surface;
-    resolveApiKeyForModel?: (model: string) => string | undefined;
-    defaultSubagentModel: AgentModelInput;
-    childProviderFactory?: (args: ChildProviderFactoryArgs) => ModelProvider;
-    childSkillExecutorFactory?: (depth: number, maxDepth: number, signal: AbortSignal, inheritedCwd?: string, inheritedReadScope?: ReadScopeInputs, skillDispatchName?: string) => SkillExecutor;
-    depth: number;
-    maxDepth?: number;
-    backgroundRegistry?: BackgroundAgentRegistry;
-    cwd?: string;
-    traceWriter?: TraceSink;
-    workspaceStore?: import('../workspace/index.js').WorkspaceStore;
-    allowedTools?: string[];
-    readOnlyBash?: boolean;
-    nestedAgentAllowlist?: readonly string[];
-    agentRegistry?: AgentRegistry;
-    inboundAttachmentRegistry?: InboundAttachmentReader;
-    parentModel?: AgentModelInput;
-}
+export type { SubagentExecutorContext, SubagentControl } from './subagent-executor/types.js';
 export type { PromotedSubagentInfo } from './subagent/foreground-promotion.js';
-export interface SubagentControl {
-    hasPromotableForeground(): boolean;
-    promoteActiveForeground(queuedNote?: QueuedNoteClaim): Promise<PromotedSubagentInfo[]>;
-    hasActiveForeground(): boolean;
-    cancelActiveForeground(): Promise<number>;
-}
 export declare class SubagentExecutor implements SubagentControl {
     private readonly ctx;
     private currentCwd;
@@ -68,18 +31,7 @@ export declare class SubagentExecutor implements SubagentControl {
     private cancelGeneration;
     cancelActiveForeground(): Promise<number>;
     promoteActiveForeground(queuedNote?: QueuedNoteClaim): Promise<PromotedSubagentInfo[]>;
-    getSubagentsLite(): {
-        active: Array<{
-            id: string;
-            status: 'idle' | 'running' | 'succeeded' | 'failed' | 'cancelled';
-        }>;
-        backgroundJobs: Array<{
-            jobId: string;
-            status: 'running' | 'completed' | 'failed' | 'cancelled';
-            startedAt: string;
-            label: string | null;
-        }>;
-    };
+    getSubagentsLite(): ReturnType<typeof buildSubagentsLite>;
     execute(call: ToolCall): Promise<ToolResult>;
     private executeOnce;
 }

package/dist/agent/tools/subagent-executor.lite-snapshot.d.ts

@@ -0,0 +1,15 @@
+import type { SubagentManager } from '../subagent.js';
+import type { BackgroundAgentRegistry } from '../background-registry.js';
+export interface SubagentsLite {
+    active: Array<{
+        id: string;
+        status: 'idle' | 'running' | 'succeeded' | 'failed' | 'cancelled';
+    }>;
+    backgroundJobs: Array<{
+        jobId: string;
+        status: 'running' | 'completed' | 'failed' | 'cancelled';
+        startedAt: string;
+        label: string | null;
+    }>;
+}
+export declare function buildSubagentsLite(subagentManager: SubagentManager, backgroundRegistry: BackgroundAgentRegistry | undefined): SubagentsLite;