@ai0x0/codex-ts 0.1.0

package/dist/core/src/session/turn.js

@@ -0,0 +1,178 @@
+/**
+ * mirrors codex-rs/core/src/session/turn.rs
+ *
+ * runTurn() — the core agent sampling loop:
+ *   1. Build Responses API request (history + tool specs)
+ *   2. Stream SSE response
+ *   3. Collect assistant text and function calls
+ *   4. Dispatch tool calls via ToolRouter
+ *   5. Emit side-effect events
+ *   6. Loop until the model produces no more tool calls
+ */
+import { toolSpecToRequestJson } from "../../../tools/src/tool_spec.js";
+// ─── SSE stream parser ────────────────────────────────────────────────────────
+async function* parseSseStream(body) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    try {
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            const lines = buffer.split("\n");
+            buffer = lines.pop() ?? "";
+            let dataLine = "";
+            for (const line of lines) {
+                if (line.startsWith("data: ")) {
+                    dataLine = line.slice(6).trim();
+                }
+                else if (line === "" && dataLine) {
+                    if (dataLine !== "[DONE]") {
+                        try {
+                            yield JSON.parse(dataLine);
+                        }
+                        catch {
+                            /* malformed JSON — skip */
+                        }
+                    }
+                    dataLine = "";
+                }
+            }
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+export async function runTurn(turnId, userItems, history, config, router, pendingInputs, emitEvent, liveThread) {
+    // Add user message to history (mutates the shared array)
+    const userContent = userItems
+        .map((item) => item.type === "text"
+        ? { type: "input_text", text: item.text }
+        : null)
+        .filter((x) => x !== null);
+    const userMsg = { role: "user", content: userContent };
+    history.push(userMsg);
+    await liveThread?.appendConversationItems([userMsg]);
+    const tools = router.toolSpecs().map(toolSpecToRequestJson);
+    let lastAgentMessage = "";
+    let itemIdCounter = 0;
+    for (;;) {
+        // ── Sample from the model ───────────────────────────────────────────────
+        const body = {
+            model: config.model,
+            input: history,
+            tools,
+            stream: true,
+        };
+        if (config.instructions)
+            body["instructions"] = config.instructions;
+        const res = await fetch(`${config.baseUrl}/responses`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${config.apiKey}`,
+            },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok || !res.body) {
+            const text = res.body ? await res.text() : "(no body)";
+            throw new Error(`Responses API ${res.status}: ${text}`);
+        }
+        // ── Parse SSE stream ────────────────────────────────────────────────────
+        const functionCalls = [];
+        const partialArgs = new Map();
+        let assistantText = "";
+        let currentItemId = `item-${++itemIdCounter}`;
+        for await (const raw of parseSseStream(res.body)) {
+            switch (raw["type"]) {
+                case "response.output_item.added": {
+                    const item = raw["item"];
+                    if (item?.["type"] === "function_call") {
+                        const cid = String(item["call_id"]);
+                        partialArgs.set(cid, { name: String(item["name"]), args: "" });
+                    }
+                    else if (item?.["type"] === "message") {
+                        currentItemId = String(item["id"] ?? currentItemId);
+                    }
+                    break;
+                }
+                case "response.output_text.delta": {
+                    const delta = String(raw["delta"] ?? "");
+                    assistantText += delta;
+                    emitEvent({
+                        type: "AgentMessageContentDelta",
+                        event: { turn_id: turnId, item_id: currentItemId, delta },
+                    });
+                    break;
+                }
+                case "response.function_call_arguments.delta": {
+                    const partial = partialArgs.get(String(raw["call_id"] ?? ""));
+                    if (partial)
+                        partial.args += String(raw["delta"] ?? "");
+                    break;
+                }
+                case "response.output_item.done": {
+                    const item = raw["item"];
+                    if (item?.["type"] === "function_call") {
+                        functionCalls.push({
+                            call_id: String(item["call_id"]),
+                            name: String(item["name"]),
+                            arguments: String(item["arguments"] ?? "{}"),
+                        });
+                    }
+                    break;
+                }
+            }
+        }
+        // ── Persist assistant message ────────────────────────────────────────────
+        if (assistantText) {
+            lastAgentMessage = assistantText;
+            const assistantItem = { role: "assistant", content: assistantText };
+            history.push(assistantItem);
+            await liveThread?.appendConversationItems([assistantItem]);
+            emitEvent({ type: "AgentMessage", event: { message: assistantText } });
+        }
+        // ── Persist function calls ───────────────────────────────────────────────
+        const callItems = functionCalls.map((call) => ({
+            type: "function_call",
+            call_id: call.call_id,
+            name: call.name,
+            arguments: call.arguments,
+        }));
+        for (const item of callItems) {
+            history.push(item);
+        }
+        if (callItems.length > 0)
+            await liveThread?.appendConversationItems(callItems);
+        // ── Done when no tool calls ─────────────────────────────────────────────
+        if (functionCalls.length === 0)
+            break;
+        // ── Dispatch tool calls ─────────────────────────────────────────────────
+        for (const call of functionCalls) {
+            let args;
+            try {
+                args = JSON.parse(call.arguments);
+            }
+            catch {
+                args = {};
+            }
+            const output = await router.dispatch(call.name, call.call_id, args, {
+                turnId,
+                pendingInputs,
+                emitEvent,
+            });
+            const outputItem = {
+                type: "function_call_output",
+                call_id: call.call_id,
+                output,
+            };
+            history.push(outputItem);
+            await liveThread?.appendConversationItems([outputItem]);
+        }
+    }
+    return { lastAgentMessage };
+}
+//# sourceMappingURL=turn.js.map

package/dist/core/src/session/turn.js.map

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

package/dist/core/src/tools/handlers/plan_spec.d.ts

@@ -0,0 +1,14 @@
+/**
+ * mirrors codex-rs/core/src/tools/handlers/plan_spec.rs
+ */
+import type { ToolSpec } from "../../../../tools/src/tool_spec.js";
+export declare const UPDATE_PLAN_TOOL_NAME = "update_plan";
+export declare function createUpdatePlanTool(): ToolSpec;
+export declare function parseUpdatePlanArgs(rawArgs: unknown): {
+    ok: true;
+    args: import("../../../../protocol/src/plan_tool.js").UpdatePlanArgs;
+} | {
+    ok: false;
+    error: string;
+};
+//# sourceMappingURL=plan_spec.d.ts.map

package/dist/core/src/tools/handlers/plan_spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan_spec.d.ts","sourceRoot":"","sources":["../../../../../core/src/tools/handlers/plan_spec.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAGnE,eAAO,MAAM,qBAAqB,gBAAgB,CAAC;AAEnD,wBAAgB,oBAAoB,IAAI,QAAQ,CA+B/C;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG;IACrD,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,OAAO,uCAAuC,EAAE,cAAc,CAAC;CACtE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA4B/B"}

package/dist/core/src/tools/handlers/plan_spec.js

@@ -0,0 +1,50 @@
+/**
+ * mirrors codex-rs/core/src/tools/handlers/plan_spec.rs
+ */
+import * as S from "../../../../tools/src/json_schema.js";
+export const UPDATE_PLAN_TOOL_NAME = "update_plan";
+export function createUpdatePlanTool() {
+    const planItemSchema = S.object({
+        step: S.string("Task step text."),
+        status: S.stringEnum(["pending", "in_progress", "completed"], "Step status."),
+    }, ["step", "status"], false);
+    return {
+        type: "function",
+        tool: {
+            name: UPDATE_PLAN_TOOL_NAME,
+            description: `Updates the task plan.
+Provide an optional explanation and a list of plan items, each with a step and status.
+At most one step can be in_progress at a time.`,
+            parameters: S.object({
+                explanation: S.string("Optional explanation for this plan update."),
+                plan: S.array(planItemSchema, "The list of steps"),
+            }, ["plan"], false),
+            strict: false,
+        },
+    };
+}
+export function parseUpdatePlanArgs(rawArgs) {
+    if (typeof rawArgs !== "object" || rawArgs === null) {
+        return { ok: false, error: "failed to parse function arguments: expected object" };
+    }
+    const obj = rawArgs;
+    if (!Array.isArray(obj["plan"])) {
+        return { ok: false, error: "failed to parse function arguments: plan must be an array" };
+    }
+    const plan = obj["plan"].map((item, i) => {
+        if (typeof item !== "object" || item === null) {
+            throw new Error(`plan[${i}] must be an object`);
+        }
+        const it = item;
+        if (typeof it["step"] !== "string")
+            throw new Error(`plan[${i}].step must be a string`);
+        const status = it["status"];
+        if (status !== "pending" && status !== "in_progress" && status !== "completed") {
+            throw new Error(`plan[${i}].status must be pending, in_progress, or completed`);
+        }
+        return { step: it["step"], status: status };
+    });
+    const explanation = typeof obj["explanation"] === "string" ? obj["explanation"] : undefined;
+    return { ok: true, args: { plan, ...(explanation !== undefined ? { explanation } : {}) } };
+}
+//# sourceMappingURL=plan_spec.js.map

package/dist/core/src/tools/handlers/plan_spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan_spec.js","sourceRoot":"","sources":["../../../../../core/src/tools/handlers/plan_spec.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,CAAC,MAAM,sCAAsC,CAAC;AAE1D,MAAM,CAAC,MAAM,qBAAqB,GAAG,aAAa,CAAC;AAEnD,MAAM,UAAU,oBAAoB;IAClC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAC7B;QACE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC;QACjC,MAAM,EAAE,CAAC,CAAC,UAAU,CAClB,CAAC,SAAS,EAAE,aAAa,EAAE,WAAW,CAAC,EACvC,cAAc,CACf;KACF,EACD,CAAC,MAAM,EAAE,QAAQ,CAAC,EAClB,KAAK,CACN,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE;YACJ,IAAI,EAAE,qBAAqB;YAC3B,WAAW,EAAE;;+CAE4B;YACzC,UAAU,EAAE,CAAC,CAAC,MAAM,CAClB;gBACE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,4CAA4C,CAAC;gBACnE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,EAAE,mBAAmB,CAAC;aACnD,EACD,CAAC,MAAM,CAAC,EACR,KAAK,CACN;YACD,MAAM,EAAE,KAAK;SACd;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAIlD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACpD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,qDAAqD,EAAE,CAAC;IACrF,CAAC;IAED,MAAM,GAAG,GAAG,OAAkC,CAAC;IAE/C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,2DAA2D,EAAE,CAAC;IAC3F,CAAC;IAED,MAAM,IAAI,GAAI,GAAG,CAAC,MAAM,CAAe,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QACtD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;QAClD,CAAC;QACD,MAAM,EAAE,GAAG,IAA+B,CAAC;QAC3C,IAAI,OAAO,EAAE,CAAC,MAAM,CAAC,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAC;QACxF,MAAM,MAAM,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,aAAa,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;YAC/E,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,qDAAqD,CAAC,CAAC;QAClF,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAW,EAAE,MAAM,EAAE,MAAoE,EAAE,CAAC;IACtH,CAAC,CAAC,CAAC;IAEH,MAAM,WAAW,GACf,OAAO,GAAG,CAAC,aAAa,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE1E,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;AAC7F,CAAC"}

package/dist/core/src/tools/handlers/request_user_input.d.ts

@@ -0,0 +1,17 @@
+/**
+ * mirrors codex-rs/core/src/tools/handlers/request_user_input.rs
+ *
+ * Suspends the current turn until the client submits a UserInputAnswer op.
+ * The resolver is stored in a map keyed by turn_id and resolved when
+ * CodexThread.submit({ type: "UserInputAnswer", id: turn_id, response })
+ * is called.
+ */
+import type { RequestUserInputQuestion, RequestUserInputResponse } from "../../../../protocol/src/request_user_input.js";
+export type PendingInputs = Map<string, (response: RequestUserInputResponse) => void>;
+export interface RequestUserInputContext {
+    turnId: string;
+    pendingInputs: PendingInputs;
+}
+export declare function handleRequestUserInput(ctx: RequestUserInputContext, _questions: RequestUserInputQuestion[]): Promise<RequestUserInputResponse>;
+export declare function formatRequestUserInputOutput(response: RequestUserInputResponse): string;
+//# sourceMappingURL=request_user_input.d.ts.map

package/dist/core/src/tools/handlers/request_user_input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request_user_input.d.ts","sourceRoot":"","sources":["../../../../../core/src/tools/handlers/request_user_input.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,wBAAwB,EACxB,wBAAwB,EACzB,MAAM,gDAAgD,CAAC;AAExD,MAAM,MAAM,aAAa,GAAG,GAAG,CAC7B,MAAM,EACN,CAAC,QAAQ,EAAE,wBAAwB,KAAK,IAAI,CAC7C,CAAC;AAEF,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,aAAa,CAAC;CAC9B;AAED,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,uBAAuB,EAC5B,UAAU,EAAE,wBAAwB,EAAE,GACrC,OAAO,CAAC,wBAAwB,CAAC,CAInC;AAED,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,wBAAwB,GACjC,MAAM,CAER"}

package/dist/core/src/tools/handlers/request_user_input.js

@@ -0,0 +1,17 @@
+/**
+ * mirrors codex-rs/core/src/tools/handlers/request_user_input.rs
+ *
+ * Suspends the current turn until the client submits a UserInputAnswer op.
+ * The resolver is stored in a map keyed by turn_id and resolved when
+ * CodexThread.submit({ type: "UserInputAnswer", id: turn_id, response })
+ * is called.
+ */
+export async function handleRequestUserInput(ctx, _questions) {
+    return new Promise((resolve) => {
+        ctx.pendingInputs.set(ctx.turnId, resolve);
+    });
+}
+export function formatRequestUserInputOutput(response) {
+    return JSON.stringify(response);
+}
+//# sourceMappingURL=request_user_input.js.map

package/dist/core/src/tools/handlers/request_user_input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request_user_input.js","sourceRoot":"","sources":["../../../../../core/src/tools/handlers/request_user_input.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiBH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,GAA4B,EAC5B,UAAsC;IAEtC,OAAO,IAAI,OAAO,CAA2B,CAAC,OAAO,EAAE,EAAE;QACvD,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,QAAkC;IAElC,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC"}

package/dist/core/src/tools/handlers/request_user_input_spec.d.ts

@@ -0,0 +1,25 @@
+/**
+ * mirrors codex-rs/core/src/tools/handlers/request_user_input_spec.rs
+ */
+import type { ToolSpec } from "../../../../tools/src/tool_spec.js";
+export declare const REQUEST_USER_INPUT_TOOL_NAME = "request_user_input";
+export declare function createRequestUserInputTool(): ToolSpec;
+/** Normalise args from the model: ensure options exist and set isOther = true */
+export declare function normalizeRequestUserInputArgs(args: {
+    questions: {
+        id: string;
+        header: string;
+        question: string;
+        options?: {
+            label: string;
+            description: string;
+        }[];
+        isOther?: boolean;
+        isSecret?: boolean;
+    }[];
+}): {
+    questions: import("../../../../protocol/src/request_user_input.js").RequestUserInputQuestion[];
+} | {
+    error: string;
+};
+//# sourceMappingURL=request_user_input_spec.d.ts.map

package/dist/core/src/tools/handlers/request_user_input_spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request_user_input_spec.d.ts","sourceRoot":"","sources":["../../../../../core/src/tools/handlers/request_user_input_spec.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAGnE,eAAO,MAAM,4BAA4B,uBAAuB,CAAC;AAEjE,wBAAgB,0BAA0B,IAAI,QAAQ,CAgDrD;AAED,iFAAiF;AACjF,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,SAAS,EAAE;QACT,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QACnD,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,EAAE,CAAC;CACL,GAAG;IAAE,SAAS,EAAE,OAAO,gDAAgD,EAAE,wBAAwB,EAAE,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAkBzH"}

package/dist/core/src/tools/handlers/request_user_input_spec.js

@@ -0,0 +1,51 @@
+/**
+ * mirrors codex-rs/core/src/tools/handlers/request_user_input_spec.rs
+ */
+import * as S from "../../../../tools/src/json_schema.js";
+export const REQUEST_USER_INPUT_TOOL_NAME = "request_user_input";
+export function createRequestUserInputTool() {
+    const optionSchema = S.object({
+        label: S.string("User-facing label (1-5 words)."),
+        description: S.string("One short sentence explaining impact/tradeoff if selected."),
+    }, ["label", "description"], false);
+    const optionsSchema = S.array(optionSchema, 'Provide 2-3 mutually exclusive choices. Put the recommended option first and suffix its label with "(Recommended)". ' +
+        'Do not include an "Other" option; the client adds one automatically.');
+    const questionSchema = S.object({
+        id: S.string("Stable identifier for mapping answers (snake_case)."),
+        header: S.string("Short header label shown in the UI (12 or fewer chars)."),
+        question: S.string("Single-sentence prompt shown to the user."),
+        options: optionsSchema,
+    }, ["id", "header", "question", "options"], false);
+    return {
+        type: "function",
+        tool: {
+            name: REQUEST_USER_INPUT_TOOL_NAME,
+            description: "Request user input for one to three short questions and wait for the response.",
+            parameters: S.object({
+                questions: S.array(questionSchema, "Questions to show the user. Prefer 1 and do not exceed 3."),
+            }, ["questions"], false),
+            strict: false,
+        },
+    };
+}
+/** Normalise args from the model: ensure options exist and set isOther = true */
+export function normalizeRequestUserInputArgs(args) {
+    for (const q of args.questions) {
+        if (!q.options || q.options.length === 0) {
+            return {
+                error: "request_user_input requires non-empty options for every question",
+            };
+        }
+    }
+    return {
+        questions: args.questions.map((q) => ({
+            id: q.id,
+            header: q.header,
+            question: q.question,
+            options: q.options,
+            isOther: true,
+            isSecret: q.isSecret ?? false,
+        })),
+    };
+}
+//# sourceMappingURL=request_user_input_spec.js.map

package/dist/core/src/tools/handlers/request_user_input_spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request_user_input_spec.js","sourceRoot":"","sources":["../../../../../core/src/tools/handlers/request_user_input_spec.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,CAAC,MAAM,sCAAsC,CAAC;AAE1D,MAAM,CAAC,MAAM,4BAA4B,GAAG,oBAAoB,CAAC;AAEjE,MAAM,UAAU,0BAA0B;IACxC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAC3B;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,gCAAgC,CAAC;QACjD,WAAW,EAAE,CAAC,CAAC,MAAM,CACnB,4DAA4D,CAC7D;KACF,EACD,CAAC,OAAO,EAAE,aAAa,CAAC,EACxB,KAAK,CACN,CAAC;IAEF,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAC3B,YAAY,EACZ,sHAAsH;QACpH,sEAAsE,CACzE,CAAC;IAEF,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAC7B;QACE,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,qDAAqD,CAAC;QACnE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,yDAAyD,CAAC;QAC3E,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,2CAA2C,CAAC;QAC/D,OAAO,EAAE,aAAa;KACvB,EACD,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC,EACvC,KAAK,CACN,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE;YACJ,IAAI,EAAE,4BAA4B;YAClC,WAAW,EACT,gFAAgF;YAClF,UAAU,EAAE,CAAC,CAAC,MAAM,CAClB;gBACE,SAAS,EAAE,CAAC,CAAC,KAAK,CAChB,cAAc,EACd,2DAA2D,CAC5D;aACF,EACD,CAAC,WAAW,CAAC,EACb,KAAK,CACN;YACD,MAAM,EAAE,KAAK;SACd;KACF,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,6BAA6B,CAAC,IAS7C;IACC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QAC/B,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzC,OAAO;gBACL,KAAK,EAAE,kEAAkE;aAC1E,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACpC,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,KAAK;SAC9B,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}

package/dist/core/src/tools/router.d.ts

@@ -0,0 +1,30 @@
+/**
+ * mirrors codex-rs/core/src/tools/router.rs
+ *
+ * Routes tool calls by name to the appropriate handler.
+ * Returns the tool output string + any side-effect EventMsgs to emit.
+ */
+import type { EventMsg } from "../../../protocol/src/protocol.js";
+import type { ToolSpec } from "../../../tools/src/tool_spec.js";
+import { GoalToolExecutor } from "../../../ext/goal/src/tool.js";
+import type { PendingInputs } from "./handlers/request_user_input.js";
+export interface ToolRouterContext {
+    turnId: string;
+    pendingInputs: PendingInputs;
+    /** Emit an event immediately — used for events that must fire before suspension */
+    emitEvent: (msg: EventMsg) => void;
+}
+/** mirrors ToolRouter in router.rs */
+export declare class ToolRouter {
+    private readonly goalExecutor;
+    constructor(goalExecutor: GoalToolExecutor);
+    /** All tool specs to include in Responses API requests */
+    toolSpecs(): ToolSpec[];
+    /**
+     * Dispatch a tool call; may suspend (request_user_input).
+     * Side-effect events are emitted immediately via ctx.emitEvent rather than
+     * returned, so RequestUserInput fires before the turn suspends.
+     */
+    dispatch(toolName: string, callId: string, rawArgs: unknown, ctx: ToolRouterContext): Promise<string>;
+}
+//# sourceMappingURL=router.d.ts.map

package/dist/core/src/tools/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../../../core/src/tools/router.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAElE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAkBjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAOtE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,aAAa,CAAC;IAC7B,mFAAmF;IACnF,SAAS,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,CAAC;CACpC;AAED,sCAAsC;AACtC,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmB;gBAEpC,YAAY,EAAE,gBAAgB;IAI1C,0DAA0D;IAC1D,SAAS,IAAI,QAAQ,EAAE;IAUvB;;;;OAIG;IACG,QAAQ,CACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,iBAAiB,GACrB,OAAO,CAAC,MAAM,CAAC;CA+DnB"}

package/dist/core/src/tools/router.js

@@ -0,0 +1,82 @@
+/**
+ * mirrors codex-rs/core/src/tools/router.rs
+ *
+ * Routes tool calls by name to the appropriate handler.
+ * Returns the tool output string + any side-effect EventMsgs to emit.
+ */
+import { CREATE_GOAL_TOOL_NAME, GET_GOAL_TOOL_NAME, UPDATE_GOAL_TOOL_NAME, createCreateGoalTool, createGetGoalTool, createUpdateGoalTool, } from "../../../ext/goal/src/spec.js";
+import { REQUEST_USER_INPUT_TOOL_NAME, normalizeRequestUserInputArgs, createRequestUserInputTool, } from "./handlers/request_user_input_spec.js";
+import { handleRequestUserInput, formatRequestUserInputOutput, } from "./handlers/request_user_input.js";
+import { UPDATE_PLAN_TOOL_NAME, createUpdatePlanTool, parseUpdatePlanArgs, } from "./handlers/plan_spec.js";
+/** mirrors ToolRouter in router.rs */
+export class ToolRouter {
+    goalExecutor;
+    constructor(goalExecutor) {
+        this.goalExecutor = goalExecutor;
+    }
+    /** All tool specs to include in Responses API requests */
+    toolSpecs() {
+        return [
+            createGetGoalTool(),
+            createCreateGoalTool(),
+            createUpdateGoalTool(),
+            createRequestUserInputTool(),
+            createUpdatePlanTool(),
+        ];
+    }
+    /**
+     * Dispatch a tool call; may suspend (request_user_input).
+     * Side-effect events are emitted immediately via ctx.emitEvent rather than
+     * returned, so RequestUserInput fires before the turn suspends.
+     */
+    async dispatch(toolName, callId, rawArgs, ctx) {
+        const args = (typeof rawArgs === "object" && rawArgs !== null
+            ? rawArgs
+            : {});
+        switch (toolName) {
+            case GET_GOAL_TOOL_NAME: {
+                const { output } = await this.goalExecutor.get();
+                return output;
+            }
+            case CREATE_GOAL_TOOL_NAME: {
+                const { output, event } = await this.goalExecutor.create(args["objective"], args["token_budget"]);
+                if (event)
+                    ctx.emitEvent({ type: "ThreadGoalUpdated", event });
+                return output;
+            }
+            case UPDATE_GOAL_TOOL_NAME: {
+                const { output, event } = await this.goalExecutor.update(args["status"]);
+                if (event)
+                    ctx.emitEvent({ type: "ThreadGoalUpdated", event });
+                return output;
+            }
+            case REQUEST_USER_INPUT_TOOL_NAME: {
+                const normalized = normalizeRequestUserInputArgs(args);
+                if ("error" in normalized) {
+                    return JSON.stringify({ error: normalized.error });
+                }
+                // Emit BEFORE suspending so the client can see the event and answer
+                ctx.emitEvent({
+                    type: "RequestUserInput",
+                    event: { call_id: callId, turn_id: ctx.turnId, questions: normalized.questions },
+                });
+                const response = await handleRequestUserInput({ turnId: ctx.turnId, pendingInputs: ctx.pendingInputs }, normalized.questions);
+                return formatRequestUserInputOutput(response);
+            }
+            case UPDATE_PLAN_TOOL_NAME: {
+                const parsed = parseUpdatePlanArgs(args);
+                if (!parsed.ok) {
+                    return JSON.stringify({
+                        error: parsed.error,
+                        success: false,
+                    });
+                }
+                ctx.emitEvent({ type: "PlanUpdate", event: parsed.args });
+                return "Plan updated";
+            }
+            default:
+                return JSON.stringify({ error: `Unknown tool: ${toolName}` });
+        }
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/core/src/tools/router.js.map

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

package/dist/core/tests/common/lib.d.ts

@@ -0,0 +1,26 @@
+/**
+ * mirrors codex-rs/core/tests/common/lib.rs
+ *
+ * Shared test helpers: waitForEvent, mock SSE server helpers.
+ */
+import type { EventMsg } from "../../../protocol/src/protocol.js";
+import type { CodexThread } from "../../src/codex_thread.js";
+/**
+ * Mirrors wait_for_event() in core_test_support.
+ * Polls nextEvent() until predicate returns true, then returns that EventMsg.
+ */
+export declare function waitForEvent(codex: CodexThread, predicate: (msg: EventMsg) => boolean, timeoutMs?: number): Promise<EventMsg>;
+/**
+ * Mirrors wait_for_event_match() — extracts a typed value from the matching event.
+ */
+export declare function waitForEventMatch<T>(codex: CodexThread, matcher: (msg: EventMsg) => T | null, timeoutMs?: number): Promise<T>;
+/** Build a raw SSE data payload string from an array of event objects */
+export declare function sse(events: object[]): string;
+export declare function evResponseCreated(id: string): object;
+export declare function evFunctionCall(callId: string, name: string, args: object): object;
+export declare function evAssistantMessage(text: string): object;
+export declare function evCompleted(id: string): object;
+/** Flatten nested arrays of SSE events into a single SSE string */
+export declare function sseFlat(events: (object | object[])[]): string;
+export declare function makeSseResponse(sseText: string): Response;
+//# sourceMappingURL=lib.d.ts.map

package/dist/core/tests/common/lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../../../../core/tests/common/lib.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAI7D;;;GAGG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,OAAO,EACrC,SAAS,SAAO,GACf,OAAO,CAAC,QAAQ,CAAC,CAcnB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,CAAC,GAAG,IAAI,EACpC,SAAS,SAAO,GACf,OAAO,CAAC,CAAC,CAAC,CAGZ;AAID,yEAAyE;AACzE,wBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAE5C;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,MAAM,CAiBR;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiBvD;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,mEAAmE;AACnE,wBAAgB,OAAO,CAAC,MAAM,EAAE,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,GAAG,MAAM,CAE7D;AAID,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAYzD"}