@pentoshi/clai 3.9.4 → 3.9.6

package/dist/interactive-session/types.d.ts

@@ -1,254 +0,0 @@
-/**
- * Public domain contracts for agent-controlled interactive terminal sessions.
- *
- * Deliberate non-goals encoded here: no user keyboard passthrough, no transfer
- * of the host controlling terminal, no reattachment after restart, no screen
- * emulation, and no command rewriting. Nothing in this module carries raw
- * commands, input bytes, environment values, or unredacted output.
- */
-export type SessionOperation = "start" | "send" | "read" | "status" | "list" | "resize" | "close";
-export type SessionState = "starting" | "running" | "closing" | "exited" | "failed" | "closed";
-export declare const TERMINAL_SESSION_STATES: readonly SessionState[];
-export declare function isTerminalState(state: SessionState): boolean;
-export type TerminationReason = "process-exit" | "explicit-close" | "cancelled" | "idle-timeout" | "lifetime-timeout" | "conversation-teardown" | "app-shutdown" | "output-limit" | "launch-failure";
-export type SessionTransportKind = "pty" | "pipe";
-export type TerminalMode = "required" | "preferred" | "pipe";
-export type OutputStream = "terminal" | "stdout" | "stderr";
-export type OutputView = "plain" | "encoded";
-export interface TerminalDimensions {
-    readonly columns: number;
-    readonly rows: number;
-}
-export type ControlInput = "interrupt" | "eof" | "suspend" | "escape" | "tab" | "backspace" | "up" | "down" | "left" | "right";
-export declare const CONTROL_INPUTS: readonly ControlInput[];
-export type SubmitBehavior = "enter" | "none";
-export type SessionInput = {
-    readonly kind: "text";
-    readonly text: string;
-    readonly submit: SubmitBehavior;
-} | {
-    readonly kind: "control";
-    readonly control: ControlInput;
-} | {
-    readonly kind: "eof";
-};
-export type SessionInputKind = SessionInput["kind"];
-export interface ProcessOutcome {
-    readonly exitCode?: number | undefined;
-    readonly signal?: string | undefined;
-    readonly endedAt: number;
-}
-export type ProcessIdentityComparison = "match" | "mismatch" | "gone" | "unknown";
-export interface OutputEvent {
-    /** Inclusive canonical safe-byte offset. */
-    readonly startCursor: number;
-    /** Exclusive canonical safe-byte offset. */
-    readonly endCursor: number;
-    readonly stream: OutputStream;
-    readonly observedAt: number;
-    readonly bytes: Uint8Array;
-}
-export interface PresentedOutputEvent {
-    readonly startCursor: number;
-    readonly endCursor: number;
-    readonly stream: OutputStream;
-    readonly observedAt: number;
-    /** Inert text for `plain`, base64 for `encoded`. */
-    readonly content: string;
-    readonly decodingLoss?: boolean | undefined;
-}
-export interface ArtifactReference {
-    readonly path: string;
-    readonly bytes: number;
-    readonly droppedBytes: number;
-    readonly redacted: boolean;
-}
-export interface ArtifactReceipt extends ArtifactReference {
-    readonly chunks: readonly string[];
-    readonly sha256: string;
-}
-export interface OutputPage {
-    readonly events: readonly PresentedOutputEvent[];
-    readonly requestedCursor: number;
-    readonly nextCursor: number;
-    readonly hasMore: boolean;
-    readonly earliestAvailableCursor: number;
-    readonly latestCursor: number;
-    readonly view: OutputView;
-    readonly decodingLoss: boolean;
-    readonly omittedBytes?: number | undefined;
-    readonly artifact: ArtifactReference;
-}
-export interface InteractiveSessionRecord {
-    readonly id: string;
-    readonly ownerId: string;
-    state: SessionState;
-    readonly transport: SessionTransportKind;
-    readonly startedAt: number;
-    lastActivityAt: number;
-    endedAt?: number | undefined;
-    dimensions?: TerminalDimensions | undefined;
-    degradedReason?: "PTY_UNAVAILABLE" | undefined;
-    processOutcome?: ProcessOutcome | undefined;
-    terminationReason?: TerminationReason | undefined;
-    artifact: ArtifactReceipt;
-    earliestCursor: number;
-    latestCursor: number;
-    inputClosed: boolean;
-    cleanupVerified?: boolean | undefined;
-}
-/** Immutable, non-disclosing projection handed to callers. */
-export interface SessionSummary {
-    readonly id: string;
-    readonly state: SessionState;
-    readonly transport: SessionTransportKind;
-    readonly startedAt: number;
-    readonly lastActivityAt: number;
-    readonly endedAt?: number | undefined;
-    readonly dimensions?: TerminalDimensions | undefined;
-    readonly degradedReason?: "PTY_UNAVAILABLE" | undefined;
-    readonly processOutcome?: ProcessOutcome | undefined;
-    readonly terminationReason?: TerminationReason | undefined;
-    readonly earliestCursor: number;
-    readonly latestCursor: number;
-    readonly inputClosed: boolean;
-    readonly artifact: ArtifactReference;
-    readonly cleanupVerified?: boolean | undefined;
-}
-export interface OwnerScoped {
-    readonly ownerId: string;
-}
-export interface StartRequest extends OwnerScoped {
-    readonly command: string;
-    readonly cwd?: string | undefined;
-    readonly terminalMode?: TerminalMode | undefined;
-    readonly columns?: number | undefined;
-    readonly rows?: number | undefined;
-    readonly idleTimeoutMs?: number | undefined;
-    readonly lifetimeTimeoutMs?: number | undefined;
-    readonly deadlineMs?: number | undefined;
-    readonly signal?: AbortSignal | undefined;
-}
-export interface SendRequest extends OwnerScoped {
-    readonly id: string;
-    readonly input: SessionInput;
-    readonly cursor?: number | undefined;
-    readonly quietMs?: number | undefined;
-    readonly deadlineMs?: number | undefined;
-    readonly view?: OutputView | undefined;
-    readonly signal?: AbortSignal | undefined;
-}
-export interface ReadRequest extends OwnerScoped {
-    readonly id: string;
-    readonly cursor: number;
-    readonly waitMs?: number | undefined;
-    readonly view?: OutputView | undefined;
-    readonly signal?: AbortSignal | undefined;
-}
-export interface ResizeRequest extends OwnerScoped, TerminalDimensions {
-    readonly id: string;
-}
-export interface CloseRequest extends OwnerScoped {
-    readonly id: string;
-    readonly deadlineMs?: number | undefined;
-}
-export interface StartResult {
-    readonly operation: "start";
-    readonly sessionId: string;
-    readonly state: SessionState;
-    readonly transport: SessionTransportKind;
-    readonly dimensions?: TerminalDimensions | undefined;
-    readonly degradedReason?: "PTY_UNAVAILABLE" | undefined;
-    readonly cursor: number;
-    readonly artifact: ArtifactReference;
-    readonly retriedLaunch?: boolean | undefined;
-}
-export type DeliveryStatus = "delivered" | "not-delivered" | "unknown";
-export interface SendResult {
-    readonly operation: "send";
-    readonly sessionId: string;
-    readonly inputSequence: number;
-    readonly delivery: DeliveryStatus;
-    readonly deliveredBytes: number;
-    readonly state: SessionState;
-    readonly page?: OutputPage | undefined;
-    readonly error?: StableError | undefined;
-}
-export interface ReadResult {
-    readonly operation: "read";
-    readonly sessionId: string;
-    readonly state: SessionState;
-    readonly page?: OutputPage | undefined;
-    readonly error?: StableError | undefined;
-}
-export interface StatusResult {
-    readonly operation: "status";
-    readonly session: SessionSummary;
-}
-export interface ListResult {
-    readonly operation: "list";
-    readonly sessions: readonly SessionSummary[];
-}
-export interface ResizeResult {
-    readonly operation: "resize";
-    readonly sessionId: string;
-    readonly state: SessionState;
-    readonly dimensions: TerminalDimensions;
-}
-export interface CloseResult {
-    readonly operation: "close";
-    readonly sessionId: string;
-    readonly state: SessionState;
-    readonly terminationReason?: TerminationReason | undefined;
-    readonly processOutcome?: ProcessOutcome | undefined;
-    readonly cleanupVerified: boolean;
-    readonly artifact: ArtifactReference;
-    readonly error?: StableError | undefined;
-}
-export interface CloseOwnerResult {
-    readonly closed: number;
-    readonly failures: readonly StableError[];
-}
-export interface CloseAllResult extends CloseOwnerResult {
-    readonly owners: number;
-}
-export type InteractiveSessionToolResult = StartResult | SendResult | ReadResult | StatusResult | ListResult | ResizeResult | CloseResult;
-export declare const STABLE_ERROR_CODES: readonly ["INVALID_REQUEST", "INVALID_CONFIGURATION", "SESSION_NOT_FOUND", "LIMIT_REACHED", "PTY_UNAVAILABLE", "SESSION_NOT_RUNNING", "SESSION_CLOSING", "INPUT_CLOSED", "INPUT_REJECTED", "INPUT_DELIVERY_UNKNOWN", "UNSUPPORTED_CONTROL", "UNSUPPORTED_OPERATION", "BACKPRESSURE", "DEADLINE_EXCEEDED", "CANCELLED", "OUTPUT_GAP", "LAUNCH_FAILED", "PERSIST_FAILED", "CLEANUP_FAILED"];
-export type StableErrorCode = (typeof STABLE_ERROR_CODES)[number];
-export type StableErrorDetailValue = string | number | boolean;
-/**
- * Detail keys are allowlisted so a native error, command line, or output byte
- * can never reach a model, transcript, or log through an error payload.
- */
-export declare const STABLE_ERROR_DETAIL_KEYS: readonly ["earliestAvailableCursor", "latestCursor", "requestedCursor", "omittedBytes", "deliveredBytes", "queuedBytes", "limitBytes", "liveSessions", "limit", "inputSequence", "control", "transport", "terminalMode", "field", "columns", "rows", "elapsedMs", "deadlineMs", "survivingDescendants", "cleanupVerified", "terminationReason", "reason", "artifactPath"];
-export type StableErrorDetailKey = (typeof STABLE_ERROR_DETAIL_KEYS)[number];
-export interface StableError {
-    readonly code: StableErrorCode;
-    readonly message: string;
-    readonly retryable: boolean;
-    readonly operation: SessionOperation;
-    readonly sessionId?: string | undefined;
-    readonly state?: SessionState | undefined;
-    readonly details?: Readonly<Partial<Record<StableErrorDetailKey, StableErrorDetailValue>>> | undefined;
-}
-export interface SessionErrorInit {
-    readonly code: StableErrorCode;
-    readonly operation: SessionOperation;
-    readonly message: string;
-    readonly sessionId?: string | undefined;
-    readonly state?: SessionState | undefined;
-    readonly details?: Readonly<Partial<Record<StableErrorDetailKey, StableErrorDetailValue>>> | undefined;
-    /** Only `LAUNCH_FAILED` and `PERSIST_FAILED` may set this explicitly. */
-    readonly retryable?: boolean | undefined;
-}
-/** Single construction point for every interactive-session failure. */
-export declare function sessionError(init: SessionErrorInit): StableError;
-/** Carrier so internal layers can reject with a StableError and be unwrapped. */
-export declare class SessionErrorException extends Error {
-    readonly stable: StableError;
-    constructor(stable: StableError);
-}
-export declare function throwSessionError(init: SessionErrorInit): never;
-export declare function asStableError(value: unknown, fallback: SessionErrorInit): StableError;
-export declare function toSummary(record: InteractiveSessionRecord): SessionSummary;
-export declare function artifactReference(receipt: ArtifactReceipt): ArtifactReference;

