agent-afk 5.67.0 → 5.69.0

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

@@ -32,6 +32,7 @@ export declare class SubagentHandleImpl<T> implements SubagentHandle<T> {
     private readonly agentType?;
     private readonly traceWriter?;
     private readonly onSubagentSucceeded?;
+    private readonly idleTimeoutMs;
     private currentStatus;
     private inFlight;
     private lastMessage;
@@ -44,7 +45,7 @@ export declare class SubagentHandleImpl<T> implements SubagentHandle<T> {
     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);
+    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, idleTimeoutMs?: number);
     get status(): SubagentStatus;
     run(prompt: string, sinkOverride?: SubagentProgressSink): Promise<Message>;
     private streamToFinalMessage;

package/dist/agent/subagent/idle-watchdog.d.ts

@@ -0,0 +1,24 @@
+import type { OutputEvent } from '../types/session-types.js';
+export declare const IDLE_WATCHDOG_PAUSE_SLACK_MS = 30000;
+export declare class IdleWatchdog {
+    private readonly controller;
+    private readonly idleTimeoutMs;
+    private readonly label;
+    private readonly onFire?;
+    private timer;
+    private disposed;
+    private fired;
+    private readonly inFlightTools;
+    constructor(controller: AbortController, idleTimeoutMs: number, label: string, onFire?: ((info: {
+        idleTimeoutMs: number;
+        elapsedSinceLastProgressMs: number;
+        lastEventType: string;
+    }) => void) | undefined);
+    private isEnabled;
+    onEvent(event: OutputEvent): void;
+    private pausedWindowMs;
+    private arm;
+    private clearTimer;
+    private fire;
+    dispose(): void;
+}

package/dist/agent/subagent.d.ts

@@ -15,6 +15,8 @@ export declare const DENY_ELICITATION: NonNullable<AgentConfig['onElicitation']>
 export declare const SUBAGENT_DEFAULT_MAX_TOOL_USE_ITERATIONS = 50;
 export declare const SUBAGENT_DEFAULT_TIMEOUT_MS: number;
 export declare function resolveSubagentTimeoutMs(): number;
+export declare const SUBAGENT_DEFAULT_IDLE_TIMEOUT_MS: number;
+export declare function resolveSubagentIdleTimeoutMs(): number;
 export declare const SUBAGENT_BACKGROUND_TIMEOUT_MS: number;
 export interface ForkParent {
     sessionId?: string;

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

@@ -61,6 +61,7 @@ export declare class SessionToolDispatcher implements ToolDispatcher {
     private readonly maxOutputBytes;
     private repeatBreaker;
     private denialBreaker;
+    private suspectedLoopWindow;
     private readonly grantManager;
     constructor(opts: SessionToolDispatcherOptions);
     private get handlerContext();
@@ -74,6 +75,7 @@ export declare class SessionToolDispatcher implements ToolDispatcher {
     get toolDefs(): readonly AnthropicToolDef[];
     private checkReadOnlyBash;
     private checkRepeatCircuitBreaker;
+    private observeSuspectedLoop;
     private recordForkReadDenial;
     private resetDenialBreaker;
     private runCanUseTool;

package/dist/agent/tools/suspected-loop-detector.d.ts

@@ -0,0 +1,15 @@
+import type { ToolCall } from '../providers/anthropic-direct/types.js';
+export declare const SUSPECTED_LOOP_THRESHOLD = 5;
+export declare const SUSPECTED_LOOP_WINDOW_SIZE = 20;
+export interface SuspectedLoopWindow {
+    recent: string[];
+    firedFingerprints: Set<string>;
+}
+export declare function createSuspectedLoopWindow(): SuspectedLoopWindow;
+export declare function fingerprintToolCall(call: ToolCall): string;
+export interface SuspectedLoopObservation {
+    fired: boolean;
+    count: number;
+}
+export declare function countInWindow(recent: readonly string[], fingerprint: string): number;
+export declare function observeToolCall(window: SuspectedLoopWindow, fingerprint: string): SuspectedLoopObservation;

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

@@ -483,6 +483,8 @@ export declare const SessionPhaseNameSchema: z.ZodEnum<{
     rate_limit: "rate_limit";
     usage_limit_pause: "usage_limit_pause";
     usage_limit_resume: "usage_limit_resume";
+    idle_watchdog_fired: "idle_watchdog_fired";
+    suspected_loop: "suspected_loop";
 }>;
 export declare const SessionPhasePayloadSchema: z.ZodObject<{
     phase: z.ZodEnum<{
@@ -500,6 +502,8 @@ export declare const SessionPhasePayloadSchema: z.ZodObject<{
         rate_limit: "rate_limit";
         usage_limit_pause: "usage_limit_pause";
         usage_limit_resume: "usage_limit_resume";
+        idle_watchdog_fired: "idle_watchdog_fired";
+        suspected_loop: "suspected_loop";
     }>;
     durationMs: z.ZodOptional<z.ZodNumber>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
@@ -823,6 +827,8 @@ export declare const TraceEventInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject
             rate_limit: "rate_limit";
             usage_limit_pause: "usage_limit_pause";
             usage_limit_resume: "usage_limit_resume";
+            idle_watchdog_fired: "idle_watchdog_fired";
+            suspected_loop: "suspected_loop";
         }>;
         durationMs: z.ZodOptional<z.ZodNumber>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
@@ -1154,6 +1160,8 @@ export declare const TraceEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             rate_limit: "rate_limit";
             usage_limit_pause: "usage_limit_pause";
             usage_limit_resume: "usage_limit_resume";
+            idle_watchdog_fired: "idle_watchdog_fired";
+            suspected_loop: "suspected_loop";
         }>;
         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

@@ -201,7 +201,7 @@ export interface BrowserEventPayload {
     };
     durationMs: number;
 }
-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' | 'rate_limit' | 'usage_limit_pause' | 'usage_limit_resume';
+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' | 'rate_limit' | 'usage_limit_pause' | 'usage_limit_resume' | 'idle_watchdog_fired' | 'suspected_loop';
 export interface SessionPhasePayload {
     phase: SessionPhaseName;
     durationMs?: number;

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

@@ -64,6 +64,7 @@ export interface AgentConfig {
     persistSession?: boolean;
     abortSignal?: AbortSignal;
     timeoutMs?: number;
+    idleTimeoutMs?: number;
     hookRegistry?: HookRegistry;
     planExitControls?: PlanExitControls;
     traceWriter?: TraceWriter;

package/dist/bundled-plugins/awa-bundled/skills/contract/SKILL.md

@@ -17,6 +17,8 @@ For each sub-agent you plan to dispatch, define a schema before the call:
 
 Embed the schema at the top of every sub-agent's prompt and require results in that exact shape. Instruct each sub-agent explicitly: "Return ONLY the schema fields. No preamble, no analysis prose, no explanation — begin your response with the first schema field." When sub-agents return, validate field-by-field. If any artifact is missing, malformed, or wrapped in prose, re-dispatch only the failing sub-agent with the gap cited. Merge only schema-valid responses.
 
+Also instruct each sub-agent to stop on non-convergence: if repeated attempts at the same sub-goal stop making progress after a few tries, do not keep retrying — return the best partial result through the schema's designated failure/partial channel (`failure_modes`, or whatever blocked/`unverified` field that agent's schema defines), naming what could not be resolved. Activity is not progress.
+
 ## Epistemic confidence
 
 Recommended for all sub-agents. Add to your return schema: