@ai0x0/codex-ts 0.1.0

package/dist/ext/goal/src/spec.js

@@ -0,0 +1,61 @@
+/**
+ * mirrors codex-rs/ext/goal/src/spec.rs
+ *
+ * Tool schemas for create_goal, get_goal, update_goal.
+ */
+import * as S from "../../../tools/src/json_schema.js";
+export const GET_GOAL_TOOL_NAME = "get_goal";
+export const CREATE_GOAL_TOOL_NAME = "create_goal";
+export const UPDATE_GOAL_TOOL_NAME = "update_goal";
+export function createGetGoalTool() {
+    return {
+        type: "function",
+        tool: {
+            name: GET_GOAL_TOOL_NAME,
+            description: "Get the current goal for this thread, including status, budgets, token and elapsed-time usage, and remaining token budget.",
+            parameters: S.object({}, [], false),
+            strict: false,
+        },
+    };
+}
+export function createCreateGoalTool() {
+    return {
+        type: "function",
+        tool: {
+            name: CREATE_GOAL_TOOL_NAME,
+            description: [
+                "Create a goal only when explicitly requested by the user or system/developer instructions; do not infer goals from ordinary tasks.",
+                `Set token_budget only when an explicit token budget is requested. Fails if a goal exists; use ${UPDATE_GOAL_TOOL_NAME} only for status.`,
+            ].join("\n"),
+            parameters: S.object({
+                objective: S.string("Required. The concrete objective to start pursuing. " +
+                    "This starts a new active goal only when no goal is currently defined; " +
+                    "if a goal already exists, this tool fails."),
+                token_budget: S.integer("Optional positive token budget for the new active goal."),
+            }, ["objective"], false),
+            strict: false,
+        },
+    };
+}
+export function createUpdateGoalTool() {
+    return {
+        type: "function",
+        tool: {
+            name: UPDATE_GOAL_TOOL_NAME,
+            description: [
+                "Update the existing goal.",
+                "Use this tool only to mark the goal achieved or blocked.",
+                "Set status to `complete` only when the objective has actually been achieved and no required work remains.",
+                "Set status to `blocked` only when the goal cannot currently proceed until something external changes.",
+                "Do not mark a goal complete merely because its budget is nearly exhausted or because you are stopping work.",
+            ].join("\n"),
+            parameters: S.object({
+                status: S.stringEnum(["complete", "blocked"], "Required. Set to complete only when the objective is achieved and no required work remains. " +
+                    "Set to blocked only when the goal cannot currently proceed without a user decision, " +
+                    "missing dependency, or external unblock."),
+            }, ["status"], false),
+            strict: false,
+        },
+    };
+}
+//# sourceMappingURL=spec.js.map

package/dist/ext/goal/src/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../../../ext/goal/src/spec.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,CAAC,MAAM,mCAAmC,CAAC;AAEvD,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC;AAC7C,MAAM,CAAC,MAAM,qBAAqB,GAAG,aAAa,CAAC;AACnD,MAAM,CAAC,MAAM,qBAAqB,GAAG,aAAa,CAAC;AAEnD,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE;YACJ,IAAI,EAAE,kBAAkB;YACxB,WAAW,EACT,4HAA4H;YAC9H,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC;YACnC,MAAM,EAAE,KAAK;SACd;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE;YACJ,IAAI,EAAE,qBAAqB;YAC3B,WAAW,EAAE;gBACX,oIAAoI;gBACpI,iGAAiG,qBAAqB,mBAAmB;aAC1I,CAAC,IAAI,CAAC,IAAI,CAAC;YACZ,UAAU,EAAE,CAAC,CAAC,MAAM,CAClB;gBACE,SAAS,EAAE,CAAC,CAAC,MAAM,CACjB,sDAAsD;oBACpD,wEAAwE;oBACxE,4CAA4C,CAC/C;gBACD,YAAY,EAAE,CAAC,CAAC,OAAO,CACrB,yDAAyD,CAC1D;aACF,EACD,CAAC,WAAW,CAAC,EACb,KAAK,CACN;YACD,MAAM,EAAE,KAAK;SACd;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE;YACJ,IAAI,EAAE,qBAAqB;YAC3B,WAAW,EAAE;gBACX,2BAA2B;gBAC3B,0DAA0D;gBAC1D,2GAA2G;gBAC3G,uGAAuG;gBACvG,6GAA6G;aAC9G,CAAC,IAAI,CAAC,IAAI,CAAC;YACZ,UAAU,EAAE,CAAC,CAAC,MAAM,CAClB;gBACE,MAAM,EAAE,CAAC,CAAC,UAAU,CAClB,CAAC,UAAU,EAAE,SAAS,CAAC,EACvB,8FAA8F;oBAC5F,sFAAsF;oBACtF,0CAA0C,CAC7C;aACF,EACD,CAAC,QAAQ,CAAC,EACV,KAAK,CACN;YACD,MAAM,EAAE,KAAK;SACd;KACF,CAAC;AACJ,CAAC"}

