@pentoshi/clai 3.9.4 → 3.9.5

package/dist/interactive-session/artifact-writer.js

@@ -1,161 +0,0 @@
-/**
- * Bounded, owner-private artifact capture for one interactive session.
- *
- * The writer only ever receives canonical redacted bytes, so nothing sensitive
- * becomes durable. Chunk names contain only the opaque session id and an index —
- * never a command, cwd, or timestamp that could identify the workload.
- */
-import { createWriteStream } from "node:fs";
-import { mkdir } from "node:fs/promises";
-import { createHash } from "node:crypto";
-import { join } from "node:path";
-import { getArtifactDir } from "../store/paths.js";
-export class BoundedArtifactWriter {
-    options;
-    stream;
-    streamDone;
-    completedStreams = [];
-    chunks = [];
-    hash = createHash("sha256");
-    index = 0;
-    currentChunkBytes = 0;
-    capturedBytes = 0;
-    dropped = 0;
-    pendingBytes = 0;
-    digest = "";
-    closePromise;
-    writeError;
-    backpressured = new Set();
-    limitReached = false;
-    failed = false;
-    constructor(options) {
-        this.options = options;
-    }
-    get path() {
-        return join(this.options.directory, `${this.options.sessionId}.log`);
-    }
-    reference() {
-        return {
-            path: this.path,
-            bytes: this.capturedBytes,
-            droppedBytes: this.dropped,
-            redacted: true,
-        };
-    }
-    receipt() {
-        return {
-            ...this.reference(),
-            chunks: [...this.chunks],
-            sha256: this.digest,
-        };
-    }
-    append(bytes) {
-        if (this.failed || this.closePromise)
-            return true;
-        let data = bytes;
-        const remaining = Math.max(0, this.options.captureBytes - this.capturedBytes);
-        if (data.length > remaining) {
-            this.dropped += data.length - remaining;
-            data = data.subarray(0, remaining);
-            this.limitReached = this.options.onLimit === "terminate";
-        }
-        let writable = true;
-        while (data.length > 0) {
-            if (!this.stream || this.currentChunkBytes >= this.options.chunkBytes) {
-                this.rotate();
-            }
-            const room = this.options.chunkBytes - this.currentChunkBytes;
-            const part = data.subarray(0, room);
-            const stream = this.stream;
-            const accepted = stream.write(Buffer.from(part));
-            if (!accepted) {
-                this.backpressured.add(stream);
-                this.pendingBytes += part.length;
-            }
-            writable = accepted && writable;
-            this.hash.update(part);
-            this.digest = this.hash.copy().digest("hex");
-            this.capturedBytes += part.length;
-            this.currentChunkBytes += part.length;
-            data = data.subarray(part.length);
-        }
-        if (this.writeError)
-            this.failed = true;
-        if (this.pendingBytes > this.options.persistenceQueueBytes)
-            this.failed = true;
-        return writable;
-    }
-    async waitForDrain() {
-        const blocked = [...this.backpressured].filter((stream) => stream.writableNeedDrain);
-        if (blocked.length === 0) {
-            this.pendingBytes = 0;
-            return;
-        }
-        await Promise.all(blocked.map((stream) => new Promise((resolve) => {
-            const done = () => {
-                stream.off("drain", done);
-                stream.off("finish", done);
-                stream.off("error", done);
-                this.backpressured.delete(stream);
-                resolve();
-            };
-            stream.once("drain", done);
-            stream.once("finish", done);
-            stream.once("error", done);
-        })));
-        this.pendingBytes = 0;
-    }
-    close() {
-        if (this.closePromise)
-            return this.closePromise;
-        this.finishCurrentStream();
-        this.closePromise = Promise.all(this.completedStreams).then(() => {
-            if (this.writeError) {
-                this.failed = true;
-                throw this.writeError;
-            }
-        });
-        return this.closePromise;
-    }
-    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.path : `${this.path}.${this.index}`;
-        this.index += 1;
-        this.currentChunkBytes = 0;
-        this.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;
-                this.failed = true;
-                resolve();
-            });
-        });
-    }
-}
-/** Create the owner-only artifact directory for one session. */
-export async function createArtifactWriter(options) {
-    const directory = join(options.baseDir ?? getArtifactDir(), `interactive-${options.sessionId}`);
-    await mkdir(directory, { recursive: true, mode: 0o700 });
-    return new BoundedArtifactWriter({
-        sessionId: options.sessionId,
-        directory,
-        captureBytes: options.captureBytes,
-        chunkBytes: options.chunkBytes,
-        persistenceQueueBytes: options.persistenceQueueBytes,
-        onLimit: options.onLimit,
-    });
-}
-//# sourceMappingURL=artifact-writer.js.map

