@felan-ai/ext-codex 0.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Felan contributors
+Copyright (c) 2026 Umberto B.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,18 @@
+@felan-ai/ext-codex
+
+Includes selected code and behavior adapted from
+@howaboua/pi-codex-conversion 3.0.8,
+https://github.com/IgorWarzocha/howaboua-pi-stuff/tree/main/packages/pi-codex-conversion.
+
+Copyright (c) 2026 Umberto B.
+Licensed under the MIT License included in this package.
+
+Adapted portions include structured tool schemas and output conventions,
+patch parsing and matching, model activation policy, OpenAI request options,
+and cached WebSocket transport selection. Felan implements process and file
+operations against AgentRuntime and uses Pi 0.84.0's native OpenAI Codex
+transport for connection reuse and cached continuation.
+
+This package uses TypeBox 1.1.38 from
+https://github.com/sinclairzx81/typebox, licensed under the MIT License.
+Copyright (c) 2017-2026 Haydn Paterson.

package/README.md

@@ -0,0 +1,63 @@
+# @felan-ai/ext-codex
+
+First-party Felan support for the compact structured tool surface used by GPT
+coding models. It activates only when the selected model ID is GPT-family and
+the provider is exactly `openai` or `openai-codex`.
+
+Active mode replaces `read`, `bash`, `edit`, and `write` with
+`exec_command`, `write_stdin`, and `apply_patch`; image-capable models also get
+`view_image`. Other Felan tools remain active. Switching to another model
+restores the ordinary tools. All shell and filesystem operations use the
+current `AgentRuntime`.
+Runtimes without persistent-process support keep Felan's ordinary coding tools.
+
+Optional settings live at `$FELAN_AGENT_DIR/codex.json`:
+
+```json
+{
+  "fast": false,
+  "verbosity": "low",
+  "forceCachedWebSockets": true
+}
+```
+
+`fast` and `verbosity` modify eligible OpenAI Responses requests through a
+session-scoped stream wrapper and the provider-request event. For the OpenAI
+Codex provider, `forceCachedWebSockets` upgrades an explicit `websocket`
+preference to Pi's native `websocket-cached` transport. Explicit `sse` and
+`auto` remain unchanged. Pi owns connection reuse, SSE fallback, cached
+continuation, and session cleanup. The extension does not register or replace
+providers.
+
+`view_image` is active only when the selected model declares image input. Raw
+image reads are limited to 20 MiB, then Pi decodes and resizes supported images
+to at most 2000×2000 with a base64 payload below 4 MiB. Malformed,
+unsupported, and unresizable images are rejected.
+
+`tty: true` allocates a real operating-system PTY through the runtime terminal
+capability. `write_stdin` sends terminal input; for non-TTY sessions, the exact
+Ctrl-C byte interrupts the process group and other input is rejected. Process
+output is decoded incrementally and terminal control sequences are removed
+before tool text is returned to the model.
+
+Initial commands wait 250-30000 ms and default to 10000 ms; Windows uses a
+10000 ms minimum. Non-empty `write_stdin` calls wait 250-30000 ms and default
+to 250 ms; empty polls wait 5000-300000 ms and default to 5000 ms.
+Interactions targeting one session are serialized. Cancelling a tool wait
+leaves its process available for a later `write_stdin` call, while session
+shutdown terminates all remaining processes. Sessions are in-memory and do
+not survive application restart.
+
+The extension excludes restart-durable jobs, web access, image generation,
+Code Mode/Responses Lite, prompt replacement, compaction, voice, and UI
+widgets.
+
+## Development
+
+```sh
+pnpm --filter @felan-ai/ext-codex build
+pnpm --filter @felan-ai/ext-codex type-check
+pnpm --filter @felan-ai/ext-codex test
+```
+
+See [NOTICE](NOTICE) for upstream attribution.

package/dist/config.d.ts

@@ -0,0 +1,11 @@
+import type { AgentRuntime } from '@felan-ai/agent-core';
+export type CodexVerbosity = 'low' | 'medium' | 'high';
+export interface CodexConfig {
+    readonly fast: boolean;
+    readonly verbosity: CodexVerbosity;
+    readonly forceCachedWebSockets: boolean;
+}
+export declare const DEFAULT_CODEX_CONFIG: CodexConfig;
+export declare function readCodexConfig(runtime: AgentRuntime, agentDir: string): Promise<CodexConfig>;
+export declare function validateCodexConfig(value: unknown, source?: string): CodexConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEvD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;CACzC;AAED,eAAO,MAAM,oBAAoB,EAAE,WAIlC,CAAC;AAQF,wBAAsB,eAAe,CACnC,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,CAAC,CAiBtB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,SAAe,GAAG,WAAW,CAyBtF"}