package/dist/ext/goal/src/tool.d.ts

@@ -0,0 +1,34 @@
+/**
+ * mirrors codex-rs/ext/goal/src/tool.rs
+ *
+ * GoalToolExecutor — handles create_goal, get_goal, update_goal.
+ *
+ * Accepts an optional GoalStore for durable persistence (SQLite, IndexedDB…).
+ * Falls back to in-memory state when no store is supplied.
+ */
+import type { ThreadGoal, ThreadGoalUpdatedEvent } from "../../../protocol/src/protocol.js";
+import type { GoalStore } from "../../../state/src/runtime/goals.js";
+export declare class GoalToolExecutor {
+    /** In-memory snapshot — always current, written through to store when present */
+    private snapshot;
+    private readonly threadId;
+    private readonly store?;
+    constructor(threadId: string, store?: GoalStore);
+    create(objective: string, token_budget?: number): Promise<{
+        output: string;
+        event: ThreadGoalUpdatedEvent | null;
+    }>;
+    get(): Promise<{
+        output: string;
+        event: null;
+    }>;
+    update(status: "complete" | "blocked"): Promise<{
+        output: string;
+        event: ThreadGoalUpdatedEvent | null;
+    }>;
+    recordTokens(count: number, elapsedSeconds?: number): Promise<void>;
+    currentSnapshot(): ThreadGoal | null;
+    private formatResponse;
+    private goalUpdatedEvent;
+}
+//# sourceMappingURL=tool.d.ts.map

package/dist/ext/goal/src/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../../ext/goal/src/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,UAAU,EAEV,sBAAsB,EACvB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAQrE,qBAAa,gBAAgB;IAC3B,iFAAiF;IACjF,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAwB;gBAEnC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS;IAOzC,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI,CAAA;KAAE,CAAC;IAoC9D,GAAG,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,IAAI,CAAA;KAAE,CAAC;IAS/C,MAAM,CACV,MAAM,EAAE,UAAU,GAAG,SAAS,GAC7B,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI,CAAA;KAAE,CAAC;IAsB9D,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBpE,eAAe,IAAI,UAAU,GAAG,IAAI;IAMpC,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,gBAAgB;CAGzB"}

package/dist/ext/goal/src/tool.js

