@moxxy/plugin-provider-codex-agent 0.0.0-stage → 0.45.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Moxxy (moxxy.ai)
+
+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/dist/account-limit.d.ts

@@ -0,0 +1,11 @@
+import { type AgentAccountLimit } from '@moxxy/sdk';
+import type { CodexRateLimitSnapshot } from './protocol.js';
+/**
+ * Codex's rate limits as Moxxy's account limit, from the most used of its windows; undefined when
+ * the update leaves the windows out (they stay as they were). Codex does not say when a window is
+ * near, so it is near from the share Claude warns at.
+ */
+export declare function accountLimitFrom(snapshot: CodexRateLimitSnapshot): AgentAccountLimit | undefined;
+/** Whether Codex failed a turn because the account's usage limit is used up. */
+export declare function failedOnUsageLimit(errorInfo: unknown): boolean;
+//# sourceMappingURL=account-limit.d.ts.map

package/dist/account-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-limit.d.ts","sourceRoot":"","sources":["../src/account-limit.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,KAAK,EAAE,sBAAsB,EAAwB,MAAM,eAAe,CAAC;AAElF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,iBAAiB,GAAG,SAAS,CAWhG;AAED,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAE9D"}

package/dist/account-limit.js

@@ -0,0 +1,24 @@
+import { ACCOUNT_LIMIT_NEAR_PERCENT } from '@moxxy/sdk';
+/**
+ * Codex's rate limits as Moxxy's account limit, from the most used of its windows; undefined when
+ * the update leaves the windows out (they stay as they were). Codex does not say when a window is
+ * near, so it is near from the share Claude warns at.
+ */
+export function accountLimitFrom(snapshot) {
+    const windows = [snapshot.primary, snapshot.secondary].filter((w) => w !== null && w !== undefined);
+    const top = windows.reduce((most, w) => (!most || w.usedPercent > most.usedPercent ? w : most), undefined);
+    if (!top)
+        return undefined;
+    const reached = (snapshot.rateLimitReachedType !== null && snapshot.rateLimitReachedType !== undefined) || top.usedPercent >= 100;
+    return {
+        state: reached ? 'reached' : top.usedPercent >= ACCOUNT_LIMIT_NEAR_PERCENT ? 'near' : 'ok',
+        usedPercent: top.usedPercent,
+        ...(top.windowDurationMins !== null ? { windowMinutes: top.windowDurationMins } : {}),
+        ...(top.resetsAt !== null ? { resetsAt: top.resetsAt * 1000 } : {}),
+    };
+}
+/** Whether Codex failed a turn because the account's usage limit is used up. */
+export function failedOnUsageLimit(errorInfo) {
+    return errorInfo === 'usageLimitExceeded';
+}
+//# sourceMappingURL=account-limit.js.map

package/dist/account-limit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-limit.js","sourceRoot":"","sources":["../src/account-limit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAA0B,MAAM,YAAY,CAAC;AAGhF;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgC;IAC/D,MAAM,OAAO,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAA6B,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC;IAC/H,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAmC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC;IAC7I,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,MAAM,OAAO,GAAG,CAAC,QAAQ,CAAC,oBAAoB,KAAK,IAAI,IAAI,QAAQ,CAAC,oBAAoB,KAAK,SAAS,CAAC,IAAI,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC;IAClI,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,IAAI,0BAA0B,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;QAC1F,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,GAAG,CAAC,GAAG,CAAC,kBAAkB,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,GAAG,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrF,GAAG,CAAC,GAAG,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpE,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,kBAAkB,CAAC,SAAkB;IACnD,OAAO,SAAS,KAAK,oBAAoB,CAAC;AAC5C,CAAC"}

package/dist/agent-provider.d.ts

