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

package/dist/own-settings.js

@@ -0,0 +1,34 @@
+/**
+ * How the person's own Codex runs, read without starting a thread: a
+ * short-lived `codex app-server` answers `config/read` for the folder (the
+ * effective config, profiles and project config included) and is closed.
+ */
+import { JsonRpcLineClient } from '@moxxy/agent-connection-kit';
+/** Codex answers in well under a second; one stuck on startup is not waited on longer. */
+const OWN_SETTINGS_TIMEOUT_MS = 15_000;
+/**
+ * Whether the person's own Codex runs in `cwd` with no approvals and full
+ * access, as Moxxy's auto-approve does; `undefined` when Codex cannot say.
+ */
+export async function codexOwnAutoApprove(cwd, start, opts = {}) {
+    let connection;
+    let client;
+    const timer = setTimeout(() => client?.close(new Error('Codex did not answer in time.')), opts.timeoutMs ?? OWN_SETTINGS_TIMEOUT_MS);
+    try {
+        connection = await start({ cwd });
+        client = new JsonRpcLineClient({ readable: connection.readable, writable: connection.writable });
+        await client.request('initialize', { clientInfo: { name: 'moxxy', title: 'Moxxy', version: '1' }, capabilities: { experimentalApi: true } });
+        client.notify('initialized');
+        const { config } = await client.request('config/read', { cwd });
+        return config.approval_policy === 'never' && config.sandbox_mode === 'danger-full-access';
+    }
+    catch {
+        return undefined;
+    }
+    finally {
+        clearTimeout(timer);
+        client?.close();
+        connection?.close();
+    }
+}
+//# sourceMappingURL=own-settings.js.map

package/dist/own-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"own-settings.js","sourceRoot":"","sources":["../src/own-settings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAIhE,0FAA0F;AAC1F,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAEvC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,GAAW,EACX,KAA0B,EAC1B,OAAwC,EAAE;IAE1C,IAAI,UAAgE,CAAC;IACrE,IAAI,MAAqC,CAAC;IAC1C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,IAAI,uBAAuB,CAAC,CAAC;IACrI,IAAI,CAAC;QACH,UAAU,GAAG,MAAM,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QAClC,MAAM,GAAG,IAAI,iBAAiB,CAAC,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;QACjG,MAAM,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,YAAY,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QAC7I,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAC7B,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAkB,aAAa,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QACjF,OAAO,MAAM,CAAC,eAAe,KAAK,OAAO,IAAI,MAAM,CAAC,YAAY,KAAK,oBAAoB,CAAC;IAC5F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,MAAM,EAAE,KAAK,EAAE,CAAC;QAChB,UAAU,EAAE,KAAK,EAAE,CAAC;IACtB,CAAC;AACH,CAAC"}

package/dist/protocol.d.ts

