agent-afk 5.23.2 → 5.25.0

package/dist/agent/providers/anthropic-direct/loop.d.ts

@@ -1,6 +1,6 @@
 import type { ProviderEvent } from '../../provider.js';
 import type { AnthropicToolDef, RunTurnInput, WireToolDef } from './types.js';
-export declare const DEFAULT_MAX_TOOL_USE_ITERATIONS = 0;
+export { DEFAULT_MAX_TOOL_USE_ITERATIONS } from '../shared/tool-loop-cap.js';
 export declare function toWireTool(tool: AnthropicToolDef): WireToolDef;
 export declare const OVERLOAD_MAX_RETRIES = 3;
 export declare function isTransientServerError(err: Error): boolean;

package/dist/agent/providers/anthropic-direct/query/cwd-dependents.d.ts

@@ -0,0 +1,37 @@
+import type { AgentConfig } from '../../../types/config-types.js';
+import type { SubagentExecutor } from '../../../tools/subagent-executor.js';
+import type { SkillExecutor } from '../../../tools/skill-executor.js';
+import type { ComposeExecutor } from '../../../tools/compose-executor.js';
+import type { ToolDispatcher } from '../tool-dispatcher.js';
+import { type RuntimeStateSource } from '../../../awareness/index.js';
+export type CwdDependentsFactory = (newCwd: string) => {
+    userSystem: string;
+    dispatcher: ToolDispatcher;
+};
+export interface CwdDependentsFactoryArgs {
+    stableSystemPrefix: string[];
+    config: AgentConfig;
+    surface: string;
+    runtimeStateSource: RuntimeStateSource;
+    getCurrentCwd: () => string | undefined;
+    setCurrentCwd: (cwd: string) => void;
+    getCurrentPermissionMode: () => string;
+    sharedReadRoots: string[] | undefined;
+    sharedWriteRoots: string[] | undefined;
+    subagentExecutor: SubagentExecutor | undefined;
+    skillExecutor: SkillExecutor | undefined;
+    composeExecutor: ComposeExecutor | undefined;
+    buildDispatcher: (permissionMode: string, opts: {
+        cwd?: string;
+        env?: Record<string, string>;
+        readRoots?: string[];
+        writeRoots?: string[];
+        sessionId?: string;
+        parentSessionId?: string;
+        traceWriter?: AgentConfig['traceWriter'];
+        runtimeStateSource?: RuntimeStateSource;
+        hookRegistry?: AgentConfig['hookRegistry'];
+        planExitControls?: AgentConfig['planExitControls'];
+    }) => ToolDispatcher;
+}
+export declare function createCwdDependentsFactory(args: CwdDependentsFactoryArgs): CwdDependentsFactory;

package/dist/agent/providers/anthropic-direct/query/presence-lifecycle.d.ts

@@ -0,0 +1,13 @@
+import { type RuntimeStateSource } from '../../../awareness/index.js';
+export interface PresenceLifecycleArgs {
+    depth: number | undefined;
+    parentSessionId: string | undefined;
+    sessionId: string | undefined;
+    currentPresenceSessionId: string | null;
+    runtimeStateSource: RuntimeStateSource;
+    surface: string;
+    cwd: string | undefined;
+    providerName: string;
+    model: string;
+}
+export declare function registerPresenceLifecycle(args: PresenceLifecycleArgs): string | null;

package/dist/agent/providers/anthropic-direct/query/token-resolution.d.ts

@@ -0,0 +1,6 @@
+import type { AgentConfig } from '../../../types/config-types.js';
+export interface ResolvedQueryToken {
+    localMode: boolean;
+    token: string;
+}
+export declare function resolveQueryToken(config: AgentConfig): ResolvedQueryToken;

package/dist/agent/providers/openai-compatible/query/dispatch-append.d.ts

