@nomix-ai/nomix-harness 0.2.6 → 0.2.9

package/dist/kernel/terminal-bash/lib/types/config.d.ts

@@ -1,71 +0,0 @@
-/** Validated configuration for the local PTY backend. */
-import z from '../../../schemastery/lib/index.mjs';
-/** One supported interactive shell dialect. */
-export type ShellDialect = 'bash' | 'pwsh';
-/** Public plugin configuration. */
-export interface Config {
-    /** Backend registry type (default: `shell`). */
-    backendType?: string;
-    /** Interactive shell dialect (default: `bash`); selects the argv/env/startup defaults. */
-    shellDialect?: ShellDialect;
-    /** Interactive shell executable (default per dialect: `/bin/bash`, or the resolved pwsh). */
-    shellPath?: string;
-    /** Shell arguments (default per dialect: bash `--noprofile --norc -i`, pwsh `-NoLogo -NoProfile`). */
-    shellArgs?: string[];
-    /** Terminal rows. */
-    rows?: number;
-    /** Terminal columns. */
-    cols?: number;
-    /** Maximum retained logical lines. */
-    scrollbackLines?: number;
-    /** Maximum retained UTF-8 bytes. */
-    scrollbackMaxBytes?: number;
-    /** Maximum bytes returned by one read or settled viewport. */
-    maxReadBytes?: number;
-    /** Readiness polling interval. */
-    pollIntervalMs?: number;
-    /** Delay before Linux exact syscall probes. */
-    exactProbeAfterMs?: number;
-    /** Silence duration that yields `inferred_idle`. */
-    idleSilenceMs?: number;
-    /**
-     * Extra wait beyond `idleSilenceMs`, once a prompt marker was seen, for the shell to
-     * regain the foreground before `inferred_idle` settles; at least one `pollIntervalMs`.
-     */
-    handoffGraceMs?: number;
-    /** Absolute send wait bound. */
-    timeoutMs?: number;
-    /** Grace before teardown escalates to `SIGKILL`. */
-    disposeGraceMs?: number;
-}
-/** Configuration after Schemastery defaults and dialect resolution. */
-export type ResolvedConfig = Omit<Required<Config>, 'shellDialect' | 'shellPath' | 'shellArgs'> & {
-    shellDialect: ShellDialect;
-    shellPath: string;
-    shellArgs: string[];
-};
-/** Bash dialect default executable. */
-export declare const DEFAULT_BASH_SHELL = "/bin/bash";
-/** Bash dialect default arguments (interactive, profile-free). */
-export declare const DEFAULT_BASH_ARGS: string[];
-/** Pwsh dialect default arguments (interactive host, profile-free). */
-export declare const DEFAULT_PWSH_ARGS: string[];
-/**
- * Resolve the effective per-dialect shell specification. Defaulting is this
- * explicit step: an unset or empty `shellPath`/`shellArgs` selects the
- * dialect's defaults, while a non-empty explicit value always wins.
- * (Schemastery materializes an absent optional array as `[]`, so emptiness —
- * not just `undefined` — means "dialect default".)
- * @param config - Schemastery-resolved plugin configuration.
- * @returns the fully resolved configuration.
- */
-export declare function resolveConfig(config: Config): ResolvedConfig;
-/** Schemastery config exposed by the plugin. */
-export declare const Config: z<Config>;
-/**
- * Assert every effective numeric config field is a positive safe integer and bounds compose.
- * @param config - Schemastery-resolved plugin configuration.
- * @returns Narrows the input to the fully resolved configuration.
- */
-export declare function validateConfig(config: Config): asserts config is ResolvedConfig;
-//# sourceMappingURL=config.d.ts.map

package/dist/kernel/terminal-bash/lib/types/config.js

