agent-afk 5.302.4 → 5.302.6

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

@@ -25,6 +25,8 @@ export interface WireExecutorsOptions {
     traceWriter?: TraceSink;
     skillTraceWriter?: TraceSink;
     backgroundRegistry?: BackgroundAgentRegistry;
+    backgroundAutoWake?: () => boolean;
+    backgroundAutoDeliver?: () => boolean;
     agentRegistryWarn?: (message: string) => void;
     workspaceStore?: WorkspaceStore;
     sessionLabel?: string;

package/dist/agent/shell-jobs/process-jobs.d.ts

@@ -1,4 +1,5 @@
 import { EventEmitter } from 'node:events';
+import type { TraceSink } from '../trace/index.js';
 export type ProcessJobStatus = 'running' | 'completed' | 'failed' | 'timed_out' | 'cancelled';
 export type ProcessCancelSource = 'model' | 'user' | 'teardown';
 export declare const PROCESS_JOB_ID_PREFIX = "proc-";
@@ -34,6 +35,7 @@ export interface ProcessJobRegistryOptions {
     closeGraceMs?: number;
     reapGraceMs?: number;
     sweep?: boolean;
+    traceWriter?: TraceSink;
 }
 export interface StartProcessJobArgs {
     command: string;
@@ -54,7 +56,7 @@ export declare class ProcessJobRegistry extends EventEmitter<ProcessJobRegistryE
     readonly sessionLabel: string;
     readonly logDir: string;
     readonly maxConcurrent: number;
-    private readonly opts;
+    private opts;
     private readonly jobs;
     private counter;
     private closed;
@@ -71,6 +73,7 @@ export declare class ProcessJobRegistry extends EventEmitter<ProcessJobRegistryE
     emitCancelTimeout(id: string): void;
     waitFor(id: string): Promise<ProcessJobSnapshot | undefined>;
     killAll(graceMs?: number): Promise<readonly ProcessJobSnapshot[]>;
+    setTraceWriter(writer: TraceSink | undefined): void;
     dispose(): void;
     private onSettled;
     private installExitHook;

package/dist/agent/shell-jobs/process-jobs.sweep.d.ts

@@ -1,3 +1,3 @@
 export declare function enforceSessionQuota(dir: string, quotaBytes: number, liveLogPaths: ReadonlySet<string>): void;
-export declare function sweepProcessJobDirs(currentLabel: string, now?: number, maxAgeMs?: number): void;
+export declare function sweepProcessJobDirs(currentLabel: string, now?: number, maxAgeMs?: number, rootOverride?: string): void;
 export declare function scheduleProcessJobSweep(currentLabel: string): void;

package/dist/agent/tools/detach-bash.d.ts

@@ -1,6 +1,7 @@
 import type { DetachableToolRegistry, DetachToken, DetachedToolResult } from './detach-registry.js';
 export declare const SETTLE_AFTER_KILL_MS = 5000;
 export declare function bashDetachLabel(command: string): string;
+export declare const BASH_SETTLE_TIMEOUT_SENTINEL = "SETTLE_TIMEOUT";
 export declare function buildBashDelivery(toolUseId: string, label: string, output: string, closeCode: number | null, closeSignal: string | null, startedAt: number): DetachedToolResult;
 export declare function applyBashDetach(registry: DetachableToolRegistry, toolUseId: string, command: string, onDetach: (token: DetachToken, label: string) => void): DetachToken;
 export interface OnDetachParams {

package/dist/agent/tools/subagent/background-branch.d.ts

@@ -1,6 +1,7 @@
 import { type BackgroundAgentRegistry } from '../../background-registry.js';
 import type { SubagentManager } from '../../subagent.js';
 import type { ToolResult } from '../types.js';
+import { type BackgroundDelivery } from './background-delivery.js';
 type ForkedHandle = Awaited<ReturnType<SubagentManager['forkSubagent']>>;
 export interface RunBackgroundBranchArgs {
     handle: ForkedHandle;
@@ -15,6 +16,7 @@ export interface RunBackgroundBranchArgs {
         repoRoot: string;
         worktreePath: string;
     };
+    delivery?: BackgroundDelivery;
 }
 export declare function runBackgroundBranch(args: RunBackgroundBranchArgs): Promise<ToolResult>;
 export {};

package/dist/agent/tools/subagent/background-delivery.d.ts

@@ -0,0 +1,14 @@
+import type { BackgroundAgentRegistry } from '../../background-registry.js';
+export type BackgroundDelivery = 'auto-wake' | 'next-message' | 'manual-join' | 'root-session';
+export interface BackgroundDeliveryContext {
+    depth: number;
+    backgroundRegistry?: BackgroundAgentRegistry;
+    backgroundAutoWake?: () => boolean;
+    backgroundAutoDeliver?: () => boolean;
+}
+export declare function resolveBackgroundDelivery(ctx: BackgroundDeliveryContext): BackgroundDelivery;
+export declare function backgroundTarget(ctx: BackgroundDeliveryContext): {
+    registry: BackgroundAgentRegistry | undefined;
+    delivery: BackgroundDelivery;
+};
+export declare function backgroundDeliveryNote(delivery: BackgroundDelivery | undefined, jobId: string): string;

package/dist/agent/tools/subagent/foreground-promotion.d.ts

@@ -1,5 +1,6 @@
 import type { ContentBlockParam } from '@anthropic-ai/sdk/resources';
 import type { BackgroundAgentRegistry } from '../../background-registry.js';
+import { type BackgroundDelivery } from './background-delivery.js';
 import type { SubagentManager } from '../../subagent.js';
 import type { TraceOrigin, TraceActor } from '../../session/session-identity.js';
 import type { TraceSink } from '../../trace/index.js';
@@ -34,6 +35,7 @@ export interface RunForegroundArgs {
     depth: number;
     parentSessionId: string | undefined;
     registry: BackgroundAgentRegistry | undefined;
+    delivery?: BackgroundDelivery;
     promotionTriggers: Map<string, PromotionTrigger>;
     activeForegroundHandles: Map<string, {
         cancel: () => Promise<void>;

package/dist/agent/tools/subagent-executor/types.d.ts

@@ -27,6 +27,8 @@ export interface SubagentExecutorContext {
     depth: number;
     maxDepth?: number;
     backgroundRegistry?: BackgroundAgentRegistry;
+    backgroundAutoWake?: () => boolean;
+    backgroundAutoDeliver?: () => boolean;
     cwd?: string;
     traceWriter?: TraceSink;
     workspaceStore?: import('../../workspace/index.js').WorkspaceStore;

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

@@ -639,6 +639,8 @@ export declare const TraceEventInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject
             stop_hook_continuation: "stop_hook_continuation";
             stop_hook_cap_reached: "stop_hook_cap_reached";
             orphan_repair: "orphan_repair";
+            background_process_started: "background_process_started";
+            background_process_settled: "background_process_settled";
         }>;
         durationMs: z.ZodOptional<z.ZodNumber>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
@@ -1049,6 +1051,8 @@ export declare const TraceEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             stop_hook_continuation: "stop_hook_continuation";
             stop_hook_cap_reached: "stop_hook_cap_reached";
             orphan_repair: "orphan_repair";
+            background_process_started: "background_process_started";
+            background_process_settled: "background_process_settled";
         }>;
         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

@@ -37,6 +37,8 @@ export declare const SessionPhaseNameSchema: z.ZodEnum<{
     stop_hook_continuation: "stop_hook_continuation";
     stop_hook_cap_reached: "stop_hook_cap_reached";
     orphan_repair: "orphan_repair";
+    background_process_started: "background_process_started";
+    background_process_settled: "background_process_settled";
 }>;
 export declare const SessionPhasePayloadSchema: z.ZodObject<{
     phase: z.ZodEnum<{
@@ -77,6 +79,8 @@ export declare const SessionPhasePayloadSchema: z.ZodObject<{
         stop_hook_continuation: "stop_hook_continuation";
         stop_hook_cap_reached: "stop_hook_cap_reached";
         orphan_repair: "orphan_repair";
+        background_process_started: "background_process_started";
+        background_process_settled: "background_process_settled";
     }>;
     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.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' | 'strategy_nudge_fired' | 'stop_inject_dropped' | 'stop_hook_continuation' | 'stop_hook_cap_reached' | 'orphan_repair';
+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' | '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/cli/commands/interactive/bg-result-notifier.d.ts

@@ -6,6 +6,7 @@ export interface PendingBgAgentNotification {
 export declare function formatBgResultBody(job: BackgroundJob): string;
 export declare function buildBgResultInjection(job: BackgroundJob): string;
 export declare function isAutoDeliverEnabled(raw: string | undefined): boolean;
+export declare function replCanAutoWake(): boolean;
 export declare class BgResultNotifier {
     private readonly registry;
     private pendingInjections;

package/dist/cli/commands/interactive/bootstrap-resume.d.ts

@@ -8,4 +8,4 @@ import type { createBootstrapInfra } from './bootstrap-infra.js';
 export declare function rebindResumeTraceWriter(ctx: Pick<InteractiveCtx, 'traceWriter'>, writer: TraceWriter | undefined, holders: readonly {
     setTraceWriter(writer: TraceWriter | undefined): void;
 }[]): void;
-export declare function createResumeRequest(getCtx: () => InteractiveCtx, sessionRef: SessionRef, sharedDeps: ReturnType<typeof buildSharedDeps>, infra: Pick<ReturnType<typeof createBootstrapInfra>, 'subagentExecutor' | 'skillExecutor' | 'composeExecutor' | 'rootManager' | 'backgroundRegistry'>, clearTrustedSkills: () => void, maxTurns: number): (target: ResolvedResumeTarget) => ReturnType<typeof performResumeSwap>;
+export declare function createResumeRequest(getCtx: () => InteractiveCtx, sessionRef: SessionRef, sharedDeps: ReturnType<typeof buildSharedDeps>, infra: Pick<ReturnType<typeof createBootstrapInfra>, 'subagentExecutor' | 'skillExecutor' | 'composeExecutor' | 'rootManager' | 'backgroundRegistry' | 'processJobs'>, clearTrustedSkills: () => void, maxTurns: number): (target: ResolvedResumeTarget) => ReturnType<typeof performResumeSwap>;

package/dist/cli/commands/interactive/process-job-notifier.d.ts

@@ -1,4 +1,5 @@
 import type { ProcessJobRegistry, ProcessJobSnapshot } from '../../../agent/shell-jobs/process-jobs.js';
+export declare function escapeXmlAttr(text: string): string;
 export declare function buildProcessResultInjection(job: ProcessJobSnapshot): string;
 export declare function formatProcessNotice(job: ProcessJobSnapshot): string;
 export declare class ProcessJobNotifier {