package/dist/interactive-session/types.js

@@ -1,191 +0,0 @@
-/**
- * Public domain contracts for agent-controlled interactive terminal sessions.
- *
- * Deliberate non-goals encoded here: no user keyboard passthrough, no transfer
- * of the host controlling terminal, no reattachment after restart, no screen
- * emulation, and no command rewriting. Nothing in this module carries raw
- * commands, input bytes, environment values, or unredacted output.
- */
-export const TERMINAL_SESSION_STATES = [
-    "exited",
-    "failed",
-    "closed",
-];
-export function isTerminalState(state) {
-    return TERMINAL_SESSION_STATES.includes(state);
-}
-export const CONTROL_INPUTS = [
-    "interrupt",
-    "eof",
-    "suspend",
-    "escape",
-    "tab",
-    "backspace",
-    "up",
-    "down",
-    "left",
-    "right",
-];
-// --- Stable errors -----------------------------------------------------
-export const STABLE_ERROR_CODES = [
-    "INVALID_REQUEST",
-    "INVALID_CONFIGURATION",
-    "SESSION_NOT_FOUND",
-    "LIMIT_REACHED",
-    "PTY_UNAVAILABLE",
-    "SESSION_NOT_RUNNING",
-    "SESSION_CLOSING",
-    "INPUT_CLOSED",
-    "INPUT_REJECTED",
-    "INPUT_DELIVERY_UNKNOWN",
-    "UNSUPPORTED_CONTROL",
-    "UNSUPPORTED_OPERATION",
-    "BACKPRESSURE",
-    "DEADLINE_EXCEEDED",
-    "CANCELLED",
-    "OUTPUT_GAP",
-    "LAUNCH_FAILED",
-    "PERSIST_FAILED",
-    "CLEANUP_FAILED",
-];
-/**
- * Detail keys are allowlisted so a native error, command line, or output byte
- * can never reach a model, transcript, or log through an error payload.
- */
-export const STABLE_ERROR_DETAIL_KEYS = [
-    "earliestAvailableCursor",
-    "latestCursor",
-    "requestedCursor",
-    "omittedBytes",
-    "deliveredBytes",
-    "queuedBytes",
-    "limitBytes",
-    "liveSessions",
-    "limit",
-    "inputSequence",
-    "control",
-    "transport",
-    "terminalMode",
-    "field",
-    "columns",
-    "rows",
-    "elapsedMs",
-    "deadlineMs",
-    "survivingDescendants",
-    "cleanupVerified",
-    "terminationReason",
-    "reason",
-    "artifactPath",
-];
-const MAX_ERROR_MESSAGE_CHARS = 400;
-const MAX_ERROR_DETAIL_CHARS = 120;
-/**
- * Retryability describes whether a fresh caller-decided attempt could help. It
- * never authorizes an automatic retry, and it is false for every code whose
- * failure could already have produced a process or input side effect.
- */
-const NON_RETRYABLE_CODES = new Set([
-    "INVALID_REQUEST",
-    "INVALID_CONFIGURATION",
-    "SESSION_NOT_FOUND",
-    "PTY_UNAVAILABLE",
-    "SESSION_NOT_RUNNING",
-    "SESSION_CLOSING",
-    "INPUT_CLOSED",
-    "INPUT_REJECTED",
-    "INPUT_DELIVERY_UNKNOWN",
-    "UNSUPPORTED_CONTROL",
-    "UNSUPPORTED_OPERATION",
-    "DEADLINE_EXCEEDED",
-    "CANCELLED",
-    "OUTPUT_GAP",
-    "CLEANUP_FAILED",
-]);
-const RETRYABLE_CODES = new Set([
-    "LIMIT_REACHED",
-    "BACKPRESSURE",
-]);
-function boundDetailValue(value) {
-    if (typeof value !== "string")
-        return value;
-    return value.length > MAX_ERROR_DETAIL_CHARS
-        ? `${value.slice(0, MAX_ERROR_DETAIL_CHARS)}…`
-        : value;
-}
-function resolveRetryable(init) {
-    if (NON_RETRYABLE_CODES.has(init.code))
-        return false;
-    if (RETRYABLE_CODES.has(init.code))
-        return init.retryable ?? true;
-    // LAUNCH_FAILED / PERSIST_FAILED are retryable only when the caller proved no
-    // process side effect was possible.
-    return init.retryable ?? false;
-}
-/** Single construction point for every interactive-session failure. */
-export function sessionError(init) {
-    const details = {};
-    for (const key of STABLE_ERROR_DETAIL_KEYS) {
-        const value = init.details?.[key];
-        if (value !== undefined)
-            details[key] = boundDetailValue(value);
-    }
-    const message = init.message.length > MAX_ERROR_MESSAGE_CHARS
-        ? `${init.message.slice(0, MAX_ERROR_MESSAGE_CHARS)}…`
-        : init.message;
-    return {
-        code: init.code,
-        message,
-        retryable: resolveRetryable(init),
-        operation: init.operation,
-        ...(init.sessionId !== undefined ? { sessionId: init.sessionId } : {}),
-        ...(init.state !== undefined ? { state: init.state } : {}),
-        ...(Object.keys(details).length > 0 ? { details } : {}),
-    };
-}
-/** Carrier so internal layers can reject with a StableError and be unwrapped. */
-export class SessionErrorException extends Error {
-    stable;
-    constructor(stable) {
-        super(stable.message);
-        this.stable = stable;
-        this.name = "SessionErrorException";
-    }
-}
-export function throwSessionError(init) {
-    throw new SessionErrorException(sessionError(init));
-}
-export function asStableError(value, fallback) {
-    return value instanceof SessionErrorException
-        ? value.stable
-        : sessionError(fallback);
-}
-export function toSummary(record) {
-    return {
-        id: record.id,
-        state: record.state,
-        transport: record.transport,
-        startedAt: record.startedAt,
-        lastActivityAt: record.lastActivityAt,
-        ...(record.endedAt !== undefined ? { endedAt: record.endedAt } : {}),
-        ...(record.dimensions ? { dimensions: { ...record.dimensions } } : {}),
-        ...(record.degradedReason ? { degradedReason: record.degradedReason } : {}),
-        ...(record.processOutcome ? { processOutcome: { ...record.processOutcome } } : {}),
-        ...(record.terminationReason ? { terminationReason: record.terminationReason } : {}),
-        earliestCursor: record.earliestCursor,
-        latestCursor: record.latestCursor,
-        inputClosed: record.inputClosed,
-        artifact: artifactReference(record.artifact),
-        ...(record.cleanupVerified !== undefined
-            ? { cleanupVerified: record.cleanupVerified }
-            : {}),
-    };
-}
-export function artifactReference(receipt) {
-    return {
-        path: receipt.path,
-        bytes: receipt.bytes,
-        droppedBytes: receipt.droppedBytes,
-        redacted: receipt.redacted,
-    };
-}
-//# sourceMappingURL=types.js.map

