@orgloop/agentctl 1.1.0 → 1.2.1

package/dist/adapters/pi-rust.d.ts

@@ -0,0 +1,89 @@
+import type { AgentAdapter, AgentSession, LaunchOpts, LifecycleEvent, ListOpts, PeekOpts, StopOpts } from "../core/types.js";
+export interface PidInfo {
+    pid: number;
+    cwd: string;
+    args: string;
+    /** Process start time from `ps -p <pid> -o lstart=`, used to detect PID recycling */
+    startTime?: string;
+}
+/** Metadata persisted by launch() so status checks survive wrapper exit */
+export interface LaunchedSessionMeta {
+    sessionId: string;
+    pid: number;
+    /** Process start time from `ps -p <pid> -o lstart=` for PID recycling detection */
+    startTime?: string;
+    /** The PID of the wrapper (agentctl launch) — may differ from `pid` (pi-rust process) */
+    wrapperPid?: number;
+    cwd: string;
+    model?: string;
+    prompt?: string;
+    launchedAt: string;
+}
+export interface PiRustAdapterOpts {
+    sessionDir?: string;
+    sessionsMetaDir?: string;
+    getPids?: () => Promise<Map<number, PidInfo>>;
+    /** Override PID liveness check for testing (default: process.kill(pid, 0)) */
+    isProcessAlive?: (pid: number) => boolean;
+}
+/**
+ * Pi Rust adapter — reads session data directly from ~/.pi/agent/sessions/
+ * and cross-references with running PIDs. NEVER maintains its own registry.
+ *
+ * Pi Rust (pi-rust / pi_agent_rust) stores sessions as JSONL files organized
+ * by project directory. It also maintains a SQLite index for fast lookups,
+ * but we read JSONL directly for simplicity and testability.
+ */
+export declare class PiRustAdapter implements AgentAdapter {
+    readonly id = "pi-rust";
+    private readonly sessionDir;
+    private readonly sessionsMetaDir;
+    private readonly getPids;
+    private readonly isProcessAlive;
+    constructor(opts?: PiRustAdapterOpts);
+    list(opts?: ListOpts): Promise<AgentSession[]>;
+    peek(sessionId: string, opts?: PeekOpts): Promise<string>;
+    status(sessionId: string): Promise<AgentSession>;
+    launch(opts: LaunchOpts): Promise<AgentSession>;
+    /**
+     * Poll the launch log file for up to `timeoutMs` to extract the real session ID.
+     * Pi Rust's JSONL output includes the session ID in the first line (type: "session").
+     */
+    private pollForSessionId;
+    stop(sessionId: string, opts?: StopOpts): Promise<void>;
+    resume(sessionId: string, message: string): Promise<void>;
+    events(): AsyncIterable<LifecycleEvent>;
+    /** List .jsonl session files in a project directory */
+    private getSessionFiles;
+    /** Read and parse the session header (first line) from a JSONL file */
+    private readSessionHeader;
+    /** Extract the session ID from a JSONL filename (e.g., "2026-02-22T16-29-54.096Z_feb70071.jsonl" → "feb70071") */
+    private extractShortId;
+    private buildSession;
+    private isSessionRunning;
+    private processStartedAfterSession;
+    private findMatchingPid;
+    private parseSessionTail;
+    /** Read the first user prompt from a JSONL session file */
+    private readFirstPrompt;
+    /** Find a session JSONL file by session ID (full or prefix match) */
+    private findSessionFile;
+    private findPidForSession;
+    writeSessionMeta(meta: Omit<LaunchedSessionMeta, "startTime">): Promise<void>;
+    readSessionMeta(sessionId: string): Promise<LaunchedSessionMeta | null>;
+    private deleteSessionMeta;
+}
+/**
+ * Decode a Pi Rust project directory name back to the original path.
+ * Pi Rust encodes paths: "/" → "-", wrapped in "--".
+ * E.g., "--private-tmp-test-pi-rust--" → "/private/tmp/test-pi-rust"
+ *
+ * Note: This is a lossy encoding — hyphens in the original path are
+ * indistinguishable from path separators. We do our best to reconstruct.
+ */
+export declare function decodeProjDir(dirName: string): string;
+/**
+ * Encode a path as a Pi Rust project directory name.
+ * E.g., "/private/tmp/test-pi-rust" → "--private-tmp-test-pi-rust--"
+ */
+export declare function encodeProjDir(cwdPath: string): string;