agent-afk 5.294.0 → 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/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/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/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';