package/dist/interactive-session/types.js.map

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

package/dist/os/process-identity.d.ts

@@ -1,46 +0,0 @@
-/**
- * Cross-platform process identity: hashed evidence that a pid still refers to
- * the process we launched, so a recycled pid can never be signalled by cleanup
- * or startup reconciliation.
- *
- * Evidence is a process start time only. The command line is deliberately
- * excluded because `sh -c "cmd"` execs into `cmd`, mutating `ps command=`
- * mid-run and making a live process fail its own identity check.
- */
-export type ProcessIdentityComparison = "match" | "mismatch" | "gone" | "unknown";
-/** Raw start-time evidence provider. Injected so platforms and tests differ. */
-export interface ProcessIdentityProvider {
-    readonly platform: NodeJS.Platform | "test";
-    /** Raw, unhashed evidence, or undefined when it cannot be read. */
-    capture(pid: number): string | undefined;
-}
-export declare const defaultProcessIdentityProvider: ProcessIdentityProvider;
-export declare class ProcessIdentityTracker {
-    private readonly provider;
-    private readonly now;
-    private readonly alive;
-    private readonly cache;
-    constructor(provider?: ProcessIdentityProvider, now?: () => number, alive?: (pid: number | undefined) => boolean);
-    /** Hashed identity for a pid, or undefined when evidence is unavailable. */
-    capture(pid: number | undefined, options?: {
-        refresh?: boolean;
-    }): string | undefined;
-    /**
-     * Compare a recorded identity against the live process. `unknown` never
-     * authorizes signalling: evidence was unreadable, so ownership is unproven.
-     */
-    compare(pid: number | undefined, expected: string | undefined): ProcessIdentityComparison;
-    forget(pid: number | undefined): void;
-    private prune;
-}
-/** Shared tracker used by the job manager and interactive sessions. */
-export declare const processIdentityTracker: ProcessIdentityTracker;
-/**
- * Legacy-compatible helper. Windows returns undefined here because the job
- * manager's existing liveness contract treats an absent identity as "unproven"
- * and must keep behaving exactly as before this extraction.
- */
-export declare function processIdentity(pid: number | undefined, options?: {
-    refresh?: boolean;
-}): string | undefined;
-export declare function forgetProcessIdentity(pid: number | undefined): void;

