@phnx-labs/agents-cli 1.22.119 → 1.22.121

package/dist/lib/session/detached.d.ts

@@ -1,16 +1,9 @@
-/** A session's foreground/background presence. */
 export type Presence = 'attached' | 'background' | 'parked';
 interface DetachRecord {
     sessionId: string;
     agent: string;
     cwd?: string;
-    /** pid of the detached headless continuation `agents sessions detach` spawned. */
     headlessPid: number;
-    /**
-     * Start-time fingerprint of {@link headlessPid} at spawn, so a liveness check
-     * survives PID reuse: the pid is only "our" continuation if it still occupies
-     * the process we launched. Null when the platform capture failed.
-     */
     headlessStartTime: string | null;
     detachedAtMs: number;
 }
@@ -18,21 +11,7 @@ export declare function writeDetachRecord(rec: DetachRecord): void;
 export declare function readDetachRecord(sessionId: string): DetachRecord | undefined;
 export declare function clearDetachRecord(sessionId: string): void;
 export declare function listDetachRecords(): DetachRecord[];
-/** True while the recorded headless continuation is still the live process we spawned. */
 export declare function isHeadlessAlive(rec: DetachRecord): boolean;
-/**
- * Stop the detached continuation before a local foreground resume starts.
- * The start-time check in {@link isHeadlessAlive} prevents signalling a reused
- * PID; a continuation that ignores SIGTERM fails closed instead of running
- * alongside a second process against the same transcript.
- */
 export declare function takeOverDetachedSession(sessionId: string): Promise<boolean>;
-/**
- * Presence for a session id from the detach store alone:
- *   - no record            -> undefined (caller decides: `attached` for a live
- *                             interactive row, nothing for cloud/team rows)
- *   - record + pid alive    -> `background` (headless continuation running)
- *   - record + pid exited   -> `parked` (the run finished; transcript is durable)
- */
 export declare function presenceFromStore(sessionId: string): Presence | undefined;
 export {};

package/dist/lib/session/detached.js

@@ -1,16 +1,3 @@
-/**
- * Detached-session store — the record `agents sessions detach` writes and both
- * `agents sessions resume` and the active-session scan read to know an agent is
- * "backgrounded": running headless with no terminal, continuing its task
- * unattended.
- *
- * One file per detached session under `~/.agents/.system/detached/<id>.json`.
- * Presence is DERIVED, never asserted: a record only means "this session was
- * detached to a headless continuation"; whether it is still `background`
- * (that continuation is alive) or `parked` (it has exited) is decided live from
- * the recorded pid + its start-time fingerprint. That keeps the store honest
- * even across a crash that never ran `attach`.
- */
 import fs from 'node:fs';
 import path from 'node:path';
 import { getSystemAgentsDir } from '../state.js';
@@ -38,7 +25,6 @@ export function clearDetachRecord(sessionId) {
         fs.rmSync(recordPath(sessionId));
     }
     catch {
-        /* already gone */
     }
 }
 export function listDetachRecords() {
@@ -59,7 +45,6 @@ export function listDetachRecords() {
     }
     return out;
 }
-/** True while the recorded headless continuation is still the live process we spawned. */
 export function isHeadlessAlive(rec) {
     if (!rec.headlessPid || rec.headlessPid <= 0)
         return false;
@@ -69,7 +54,6 @@ export function isHeadlessAlive(rec) {
     catch {
         return false;
     }
-    // Defeat PID reuse: if the pid now belongs to a different process, it is not ours.
     if (rec.headlessStartTime !== null) {
         const now = captureProcessStartTime(rec.headlessPid);
         if (now !== null && now !== rec.headlessStartTime)
@@ -77,12 +61,6 @@ export function isHeadlessAlive(rec) {
     }
     return true;
 }
-/**
- * Stop the detached continuation before a local foreground resume starts.
- * The start-time check in {@link isHeadlessAlive} prevents signalling a reused
- * PID; a continuation that ignores SIGTERM fails closed instead of running
- * alongside a second process against the same transcript.
- */
 export async function takeOverDetachedSession(sessionId) {
     const rec = readDetachRecord(sessionId);
     if (!rec)
@@ -106,13 +84,6 @@ export async function takeOverDetachedSession(sessionId) {
     clearDetachRecord(sessionId);
     return true;
 }
-/**
- * Presence for a session id from the detach store alone:
- *   - no record            -> undefined (caller decides: `attached` for a live
- *                             interactive row, nothing for cloud/team rows)
- *   - record + pid alive    -> `background` (headless continuation running)
- *   - record + pid exited   -> `parked` (the run finished; transcript is durable)
- */
 export function presenceFromStore(sessionId) {
     const rec = readDetachRecord(sessionId);
     if (!rec)