@pentoshi/clai 4.11.5 → 4.11.8

package/dist/tools/jobs/redacted-writer.js

@@ -0,0 +1,134 @@
+import { redactSecrets } from "../../llm/provider.js";
+import { createHash } from "node:crypto";
+import { createWriteStream } from "node:fs";
+import { StringDecoder } from "node:string_decoder";
+const PER_FILE_BYTES = 1024 * 1024;
+const MAX_STREAM_BYTES = 16 * 1024 * 1024;
+export class RotatingRedactedWriter {
+    receipt;
+    stream;
+    streamDone;
+    completedStreams = [];
+    index = 0;
+    currentBytes = 0;
+    hash = createHash("sha256");
+    decoder = new StringDecoder("utf8");
+    pending = "";
+    closePromise;
+    writeError;
+    closed = false;
+    acceptedBytes;
+    backpressuredStreams = new Set();
+    static REDACTION_OVERLAP_CHARS = 4096;
+    constructor(receipt) {
+        this.receipt = receipt;
+        this.acceptedBytes = receipt.bytes;
+    }
+    append(raw) {
+        if (this.closed)
+            throw new Error("Cannot append to a closed job artifact");
+        this.pending += Buffer.isBuffer(raw) ? this.decoder.write(raw) : raw;
+        let writable = true;
+        const lastNewline = this.pending.lastIndexOf("\n");
+        if (lastNewline >= 0) {
+            writable = this.writeRedacted(this.pending.slice(0, lastNewline + 1));
+            this.pending = this.pending.slice(lastNewline + 1);
+        }
+        if (this.pending.length <= RotatingRedactedWriter.REDACTION_OVERLAP_CHARS) {
+            return writable;
+        }
+        const flushLength = this.pending.length - RotatingRedactedWriter.REDACTION_OVERLAP_CHARS;
+        writable = this.writeRedacted(this.pending.slice(0, flushLength)) && writable;
+        this.pending = this.pending.slice(flushLength);
+        return writable;
+    }
+    waitForDrain() {
+        const blocked = [...this.backpressuredStreams].filter((stream) => stream.writableNeedDrain);
+        if (blocked.length === 0)
+            return Promise.resolve();
+        return Promise.all(blocked.map((stream) => new Promise((resolve) => {
+            const done = () => {
+                stream.off("drain", done);
+                stream.off("finish", done);
+                stream.off("error", done);
+                this.backpressuredStreams.delete(stream);
+                resolve();
+            };
+            stream.once("drain", done);
+            stream.once("finish", done);
+            stream.once("error", done);
+        }))).then(() => undefined);
+    }
+    close() {
+        if (this.closePromise)
+            return this.closePromise;
+        this.pending += this.decoder.end();
+        if (this.pending)
+            this.writeRedacted(this.pending);
+        this.pending = "";
+        this.closed = true;
+        this.finishCurrentStream();
+        this.closePromise = Promise.all(this.completedStreams).then(() => {
+            if (this.writeError)
+                throw this.writeError;
+        });
+        return this.closePromise;
+    }
+    writeRedacted(source) {
+        const safe = redactSecrets(source);
+        if (safe !== source)
+            this.receipt.redacted = true;
+        let data = Buffer.from(safe, "utf8");
+        const remaining = Math.max(0, MAX_STREAM_BYTES - this.acceptedBytes);
+        if (data.length > remaining) {
+            this.receipt.droppedBytes += data.length - remaining;
+            data = data.subarray(0, remaining);
+        }
+        this.acceptedBytes += data.length;
+        let writable = true;
+        while (data.length > 0) {
+            if (!this.stream || this.currentBytes >= PER_FILE_BYTES)
+                this.rotate();
+            const room = PER_FILE_BYTES - this.currentBytes;
+            const part = data.subarray(0, room);
+            const stream = this.stream;
+            const accepted = stream.write(part);
+            if (!accepted)
+                this.backpressuredStreams.add(stream);
+            writable = accepted && writable;
+            this.hash.update(part);
+            this.receipt.bytes += part.length;
+            this.receipt.sha256 = this.hash.copy().digest("hex");
+            this.currentBytes += part.length;
+            data = data.subarray(part.length);
+        }
+        return writable;
+    }
+    finishCurrentStream() {
+        if (!this.stream || !this.streamDone)
+            return;
+        const stream = this.stream;
+        const done = this.streamDone;
+        this.stream = undefined;
+        this.streamDone = undefined;
+        stream.end();
+        this.completedStreams.push(done);
+    }
+    rotate() {
+        this.finishCurrentStream();
+        const path = this.index === 0 ? this.receipt.path : `${this.receipt.path}.${this.index}`;
+        this.index += 1;
+        this.currentBytes = 0;
+        this.receipt.chunks.push(path);
+        const stream = createWriteStream(path, { flags: "w", mode: 0o600 });
+        this.stream = stream;
+        this.streamDone = new Promise((resolve) => {
+            stream.once("finish", resolve);
+            stream.once("error", (error) => {
+                this.writeError ??= error;
+                resolve();
+            });
+        });
+    }
+}
+//# sourceMappingURL=redacted-writer.js.map

