agent-afk 5.23.1 → 5.24.0

package/dist/agent/providers/anthropic-direct/query/retry-layer.d.ts

@@ -1,6 +1,8 @@
 import type Anthropic from '@anthropic-ai/sdk';
 import type { ProviderEvent } from '../../../provider.js';
 import type { AuthMode, RunTurnInput } from '../types.js';
+export declare const RATE_LIMIT_TRANSIENT_MAX_RETRIES = 3;
+export declare const RATE_LIMIT_RETRY_MAX_WAIT_MS = 120000;
 export interface RetryLayerOptions {
     client: Anthropic;
     authMode: AuthMode;

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/subagent/handle.d.ts

@@ -43,6 +43,7 @@ export declare class SubagentHandleImpl<T> implements SubagentHandle<T> {
     private parentId;
     private currentTrace;
     private lastStreamedContent;
+    private lastStopReason;
     constructor(id: string, session: IAgentSession, controller: AbortController, abortGraph: AbortGraph, outputSchema: ZodType<T> | undefined, timeoutMs: number, hookRegistry: HookRegistry | undefined, onTerminal: () => void, parentInputStreamRef?: ReturnType<IAgentSession["getInputStreamRef"]> | undefined, parentAbortSignal?: AbortSignal | undefined, agentType?: string | undefined, progressSink?: SubagentProgressSink, parentId?: string, traceWriter?: TraceWriter | undefined, onSubagentSucceeded?: ((usage: SubagentTrace["usage"], costUsd: number | undefined) => void) | undefined);
     get status(): SubagentStatus;
     run(prompt: string, sinkOverride?: SubagentProgressSink): Promise<Message>;

package/dist/agent/subagent/result.d.ts

@@ -37,9 +37,10 @@ export interface SubagentResult<T = unknown> {
     completionPercent?: number;
     trace?: SubagentTrace;
     signal?: Signal;
+    stopReason?: string;
 }
-export declare function buildResultFromMessage<T>(id: string, status: SubagentStatus, message: Message, outputSchema: ZodType<T> | undefined, trace?: SubagentTrace): SubagentResult<T>;
-export declare function buildResultFromError<T>(id: string, status: SubagentStatus, err: unknown, trace?: SubagentTrace): SubagentResult<T>;
+export declare function buildResultFromMessage<T>(id: string, status: SubagentStatus, message: Message, outputSchema: ZodType<T> | undefined, trace?: SubagentTrace, stopReason?: string): SubagentResult<T>;
+export declare function buildResultFromError<T>(id: string, status: SubagentStatus, err: unknown, trace?: SubagentTrace, stopReason?: string): SubagentResult<T>;
 export declare function describeFailure(result: Pick<SubagentResult, 'status' | 'error'>): string;
 export interface SubagentExecutionError extends Error {
     partialOutput?: unknown;

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/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;