@@ -1,73 +0,0 @@
-/** Validated configuration for the local PTY backend. */
-import z from '../../../schemastery/lib/index.mjs';
-import { resolvePwshPath } from '../../../pwsh-local/lib/index.js';
-/** Bash dialect default executable. */
-export const DEFAULT_BASH_SHELL = '/bin/bash';
-/** Bash dialect default arguments (interactive, profile-free). */
-export const DEFAULT_BASH_ARGS = ['--noprofile', '--norc', '-i'];
-/** Pwsh dialect default arguments (interactive host, profile-free). */
-export const DEFAULT_PWSH_ARGS = ['-NoLogo', '-NoProfile'];
-/**
- * Resolve the effective per-dialect shell specification. Defaulting is this
- * explicit step: an unset or empty `shellPath`/`shellArgs` selects the
- * dialect's defaults, while a non-empty explicit value always wins.
- * (Schemastery materializes an absent optional array as `[]`, so emptiness —
- * not just `undefined` — means "dialect default".)
- * @param config - Schemastery-resolved plugin configuration.
- * @returns the fully resolved configuration.
- */
-export function resolveConfig(config) {
-    const shellDialect = config.shellDialect ?? 'bash';
-    return {
-        ...config,
-        shellDialect,
-        shellPath: config.shellPath !== undefined && config.shellPath.length > 0
-            ? config.shellPath
-            : (shellDialect === 'pwsh' ? resolvePwshPath() : DEFAULT_BASH_SHELL),
-        shellArgs: config.shellArgs !== undefined && config.shellArgs.length > 0
-            ? config.shellArgs
-            : (shellDialect === 'pwsh' ? DEFAULT_PWSH_ARGS : DEFAULT_BASH_ARGS),
-    };
-}
-/** Schemastery config exposed by the plugin. */
-export const Config = z.object({
-    backendType: z.string().default('shell'),
-    shellDialect: z.union(['bash', 'pwsh']).default('bash'),
-    shellPath: z.string().required(false),
-    shellArgs: z.array(z.string()).required(false),
-    rows: z.number().default(40),
-    cols: z.number().default(160),
-    scrollbackLines: z.number().default(10_000),
-    scrollbackMaxBytes: z.number().default(4 * 1024 * 1024),
-    maxReadBytes: z.number().default(256 * 1024),
-    pollIntervalMs: z.number().default(50),
-    exactProbeAfterMs: z.number().default(150),
-    idleSilenceMs: z.number().default(3_000),
-    handoffGraceMs: z.number().default(500),
-    timeoutMs: z.number().default(30_000),
-    disposeGraceMs: z.number().default(3_000),
-});
-/**
- * Assert every effective numeric config field is a positive safe integer and bounds compose.
- * @param config - Schemastery-resolved plugin configuration.
- * @returns Narrows the input to the fully resolved configuration.
- */
-export function validateConfig(config) {
-    const resolved = config;
-    if (resolved.backendType.length === 0)
-        throw new Error('terminal-bash: backendType must be non-empty');
-    if (resolved.shellPath.length === 0)
-        throw new Error('terminal-bash: shellPath must be non-empty');
-    for (const [name, value] of Object.entries(resolved)) {
-        if (typeof value === 'number' && (!Number.isSafeInteger(value) || value <= 0)) {
-            throw new Error(`terminal-bash: ${name} must be a positive safe integer`);
-        }
-    }
-    if (resolved.maxReadBytes > resolved.scrollbackMaxBytes) {
-        throw new Error('terminal-bash: maxReadBytes must not exceed scrollbackMaxBytes');
-    }
-    if (resolved.handoffGraceMs < resolved.pollIntervalMs) {
-        throw new Error('terminal-bash: handoffGraceMs must be at least pollIntervalMs so one readiness poll runs inside the grace window');
-    }
-}
-//# sourceMappingURL=config.js.map

package/dist/kernel/terminal-bash/lib/types/index.d.ts