package/dist/config.js

@@ -0,0 +1,67 @@
+export const DEFAULT_CODEX_CONFIG = {
+    fast: false,
+    verbosity: 'low',
+    forceCachedWebSockets: true,
+};
+const CONFIG_FIELDS = new Set([
+    'fast',
+    'verbosity',
+    'forceCachedWebSockets',
+]);
+export async function readCodexConfig(runtime, agentDir) {
+    if (!runtime.readAgentFile)
+        return DEFAULT_CODEX_CONFIG;
+    let content;
+    try {
+        content = await runtime.readAgentFile('codex.json');
+    }
+    catch (error) {
+        if (isMissingFile(error))
+            return DEFAULT_CODEX_CONFIG;
+        throw new Error(`Failed to read ${agentDir}/codex.json: ${errorMessage(error)}`, { cause: error });
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(new TextDecoder().decode(content));
+    }
+    catch (error) {
+        throw new Error(`Invalid ${agentDir}/codex.json: ${errorMessage(error)}`, { cause: error });
+    }
+    return validateCodexConfig(parsed, `${agentDir}/codex.json`);
+}
+export function validateCodexConfig(value, source = 'codex.json') {
+    if (!isRecord(value))
+        throw new Error(`${source} must contain a JSON object`);
+    for (const field of Object.keys(value)) {
+        if (!CONFIG_FIELDS.has(field))
+            throw new Error(`${source} contains unknown field: ${field}`);
+    }
+    if (value.fast !== undefined && typeof value.fast !== 'boolean') {
+        throw new Error(`${source}.fast must be a boolean`);
+    }
+    if (value.forceCachedWebSockets !== undefined && typeof value.forceCachedWebSockets !== 'boolean') {
+        throw new Error(`${source}.forceCachedWebSockets must be a boolean`);
+    }
+    if (value.verbosity !== undefined
+        && value.verbosity !== 'low'
+        && value.verbosity !== 'medium'
+        && value.verbosity !== 'high') {
+        throw new Error(`${source}.verbosity must be low, medium, or high`);
+    }
+    return {
+        fast: value.fast ?? DEFAULT_CODEX_CONFIG.fast,
+        verbosity: value.verbosity ?? DEFAULT_CODEX_CONFIG.verbosity,
+        forceCachedWebSockets: value.forceCachedWebSockets
+            ?? DEFAULT_CODEX_CONFIG.forceCachedWebSockets,
+    };
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isMissingFile(error) {
+    return error instanceof Error && 'code' in error && error.code === 'ENOENT';
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/exec-session-manager.d.ts

@@ -0,0 +1,34 @@
+import type { AgentRuntime } from '@felan-ai/agent-core';
+export interface ExecCommandInput {
+    readonly cmd: string;
+    readonly workdir?: string;
+    readonly shell?: string;
+    readonly tty?: boolean;
+    readonly yield_time_ms?: number;
+    readonly max_output_tokens?: number;
+    readonly login?: boolean;
+}
+export interface WriteStdinInput {
+    readonly session_id: number;
+    readonly chars?: string;
+    readonly yield_time_ms?: number;
+    readonly max_output_tokens?: number;
+}
+export interface UnifiedExecResult {
+    readonly chunk_id: string;
+    readonly wall_time_seconds: number;
+    readonly output: string;
+    readonly exit_code?: number;
+    readonly session_id?: number;
+    readonly original_token_count?: number;
+}
+export declare class ExecSessionManager {
+    #private;
+    private readonly runtime;
+    constructor(runtime: AgentRuntime);
+    exec(input: ExecCommandInput, signal?: AbortSignal, onUpdate?: (result: UnifiedExecResult) => void): Promise<UnifiedExecResult>;
+    write(input: WriteStdinInput, signal?: AbortSignal, onUpdate?: (result: UnifiedExecResult) => void): Promise<UnifiedExecResult>;
+    shutdown(): Promise<void>;
+}
+export declare function formatExecResult(result: UnifiedExecResult): string;
+//# sourceMappingURL=exec-session-manager.d.ts.map

package/dist/exec-session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-session-manager.d.ts","sourceRoot":"","sources":["../src/exec-session-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAuB,MAAM,sBAAsB,CAAC;AAE9E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACxC;AA0BD,qBAAa,kBAAkB;;IAIjB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,YAAY;IAE5C,IAAI,CACR,KAAK,EAAE,gBAAgB,EACvB,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,GAC7C,OAAO,CAAC,iBAAiB,CAAC;IAoDvB,KAAK,CACT,KAAK,EAAE,eAAe,EACtB,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,GAC7C,OAAO,CAAC,iBAAiB,CAAC;IA0CvB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CA0HhC;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAalE"}

package/dist/exec-session-manager.js

@@ -0,0 +1,374 @@
+import { randomBytes, randomInt } from 'node:crypto';
+const DEFAULT_EXEC_YIELD_MS = 10_000;
+const DEFAULT_WRITE_YIELD_MS = 250;
+const MIN_YIELD_MS = 250;
+const MIN_EMPTY_POLL_YIELD_MS = 5_000;
+const MAX_YIELD_MS = 30_000;
+const MAX_EMPTY_POLL_YIELD_MS = 300_000;
+const DEFAULT_MAX_OUTPUT_TOKENS = 10_000;
+const MAX_RETAINED_OUTPUT_CHARS = 4 * 1024 * 1024;
+const COMPLETED_HISTORY_LIMIT = 32;
+const SESSION_ID_MIN = 1_000;
+const SESSION_ID_MAX_EXCLUSIVE = 100_000;
+export class ExecSessionManager {
+    runtime;
+    #sessions = new Map();
+    #completed = new Map();
+    constructor(runtime) {
+        this.runtime = runtime;
+    }
+    async exec(input, signal, onUpdate) {
+        const processes = this.runtime.processes;
+        if (!processes)
+            throw new Error('exec_command requires runtime process support');
+        if (signal?.aborted)
+            throw new Error('exec_command aborted');
+        const startedAt = Date.now();
+        const processOptions = {
+            ...(input.workdir === undefined ? {} : { cwd: input.workdir }),
+            ...(input.shell === undefined ? {} : { shell: input.shell }),
+            ...(input.login === undefined ? {} : { login: input.login }),
+        };
+        const process = input.tty === true
+            ? await this.#startTerminal(input.cmd, processOptions)
+            : await processes.startShell(input.cmd, processOptions);
+        const session = {
+            id: this.#allocateSessionId(),
+            process,
+            tty: input.tty === true,
+            decoder: new TextDecoder(),
+            sanitizer: new TerminalSanitizer(),
+            interactionTail: Promise.resolve(),
+            offset: 0,
+            pendingOutput: '',
+            pendingOriginalCharCount: 0,
+        };
+        this.#sessions.set(session.id, session);
+        try {
+            return await this.#withInteraction(session, async () => {
+                onUpdate?.(this.#emptyResult(session, startedAt));
+                const snapshot = await readFor(session, 0, execYield(input.yield_time_ms), input.max_output_tokens, signal);
+                session.offset = snapshot.nextOffset;
+                if (signal?.aborted) {
+                    await this.#preserveAbortedRead(session, snapshot, startedAt);
+                    throw new Error(`exec_command aborted; process continues as session ${session.id}`);
+                }
+                const result = this.#consumeRead(session, snapshot, startedAt, input.max_output_tokens);
+                if (!snapshot.running)
+                    await this.#complete(session, result);
+                return result;
+            });
+        }
+        catch (error) {
+            if (signal?.aborted && !String(error).includes(`session ${session.id}`)) {
+                throw new Error(`exec_command aborted; process continues as session ${session.id}`, { cause: error });
+            }
+            throw error;
+        }
+    }
+    async write(input, signal, onUpdate) {
+        const session = this.#sessions.get(input.session_id);
+        if (!session) {
+            return this.#completedResult(input);
+        }
+        const startedAt = Date.now();
+        try {
+            return await this.#withInteraction(session, async () => {
+                if (this.#sessions.get(input.session_id) !== session)
+                    return this.#completedResult(input);
+                const chars = input.chars ?? '';
+                if (chars) {
+                    this.#validateInput(session, chars);
+                    await this.#writeInput(session, chars);
+                }
+                if (signal?.aborted) {
+                    throw new Error(`write_stdin aborted; session ${session.id} remains available`);
+                }
+                onUpdate?.(this.#emptyResult(session, startedAt));
+                const snapshot = await readFor(session, session.offset, writeYield(chars, input.yield_time_ms), input.max_output_tokens, signal);
+                session.offset = snapshot.nextOffset;
+                if (signal?.aborted) {
+                    await this.#preserveAbortedRead(session, snapshot, startedAt);
+                    throw new Error(`write_stdin aborted; session ${session.id} remains available`);
+                }
+                const result = this.#consumeRead(session, snapshot, startedAt, input.max_output_tokens);
+                if (!snapshot.running)
+                    await this.#complete(session, result);
+                return result;
+            });
+        }
+        catch (error) {
+            if (signal?.aborted && !String(error).includes(`session ${session.id}`)) {
+                throw new Error(`write_stdin aborted; session ${session.id} remains available`, { cause: error });
+            }
+            throw error;
+        }
+    }
+    async shutdown() {
+        const sessions = [...this.#sessions.values()];
+        this.#sessions.clear();
+        this.#completed.clear();
+        await Promise.allSettled(sessions.map((session) => session.process.dispose()));
+    }
+    #emptyResult(session, startedAt) {
+        return {
+            chunk_id: chunkId(),
+            wall_time_seconds: (Date.now() - startedAt) / 1_000,
+            output: '',
+            session_id: session.id,
+        };
+    }
+    async #complete(session, result) {
+        if (this.#sessions.get(session.id) === session)
+            this.#sessions.delete(session.id);
+        this.#completed.set(session.id, result);
+        while (this.#completed.size > COMPLETED_HISTORY_LIMIT) {
+            const oldest = this.#completed.keys().next().value;
+            if (oldest === undefined)
+                break;
+            this.#completed.delete(oldest);
+        }
+        await session.process.dispose();
+    }
+    async #startTerminal(command, options) {
+        if (!this.runtime.terminals) {
+            throw new Error('exec_command with tty=true requires runtime terminal support');
+        }
+        return this.runtime.terminals.startShell(command, options);
+    }
+    async #writeInput(session, chars) {
+        if (session.tty) {
+            await session.process.write(new TextEncoder().encode(chars));
+            await delay(100);
+            return;
+        }
+        await session.process.interrupt();
+    }
+    #validateInput(session, chars) {
+        if (session.tty)
+            return;
+        if (chars !== '\u0003') {
+            throw new Error('stdin is closed for this session; rerun exec_command with tty=true to keep stdin open');
+        }
+        if (!session.process.interrupt)
+            throw new Error('Runtime process interruption is unavailable');
+    }
+    #completedResult(input) {
+        const completed = this.#completed.get(input.session_id);
+        if (completed && !(input.chars ?? ''))
+            return truncateResult(completed, input.max_output_tokens);
+        if (completed)
+            throw new Error(`Process id ${input.session_id} already exited; cannot write stdin`);
+        throw new Error(`Unknown process id ${input.session_id}`);
+    }
+    #consumeRead(session, read, startedAt, maxOutputTokens) {
+        const output = `${session.pendingOutput}${read.output}`;
+        const originalCharCount = session.pendingOriginalCharCount + read.originalCharCount;
+        session.pendingOutput = '';
+        session.pendingOriginalCharCount = 0;
+        return resultFromRead(session, { ...read, output, originalCharCount }, startedAt, maxOutputTokens);
+    }
+    async #preserveAbortedRead(session, read, startedAt) {
+        const combined = `${session.pendingOutput}${read.output}`;
+        session.pendingOutput = tail(combined, MAX_RETAINED_OUTPUT_CHARS);
+        session.pendingOriginalCharCount += read.originalCharCount;
+        if (!read.running) {
+            const result = this.#consumeRead(session, { ...read, output: '', originalCharCount: 0 }, startedAt, MAX_RETAINED_OUTPUT_CHARS / 4);
+            await this.#complete(session, result);
+        }
+    }
+    async #withInteraction(session, operation) {
+        const previous = session.interactionTail;
+        let release;
+        const gate = new Promise((resolveGate) => { release = resolveGate; });
+        session.interactionTail = previous.then(() => gate);
+        try {
+            await previous;
+            return await operation();
+        }
+        finally {
+            release();
+        }
+    }
+    #allocateSessionId() {
+        for (let attempt = 0; attempt < 1_000; attempt += 1) {
+            const id = randomInt(SESSION_ID_MIN, SESSION_ID_MAX_EXCLUSIVE);
+            if (!this.#sessions.has(id) && !this.#completed.has(id))
+                return id;
+        }
+        throw new Error('Unable to allocate a unified exec session id');
+    }
+}
+export function formatExecResult(result) {
+    const sections = [];
+    sections.push(`Chunk ID: ${result.chunk_id}`);
+    sections.push(`Wall time: ${result.wall_time_seconds.toFixed(4)} seconds`);
+    if (result.exit_code !== undefined)
+        sections.push(`Process exited with code ${result.exit_code}`);
+    if (result.session_id !== undefined) {
+        sections.push(`Process running with session ID ${result.session_id}`);
+    }
+    if (result.original_token_count !== undefined) {
+        sections.push(`Original token count: ${result.original_token_count}`);
+    }
+    sections.push('Output:', result.output);
+    return sections.join('\n');
+}
+function resultFromRead(session, read, startedAt, maxOutputTokens) {
+    const truncated = truncateOutput(read.output, maxOutputTokens, read.originalCharCount);
+    return {
+        chunk_id: chunkId(),
+        wall_time_seconds: (Date.now() - startedAt) / 1_000,
+        ...truncated,
+        ...(read.running ? { session_id: session.id } : { exit_code: read.exitCode ?? 1 }),
+    };
+}
+async function readFor(session, afterOffset, waitMs, maxOutputTokens, signal) {
+    const deadline = Date.now() + waitMs;
+    const maxChars = maxCharsForTokens(maxOutputTokens);
+    let output = '';
+    let originalCharCount = 0;
+    let offset = afterOffset;
+    let snapshot = await session.process.read(offset);
+    while (true) {
+        const decoded = session.decoder.decode(snapshot.output, { stream: snapshot.running });
+        const sanitized = session.sanitizer.write(decoded, !snapshot.running);
+        originalCharCount += sanitized.length;
+        output = tail(`${output}${sanitized}`, maxChars);
+        offset = snapshot.nextOffset;
+        if (!snapshot.running || signal?.aborted)
+            break;
+        const remaining = deadline - Date.now();
+        if (remaining <= 0)
+            break;
+        snapshot = await session.process.read(offset, {
+            waitMs: remaining,
+            ...(signal === undefined ? {} : { signal }),
+        });
+        if (snapshot.output.length === 0 && snapshot.running)
+            break;
+    }
+    return {
+        output,
+        originalCharCount,
+        nextOffset: snapshot.nextOffset,
+        running: snapshot.running,
+        ...(snapshot.exitCode === undefined ? {} : { exitCode: snapshot.exitCode }),
+    };
+}
+function truncateResult(result, maxOutputTokens) {
+    const originalCharCount = result.original_token_count === undefined
+        ? result.output.length
+        : result.original_token_count * 4;
+    return { ...result, ...truncateOutput(result.output, maxOutputTokens, originalCharCount) };
+}
+function truncateOutput(output, maxOutputTokens = DEFAULT_MAX_OUTPUT_TOKENS, originalCharCount = output.length) {
+    const maxChars = maxCharsForTokens(maxOutputTokens);
+    const originalTokenCount = Math.ceil(Math.max(output.length, originalCharCount) / 4);
+    if (output.length <= maxChars) {
+        return output || originalCharCount > 0
+            ? { output, original_token_count: originalTokenCount }
+            : { output };
+    }
+    return {
+        output: tail(output, maxChars),
+        original_token_count: originalTokenCount,
+    };
+}
+function maxCharsForTokens(maxOutputTokens = DEFAULT_MAX_OUTPUT_TOKENS) {
+    const requested = Number.isFinite(maxOutputTokens)
+        ? Math.max(256, Math.floor(maxOutputTokens * 4))
+        : DEFAULT_MAX_OUTPUT_TOKENS * 4;
+    return Math.min(MAX_RETAINED_OUTPUT_CHARS, requested);
+}
+function tail(output, maxChars) {
+    let start = Math.max(0, output.length - maxChars);
+    if (start > 0 && /[\uDC00-\uDFFF]/u.test(output[start]))
+        start += 1;
+    return output.slice(start);
+}
+function execYield(value) {
+    const minimum = process.platform === 'win32' ? DEFAULT_EXEC_YIELD_MS : MIN_YIELD_MS;
+    return clampYield(value ?? DEFAULT_EXEC_YIELD_MS, minimum, MAX_YIELD_MS);
+}
+function writeYield(chars, value) {
+    const requested = value ?? DEFAULT_WRITE_YIELD_MS;
+    return chars
+        ? clampYield(requested, MIN_YIELD_MS, MAX_YIELD_MS)
+        : clampYield(requested, MIN_EMPTY_POLL_YIELD_MS, MAX_EMPTY_POLL_YIELD_MS);
+}
+function clampYield(value, minimum, maximum) {
+    if (!Number.isFinite(value))
+        return minimum;
+    return Math.min(maximum, Math.max(minimum, Math.floor(value)));
+}
+function chunkId() {
+    return randomBytes(3).toString('hex');
+}
+function delay(ms) {
+    return new Promise((resolveDelay) => setTimeout(resolveDelay, ms));
+}
+class TerminalSanitizer {
+    #state = 'text';
+    write(input, final) {
+        let output = '';
+        for (const character of input) {
+            const code = character.codePointAt(0);
+            switch (this.#state) {
+                case 'text':
+                    if (code === 0x1b)
+                        this.#state = 'escape';
+                    else if (code === 0x9b)
+                        this.#state = 'csi';
+                    else if (code === 0x9d)
+                        this.#state = 'osc';
+                    else if ([0x90, 0x98, 0x9e, 0x9f].includes(code))
+                        this.#state = 'string';
+                    else if (character === '\t' || character === '\n' || (code >= 0x20 && code !== 0x7f && !(code >= 0x80 && code <= 0x9f))) {
+                        output += character;
+                    }
+                    break;
+                case 'escape':
+                    if (character === '[')
+                        this.#state = 'csi';
+                    else if (character === ']')
+                        this.#state = 'osc';
+                    else if (character === 'P' || character === 'X' || character === '^' || character === '_')
+                        this.#state = 'string';
+                    else if (code >= 0x20 && code <= 0x2f)
+                        this.#state = 'escape-intermediate';
+                    else
+                        this.#state = 'text';
+                    break;
+                case 'escape-intermediate':
+                    if (code >= 0x30 && code <= 0x7e)
+                        this.#state = 'text';
+                    break;
+                case 'csi':
+                    if (code >= 0x40 && code <= 0x7e)
+                        this.#state = 'text';
+                    break;
+                case 'osc':
+                    if (code === 0x07)
+                        this.#state = 'text';
+                    else if (code === 0x1b)
+                        this.#state = 'osc-escape';
+                    break;
+                case 'osc-escape':
+                    this.#state = character === '\\' ? 'text' : 'osc';
+                    break;
+                case 'string':
+                    if (code === 0x1b)
+                        this.#state = 'string-escape';
+                    break;
+                case 'string-escape':
+                    this.#state = character === '\\' ? 'text' : 'string';
+                    break;
+            }
+        }
+        if (final)
+            this.#state = 'text';
+        return output;
+    }
+}
+//# sourceMappingURL=exec-session-manager.js.map

