agent-afk 5.79.0 → 5.80.0

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

@@ -3,4 +3,5 @@ export { buildRuntimeSnapshot, parseView, formatEnvironmentFragment, } from './r
 export { buildRuntimeStateSource, type RuntimeSourceDeps, } from './runtime-source.js';
 export { getRuntimeStateTool, AWARENESS_TOOL_NAMES, createGetRuntimeStateHandler, wrapDispatcherWithRuntimeState, } from './tool.js';
 export { gatherWorkspace } from './workspace-source.js';
-export { writePresenceFile, removePresenceFile, removePresenceFileSync, readPresenceFiles, type PresenceFileInfo, type PresenceRecord, } from './presence.js';
+export { writePresenceFile, removePresenceFile, removePresenceFileSync, readPresenceFiles, readLivePresenceFiles, touchPresenceHeartbeat, PRESENCE_SCHEMA_VERSION, type PresenceFileInfo, type PresenceRecord, type PresenceLiveness, type ReadLivePresenceOptions, } from './presence.js';
+export { isProcessAlive, classifyPidLiveness, type ProcessLiveness, } from '../process-liveness.js';

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

@@ -1,5 +1,7 @@
 import type { RuntimeWorkspace } from './types.js';
 import type { TraceActor } from '../session/session-identity.js';
+import { type ProcessLiveness } from '../process-liveness.js';
+export declare const PRESENCE_SCHEMA_VERSION = 1;
 export interface PresenceFileInfo {
     sessionId: string;
     surface: string;
@@ -13,13 +15,23 @@ export interface PresenceFileInfo {
     workspace: RuntimeWorkspace;
     pid: number;
     afk?: boolean;
+    schemaVersion?: number;
+    heartbeatAt?: string;
 }
+export type PresenceLiveness = ProcessLiveness;
 export interface PresenceRecord extends PresenceFileInfo {
     path: string;
+    liveness: PresenceLiveness;
+    heartbeatAgeMs: number | null;
 }
 export declare function writePresenceFile(info: PresenceFileInfo): Promise<void>;
+export declare function touchPresenceHeartbeat(sessionId: string): Promise<void>;
 export declare function setPresenceAfk(sessionId: string, afk: boolean): Promise<void>;
 export declare function updatePresenceCwd(sessionId: string, cwd: string): Promise<void>;
 export declare function removePresenceFile(sessionId: string): Promise<void>;
 export declare function removePresenceFileSync(sessionId: string): void;
 export declare function readPresenceFiles(): Promise<PresenceRecord[]>;
+export interface ReadLivePresenceOptions {
+    maxHeartbeatAgeMs?: number;
+}
+export declare function readLivePresenceFiles(options?: ReadLivePresenceOptions): Promise<PresenceRecord[]>;

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

@@ -0,0 +1,3 @@
+export type ProcessLiveness = 'alive' | 'dead' | 'unknown';
+export declare function isProcessAlive(pid: number): boolean;
+export declare function classifyPidLiveness(pid: unknown): ProcessLiveness;