@@ -0,0 +1,279 @@
+/**
+ * The part of the `codex app-server` protocol Moxxy speaks, written by hand
+ * from `codex app-server generate-ts` (0.155.1, checked against 0.163.0). Codex sends far more than
+ * this; anything not listed here is read as unknown and left alone.
+ */
+export type CodexApprovalPolicy = 'untrusted' | 'on-request' | 'never' | {
+    readonly granular: Readonly<Record<string, boolean>>;
+};
+export type CodexSandboxPolicy = {
+    readonly type: 'dangerFullAccess';
+} | {
+    readonly type: 'readOnly';
+    readonly networkAccess?: boolean;
+} | {
+    readonly type: 'workspaceWrite';
+    readonly [key: string]: unknown;
+} | {
+    readonly type: 'externalSandbox';
+    readonly [key: string]: unknown;
+};
+/** The thread's settings in `thread/settings/updated` (only what Moxxy reads). */
+export interface CodexThreadSettingsReport {
+    readonly approvalPolicy: CodexApprovalPolicy;
+    readonly approvalsReviewer: CodexApprovalsReviewer;
+    readonly sandboxPolicy: CodexSandboxPolicy;
+}
+/** What `thread/start` and `thread/resume` answer: the thread as Codex really runs it. */
+export interface CodexThreadResponse {
+    readonly thread: {
+        readonly id: string;
+    };
+    readonly model: string;
+    readonly approvalPolicy: CodexApprovalPolicy;
+    readonly sandbox: CodexSandboxPolicy;
+    readonly approvalsReviewer?: CodexApprovalsReviewer;
+    readonly reasoningEffort: string | null;
+    readonly serviceTier?: string | null;
+}
+/** Who answers Codex's approvals: the person, or Codex's own reviewer. */
+export type CodexApprovalsReviewer = 'user' | 'auto_review' | 'guardian_subagent';
+/** What `config/read` answers: the person's effective Codex config, as far as Moxxy reads it. */
+/** The person's Codex config as `config/read` reports it for the folder (only what Moxxy reads). */
+/** `skills/list`: the skills Codex has where each folder asked for runs (generated `SkillsListResponse`, fields Moxxy reads). */
+export interface CodexSkillsList {
+    readonly data: ReadonlyArray<{
+        readonly cwd: string;
+        readonly skills: ReadonlyArray<{
+            readonly name: string;
+            readonly description: string;
+            readonly enabled: boolean;
+        }>;
+    }>;
+}
+/**
+ * `thread/backgroundTerminals/list` (experimental, 0.155.1 and later): the
+ * commands still running in a thread, by the item that started them. An
+ * interrupted turn's commands stay here until `terminate` ends them.
+ */
+export interface CodexBackgroundTerminals {
+    readonly data: ReadonlyArray<{
+        readonly itemId: string;
+        readonly processId: string;
+    }>;
+    readonly nextCursor: string | null;
+}
+export interface CodexConfigRead {
+    readonly config: {
+        readonly model_reasoning_summary?: string | null;
+        readonly approval_policy?: CodexApprovalPolicy | null;
+        readonly sandbox_mode?: 'read-only' | 'workspace-write' | 'danger-full-access' | null;
+        readonly sandbox_workspace_write?: {
+            readonly writable_roots: ReadonlyArray<string>;
+            readonly network_access: boolean;
+            readonly exclude_tmpdir_env_var: boolean;
+            readonly exclude_slash_tmp: boolean;
+        } | null;
+        readonly approvals_reviewer?: CodexApprovalsReviewer | null;
+        readonly tools?: {
+            readonly update_plan?: {
+                readonly enabled?: boolean;
+            } | null;
+        } | null;
+        /** The person's own MCP servers, by name. */
+        readonly mcp_servers?: Readonly<Record<string, {
+            readonly enabled?: boolean;
+        }>> | null;
+    };
+}
+/** `model/list`: one page of the models Codex offers the account (generated `ModelListResponse`, fields Moxxy reads). */
+export interface CodexModelList {
+    readonly data: ReadonlyArray<{
+        readonly id: string;
+        readonly hidden?: boolean;
+        readonly inputModalities?: ReadonlyArray<string>;
+        readonly supportedReasoningEfforts?: ReadonlyArray<unknown>;
+        readonly additionalSpeedTiers?: ReadonlyArray<string>;
+    }>;
+    readonly nextCursor?: string | null;
+}
+export type CodexUserInput = {
+    readonly type: 'text';
+    readonly text: string;
+    readonly text_elements: ReadonlyArray<never>;
+} | {
+    readonly type: 'image';
+    readonly url: string;
+} | {
+    readonly type: 'localImage';
+    readonly path: string;
+};
+export type CodexCollaborationMode = {
+    readonly mode: 'plan' | 'default';
+    readonly settings: {
+        readonly model: string;
+        readonly reasoning_effort: string | null;
+        readonly developer_instructions: null;
+    };
+};
+/** Fields of `thread/settings/update`; each applies to the thread's later turns. */
+export interface CodexThreadSettings {
+    readonly approvalPolicy?: CodexApprovalPolicy;
+    readonly sandboxPolicy?: CodexSandboxPolicy;
+    readonly model?: string;
+    readonly effort?: string;
+    readonly collaborationMode?: CodexCollaborationMode;
+}
+export type CodexTurnStatus = 'completed' | 'interrupted' | 'failed' | 'inProgress';
+export interface CodexTurn {
+    readonly id: string;
+    readonly status: CodexTurnStatus;
+    /** `codexErrorInfo` is Codex's code for the failure: a string (`usageLimitExceeded`) or an object for some. */
+    readonly error?: {
+        readonly message: string;
+        readonly codexErrorInfo?: unknown;
+    } | null;
+}
+/** `resetsAt` is in epoch seconds. */
+export interface CodexRateLimitWindow {
+    readonly usedPercent: number;
+    readonly windowDurationMins: number | null;
+    readonly resetsAt: number | null;
+}
+/** `account/rateLimits/updated`: a sparse update, where a missing window keeps the one seen before. */
+export interface CodexRateLimitSnapshot {
+    readonly primary?: CodexRateLimitWindow | null;
+    readonly secondary?: CodexRateLimitWindow | null;
+    readonly rateLimitReachedType?: string | null;
+}
+export type CodexGoalStatus = 'active' | 'paused' | 'blocked' | 'usageLimited' | 'budgetLimited' | 'complete';
+export interface CodexGoal {
+    readonly objective: string;
+    readonly status: CodexGoalStatus;
+}
+/** A question Codex's plan mode asks inside its message (`delivery: 'async'`). */
+export interface CodexAsyncQuestion {
+    readonly title: string;
+    readonly options: ReadonlyArray<string> | null;
+}
+export type CodexItem = {
+    readonly type: 'agentMessage';
+    readonly id: string;
+    readonly text: string;
+    readonly phase?: string | null;
+    readonly delivery?: 'async' | null;
+    readonly questions?: ReadonlyArray<CodexAsyncQuestion> | null;
+} | {
+    readonly type: 'plan';
+    readonly id: string;
+    readonly text: string;
+} | {
+    readonly type: 'reasoning';
+    readonly id: string;
+    readonly summary: ReadonlyArray<string>;
+    readonly content: ReadonlyArray<string>;
+} | {
+    readonly type: 'commandExecution';
+    readonly id: string;
+    readonly command: string;
+    readonly cwd: string;
+    readonly status: string;
+    readonly aggregatedOutput: string | null;
+    readonly exitCode: number | null;
+    readonly commandActions?: ReadonlyArray<{
+        readonly command?: string;
+    }>;
+} | {
+    readonly type: 'fileChange';
+    readonly id: string;
+    readonly status: string;
+    readonly changes: ReadonlyArray<CodexFileChange>;
+} | {
+    readonly type: 'mcpToolCall';
+    readonly id: string;
+    readonly server: string;
+    readonly tool: string;
+    readonly status: string;
+    readonly arguments: unknown;
+    readonly result: unknown;
+    readonly error: {
+        readonly message: string;
+    } | null;
+} | {
+    readonly type: 'webSearch';
+    readonly id: string;
+    readonly query: string;
+    readonly action?: CodexWebSearchAction | null;
+} | {
+    readonly type: 'imageView';
+    readonly id: string;
+    readonly path: string;
+} | {
+    readonly type: 'sleep';
+    readonly id: string;
+    readonly durationMs: number;
+} | {
+    readonly type: 'imageGeneration';
+    readonly id: string;
+    readonly status: string;
+    readonly revisedPrompt: string | null;
+    /** The picture, base64. */
+    readonly result: string;
+    readonly failure: {
+        readonly type: string;
+    } | null;
+    readonly savedPath?: string;
+};
+export type CodexWebSearchAction = {
+    readonly type: 'search';
+    readonly query?: string;
+    readonly queries?: ReadonlyArray<string>;
+} | {
+    readonly type: 'open_page';
+    readonly url?: string;
+} | {
+    readonly type: 'find_in_page';
+    readonly url?: string;
+    readonly pattern?: string;
+} | {
+    readonly type: 'other';
+};
+/** One file of a `fileChange`: for `add` the diff is the new content, for `update` a unified diff; `move_path` names where an update moved it. */
+export interface CodexFileChange {
+    readonly path: string;
+    readonly kind: {
+        readonly type: string;
+        readonly move_path?: string | null;
+    };
+    readonly diff?: string;
+}
+/** Items Moxxy leaves out of the chat on purpose, and why. Every other kind shows: one Moxxy does not know, as a call named after it. */
+export declare const CODEX_ITEMS_LEFT_OUT: Readonly<Record<string, string>>;
+/** An item Moxxy reads, or `undefined` for one it shows as a plain call or leaves out. */
+export declare function knownItem(value: unknown): CodexItem | undefined;
+/** An item of a kind Moxxy neither reads nor leaves out: its fields, without the id, kind and status. */
+export interface CodexOtherItem {
+    readonly type: string;
+    readonly id: string;
+    readonly status?: string;
+    readonly fields: Readonly<Record<string, unknown>>;
+}
+export declare function otherItem(value: unknown): CodexOtherItem | undefined;
+export interface CodexTokenUsage {
+    readonly inputTokens: number;
+    readonly cachedInputTokens: number;
+    readonly outputTokens: number;
+}
+/** `item/tool/requestUserInput` (experimental): a blocking question with ids. */
+export interface CodexUserInputQuestion {
+    readonly id: string;
+    readonly header: string;
+    readonly question: string;
+    readonly isOther: boolean;
+    readonly isSecret: boolean;
+    readonly options: ReadonlyArray<{
+        readonly label: string;
+        readonly description: string;
+    }> | null;
+}
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

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