package/dist/interactive-session/artifact-writer.js.map

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

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

@@ -1,36 +0,0 @@
-/**
- * Identity-safe, single-winner teardown.
- *
- * Every termination trigger — explicit close, process exit, owner cancellation,
- * idle/lifetime timeout, conversation teardown, application shutdown — funnels
- * through `FinalizeOnce`, so exactly one execution owns the terminal transition
- * and repeated Close returns the recorded result without signalling again.
- */
-import { type ProcessIdentityComparison } from "../os/process-identity.js";
-import type { RecoveryJournal } from "./recovery-journal.js";
-import type { SessionRegistry } from "./registry.js";
-import type { SessionRuntime } from "./session-runtime.js";
-import { type CloseResult, type TerminationReason } from "./types.js";
-export interface CleanupDeps {
-    readonly registry: SessionRegistry;
-    readonly journal: RecoveryJournal;
-    readonly onFinalized?: ((runtime: SessionRuntime) => void) | undefined;
-    readonly process?: Partial<CleanupProcessDeps> | undefined;
-}
-export interface CleanupProcessDeps {
-    readonly isAlive: (pid: number | undefined) => boolean;
-    readonly compareIdentity: (pid: number | undefined, identity: string | undefined) => ProcessIdentityComparison;
-    readonly hasLiveDescendants: (pid: number) => Promise<boolean>;
-}
-export declare class CleanupCoordinator {
-    private readonly deps;
-    private readonly process;
-    constructor(deps: CleanupDeps);
-    /** Idempotent: later callers join the first execution's promise. */
-    close(runtime: SessionRuntime, reason: TerminationReason, deadlineMs: number): Promise<CloseResult>;
-    private execute;
-    private waitForOutputDrain;
-    private waitForExit;
-    /** True when a verified descendant or the root is still alive. */
-    private verifyAbsence;
-}

package/dist/interactive-session/cleanup.js