@@ -1,36 +0,0 @@
-/**
- * Persistent shell PTY backend over the subprocess terminal primitive, shared
- * sandbox policy, bounded output, and provider-owned session cleanup.
- * @module @nomix-ai/nomix-terminal-bash
- */
-import { Context } from '../../../cordis/lib/index.js';
-import type { TerminalBackend, TerminalBackendSpawnSpec } from '../../../terminal/lib/index.js';
-import type { SubprocessTerminalHandle, SubprocessTerminalSpawnSpec } from '../../../subprocess/lib/index.js';
-import { type Config, type ResolvedConfig } from './config.ts';
-import { LocalPtySession } from './session.ts';
-export { Config } from './config.ts';
-export type { Config as TerminalLocalConfig } from './config.ts';
-/** Cordis plugin name. */
-export declare const name = "terminal-bash";
-/** Required services: PTY registry, shared confinement policy, and process substrate. */
-export declare const inject: string[];
-/**
- * The pwsh prompt function that emits the shared OSC `133;D;` + BEL marker
- * before every prompt, mirroring bash's PROMPT_COMMAND. `[char]27`/`[char]7`
- * build the control bytes at runtime because raw ESC characters in submitted
- * input are unreliable under PSReadLine.
- */
-export declare const PWSH_PROMPT_SETUP: string;
-/** Local shell backend registered under the configured type. */
-export declare class BashTerminalBackend implements TerminalBackend {
-    private readonly ctx;
-    private readonly config;
-    private readonly spawnTerminal;
-    private readonly createSession;
-    readonly type: string;
-    constructor(ctx: Context, config: ResolvedConfig, spawnTerminal?: (spec: SubprocessTerminalSpawnSpec) => Promise<SubprocessTerminalHandle>, createSession?: (terminal: SubprocessTerminalHandle, config: ResolvedConfig) => LocalPtySession);
-    spawn(spec: TerminalBackendSpawnSpec): Promise<LocalPtySession>;
-}
-/** Register the local PTY backend. */
-export declare function apply(ctx: Context, config: Config): void;
-//# sourceMappingURL=index.d.ts.map

package/dist/kernel/terminal-bash/lib/types/index.js