package/dist/tools/jobs/redacted-writer.js.map

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

package/dist/tools/jobs/types.d.ts

@@ -0,0 +1,152 @@
+export type JobStatus = "starting" | "running" | "exited" | "failed" | "stopping" | "killed" | "lost";
+export type JobTerminalStatus = Exclude<JobStatus, "starting" | "running" | "stopping">;
+export interface JobArtifactReceipt {
+    path: string;
+    chunks: string[];
+    bytes: number;
+    droppedBytes: number;
+    redacted: boolean;
+    sha256: string;
+}
+export type JobMonitorMetadata = Record<string, unknown>;
+export interface JobLinkMetadata {
+    taskId?: string | undefined;
+    parentTaskId?: string | undefined;
+    delegationId?: string | undefined;
+    wakeOnCompletion?: boolean | undefined;
+    monitor?: JobMonitorMetadata | undefined;
+    responderLeaseId?: string | undefined;
+    responder?: boolean | undefined;
+}
+export type JobKind = "durable" | "ephemeral";
+export interface BackgroundJob extends JobLinkMetadata {
+    id: string;
+    command: string;
+    commandDisplay: string;
+    cwd: string;
+    pid?: number | undefined;
+    processGroupId?: number | undefined;
+    processIdentity?: string | undefined;
+    status: JobStatus;
+    startedAt: string;
+    heartbeatAt?: string | undefined;
+    endedAt?: string | undefined;
+    exitCode?: number | undefined;
+    signal?: string | undefined;
+    artifactPath: string;
+    stdoutArtifact: string;
+    stderrArtifact: string;
+    artifacts: {
+        stdout: JobArtifactReceipt;
+        stderr: JobArtifactReceipt;
+    };
+    redactionProfile: string;
+    ownerSessionId: string;
+    kind?: JobKind | undefined;
+    name?: string | undefined;
+    authorization?: {
+        target: string;
+        expiresAt?: string | undefined;
+    } | undefined;
+    timeoutAt?: string | undefined;
+}
+export interface SupersededResultRevision {
+    resultRevision: number;
+    resultHash: string;
+    status: JobTerminalStatus;
+    endedAt: string;
+    exitCode?: number | undefined;
+    signal?: string | undefined;
+    deliveredAt?: string | undefined;
+    readAt?: string | undefined;
+    analyzedAt?: string | undefined;
+    acknowledgedAt?: string | undefined;
+    settledAt?: string | undefined;
+}
+export interface ResponderNotification {
+    id: string;
+    ownerSessionId: string;
+    jobId: string;
+    taskId?: string | undefined;
+    parentTaskId?: string | undefined;
+    status: JobTerminalStatus;
+    createdAt: string;
+    startedAt: string;
+    endedAt: string;
+    exitCode?: number | undefined;
+    signal?: string | undefined;
+    stdoutArtifact: JobArtifactReceipt;
+    stderrArtifact: JobArtifactReceipt;
+    commandDisplay: string;
+    wakeOnCompletion: boolean;
+    responder: boolean;
+    monitor?: JobMonitorMetadata | undefined;
+    responderLeaseId?: string | undefined;
+    deliveryStartedAt?: string | undefined;
+    deliveredAt?: string | undefined;
+    readAt?: string | undefined;
+    analyzedAt?: string | undefined;
+    acknowledgedAt?: string | undefined;
+    discardedAt?: string | undefined;
+    discardReason?: "session-cancelled" | undefined;
+    resultRevision?: number | undefined;
+    resultHash?: string | undefined;
+    supersededRevisions?: readonly SupersededResultRevision[] | undefined;
+    archivedAt?: string | undefined;
+    settledAt?: string | undefined;
+}
+export type JobManagerChange = {
+    type: "job";
+    jobId: string;
+} | {
+    type: "notification";
+    jobId: string;
+    notificationId: string;
+};
+export type JobManagerListener = (change: JobManagerChange) => void;
+interface PersistedRegistryV1 {
+    schemaVersion: 1;
+    jobs: BackgroundJob[];
+}
+export interface PersistedRegistryV2 {
+    schemaVersion: 2;
+    jobs: BackgroundJob[];
+    notifications: ResponderNotification[];
+    settlements?: PendingSettlement[];
+    consumedResults?: ConsumedResponderResult[];
+}
+export interface ConsumedResponderResult {
+    jobId: string;
+    resultHash: string;
+    resultRevision: number;
+    acknowledgedAt: string;
+}
+export interface PendingSettlement {
+    jobId: string;
+    resultRevision: number;
+    attempts: number;
+    firstAttemptAt: string;
+    lastAttemptAt: string;
+    lastReason: string;
+    deadLetteredAt?: string | undefined;
+}
+export type PersistedRegistry = PersistedRegistryV1 | PersistedRegistryV2;
+export interface BackgroundSpawnSpec {
+    command: string;
+    argv: string[];
+    stdinText?: string | undefined;
+    display?: string | undefined;
+}
+export interface StartJobOptions extends JobLinkMetadata {
+    cwd?: string | undefined;
+    name?: string | undefined;
+    ownerSessionId?: string | undefined;
+    profile?: string | undefined;
+    estimatedSeconds?: number | undefined;
+    timeoutMs?: number | undefined;
+    authorization?: {
+        target: string;
+        expiresAt?: string | undefined;
+    } | undefined;
+}
+export {};