@@ -1,157 +0,0 @@
-/**
- * Identity-safe, single-winner teardown.
- *
- * Every termination trigger — explicit close, process exit, owner cancellation,
- * idle/lifetime timeout, conversation teardown, application shutdown — funnels
- * through `FinalizeOnce`, so exactly one execution owns the terminal transition
- * and repeated Close returns the recorded result without signalling again.
- */
-import { processIdentityTracker, } from "../os/process-identity.js";
-import { hasLiveDescendants, processAlive } from "../os/process-tree.js";
-import { artifactReference, isTerminalState, sessionError, } from "./types.js";
-const POLL_INTERVAL_MS = 50;
-const defaultProcessDeps = {
-    isAlive: processAlive,
-    compareIdentity: (pid, identity) => processIdentityTracker.compare(pid, identity),
-    hasLiveDescendants,
-};
-function delay(ms) {
-    return new Promise((resolve) => {
-        const timer = setTimeout(resolve, ms);
-        timer.unref?.();
-    });
-}
-/** Terminal state chosen by the cleanup owner from its winning reason. */
-function terminalStateFor(reason, processExited, cleanupFailed) {
-    if (cleanupFailed)
-        return "failed";
-    if (reason === "process-exit" || processExited)
-        return "exited";
-    if (reason === "launch-failure")
-        return "failed";
-    return "closed";
-}
-export class CleanupCoordinator {
-    deps;
-    process;
-    constructor(deps) {
-        this.deps = deps;
-        this.process = { ...defaultProcessDeps, ...deps.process };
-    }
-    /** Idempotent: later callers join the first execution's promise. */
-    close(runtime, reason, deadlineMs) {
-        if (isTerminalState(runtime.record.state) && runtime.finalize.started) {
-            return runtime.finalize.join();
-        }
-        return runtime.finalize.run(reason, () => this.execute(runtime, reason, deadlineMs));
-    }
-    async execute(runtime, reason, deadlineMs) {
-        const record = runtime.record;
-        const started = Date.now();
-        const remaining = () => Math.max(0, deadlineMs - (Date.now() - started));
-        // Commit `closing` before any termination action so later input is rejected.
-        this.deps.registry.transition(record, "closing", { terminationReason: reason });
-        runtime.input.rejectAll({ status: "not-delivered", deliveredBytes: 0 });
-        let error;
-        let cleanupVerified = true;
-        if (!runtime.processExited && this.process.isAlive(runtime.transport.pid)) {
-            const identity = this.process.compareIdentity(runtime.transport.pid, runtime.transport.identity);
-            if (identity === "match") {
-                await runtime.transport.requestTreeTermination("graceful");
-                const graceMs = Math.min(runtime.config.gracefulCloseMs, remaining());
-                await this.waitForExit(runtime, graceMs);
-                if (!runtime.processExited && this.process.isAlive(runtime.transport.pid)) {
-                    await runtime.transport.requestTreeTermination("forceful");
-                    await this.waitForExit(runtime, remaining());
-                }
-            }
-            else if (identity === "unknown") {
-                // Ownership is unproven, so signalling could hit a recycled pid.
-                cleanupVerified = false;
-            }
-            // `mismatch` and `gone` mean this pid is no longer ours: nothing to signal.
-        }
-        await this.waitForOutputDrain(runtime, remaining());
-        // Final captured output must reach the store before resources close.
-        runtime.output.finish();
-        runtime.syncCursors();
-        try {
-            await runtime.artifact.close();
-        }
-        catch {
-            error ??= sessionError({
-                code: "PERSIST_FAILED",
-                operation: "close",
-                sessionId: record.id,
-                message: "Session output artifact could not be flushed during cleanup.",
-                details: { artifactPath: runtime.artifact.path },
-            });
-        }
-        const survivors = await this.verifyAbsence(runtime, remaining());
-        if (survivors) {
-            cleanupVerified = false;
-            error ??= sessionError({
-                code: "CLEANUP_FAILED",
-                operation: "close",
-                sessionId: record.id,
-                message: "A descendant of this interactive session was still alive after the close deadline.",
-                details: { survivingDescendants: 1, elapsedMs: Date.now() - started },
-            });
-        }
-        runtime.timers.clearAll();
-        runtime.releaseListeners();
-        await runtime.transport.dispose();
-        runtime.output.dispose();
-        runtime.disposed = true;
-        this.deps.journal.remove(record.id);
-        record.artifact = runtime.artifact.receipt();
-        const state = terminalStateFor(reason, runtime.processExited, error !== undefined);
-        this.deps.registry.transition(record, state, {
-            terminationReason: reason,
-            ...(record.processOutcome ? { processOutcome: record.processOutcome } : {}),
-            cleanupVerified,
-            now: Date.now(),
-        });
-        this.deps.onFinalized?.(runtime);
-        return {
-            operation: "close",
-            sessionId: record.id,
-            state: record.state,
-            ...(record.terminationReason ? { terminationReason: record.terminationReason } : {}),
-            ...(record.processOutcome ? { processOutcome: record.processOutcome } : {}),
-            cleanupVerified,
-            artifact: artifactReference(record.artifact),
-            ...(error ? { error } : {}),
-        };
-    }
-    async waitForOutputDrain(runtime, budgetMs) {
-        const wait = runtime.transport.waitForOutputDrain;
-        if (!wait || budgetMs <= 0)
-            return;
-        await Promise.race([wait.call(runtime.transport), delay(budgetMs)]).catch(() => undefined);
-    }
-    async waitForExit(runtime, budgetMs) {
-        const deadline = Date.now() + Math.max(0, budgetMs);
-        while (Date.now() < deadline) {
-            if (runtime.processExited || !this.process.isAlive(runtime.transport.pid))
-                return;
-            await delay(POLL_INTERVAL_MS);
-        }
-    }
-    /** True when a verified descendant or the root is still alive. */
-    async verifyAbsence(runtime, budgetMs) {
-        const pid = runtime.transport.pid;
-        if (pid <= 0)
-            return false;
-        if (this.process.isAlive(pid)) {
-            const identity = this.process.compareIdentity(pid, runtime.transport.identity);
-            // A mismatch means the pid was recycled: our process is gone.
-            if (identity === "match")
-                return true;
-        }
-        if (budgetMs <= 0)
-            return false;
-        return await this.process.hasLiveDescendants(pid);
-    }
-}
-//# sourceMappingURL=cleanup.js.map

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

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

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