@@ -0,0 +1,15 @@
+import type { TraceWriter } from '../../../trace/index.js';
+import type { ProviderEvent } from '../../../provider.js';
+import type { ToolDispatcher } from '../../anthropic-direct/tool-dispatcher.js';
+import type { OpenAIMessage } from '../messages.js';
+import type { StreamState } from '../translate.js';
+export interface DispatchAndAppendInput {
+    state: StreamState;
+    signal: AbortSignal;
+    vision: boolean;
+    toolDispatcher: ToolDispatcher | undefined;
+    traceWriter: TraceWriter | undefined;
+    priorTurns: OpenAIMessage[];
+    sessionId: string;
+}
+export declare function dispatchAndAppendToolCalls({ state, signal, vision, toolDispatcher, traceWriter, priorTurns, sessionId, }: DispatchAndAppendInput): AsyncGenerator<ProviderEvent>;

package/dist/agent/providers/shared/tool-loop-cap.d.ts

@@ -0,0 +1,5 @@
+export declare const TOOL_USE_LOOP_CAPPED = "tool_use_loop_capped";
+export declare const DEFAULT_MAX_TOOL_USE_ITERATIONS = 0;
+export declare const WIND_DOWN_NOTE: string;
+export declare function resolveMaxToolIterations(configured: number | undefined): number;
+export declare function shouldWindDown(completedRounds: number, maxIterations: number): boolean;

package/dist/agent/shadow-verify-nudge.d.ts

@@ -1,2 +1,3 @@
 import type { HookContext, HookDecision } from './hooks.js';
+export declare function createShadowVerifyNudge(): (context: HookContext) => HookDecision;
 export declare function shadowVerifyNudge(context: HookContext): HookDecision;

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

@@ -0,0 +1,13 @@
+import { type BackgroundAgentRegistry } from '../../background-registry.js';
+import type { SubagentManager } from '../../subagent.js';
+import type { ToolResult } from '../types.js';
+type ForkedHandle = Awaited<ReturnType<SubagentManager['forkSubagent']>>;
+export interface RunBackgroundBranchArgs {
+    handle: ForkedHandle;
+    registry: BackgroundAgentRegistry | undefined;
+    prompt: string;
+    model: string | undefined;
+    parentSessionId: string | undefined;
+}
+export declare function runBackgroundBranch(args: RunBackgroundBranchArgs): Promise<ToolResult>;
+export {};

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

@@ -0,0 +1,39 @@
+import { SubagentManager } from '../../subagent.js';
+import type { ModelProvider } from '../../provider.js';
+import type { AgentModelInput } from '../../types.js';
+import type { AgentConfig } from '../../types/config-types.js';
+import { createStubParentSession, type ChildProviderFactoryArgs } from '../nesting.js';
+import type { RegisteredAgent } from '../../agents/index.js';
+import type { AgentRegistry } from '../../agents/index.js';
+import type { SkillExecutor } from '../skill-executor.js';
+import type { Surface } from '../../awareness/types.js';
+import type { SubagentExecutor, SubagentExecutorContext } from '../subagent-executor.js';
+import type { AgentInput } from './input-parse.js';
+export type ChildParentSession = ReturnType<typeof createStubParentSession> & {
+    sessionId: string | undefined;
+};
+export interface BuildChildConfigArgs {
+    parsed: AgentInput;
+    namedAgent: RegisteredAgent | undefined;
+    depth: number;
+    maxDepth: number;
+    currentCwd: string | undefined;
+    signal: AbortSignal;
+    defaultConfig: Pick<AgentConfig, 'apiKey' | 'systemPrompt' | 'baseUrl' | 'openaiBaseUrl'>;
+    resolveApiKeyForModel?: (model: string) => string | undefined;
+    defaultSubagentModel?: AgentModelInput;
+    childProviderFactory?: (args: ChildProviderFactoryArgs) => ModelProvider;
+    childSkillExecutorFactory?: (depth: number, maxDepth: number, signal: AbortSignal, inheritedCwd?: string) => SkillExecutor;
+    surface?: Surface;
+    allowedTools?: string[];
+    readOnlyBash?: boolean;
+    agentRegistry?: AgentRegistry;
+    parentModel?: AgentModelInput;
+    createChildExecutor: (ctx: SubagentExecutorContext) => SubagentExecutor;
+}
+export interface BuildChildConfigResult {
+    childConfig: AgentConfig;
+    childParentSession: ChildParentSession | undefined;
+    childManager: SubagentManager | undefined;
+}
+export declare function buildChildConfig(args: BuildChildConfigArgs): BuildChildConfigResult;

