agent-afk 5.302.13 → 5.303.0

package/dist/agent/journal/journal-file.d.ts

@@ -26,6 +26,7 @@ export declare class JournalFileWriter {
     private len;
     constructor(shared: JournalSessionShared, subagentId?: string | undefined);
     get length(): number;
+    get path(): string | undefined;
     get isClosed(): boolean;
     record(input: JournalRecordInput): void;
     private recordUnsafe;

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

@@ -121,6 +121,7 @@ export type JournalRecordInput = Omit<Extract<JournalRecord, {
     kind: 'mark';
 }>, 'v' | 'ts'>;
 export interface MessageJournal {
+    readonly path?: string;
     readonly length: number;
     append(index: number, message: JournalMessage): void;
     truncate(length: number, reason?: JournalTruncateReason): void;

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

@@ -56,9 +56,9 @@ export declare const VerifiedOutcomeSchema: z.ZodObject<{
     self_report: z.ZodEnum<{
         done: "done";
         blocked: "blocked";
+        none: "none";
         asking: "asking";
         interrupted: "interrupted";
-        none: "none";
     }>;
     artifacts: z.ZodObject<{
         commits: z.ZodArray<z.ZodString>;

package/dist/agent/provider.d.ts

@@ -44,6 +44,8 @@ export interface ProviderProgress {
     taskId: string;
     description: string;
     summary?: string;
+    roundsUsed?: number;
+    budget?: number;
     lastToolName?: string;
     totalTokens: number;
     toolUses: number;

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

@@ -0,0 +1,19 @@
+import type { AnthropicMessagesCreateParams } from '../types.js';
+export declare class ConnectionOverloadExhaustedError extends Error {
+    constructor();
+}
+export interface ConnectionRetryInfo {
+    attempt: number;
+    delayMs: number;
+    error: Error;
+}
+export interface ConnectionLifecycleInfo {
+    phase: 'connection_failure' | 'connection_recovered' | 'connection_budget_exhausted';
+    metadata: Record<string, string | number | boolean>;
+}
+export declare function createWithRetry(client: {
+    messages: {
+        create(params: unknown, opts: unknown): unknown;
+    };
+    baseURL?: string;
+}, params: AnthropicMessagesCreateParams, headers: Record<string, string>, requestSignal: AbortSignal, turnSignal: AbortSignal, onConnectionRetry?: (info: ConnectionRetryInfo) => void, onLifecycle?: (info: ConnectionLifecycleInfo) => void): Promise<AsyncIterable<unknown>>;

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

@@ -2,19 +2,10 @@ import type { ProviderEvent } from '../../../provider.js';
 import type { AnthropicMessagesCreateParams, AnthropicToolDef, RunTurnInput, WireToolDef } from '../types.js';
 import { type FirstByteTimeoutHandle } from '../../shared/first-byte-timeout.js';
 import { type StreamStallHandle } from '../../shared/stream-stall-timeout.js';
-import { type RoundRetryBudget } from './retry-budget.js';
+import type { RoundRetryBudget } from './retry-budget.js';
 import type { TurnAccumulator } from './turn-accumulator.js';
 export declare function toWireTool(tool: AnthropicToolDef): WireToolDef;
-export declare function createWithRetry(client: {
-    messages: {
-        create(params: unknown, opts: unknown): unknown;
-    };
-}, params: AnthropicMessagesCreateParams, headers: Record<string, string>, requestSignal: AbortSignal, turnSignal: AbortSignal, onConnectionRetry?: (info: ConnectionRetryInfo) => void): Promise<AsyncIterable<unknown>>;
-export interface ConnectionRetryInfo {
-    attempt: number;
-    delayMs: number;
-    error: Error;
-}
+export { createWithRetry, type ConnectionRetryInfo } from './connection-create.js';
 export interface OpenRoundTransport {
     kind: 'opened';
     events: AsyncIterable<unknown>;

package/dist/agent/providers/openai-compatible/query/stream-drive.connection.d.ts

@@ -6,4 +6,4 @@ export type ConnectionOutcome<TEvent> = {
     ok: false;
     error: unknown;
 };
-export declare function runConnectionPhase<TEvent>(createStream: (signal: AbortSignal) => Promise<AsyncIterable<TEvent>>, streamSignal: AbortSignal, userSignal: AbortSignal, traceWriter: TraceSink | undefined, resolvedModel: string): Promise<ConnectionOutcome<TEvent>>;
+export declare function runConnectionPhase<TEvent>(createStream: (signal: AbortSignal) => Promise<AsyncIterable<TEvent>>, streamSignal: AbortSignal, userSignal: AbortSignal, traceWriter: TraceSink | undefined, resolvedModel: string, endpoint?: string): Promise<ConnectionOutcome<TEvent>>;

package/dist/agent/providers/openai-compatible/query/stream-drive.d.ts

@@ -17,6 +17,7 @@ export interface StreamDriveContext {
     traceWriter: TraceSink | undefined;
     initSessionId: string;
     currentModel: string;
+    endpoint?: string;
     isClosed: () => boolean;
     ttfbTimeoutMs?: number;
     stallTimeoutMs?: number;

package/dist/agent/providers/shared/connection-loop-lag.d.ts

@@ -0,0 +1,4 @@
+export declare function connectionLoopLag(): {
+    loopLagP99Ms: number;
+    loopLagMaxMs: number;
+};

package/dist/agent/providers/shared/connection-retry-budget.d.ts

@@ -0,0 +1,10 @@
+export declare const CONNECT_WAIT_CAP_MS = 8000;
+export declare function connectRetryBudgetMs(): number | undefined;
+export declare class ConnectionRetryBudget {
+    readonly startedAt: number;
+    readonly budgetMs: number | undefined;
+    elapsedMs(): number;
+    canRetry(attempt: number, legacyMax: number): boolean;
+    delay(legacyDelay: number, baseMs: number, attempt: number): number;
+}
+export declare function connectionFailureMetadata(error: unknown, budget: ConnectionRetryBudget, endpoint?: string): Record<string, string | number | boolean>;

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

@@ -4,3 +4,4 @@ export declare const WIND_DOWN_NOTE: string;
 export declare function resolveMaxToolIterations(configured: number | undefined): number;
 export declare function shouldWindDown(completedRounds: number, maxIterations: number): boolean;
 export declare function formatRoundLabel(round: number, maxIterations: number): string;
+export declare function roundDeliveryNotice(completedRounds: number, budget: number): string | null;

package/dist/agent/subagent/capped-handoff.d.ts

@@ -0,0 +1,26 @@
+import type { Message, IAgentSession, OutputEvent } from '../types.js';
+import type { SubagentHandleImpl } from './handle.js';
+import { TOOL_USE_LOOP_CAPPED } from '../providers/shared/tool-loop-cap.js';
+export declare function isNarrationOnly(text: string): boolean;
+export declare class CappedHandoffAccumulator {
+    private priorText;
+    private roundText;
+    private lastMessage;
+    private roundsUsed;
+    private budget;
+    private historyLengthAtStart;
+    setHistoryBaseline(length: number): void;
+    onEvent(event: OutputEvent): void;
+    finish(finalMessage: Message | undefined, session: IAgentSession): Message;
+}
+export declare function emitSuccessfulHandoff<T>(handle: SubagentHandleImpl<T>, message: Message, startTime: number): Promise<void>;
+export interface CappedHandoff {
+    incomplete: true;
+    incompleteReason: typeof TOOL_USE_LOOP_CAPPED;
+    roundsUsed?: number;
+    budget?: number;
+    journalPath?: string;
+    salvaged?: true;
+}
+export declare function cappedHandoffFields(message: Message, stopReason: string | undefined): Partial<CappedHandoff>;
+export declare function salvageCappedMessage(finalMessage: Message | undefined, buffered: string, priorText: string, fields: Omit<CappedHandoff, 'incomplete' | 'incompleteReason'>): Message;

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

@@ -1,5 +1,6 @@
 import type { ZodError, ZodType } from 'zod';
 import type { Message } from '../types.js';
+import { type CappedHandoff } from './capped-handoff.js';
 import { type Signal } from '../signal-block.js';
 export type SubagentStatus = 'idle' | 'running' | 'succeeded' | 'failed' | 'cancelled';
 export declare const STREAM_INCOMPLETE = "stream_incomplete";
@@ -33,7 +34,7 @@ export interface SubagentTrace {
     };
 }
 export declare function createEmptyTrace(): SubagentTrace;
-export interface SubagentResult<T = unknown> {
+export interface SubagentResult<T = unknown> extends Partial<CappedHandoff> {
     id: string;
     status: SubagentStatus;
     message?: Message;

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

@@ -633,6 +633,9 @@ export declare const TraceEventInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject
             stream_accepted_after_drop: "stream_accepted_after_drop";
             connection_retry: "connection_retry";
             connection_retry_exhausted: "connection_retry_exhausted";
+            connection_failure: "connection_failure";
+            connection_recovered: "connection_recovered";
+            connection_budget_exhausted: "connection_budget_exhausted";
             usage_notice: "usage_notice";
             tool_degraded: "tool_degraded";
             strategy_nudge_fired: "strategy_nudge_fired";
@@ -1046,6 +1049,9 @@ export declare const TraceEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             stream_accepted_after_drop: "stream_accepted_after_drop";
             connection_retry: "connection_retry";
             connection_retry_exhausted: "connection_retry_exhausted";
+            connection_failure: "connection_failure";
+            connection_recovered: "connection_recovered";
+            connection_budget_exhausted: "connection_budget_exhausted";
             usage_notice: "usage_notice";
             tool_degraded: "tool_degraded";
             strategy_nudge_fired: "strategy_nudge_fired";

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

@@ -31,6 +31,9 @@ export declare const SessionPhaseNameSchema: z.ZodEnum<{
     stream_accepted_after_drop: "stream_accepted_after_drop";
     connection_retry: "connection_retry";
     connection_retry_exhausted: "connection_retry_exhausted";
+    connection_failure: "connection_failure";
+    connection_recovered: "connection_recovered";
+    connection_budget_exhausted: "connection_budget_exhausted";
     usage_notice: "usage_notice";
     tool_degraded: "tool_degraded";
     strategy_nudge_fired: "strategy_nudge_fired";
@@ -74,6 +77,9 @@ export declare const SessionPhasePayloadSchema: z.ZodObject<{
         stream_accepted_after_drop: "stream_accepted_after_drop";
         connection_retry: "connection_retry";
         connection_retry_exhausted: "connection_retry_exhausted";
+        connection_failure: "connection_failure";
+        connection_recovered: "connection_recovered";
+        connection_budget_exhausted: "connection_budget_exhausted";
         usage_notice: "usage_notice";
         tool_degraded: "tool_degraded";
         strategy_nudge_fired: "strategy_nudge_fired";

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

@@ -55,6 +55,12 @@ export interface SubagentStartedPayload {
     maxToolUseIterations?: number;
 }
 export interface SubagentSucceededPayload {
+    incomplete?: true;
+    incompleteReason?: string;
+    roundsUsed?: number;
+    budget?: number;
+    journalPath?: string;
+    salvaged?: true;
     transition: 'succeeded';
     subagentId: string;
     durationMs: number;

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' | 'connection_retry_exhausted' | 'usage_notice' | 'tool_degraded' | 'strategy_nudge_fired' | 'stop_inject_dropped' | 'stop_hook_continuation' | 'stop_hook_cap_reached' | 'orphan_repair' | 'background_process_started' | 'background_process_settled';
+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' | 'connection_retry_exhausted' | 'connection_failure' | 'connection_recovered' | 'connection_budget_exhausted' | 'usage_notice' | 'tool_degraded' | 'strategy_nudge_fired' | 'stop_inject_dropped' | 'stop_hook_continuation' | 'stop_hook_cap_reached' | 'orphan_repair' | 'background_process_started' | 'background_process_settled';
 export interface SessionPhasePayload {
     phase: SessionPhaseName;
     durationMs?: number;

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

@@ -120,6 +120,8 @@ export interface ProgressEvent {
     taskId: string;
     description: string;
     summary?: string;
+    roundsUsed?: number;
+    budget?: number;
     lastToolName?: string;
     totalTokens: number;
     toolUses: number;