agent-afk 5.293.1 → 5.295.0

package/dist/agent/done-evidence.d.ts

@@ -0,0 +1,9 @@
+export interface ToolEventMin {
+    toolName: string;
+    input: string;
+    isError?: boolean;
+}
+export declare const DONE_EVIDENCE_TOOLS: ReadonlySet<string>;
+export declare function isVerificationCommand(input: string): boolean;
+export declare function classifyDoneEvidence(toolEvents: readonly ToolEventMin[]): 'no-code-changes' | 'verified' | 'unverified';
+export declare function doneHasCorroboratingEvidence(toolEvents: readonly ToolEventMin[]): boolean;

package/dist/agent/facets/derive.pr-detect.d.ts

@@ -0,0 +1,3 @@
+import type { ToolEventInput } from './schema.js';
+export declare function lastOwnLinePrUrl(result: string): string | null;
+export declare function detectPrUrlFromEvents(events: readonly ToolEventInput[]): string | null;

package/dist/agent/facets/schema.d.ts

@@ -122,6 +122,7 @@ export declare const SubagentToolSummarySchema: z.ZodObject<{
     tool_calls: z.ZodNumber;
     tool_errors: z.ZodNumber;
     tool_counts: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    detected_pr_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 export type SubagentToolSummary = z.infer<typeof SubagentToolSummarySchema>;
 export declare const SessionFacetSchema: z.ZodObject<{
@@ -214,6 +215,7 @@ export declare const SessionFacetSchema: z.ZodObject<{
         tool_calls: z.ZodNumber;
         tool_errors: z.ZodNumber;
         tool_counts: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        detected_pr_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>>>;
 }, z.core.$loose>;
 export type SessionFacet = z.infer<typeof SessionFacetSchema>;

package/dist/agent/providers/openai-compatible/responses-translate.d.ts

@@ -27,6 +27,12 @@ export interface ResponsesStreamEvent {
         incomplete_details?: {
             reason?: string;
         };
+        error?: {
+            code?: string;
+            message?: string;
+        } | null;
     };
+    code?: string | null;
+    message?: string;
 }
 export declare function translateResponsesEvent(event: ResponsesStreamEvent, state: StreamState, sessionId: string): Generator<ProviderEvent>;

package/dist/agent/session/agent-session.d.ts

@@ -5,10 +5,12 @@ import type { ProviderCommandInfo, ProviderCompactResult, ProviderQuery, Provide
 import type { AccountInfo, AgentConfig, AgentInfo, AgentModelInput, IAgentSession, InputStreamRef, McpServerStatus, Message, ModelInfo, OutputEvent, PermissionMode, ResponseMetadata, RewindFilesResult, SDKControlGetContextUsageResponse, SendMessageOptions, SessionIdentity, SessionMetadata, SessionState, StructuredMessageOptions } from '../types.js';
 import type { ZodType } from 'zod';
 import type { ElicitationRequest } from '../types/sdk-types.js';
+import type { StopWiring } from '../types/session-types.js';
 import type { MessageJournal } from '../journal/index.js';
 export declare class AgentSession implements IAgentSession {
     private readonly ownedTraceWriter;
     private config;
+    private stopWiring;
     private readonly planExit;
     private currentState;
     private providerQuery;
@@ -45,6 +47,7 @@ export declare class AgentSession implements IAgentSession {
     sendMessageStream(content: string | ContentBlockParam[]): AsyncIterableIterator<OutputEvent>;
     interrupt(): Promise<void>;
     setBeforeNextRound(cb: (() => string | undefined) | undefined): void;
+    wireStopHook(wiring: StopWiring): void;
     reset(): Promise<void>;
     private onAbort;
     private makeConfigDeps;

package/dist/agent/session/hooks-dispatch.d.ts

@@ -1,4 +1,4 @@
-import type { HookRegistry, SessionEndContext, SessionStartContext } from '../hooks.js';
+import type { HookRegistry, SessionEndContext, SessionStartContext, StopContext } from '../hooks.js';
 import type { TraceSink } from '../trace/index.js';
 export interface SessionHookDispatchOptions {
     signal?: AbortSignal;
@@ -7,3 +7,14 @@ export interface SessionHookDispatchOptions {
 }
 export declare function dispatchSessionStart(registry: HookRegistry | undefined, context: SessionStartContext, options?: SessionHookDispatchOptions): Promise<string | undefined>;
 export declare function dispatchSessionEnd(registry: HookRegistry | undefined, context: SessionEndContext, options?: SessionHookDispatchOptions): Promise<void>;
+export interface StopHookDispatchOptions extends SessionHookDispatchOptions {
+    hasNextTurn: boolean;
+    surface?: string;
+}
+export interface StopHookDispatchResult {
+    injectContext?: string;
+    wasBlocked?: boolean;
+    blockedReason?: string;
+    wasTimeout?: boolean;
+}
+export declare function dispatchStopHook(registry: HookRegistry | undefined, context: StopContext, options: StopHookDispatchOptions): Promise<StopHookDispatchResult>;

package/dist/agent/session/stream-consumer.d.ts

@@ -1,8 +1,9 @@
 import type { ProviderEvent, ProviderUsage } from '../provider.js';
+import { type ToolEventAccumulator } from './stream-consumer.tool-events.js';
 import type { Message, OutputEvent, ResponseMetadata, SessionMetadata } from '../types.js';
 import { BudgetExceededError } from '../../utils/errors.js';
 import type { TraceSink } from '../trace/index.js';
-export type TransformDeps = {
+export type TransformDeps = ToolEventAccumulator & {
     conversationHistory: Message[];
     getSessionMetadata: () => SessionMetadata;
     setSessionMetadata: (updater: (prev: SessionMetadata) => SessionMetadata) => void;
@@ -12,7 +13,6 @@ export type TransformDeps = {
     maxBudgetUsd?: number;
     abortBudget?: (reason: BudgetExceededError) => void;
     _runningCostUsd?: number;
-    _successfulToolNames?: string[];
     traceWriter?: TraceSink;
 };
 export declare function parsePersistedOutput(content: string): {

package/dist/agent/session/stream-consumer.tool-events.d.ts

@@ -0,0 +1,16 @@
+import type { ProviderEvent } from '../provider.js';
+import type { ToolEventMin } from '../done-evidence.js';
+type ToolUseStartEvent = Extract<ProviderEvent, {
+    type: 'tool.use.start';
+}>;
+type ToolOutputEvent = Extract<ProviderEvent, {
+    type: 'tool.output';
+}>;
+export interface ToolEventAccumulator {
+    _successfulToolNames?: string[];
+    _pendingToolInputs?: Map<string, string>;
+    _turnToolEvents?: ToolEventMin[];
+}
+export declare function recordToolUseStart(acc: ToolEventAccumulator, event: ToolUseStartEvent): void;
+export declare function recordToolOutput(acc: ToolEventAccumulator, event: ToolOutputEvent): void;
+export {};

package/dist/agent/session/turn-stream-runner.d.ts

@@ -7,6 +7,7 @@ import type { SessionStateManager } from './session-state.js';
 import type { AgentConfig, OutputEvent, ResponseMetadata, SessionState } from '../types.js';
 import type { ProviderQuery, ProviderEvent } from '../provider.js';
 import type { Message } from '../types.js';
+import type { StopWiring } from '../types/session-types.js';
 export interface TurnRunnerDeps {
     getConfig: () => AgentConfig;
     getAbortController: () => AbortController;
@@ -31,6 +32,7 @@ export interface TurnRunnerDeps {
     getProviderQuery: () => ProviderQuery;
     getLedgerMetadata: () => ReturnType<SessionStateManager['getSessionMetadata']>;
     observeProviderEvent?: (event: ProviderEvent) => void;
+    getStopWiring?: () => StopWiring | undefined;
 }
 export declare class TurnStreamRunner {
     private readonly deps;

package/dist/agent/session/turn-stream-runner.stop.d.ts

@@ -0,0 +1,13 @@
+import type { AgentConfig } from '../types.js';
+import type { Message } from '../types.js';
+import type { StopWiring } from '../types/session-types.js';
+import { type ToolEventMin } from '../done-evidence.js';
+export interface TurnStopParams {
+    config: AgentConfig;
+    wiring: StopWiring | undefined;
+    sessionId: string | undefined;
+    signal: AbortSignal;
+    conversationHistory: readonly Message[];
+    toolEvents: readonly ToolEventMin[];
+}
+export declare function dispatchTurnStop(p: TurnStopParams): Promise<void>;

package/dist/agent/terminal-state-gate.d.ts

@@ -0,0 +1,10 @@
+import type { HookHandler } from './hooks.js';
+import type { PermissionMode } from './types/sdk-types.js';
+export declare const DEFAULT_MAX_TERMINAL_STATE_INJECTIONS = 3;
+export declare const TERMINAL_STATE_GATE_CORRECTION: string;
+export interface TerminalStateGateOptions {
+    getPermissionMode: () => PermissionMode;
+    isEnabled: () => boolean;
+    maxInjectionsPerSession?: number;
+}
+export declare function createTerminalStateGate(opts: TerminalStateGateOptions): HookHandler;

package/dist/agent/tools/handlers/wait-for.limits.d.ts

@@ -0,0 +1,2 @@
+export declare const TIMED_OUT_HINT = "Condition not met within the timeout. Call wait_for again if it is still needed.";
+export declare function clampNotes(raw: unknown): string[];

package/dist/agent/trace/events.d.ts

@@ -94,6 +94,7 @@ export declare const HookEventNameSchema: z.ZodEnum<{
     PostToolUseFailure: "PostToolUseFailure";
     SessionStart: "SessionStart";
     SessionEnd: "SessionEnd";
+    Stop: "Stop";
     SubagentStart: "SubagentStart";
     SubagentStop: "SubagentStop";
 }>;
@@ -104,6 +105,7 @@ export declare const HookDecisionPayloadSchema: z.ZodObject<{
         PostToolUseFailure: "PostToolUseFailure";
         SessionStart: "SessionStart";
         SessionEnd: "SessionEnd";
+        Stop: "Stop";
         SubagentStart: "SubagentStart";
         SubagentStop: "SubagentStop";
     }>;
@@ -459,6 +461,7 @@ export declare const TraceEventInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject
             PostToolUseFailure: "PostToolUseFailure";
             SessionStart: "SessionStart";
             SessionEnd: "SessionEnd";
+            Stop: "Stop";
             SubagentStart: "SubagentStart";
             SubagentStop: "SubagentStop";
         }>;
@@ -765,6 +768,7 @@ export declare const TraceEventInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject
             connection_retry: "connection_retry";
             usage_notice: "usage_notice";
             tool_degraded: "tool_degraded";
+            stop_inject_dropped: "stop_inject_dropped";
         }>;
         durationMs: z.ZodOptional<z.ZodNumber>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
@@ -836,6 +840,7 @@ export declare const TraceEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             PostToolUseFailure: "PostToolUseFailure";
             SessionStart: "SessionStart";
             SessionEnd: "SessionEnd";
+            Stop: "Stop";
             SubagentStart: "SubagentStart";
             SubagentStop: "SubagentStop";
         }>;
@@ -1168,6 +1173,7 @@ export declare const TraceEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             connection_retry: "connection_retry";
             usage_notice: "usage_notice";
             tool_degraded: "tool_degraded";
+            stop_inject_dropped: "stop_inject_dropped";
         }>;
         durationMs: z.ZodOptional<z.ZodNumber>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;

package/dist/agent/trace/events.session-phase.d.ts

@@ -32,6 +32,7 @@ export declare const SessionPhaseNameSchema: z.ZodEnum<{
     connection_retry: "connection_retry";
     usage_notice: "usage_notice";
     tool_degraded: "tool_degraded";
+    stop_inject_dropped: "stop_inject_dropped";
 }>;
 export declare const SessionPhasePayloadSchema: z.ZodObject<{
     phase: z.ZodEnum<{
@@ -67,6 +68,7 @@ export declare const SessionPhasePayloadSchema: z.ZodObject<{
         connection_retry: "connection_retry";
         usage_notice: "usage_notice";
         tool_degraded: "tool_degraded";
+        stop_inject_dropped: "stop_inject_dropped";
     }>;
     durationMs: z.ZodOptional<z.ZodNumber>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;

package/dist/agent/trace/types.d.ts

@@ -30,7 +30,7 @@ export interface ToolCallCompletedPayload {
     testResult?: import('../tools/handlers/test-runner-detector.js').TestResult;
 }
 export type ToolCallPayload = ToolCallStartedPayload | ToolCallCompletedPayload;
-export type HookEventName = 'PreToolUse' | 'PostToolUse' | 'PostToolUseFailure' | 'SessionStart' | 'SessionEnd' | 'SubagentStart' | 'SubagentStop';
+export type HookEventName = 'PreToolUse' | 'PostToolUse' | 'PostToolUseFailure' | 'SessionStart' | 'SessionEnd' | 'Stop' | 'SubagentStart' | 'SubagentStop';
 export type AfkApprovalOutcome = 'carve-out' | 'approved' | 'denied' | 'unrecognised' | 'timeout' | 'decline' | 'cancel' | 'hard-block';
 export interface HookDecisionPayload {
     hookEvent: HookEventName;

package/dist/agent/trace/types.session-phase.d.ts

@@ -1,4 +1,4 @@
-export type SessionPhaseName = 'bootstrap_start' | 'bootstrap_done' | 'session_init_start' | 'session_init_done' | 'mcp_connect_start' | 'mcp_connect_done' | 'mcp_server_start' | 'mcp_server_done' | 'loop_start' | 'loop_end' | 'model_ttfb' | 'interrupt_halt' | 'rate_limit' | 'ttfb_timeout' | 'usage_limit_pause' | 'usage_limit_resume' | 'overload_pause' | 'overload_resume' | 'idle_watchdog_fired' | 'pause_extension_granted' | 'suspected_loop' | 'compaction_disabled' | 'boot_warning' | 'workspace_subscribed' | 'workspace_delivery' | 'gate_shape' | 'session_id_assigned' | 'many_image_degraded' | 'stream_accepted_after_drop' | 'connection_retry' | 'usage_notice' | 'tool_degraded';
+export type SessionPhaseName = 'bootstrap_start' | 'bootstrap_done' | 'session_init_start' | 'session_init_done' | 'mcp_connect_start' | 'mcp_connect_done' | 'mcp_server_start' | 'mcp_server_done' | 'loop_start' | 'loop_end' | 'model_ttfb' | 'interrupt_halt' | 'rate_limit' | 'ttfb_timeout' | 'usage_limit_pause' | 'usage_limit_resume' | 'overload_pause' | 'overload_resume' | 'idle_watchdog_fired' | 'pause_extension_granted' | 'suspected_loop' | 'compaction_disabled' | 'boot_warning' | 'workspace_subscribed' | 'workspace_delivery' | 'gate_shape' | 'session_id_assigned' | 'many_image_degraded' | 'stream_accepted_after_drop' | 'connection_retry' | 'usage_notice' | 'tool_degraded' | 'stop_inject_dropped';
 export interface SessionPhasePayload {
     phase: SessionPhaseName;
     durationMs?: number;

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

@@ -150,6 +150,7 @@ export interface IAgentSession {
     sendMessageStructured?<T>(content: string, schema: ZodType<T>, options?: StructuredMessageOptions): Promise<T>;
     interrupt(): Promise<void>;
     setBeforeNextRound?(cb: (() => string | undefined) | undefined): void;
+    wireStopHook?(wiring: StopWiring): void;
     reset(): Promise<void>;
     readonly abortSignal: AbortSignal;
     abort(reason: string): void;
@@ -181,3 +182,9 @@ export interface IAgentSession {
     rewindConversation(turnIndex: number): Promise<ProviderRewindConversationResult>;
     close(): Promise<void>;
 }
+export interface StopWiring {
+    getHasNextTurn: () => boolean;
+    onStopInjectContext?: (text: string) => void;
+    onStopBlocked?: (reason: string | undefined) => void;
+    onStopTimeout?: () => void;
+}

package/dist/cli/_lib/stream-renderer-process.d.ts

@@ -26,6 +26,7 @@ export interface ProcessCtx {
     coordinator: CommitCoordinator;
     childActivity: ChildActivityTracker;
     inFlightTools: InFlightToolTracker;
+    rootTools: InFlightToolTracker;
     sources: Map<string, SourceState>;
     subagentMarkdown: Map<string, StreamingMarkdownRenderer>;
     lastProgressByTask: Map<string, ProgressEvent>;

package/dist/cli/_lib/stream-renderer.d.ts

@@ -35,6 +35,7 @@ export declare class StreamRenderer {
     private lastProgressByTask;
     private childActivity;
     private inFlightTools;
+    private rootTools;
     private disposed;
     private toolLaneFlash;
     private smoke;

package/dist/cli/commands/chat.session-wiring.d.ts

@@ -0,0 +1,7 @@
+import type { AgentSession } from '../../agent/session.js';
+type SubagentCompletionArgs = Parameters<AgentSession['recordSubagentCompletion']>;
+export interface SubagentSuccessSource {
+    setOnSubagentSucceeded(cb: (...args: SubagentCompletionArgs) => void): void;
+}
+export declare function wireOneShotChatSession(session: AgentSession, sources: readonly SubagentSuccessSource[]): void;
+export {};

package/dist/cli/commands/interactive/loop-iteration.stop-wiring.d.ts

@@ -0,0 +1,3 @@
+import type { StopWiring } from '../../../agent/types/session-types.js';
+import type { InteractiveCtx } from './shared.js';
+export declare function wireReplStopHook(ctx: InteractiveCtx, setPendingStopInjection: (text: string) => void): StopWiring;

package/dist/cli/commands/interactive/terminal-state-gate.d.ts

@@ -1,10 +1 @@
-import type { HookHandler } from '../../../agent/hooks.js';
-import type { PermissionMode } from '../../../agent/types/sdk-types.js';
-export declare const DEFAULT_MAX_TERMINAL_STATE_INJECTIONS = 3;
-export declare const TERMINAL_STATE_GATE_CORRECTION: string;
-export interface TerminalStateGateOptions {
-    getPermissionMode: () => PermissionMode;
-    isEnabled: () => boolean;
-    maxInjectionsPerSession?: number;
-}
-export declare function createTerminalStateGate(opts: TerminalStateGateOptions): HookHandler;
+export { DEFAULT_MAX_TERMINAL_STATE_INJECTIONS, TERMINAL_STATE_GATE_CORRECTION, type TerminalStateGateOptions, createTerminalStateGate, } from '../../../agent/terminal-state-gate.js';

package/dist/cli/input/spinner.d.ts

@@ -3,6 +3,7 @@ export interface SpinnerControllerOptions {
     onTick: () => void;
     goblin?: boolean;
     workVerb?: () => string | undefined;
+    contextTip?: () => string | undefined;
 }
 export declare class SpinnerController {
     private state;
@@ -11,6 +12,7 @@ export declare class SpinnerController {
     private readonly onTick;
     private readonly goblin;
     private readonly workVerb;
+    private readonly contextTip;
     constructor(opts: SpinnerControllerOptions);
     private pickVerb;
     set(config: {

package/dist/cli/input/work-derived-verb.d.ts

@@ -3,11 +3,18 @@ export declare class InFlightToolTracker {
     private readonly inFlight;
     start(toolUseId: string, toolName: string): void;
     finish(toolUseId: string): void;
+    has(toolName: string): boolean;
     current(): string | undefined;
     reset(): void;
 }
+export declare const WAIT_HINT_TOOL = "wait_for";
+export declare function waitHintText(state: {
+    waiting: boolean;
+    queued: boolean;
+}): string | undefined;
 export interface ActiveToolNameSink {
     setActiveToolName?(toolName: string | undefined): void;
+    setRootWaitActive?(active: boolean): void;
 }
 interface MaybeToolEvent {
     type: string;
@@ -18,4 +25,5 @@ interface MaybeToolEvent {
     };
 }
 export declare function noteToolEvent(event: MaybeToolEvent, tracker: InFlightToolTracker, sink: ActiveToolNameSink | null | undefined): boolean;
+export declare function noteRootWaitEvent(event: MaybeToolEvent, tracker: InFlightToolTracker, sink: ActiveToolNameSink | null | undefined): boolean;
 export {};

package/dist/cli/terminal-compositor.d.ts

@@ -66,6 +66,7 @@ export declare class TerminalCompositor {
     disarmRows: number;
     readonly spinnerController: SpinnerController;
     private activeToolName;
+    private rootWaitActive;
     readonly caretBlinkController: CaretBlinkController;
     repaintCount: number;
     pendingTrailingRepaint: boolean;
@@ -128,6 +129,7 @@ export declare class TerminalCompositor {
         rotateVerbEveryMs?: number;
     }): void;
     setActiveToolName(toolName: string | undefined): void;
+    setRootWaitActive(active: boolean): void;
     commitAbove(text: string): void;
     clearCommittedBand(): void;
     forgetCommittedBand(): void;

package/dist/cli/terminal-compositor.scrollback.d.ts

@@ -8,4 +8,4 @@ export declare function buildBandMeta(logicalLines: readonly string[], width: nu
 export declare function scrollbackFlushLines(rows: readonly string[], meta: readonly BandRowMeta[] | undefined, count: number): string[];
 export declare function snapFlushCountToLogicalBoundary(meta: readonly BandRowMeta[] | undefined, count: number, total: number): number;
 export declare function buildScrollbackArchiveEscape(lines: readonly string[], anchorFloor: number, bottomRow: number, width: number): string;
-export declare function formatTipRow(text: string, cols: number): string;
+export declare function formatTipRow(text: string, cols: number, label?: string): string;