agent-afk 5.319.2 → 5.319.4

package/dist/agent/daemon/handoff-expiry.d.ts

@@ -1,4 +1,5 @@
 import { type HandoffRecord } from './handoff-store.js';
+export declare const RESUME_QUEUE_SUBDIR = "handoff-resume";
 export declare const DEFAULT_HANDOFF_TTL_MS: number;
 export declare const EXPIRY_SWEEP_INTERVAL_MS = 60000;
 export interface ExpireHandoffOpts {
@@ -10,5 +11,9 @@ export interface ExpireHandoffOpts {
 export declare function isHandoffStale(record: Pick<HandoffRecord, 'createdAt'>, now: number, ttlMs?: number): boolean;
 export declare function expireHandoff(taskId: string, opts?: ExpireHandoffOpts): Promise<boolean>;
 export declare function expireStaleHandoffs(opts?: ExpireHandoffOpts): Promise<number>;
-export declare function sweepExpiredHandoffs(queueDir: string, now?: number): void;
+export declare function sweepExpiredHandoffs(queueDir: string, now?: number, handoffsDir?: string): void;
 export declare function resetExpirySweepThrottleForTests(): void;
+export declare function expiryNoticeRoute(route: unknown): {
+    target: number;
+    messageThreadId?: number;
+} | undefined;

package/dist/agent/daemon/handoff-maintenance.d.ts

@@ -0,0 +1,18 @@
+import type { Telegraf } from 'telegraf';
+import { RESUME_QUEUE_SUBDIR } from './handoff-expiry.js';
+export declare const HANDOFF_MAINTENANCE_INTERVAL_MS = 30000;
+export { RESUME_QUEUE_SUBDIR };
+export declare function resumeQueueDir(queueDir: string): string;
+export interface HandoffMaintenanceOpts {
+    queueDir: string;
+    handoffsDir?: string;
+    bot?: Telegraf;
+    drainResumeQueue: (resumeDir: string) => Promise<void>;
+    intervalMs?: number;
+}
+export interface HandoffMaintenanceHandle {
+    stop(): void;
+}
+export declare function runStartupRecovery(opts: HandoffMaintenanceOpts, resumeDir: string): Promise<void>;
+export declare function consumeAndResume(opts: HandoffMaintenanceOpts, resumeDir: string): Promise<void>;
+export declare function startHandoffMaintenance(opts: HandoffMaintenanceOpts): HandoffMaintenanceHandle;

package/dist/agent/daemon/handoff-resume-context.d.ts

@@ -0,0 +1,10 @@
+import type { ScheduledTask } from './triggers.js';
+export interface HandoffResumeContext {
+    originalTaskId?: string;
+    cwd?: string;
+    notifyOn?: 'failure' | 'always' | 'never';
+    notifyChat?: number | string;
+}
+export declare function pickResumeFields(src: unknown): HandoffResumeContext;
+export declare function resumeContextFromTask(task: ScheduledTask): HandoffResumeContext;
+export declare function overlapKeyOf(task: Pick<ScheduledTask, 'taskId' | 'overlapKey'>): string;

package/dist/agent/daemon/handoff-store.d.ts

@@ -22,12 +22,16 @@ export interface HandoffRecord {
     responderIdentity?: string;
     originalCommand: string;
     telegramMessageId?: number;
+    originalTaskId?: string;
+    cwd?: string;
+    notifyOn?: 'failure' | 'always' | 'never';
+    notifyChat?: number | string;
 }
 export declare function writeHandoff(record: HandoffRecord, handoffsDir?: string): Promise<void>;
 export declare function readHandoff(taskId: string, handoffsDir?: string): Promise<HandoffRecord | null>;
 export declare function deleteHandoff(taskId: string, handoffsDir?: string): Promise<void>;
 export declare function listPendingHandoffs(handoffsDir?: string): Promise<HandoffRecord[]>;
-export declare function withHandoffLock<T>(taskId: string, handoffsDir: string, cb: () => Promise<T>): Promise<T | null>;
+export declare function withHandoffLock<T>(taskId: string, handoffsDir: string, cb: () => Promise<T>, platform?: string): Promise<T | null>;
 export interface UpdateHandoffAnswerOpts {
     handoffsDir?: string;
     responderIdentity?: string;

package/dist/agent/daemon/handoff-wiring.d.ts

@@ -1,3 +1,4 @@
+import { type HandoffResumeContext } from './handoff-resume-context.js';
 import type { ElicitationHandler } from '../elicitation-router.js';
 import type { Telegraf } from 'telegraf';
 export interface DaemonElicitationOpts {
@@ -8,6 +9,7 @@ export interface DaemonElicitationOpts {
     bot?: Telegraf;
     chatId?: number;
     threadId?: number;
+    resumeContext?: HandoffResumeContext;
 }
 export declare function makeDaemonElicitationHandler(opts: DaemonElicitationOpts): ElicitationHandler;
 export interface RecoveryResult {

package/dist/agent/daemon/queue-store.d.ts

@@ -1,4 +1,5 @@
 import { recoverExpiredLeases } from './lease-store.js';
+import { type HandoffResumeContext } from './handoff-resume-context.js';
 export { recoverExpiredLeases };
 export interface QueuedTask {
     id: string;
@@ -11,8 +12,11 @@ export interface QueuedTask {
     backoffStrategy?: 'fixed' | 'exponential';
     backoffBaseMs?: number;
     eligibleAfter?: number;
+    originalTaskId?: string;
+    cwd?: string;
+    notifyChat?: number | string;
 }
-export interface EnqueueOptions {
+export interface EnqueueOptions extends HandoffResumeContext {
     notifyOn?: 'failure' | 'always' | 'never';
 }
 export declare function enqueue(command: string, opts?: EnqueueOptions, queueDir?: string): QueuedTask;

package/dist/agent/daemon/scheduler.d.ts

@@ -59,6 +59,7 @@ export declare class CronScheduler {
     private readonly now;
     private readonly idleDetector;
     private pullPollTimer;
+    private handoffMaintenance;
     private isDequeuing;
     private readonly queueDir;
     private readonly inFlightTasks;
@@ -80,6 +81,7 @@ export declare class CronScheduler {
     fireOnStart(): Promise<TelemetryRecord[]>;
     stop(): Promise<void>;
     startPullLoop(): void;
+    startHandoffMaintenance(intervalMs?: number): void;
     private pullTick;
     private runOnce;
     private spawnSession;

package/dist/agent/daemon/scheduler.elicitation-notify.d.ts

@@ -1,3 +1,4 @@
+import { type HandoffResumeContext } from './handoff-resume-context.js';
 import type { ElicitationHandler } from '../elicitation-router.js';
 import type { Telegraf } from 'telegraf';
 export type { ElicitationHandler };
@@ -11,5 +12,6 @@ export interface CronElicitationHandlerOpts {
     bot?: Telegraf;
     chatId?: number;
     threadId?: number;
+    resumeContext?: HandoffResumeContext;
 }
 export declare function makeCronElicitationHandler(opts: CronElicitationHandlerOpts): ElicitationHandler;

package/dist/agent/daemon/scheduler.overlap-guard.d.ts

@@ -15,3 +15,10 @@ export declare class OverlapAlertLatch {
     _reset(): void;
 }
 export declare function formatOverlapAlertMessage(taskId: string, command: string, cron: string | undefined): string;
+export declare function snapshotInFlightTasks(inFlight: ReadonlyMap<string, number>, commandOf: (taskId: string) => string | undefined, now: number): Array<{
+    taskId: string;
+    displayId: string;
+    commandHead: string;
+    elapsedMs: number;
+}>;
+export declare function makeCwdErrorRecord(task: ScheduledTask, trigger: TelemetryTrigger, nowMs: number, cwdError: string): TelemetryRecord;

package/dist/agent/daemon/scheduler.pull-tick.d.ts

@@ -2,12 +2,14 @@ import type { ScheduledTask } from './triggers.js';
 import type { TelemetryRecord, TaskCompletionDetails } from './scheduler.js';
 export interface PullTickContext {
     queueDir: string;
+    handoffsDir?: string;
     isIdle: () => boolean;
     getIsDequeuing: () => boolean;
     setIsDequeuing: (v: boolean) => void;
     runOnce: (task: ScheduledTask, trigger: 'pull') => Promise<TelemetryRecord>;
+    isOverlapBusy?: (overlapKey: string) => boolean;
 }
-export declare function sweepAnsweredHandoffs(queueDir: string): void;
+export declare function sweepAnsweredHandoffs(queueDir: string, handoffsDir?: string): void;
 export declare function executePullTick(ctx: PullTickContext): Promise<void>;
 export interface FireOnTaskCompleteOptions {
     onTaskComplete?: (record: TelemetryRecord, details?: TaskCompletionDetails) => void | Promise<void>;

package/dist/agent/daemon/triggers.d.ts

@@ -14,5 +14,6 @@ export interface ScheduledTask {
     cwd?: string;
     maxAttempts?: number;
     retryDelayMs?: number;
+    overlapKey?: string;
 }
 export declare function validateScheduledTask(task: ScheduledTask): void;

package/dist/agent/daemon.d.ts

@@ -16,6 +16,7 @@ export interface DaemonOptions {
     onTaskTurnComplete?: SchedulerOptions['onTaskTurnComplete'];
     pullPollIntervalMs?: number;
     queueDir?: string;
+    handoffMaintenance?: boolean;
     writePortFile?: boolean;
     bot?: Telegraf;
     primaryChatId?: number;

package/dist/agent/tools/handlers/_output-cap.d.ts

@@ -6,4 +6,6 @@ export declare function capForModel(text: string): {
     truncated: boolean;
 };
 export declare function isOutputCapKill(content: string): boolean;
+export declare const OUTPUT_TRUNCATED_MARKER = "[output truncated";
+export declare function hasOutputTruncatedMarker(content: string): boolean;
 export declare const HARD_CAP_KILL_NOTE: string;

package/dist/agent/tools/handlers/scratch-roots.d.ts

@@ -0,0 +1,5 @@
+export declare function lexicalScratchRoots(): readonly string[];
+export declare function realScratchRoots(): readonly string[];
+export declare function isWithinScratchRoot(realAbs: string): boolean;
+export declare function _resetScratchRootsCacheForTests(): void;
+export declare function _setRealScratchRootsForTests(roots: readonly string[]): void;

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

@@ -0,0 +1,4 @@
+export declare function pollMutationReason(command: string): string | undefined;
+export declare function pollSyntaxReason(command: string): string | undefined;
+export declare function isReadOnlyPoll(command: string, cwd: string): boolean;
+export declare function pollRefusalReason(command: string, risk: string, cwd: string): string | undefined;

package/dist/agent/tools/handlers/wait-for-poll-allowlist.argv.d.ts

@@ -0,0 +1,9 @@
+export interface ArgvSpec {
+    readonly flags: ReadonlySet<string>;
+    readonly valueShorts?: string;
+    readonly numeric?: boolean;
+    readonly noPositional?: boolean;
+    readonly verbs?: ReadonlySet<string>;
+    readonly requireAny?: ReadonlySet<string>;
+}
+export declare function argvAllowed(argv: readonly string[], spec: ArgvSpec): boolean;

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

@@ -0,0 +1,3 @@
+export declare function segmentArgvReason(tokens: readonly string[]): string | undefined;
+export declare function pollArgvReason(command: string): string | undefined;
+export declare function hasUnquotedBackgroundOp(command: string): boolean;

package/dist/agent/tools/handlers/wait-for-poll-allowlist.git.d.ts

@@ -0,0 +1 @@
+export declare function gitArgvAllowed(argv: readonly string[]): boolean;

package/dist/agent/worktree/worktree-root-registry.d.ts

@@ -1,3 +1,4 @@
+export declare function acquireRegistryLock(lockPath: string, platform?: string): Promise<(() => Promise<void>) | null>;
 export declare function registerWorktreeRoot(repoRoot: string): Promise<void>;
 export declare function readRegisteredWorktreeRoots(): Promise<string[]>;
 export declare function sweepRootSet(primary: string | null): Promise<string[]>;

package/dist/agent/worktree/worktree-sweep.lock.d.ts

@@ -2,4 +2,4 @@ export declare function countPriorSuccessfulRuns(telemetryPath: string): Promise
 export declare class LockContestedError extends Error {
     constructor(lockPath: string);
 }
-export declare function acquireLock(lockPath: string): Promise<() => Promise<void>>;
+export declare function acquireLock(lockPath: string, platform?: string): Promise<() => Promise<void>>;