package/dist/tools/jobs/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tools/jobs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/jobs/types.ts"],"names":[],"mappings":""}

package/dist/tools/jobs.d.ts

@@ -1,181 +1,17 @@
 import { type ChildProcess } from "node:child_process";
-import type { ToolCall, ToolResult } from "../types.js";
-export type JobStatus = "starting" | "running" | "exited" | "failed" | "stopping" | "killed" | "lost";
-export type JobTerminalStatus = Exclude<JobStatus, "starting" | "running" | "stopping">;
-export interface JobArtifactReceipt {
-    path: string;
-    chunks: string[];
-    bytes: number;
-    droppedBytes: number;
-    redacted: boolean;
-    sha256: string;
-}
-export type JobMonitorMetadata = Record<string, unknown>;
-export interface JobLinkMetadata {
-    taskId?: string | undefined;
-    parentTaskId?: string | undefined;
-    /**
-     * Stable delegation identity minted before launch. It is the
-     * reconciliation key between a job and its responder child task, so a fast
-     * exit or a failed link cannot orphan the child.
-     */
-    delegationId?: string | undefined;
-    wakeOnCompletion?: boolean | undefined;
-    monitor?: JobMonitorMetadata | undefined;
-    /** Runtime listening lease that authorized this responder delegation. */
-    responderLeaseId?: string | undefined;
-    /**
-     * Opt-in delegation to the Responder: fire-and-continue, plan subtask +
-     * auto-wake on completion, and inclusion in the Responder inbox/UI. When
-     * false/absent the job is a plain background job the agent polls itself
-     * (shell.jobs/shell.tail) exactly as before Responder existed.
-     */
-    responder?: boolean | undefined;
-}
-/**
- * durable  — shell.start / auto-backgrounded servers (listed by shell.jobs, persisted)
- * ephemeral — per-tool stall tracking in the agent runner (never listed, never persisted)
- */
-export type JobKind = "durable" | "ephemeral";
-export interface BackgroundJob extends JobLinkMetadata {
-    id: string;
-    command: string;
-    commandDisplay: string;
-    cwd: string;
-    pid?: number | undefined;
-    processGroupId?: number | undefined;
-    processIdentity?: string | undefined;
-    status: JobStatus;
-    startedAt: string;
-    heartbeatAt?: string | undefined;
-    endedAt?: string | undefined;
-    exitCode?: number | undefined;
-    signal?: string | undefined;
-    artifactPath: string;
-    stdoutArtifact: string;
-    stderrArtifact: string;
-    artifacts: {
-        stdout: JobArtifactReceipt;
-        stderr: JobArtifactReceipt;
-    };
-    redactionProfile: string;
-    ownerSessionId: string;
-    /** Default durable for registry records; ephemeral for tool-stall tracking. */
-    kind?: JobKind | undefined;
-    name?: string | undefined;
-    authorization?: {
-        target: string;
-        expiresAt?: string | undefined;
-    } | undefined;
-    /** Accepted when reading legacy registries but never armed or restored. */
-    timeoutAt?: string | undefined;
-}
-export interface ResponderPollingPolicyInput {
-    call: ToolCall;
-    targetJob?: BackgroundJob | undefined;
-    /** Jobs in the exact shell.jobs display window, in display order. */
-    recentJobs?: readonly BackgroundJob[] | undefined;
-}
-export declare function responderPollingPolicy(input: ResponderPollingPolicyInput): {
-    blocked: boolean;
-    reason?: string | undefined;
-};
-export declare function formatJobElapsed(job: Pick<BackgroundJob, "startedAt" | "endedAt">, now?: number): string;
-export interface SupersededResultRevision {
-    resultRevision: number;
-    resultHash: string;
-    status: JobTerminalStatus;
-    endedAt: string;
-    exitCode?: number | undefined;
-    signal?: string | undefined;
-    deliveredAt?: string | undefined;
-    readAt?: string | undefined;
-    analyzedAt?: string | undefined;
-    acknowledgedAt?: string | undefined;
-    settledAt?: string | undefined;
-}
-export interface ResponderNotification {
-    id: string;
-    ownerSessionId: string;
-    jobId: string;
-    taskId?: string | undefined;
-    parentTaskId?: string | undefined;
-    status: JobTerminalStatus;
-    createdAt: string;
-    startedAt: string;
-    endedAt: string;
-    exitCode?: number | undefined;
-    signal?: string | undefined;
-    stdoutArtifact: JobArtifactReceipt;
-    stderrArtifact: JobArtifactReceipt;
-    commandDisplay: string;
-    wakeOnCompletion: boolean;
-    responder: boolean;
-    monitor?: JobMonitorMetadata | undefined;
-    responderLeaseId?: string | undefined;
-    /** A delivery attempt began; not durable consumption. Cleared claims may retry. */
-    deliveryStartedAt?: string | undefined;
-    deliveredAt?: string | undefined;
-    readAt?: string | undefined;
-    analyzedAt?: string | undefined;
-    acknowledgedAt?: string | undefined;
-    /** User discarded this receipt (cancel/new session); never model analysis. */
-    discardedAt?: string | undefined;
-    discardReason?: "session-cancelled" | undefined;
-    /** Monotonic revision of the authoritative result this receipt carries. */
-    resultRevision?: number | undefined;
-    /** Content hash of the authoritative result, used to detect a correction. */
-    resultHash?: string | undefined;
-    /** Bounded audit trail of revisions this receipt superseded. */
-    supersededRevisions?: readonly SupersededResultRevision[] | undefined;
-    archivedAt?: string | undefined;
-    settledAt?: string | undefined;
-}
-export type JobManagerChange = {
-    type: "job";
-    jobId: string;
-} | {
-    type: "notification";
-    jobId: string;
-    notificationId: string;
-};
-export type JobManagerListener = (change: JobManagerChange) => void;
-/** Durable projection marker for a terminal result whose plan child is unsettled. */
-export interface PendingSettlement {
-    jobId: string;
-    resultRevision: number;
-    attempts: number;
-    firstAttemptAt: string;
-    lastAttemptAt: string;
-    lastReason: string;
-    deadLetteredAt?: string | undefined;
-}
+import type { ToolResult } from "../types.js";
+import { responderPollingPolicy } from "./jobs/polling-policy.js";
+import { formatJobElapsed } from "./jobs/helpers.js";
+import { BackgroundJob, BackgroundSpawnSpec, JobLinkMetadata, JobManagerListener, JobStatus, PendingSettlement, ResponderNotification, StartJobOptions } from "./jobs/types.js";
+export type { BackgroundJob, BackgroundSpawnSpec, JobArtifactReceipt, JobKind, JobLinkMetadata, JobManagerChange, JobManagerListener, JobMonitorMetadata, JobStatus, JobTerminalStatus, PendingSettlement, ResponderNotification, StartJobOptions, SupersededResultRevision } from "./jobs/types.js";
+export { formatJobElapsed };
+export { responderPollingPolicy };
+export type { ResponderPollingPolicyInput } from "./jobs/polling-policy.js";
 interface TailCursor {
     stream?: "stdout" | "stderr" | "combined";
     offset?: number;
     bytes?: number;
 }