@@ -1,189 +0,0 @@
-/**
- * Persistent shell PTY backend over the subprocess terminal primitive, shared
- * sandbox policy, bounded output, and provider-owned session cleanup.
- * @module @nomix-ai/nomix-terminal-bash
- */
-import { TerminalBackendCleanupError } from '../../../terminal/lib/index.js';
-import { effectiveSandboxMode } from '../../../sandbox-policy/lib/index.js';
-import { ENCODING_PREAMBLE } from '../../../pwsh-local/lib/index.js';
-import { resolveConfig, validateConfig } from "./config.js";
-import { LocalPtySession } from "./session.js";
-import { CONTROLLED_PROMPT } from "./sanitize.js";
-export { Config } from "./config.js";
-/** Cordis plugin name. */
-export const name = 'terminal-bash';
-/** Required services: PTY registry, shared confinement policy, and process substrate. */
-export const inject = ['terminals', 'sandboxPolicy', 'subprocess'];
-const sandboxModeFences = new WeakMap();
-function ensureSandboxModeFence(ctx, owner) {
-    const existing = sandboxModeFences.get(owner);
-    if (existing !== undefined) {
-        existing.pty = ctx.terminals;
-        existing.sandboxPolicy = ctx.sandboxPolicy;
-        return;
-    }
-    const state = { pty: ctx.terminals, sandboxPolicy: ctx.sandboxPolicy };
-    sandboxModeFences.set(owner, state);
-    owner.ctx.on('internal/dispatch', (_mode, eventName, args) => {
-        if (eventName !== 'session/event')
-            return;
-        const [session, event] = args;
-        if (session !== owner.session || event.type !== 'sandbox/mode')
-            return;
-        const currentMode = effectiveSandboxMode(session.events) ?? state.sandboxPolicy.defaultMode;
-        if (event.data.mode === currentMode || !state.pty.hasOwnerActivity(owner))
-            return;
-        throw new Error(`cannot change sandbox mode from "${currentMode}" to "${event.data.mode}" while persistent terminal sessions are open or being created; wait for creation to settle and close them first`);
-    }, { global: true });
-}
-function childEnvironment(spec, dialect) {
-    // The subprocess provider supplies its own scrubbed ambient base; these are
-    // deliberate terminal-specific overrides layered after it.
-    const common = {
-        TERM: 'dumb',
-        PAGER: 'cat',
-        GIT_PAGER: 'cat',
-        NOMIX_SHELL: '1',
-        NOMIX_SESSION_ID: spec.owner.id,
-        NOMIX_PTY_SESSION_ID: spec.sessionId,
-    };
-    if (dialect === 'pwsh') {
-        // pwsh ignores PS1/PROMPT_COMMAND; its prompt is installed by the startup
-        // bootstrap instead, and NO_COLOR keeps the renderer quiet.
-        return { ...common, NO_COLOR: '1' };
-    }
-    return {
-        ...common,
-        PS1: CONTROLLED_PROMPT,
-        // Re-asserting PS1 after the marker keeps prompt readiness working when a
-        // command overwrote the shell variable: bash runs PROMPT_COMMAND before
-        // rendering each prompt, so an override never survives to the next prompt.
-        PROMPT_COMMAND: `printf "\\033]133;D;%s\\007" "$?"; PS1='${CONTROLLED_PROMPT}'`,
-        BASH_SILENCE_DEPRECATION_WARNING: '1',
-    };
-}
-/**
- * The pwsh prompt function that emits the shared OSC `133;D;` + BEL marker
- * before every prompt, mirroring bash's PROMPT_COMMAND. `[char]27`/`[char]7`
- * build the control bytes at runtime because raw ESC characters in submitted
- * input are unreliable under PSReadLine.
- */
-export const PWSH_PROMPT_SETUP = "function prompt { [Console]::Write([char]27 + ']133;D;' + [int]$LASTEXITCODE + [char]7); '" + CONTROLLED_PROMPT + "' }";
-function spawnArgv(ctx, config, policy) {
-    const argv = [config.shellPath, ...config.shellArgs];
-    if (policy.mode === 'danger-full-access')
-        return argv;
-    const sandbox = ctx.get('sandbox');
-    if (sandbox === undefined) {
-        throw new Error(`terminal-bash: sandbox mode "${policy.mode}" requires a ctx.sandbox provider in the execution world`);
-    }
-    // Re-state the discriminant because object spread does not preserve its narrowed type.
-    return sandbox.confine(argv, { ...policy, mode: policy.mode }).argv;
-}
-// TODO(pty-initialize-race-home): Fold this outer abort race into
-// LocalPtySession.initialize when the send-state consolidation lands; the
-// session already owns the send lifecycle the race protects.
-async function startupSession(session, dialect, signal) {
-    const start = async () => {
-        if (dialect === 'bash') {
-            await session.initialize(signal);
-            return;
-        }
-        // pwsh cannot install its prompt from the environment: write the prompt
-        // function through the session and wait for the first marker prompt,
-        // which is also the readiness contract of the bash initialize path. The
-        // first send also pins UTF-8 output (the shared pwsh-local preamble)
-        // before anything runs: the session decode path treats PTY bytes as
-        // UTF-8, and an un-pinned console writes its host code page for
-        // non-ASCII output. The banner-to-prompt gap can outlast the silence
-        // bound, so the wait loops over follow-up sends until the controlled
-        // prompt is actually visible (in the viewport or the retained scrollback
-        // when it landed between sends), bounded by the send deadline.
-        let viewport = '';
-        for (;;) {
-            const first = viewport.length === 0;
-            const operation = session.startSend({
-                text: first ? ENCODING_PREAMBLE + PWSH_PROMPT_SETUP : '',
-                submit: first,
-                ...signal !== undefined ? { signal } : {},
-            });
-            const result = await operation.done;
-            if (result.waitReason === 'session_exit')
-                throw new Error('PTY shell exited during startup');
-            if (result.waitReason === 'timeout')
-                throw new Error('PTY shell did not reach readiness before startup timeout');
-            viewport = result.viewport;
-            const scrollback = session.read({ offset: 0, count: 20 }).text;
-            if (viewport.includes(CONTROLLED_PROMPT) || scrollback.includes(CONTROLLED_PROMPT))
-                break;
-        }
-        session.motd = viewport;
-    };
-    if (signal === undefined) {
-        await start();
-        return;
-    }
-    const aborted = Promise.withResolvers();
-    const onAbort = () => { aborted.reject(signal.reason); };
-    signal.addEventListener('abort', onAbort, { once: true });
-    try {
-        signal.throwIfAborted();
-        await Promise.race([start(), aborted.promise]);
-    }
-    finally {
-        signal.removeEventListener('abort', onAbort);
-    }
-}
-/** Local shell backend registered under the configured type. */
-export class BashTerminalBackend {
-    ctx;
-    config;
-    spawnTerminal;
-    createSession;
-    type;
-    constructor(ctx, config, spawnTerminal = spec => ctx.subprocess.spawnTerminal(spec), createSession = (terminal, config) => new LocalPtySession(terminal, config)) {
-        this.ctx = ctx;
-        this.config = config;
-        this.spawnTerminal = spawnTerminal;
-        this.createSession = createSession;
-        this.type = config.backendType;
-    }
-    async spawn(spec) {
-        spec.signal?.throwIfAborted();
-        ensureSandboxModeFence(this.ctx, spec.owner);
-        const policy = this.ctx.sandboxPolicy.resolve({ session: spec.owner.session });
-        const argv = spawnArgv(this.ctx, this.config, policy);
-        if (argv[0] === undefined)
-            throw new Error('terminal-bash: sandbox returned empty argv');
-        const terminal = await this.spawnTerminal({
-            argv,
-            cwd: spec.cwd ?? policy.workspaceRoot,
-            env: childEnvironment(spec, this.config.shellDialect),
-            rows: this.config.rows,
-            cols: this.config.cols,
-            graceMs: this.config.disposeGraceMs,
-            signal: spec.signal,
-        });
-        const session = this.createSession(terminal, this.config);
-        try {
-            await startupSession(session, this.config.shellDialect, spec.signal);
-            return session;
-        }
-        catch (error) {
-            try {
-                await session.close('PTY startup failed');
-            }
-            catch (closeError) {
-                throw new TerminalBackendCleanupError(error, closeError);
-            }
-            throw error;
-        }
-    }
-}
-/** Register the local PTY backend. */
-export function apply(ctx, config) {
-    const resolved = resolveConfig(config);
-    validateConfig(resolved);
-    ctx.terminals.registerBackend(new BashTerminalBackend(ctx, resolved));
-}
-//# sourceMappingURL=index.js.map

