@ai0x0/codex-ts 0.6.4 → 0.7.0

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

@@ -25,13 +25,12 @@ export function createCreateGoalTool() {
             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.`,
+                `Set token_budget only when an explicit token budget is requested. Fails if an unfinished 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."),
+                    "This starts a new active goal when no goal exists or replaces the current goal when it is complete."),
+                token_budget: S.integer("Positive token budget for the new goal. Omit unless explicitly requested."),
             }, ["objective"], false),
             strict: false,
         },
@@ -44,15 +43,21 @@ export function createUpdateGoalTool() {
             name: UPDATE_GOAL_TOOL_NAME,
             description: [
                 "Update the existing goal.",
-                "Use this tool only to mark the goal achieved or blocked.",
+                "Use this tool only to mark the goal achieved or genuinely 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.",
+                "Set status to `blocked` only when the same blocking condition has repeated for at least three consecutive goal turns, counting the original/user-triggered turn and any automatic continuations, and the agent cannot make meaningful progress without user input or an external-state change.",
+                "If the user resumes a goal that was previously marked `blocked`, treat the resumed run as a fresh blocked audit. If the same blocking condition then repeats for at least three consecutive resumed goal turns, set status to `blocked` again.",
+                "Once the blocked threshold is satisfied, do not keep reporting that you are still blocked while leaving the goal active; set status to `blocked`.",
+                "Do not use `blocked` merely because the work is hard, slow, uncertain, incomplete, or would benefit from clarification.",
                 "Do not mark a goal complete merely because its budget is nearly exhausted or because you are stopping work.",
+                "You cannot use this tool to pause, resume, budget-limit, or usage-limit a goal; those status changes are controlled by the user or system.",
+                "When marking a budgeted goal achieved with status `complete`, report the final token usage from the tool result to the user.",
             ].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: S.stringEnum(["complete", "blocked"], "Required. Set to `complete` only when the objective is achieved and no required work remains. " +
+                    "Set to `blocked` only after the same blocking condition has recurred for at least three consecutive " +
+                    "goal turns and the agent is at an impasse. After a previously blocked goal is resumed, the resumed " +
+                    "run starts a fresh blocked audit."),
             }, ["status"], false),
             strict: false,
         },

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