package/dist/protocol.js

@@ -0,0 +1,30 @@
+/**
+ * The part of the `codex app-server` protocol Moxxy speaks, written by hand
+ * from `codex app-server generate-ts` (0.155.1, checked against 0.163.0). Codex sends far more than
+ * this; anything not listed here is read as unknown and left alone.
+ */
+const KNOWN_ITEMS = new Set(['agentMessage', 'plan', 'reasoning', 'commandExecution', 'fileChange', 'mcpToolCall', 'webSearch', 'imageView', 'sleep', 'imageGeneration']);
+/** Items Moxxy leaves out of the chat on purpose, and why. Every other kind shows: one Moxxy does not know, as a call named after it. */
+export const CODEX_ITEMS_LEFT_OUT = {
+    userMessage: "the person's own message, which Moxxy already shows",
+    hookPrompt: "text the person's Codex hooks add to the prompt, not something Codex did",
+    contextCompaction: "Codex shortening its own context; Moxxy's record of the conversation stays whole",
+    collabAgentToolCall: "Codex starting, waiting on or messaging its subagents, which their own rows show",
+    subAgentActivity: 'shown as the subagent row, read before the turn items',
+};
+/** An item Moxxy reads, or `undefined` for one it shows as a plain call or leaves out. */
+export function knownItem(value) {
+    if (typeof value !== 'object' || value === null)
+        return undefined;
+    const { type, id } = value;
+    return typeof type === 'string' && typeof id === 'string' && KNOWN_ITEMS.has(type) ? value : undefined;
+}
+export function otherItem(value) {
+    if (typeof value !== 'object' || value === null || knownItem(value))
+        return undefined;
+    const { type, id, status, ...fields } = value;
+    if (typeof type !== 'string' || typeof id !== 'string' || type in CODEX_ITEMS_LEFT_OUT)
+        return undefined;
+    return { type, id, ...(typeof status === 'string' ? { status } : {}), fields };
+}
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA4MH,MAAM,WAAW,GAAG,IAAI,GAAG,CAAS,CAAC,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,kBAAkB,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC;AAElL,yIAAyI;AACzI,MAAM,CAAC,MAAM,oBAAoB,GAAqC;IACpE,WAAW,EAAE,qDAAqD;IAClE,UAAU,EAAE,0EAA0E;IACtF,iBAAiB,EAAE,kFAAkF;IACrG,mBAAmB,EAAE,kFAAkF;IACvG,gBAAgB,EAAE,uDAAuD;CAC1E,CAAC;AAEF,0FAA0F;AAC1F,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAClE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,KAAyC,CAAC;IAC/D,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,KAAmB,CAAC,CAAC,CAAC,SAAS,CAAC;AACxH,CAAC;AAUD,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,SAAS,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACtF,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,KAAgC,CAAC;IACzE,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,IAAI,IAAI,oBAAoB;QAAE,OAAO,SAAS,CAAC;IACzG,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,CAAC,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;AACjF,CAAC"}