package/dist/kernel/terminal-bash/lib/types/invariant.d.ts

@@ -1,16 +0,0 @@
-/**
- * Package-owned invariant companion for `@nomix-ai/nomix-terminal-bash`.
- * @module @nomix-ai/nomix-terminal-bash/invariant
- */
-import type { Context } from '../../../cordis/lib/index.js';
-/** Cordis companion plugin name. */
-export declare const name = "terminal-bash-invariant";
-/** Service required before the companion can reserve package ownership. */
-export declare const inject: string[];
-/**
- * Register this package's invariant companion.
- * @param ctx - Cordis context carrying the invariant service.
- * @returns the installed registration's disposer after setup succeeds.
- */
-export declare const apply: (ctx: Context) => Promise<() => void>;
-//# sourceMappingURL=invariant.d.ts.map

package/dist/kernel/terminal-bash/lib/types/invariant.js

@@ -1,22 +0,0 @@
-/**
- * Package-owned invariant companion for `@nomix-ai/nomix-terminal-bash`.
- * @module @nomix-ai/nomix-terminal-bash/invariant
- */
-const PACKAGE_NAME = '@nomix-ai/nomix-terminal-bash';
-/** Cordis companion plugin name. */
-export const name = 'terminal-bash-invariant';
-/** Service required before the companion can reserve package ownership. */
-export const inject = ['invariants'];
-/**
- * No runtime invariant: readiness, terminal buffers, and process-tree state are private per-session
- * implementation state, and the backend publishes no independent lifecycle stream or snapshot.
- */
-const install = () => { };
-/**
- * Register this package's invariant companion.
- * @param ctx - Cordis context carrying the invariant service.
- * @returns the installed registration's disposer after setup succeeds.
- */
-export const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
-/* jscpd:ignore-end */
-//# sourceMappingURL=invariant.js.map

package/dist/kernel/terminal-bash/lib/types/sanitize.js

