agent-afk 5.289.1 → 5.290.0

package/dist/agent/awareness/presence.activity.d.ts

@@ -0,0 +1,9 @@
+export declare const ACTIVITY_PROMPT_HEAD_MAX = 120;
+export interface PresenceActivity {
+    promptHead?: string;
+    turns: number;
+    lastTurnEndedAt?: string;
+}
+export declare function normalizePromptHead(raw: string): string | undefined;
+export declare function setPresenceActivityPromptHead(sessionId: string, rawText: string): Promise<void>;
+export declare function setPresenceActivityTurnEnd(sessionId: string, totalTurns: number, rawUserText?: string): Promise<void>;

package/dist/agent/awareness/presence.d.ts

@@ -1,6 +1,7 @@
 import type { RuntimeWorkspace } from './types.js';
 import type { TraceActor } from '../session/session-identity.js';
 import { type ProcessLiveness } from '../process-liveness.js';
+import { type StartTimeProbe } from './presence.liveness.js';
 export declare const PRESENCE_SCHEMA_VERSION = 1;
 export interface PresenceFileInfo {
     sessionId: string;
@@ -14,6 +15,8 @@ export interface PresenceFileInfo {
     };
     workspace: RuntimeWorkspace;
     pid: number;
+    pidStartedAt?: number;
+    pidStartTicks?: number;
     afk?: boolean;
     schemaVersion?: number;
     heartbeatAt?: string;
@@ -22,6 +25,11 @@ export interface PresenceFileInfo {
     turnState?: 'idle' | 'busy' | 'blocked';
     turnStateSince?: string;
     peerInbox?: boolean;
+    activity?: {
+        promptHead?: string;
+        turns: number;
+        lastTurnEndedAt?: string;
+    };
 }
 export type PresenceLiveness = ProcessLiveness;
 export interface PresenceRecord extends PresenceFileInfo {
@@ -31,7 +39,10 @@ export interface PresenceRecord extends PresenceFileInfo {
 }
 export declare function writePresenceFile(info: PresenceFileInfo): Promise<void>;
 export declare function writePresenceFileSync(info: PresenceFileInfo): void;
-export declare function touchPresenceHeartbeat(sessionId: string): Promise<void>;
+export interface TouchHeartbeatOptions {
+    stillOwned?: () => boolean;
+}
+export declare function touchPresenceHeartbeat(sessionId: string, options?: TouchHeartbeatOptions): Promise<void>;
 export declare function patchPresenceFile(sessionId: string, patch: (record: PresenceFileInfo) => void): Promise<void>;
 export declare function setPresenceAfk(sessionId: string, afk: boolean): Promise<void>;
 export declare function setPresenceBlocked(sessionId: string, blocked: boolean): Promise<void>;
@@ -41,5 +52,6 @@ export declare function removePresenceFileSync(sessionId: string): void;
 export declare function readPresenceFiles(): Promise<PresenceRecord[]>;
 export interface ReadLivePresenceOptions {
     maxHeartbeatAgeMs?: number;
+    startTimeProbe?: StartTimeProbe;
 }
 export declare function readLivePresenceFiles(options?: ReadLivePresenceOptions): Promise<PresenceRecord[]>;

package/dist/agent/awareness/presence.liveness.d.ts

@@ -0,0 +1,22 @@
+import type { PresenceRecord } from './presence.js';
+import { type ProcessStartInfo } from '../process-liveness.start-time.js';
+export declare const START_TIME_TOLERANCE_MS = 5000;
+export declare const LEGACY_STALE_HEARTBEAT_MS: number;
+export type PresenceVerdict = 'live' | 'dead' | 'reused' | 'stale-legacy';
+export type StartTimeProbe = (pids: readonly number[]) => Promise<Map<number, ProcessStartInfo | undefined>>;
+type IdentityFields = Pick<PresenceRecord, 'liveness' | 'heartbeatAgeMs' | 'pidStartedAt' | 'pidStartTicks'>;
+export declare function classifyPresenceRecord(record: IdentityFields, probed: ProcessStartInfo | undefined): PresenceVerdict;
+export declare const START_TIME_PROBE_CACHE_TTL_MS = 30000;
+export declare class StartTimeProbeCache {
+    private readonly ttlMs;
+    private readonly now;
+    private readonly entries;
+    constructor(ttlMs?: number, now?: () => number);
+    static keyFor(record: Pick<PresenceRecord, 'pid' | 'pidStartedAt' | 'pidStartTicks'>): string;
+    get(key: string): ProcessStartInfo | undefined;
+    set(key: string, info: ProcessStartInfo): void;
+    clear(): void;
+}
+export declare function _resetStartTimeProbeCacheForTest(): void;
+export declare function filterVerifiedLive(records: PresenceRecord[], probe?: StartTimeProbe, cache?: StartTimeProbeCache): Promise<PresenceRecord[]>;
+export {};

package/dist/agent/awareness/presence.reaper.d.ts

@@ -0,0 +1,7 @@
+export interface SweepDeadPresenceOptions {
+    selfIds?: ReadonlySet<string>;
+    kill?: (pid: number, signal: 0) => void;
+    remove?: (path: string) => Promise<void>;
+    read?: (path: string) => Promise<string>;
+}
+export declare function sweepDeadPresence(opts?: SweepDeadPresenceOptions): Promise<number>;

package/dist/agent/process-liveness.start-time.d.ts

@@ -0,0 +1,26 @@
+export interface ProcessStartInfo {
+    startedAtMs?: number;
+    startTicks?: number;
+}
+export type StartTimeExec = (file: string, args: string[]) => Promise<{
+    stdout: string;
+}>;
+export interface StartTimeProbeDeps {
+    platform?: NodeJS.Platform;
+    exec?: StartTimeExec;
+    readFile?: (path: string) => Promise<string>;
+    now?: () => number;
+}
+export declare const LINUX_CLOCK_TICKS_PER_SEC = 100;
+export declare function parseEtime(value: string): number | undefined;
+export declare function parsePsStartTimes(stdout: string, nowMs: number): Map<number, number>;
+export declare function parseProcStatStartTicks(stat: string): number | undefined;
+export declare function parseProcBootTime(procStat: string): number | undefined;
+export declare function probeProcessStartTimes(pids: readonly number[], deps?: StartTimeProbeDeps): Promise<Map<number, ProcessStartInfo | undefined>>;
+export declare function ownProcessStartedAt(): number;
+export interface OwnStartTicksDeps {
+    platform?: NodeJS.Platform;
+    readFileSync?: (path: string) => string;
+}
+export declare function readOwnStartTicks(deps?: OwnStartTicksDeps): number | undefined;
+export declare function ownProcessStartTicks(): number | undefined;

package/dist/agent/providers/shared/presence-signals.d.ts

@@ -1,3 +1,5 @@
+export declare const PRESENCE_HEARTBEAT_INTERVAL_MS = 60000;
+export declare function _getPresenceHeartbeatTimerForTest(): ReturnType<typeof setInterval> | null;
 export declare function registerPresenceCleanup(sessionId: string): void;
 export declare function unregisterPresenceCleanup(sessionId: string): void;
 export declare function _resetPresenceSignalsForTest(): void;

package/dist/cli/commands/interactive/loop-iteration.injections.d.ts

@@ -3,4 +3,4 @@ export interface InjectionSource {
     drainInjections(): string;
 }
 export declare function prependTurnInjections(runText: string, sources: readonly InjectionSource[]): string;
-export declare function markPresenceTurn(sessionId: string | undefined, state: 'idle' | 'busy'): void;
+export declare function markPresenceTurn(sessionId: string | undefined, state: 'idle' | 'busy', rawUserText?: string, totalTurns?: number): void;

package/dist/cli/commands/interactive/loop-iteration.turn-run.d.ts

@@ -9,4 +9,4 @@ export interface TerminalCapture {
     doneHasEvidence: boolean | undefined;
     doneClassification: 'no-code-changes' | 'verified' | 'unverified' | undefined;
 }
-export declare function runOneTurn(runText: string, attachments: readonly ImageAttachment[], ctx: InteractiveCtx, turnState: TurnState, footer: FooterSubsystems, transcript: TranscriptHandle, surface: InputSurface, installSoftStop: (handler: (() => void) | null) => void, maxTurnsNum: number | undefined, autosaveState: [autosaveFailureLogged: boolean]): Promise<TerminalCapture>;
+export declare function runOneTurn(runText: string, attachments: readonly ImageAttachment[], ctx: InteractiveCtx, turnState: TurnState, footer: FooterSubsystems, transcript: TranscriptHandle, surface: InputSurface, installSoftStop: (handler: (() => void) | null) => void, maxTurnsNum: number | undefined, autosaveState: [autosaveFailureLogged: boolean], rawUserText: string): Promise<TerminalCapture>;