@felan-ai/ext-background-bash 0.5.0 → 0.6.0

package/README.md

@@ -1,7 +1,8 @@
 # @felan-ai/ext-background-bash
 
-Detached project-local Bash execution for Felan sessions. The extension augments
-`bash` with `background: true` and adds tools to list, wait for, and stop processes.
+Provider-neutral project-local Bash execution for Felan sessions. The extension augments
+`bash` with explicit backgrounding, bounded foreground waiting, optional PTY input,
+and adds tools to list, read, wait for, write to, and stop processes.
 Output and process metadata live under
 `<session-storage>/background-bash/<workspace-key>/jobs`. Local Felan maps
 `<session-storage>` to
@@ -24,29 +25,39 @@ the host runtime. Git Bash's process tools use its `ps -l` format when GNU
 through dependency onboarding; Felan does not install operating-system
 utilities.
 
-The extension activates for selected models outside the OpenAI provider family.
-OpenAI and OpenAI Codex sessions use the separate Codex-specific process
-surface instead. Keeping eligibility here gives cloud and local consumers
-identical behavior without duplicating model filters in their composition
-roots.
+The same process surface is available to every selected model. Model-specific
+policy belongs to the model-facing prompt/tool composition, not to process
+ownership or runtime capability checks.
 
-This release requires `@felan-ai/agent-core` `^0.6.0` because it uses the
+This release requires `@felan-ai/agent-core` `^0.6.1` because it uses the
 runtime's explicit POSIX shell flavor.
 
 ## Tools and controls
 
 - `bash({ command, background: true })` starts a detached process.
+- `bash({ command, timeout: 120 })` waits in the tool, then promotes the same process without restarting it.
+- `bash({ command, timeout: 0, tty: true })` starts an interactive PTY immediately.
+- `write_background_bash({ id, chars })` sends exact stdin/control bytes to a PTY job.
 - `list_background_bash` lists workspace processes and statuses.
-- `read_background_bash` reads trailing process output.
+- `read_background_bash` reads trailing process output, capped at 128 KiB of log content. Larger files use POSIX `tail` without loading the whole log.
 - `wait_background_bash` waits for terminal status without returning log output.
 - `stop_background_bash` sends `SIGTERM` or `SIGKILL`.
-- `/background-bash` and `Ctrl+Shift+J` open the interactive process/log view inline in the TUI.
+- `/processes` and `Ctrl+Shift+J` open the interactive process/log view inline in the TUI.
 
 The process/log view uses an inline frame. Automatic completion messages use a
 compact one-line summary; `Alt+A` reveals bounded details.
 
-The footer status shows the number of running processes. Foreground `bash` continues
-to use the active `AgentRuntime`. Processes started by the active session deliver a
+The default foreground promotion window is 120 seconds and can be changed with
+`extensionConfig.backgroundBash.foregroundTimeoutSeconds`. Cancelling a foreground
+wait terminates its process tree; cancelling a wait for an already-backgrounded job
+does not terminate that job. Detached jobs remain discoverable after restart when
+their runtime storage persists. PTY handles are root-session-scoped and are not
+reattachable after shutdown. The footer status shows the number of running processes.
+Live PTY status comes from its root-session handle, not detached-runner PID probes.
+Status reads and input remain available while another caller waits in the foreground.
+Terminal outcomes and completion timestamps are recorded once. An orphaned PTY is
+reported as `unknown`; its stored PID is not used to reattach or signal a process.
+Processes started by the active session deliver a
 completion message automatically. The message steers an active run at its next
 model-call boundary or triggers a turn when the agent is idle. A terminal result
 returned directly by `list_background_bash`, `read_background_bash`,
@@ -85,8 +96,8 @@ the POSIX shell/process facilities listed in
 does not install operating-system utilities, and the feature remains inactive
 when they are unavailable.
 
-The extension owns detached job records, logs, lifecycle, model eligibility,
-and the five model-facing process controls. It does not provide a sandbox.
+The extension owns detached job records, logs, lifecycle, PTY controls, and the
+six model-facing process controls. It does not provide a sandbox.
 
 ## Related documentation
 