@@ -1,181 +0,0 @@
-/** Streaming terminal-control sanitizer for the line-oriented first release. */
-import { Buffer } from 'node:buffer';
-/** OSC marker emitted by the controlled bash before each prompt. */
-export const PROMPT_MARKER_PREFIX = '133;D;';
-/** Exact printable prompt emitted after the private marker. */
-export const CONTROLLED_PROMPT = 'nomix> ';
-/**
- * Remove CSI/OSC/short escape sequences while preserving split-sequence carry.
- * Full terminal emulation is deliberately deferred; ordinary line output and
- * the private prompt marker are the supported contract.
- */
-export class TerminalSanitizer {
-    maxPendingBytes;
-    pending = '';
-    discardMode;
-    discardOscEscape = false;
-    trailingCarriageReturn = false;
-    trackingPromptTail = false;
-    constructor(maxPendingBytes) {
-        this.maxPendingBytes = maxPendingBytes;
-    }
-    /**
-     * Consume one decoded `node-pty` data chunk.
-     * @param chunk - decoded terminal data.
-     * @returns Printable text and whether the private prompt marker completed.
-     */
-    push(chunk) {
-        this.pending += this.discardPrefix(chunk);
-        let text = '';
-        let prompt = false;
-        let includePromptTail = this.trackingPromptTail;
-        let promptTail = '';
-        let index = 0;
-        const appendText = (value) => {
-            text += value;
-            if (this.trackingPromptTail)
-                promptTail += value;
-        };
-        while (index < this.pending.length) {
-            const escape = this.pending.indexOf('\x1b', index);
-            if (escape < 0) {
-                appendText(this.pending.slice(index));
-                index = this.pending.length;
-                break;
-            }
-            appendText(this.pending.slice(index, escape));
-            if (escape + 1 >= this.pending.length) {
-                index = escape;
-                break;
-            }
-            const kind = this.pending[escape + 1];
-            if (kind === ']') {
-                const bel = this.pending.indexOf('\x07', escape + 2);
-                const stringTerminator = this.pending.indexOf('\x1b\\', escape + 2);
-                let end = -1;
-                if (bel >= 0 && stringTerminator >= 0)
-                    end = Math.min(bel + 1, stringTerminator + 2);
-                else if (bel >= 0)
-                    end = bel + 1;
-                else if (stringTerminator >= 0)
-                    end = stringTerminator + 2;
-                if (end < 0) {
-                    index = escape;
-                    break;
-                }
-                const terminatorBytes = this.pending[end - 1] === '\x07' ? 1 : 2;
-                const content = this.pending.slice(escape + 2, end - terminatorBytes);
-                if (content.startsWith(PROMPT_MARKER_PREFIX)) {
-                    prompt = true;
-                    this.trackingPromptTail = true;
-                    includePromptTail = true;
-                    promptTail = '';
-                }
-                index = end;
-                continue;
-            }
-            if (kind === '[') {
-                let end = escape + 2;
-                while (end < this.pending.length) {
-                    const code = this.pending.charCodeAt(end);
-                    if (code >= 0x40 && code <= 0x7e)
-                        break;
-                    end += 1;
-                }
-                if (end >= this.pending.length) {
-                    index = escape;
-                    break;
-                }
-                index = end + 1;
-                continue;
-            }
-            // Two-byte escape family (save/restore cursor and similar).
-            index = escape + 2;
-        }
-        this.pending = this.pending.slice(index);
-        this.enforcePendingBound();
-        return {
-            text: this.normalizeText(text),
-            prompt,
-            ...includePromptTail ? { promptTail } : {},
-        };
-    }
-    /**
-     * Flush a trailing printable fragment when the PTY exits.
-     * @returns Remaining printable text; incomplete escapes are discarded.
-     */
-    flush() {
-        const text = this.pending.startsWith('\x1b') ? '' : this.pending;
-        this.pending = '';
-        this.discardMode = undefined;
-        this.discardOscEscape = false;
-        this.trackingPromptTail = false;
-        const normalized = this.normalizeText(text);
-        if (!this.trailingCarriageReturn)
-            return normalized;
-        this.trailingCarriageReturn = false;
-        return `${normalized}\n`;
-    }
-    normalizeText(text) {
-        let complete = this.trailingCarriageReturn ? `\r${text}` : text;
-        this.trailingCarriageReturn = false;
-        if (complete.endsWith('\r')) {
-            complete = complete.slice(0, -1);
-            this.trailingCarriageReturn = true;
-        }
-        return normalizeTerminalText(complete);
-    }
-    enforcePendingBound() {
-        if (Buffer.byteLength(this.pending) <= this.maxPendingBytes)
-            return;
-        this.discardMode = this.pending[1] === ']' ? 'osc' : 'csi';
-        this.pending = '';
-    }
-    discardPrefix(chunk) {
-        if (this.discardMode === undefined)
-            return chunk;
-        if (this.discardMode === 'csi') {
-            for (let index = 0; index < chunk.length; index += 1) {
-                const code = chunk.charCodeAt(index);
-                if (code >= 0x40 && code <= 0x7e) {
-                    this.discardMode = undefined;
-                    return chunk.slice(index + 1);
-                }
-            }
-            return '';
-        }
-        let index = 0;
-        if (this.discardOscEscape) {
-            this.discardOscEscape = false;
-            if (chunk.startsWith('\\')) {
-                this.discardMode = undefined;
-                return chunk.slice(1);
-            }
-        }
-        while (index < chunk.length) {
-            if (chunk[index] === '\x07') {
-                this.discardMode = undefined;
-                return chunk.slice(index + 1);
-            }
-            if (chunk[index] === '\x1b') {
-                if (chunk[index + 1] === '\\') {
-                    this.discardMode = undefined;
-                    return chunk.slice(index + 2);
-                }
-                if (index + 1 === chunk.length)
-                    this.discardOscEscape = true;
-            }
-            index += 1;
-        }
-        return '';
-    }
-}
-/**
- * Normalize CRLF and standalone carriage returns for line-oriented rendering.
- * @param text - sanitized terminal text.
- * @returns Line-normalized text with BEL removed.
- */
-export function normalizeTerminalText(text) {
-    return text.replaceAll('\r\n', '\n').replaceAll('\r', '\n').replaceAll('\x07', '');
-}
-//# sourceMappingURL=sanitize.js.map