@@ -1,118 +0,0 @@
-/**
- * Interactive-session configuration: documented defaults, validated ranges, and
- * a runtime kill switch. Every value is validated before a slot is reserved or a
- * process is launched so an out-of-range setting can never produce a live child.
- */
-import { type SessionOperation, type TerminalDimensions } from "./types.js";
-export interface InteractiveSessionConfig {
-    enabled: boolean;
-    liveSessionLimit: number;
-    quietIntervalMs: number;
-    startDeadlineMs: number;
-    sendDeadlineMs: number;
-    closeDeadlineMs: number;
-    gracefulCloseMs: number;
-    pageBytes: number;
-    memoryWindowBytes: number;
-    queuedInputBytes: number;
-    artifactCaptureBytes: number;
-    artifactChunkBytes: number;
-    persistenceQueueBytes: number;
-    /** Undefined disables the timeout. */
-    idleTimeoutMs: number | undefined;
-    lifetimeTimeoutMs: number | undefined;
-    /** Behavior when artifact capture reaches its limit. */
-    onOutputLimit: "terminate" | "continue";
-    /** Max bytes retained for cross-chunk secret matching. */
-    redactionOverlapBytes: number;
-}
-interface Range {
-    readonly min: number;
-    readonly max: number;
-}
-export declare const INTERACTIVE_SESSION_RANGES: {
-    readonly liveSessionLimit: {
-        readonly min: 1;
-        readonly max: 32;
-    };
-    readonly quietIntervalMs: {
-        readonly min: 25;
-        readonly max: 5000;
-    };
-    readonly startDeadlineMs: {
-        readonly min: 100;
-        readonly max: 120000;
-    };
-    readonly sendDeadlineMs: {
-        readonly min: 100;
-        readonly max: 120000;
-    };
-    readonly closeDeadlineMs: {
-        readonly min: 100;
-        readonly max: 120000;
-    };
-    readonly gracefulCloseMs: {
-        readonly min: 0;
-        readonly max: 30000;
-    };
-    readonly pageBytes: {
-        readonly min: 1024;
-        readonly max: 1048576;
-    };
-    readonly memoryWindowBytes: {
-        readonly min: 65536;
-        readonly max: 16777216;
-    };
-    readonly queuedInputBytes: {
-        readonly min: 1024;
-        readonly max: 1048576;
-    };
-    readonly artifactCaptureBytes: {
-        readonly min: 1048576;
-        readonly max: 1073741824;
-    };
-    readonly artifactChunkBytes: {
-        readonly min: 65536;
-        readonly max: 16777216;
-    };
-    readonly persistenceQueueBytes: {
-        readonly min: 65536;
-        readonly max: 16777216;
-    };
-    readonly idleTimeoutMs: {
-        readonly min: 1000;
-        readonly max: 86400000;
-    };
-    readonly lifetimeTimeoutMs: {
-        readonly min: 1000;
-        readonly max: 604800000;
-    };
-    readonly redactionOverlapBytes: {
-        readonly min: 256;
-        readonly max: 65536;
-    };
-};
-export type RangedConfigField = keyof typeof INTERACTIVE_SESSION_RANGES;
-export declare const DIMENSION_RANGE: Range;
-export declare const DEFAULT_DIMENSIONS: TerminalDimensions;
-/** Hard cap for a blocking read wait, independent of send deadlines. */
-export declare const MAX_READ_WAIT_MS = 30000;
-export declare const MAX_LIST_SUMMARIES = 50;
-export declare const INTERACTIVE_SESSION_DEFAULTS: InteractiveSessionConfig;
-/** Env kill switch. Disables only the seven interactive tools. */
-export declare const KILL_SWITCH_ENV = "CLAI_DISABLE_INTERACTIVE_SESSIONS";
-export type InteractiveSessionOverrides = Partial<InteractiveSessionConfig>;
-/**
- * Resolve the effective configuration. Throws `INVALID_CONFIGURATION` for any
- * out-of-range value so callers fail before allocating resources.
- */
-export declare function resolveInteractiveSessionConfig(overrides?: InteractiveSessionOverrides, operation?: SessionOperation): InteractiveSessionConfig;
-export declare function isInteractiveSessionsEnabled(config?: InteractiveSessionConfig): boolean;
-/** Per-operation timeout override, validated against the same bounds. */
-export declare function resolveDeadline(field: "startDeadlineMs" | "sendDeadlineMs" | "closeDeadlineMs", override: number | undefined, config: InteractiveSessionConfig, operation: SessionOperation): number;
-export declare function resolveQuietInterval(override: number | undefined, config: InteractiveSessionConfig, operation: SessionOperation): number;
-export declare function resolveOptionalTimeout(field: "idleTimeoutMs" | "lifetimeTimeoutMs", override: number | undefined, config: InteractiveSessionConfig, operation: SessionOperation): number | undefined;
-/** Validate requested dimensions before any lookup or process mutation. */
-export declare function resolveDimensions(columns: number | undefined, rows: number | undefined, operation: SessionOperation): TerminalDimensions;
-export declare function clampReadWait(waitMs: number | undefined): number;
-export {};