package/dist/agent/tools/subagent/failure-payload.d.ts

@@ -0,0 +1,18 @@
+import { appendRoutingDecision } from '../../routing-telemetry.js';
+export declare function emitTelemetry(entry: Parameters<typeof appendRoutingDecision>[0]): Promise<void>;
+export declare function truncate(s: string, max?: number): string;
+export declare function measurePartial(partial: unknown): number | undefined;
+export interface StructuredFailurePayload {
+    status: string;
+    error: string;
+    schemaError?: string;
+    partialOutput?: unknown;
+    subagent_id: string;
+}
+export declare function buildFailurePayload(args: {
+    status: string;
+    errorMessage: string;
+    schemaErrorMessage?: string;
+    partialOutput?: unknown;
+    subagentId: string;
+}): StructuredFailurePayload;

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

@@ -0,0 +1,31 @@
+import type { BackgroundAgentRegistry } from '../../background-registry.js';
+import type { SubagentManager } from '../../subagent.js';
+import type { TraceOrigin, TraceActor } from '../../session/session-identity.js';
+import type { ToolResult } from '../types.js';
+import type { PromotedSubagentInfo } from '../subagent-executor.js';
+type ForkedHandle = Awaited<ReturnType<SubagentManager['forkSubagent']>>;
+export interface PromotionTrigger {
+    fire: () => void;
+    ready: Promise<PromotedSubagentInfo | null>;
+}
+export interface RunForegroundArgs {
+    handle: ForkedHandle;
+    signal: AbortSignal;
+    prompt: string;
+    idPrefix: string | undefined;
+    model: string | undefined;
+    childManager: SubagentManager | undefined;
+    identity: {
+        origin?: TraceOrigin;
+        actor?: TraceActor;
+    };
+    depth: number;
+    parentSessionId: string | undefined;
+    registry: BackgroundAgentRegistry | undefined;
+    promotionTriggers: Map<string, PromotionTrigger>;
+    activeForegroundHandles: Map<string, {
+        cancel: () => Promise<void>;
+    }>;
+}
+export declare function runForegroundWithPromotion(args: RunForegroundArgs): Promise<ToolResult>;
+export {};

package/dist/agent/tools/subagent/input-parse.d.ts

@@ -0,0 +1,14 @@
+export type AgentExecutionMode = 'foreground' | 'background';
+export interface AgentInput {
+    prompt: string;
+    model?: string;
+    max_turns?: number;
+    max_turns_explicit: boolean;
+    max_tool_use_iterations?: number;
+    max_tool_use_iterations_explicit: boolean;
+    id_prefix?: string;
+    agent_type?: string;
+    mode: AgentExecutionMode;
+    cwd?: string;
+}
+export declare function parseAgentInput(input: unknown): AgentInput;

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

@@ -8,7 +8,9 @@ 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 AgentExecutionMode } from './subagent/input-parse.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'>>;
@@ -28,7 +30,6 @@ export interface SubagentExecutorContext {
     agentRegistry?: AgentRegistry;
     parentModel?: AgentModelInput;
 }