package/dist/subagents.d.ts

@@ -0,0 +1,20 @@
+import type { AgentBackgroundWork, AgentStepEvent } from '@moxxy/sdk';
+/**
+ * Codex's subagents. Codex announces one with a `subAgentActivity` item on the conversation's
+ * thread and runs it in a thread of its own; its tool calls and answer come from that thread.
+ * They outlive a Moxxy turn, so the session keeps them.
+ */
+export declare class CodexSubagents {
+    private readonly agents;
+    /** A `subAgentActivity` item on the conversation's thread. */
+    activity(item: unknown): AgentStepEvent[];
+    /** A notification from a thread other than the conversation's: a subagent's work, if it is one. */
+    fromThread(method: string, params: Record<string, unknown>): AgentStepEvent[];
+    /** The subagents still working, as background work. */
+    running(): AgentBackgroundWork[];
+    /** The turn running in a working subagent's thread, if any. */
+    turnOf(id: string): string | undefined;
+}
+/** "/root/inspect_folder" → "inspect folder". */
+export declare function labelOf(path: unknown): string;
+//# sourceMappingURL=subagents.d.ts.map

package/dist/subagents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagents.d.ts","sourceRoot":"","sources":["../src/subagents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAatE;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;IAErD,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,EAAE;IAezC,mGAAmG;IACnG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,EAAE;IAgC7E,uDAAuD;IACvD,OAAO,IAAI,mBAAmB,EAAE;IAIhC,+DAA+D;IAC/D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAIvC;AAaD,iDAAiD;AACjD,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAG7C"}

