@pentoshi/clai 4.9.0 → 4.10.0

package/dist/session-runtime/discovery.js

@@ -0,0 +1,100 @@
+import { rm } from "node:fs/promises";
+import { processIdentityTracker } from "../os/process-identity.js";
+import { processAlive } from "../os/process-tree.js";
+import { connectRuntimeSocket, readFirstFrame, sendFrame } from "./protocol.js";
+import { isRuntimeSocketPath } from "./paths.js";
+import { deleteRuntimeLock, deleteRuntimeMetadata, listRuntimeMetadata, } from "./store.js";
+import { RUNTIME_PROTOCOL_VERSION, } from "./types.js";
+function isAck(value, sessionId) {
+    if (!value || typeof value !== "object")
+        return false;
+    const frame = value;
+    return (frame.version === RUNTIME_PROTOCOL_VERSION &&
+        frame.type === "ack" &&
+        frame.sessionId === sessionId);
+}
+export async function probeRuntime(metadata, timeoutMs = 500) {
+    let socket;
+    try {
+        socket = await connectRuntimeSocket(metadata.socketPath, timeoutMs);
+        sendFrame(socket, {
+            version: RUNTIME_PROTOCOL_VERSION,
+            type: "auth",
+            role: "probe",
+            token: metadata.token,
+        });
+        const first = await readFirstFrame(socket, timeoutMs);
+        return isAck(first.value, metadata.sessionId);
+    }
+    catch {
+        return false;
+    }
+    finally {
+        socket?.destroy();
+    }
+}
+async function reapIfStale(metadata) {
+    const comparison = processIdentityTracker.compare(metadata.hostPid, metadata.hostIdentity);
+    const stale = comparison === "gone" ||
+        comparison === "mismatch" ||
+        (comparison === "unknown" && !processAlive(metadata.hostPid));
+    if (!stale)
+        return;
+    await Promise.all([
+        deleteRuntimeMetadata(metadata.sessionId),
+        deleteRuntimeLock(metadata.sessionId),
+        isRuntimeSocketPath(metadata.socketPath)
+            ? rm(metadata.socketPath, { force: true }).catch(() => undefined)
+            : Promise.resolve(),
+    ]);
+}
+export async function listLiveRuntimeMetadata() {
+    const candidates = await listRuntimeMetadata();
+    const checked = await Promise.all(candidates.map(async (metadata) => {
+        if (await probeRuntime(metadata))
+            return metadata;
+        await reapIfStale(metadata);
+        return undefined;
+    }));
+    const bySession = new Map();
+    for (const metadata of checked) {
+        if (!metadata)
+            continue;
+        const previous = bySession.get(metadata.sessionId);
+        if (!previous || previous.updatedAt < metadata.updatedAt) {
+            bySession.set(metadata.sessionId, metadata);
+        }
+    }
+    return [...bySession.values()].sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
+}
+export async function findLiveRuntime(sessionIdOrPrefix) {
+    const needle = sessionIdOrPrefix.trim().toLowerCase();
+    if (!needle)
+        return undefined;
+    const records = await listLiveRuntimeMetadata();
+    const exact = records.find((record) => record.sessionId.toLowerCase() === needle);
+    if (exact)
+        return exact;
+    const matches = records.filter((record) => record.sessionId.toLowerCase().startsWith(needle));
+    if (matches.length > 1) {
+        throw new Error(`"${sessionIdOrPrefix}" matches ${matches.length} live sessions — pass a longer id`);
+    }
+    return matches[0];
+}
+export async function latestLiveRuntime(cwd) {
+    const normalized = cwd.replace(/[\\/]+$/, "");
+    return (await listLiveRuntimeMetadata()).find((record) => record.cwd.replace(/[\\/]+$/, "") === normalized);
+}
+export async function listLiveSessionRuntimes() {
+    return (await listLiveRuntimeMetadata()).map((record) => ({
+        sessionId: record.sessionId,
+        cwd: record.cwd,
+        ...(record.title ? { title: record.title } : {}),
+        startedAt: record.startedAt,
+        updatedAt: record.updatedAt,
+        phase: record.phase,
+        busy: record.busy,
+        attached: record.attached,
+    }));
+}
+//# sourceMappingURL=discovery.js.map

package/dist/session-runtime/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../src/session-runtime/discovery.ts"],"names":[],"mappings":"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"}

package/dist/session-runtime/host.d.ts

@@ -0,0 +1,77 @@
+import { type RuntimeHostPayload } from "./types.js";
+export declare class SessionRuntimeHost {
+    private readonly payload;
+    private readonly token;
+    private readonly replay;
+    private readonly startedAt;
+    private sessionId;
+    private cwd;
+    private socketPath;
+    private title;
+    private busy;
+    private attached;
+    private phase;
+    private error;
+    private lease;
+    private server;
+    private readonly connections;
+    private transport;
+    private client;
+    private childSocket;
+    private childChannel;
+    private idleTimer;
+    private forceTimer;
+    private livenessTimer;
+    private livenessMisses;
+    private expectedExitCode;
+    private metadataTimer;
+    private metadataDirty;
+    private outputPausedFor;
+    private outputDrainHandler;
+    private metadataWrites;
+    private inputWrites;
+    private statusWrites;
+    private closing;
+    private cleaning;
+    private exitOutcome;
+    private resolveExit;
+    private readonly exitPromise;
+    private readonly signalHandlers;
+    constructor(payload: RuntimeHostPayload);
+    run(): Promise<void>;
+    private startServer;
+    private startChild;
+    private armChildLiveness;
+    private accept;
+    private acknowledge;
+    private acceptClientControl;
+    private acceptClientTerminal;
+    private acceptChild;
+    private handleClientFrame;
+    private handleChildFrame;
+    private applyStatus;
+    private rebind;
+    private publishOutput;
+    private writeToTerminal;
+    private applyOutputBackpressure;
+    private releaseOutputBackpressure;
+    private flushTerminalOutput;
+    private queueInput;
+    private resize;
+    private clientClosed;
+    private sendToClient;
+    private disconnectClient;
+    private closeClientSockets;
+    private scheduleIdleTimer;
+    private cancelIdleTimer;
+    private requestGracefulStop;
+    private metadataSnapshot;
+    private queueMetadata;
+    private flushQueuedMetadata;
+    private writeMetadataNow;
+    private installSignals;
+    private removeSignals;
+    private cleanup;
+}
+export declare function runRuntimeHostFromEnvironment(): Promise<boolean>;
+export declare function runtimeHostClientId(): string;