agent-afk 5.319.1 → 5.319.3

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,6 +22,10 @@ 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>;

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;