@@ -0,0 +1,104 @@
+/**
+ * mirrors codex-rs/ext/goal/src/tool.rs
+ *
+ * GoalToolExecutor — handles create_goal, get_goal, update_goal.
+ *
+ * Accepts an optional GoalStore for durable persistence (SQLite, IndexedDB…).
+ * Falls back to in-memory state when no store is supplied.
+ */
+export class GoalToolExecutor {
+    /** In-memory snapshot — always current, written through to store when present */
+    snapshot = null;
+    threadId;
+    store;
+    constructor(threadId, store) {
+        this.threadId = threadId;
+        this.store = store;
+    }
+    // ─── create_goal ────────────────────────────────────────────────────────────
+    async create(objective, token_budget) {
+        if (this.snapshot !== null) {
+            return {
+                output: JSON.stringify({ error: "A goal already exists. Use update_goal to change its status." }),
+                event: null,
+            };
+        }
+        if (!objective) {
+            return { output: JSON.stringify({ error: "objective is required." }), event: null };
+        }
+        if (token_budget !== undefined && (token_budget <= 0 || !Number.isInteger(token_budget))) {
+            return { output: JSON.stringify({ error: "token_budget must be a positive integer." }), event: null };
+        }
+        const goal = {
+            objective,
+            status: "Active",
+            ...(token_budget !== undefined ? { token_budget } : {}),
+            tokens_used: 0,
+            time_used_seconds: 0,
+        };
+        if (this.store) {
+            await this.store.replaceThreadGoal(this.threadId, objective, "Active", token_budget);
+        }
+        this.snapshot = goal;
+        return { output: this.formatResponse(), event: this.goalUpdatedEvent() };
+    }
+    // ─── get_goal ───────────────────────────────────────────────────────────────
+    async get() {
+        if (this.store) {
+            this.snapshot = await this.store.getThreadGoal(this.threadId);
+        }
+        return { output: this.formatResponse(), event: null };
+    }
+    // ─── update_goal ────────────────────────────────────────────────────────────
+    async update(status) {
+        if (this.snapshot === null) {
+            return { output: JSON.stringify({ error: "No active goal exists." }), event: null };
+        }
+        if (status !== "complete" && status !== "blocked") {
+            return {
+                output: JSON.stringify({ error: `Invalid status "${String(status)}". Must be "complete" or "blocked".` }),
+                event: null,
+            };
+        }
+        const goalStatus = status === "complete" ? "Complete" : "Blocked";
+        if (this.store) {
+            await this.store.updateThreadGoal(this.threadId, { status: goalStatus });
+        }
+        this.snapshot = { ...this.snapshot, status: goalStatus };
+        return { output: this.formatResponse(), event: this.goalUpdatedEvent() };
+    }
+    // ─── Token accounting ───────────────────────────────────────────────────────
+    async recordTokens(count, elapsedSeconds = 0) {
+        if (this.snapshot === null)
+            return;
+        if (this.store) {
+            const outcome = await this.store.accountTokens(this.threadId, count, elapsedSeconds);
+            if (outcome.kind === "Updated") {
+                this.snapshot = outcome.goal;
+                return;
+            }
+        }
+        this.snapshot = {
+            ...this.snapshot,
+            tokens_used: this.snapshot.tokens_used + count,
+            time_used_seconds: this.snapshot.time_used_seconds + elapsedSeconds,
+        };
+    }
+    currentSnapshot() {
+        return this.snapshot ? { ...this.snapshot } : null;
+    }
+    // ─── Private helpers ─────────────────────────────────────────────────────────
+    formatResponse() {
+        if (this.snapshot === null) {
+            return JSON.stringify({ goal: null, remaining_tokens: null });
+        }
+        const remaining_tokens = this.snapshot.token_budget !== undefined
+            ? this.snapshot.token_budget - this.snapshot.tokens_used
+            : null;
+        return JSON.stringify({ goal: this.snapshot, remaining_tokens });
+    }
+    goalUpdatedEvent() {
+        return this.snapshot ? { goal: { ...this.snapshot } } : null;
+    }
+}
+//# sourceMappingURL=tool.js.map

package/dist/ext/goal/src/tool.js.map

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

package/dist/protocol/src/index.d.ts

@@ -0,0 +1,5 @@
+export type { UserInput } from "./user_input.js";
+export type { RequestUserInputQuestionOption, RequestUserInputQuestion, RequestUserInputArgs, RequestUserInputAnswer, RequestUserInputResponse, RequestUserInputEvent, } from "./request_user_input.js";
+export type { StepStatus, PlanItemArg, UpdatePlanArgs } from "./plan_tool.js";
+export type { ThreadGoalStatus, ThreadGoal, TurnStartedEvent, TurnCompleteEvent, AgentMessageEvent, AgentMessageContentDeltaEvent, ThreadGoalUpdatedEvent, ErrorEvent, EventMsg, Event, Op, } from "./protocol.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/protocol/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../protocol/src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,YAAY,EACV,8BAA8B,EAC9B,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC9E,YAAY,EACV,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,6BAA6B,EAC7B,sBAAsB,EACtB,UAAU,EACV,QAAQ,EACR,KAAK,EACL,EAAE,GACH,MAAM,eAAe,CAAC"}

package/dist/protocol/src/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/protocol/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../protocol/src/index.ts"],"names":[],"mappings":""}

package/dist/protocol/src/plan_tool.d.ts