package/dist/coordinator.d.ts

@@ -0,0 +1,24 @@
+import type { AgentRuntime, AgentRuntimeProcess } from '@felan-ai/agent-core';
+export interface InteractiveBashProcess {
+    readonly id: string;
+    readonly process: AgentRuntimeProcess;
+    readonly output: string;
+    readonly running: boolean;
+    readonly nextOffset: number;
+    readonly exitCode?: number;
+    readonly signal?: 'SIGTERM' | 'SIGKILL';
+}
+/** Owns live PTY handles; persisted detached jobs remain owned by BackgroundBashManager. */
+export declare class BackgroundBashCoordinator {
+    #private;
+    private readonly runtime;
+    constructor(runtime: AgentRuntime);
+    start(id: string, command: string, cwd?: string, onSnapshot?: (snapshot: InteractiveBashProcess) => Promise<void>): Promise<InteractiveBashProcess>;
+    read(id: string, waitMs?: number, signal?: AbortSignal): Promise<InteractiveBashProcess>;
+    write(id: string, chars: string): Promise<InteractiveBashProcess>;
+    stop(id: string, signal?: 'SIGTERM' | 'SIGKILL'): Promise<InteractiveBashProcess>;
+    has(id: string): boolean;
+    isStarting(id: string): boolean;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=coordinator.d.ts.map

package/dist/coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../src/coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAM9E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CACzC;AAcD,4FAA4F;AAC5F,qBAAa,yBAAyB;;IAKxB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,YAAY;IAE5C,KAAK,CACT,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,sBAAsB,KAAK,OAAO,CAAC,IAAI,CAAC,GAC/D,OAAO,CAAC,sBAAsB,CAAC;IAgD5B,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,SAAI,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAcnF,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAMjE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,GAAE,SAAS,GAAG,SAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAwBlG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIzB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAoFhC"}

package/dist/coordinator.js

@@ -0,0 +1,212 @@
+const MAX_OUTPUT_BYTES = 8 * 1024 * 1024;
+const encoder = new TextEncoder();
+const decoder = new TextDecoder();
+/** Owns live PTY handles; persisted detached jobs remain owned by BackgroundBashManager. */
+export class BackgroundBashCoordinator {
+    runtime;
+    #entries = new Map();
+    #starting = new Map();
+    #shutdownPromise;
+    constructor(runtime) {
+        this.runtime = runtime;
+    }
+    async start(id, command, cwd, onSnapshot) {
+        if (this.#shutdownPromise)
+            throw new Error('Background process coordinator is shut down');
+        if (this.#entries.has(id) || this.#starting.has(id)) {
+            throw new Error(`Interactive background process already exists: ${id}`);
+        }
+        const terminals = this.runtime.terminals;
+        if (!terminals)
+            throw new Error('Interactive background processes require PTY support');
+        const starting = (async () => {
+            const process = await terminals.startShell(command, {
+                shellFlavor: 'posix',
+                ...(cwd === undefined ? {} : { cwd }),
+            });
+            const entry = {
+                process,
+                onSnapshot,
+                offset: 0,
+                output: '',
+                operation: Promise.resolve(),
+                decoder: new TextDecoder(),
+            };
+            this.#entries.set(id, entry);
+            try {
+                return await this.read(id);
+            }
+            catch (error) {
+                const errors = [error];
+                try {
+                    await process.terminate('SIGTERM');
+                }
+                catch (cleanupError) {
+                    errors.push(cleanupError);
+                }
+                try {
+                    await process.dispose();
+                }
+                catch (cleanupError) {
+                    errors.push(cleanupError);
+                }
+                if (errors.length > 1)
+                    throw new AggregateError(errors, `Failed to clean up interactive startup ${id}`);
+                this.#entries.delete(id);
+                throw error;
+            }
+        })();
+        this.#starting.set(id, starting);
+        try {
+            return await starting;
+        }
+        finally {
+            this.#starting.delete(id);
+        }
+    }
+    async read(id, waitMs = 0, signal) {
+        const entry = this.#require(id);
+        signal?.throwIfAborted();
+        // A foreground wait must not hold the snapshot/persistence queue needed by other callers.
+        if (waitMs > 0) {
+            await entry.process.read(entry.offset, {
+                waitMs,
+                ...(signal === undefined ? {} : { signal }),
+            });
+        }
+        signal?.throwIfAborted();
+        return this.#serialize(entry, () => this.#readUnlocked(id, entry), signal);
+    }
+    async write(id, chars) {
+        const entry = this.#require(id);
+        await entry.process.write(encoder.encode(chars));
+        return this.#serialize(entry, () => this.#readUnlocked(id, entry));
+    }
+    async stop(id, signal = 'SIGTERM') {
+        await this.#starting.get(id);
+        const entry = this.#require(id);
+        const stopping = entry.stopping ??= this.#terminate(entry, signal);
+        try {
+            await stopping;
+        }
+        finally {
+            if (entry.stopping === stopping)
+                delete entry.stopping;
+        }
+        return this.#serialize(entry, () => this.#readUnlocked(id, entry));
+    }
+    async #terminate(entry, signal) {
+        const current = await entry.process.read(entry.offset);
+        if (!current.running)
+            return;
+        entry.signal = signal;
+        try {
+            await entry.process.terminate(signal);
+        }
+        catch (error) {
+            delete entry.signal;
+            throw error;
+        }
+    }
+    has(id) {
+        return this.#entries.has(id) || this.#starting.has(id);
+    }
+    isStarting(id) {
+        return this.#starting.has(id);
+    }
+    async shutdown() {
+        if (this.#shutdownPromise)
+            return this.#shutdownPromise;
+        this.#shutdownPromise = (async () => {
+            const starts = await Promise.allSettled(this.#starting.values());
+            const entries = [...this.#entries.entries()];
+            const results = await Promise.allSettled(entries.map(async ([id, entry]) => {
+                const errors = [];
+                try {
+                    await this.stop(id);
+                }
+                catch (error) {
+                    errors.push(error);
+                }
+                try {
+                    await entry.process.dispose();
+                }
+                catch (error) {
+                    errors.push(error);
+                }
+                if (errors.length > 0)
+                    throw new AggregateError(errors, `Failed to clean up interactive process ${id}`);
+                this.#entries.delete(id);
+            }));
+            const failures = [...starts, ...results].filter((result) => result.status === 'rejected');
+            if (failures.length > 0) {
+                throw new AggregateError(failures.map((result) => result.reason), 'Failed to shut down interactive background processes');
+            }
+        })();
+        return this.#shutdownPromise;
+    }
+    #serialize(entry, operation, signal) {
+        const result = entry.operation.then(() => {
+            signal?.throwIfAborted();
+            return operation();
+        });
+        entry.operation = result.then(() => { }, () => { });
+        if (!signal)
+            return result;
+        return new Promise((resolve, reject) => {
+            const onAbort = () => {
+                signal.removeEventListener('abort', onAbort);
+                reject(signal.reason);
+            };
+            if (signal.aborted)
+                onAbort();
+            else
+                signal.addEventListener('abort', onAbort, { once: true });
+            void result.then((value) => { signal.removeEventListener('abort', onAbort); resolve(value); }, (error) => { signal.removeEventListener('abort', onAbort); reject(error); });
+        });
+    }
+    async #readUnlocked(id, entry) {
+        const snapshot = await entry.process.read(entry.offset);
+        entry.offset = snapshot.nextOffset;
+        if (snapshot.output.length > 0) {
+            entry.output = boundedTail(`${entry.output}${entry.decoder.decode(snapshot.output, { stream: snapshot.running })}`);
+        }
+        if (!snapshot.running)
+            entry.output = boundedTail(`${entry.output}${entry.decoder.decode()}`);
+        const result = {
+            id,
+            process: entry.process,
+            output: entry.output,
+            running: snapshot.running,
+            nextOffset: snapshot.nextOffset,
+            ...(snapshot.exitCode === undefined ? {} : { exitCode: snapshot.exitCode }),
+            ...(entry.signal === undefined ? {} : { signal: entry.signal }),
+        };
+        const previous = entry.snapshot;
+        if (!previous
+            || previous.nextOffset !== result.nextOffset
+            || previous.running !== result.running
+            || previous.exitCode !== result.exitCode
+            || previous.signal !== result.signal) {
+            await entry.onSnapshot?.(result);
+            entry.snapshot = result;
+        }
+        return result;
+    }
+    #require(id) {
+        const entry = this.#entries.get(id);
+        if (!entry)
+            throw new Error(`Interactive background process not found: ${id}`);
+        return entry;
+    }
+}
+function boundedTail(value) {
+    const bytes = encoder.encode(value);
+    if (bytes.byteLength <= MAX_OUTPUT_BYTES)
+        return value;
+    let start = bytes.byteLength - MAX_OUTPUT_BYTES;
+    while ((bytes[start] & 0xc0) === 0x80)
+        start += 1;
+    return decoder.decode(bytes.subarray(start));
+}
+//# sourceMappingURL=coordinator.js.map