package/dist/subagents.js

@@ -0,0 +1,90 @@
+import { toolCallOf } from './translate.js';
+/**
+ * Codex's subagents. Codex announces one with a `subAgentActivity` item on the conversation's
+ * thread and runs it in a thread of its own; its tool calls and answer come from that thread.
+ * They outlive a Moxxy turn, so the session keeps them.
+ */
+export class CodexSubagents {
+    agents = new Map();
+    /** A `subAgentActivity` item on the conversation's thread. */
+    activity(item) {
+        const a = (item ?? {});
+        if (typeof a.agentThreadId !== 'string')
+            return [];
+        const id = a.agentThreadId;
+        const known = this.agents.get(id);
+        if (a.kind === 'started') {
+            if (known)
+                return [];
+            const label = labelOf(a.agentPath);
+            this.agents.set(id, { label, text: '', tokens: undefined, done: false });
+            return [{ type: 'subagent_started', id, label, agentType: 'default' }];
+        }
+        if ((a.kind !== 'completed' && a.kind !== 'interrupted') || !known || known.done)
+            return [];
+        return [end(id, known, a.kind === 'interrupted')];
+    }
+    /** A notification from a thread other than the conversation's: a subagent's work, if it is one. */
+    fromThread(method, params) {
+        const id = typeof params.threadId === 'string' ? params.threadId : '';
+        const agent = this.agents.get(id);
+        if (!agent || agent.done)
+            return [];
+        if (method === 'turn/started' || method === 'turn/completed') {
+            const turn = params.turn;
+            if (method === 'turn/started') {
+                if (typeof turn?.id === 'string')
+                    agent.turn = turn.id;
+                return [];
+            }
+            delete agent.turn;
+            // Between the conversation's turns Codex reports a stopped subagent only here.
+            return turn?.status === 'interrupted' ? [end(id, agent, true)] : [];
+        }
+        if (method === 'thread/tokenUsage/updated') {
+            const total = params.tokenUsage?.total;
+            if (total && typeof total.totalTokens === 'number')
+                agent.tokens = total.totalTokens;
+            return [];
+        }
+        if (method !== 'item/completed')
+            return [];
+        const item = params.item;
+        if (!item)
+            return [];
+        if (item.type === 'agentMessage') {
+            if (!item.text)
+                return [];
+            agent.text = item.text;
+            // The final answer shows as the subagent's answer when it ends.
+            return item.phase === 'final_answer' ? [] : [{ type: 'subagent_message', id, text: item.text }];
+        }
+        const call = toolCallOf(item);
+        return call ? [{ type: 'subagent_tool_call', id, name: call.name, input: call.input }] : [];
+    }
+    /** The subagents still working, as background work. */
+    running() {
+        return [...this.agents].flatMap(([id, agent]) => (agent.done ? [] : [{ id, kind: 'agent', label: agent.label }]));
+    }
+    /** The turn running in a working subagent's thread, if any. */
+    turnOf(id) {
+        const agent = this.agents.get(id);
+        return agent && !agent.done ? agent.turn : undefined;
+    }
+}
+function end(id, agent, stopped) {
+    agent.done = true;
+    return {
+        type: 'subagent_completed',
+        id,
+        text: agent.text,
+        ...(agent.tokens !== undefined ? { tokensUsed: agent.tokens } : {}),
+        ...(stopped ? { error: 'The subagent was stopped.', stopped: true } : {}),
+    };
+}
+/** "/root/inspect_folder" → "inspect folder". */
+export function labelOf(path) {
+    const last = typeof path === 'string' ? path.split('/').filter(Boolean).pop() : undefined;
+    return last ? last.replace(/[_-]+/g, ' ') : 'subagent';
+}
+//# sourceMappingURL=subagents.js.map