package/dist/kernel/terminal-bash/lib/types/session.d.ts

@@ -1,66 +0,0 @@
-/** Persistent PTY session over the subprocess seam's terminal primitive. */
-import type { SubprocessTerminalHandle } from '../../../subprocess/lib/index.js';
-import type { TerminalBackendSession, TerminalReadRequest, TerminalReadResult, TerminalSendOperation, TerminalSendRequest, TerminalSessionStatus, TerminalSignal, TerminalSignalResult } from '../../../terminal/lib/index.js';
-import type { ResolvedConfig } from './config.ts';
-/** Backend session wrapping one provider-owned terminal process. */
-export declare class LocalPtySession implements TerminalBackendSession {
-    private readonly terminal;
-    private readonly config;
-    motd: string;
-    readonly pid: number;
-    private readonly decoder;
-    private readonly sanitizer;
-    private readonly scrollback;
-    private readonly outputEnded;
-    private readonly completion;
-    private statusValue;
-    private active;
-    private activeTimer;
-    private activeDeadlineTimer;
-    private activeAbort;
-    private interrupting;
-    private activeWrite;
-    private pollingReady;
-    private polling;
-    private promptSeen;
-    private promptTextSeen;
-    private promptTail;
-    private shellPgid;
-    private initializing;
-    private lastOutputAt;
-    private closing;
-    private closePromise;
-    private transportFailure;
-    constructor(terminal: SubprocessTerminalHandle, config: ResolvedConfig);
-    /**
-     * Capture startup output through the same readiness contract as later sends.
-     * @param signal - optional cancellation while the shell reaches its first prompt.
-     * @returns Resolves after startup readiness; rejects on exit or readiness timeout.
-     */
-    initialize(signal?: AbortSignal): Promise<void>;
-    startSend(request: TerminalSendRequest): TerminalSendOperation;
-    private beginSend;
-    private resetReadinessEvidence;
-    read(request: TerminalReadRequest): TerminalReadResult;
-    signal(signal: TerminalSignal): Promise<TerminalSignalResult>;
-    status(): TerminalSessionStatus;
-    close(reason: string): Promise<void>;
-    private readonly onTerminalData;
-    private readonly onTerminalEnd;
-    private readonly onTerminalError;
-    private onData;
-    private onExit;
-    private onTransportFailure;
-    private appendOutput;
-    private schedulePoll;
-    private pollReadiness;
-    private settleActive;
-    private stopPolling;
-    private stopReadinessPolling;
-    private clearActive;
-    private failActive;
-    private interrupt;
-    private interruptOnce;
-    private closeOnce;
-}
-//# sourceMappingURL=session.d.ts.map