@@ -1 +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"}
+{"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,6GAA6G,qBAAqB,mBAAmB;aACtJ,CAAC,IAAI,CAAC,IAAI,CAAC;YACZ,UAAU,EAAE,CAAC,CAAC,MAAM,CAClB;gBACE,SAAS,EAAE,CAAC,CAAC,MAAM,CACjB,sDAAsD;oBACpD,qGAAqG,CACxG;gBACD,YAAY,EAAE,CAAC,CAAC,OAAO,CACrB,2EAA2E,CAC5E;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,oEAAoE;gBACpE,2GAA2G;gBAC3G,gSAAgS;gBAChS,gPAAgP;gBAChP,mJAAmJ;gBACnJ,yHAAyH;gBACzH,6GAA6G;gBAC7G,4IAA4I;gBAC5I,8HAA8H;aAC/H,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,gGAAgG;oBAC9F,sGAAsG;oBACtG,qGAAqG;oBACrG,mCAAmC,CACtC;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.map

@@ -1 +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"}
+{"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;AAE3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAYrE,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;IAiD9D,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;IA0B9D,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBpE,eAAe,IAAI,UAAU,GAAG,IAAI;IAMpC,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,gBAAgB;CAKzB"}

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

@@ -6,6 +6,9 @@
  * Accepts an optional GoalStore for durable persistence (SQLite, IndexedDB…).
  * Falls back to in-memory state when no store is supplied.
  */
+import { validateThreadGoalObjective } from "../../../protocol/src/protocol.js";
+/** verbatim from handle_create's ok_or_else (tool.rs:201-205) */
+const CREATE_BLOCKED_ERROR = "cannot create a new goal because this thread has an unfinished goal; complete the existing goal first";
 export class GoalToolExecutor {
     /** In-memory snapshot — always current, written through to store when present */
     snapshot = null;
@@ -17,29 +20,43 @@ export class GoalToolExecutor {
     }
     // ─── 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,
-            };
+        // mirrors handle_create (tool.rs:200) on top of create_thread_goal
+        // (goals.rs:225): an UNFINISHED goal blocks creation, but a COMPLETE one is
+        // replaced (counters reset), so a thread can start its next goal.
+        if (this.snapshot !== null && this.snapshot.status !== "Complete") {
+            return { output: JSON.stringify({ error: CREATE_BLOCKED_ERROR }), event: null };
         }
-        if (!objective) {
-            return { output: JSON.stringify({ error: "objective is required." }), event: null };
+        // mirrors handle_create (tool.rs:185-187): trim, then
+        // validate_thread_goal_objective (protocol.rs:4055).
+        const trimmedObjective = (objective ?? "").trim();
+        const objectiveError = validateThreadGoalObjective(trimmedObjective);
+        if (objectiveError !== null) {
+            return { output: JSON.stringify({ error: objectiveError }), 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,
+        // mirrors handle_create (tool.rs:190-206): the store's create is
+        // authoritative — a null result means it found an unfinished goal.
+        if (this.store) {
+            const created = await this.store.createThreadGoal(this.threadId, trimmedObjective, token_budget);
+            if (created === null) {
+                return { output: JSON.stringify({ error: CREATE_BLOCKED_ERROR }), event: null };
+            }
+            this.snapshot = created;
+            return { output: this.formatResponse(), event: this.goalUpdatedEvent() };
+        }
+        const now = Date.now();
+        this.snapshot = {
+            thread_id: this.threadId,
+            objective: trimmedObjective,
             status: "Active",
             ...(token_budget !== undefined ? { token_budget } : {}),
             tokens_used: 0,
             time_used_seconds: 0,
+            created_at: now,
+            updated_at: now,
         };
-        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 ───────────────────────────────────────────────────────────────
@@ -64,7 +81,11 @@ export class GoalToolExecutor {
         if (this.store) {
             await this.store.updateThreadGoal(this.threadId, { status: goalStatus });
         }
-        this.snapshot = { ...this.snapshot, status: goalStatus };
+        this.snapshot = {
+            ...this.snapshot,
+            status: goalStatus,
+            updated_at: Date.now(),
+        };
         return { output: this.formatResponse(), event: this.goalUpdatedEvent() };
     }
     // ─── Token accounting ───────────────────────────────────────────────────────
@@ -82,6 +103,7 @@ export class GoalToolExecutor {
             ...this.snapshot,
             tokens_used: this.snapshot.tokens_used + count,
             time_used_seconds: this.snapshot.time_used_seconds + elapsedSeconds,
+            updated_at: Date.now(),
         };
     }
     currentSnapshot() {
@@ -98,7 +120,9 @@ export class GoalToolExecutor {
         return JSON.stringify({ goal: this.snapshot, remaining_tokens });
     }
     goalUpdatedEvent() {
-        return this.snapshot ? { goal: { ...this.snapshot } } : null;
+        return this.snapshot
+            ? { thread_id: this.threadId, goal: { ...this.snapshot } }
+            : null;
     }
 }
 //# sourceMappingURL=tool.js.map

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

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

@@ -2,5 +2,6 @@ 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 { ContextCompactedEvent, WarningEvent } from "./protocol.js";
-export type { ThreadGoalStatus, ThreadGoal, TurnStartedEvent, TurnCompleteEvent, AgentMessageEvent, AgentMessageContentDeltaEvent, ThreadGoalUpdatedEvent, ErrorEvent, EventMsg, Event, Op, } from "./protocol.js";
+export { MAX_THREAD_GOAL_OBJECTIVE_CHARS, validateThreadGoalObjective, } from "./protocol.js";
+export type { ThreadGoalStatus, ThreadGoal, TurnStartedEvent, TurnCompleteEvent, TurnAbortedEvent, TurnAbortReason, AgentMessageEvent, AgentMessageContentDeltaEvent, ReasoningContentDeltaEvent, ThreadGoalUpdatedEvent, CodexErrorInfo, ErrorEvent, TokenUsage, TokenUsageInfo, TokenCountEvent, EventMsg, Event, Op, } from "./protocol.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACzE,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"}
+{"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,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EACL,+BAA+B,EAC/B,2BAA2B,GAC5B,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,6BAA6B,EAC7B,0BAA0B,EAC1B,sBAAsB,EACtB,cAAc,EACd,UAAU,EACV,UAAU,EACV,cAAc,EACd,eAAe,EACf,QAAQ,EACR,KAAK,EACL,EAAE,GACH,MAAM,eAAe,CAAC"}

package/dist/protocol/src/index.js

@@ -1,2 +1,2 @@
-export {};
+export { MAX_THREAD_GOAL_OBJECTIVE_CHARS, validateThreadGoalObjective, } from "./protocol.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../protocol/src/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../protocol/src/index.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,+BAA+B,EAC/B,2BAA2B,GAC5B,MAAM,eAAe,CAAC"}

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

@@ -9,18 +9,58 @@ import type { RequestUserInputEvent, RequestUserInputResponse } from "./request_
 import type { UpdatePlanArgs } from "./plan_tool.js";
 export type ThreadGoalStatus = "Active" | "Paused" | "Blocked" | "UsageLimited" | "BudgetLimited" | "Complete";
 export interface ThreadGoal {
+    /** mirrors ThreadGoal.thread_id (protocol.rs:4071) — the owning thread. */
+    thread_id: string;
     objective: string;
     status: ThreadGoalStatus;
     token_budget?: number | undefined;
     tokens_used: number;
     time_used_seconds: number;
+    /** Unix epoch milliseconds — mirrors created_at/updated_at (protocol.rs:4079). */
+    created_at: number;
+    updated_at: number;
 }
+/** mirrors MAX_THREAD_GOAL_OBJECTIVE_CHARS (protocol.rs:4053) */
+export declare const MAX_THREAD_GOAL_OBJECTIVE_CHARS = 4000;
+/** mirrors validate_thread_goal_objective (protocol.rs:4055) — returns the
+ *  error message, or null when the objective is acceptable. */
+export declare function validateThreadGoalObjective(value: string): string | null;
 export interface TurnStartedEvent {
     turn_id: string;
 }
+/**
+ * mirrors TurnCompleteEvent (protocol.rs:1986). codex-rs emits this at the END
+ * of EVERY turn — successful or not — carrying the terminal error when the turn
+ * failed (tasks/mod.rs:803). codex-ts mirrors that: a failing turn now emits
+ * BOTH `Error` (unchanged, for hosts that key off it) and a final
+ * `TurnComplete` with `error` set, so a host looping until TurnComplete no
+ * longer hangs on failure.
+ */
 export interface TurnCompleteEvent {
     turn_id: string;
     last_agent_message?: string | undefined;
+    /** Terminal error details when the turn completed unsuccessfully. */
+    error?: ErrorEvent | undefined;
+    /** Unix timestamp (seconds) when the turn started / completed. */
+    started_at?: number | undefined;
+    completed_at?: number | undefined;
+    /** Turn wall-clock duration in milliseconds, when known. */
+    duration_ms?: number | undefined;
+}
+/** mirrors TurnAbortReason (protocol.rs:4209). codex-ts only ever produces
+ *  `interrupted` (Op.Interrupt); the rest exist for shape parity. */
+export type TurnAbortReason = "interrupted" | "replaced" | "review_ended" | "budget_limited";
+/**
+ * mirrors TurnAbortedEvent (protocol.rs:4190). codex-rs ends an aborted turn with
+ * THIS event instead of TurnComplete (tasks/mod.rs:785-794), so an interrupted
+ * turn has its own terminal event rather than a success-shaped one.
+ */
+export interface TurnAbortedEvent {
+    turn_id?: string | undefined;
+    reason: TurnAbortReason;
+    started_at?: number | undefined;
+    completed_at?: number | undefined;
+    duration_ms?: number | undefined;
 }
 /** Full assistant text for a completed message */
 export interface AgentMessageEvent {
@@ -32,19 +72,79 @@ export interface AgentMessageContentDeltaEvent {
     item_id: string;
     delta: string;
 }
-/** Streaming reasoning (thinking) chunk — mirrors codex-rs ReasoningContentDeltaEvent.
- *  Emitted while the model streams its reasoning/thinking, before any final
- *  output_text. Lets hosts show a "thinking" state only while truly reasoning. */
+/** Streaming reasoning (thinking) chunk — mirrors codex-rs
+ *  ReasoningContentDeltaEvent (protocol.rs:1873). Emitted while the model streams
+ *  its reasoning/thinking, before any final output_text. Lets hosts show a
+ *  "thinking" state only while truly reasoning. */
 export interface ReasoningContentDeltaEvent {
     turn_id: string;
+    /** Reasoning item this delta belongs to — mirrors item_id (protocol.rs:1876). */
+    item_id: string;
     delta: string;
+    /**
+     * Which reasoning block the delta belongs to — mirrors summary_index
+     * (protocol.rs:1880). Sourced from the SSE `summary_index` for
+     * `response.reasoning_summary_text.delta` and from `content_index` for
+     * `response.reasoning_text.delta` (codex-api/src/sse/responses.rs), so hosts
+     * can keep separate reasoning blocks apart. Defaults to 0, like rs's
+     * `#[serde(default)]`.
+     */
+    summary_index: number;
 }
 export interface ThreadGoalUpdatedEvent {
+    /** mirrors ThreadGoalUpdatedEvent.thread_id (protocol.rs:4087) */
+    thread_id: string;
     turn_id?: string | undefined;
     goal: ThreadGoal;
 }
+/**
+ * mirrors codex-rs/protocol/src/protocol.rs CodexErrorInfo (protocol.rs:1758) —
+ * the client-facing error classification. codex-ts produces the subset it can
+ * actually observe over HTTP/SSE (see codexErrorInfoFor in session/retry.ts);
+ * the remaining variants are kept for shape parity with rs.
+ */
+export type CodexErrorInfo = {
+    type: "context_window_exceeded";
+} | {
+    type: "session_budget_exceeded";
+} | {
+    type: "usage_limit_exceeded";
+} | {
+    type: "server_overloaded";
+} | {
+    type: "cyber_policy";
+} | {
+    type: "http_connection_failed";
+    http_status_code?: number | undefined;
+} | {
+    type: "response_stream_connection_failed";
+    http_status_code?: number | undefined;
+} | {
+    type: "internal_server_error";
+} | {
+    type: "unauthorized";
+} | {
+    type: "bad_request";
+} | {
+    type: "sandbox_error";
+} | {
+    type: "response_stream_disconnected";
+    http_status_code?: number | undefined;
+} | {
+    type: "response_too_many_failed_attempts";
+    http_status_code?: number | undefined;
+} | {
+    type: "thread_rollback_failed";
+} | {
+    type: "other";
+};
 export interface ErrorEvent {
     message: string;
+    /**
+     * mirrors ErrorEvent.codex_error_info (protocol.rs:1925) — lets hosts branch
+     * on the error class instead of matching message text.
+     */
+    codex_error_info?: CodexErrorInfo | undefined;
     /**
      * Browser-specific extension — no equivalent in codex-rs/protocol ErrorEvent.
      * Lets hosts correlate an error with the turn that produced it (e.g. to
@@ -58,15 +158,19 @@ export type ContextCompactedEvent = Record<never, never>;
 export interface WarningEvent {
     message: string;
 }
-/** mirrors TokenUsage (protocol.rs:1919) */
+/** mirrors TokenUsage (protocol.rs:2056) */
 export interface TokenUsage {
     input_tokens: number;
     cached_input_tokens: number;
+    /** Prompt-cache WRITE tokens — mirrors cache_write_input_tokens
+     *  (protocol.rs:2063), read from `usage.input_tokens_details.cache_write_tokens`
+     *  (codex-api/src/sse/responses.rs:137). 0 when the provider omits it. */
+    cache_write_input_tokens: number;
     output_tokens: number;
     reasoning_output_tokens: number;
     total_tokens: number;
 }
-/** mirrors TokenUsageInfo (protocol.rs:1933) */
+/** mirrors TokenUsageInfo (protocol.rs:2073) */
 export interface TokenUsageInfo {
     total_token_usage: TokenUsage;
     last_token_usage: TokenUsage;
@@ -85,6 +189,11 @@ export type EventMsg = {
 } | {
     type: "TurnComplete";
     event: TurnCompleteEvent;
+}
+/** mirrors EventMsg::TurnAborted — terminal event for an interrupted turn */
+ | {
+    type: "TurnAborted";
+    event: TurnAbortedEvent;
 } | {
     type: "AgentMessage";
     event: AgentMessageEvent;

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

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

package/dist/protocol/src/protocol.js

@@ -4,5 +4,17 @@
  * Subset: Op + EventMsg variants needed for goal, request_user_input,
  * and conversation (turn lifecycle + streaming text).
  */
-export {};
+/** mirrors MAX_THREAD_GOAL_OBJECTIVE_CHARS (protocol.rs:4053) */
+export const MAX_THREAD_GOAL_OBJECTIVE_CHARS = 4_000;
+/** mirrors validate_thread_goal_objective (protocol.rs:4055) — returns the
+ *  error message, or null when the objective is acceptable. */
+export function validateThreadGoalObjective(value) {
+    if (value.length === 0) {
+        return "goal objective must not be empty";
+    }
+    if (Array.from(value).length > MAX_THREAD_GOAL_OBJECTIVE_CHARS) {
+        return `goal objective must be at most ${MAX_THREAD_GOAL_OBJECTIVE_CHARS} characters`;
+    }
+    return null;
+}
 //# sourceMappingURL=protocol.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../../protocol/src/protocol.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../../protocol/src/protocol.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgCH,iEAAiE;AACjE,MAAM,CAAC,MAAM,+BAA+B,GAAG,KAAK,CAAC;AAErD;+DAC+D;AAC/D,MAAM,UAAU,2BAA2B,CAAC,KAAa;IACvD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,kCAAkC,CAAC;IAC5C,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,+BAA+B,EAAE,CAAC;QAC/D,OAAO,kCAAkC,+BAA+B,aAAa,CAAC;IACxF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

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

@@ -14,6 +14,15 @@ export interface RequestUserInputQuestion {
 }
 export interface RequestUserInputArgs {
     questions: RequestUserInputQuestion[];
+    /**
+     * Optional auto-resolution window in milliseconds — mirrors
+     * `auto_resolution_ms` (request_user_input.rs:34). Present only when the
+     * question is useful but NON-blocking: the host may proceed with the agent's
+     * best judgment if the user does not answer within the window. Clamped to
+     * [MIN_AUTO_RESOLUTION_MS, MAX_AUTO_RESOLUTION_MS] by
+     * normalizeRequestUserInputArgs.
+     */
+    autoResolutionMs?: number | undefined;
 }
 /** Per-question answers: key = question id */
 export interface RequestUserInputAnswer {
@@ -27,5 +36,11 @@ export interface RequestUserInputEvent {
     call_id: string;
     turn_id: string;
     questions: RequestUserInputQuestion[];
+    /**
+     * Auto-resolution window forwarded from the tool call — mirrors
+     * `RequestUserInputEvent.auto_resolution_ms` (request_user_input.rs:58).
+     * Absent means the agent needs an explicit answer before continuing.
+     */
+    autoResolutionMs?: number | undefined;
 }
 //# sourceMappingURL=request_user_input.d.ts.map

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

@@ -1 +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"}
+{"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;IACtC;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,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;IACtC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC"}

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

@@ -5,5 +5,16 @@ export type UserInput = {
 } | {
     type: "image";
     image_url: string;
+}
+/**
+ * Pre-encoded audio data URI forwarded to the Responses API — mirrors
+ * `UserInput::Audio { audio_url }` (user_input.rs:41), serialized as
+ * `ContentItem::InputAudio { audio_url }` (models.rs:1778). The rs
+ * `LocalAudio`/`LocalImage` variants read from disk, so they have no browser
+ * equivalent: a host records audio and passes the data URI here directly.
+ */
+ | {
+    type: "audio";
+    audio_url: string;
 };
 //# sourceMappingURL=user_input.d.ts.map

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

@@ -1 +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"}
+{"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;AACtC;;;;;;GAMG;GACD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC"}

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

@@ -35,10 +35,24 @@ export declare class GoalStore {
     private readonly backend;
     constructor(backend?: GoalBackend);
     getThreadGoal(threadId: string): Promise<ThreadGoal | null>;
-    /** Create or replace a thread goal */
+    /** Create or replace a thread goal (mirrors replace_thread_goal, goals.rs:158) */
     replaceThreadGoal(threadId: string, objective: string, status: ThreadGoalStatus, token_budget?: number): Promise<ThreadGoal>;
+    /**
+     * Create a goal only when the thread has no goal, or its goal is already
+     * complete. mirrors create_thread_goal (goals.rs:225): upstream changed the
+     * `ON CONFLICT(thread_id) DO NOTHING` to `DO UPDATE … WHERE status =
+     * 'complete'`, so a finished goal is replaced (usage counters reset to 0)
+     * while an UNFINISHED goal still blocks creation. Returns null when blocked.
+     */
+    createThreadGoal(threadId: string, objective: string, token_budget?: number): Promise<ThreadGoal | null>;
     /** Apply a partial update to an existing goal */
     updateThreadGoal(threadId: string, update: GoalUpdate): Promise<GoalAccountingOutcome>;
+    /**
+     * Delete the thread's goal and return what was removed (null when there was
+     * none). mirrors delete_thread_goal (goals.rs:472), which upstream changed
+     * from `bool` to the deleted row so callers can report/emit it.
+     */
+    deleteThreadGoal(threadId: string): Promise<ThreadGoal | null>;
     /**
      * Record token and time usage against the active goal budget.
      * Mirrors the accounting path in GoalStore::account_tokens().

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

@@ -1 +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"}
+{"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,kFAAkF;IAC5E,iBAAiB,CACrB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,gBAAgB,EACxB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,UAAU,CAAC;IAgBtB;;;;;;OAMG;IACG,gBAAgB,CACpB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAQ7B,iDAAiD;IAC3C,gBAAgB,CACpB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,qBAAqB,CAAC;IAmBjC;;;;OAIG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IASpE;;;OAGG;IACG,aAAa,CACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,qBAAqB,CAAC;CA8BlC"}

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

@@ -30,21 +30,39 @@ export class GoalStore {
     async getThreadGoal(threadId) {
         return this.backend.getThreadGoal(threadId);
     }
-    /** Create or replace a thread goal */
+    /** Create or replace a thread goal (mirrors replace_thread_goal, goals.rs:158) */
     async replaceThreadGoal(threadId, objective, status, token_budget) {
+        const now = Date.now();
         const goal = {
+            thread_id: threadId,
             objective,
             status,
             ...(token_budget !== undefined ? { token_budget } : {}),
             tokens_used: 0,
             time_used_seconds: 0,
+            created_at: now,
+            updated_at: now,
         };
         await this.backend.saveThreadGoal(threadId, goal);
         return goal;
     }
+    /**
+     * Create a goal only when the thread has no goal, or its goal is already
+     * complete. mirrors create_thread_goal (goals.rs:225): upstream changed the
+     * `ON CONFLICT(thread_id) DO NOTHING` to `DO UPDATE … WHERE status =
+     * 'complete'`, so a finished goal is replaced (usage counters reset to 0)
+     * while an UNFINISHED goal still blocks creation. Returns null when blocked.
+     */
+    async createThreadGoal(threadId, objective, token_budget) {
+        const existing = await this.getThreadGoal(threadId);
+        if (existing !== null && existing.status !== "Complete") {
+            return null;
+        }
+        return this.replaceThreadGoal(threadId, objective, "Active", token_budget);
+    }
     /** Apply a partial update to an existing goal */
     async updateThreadGoal(threadId, update) {
-        const existing = await this.backend.getThreadGoal(threadId);
+        const existing = await this.getThreadGoal(threadId);
         if (existing === null) {
             return { kind: "Unchanged", goal: null };
         }
@@ -56,16 +74,30 @@ export class GoalStore {
                     ? {}
                     : { token_budget: update.token_budget }
                 : {}),
+            updated_at: Date.now(),
         };
         await this.backend.saveThreadGoal(threadId, updated);
         return { kind: "Updated", goal: updated };
     }
+    /**
+     * Delete the thread's goal and return what was removed (null when there was
+     * none). mirrors delete_thread_goal (goals.rs:472), which upstream changed
+     * from `bool` to the deleted row so callers can report/emit it.
+     */
+    async deleteThreadGoal(threadId) {
+        const existing = await this.getThreadGoal(threadId);
+        if (existing === null) {
+            return null;
+        }
+        await this.backend.deleteThreadGoal(threadId);
+        return existing;
+    }
     /**
      * 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);
+        const existing = await this.getThreadGoal(threadId);
         if (existing === null || existing.status !== "Active") {
             return { kind: "Unchanged", goal: existing };
         }
@@ -82,6 +114,7 @@ export class GoalStore {
             tokens_used,
             time_used_seconds,
             status,
+            updated_at: Date.now(),
         };
         await this.backend.saveThreadGoal(threadId, updated);
         const changed = status !== existing.status || tokens_used !== existing.tokens_used;