@@ -0,0 +1,16 @@
+/**
+ * mirrors codex-rs/protocol/src/plan_tool.rs
+ */
+/** mirrors StepStatus enum */
+export type StepStatus = "pending" | "in_progress" | "completed";
+/** mirrors PlanItemArg struct */
+export interface PlanItemArg {
+    step: string;
+    status: StepStatus;
+}
+/** mirrors UpdatePlanArgs struct */
+export interface UpdatePlanArgs {
+    explanation?: string | undefined;
+    plan: PlanItemArg[];
+}
+//# sourceMappingURL=plan_tool.d.ts.map

package/dist/protocol/src/plan_tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan_tool.d.ts","sourceRoot":"","sources":["../../../protocol/src/plan_tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,8BAA8B;AAC9B,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC;AAEjE,iCAAiC;AACjC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,oCAAoC;AACpC,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,IAAI,EAAE,WAAW,EAAE,CAAC;CACrB"}

package/dist/protocol/src/plan_tool.js

@@ -0,0 +1,5 @@
+/**
+ * mirrors codex-rs/protocol/src/plan_tool.rs
+ */
+export {};
+//# sourceMappingURL=plan_tool.js.map

package/dist/protocol/src/plan_tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan_tool.js","sourceRoot":"","sources":["../../../protocol/src/plan_tool.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/protocol/src/protocol.d.ts

@@ -0,0 +1,87 @@
+/**
+ * mirrors codex-rs/protocol/src/protocol.rs
+ *
+ * Subset: Op + EventMsg variants needed for goal, request_user_input,
+ * and conversation (turn lifecycle + streaming text).
+ */
+import type { UserInput } from "./user_input.js";
+import type { RequestUserInputEvent, RequestUserInputResponse } from "./request_user_input.js";
+import type { UpdatePlanArgs } from "./plan_tool.js";
+export type ThreadGoalStatus = "Active" | "Paused" | "Blocked" | "UsageLimited" | "BudgetLimited" | "Complete";
+export interface ThreadGoal {
+    objective: string;
+    status: ThreadGoalStatus;
+    token_budget?: number | undefined;
+    tokens_used: number;
+    time_used_seconds: number;
+}
+export interface TurnStartedEvent {
+    turn_id: string;
+}
+export interface TurnCompleteEvent {
+    turn_id: string;
+    last_agent_message?: string | undefined;
+}
+/** Full assistant text for a completed message */
+export interface AgentMessageEvent {
+    message: string;
+}
+/** Streaming text chunk — mirrors AgentMessageContentDeltaEvent */
+export interface AgentMessageContentDeltaEvent {
+    turn_id: string;
+    item_id: string;
+    delta: string;
+}
+export interface ThreadGoalUpdatedEvent {
+    turn_id?: string | undefined;
+    goal: ThreadGoal;
+}
+export interface ErrorEvent {
+    message: string;
+}
+export type EventMsg = {
+    type: "TurnStarted";
+    event: TurnStartedEvent;
+} | {
+    type: "TurnComplete";
+    event: TurnCompleteEvent;
+} | {
+    type: "AgentMessage";
+    event: AgentMessageEvent;
+} | {
+    type: "AgentMessageContentDelta";
+    event: AgentMessageContentDeltaEvent;
+} | {
+    type: "RequestUserInput";
+    event: RequestUserInputEvent;
+} | {
+    type: "ThreadGoalUpdated";
+    event: ThreadGoalUpdatedEvent;
+} | {
+    type: "PlanUpdate";
+    event: UpdatePlanArgs;
+} | {
+    type: "Error";
+    event: ErrorEvent;
+};
+/** Wraps EventMsg with the submission_id that originated it — mirrors codex-rs Event */
+export interface Event {
+    /** submission_id returned by CodexThread.submit() */
+    id: string;
+    msg: EventMsg;
+}
+export type Op = {
+    type: "UserInput";
+    items: UserInput[];
+} | {
+    type: "UserInputAnswer";
+    /** RequestUserInputEvent.turn_id — identifies which turn to unblock */
+    id: string;
+    response: RequestUserInputResponse;
+} | {
+    type: "Interrupt";
+};
+export type { RequestUserInputEvent, RequestUserInputResponse };
+export type { UpdatePlanArgs } from "./plan_tool.js";
+export type { StepStatus, PlanItemArg } from "./plan_tool.js";
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol/src/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../protocol/src/protocol.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EACV,qBAAqB,EACrB,wBAAwB,EACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIrD,MAAM,MAAM,gBAAgB,GACxB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,cAAc,GACd,eAAe,GACf,UAAU,CAAC;AAEf,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,gBAAgB,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAID,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC;AAED,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,mEAAmE;AACnE,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,MAAM,MAAM,QAAQ,GAChB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,0BAA0B,CAAC;IAAC,KAAK,EAAE,6BAA6B,CAAA;CAAE,GAC1E;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,KAAK,EAAE,qBAAqB,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,KAAK,EAAE,sBAAsB,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAAC;AAEzC,wFAAwF;AACxF,MAAM,WAAW,KAAK;IACpB,qDAAqD;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,QAAQ,CAAC;CACf;AAID,MAAM,MAAM,EAAE,GACV;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,SAAS,EAAE,CAAA;CAAE,GACzC;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,uEAAuE;IACvE,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,wBAAwB,CAAC;CACpC,GACD;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC;AAE1B,YAAY,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,CAAC;AAChE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/protocol/src/protocol.js