@@ -0,0 +1,62 @@
+import { type AgentActivity, type AgentStepEvent, type AgentStepRequest, type AgentTurnStart, type LLMProvider, type ModelDescriptor, type ProviderEvent, type ProviderRequest } from '@moxxy/sdk';
+import { AgentSessionPool } from '@moxxy/agent-connection-kit';
+import { CodexAgentSession, type StartCodexAppServer } from './codex-session.js';
+export declare const CODEX_AGENT_DEFAULT_MODEL = "gpt-6-astra";
+/** What a new conversation starts on while the person chose no default: light, so it spares their plan. */
+export declare const CODEX_AGENT_STARTER_MODEL = "gpt-6-luna";
+/** Models Codex offers on a ChatGPT sign-in, used until Codex's own `model/list` answered; Codex decides what the account may use. */
+export declare const codexAgentModels: ReadonlyArray<ModelDescriptor>;
+export interface CodexAgentProviderConfig {
+    /** The person's Codex CLI; resolved from PATH when left out. */
+    readonly executable?: string;
+    /** Persisted provider-item model (`plugins.provider.items.codex-agent.model`). */
+    readonly model?: string;
+    readonly defaultModel?: string;
+    /** Runner workspace, supplied on activation. */
+    readonly cwd?: string;
+    /** How `codex app-server` is started; spawns the person's Codex by default. */
+    readonly startAppServer?: StartCodexAppServer;
+    /** The live Codex sessions; shared across the process by default. */
+    readonly sessions?: AgentSessionPool<CodexAgentSession>;
+}
+/** The live Codex sessions of this process, one per Moxxy conversation. */
+export declare function codexSessions(): AgentSessionPool<CodexAgentSession>;
+/**
+ * The Codex agent connection: Codex does each turn itself through
+ * `codex app-server`, unmodified (its instructions, config, tools, skills and
+ * MCP servers), on the person's ChatGPT sign-in. Moxxy adds only its own MCP
+ * server to the thread, and nothing to the prompt.
+ */
+export declare class CodexAgentProvider implements LLMProvider {
+    private readonly config;
+    readonly name = "codex-agent";
+    readonly agentName = "Codex";
+    /** Its own plan mode and goal: Moxxy shows the plan and ends the goal when the agent says so. */
+    readonly agentOwns: {
+        readonly plan: true;
+        readonly goal: true;
+    };
+    readonly models: readonly ModelDescriptor[];
+    readonly starterModel = "gpt-6-luna";
+    private readonly defaultModel;
+    private readonly start;
+    constructor(config?: CodexAgentProviderConfig);
+    agentStep(req: AgentStepRequest): AsyncIterable<AgentStepEvent>;
+    /**
+     * Work Codex left running (a subagent, a command in the background) ended
+     * between turns. Codex starts no turn then, so Moxxy opens one to show it.
+     */
+    onAgentTurn(listener: (start: AgentTurnStart) => void): () => void;
+    /** What Codex's background work does between turns, recorded at once. */
+    onAgentActivity(listener: (activity: AgentActivity) => void): () => void;
+    /** Stop one work Codex runs in the background in the conversation. */
+    stopBackgroundWork(sessionId: string, workId: string): Promise<boolean>;
+    private sessions;
+    /** One-off text (summaries, skill drafts): an ephemeral read-only Codex thread, kept nowhere. */
+    stream(req: ProviderRequest): AsyncIterable<ProviderEvent>;
+    countTokens(req: Pick<ProviderRequest, 'model' | 'messages' | 'system' | 'tools'>): Promise<number>;
+    /** The conversation's running Codex, or a new one (resuming its thread) when there is none that fits. */
+    private lease;
+}
+export declare function createCodexAgentClient(config?: CodexAgentProviderConfig): LLMProvider;
+//# sourceMappingURL=agent-provider.d.ts.map