package/dist/subagents.js.map

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

package/dist/translate.d.ts

@@ -0,0 +1,87 @@
+import type { AgentStepEvent, ContentBlock, QuestionAnswers, QuestionItem, TokenUsage, ToolImage } from '@moxxy/sdk';
+import { type CodexAsyncQuestion, type CodexItem, type CodexTokenUsage, type CodexUserInput, type CodexUserInputQuestion } from './protocol.js';
+/** Questions Codex asked in its message `itemId`. */
+export interface CodexAskedQuestions {
+    readonly itemId: string;
+    readonly questions: ReadonlyArray<CodexAsyncQuestion>;
+}
+/** A tool Codex runs itself, as Moxxy names it (`Bash` so Moxxy's shell rules and formatting apply). */
+export interface CodexToolCall {
+    readonly name: string;
+    readonly input: unknown;
+}
+/**
+ * Codex's notifications for one Moxxy turn, as Moxxy agent events. Calls to
+ * Moxxy's own tools are left out: Moxxy records those when it runs them.
+ */
+export declare class TurnTranslator {
+    private readonly cwd;
+    private readonly readImage;
+    private readonly announced;
+    private readonly calls;
+    /** Items that started and have not ended yet. */
+    private readonly running;
+    /** Plan updates shown this turn; each is a call of its own. */
+    private plans;
+    /** Questions Codex just asked in a message, until the session takes them. */
+    private asked;
+    /** The item Codex is on: the last one it started or finished. */
+    private latestItem;
+    /** Codex's last message so far. */
+    private latestMessage;
+    /**
+     * `cwd`: the project folder, which the paths of file diffs are shown relative to.
+     * `readImage`: the picture at a path, for an image Codex viewed (it names only the file).
+     */
+    constructor(cwd?: string, readImage?: (path: string) => ToolImage | undefined);
+    /** Show a call before Moxxy decides on it, unless it is already shown. */
+    announce(callId: string, call: CodexToolCall): AgentStepEvent[];
+    /**
+     * What Codex left running as its turn ended (a command in the background):
+     * shown as still running, and handed back so its end can be shown when it comes.
+     */
+    leftRunning(): {
+        readonly events: AgentStepEvent[];
+        readonly calls: ReadonlyMap<string, CodexToolCall>;
+    };
+    /** The questions Codex just asked in a message (`delivery: 'async'`), handed out once. */
+    takeQuestions(): CodexAskedQuestions | undefined;
+    /** Codex started or finished another item since `itemId`: it works on without waiting. */
+    movedOnFrom(itemId: string): boolean;
+    /** Message `itemId` is the last thing Codex said. */
+    lastSaid(itemId: string): boolean;
+    /** The call shown for an item, for an approval that names only the item. */
+    callOf(callId: string): CodexToolCall | undefined;
+    translate(method: string, params: unknown): AgentStepEvent[];
+    private noteItem;
+    /**
+     * Codex's checklist (its `update_plan` tool) as it stands after a change.
+     * Codex reports it as a notification, not an item, so it is shown as a call
+     * of its own; the plan of plan mode is a `plan` item instead.
+     */
+    private planUpdated;
+    /**
+     * An item of a kind Moxxy does not know (one a newer Codex added), shown as
+     * a call named after it: what Codex said as it started, and what it added by the end.
+     */
+    private otherCompleted;
+    private completed;
+}
+export declare function toolCallOf(item: CodexItem): CodexToolCall | undefined;
+/** The command as the person would type it: Codex wraps it in `<shell> -lc '…'`. */
+export declare function shownCommand(command: string): string;
+/** Codex counts cached prompt tokens inside `inputTokens`; Moxxy keeps them apart. */
+export declare function toTokenUsage(usage: CodexTokenUsage): TokenUsage;
+/** The person's message as Codex input: text as it is, images inline. */
+export declare function toCodexInput(prompt: ReadonlyArray<ContentBlock>): CodexUserInput[];
+export declare function promptText(prompt: ReadonlyArray<ContentBlock>): string;
+/** Codex plan-mode questions as Moxxy Questions. Codex takes any text back, so an own answer always fits. */
+export declare function fromAsyncQuestions(questions: ReadonlyArray<CodexAsyncQuestion>): QuestionItem[];
+/** The answers as the next message Codex reads: one `question: answer` line each. */
+export declare function answersMessage(items: ReadonlyArray<QuestionItem>, answers: QuestionAnswers): string;
+/** `item/tool/requestUserInput` questions as Moxxy Questions. */
+export declare function fromUserInputQuestions(questions: ReadonlyArray<CodexUserInputQuestion>): QuestionItem[];
+export declare function toUserInputAnswers(items: ReadonlyArray<QuestionItem>, answers: QuestionAnswers): Record<string, {
+    answers: string[];
+}>;
+//# sourceMappingURL=translate.d.ts.map