@@ -0,0 +1,8 @@
+/**
+ * mirrors codex-rs/protocol/src/protocol.rs
+ *
+ * Subset: Op + EventMsg variants needed for goal, request_user_input,
+ * and conversation (turn lifecycle + streaming text).
+ */
+export {};
+//# sourceMappingURL=protocol.js.map

package/dist/protocol/src/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../../protocol/src/protocol.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/protocol/src/request_user_input.d.ts

@@ -0,0 +1,31 @@
+/** mirrors codex-rs/protocol/src/request_user_input.rs */
+export interface RequestUserInputQuestionOption {
+    label: string;
+    description: string;
+}
+export interface RequestUserInputQuestion {
+    id: string;
+    header: string;
+    question: string;
+    /** Injected by normalize_request_user_input_args in spec.rs */
+    isOther: boolean;
+    isSecret: boolean;
+    options?: RequestUserInputQuestionOption[] | undefined;
+}
+export interface RequestUserInputArgs {
+    questions: RequestUserInputQuestion[];
+}
+/** Per-question answers: key = question id */
+export interface RequestUserInputAnswer {
+    answers: string[];
+}
+export interface RequestUserInputResponse {
+    answers: Record<string, RequestUserInputAnswer>;
+}
+/** Emitted by the agent when it calls request_user_input */
+export interface RequestUserInputEvent {
+    call_id: string;
+    turn_id: string;
+    questions: RequestUserInputQuestion[];
+}
+//# sourceMappingURL=request_user_input.d.ts.map

package/dist/protocol/src/request_user_input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request_user_input.d.ts","sourceRoot":"","sources":["../../../protocol/src/request_user_input.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAE1D,MAAM,WAAW,8BAA8B;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,8BAA8B,EAAE,GAAG,SAAS,CAAC;CACxD;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,wBAAwB,EAAE,CAAC;CACvC;AAED,8CAA8C;AAC9C,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;CACjD;AAED,4DAA4D;AAC5D,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,wBAAwB,EAAE,CAAC;CACvC"}

package/dist/protocol/src/request_user_input.js

@@ -0,0 +1,3 @@
+/** mirrors codex-rs/protocol/src/request_user_input.rs */
+export {};
+//# sourceMappingURL=request_user_input.js.map

package/dist/protocol/src/request_user_input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request_user_input.js","sourceRoot":"","sources":["../../../protocol/src/request_user_input.ts"],"names":[],"mappings":"AAAA,0DAA0D"}

package/dist/protocol/src/user_input.d.ts

@@ -0,0 +1,9 @@
+/** mirrors codex-rs/protocol/src/user_input.rs */
+export type UserInput = {
+    type: "text";
+    text: string;
+} | {
+    type: "image";
+    image_url: string;
+};
+//# sourceMappingURL=user_input.d.ts.map

package/dist/protocol/src/user_input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user_input.d.ts","sourceRoot":"","sources":["../../../protocol/src/user_input.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAElD,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/protocol/src/user_input.js

@@ -0,0 +1,3 @@
+/** mirrors codex-rs/protocol/src/user_input.rs */
+export {};
+//# sourceMappingURL=user_input.js.map

package/dist/protocol/src/user_input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user_input.js","sourceRoot":"","sources":["../../../protocol/src/user_input.ts"],"names":[],"mappings":"AAAA,kDAAkD"}