package/dist/agent-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-provider.d.ts","sourceRoot":"","sources":["../src/agent-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,eAAe,EAErB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAkE,MAAM,6BAA6B,CAAC;AAE/H,OAAO,EAAE,iBAAiB,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAKjF,eAAO,MAAM,yBAAyB,gBAAgB,CAAC;AACvD,2GAA2G;AAC3G,eAAO,MAAM,yBAAyB,eAAe,CAAC;AAetD,sIAAsI;AACtI,eAAO,MAAM,gBAAgB,EAAE,aAAa,CAAC,eAAe,CAS3D,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,gEAAgE;IAChE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,kFAAkF;IAClF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,gDAAgD;IAChD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,QAAQ,CAAC,cAAc,CAAC,EAAE,mBAAmB,CAAC;IAC9C,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;CACzD;AAID,2EAA2E;AAC3E,wBAAgB,aAAa,IAAI,gBAAgB,CAAC,iBAAiB,CAAC,CAGnE;AAED;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,WAAW;IAUxC,OAAO,CAAC,QAAQ,CAAC,MAAM;IATnC,QAAQ,CAAC,IAAI,iBAA2B;IACxC,QAAQ,CAAC,SAAS,WAAoB;IACtC,iGAAiG;IACjG,QAAQ,CAAC,SAAS;;;MAAuC;IACzD,QAAQ,CAAC,MAAM,6BAAoB;IACnC,QAAQ,CAAC,YAAY,gBAA6B;IAClD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;gBAEf,MAAM,GAAE,wBAA6B;IAK3D,SAAS,CAAC,GAAG,EAAE,gBAAgB,GAAG,aAAa,CAAC,cAAc,CAAC;IAgBtE;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GAAG,MAAM,IAAI;IAIlE,yEAAyE;IACzE,eAAe,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI;IAIxE,sEAAsE;IAChE,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK7E,OAAO,CAAC,QAAQ;IAIhB,iGAAiG;IAC1F,MAAM,CAAC,GAAG,EAAE,eAAe,GAAG,aAAa,CAAC,aAAa,CAAC;IA8D3D,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAazG,yGAAyG;YAC3F,KAAK;CAkBpB;AAED,wBAAgB,sBAAsB,CAAC,MAAM,GAAE,wBAA6B,GAAG,WAAW,CAEzF"}

package/dist/agent-provider.js