package/dist/interactive-session/config.js

@@ -1,141 +0,0 @@
-/**
- * Interactive-session configuration: documented defaults, validated ranges, and
- * a runtime kill switch. Every value is validated before a slot is reserved or a
- * process is launched so an out-of-range setting can never produce a live child.
- */
-import { throwSessionError, } from "./types.js";
-export const INTERACTIVE_SESSION_RANGES = {
-    liveSessionLimit: { min: 1, max: 32 },
-    quietIntervalMs: { min: 25, max: 5_000 },
-    startDeadlineMs: { min: 100, max: 120_000 },
-    sendDeadlineMs: { min: 100, max: 120_000 },
-    closeDeadlineMs: { min: 100, max: 120_000 },
-    gracefulCloseMs: { min: 0, max: 30_000 },
-    pageBytes: { min: 1_024, max: 1_048_576 },
-    memoryWindowBytes: { min: 65_536, max: 16_777_216 },
-    queuedInputBytes: { min: 1_024, max: 1_048_576 },
-    artifactCaptureBytes: { min: 1_048_576, max: 1_073_741_824 },
-    artifactChunkBytes: { min: 65_536, max: 16_777_216 },
-    persistenceQueueBytes: { min: 65_536, max: 16_777_216 },
-    idleTimeoutMs: { min: 1_000, max: 86_400_000 },
-    lifetimeTimeoutMs: { min: 1_000, max: 604_800_000 },
-    redactionOverlapBytes: { min: 256, max: 65_536 },
-};
-export const DIMENSION_RANGE = { min: 2, max: 1_000 };
-export const DEFAULT_DIMENSIONS = { columns: 80, rows: 24 };
-/** Hard cap for a blocking read wait, independent of send deadlines. */
-export const MAX_READ_WAIT_MS = 30_000;
-export const MAX_LIST_SUMMARIES = 50;
-export const INTERACTIVE_SESSION_DEFAULTS = {
-    enabled: true,
-    liveSessionLimit: 4,
-    quietIntervalMs: 250,
-    startDeadlineMs: 10_000,
-    sendDeadlineMs: 30_000,
-    closeDeadlineMs: 10_000,
-    gracefulCloseMs: 2_000,
-    pageBytes: 12_000,
-    memoryWindowBytes: 1_048_576,
-    queuedInputBytes: 65_536,
-    artifactCaptureBytes: 67_108_864,
-    artifactChunkBytes: 1_048_576,
-    persistenceQueueBytes: 1_048_576,
-    idleTimeoutMs: undefined,
-    lifetimeTimeoutMs: undefined,
-    onOutputLimit: "terminate",
-    redactionOverlapBytes: 4_096,
-};
-/** Env kill switch. Disables only the seven interactive tools. */
-export const KILL_SWITCH_ENV = "CLAI_DISABLE_INTERACTIVE_SESSIONS";
-function envDisabled() {
-    const raw = process.env[KILL_SWITCH_ENV];
-    if (raw === undefined)
-        return false;
-    const normalized = raw.trim().toLowerCase();
-    return normalized === "1" || normalized === "true" || normalized === "yes";
-}
-function invalid(field, message, operation) {
-    throwSessionError({
-        code: "INVALID_CONFIGURATION",
-        operation,
-        message,
-        details: { field },
-    });
-}
-function checkRange(field, value, operation) {
-    const { min, max } = INTERACTIVE_SESSION_RANGES[field];
-    if (!Number.isInteger(value) || value < min || value > max) {
-        invalid(field, `${field} must be an integer between ${min} and ${max}.`, operation);
-    }
-    return value;
-}
-/**
- * Resolve the effective configuration. Throws `INVALID_CONFIGURATION` for any
- * out-of-range value so callers fail before allocating resources.
- */
-export function resolveInteractiveSessionConfig(overrides = {}, operation = "start") {
-    const merged = { ...INTERACTIVE_SESSION_DEFAULTS, ...overrides };
-    for (const field of Object.keys(INTERACTIVE_SESSION_RANGES)) {
-        const value = merged[field];
-        if (value === undefined)
-            continue;
-        if (typeof value !== "number") {
-            invalid(field, `${field} must be a number.`, operation);
-        }
-        checkRange(field, value, operation);
-    }
-    if (merged.artifactChunkBytes > merged.artifactCaptureBytes) {
-        invalid("artifactChunkBytes", "artifactChunkBytes cannot exceed artifactCaptureBytes.", operation);
-    }
-    if (merged.onOutputLimit !== "terminate" && merged.onOutputLimit !== "continue") {
-        invalid("onOutputLimit", "onOutputLimit must be terminate or continue.", operation);
-    }
-    return { ...merged, enabled: merged.enabled && !envDisabled() };
-}
-export function isInteractiveSessionsEnabled(config = resolveInteractiveSessionConfig()) {
-    return config.enabled;
-}
-/** Per-operation timeout override, validated against the same bounds. */
-export function resolveDeadline(field, override, config, operation) {
-    if (override === undefined)
-        return config[field];
-    return checkRange(field, override, operation);
-}
-export function resolveQuietInterval(override, config, operation) {
-    if (override === undefined)
-        return config.quietIntervalMs;
-    return checkRange("quietIntervalMs", override, operation);
-}
-export function resolveOptionalTimeout(field, override, config, operation) {
-    if (override === undefined)
-        return config[field];
-    return checkRange(field, override, operation);
-}
-/** Validate requested dimensions before any lookup or process mutation. */
-export function resolveDimensions(columns, rows, operation) {
-    const resolved = {
-        columns: columns ?? DEFAULT_DIMENSIONS.columns,
-        rows: rows ?? DEFAULT_DIMENSIONS.rows,
-    };
-    for (const [field, value] of Object.entries(resolved)) {
-        if (!Number.isInteger(value) ||
-            value < DIMENSION_RANGE.min ||
-            value > DIMENSION_RANGE.max) {
-            throwSessionError({
-                code: "INVALID_REQUEST",
-                operation,
-                message: `${field} must be an integer between ${DIMENSION_RANGE.min} and ${DIMENSION_RANGE.max}.`,
-                details: { field },
-            });
-        }
-    }
-    return resolved;
-}
-export function clampReadWait(waitMs) {
-    if (waitMs === undefined)
-        return 0;
-    if (!Number.isFinite(waitMs) || waitMs < 0)
-        return 0;
-    return Math.min(Math.floor(waitMs), MAX_READ_WAIT_MS);
-}
-//# sourceMappingURL=config.js.map

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

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