package/dist/state/src/index.d.ts

@@ -0,0 +1,3 @@
+export type { GoalBackend, GoalUpdate, GoalAccountingOutcome } from "./runtime/goals.js";
+export { GoalStore, InMemoryGoalBackend } from "./runtime/goals.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/state/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../state/src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/state/src/index.js

@@ -0,0 +1,2 @@
+export { GoalStore, InMemoryGoalBackend } from "./runtime/goals.js";
+//# sourceMappingURL=index.js.map

package/dist/state/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../state/src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/state/src/runtime/goals.d.ts

@@ -0,0 +1,48 @@
+/**
+ * mirrors codex-rs/state/src/runtime/goals.rs
+ *
+ * GoalBackend — injectable storage primitive for goal state.
+ *
+ * Implement this to persist goals to SQLite, IndexedDB, OPFS, etc.
+ * The built-in InMemoryGoalBackend works in all environments without I/O.
+ *
+ * GoalStore wraps a GoalBackend and adds accounting (token budget tracking).
+ */
+import type { ThreadGoal, ThreadGoalStatus } from "../../../protocol/src/protocol.js";
+export interface GoalBackend {
+    getThreadGoal(threadId: string): Promise<ThreadGoal | null>;
+    saveThreadGoal(threadId: string, goal: ThreadGoal): Promise<void>;
+    deleteThreadGoal(threadId: string): Promise<void>;
+}
+export declare class InMemoryGoalBackend implements GoalBackend {
+    private readonly store;
+    getThreadGoal(threadId: string): Promise<ThreadGoal | null>;
+    saveThreadGoal(threadId: string, goal: ThreadGoal): Promise<void>;
+    deleteThreadGoal(threadId: string): Promise<void>;
+}
+export interface GoalUpdate {
+    status?: ThreadGoalStatus | undefined;
+    token_budget?: number | null | undefined;
+}
+export type GoalAccountingOutcome = {
+    kind: "Unchanged";
+    goal: ThreadGoal | null;
+} | {
+    kind: "Updated";
+    goal: ThreadGoal;
+};
+export declare class GoalStore {
+    private readonly backend;
+    constructor(backend?: GoalBackend);
+    getThreadGoal(threadId: string): Promise<ThreadGoal | null>;
+    /** Create or replace a thread goal */
+    replaceThreadGoal(threadId: string, objective: string, status: ThreadGoalStatus, token_budget?: number): Promise<ThreadGoal>;
+    /** Apply a partial update to an existing goal */
+    updateThreadGoal(threadId: string, update: GoalUpdate): Promise<GoalAccountingOutcome>;
+    /**
+     * Record token and time usage against the active goal budget.
+     * Mirrors the accounting path in GoalStore::account_tokens().
+     */
+    accountTokens(threadId: string, tokens: number, elapsedSeconds: number): Promise<GoalAccountingOutcome>;
+}
+//# sourceMappingURL=goals.d.ts.map

package/dist/state/src/runtime/goals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goals.d.ts","sourceRoot":"","sources":["../../../../state/src/runtime/goals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAItF,MAAM,WAAW,WAAW;IAC1B,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC5D,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD;AAID,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IAEjD,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAI3D,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGxD;AAID,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CAC1C;AAID,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAI1C,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;gBAE1B,OAAO,GAAE,WAAuC;IAItD,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAIjE,sCAAsC;IAChC,iBAAiB,CACrB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,gBAAgB,EACxB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,UAAU,CAAC;IAYtB,iDAAiD;IAC3C,gBAAgB,CACpB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,qBAAqB,CAAC;IAkBjC;;;OAGG;IACG,aAAa,CACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,qBAAqB,CAAC;CA6BlC"}

package/dist/state/src/runtime/goals.js