package/dist/exec-session-manager.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+import { type FelanExtension } from '@felan-ai/agent-core';
+declare const codexExtension: FelanExtension;
+export { DEFAULT_CODEX_CONFIG, readCodexConfig, validateCodexConfig } from './config.js';
+export type { CodexConfig, CodexVerbosity } from './config.js';
+export { ExecSessionManager, formatExecResult } from './exec-session-manager.js';
+export type { ExecCommandInput, UnifiedExecResult, WriteStdinInput } from './exec-session-manager.js';
+export { supportsCodexModel, supportsCodexResponsesRequest } from './model-policy.js';
+export { applyCodexRequestOptions } from './request-options.js';
+export { CODEX_TOOL_NAMES, MAX_VIEW_IMAGE_INPUT_BYTES, createCodexTools } from './tools.js';
+export { createCodexStreamFunctionWrapper, resolveCodexStreamOptions, resolveCodexTransport, } from './transport.js';
+export default codexExtension;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,sBAAsB,CAAC;AAU9B,QAAA,MAAM,cAAc,EAAE,cAgCrB,CAAC;AAEF,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACzF,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACjF,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACtG,OAAO,EAAE,kBAAkB,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AACtF,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC5F,OAAO,EACL,gCAAgC,EAChC,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AACxB,eAAe,cAAc,CAAC"}