-export type AgentExecutionMode = 'foreground' | 'background';
 export interface PromotedSubagentInfo {
     jobId: string;
     label: string;

package/dist/agent/types/sdk-types.d.ts

@@ -131,6 +131,7 @@ export type AgentDefinition = {
     skills?: string[];
     initialPrompt?: string;
     maxTurns?: number;
+    maxToolUseIterations?: number;
     background?: boolean;
     memory?: 'user' | 'project' | 'local';
     effort?: EffortLevel | number;

package/dist/cli/commands/interactive/bootstrap.d.ts

@@ -14,6 +14,7 @@ interface BuildAgentSessionDeps {
     thinking: ThinkingConfig | undefined;
     effort: EffortLevel | undefined;
     maxOutputTokens: number | undefined;
+    maxToolUseIterations: number | undefined;
     providerFactory: (model: string | undefined) => ModelProvider;
     hookRegistry: HookRegistry;
     traceWriter: TraceWriter | undefined;

package/dist/cli/commands/interactive/shared.d.ts

@@ -21,7 +21,7 @@ export interface CliOptions {
     model: AgentModelInput;
     maxTurns: string;
     thinking?: string;
-    thinkingUi: ThinkingUiMode;
+    thinkingUi?: ThinkingUiMode;
     effort?: string;
     maxOutputTokens?: string;
     resume?: string;

package/dist/cli/commands/interactive.d.ts

@@ -1,11 +1,12 @@
 import { Command } from 'commander';
 import { type SkipReason } from './interactive/worktree-autoname.js';
 import { type CliConfig } from '../config.js';
-import type { CliOptions } from './interactive/shared.js';
+import type { CliOptions, ThinkingUiMode } from './interactive/shared.js';
 import { type UpdateInfo } from '../update-checker.js';
 export { formatToolResultLine } from './interactive/tool-lane.js';
 export declare function setInteractiveUpdateNotices(updateInfo: UpdateInfo | null, pendingMessage: string | null): void;
 export declare function formatAutonameSkipReason(reason: SkipReason | 'create-failed' | 'unknown', detail: string | undefined): string | undefined;
 export declare function isAutonameEnabled(options: CliOptions, config: CliConfig): boolean;
+export declare function resolveThinkingUi(options: CliOptions, config: CliConfig): ThinkingUiMode;
 export declare function startupHintLine(): string;
 export declare function registerInteractiveCommand(program: Command): void;

package/dist/cli/config.d.ts

@@ -49,6 +49,7 @@ export interface CliConfig {
         worktreeBranchPrefix?: string;
         worktreeBase?: string;
         suggestGhost?: boolean;
+        thinkingUi?: 'summary' | 'live' | 'digest' | 'off';
     };
     updatePolicy: 'notify' | 'auto' | 'off';
     autoResumeOnUsageLimit?: boolean;

package/dist/cli/elicitation/field-validation.d.ts

@@ -0,0 +1,35 @@
+export interface NumberValidationOptions {
+    allowSkip: boolean;
+    min?: number;
+    max?: number;
+    emptyError: string;
+}
+export type NumberValidationOutcome = {
+    ok: true;
+    skip: true;
+} | {
+    ok: true;
+    skip: false;
+    value: number;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function validateNumberField(input: string, opts: NumberValidationOptions): NumberValidationOutcome;
+export interface TextValidationOptions {
+    allowSkip: boolean;
+    minLength?: number;
+    maxLength?: number;
+    emptyError: string;
+}
+export type TextValidationOutcome = {
+    ok: true;
+    skip: true;
+} | {
+    ok: true;
+    skip: false;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function validateTextField(input: string, opts: TextValidationOptions): TextValidationOutcome;

package/dist/cli/shared-helpers.d.ts

@@ -23,6 +23,8 @@ export declare function getMaxBudgetUsd(): number | undefined;
 export declare function getTaskBudget(): number | undefined;
 export declare function parseMaxOutputTokens(raw: string | undefined): number | undefined;
 export declare function getMaxOutputTokens(): number | undefined;
+export declare function parseMaxToolUseIterations(raw: string | undefined): number | undefined;
+export declare function getMaxToolUseIterations(): number | undefined;
 export declare function parseProvider(raw: string | undefined, opts?: {
     subagentExecutor?: import('../agent/tools/subagent-executor.js').SubagentExecutor;
     skillExecutor?: import('../agent/tools/skill-executor.js').SkillExecutor;