@@ -0,0 +1,93 @@
+/**
+ * mirrors codex-rs/state/src/runtime/goals.rs
+ *
+ * GoalBackend — injectable storage primitive for goal state.
+ *
+ * Implement this to persist goals to SQLite, IndexedDB, OPFS, etc.
+ * The built-in InMemoryGoalBackend works in all environments without I/O.
+ *
+ * GoalStore wraps a GoalBackend and adds accounting (token budget tracking).
+ */
+// ─── InMemoryGoalBackend ───────────────────────────────────────────────────────
+export class InMemoryGoalBackend {
+    store = new Map();
+    async getThreadGoal(threadId) {
+        return this.store.get(threadId) ?? null;
+    }
+    async saveThreadGoal(threadId, goal) {
+        this.store.set(threadId, { ...goal });
+    }
+    async deleteThreadGoal(threadId) {
+        this.store.delete(threadId);
+    }
+}
+// ─── GoalStore ────────────────────────────────────────────────────────────────
+export class GoalStore {
+    backend;
+    constructor(backend = new InMemoryGoalBackend()) {
+        this.backend = backend;
+    }
+    async getThreadGoal(threadId) {
+        return this.backend.getThreadGoal(threadId);
+    }
+    /** Create or replace a thread goal */
+    async replaceThreadGoal(threadId, objective, status, token_budget) {
+        const goal = {
+            objective,
+            status,
+            ...(token_budget !== undefined ? { token_budget } : {}),
+            tokens_used: 0,
+            time_used_seconds: 0,
+        };
+        await this.backend.saveThreadGoal(threadId, goal);
+        return goal;
+    }
+    /** Apply a partial update to an existing goal */
+    async updateThreadGoal(threadId, update) {
+        const existing = await this.backend.getThreadGoal(threadId);
+        if (existing === null) {
+            return { kind: "Unchanged", goal: null };
+        }
+        const updated = {
+            ...existing,
+            ...(update.status !== undefined ? { status: update.status } : {}),
+            ...(update.token_budget !== undefined
+                ? update.token_budget === null
+                    ? {}
+                    : { token_budget: update.token_budget }
+                : {}),
+        };
+        await this.backend.saveThreadGoal(threadId, updated);
+        return { kind: "Updated", goal: updated };
+    }
+    /**
+     * Record token and time usage against the active goal budget.
+     * Mirrors the accounting path in GoalStore::account_tokens().
+     */
+    async accountTokens(threadId, tokens, elapsedSeconds) {
+        const existing = await this.backend.getThreadGoal(threadId);
+        if (existing === null || existing.status !== "Active") {
+            return { kind: "Unchanged", goal: existing };
+        }
+        const tokens_used = existing.tokens_used + tokens;
+        const time_used_seconds = existing.time_used_seconds + elapsedSeconds;
+        let status = existing.status;
+        // Budget exhaustion → UsageLimited
+        if (existing.token_budget !== undefined &&
+            tokens_used >= existing.token_budget) {
+            status = "UsageLimited";
+        }
+        const updated = {
+            ...existing,
+            tokens_used,
+            time_used_seconds,
+            status,
+        };
+        await this.backend.saveThreadGoal(threadId, updated);
+        const changed = status !== existing.status || tokens_used !== existing.tokens_used;
+        return changed
+            ? { kind: "Updated", goal: updated }
+            : { kind: "Unchanged", goal: updated };
+    }
+}
+//# sourceMappingURL=goals.js.map

package/dist/state/src/runtime/goals.js.map

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

package/dist/thread-store/src/in_memory.d.ts

@@ -0,0 +1,20 @@
+/**
+ * mirrors codex-rs/thread-store/src/in_memory.rs
+ *
+ * InMemoryThreadStore — reference implementation that works in both
+ * browser and Node.js without any I/O.  Suitable for tests and ephemeral use.
+ *
+ * For durable storage supply a custom IoBackend to LocalThreadStore instead.
+ */
+import type { ThreadStore } from "./store.js";
+import type { AppendThreadItemsParams, CreateThreadParams, LoadThreadHistoryParams, ReadThreadParams, StoredThread, StoredThreadHistory, UpdateThreadMetadataParams } from "./types.js";
+export declare class InMemoryThreadStore implements ThreadStore {
+    private readonly threads;
+    createThread(params: CreateThreadParams): Promise<void>;
+    appendItems(params: AppendThreadItemsParams): Promise<void>;
+    loadHistory(params: LoadThreadHistoryParams): Promise<StoredThreadHistory>;
+    readThread(params: ReadThreadParams): Promise<StoredThread | null>;
+    updateThreadMetadata(params: UpdateThreadMetadataParams): Promise<void>;
+    listThreadIds(): Promise<string[]>;
+}
+//# sourceMappingURL=in_memory.d.ts.map