-/** Safe detached process form. stdinText is written once, then stdin is closed. */
-export interface BackgroundSpawnSpec {
-    command: string;
-    argv: string[];
-    stdinText?: string | undefined;
-    /** Non-secret display text persisted in the registry and artifacts. */
-    display?: string | undefined;
-}
-export interface StartJobOptions extends JobLinkMetadata {
-    cwd?: string | undefined;
-    name?: string | undefined;
-    ownerSessionId?: string | undefined;
-    profile?: string | undefined;
-    estimatedSeconds?: number | undefined;
-    /** Legacy compatibility input. Durable jobs no longer have generic deadlines. */
-    timeoutMs?: number | undefined;
-    authorization?: {
-        target: string;
-        expiresAt?: string | undefined;
-    } | undefined;
-}
 export declare class JobManager {
     private readonly jobsDir;
     private jobs;
@@ -192,12 +28,6 @@ export declare class JobManager {
     private livenessWatchTimer;
     private finalizations;
     private listeners;
-    /**
-     * Tracks the first time a live job (with no ChildProcess handle) failed the
-     * liveness check, so we only finalize it as "lost" after a sustained grace
-     * window instead of on a single transient miss. Cleared as soon as the job is
-     * observed alive again or finalized.
-     */
     private livenessMisses;
     private livenessCheckedAt;
     private registryRetryTimer;
@@ -206,11 +36,8 @@ export declare class JobManager {
     constructor(jobsDir?: string);
     private isDurable;
     private artifactPathsOf;
-    /** Delete a dropped job's artifact chunks, never one still referenced. */
     private removeJobArtifacts;
-    /** Drop a job row plus its per-job caches and artifacts. */
     private forgetJob;
-    /** Remove artifact files whose job row no longer exists. */
     private sweepOrphanArtifacts;
     private isLive;
     private isTerminalStatus;
@@ -227,39 +54,17 @@ export declare class JobManager {
     private ensureCompletionNotification;
     private closeWriters;
     private finalizeJob;
-    /** Reconcile a restored process that no longer has a ChildProcess close event. */
     private refreshJobLiveness;
     private scheduleTaskSettlement;
     private completeSettlement;
-    /**
-     * Retry until the projection lands. The marker is durable, so a crash or a
-     * long-lived plan-write conflict cannot silently strand a green child, and an
-     * unrecoverable case is dead-lettered with a visible reason.
-     */
     private retrySettlement;
-    /**
-     * One coalesced, unref'd watcher that reconciles restored live jobs without a
-     * UI read. Without it a headless session can leave a finished responder job
-     * "running" forever, because liveness was only refreshed by list/get calls.
-     */
     private scheduleLivenessWatch;
-    /** Ownership guard: a receipt may only be mutated by its owning session. */
     private ownsNotification;
-    /** Receipt for a launch that was deduplicated by its delegation key. */
     private startJobReceipt;
-    /** Terminal results whose plan child could not be settled yet. */
     getPendingSettlements(): PendingSettlement[];
-    /**
-     * Register an in-flight tool for stall tracking only.
-     * Never appears in shell.jobs and never touches the durable registry.
-     */
     registerJob(id: string, job: BackgroundJob, ac?: AbortController, child?: ChildProcess): void;
     updateJobStatus(id: string, status: JobStatus, exitCode?: number): void;
     startJob(command: string | BackgroundSpawnSpec, options?: StartJobOptions): Promise<ToolResult>;
-    /**
-     * List durable background jobs for this session only.
-     * Ephemeral tool-stall rows and other sessions' jobs are excluded.
-     */
     listJobs(sessionId?: string): ToolResult;
     private resolveJobId;
     getJob(id: string): BackgroundJob | undefined;
@@ -267,10 +72,6 @@ export declare class JobManager {
     pendingNotifications(sessionId?: string): ResponderNotification[];
     claimNextResponderNotification(sessionId: string, leaseId: string): ResponderNotification | undefined;
     releaseResponderNotificationClaim(notificationId: string): void;
-    /**
-     * Record that a delivery attempt started. This is deliberately weaker than
-     * `markDelivered`: an aborted or failed analysis turn must remain deliverable.
-     */
     markDeliveryStarted(notificationId: string, sessionId?: string): boolean;
     markDelivered(notificationId: string, sessionId?: string): boolean;
     markRead(notificationId: string, sessionId: string): boolean;
@@ -291,14 +92,11 @@ export declare class JobManager {
     cancelAll(sessionId: string): Promise<ToolResult>;
     getRunningJobs(sessionId?: string): BackgroundJob[];
     getRecentJobs(limit?: number, sessionId?: string): BackgroundJob[];
-    /** Drop stale terminal durable jobs and all leftover ephemeral rows. */
     pruneTerminalJobs(): void;
     private loadAndReconcile;
-    /** Only durable jobs and responder notifications are written to disk. */
     private registry;
     private scheduleRegistryRetry;
     private persistSync;
     private persist;
 }
 export declare const jobManager: JobManager;
-export {};