@qduc/term2 0.11.1 → 0.13.0

package/dist/services/shell/background-shell-registry.js

@@ -0,0 +1,341 @@
+import { randomUUID } from 'node:crypto';
+export class BackgroundShellRegistryCapacityError extends Error {
+    constructor(maxConcurrentJobs) {
+        super(`Background shell job limit reached (${maxConcurrentJobs}).`);
+        this.name = 'BackgroundShellRegistryCapacityError';
+    }
+}
+export class BackgroundShellRegistryDisposedError extends Error {
+    constructor() {
+        super('Background shell registry has been disposed.');
+        this.name = 'BackgroundShellRegistryDisposedError';
+    }
+}
+/**
+ * Session-owned lifecycle for shell processes whose tool invocation has
+ * already returned. The registry deliberately owns cancellation and retention
+ * so callers cannot accidentally leave an orphaned process behind.
+ */
+export class BackgroundShellRegistry {
+    #jobs = new Map();
+    #foreground = new Map();
+    #terminalJobIds = [];
+    #maxConcurrentJobs;
+    #maxRetainedJobs;
+    #createId;
+    #now;
+    #eventSink;
+    #runningJobs = 0;
+    #disposed = false;
+    #disposePromise;
+    constructor(options = {}) {
+        this.#maxConcurrentJobs = options.maxConcurrentJobs ?? 4;
+        this.#maxRetainedJobs = options.maxRetainedJobs ?? 20;
+        this.#createId = options.createId ?? randomUUID;
+        this.#now = options.now ?? Date.now;
+        this.#eventSink = options.onEvent;
+        if (!Number.isInteger(this.#maxConcurrentJobs) || this.#maxConcurrentJobs < 1) {
+            throw new RangeError('maxConcurrentJobs must be a positive integer.');
+        }
+        if (!Number.isInteger(this.#maxRetainedJobs) || this.#maxRetainedJobs < 0) {
+            throw new RangeError('maxRetainedJobs must be a non-negative integer.');
+        }
+    }
+    launch(options) {
+        if (this.#disposed)
+            throw new BackgroundShellRegistryDisposedError();
+        if (this.#runningJobs >= this.#maxConcurrentJobs) {
+            throw new BackgroundShellRegistryCapacityError(this.#maxConcurrentJobs);
+        }
+        const job = {
+            id: this.#createId(),
+            command: options.command,
+            status: 'running',
+            startedAt: this.#now(),
+        };
+        job.lastActivityAt = job.startedAt;
+        const controller = new AbortController();
+        this.#runningJobs += 1;
+        const record = {
+            job,
+            controller,
+            settled: Promise.resolve(job),
+        };
+        this.#jobs.set(job.id, record);
+        options.onStarted?.(job.id);
+        record.settled = this.#settle(record, options);
+        this.#emit({ type: 'background_shell_started', jobId: job.id, command: job.command });
+        return { ...job, settled: record.settled };
+    }
+    /**
+     * Starts a root shell process under a detachable foreground lease. The lease
+     * is intentionally invisible to `list()` until `adoptForeground` succeeds.
+     */
+    startForeground(options) {
+        if (this.#disposed)
+            throw new BackgroundShellRegistryDisposedError();
+        if (this.#foreground.has(options.callId)) {
+            throw new Error(`Foreground shell lease already exists for tool call ${options.callId}.`);
+        }
+        const job = {
+            id: this.#createId(),
+            command: options.command,
+            status: 'running',
+            startedAt: this.#now(),
+        };
+        job.lastActivityAt = job.startedAt;
+        const controller = new AbortController();
+        let resolveForegroundResult;
+        let rejectForegroundResult;
+        const foregroundResult = new Promise((resolve, reject) => {
+            resolveForegroundResult = resolve;
+            rejectForegroundResult = reject;
+        });
+        const abortFromParent = () => controller.abort();
+        if (options.parentSignal?.aborted)
+            abortFromParent();
+        else
+            options.parentSignal?.addEventListener('abort', abortFromParent, { once: true });
+        const record = {
+            job,
+            controller,
+            callId: options.callId,
+            adopted: false,
+            onAdopted: options.onAdopted,
+            detachParentAbort: () => options.parentSignal?.removeEventListener('abort', abortFromParent),
+            resolveForegroundResult,
+            rejectForegroundResult,
+            settled: Promise.resolve(job),
+        };
+        this.#foreground.set(options.callId, record);
+        options.onStarted?.(job.id);
+        record.settled = this.#settleForeground(record, options);
+        return {
+            callId: record.callId,
+            jobId: job.id,
+            command: job.command,
+            startedAt: job.startedAt,
+            status: 'running',
+            foregroundResult,
+            settled: record.settled,
+        };
+    }
+    getForeground(callId) {
+        const record = this.#foreground.get(callId);
+        if (!record || record.job.status !== 'running')
+            return undefined;
+        return {
+            callId: record.callId,
+            jobId: record.job.id,
+            command: record.job.command,
+            status: 'running',
+            startedAt: record.job.startedAt,
+        };
+    }
+    listForeground() {
+        return [...this.#foreground.values()]
+            .filter((record) => record.job.status === 'running')
+            .map((record) => ({
+            callId: record.callId,
+            jobId: record.job.id,
+            command: record.job.command,
+            status: 'running',
+            startedAt: record.job.startedAt,
+        }));
+    }
+    /** Atomically publishes a running foreground lease as a background job. */
+    adoptForeground(callId) {
+        const record = this.#foreground.get(callId);
+        if (!record || record.job.status !== 'running') {
+            throw new Error(`No running foreground shell lease exists for tool call ${callId}.`);
+        }
+        if (record.controller.signal.aborted) {
+            throw new Error(`Foreground shell lease for tool call ${callId} is already aborting.`);
+        }
+        if (this.#disposed)
+            throw new BackgroundShellRegistryDisposedError();
+        if (this.#runningJobs >= this.#maxConcurrentJobs) {
+            throw new BackgroundShellRegistryCapacityError(this.#maxConcurrentJobs);
+        }
+        // All validation precedes this ownership change. JavaScript's synchronous
+        // turn makes these mutations atomic with respect to process settlement.
+        record.detachParentAbort();
+        record.adopted = true;
+        this.#foreground.delete(callId);
+        this.#jobs.set(record.job.id, record);
+        this.#runningJobs += 1;
+        const result = { jobId: record.job.id, status: 'running' };
+        try {
+            record.onAdopted?.();
+        }
+        catch {
+            // Lifecycle ownership has already changed; observers cannot roll it back.
+        }
+        record.resolveForegroundResult(result);
+        this.#emit({ type: 'background_shell_started', jobId: record.job.id, command: record.job.command });
+        return result;
+    }
+    get(id) {
+        const job = this.#jobs.get(id)?.job;
+        return job ? { ...job } : undefined;
+    }
+    whenSettled(id) {
+        return this.#jobs.get(id)?.settled;
+    }
+    setEventSink(eventSink) {
+        this.#eventSink = eventSink;
+    }
+    list() {
+        return [...this.#jobs.values()].map(({ job }) => ({ ...job }));
+    }
+    cancel(id) {
+        const record = this.#jobs.get(id);
+        if (!record || record.job.status !== 'running')
+            return false;
+        record.job.status = 'cancelling';
+        record.job.lastActivityAt = this.#now();
+        record.controller.abort();
+        return true;
+    }
+    /** Records that a running process produced output without retaining the chunk. */
+    recordOutputChunk(id) {
+        const record = this.#jobs.get(id) ?? [...this.#foreground.values()].find((candidate) => candidate.job.id === id);
+        if (!record || (record.job.status !== 'running' && record.job.status !== 'cancelling'))
+            return false;
+        record.job.lastActivityAt = this.#now();
+        return true;
+    }
+    /** Cancels every running process and permanently rejects new launches. */
+    dispose() {
+        if (this.#disposePromise)
+            return this.#disposePromise;
+        this.#disposed = true;
+        for (const { job } of this.#jobs.values()) {
+            this.cancel(job.id);
+        }
+        const foreground = [...this.#foreground.values()];
+        for (const record of foreground)
+            record.controller.abort();
+        this.#disposePromise = Promise.allSettled([
+            ...[...this.#jobs.values()].map((record) => record.settled),
+            ...foreground.map((record) => record.settled),
+        ]).then(() => { });
+        return this.#disposePromise;
+    }
+    async #settle(record, options) {
+        let result;
+        let failure;
+        try {
+            result = await options.run(record.controller.signal);
+        }
+        catch (error) {
+            failure = error;
+        }
+        try {
+            await options.onSettled?.();
+        }
+        catch (error) {
+            failure ??= error;
+        }
+        const { job } = record;
+        this.#runningJobs -= 1;
+        job.completedAt = this.#now();
+        job.lastActivityAt = job.completedAt;
+        if (record.controller.signal.aborted) {
+            job.status = 'cancelled';
+            if (result !== undefined)
+                job.result = result;
+        }
+        else if (failure !== undefined) {
+            job.status = 'failed';
+            job.error = errorMessage(failure);
+        }
+        else {
+            job.status = options.resultToStatus?.(result) ?? 'completed';
+            job.result = result;
+        }
+        this.#retainTerminal(job.id);
+        this.#emit({
+            type: 'background_shell_completed',
+            jobId: job.id,
+            command: job.command,
+            status: job.status,
+            ...(job.result === undefined ? {} : { output: job.result }),
+            ...(job.error === undefined ? {} : { error: job.error }),
+        });
+        return { ...job };
+    }
+    async #settleForeground(record, options) {
+        let result;
+        let failure;
+        try {
+            result = await options.run(record.controller.signal);
+        }
+        catch (error) {
+            failure = error;
+        }
+        try {
+            await options.onSettled?.();
+        }
+        catch (error) {
+            failure ??= error;
+        }
+        const { job } = record;
+        job.completedAt = this.#now();
+        job.lastActivityAt = job.completedAt;
+        if (record.controller.signal.aborted) {
+            job.status = 'cancelled';
+            if (result !== undefined)
+                job.result = result;
+        }
+        else if (failure !== undefined) {
+            job.status = 'failed';
+            job.error = errorMessage(failure);
+        }
+        else {
+            job.status = options.resultToStatus?.(result) ?? 'completed';
+            job.result = result;
+        }
+        if (record.adopted) {
+            this.#runningJobs -= 1;
+            this.#retainTerminal(job.id);
+            this.#emit({
+                type: 'background_shell_completed',
+                jobId: job.id,
+                command: job.command,
+                status: job.status,
+                ...(job.result === undefined ? {} : { output: job.result }),
+                ...(job.error === undefined ? {} : { error: job.error }),
+            });
+        }
+        else {
+            record.detachParentAbort();
+            this.#foreground.delete(record.callId);
+            if (failure !== undefined)
+                record.rejectForegroundResult(failure);
+            else
+                record.resolveForegroundResult(result);
+        }
+        return { ...job };
+    }
+    #retainTerminal(id) {
+        this.#terminalJobIds.push(id);
+        while (this.#terminalJobIds.length > this.#maxRetainedJobs) {
+            const evicted = this.#terminalJobIds.shift();
+            if (evicted)
+                this.#jobs.delete(evicted);
+        }
+    }
+    #emit(event) {
+        try {
+            this.#eventSink?.(event);
+        }
+        catch {
+            // Event consumers are observational and must not change process lifetime.
+        }
+    }
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=background-shell-registry.js.map

package/dist/services/shell/background-shell-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-shell-registry.js","sourceRoot":"","sources":["../../../source/services/shell/background-shell-registry.ts"],"names":[],"mappings":"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"}

package/dist/services/shell/background-shell-watches.d.ts

@@ -0,0 +1,141 @@
+import type { BackgroundShellOutputStream, BackgroundShellOutputStore } from './background-shell-output-store.js';
+/**
+ * The session-owned output store + watch layer handed to the shell tool and
+ * the job-control tools. Created beside the registry and threaded alongside
+ * it, so the shell seam and the monitor tools share one store and one watch
+ * set per job.
+ */
+export interface BackgroundShellOutputBundle {
+    store: BackgroundShellOutputStore;
+    watches: BackgroundShellWatches;
+}
+/**
+ * Watch semantics over a {@link BackgroundShellOutputStore}: attach a watch to
+ * a background shell job and be told, without polling, when the job's output
+ * says something worth reacting to.
+ *
+ * A watch fires when a complete line in its selected stream matches its
+ * pattern (or, with no pattern, when any new complete line arrives), and only
+ * after `idleMs` of quiet — a burst of 200 matching lines produces one firing
+ * carrying the burst, not 200 firings. The idle window is quiet *for this
+ * watch*: only new matching lines extend it; unrelated output does not delay
+ * the firing. Firings are counted per watch (`seq` 1, 2, …); a watch retires
+ * when it has fired `notifyLimit` times, when its job settles, or when
+ * cancelled by id.
+ *
+ * Watches replay the job's retained buffer from `fromOffset` (default 0 = the
+ * head of the buffer), which is the whole reason no launch-time monitor
+ * parameter exists: registering a watch after the line was already printed
+ * still catches it. Matching operates only on complete lines from the store —
+ * a pattern can never match a half line or a span across a chunk split; line
+ * assembly is the store's job.
+ *
+ * Ordering rule: {@link BackgroundShellWatches.settleJob} closes the store
+ * stream (flushing each stream's pending partial line as a final complete
+ * line), evaluates those final lines, then flushes every matched-but-
+ * undelivered watch firing synchronously and retires the job's watches — all
+ * before the call returns, so the caller can emit the job's completion
+ * notification and be certain no monitor firing will follow it.
+ *
+ * Pure unit module: no processes, no real timers, no shell-tool coupling. The
+ * timer scheduler is injected so tests drive time deterministically; the
+ * phase-5 shell-tool wiring passes a `setTimeout`-based adapter.
+ */
+export type ShellOutputWatchStream = BackgroundShellOutputStream | 'both';
+/** The immutable specification of one watch, as decided in the plan. */
+export interface ShellOutputWatch {
+    watchId: string;
+    jobId: string;
+    /** Absent = any output. */
+    pattern?: RegExp;
+    stream: ShellOutputWatchStream;
+    /** Coalescing window in ms; default 1500. */
+    idleMs: number;
+    /** Firing budget; default 1 when a pattern is set, 5 otherwise. */
+    notifyLimit: number;
+    /**
+     * Number of retained complete lines to skip from the head of the job's
+     * buffer when replaying. Default 0 = the whole retained buffer. Lines
+     * evicted before registration are not replayable — their bytes are surfaced
+     * through `droppedBytes` instead.
+     */
+    fromOffset: number;
+}
+export interface RegisterShellOutputWatchOptions {
+    jobId: string;
+    pattern?: RegExp;
+    stream?: ShellOutputWatchStream;
+    idleMs?: number;
+    notifyLimit?: number;
+    fromOffset?: number;
+    /** Passed through to every firing so the consumer can name the job. */
+    command?: string;
+}
+export interface ShellOutputFiring {
+    jobId: string;
+    watchId: string;
+    /** Per-watch firing counter, 1-based. */
+    seq: number;
+    /**
+     * Matched complete lines joined by '\n', capped at about 4 KB keeping the
+     * newest text.
+     */
+    matchedLines: string;
+    /** Store evictions since the job opened, from the store read at delivery. */
+    droppedBytes: number;
+    command?: string;
+}
+/**
+ * The module's only contact with wall-clock time. Injected so tests can drive
+ * time deterministically; production wiring passes a `setTimeout`-based
+ * adapter.
+ */
+export interface BackgroundShellWatchScheduler {
+    schedule(callback: () => void, delayMs: number): unknown;
+    cancel(handle: unknown): void;
+}
+export interface BackgroundShellWatchesOptions {
+    store: BackgroundShellOutputStore;
+    scheduler: BackgroundShellWatchScheduler;
+    /** Receives every firing. Subscribers are observational: a throw is swallowed. */
+    onFiring?: (firing: ShellOutputFiring) => void;
+}
+export declare class BackgroundShellWatchesError extends Error {
+    constructor(message: string);
+}
+export declare class BackgroundShellWatches {
+    #private;
+    constructor(options: BackgroundShellWatchesOptions);
+    /**
+     * Replaces the firing subscriber. The phase-5 shell-tool wiring installs the
+     * conversation-lane sink here when the session attaches it, so firings enter
+     * the same durable lane as job-completion events.
+     */
+    setOnFiring(callback: ((firing: ShellOutputFiring) => void) | undefined): void;
+    /** Begins a job's output stream; delegates to the store. */
+    open(jobId: string): void;
+    /**
+     * Routes one chunk of a job's output into the store and evaluates the new
+     * complete lines against the job's active watches. Throws when the store
+     * rejects the push (unknown or already-closed job).
+     */
+    push(jobId: string, stream: BackgroundShellOutputStream, text: string): void;
+    /**
+     * Registers a watch and returns its watchId. Replays the retained buffer
+     * from `fromOffset` immediately; on a job that has already settled, any
+     * replay match is flushed synchronously and the watch retires, because no
+     * firing may trail a job's completion.
+     */
+    registerWatch(options: RegisterShellOutputWatchOptions): string;
+    /** Retires a watch by id. Returns false when no such watch exists. */
+    cancelWatch(watchId: string): boolean;
+    /**
+     * Terminal settlement of a job. Closes the store stream (flushing each
+     * pending partial line), evaluates those final lines, then flushes every
+     * matched-but-undelivered firing synchronously and retires the job's
+     * watches. After this returns, no timer for the job can ever fire again, so
+     * the caller may emit the completion notification.
+     */
+    settleJob(jobId: string): void;
+}
+//# sourceMappingURL=background-shell-watches.d.ts.map

package/dist/services/shell/background-shell-watches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-shell-watches.d.ts","sourceRoot":"","sources":["../../../source/services/shell/background-shell-watches.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAElH;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,0BAA0B,CAAC;IAClC,OAAO,EAAE,sBAAsB,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,MAAM,sBAAsB,GAAG,2BAA2B,GAAG,MAAM,CAAC;AAE1E,wEAAwE;AACxE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,+BAA+B;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IACzD,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,0BAA0B,CAAC;IAClC,SAAS,EAAE,6BAA6B,CAAC;IACzC,kFAAkF;IAClF,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAChD;AAED,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAsBD,qBAAa,sBAAsB;;IAOjC,YAAY,OAAO,EAAE,6BAA6B,EAIjD;IAED;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC,GAAG,SAAS,GAAG,IAAI,CAE7E;IAED,4DAA4D;IAC5D,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAExB;IAED;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,2BAA2B,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAM3E;IAED;;;;;OAKG;IACH,aAAa,CAAC,OAAO,EAAE,+BAA+B,GAAG,MAAM,CAuD9D;IAED,sEAAsE;IACtE,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAIpC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAe7B;CAwFF"}