package/dist/os/process-identity.js

@@ -1,147 +0,0 @@
-/**
- * Cross-platform process identity: hashed evidence that a pid still refers to
- * the process we launched, so a recycled pid can never be signalled by cleanup
- * or startup reconciliation.
- *
- * Evidence is a process start time only. The command line is deliberately
- * excluded because `sh -c "cmd"` execs into `cmd`, mutating `ps command=`
- * mid-run and making a live process fail its own identity check.
- */
-import { execFileSync } from "node:child_process";
-import { createHash } from "node:crypto";
-import { readFileSync } from "node:fs";
-import { processAlive } from "./process-tree.js";
-const IDENTITY_TTL_MS = 15_000;
-const IDENTITY_CACHE_MAX = 512;
-const PROBE_TIMEOUT_MS = 2_000;
-function hashEvidence(raw) {
-    return createHash("sha256").update(raw).digest("hex");
-}
-function readLinuxProcessStart(pid) {
-    try {
-        const raw = readFileSync(`/proc/${pid}/stat`, "utf8");
-        const commEnd = raw.lastIndexOf(")");
-        if (commEnd < 0)
-            return undefined;
-        const fields = raw.slice(commEnd + 2).trim().split(/\s+/);
-        // Evidence format is intentionally identical to the pre-extraction job
-        // manager so persisted registry identities keep comparing equal.
-        const startTime = fields[19];
-        return startTime && startTime.length > 0 ? startTime : undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
-function readPsProcessStart(pid) {
-    try {
-        const raw = execFileSync("ps", ["-p", String(pid), "-o", "lstart="], {
-            encoding: "utf8",
-            timeout: PROBE_TIMEOUT_MS,
-            stdio: ["ignore", "pipe", "ignore"],
-        }).trim();
-        return raw.length > 0 ? raw : undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
-function readWindowsProcessStart(pid) {
-    const query = `(Get-CimInstance Win32_Process -Filter "ProcessId=${pid}").CreationDate`;
-    for (const shell of ["powershell.exe", "pwsh.exe"]) {
-        try {
-            const raw = execFileSync(shell, ["-NoProfile", "-NonInteractive", "-Command", query], {
-                encoding: "utf8",
-                timeout: PROBE_TIMEOUT_MS,
-                windowsHide: true,
-                stdio: ["ignore", "pipe", "ignore"],
-            }).trim();
-            if (raw.length > 0)
-                return raw;
-        }
-        catch {
-            // Try the next shell; an unavailable query yields `unknown`, not a match.
-        }
-    }
-    return undefined;
-}
-export const defaultProcessIdentityProvider = {
-    platform: process.platform,
-    capture(pid) {
-        if (process.platform === "linux")
-            return readLinuxProcessStart(pid);
-        if (process.platform === "win32")
-            return readWindowsProcessStart(pid);
-        return readPsProcessStart(pid);
-    },
-};
-export class ProcessIdentityTracker {
-    provider;
-    now;
-    alive;
-    cache = new Map();
-    constructor(provider = defaultProcessIdentityProvider, now = Date.now, alive = processAlive) {
-        this.provider = provider;
-        this.now = now;
-        this.alive = alive;
-    }
-    /** Hashed identity for a pid, or undefined when evidence is unavailable. */
-    capture(pid, options = {}) {
-        if (!pid || pid <= 0)
-            return undefined;
-        const now = this.now();
-        const cached = this.cache.get(pid);
-        if (cached && !options.refresh && now - cached.at < IDENTITY_TTL_MS) {
-            return cached.value;
-        }
-        const raw = this.provider.capture(pid);
-        const value = raw ? hashEvidence(raw) : undefined;
-        this.cache.set(pid, { value, at: now });
-        this.prune(now);
-        return value;
-    }
-    /**
-     * Compare a recorded identity against the live process. `unknown` never
-     * authorizes signalling: evidence was unreadable, so ownership is unproven.
-     */
-    compare(pid, expected) {
-        if (!pid || pid <= 0)
-            return "gone";
-        if (!this.alive(pid))
-            return "gone";
-        const current = this.capture(pid, { refresh: true });
-        if (!current || !expected)
-            return "unknown";
-        return current === expected ? "match" : "mismatch";
-    }
-    forget(pid) {
-        if (pid)
-            this.cache.delete(pid);
-    }
-    prune(now) {
-        if (this.cache.size <= IDENTITY_CACHE_MAX)
-            return;
-        for (const [pid, entry] of this.cache) {
-            if (now - entry.at >= IDENTITY_TTL_MS)
-                this.cache.delete(pid);
-        }
-        if (this.cache.size > IDENTITY_CACHE_MAX)
-            this.cache.clear();
-    }
-}
-/** Shared tracker used by the job manager and interactive sessions. */
-export const processIdentityTracker = new ProcessIdentityTracker();
-/**
- * Legacy-compatible helper. Windows returns undefined here because the job
- * manager's existing liveness contract treats an absent identity as "unproven"
- * and must keep behaving exactly as before this extraction.
- */
-export function processIdentity(pid, options = {}) {
-    if (process.platform === "win32")
-        return undefined;
-    return processIdentityTracker.capture(pid, options);
-}
-export function forgetProcessIdentity(pid) {
-    processIdentityTracker.forget(pid);
-}
-//# sourceMappingURL=process-identity.js.map

package/dist/os/process-identity.js.map

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

package/dist/tools/interactive-session-tools.d.ts

@@ -1,11 +0,0 @@
-/**
- * Tool adapter for the seven additive `terminal.*` operations.
- *
- * Existing shell and job tools are untouched. Every handler requires an owning
- * conversation id, projects a concise ANSI-free `output` for providers and
- * transcripts, and returns the structured result under `interactiveSession`.
- */
-import { InteractiveSessionManager } from "../interactive-session/manager.js";
-import type { ToolHandler } from "./tool-types.js";
-export declare const INTERACTIVE_SESSION_TOOL_NAMES: readonly ["terminal.start", "terminal.send", "terminal.read", "terminal.status", "terminal.list", "terminal.resize", "terminal.close"];
-export declare function createInteractiveSessionHandlers(manager?: InteractiveSessionManager): Record<(typeof INTERACTIVE_SESSION_TOOL_NAMES)[number], ToolHandler>;