@@ -0,0 +1,209 @@
+import { estimateTextTokens, } from '@moxxy/sdk';
+import { AgentSessionPool, Inbox, JsonRpcLineClient, oneOffPrompt } from '@moxxy/agent-connection-kit';
+import { CODEX_AGENT_NAME, CODEX_AGENT_PROVIDER_ID } from './constants.js';
+import { CodexAgentSession } from './codex-session.js';
+import { spawnCodexAppServer } from './executable.js';
+import { toTokenUsage } from './translate.js';
+export const CODEX_AGENT_DEFAULT_MODEL = 'gpt-6-astra';
+/** What a new conversation starts on while the person chose no default: light, so it spares their plan. */
+export const CODEX_AGENT_STARTER_MODEL = 'gpt-6-luna';
+const NON_TEXT_BLOCK_TOKENS = 256;
+const MAX_LIVE_CODEX_SESSIONS = 8;
+const agentCapabilities = {
+    supportsTools: true,
+    supportsStreaming: true,
+    supportsImages: true,
+    supportsDocuments: false,
+    supportsAudio: false,
+    supportsReasoning: true,
+    supportsFast: true,
+    hostedTools: ['web_search'],
+};
+/** Models Codex offers on a ChatGPT sign-in, used until Codex's own `model/list` answered; Codex decides what the account may use. */
+export const codexAgentModels = [
+    { id: CODEX_AGENT_DEFAULT_MODEL, contextWindow: 272_000, maxOutputTokens: 128_000, ...agentCapabilities },
+    // Codex 0.163's own catalog: 500k for 6.1 Sol, 272k for the rest (the API models have 1.05M).
+    { id: 'gpt-6.1-sol', contextWindow: 500_000, maxOutputTokens: 128_000, ...agentCapabilities },
+    { id: 'gpt-6-sol', contextWindow: 272_000, maxOutputTokens: 128_000, ...agentCapabilities },
+    { id: 'gpt-6-luna', contextWindow: 272_000, maxOutputTokens: 128_000, ...agentCapabilities },
+    { id: 'gpt-5.6-sol', contextWindow: 272_000, maxOutputTokens: 128_000, ...agentCapabilities },
+    { id: 'gpt-5.6-terra', contextWindow: 272_000, maxOutputTokens: 128_000, ...agentCapabilities },
+    { id: 'gpt-5.6-luna', contextWindow: 272_000, maxOutputTokens: 128_000, ...agentCapabilities },
+];
+let sharedSessions;
+/** The live Codex sessions of this process, one per Moxxy conversation. */
+export function codexSessions() {
+    sharedSessions ??= new AgentSessionPool({ limit: MAX_LIVE_CODEX_SESSIONS });
+    return sharedSessions;
+}
+/**
+ * The Codex agent connection: Codex does each turn itself through
+ * `codex app-server`, unmodified (its instructions, config, tools, skills and
+ * MCP servers), on the person's ChatGPT sign-in. Moxxy adds only its own MCP
+ * server to the thread, and nothing to the prompt.
+ */
+export class CodexAgentProvider {
+    config;
+    name = CODEX_AGENT_PROVIDER_ID;
+    agentName = CODEX_AGENT_NAME;
+    /** Its own plan mode and goal: Moxxy shows the plan and ends the goal when the agent says so. */
+    agentOwns = { plan: true, goal: true };
+    models = codexAgentModels;
+    starterModel = CODEX_AGENT_STARTER_MODEL;
+    defaultModel;
+    start;
+    constructor(config = {}) {
+        this.config = config;
+        this.defaultModel = config.model ?? config.defaultModel ?? CODEX_AGENT_DEFAULT_MODEL;
+        this.start = config.startAppServer ?? spawnCodexAppServer(config.executable ?? 'codex');
+    }
+    async *agentStep(req) {
+        let lease;
+        try {
+            lease = await this.lease(req);
+        }
+        catch (err) {
+            if (!req.signal.aborted)
+                yield { type: 'error', message: messageOf(err), retryable: false };
+            return;
+        }
+        try {
+            yield* lease.session.turn(req);
+        }
+        finally {
+            if (lease.session.isAlive)
+                lease.release();
+            else
+                await lease.discard();
+        }
+    }
+    /**
+     * Work Codex left running (a subagent, a command in the background) ended
+     * between turns. Codex starts no turn then, so Moxxy opens one to show it.
+     */
+    onAgentTurn(listener) {
+        return this.sessions().onAgentTurn(listener);
+    }
+    /** What Codex's background work does between turns, recorded at once. */
+    onAgentActivity(listener) {
+        return this.sessions().onActivity(listener);
+    }
+    /** Stop one work Codex runs in the background in the conversation. */
+    async stopBackgroundWork(sessionId, workId) {
+        const live = this.sessions().running(sessionId);
+        return live ? live.stopWork(workId) : false;
+    }
+    sessions() {
+        return this.config.sessions ?? codexSessions();
+    }
+    /** One-off text (summaries, skill drafts): an ephemeral read-only Codex thread, kept nowhere. */
+    async *stream(req) {
+        const model = req.model || this.defaultModel;
+        yield { type: 'message_start', model };
+        const cwd = this.config.cwd ?? process.cwd();
+        let usage;
+        let connection;
+        try {
+            connection = await this.start({ cwd });
+            const client = new JsonRpcLineClient({ readable: connection.readable, writable: connection.writable });
+            const notes = new Inbox();
+            client.onNotification((method, params) => notes.push({ method, params: (params ?? {}) }));
+            connection.readable.once('close', () => notes.push(null));
+            await client.request('initialize', { clientInfo: { name: 'moxxy', title: 'Moxxy', version: '1' }, capabilities: { experimentalApi: true } });
+            client.notify('initialized');
+            const { system, prompt } = oneOffPrompt(req);
+            const thread = await client.request('thread/start', {
+                cwd,
+                ephemeral: true,
+                approvalPolicy: 'never',
+                sandbox: 'read-only',
+                model,
+                ...(system ? { developerInstructions: system } : {}),
+            });
+            const started = await client.request('turn/start', { threadId: thread.thread.id, input: [{ type: 'text', text: prompt, text_elements: [] }] }, req.signal);
+            const stop = () => void client.request('turn/interrupt', { threadId: thread.thread.id, turnId: started.turn.id }).catch(() => undefined);
+            req.signal?.addEventListener('abort', stop, { once: true });
+            try {
+                for (;;) {
+                    const note = await notes.next();
+                    if (note === null)
+                        throw new Error('Codex stopped.');
+                    const { method, params } = note;
+                    if (params.turnId !== undefined && params.turnId !== started.turn.id)
+                        continue;
+                    if (method === 'item/agentMessage/delta' && typeof params.delta === 'string')
+                        yield { type: 'text_delta', delta: params.delta };
+                    else if (method === 'thread/tokenUsage/updated') {
+                        const last = params.tokenUsage?.last;
+                        if (last)
+                            usage = toTokenUsage(last);
+                    }
+                    else if (method === 'turn/completed') {
+                        const turn = params.turn;
+                        if (!turn || turn.id !== started.turn.id)
+                            continue;
+                        if (turn.status === 'failed') {
+                            yield { type: 'error', message: `Codex: ${turn.error?.message ?? 'the turn failed'}`, retryable: false };
+                            return;
+                        }
+                        break;
+                    }
+                }
+            }
+            finally {
+                req.signal?.removeEventListener('abort', stop);
+            }
+        }
+        catch (err) {
+            if (!req.signal?.aborted)
+                yield { type: 'error', message: messageOf(err), retryable: false };
+            return;
+        }
+        finally {
+            connection?.close();
+        }
+        yield { type: 'message_end', stopReason: 'end_turn', ...(usage ? { usage } : {}) };
+    }
+    async countTokens(req) {
+        let text = req.system ?? '';
+        let nonTextBlocks = 0;
+        for (const message of req.messages) {
+            for (const block of message.content) {
+                if (block.type === 'text')
+                    text += block.text;
+                else
+                    nonTextBlocks += 1;
+            }
+        }
+        for (const tool of req.tools ?? [])
+            text += tool.name + tool.description;
+        return estimateTextTokens(text) + nonTextBlocks * NON_TEXT_BLOCK_TOKENS;
+    }
+    /** The conversation's running Codex, or a new one (resuming its thread) when there is none that fits. */
+    async lease(req) {
+        const settings = {
+            start: this.start,
+            cwd: req.cwd,
+            ...(req.model ? { model: req.model } : {}),
+            tools: req.allTools ?? req.tools,
+            ...(req.skills ? { skills: req.skills } : {}),
+            ...(req.resumeSessionId ? { resume: req.resumeSessionId } : {}),
+            onAgentTurn: (name, workId) => this.sessions().agentTurn({ sessionId: req.sessionId, name, ...(workId ? { workId } : {}) }),
+            onActivity: (events) => this.sessions().activity({ sessionId: req.sessionId, events }),
+        };
+        const sessions = this.sessions();
+        const create = () => CodexAgentSession.start(settings);
+        const lease = await sessions.acquire(req.sessionId, { signal: req.signal, create });
+        if (lease.session.isAlive && lease.session.fits(settings))
+            return lease;
+        await lease.discard();
+        return sessions.acquire(req.sessionId, { signal: req.signal, create });
+    }
+}
+export function createCodexAgentClient(config = {}) {
+    return new CodexAgentProvider(config);
+}
+function messageOf(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=agent-provider.js.map

package/dist/agent-provider.js.map

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

package/dist/codex-session.d.ts

@@ -0,0 +1,220 @@
+import type { Readable, Writable } from 'node:stream';
+import type { AgentStepEvent, AgentStepRequest, Skill, ToolDef } from '@moxxy/sdk';
+import { type LiveSession } from '@moxxy/agent-connection-kit';
+import type { CodexApprovalPolicy, CodexSandboxPolicy } from './protocol.js';
+/** A running `codex app-server`: its stdout, stdin and stderr. */
+export interface CodexConnection {
+    readonly readable: Readable;
+    readonly writable: Writable;
+    readonly stderr?: Readable;
+    close(): void;
+}
+export type StartCodexAppServer = (opts: {
+    readonly cwd: string;
+}) => Promise<CodexConnection>;
+export interface CodexSessionSettings {
+    readonly start: StartCodexAppServer;
+    readonly cwd: string;
+    /** The conversation's Codex thread from an earlier process, to resume. */
+    readonly resume?: string;
+    /**
+     * The model the turn runs. The thread opens on it: one opened on the config's
+     * model and switched before the turn carries Codex's model-switch
+     * instructions in every request after.
+     */
+    readonly model?: string;
+    /** Every Moxxy tool of the conversation: Codex reads the list once, as the thread opens or resumes. */
+    readonly tools?: ReadonlyArray<ToolDef>;
+    /** The conversation's Moxxy skills: Codex reads those meant for it through one more Moxxy tool, listed with the tools. */
+    readonly skills?: ReadonlyArray<Skill>;
+    /** Work Codex left running ended while no Moxxy turn runs; `name` says what, `workId` which work. Codex itself starts no turn then. */
+    readonly onAgentTurn?: (name: string, workId?: string) => void;
+    /** What Codex's background work did, for the conversation to record at once: its list, a command's end, a subagent's steps after its turn. */
+    readonly onActivity?: (events: ReadonlyArray<AgentStepEvent>) => void;
+}
+interface Policy {
+    readonly approvalPolicy: CodexApprovalPolicy;
+    readonly sandbox: CodexSandboxPolicy;
+}
+export declare function isAuto(policy: Policy): boolean;
+export declare function toolsLentToCodex(tools: ReadonlyArray<ToolDef>): ToolDef[];
+/**
+ * One running `codex app-server` with one thread for one Moxxy conversation.
+ * Every message the person sends is the next turn of the same thread, so
+ * Codex keeps its context, tools and goal between turns. Codex's
+ * notifications and its requests to Moxxy (approvals, questions) and Moxxy
+ * tool calls over MCP are queued together and handled in order, so the log
+ * shows a call before the decision about it.
+ */
+export declare class CodexAgentSession implements LiveSession {
+    readonly settings: CodexSessionSettings;
+    private readonly mcp;
+    private readonly connection;
+    private readonly inbox;
+    private readonly client;
+    private alive;
+    private closed;
+    private inTurn;
+    /**
+     * The conversation has not been told how Codex runs yet. Only a thread
+     * started for it does that: a conversation going on keeps the auto-approve
+     * the person chose, which a new process resuming the thread knows nothing of.
+     */
+    private fresh;
+    private threadId;
+    /** How the person's Codex config runs the thread; restored when Moxxy no longer overrides it. */
+    private original;
+    private originalTier;
+    private originalReviewer;
+    /** `model_reasoning_summary` from the person's config: `null` unset, `undefined` unread. */
+    private ownSummary;
+    private current;
+    /** Why the person declined, for Codex's next message when its turn could not take it. */
+    private pendingNotes;
+    /** The question Codex asked while it works, open until answered, closed, or its turn ends. */
+    private asked;
+    /** The thread is new while the conversation may already have run: its first message carries the conversation so far. */
+    private newThread;
+    private goal;
+    /**
+     * How Codex asks while auto-approve is off: ASKING on a Codex set up to run
+     * without asking, else the person's own setup, or tighter if something
+     * outside Moxxy tightened it since (Moxxy never loosens that back by itself).
+     */
+    private asking;
+    /** Something outside Moxxy made Codex ask while auto-approve was on; the switch shows it on the next turn. */
+    private turnedOffElsewhere;
+    /** Moxxy set back a change made outside it between turns; the next turn says so. */
+    private restoredElsewhere;
+    /** Codex turns that belong to the Moxxy turn running now. */
+    private readonly myTurns;
+    /** The Codex turn each command still running started in, by item id: what Stop ends. */
+    private readonly commandTurns;
+    /** Subagents Codex started; they work in threads of their own and may outlive a turn. */
+    private readonly subagents;
+    /** Calls Codex left running when its turn ended, by item id; their end is shown when it comes. */
+    private readonly leftRunning;
+    /** What that work did after its turn, for the turn opened to show it (or the person's next turn). */
+    private late;
+    /** A turn was asked of the conversation to show what finished after Codex's turn. */
+    private agentTurnPending;
+    /** The background work last reported, to report it again only when it changes. */
+    private shownWork;
+    /** Background work the person stopped: its end is recorded, but asks no turn of the conversation. */
+    private readonly stopping;
+    /** The Moxxy tools Codex listed as the thread opened, the same for every turn. */
+    private listed;
+    /** Names of Codex's own skills, read as the thread opens. */
+    private ownSkills;
+    /** Codex's own MCP servers that are on: Moxxy's server of the same name is left to Codex's. */
+    private ownMcpServers;
+    /** The Moxxy skills Codex listed with the tools; their instructions are read fresh at each call. */
+    private offered;
+    private activeTurn;
+    private lastError;
+    private lastErrorInfo;
+    /** The account limit Codex last reported; its updates leave out what has not changed. */
+    private limit;
+    private stderr;
+    static start(settings: CodexSessionSettings): Promise<CodexAgentSession>;
+    private constructor();
+    get isAlive(): boolean;
+    /**
+     * Whether this Codex was started where the turn runs (a running thread
+     * cannot move) and listed the tools the conversation has now: Codex reads
+     * them only as a thread opens, so other tools mean resuming it in a new Codex.
+     */
+    fits(settings: Pick<CodexSessionSettings, 'cwd' | 'tools' | 'skills'>): boolean;
+    private lent;
+    private skillsFor;
+    turn(req: AgentStepRequest): AsyncGenerator<AgentStepEvent>;
+    /** Stop one work Codex runs in the background (`AgentBackgroundWork.id`); `false` when Codex runs no such work. */
+    stopWork(workId: string): Promise<boolean>;
+    close(): Promise<void>;
+    /** Codex's own skills that are switched on: a Moxxy skill of the same name is left to Codex's. */
+    private ownSkillNames;
+    private open;
+    /** What the thread should run with for this turn's mode, model and auto-approve. */
+    private wanted;
+    /** Change on the thread only what differs; nothing is written to the person's Codex config. */
+    private apply;
+    /** Start the turn: a goal Codex works on by itself, or the person's message. */
+    private begin;
+    private startTurn;
+    private clearGoal;
+    /** Read Codex until the Moxxy turn is over: its turn ended, or its goal stopped running. */
+    private read;
+    /**
+     * Show Codex's question at once and let Codex work on: Codex asks in a
+     * message and does not wait, so the answer goes into its running turn, or
+     * waits for its turn to end when it ended on the question.
+     */
+    private askWhileWorking;
+    /**
+     * The person's answer goes into Codex's running turn once Codex has gone on
+     * from the question; until then Codex may still end its turn on it, and the
+     * answer is its next message. A question closed unanswered is let go.
+     */
+    private steerAnswer;
+    /** What Codex asked of Moxxy, answered with the turn's host. */
+    private answer;
+    private decide;
+    /**
+     * Codex's answer to an approval is a bare `decline`, so the person's reason
+     * goes into its running turn (`turn/steer`), or its next message when the
+     * turn can no longer take input.
+     */
+    private explainDecline;
+    private steerPending;
+    private interrupt;
+    /**
+     * Codex leaves an interrupted turn's commands running, so Stop ends the ones
+     * these turns started. What an earlier turn left running (a dev server) is
+     * not this turn's to stop.
+     */
+    private endCommandsOf;
+    /** End the command a call left running, found by the item that started it; `false` when no such command runs. */
+    private terminateCommand;
+    /** End every background command of the thread whose item `pick` chooses; how many it ended. */
+    private terminateWhere;
+    /** Which Codex turn started each command, noted as Codex reports it, ahead of the turn reading it. */
+    private noteCommand;
+    private belongsHere;
+    private onNotification;
+    /**
+     * A change of the thread's approvals made without Moxxy (another client, a
+     * hook): only the person loosens them. A change that holds Codex back at
+     * least as much is `kept` (`turned-off` when auto-approve was on), a looser
+     * one is `loosened` and set back. Codex reports Moxxy's own changes too; those
+     * match what Moxxy set and are passed over.
+     */
+    private noteSettings;
+    /** Put the thread's approvals back as Moxxy last set them. */
+    private restore;
+    /**
+     * Between turns: what Codex's background work does. Codex starts no turn
+     * when it ends (0.155.1), so the conversation is asked for one to show it:
+     * a subagent's tools and answer, a command's output.
+     */
+    private noteLate;
+    /**
+     * The end of a call Codex left running, as a call of its own beside the one
+     * shown running; `undefined` for anything else. Its end is recorded for the
+     * agents panel at once, with what the command printed last.
+     */
+    private endOfLeftRunning;
+    private askForTurn;
+    /** What Codex runs in the background now: the commands its turns left running and the subagents still working. Reported when it changes. */
+    private reportWork;
+    private workNow;
+    private report;
+    private takeLate;
+    /** Keep the goal's state, whether or not a turn is reading. */
+    private noteGoal;
+    private ended;
+    private endedMessage;
+    /** Answer whatever is still queued once no turn can: Codex must never wait on Moxxy forever. */
+    private dismissQueued;
+}
+export {};
+//# sourceMappingURL=codex-session.d.ts.map

package/dist/codex-session.d.ts.map

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