package/dist/coordinator.js.map

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

package/dist/index.d.ts

@@ -1,4 +1,6 @@
-import { type Api, type FelanExtension, type Model } from '@felan-ai/agent-core';
+import { type FelanExtension } from '@felan-ai/agent-core';
+import { BackgroundBashCoordinator } from './coordinator.js';
+export declare function supportsBackgroundBashModel(model: unknown): boolean;
 interface BackgroundBashDetails {
     background: true;
     id: string;
@@ -13,12 +15,17 @@ interface BackgroundBashDetails {
     cwd: string;
     startedAt: number;
 }
-export declare function supportsBackgroundBashModel(model: Model<Api> | undefined): boolean;
+export declare const BACKGROUND_BASH_CONFIG: import("@felan-ai/agent-core").ExtensionConfigDefinition<{
+    readonly foregroundTimeoutSeconds: import("@felan-ai/agent-core").ExtensionConfigField<number>;
+}>;
+export declare function createBackgroundBashExtension(coordinator?: BackgroundBashCoordinator, ownsCoordinator?: boolean): FelanExtension;
 declare const backgroundBashExtension: FelanExtension;
 export { inspectBackgroundBashRuntime } from './runtime-support.js';
 export type { BackgroundBashRuntimeStatus } from './runtime-support.js';
 export type { BackgroundBashDetails };
 export { BackgroundBashManager } from './process-manager.js';
+export { BackgroundBashCoordinator } from './coordinator.js';
+export type { InteractiveBashProcess } from './coordinator.js';
 export type { BackgroundBashInfo, BackgroundBashJob, BackgroundBashMeta, BackgroundBashStatus, BackgroundBashStatusFile, BackgroundBashStatusFilter, } from './job-store.js';
 export default backgroundBashExtension;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,GAAG,EAER,KAAK,cAAc,EACnB,KAAK,KAAK,EACX,MAAM,sBAAsB,CAAC;AAkE9B,UAAU,qBAAqB;IAC7B,UAAU,EAAE,IAAI,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB;AAOD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,GAAG,OAAO,CAElF;AAED,QAAA,MAAM,uBAAuB,EAAE,cAma9B,CAAC;AAEF,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AACpE,YAAY,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAiFxE,YAAY,EAAE,qBAAqB,EAAE,CAAC;AACtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AACxB,eAAe,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAU9B,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAmB7D,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEnE;AA+CD,UAAU,qBAAqB;IAC7B,UAAU,EAAE,IAAI,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB;AAOD,eAAO,MAAM,sBAAsB;;EAYjC,CAAC;AAEH,wBAAgB,6BAA6B,CAC3C,WAAW,CAAC,EAAE,yBAAyB,EACvC,eAAe,UAA4B,GAC1C,cAAc,CAgdhB;AAED,QAAA,MAAM,uBAAuB,gBAAkC,CAAC;AAEhE,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AACpE,YAAY,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAsFxE,YAAY,EAAE,qBAAqB,EAAE,CAAC;AACtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,YAAY,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC/D,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AACxB,eAAe,uBAAuB,CAAC"}