package/dist/translate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate.d.ts","sourceRoot":"","sources":["../src/translate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAmB,eAAe,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGtI,OAAO,EAGL,KAAK,kBAAkB,EAEvB,KAAK,SAAS,EAEd,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAE5B,MAAM,eAAe,CAAC;AAIvB,qDAAqD;AACrD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;CACvD;AAED,wGAAwG;AACxG,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED;;;GAGG;AACH,qBAAa,cAAc;IAmBvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAnB5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;IAC1D,iDAAiD;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,+DAA+D;IAC/D,OAAO,CAAC,KAAK,CAAK;IAClB,6EAA6E;IAC7E,OAAO,CAAC,KAAK,CAAkC;IAC/C,iEAAiE;IACjE,OAAO,CAAC,UAAU,CAAqB;IACvC,mCAAmC;IACnC,OAAO,CAAC,aAAa,CAAqB;IAE1C;;;OAGG;gBAEgB,GAAG,SAAK,EACR,SAAS,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,GAAG,SAA2B;IAGvF,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,cAAc,EAAE;IAO/D;;;OAGG;IACH,WAAW,IAAI;QAAE,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;KAAE;IAOxG,0FAA0F;IAC1F,aAAa,IAAI,mBAAmB,GAAG,SAAS;IAMhD,0FAA0F;IAC1F,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIpC,qDAAqD;IACrD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIjC,4EAA4E;IAC5E,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIjD,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,cAAc,EAAE;IAsC5D,OAAO,CAAC,QAAQ;IAKhB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAiBnB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,SAAS;CAmBlB;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,aAAa,GAAG,SAAS,CAmBrE;AAwED,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED,sFAAsF;AACtF,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU,CAO/D;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,cAAc,EAAE,CAMlF;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,MAAM,CAEtE;AAED,6GAA6G;AAC7G,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,aAAa,CAAC,kBAAkB,CAAC,GAAG,YAAY,EAAE,CAQ/F;AAED,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM,CAInG;AAED,iEAAiE;AACjE,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,aAAa,CAAC,sBAAsB,CAAC,GAAG,YAAY,EAAE,CASvG;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAItI"}