@ccpocket/bridge 1.63.6 → 1.65.0

package/dist/codex-process.d.ts

@@ -1,5 +1,5 @@
 import { EventEmitter } from "node:events";
-import type { ServerMessage, ProcessStatus } from "./parser.js";
+import type { CodexGoal, CodexGoalStatus, ServerMessage, ProcessStatus } from "./parser.js";
 import { buildCodexSpawnSpec } from "./codex-transport.js";
 export { buildCodexSpawnSpec };
 export interface CodexStartOptions {
@@ -11,7 +11,7 @@ export interface CodexStartOptions {
     codexPermissionsMode?: "default" | "autoReview" | "fullAccess" | "custom";
     sandboxMode?: "read-only" | "workspace-write" | "danger-full-access";
     model?: string;
-    modelReasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh";
+    modelReasoningEffort?: string;
     networkAccessEnabled?: boolean;
     webSearchMode?: "disabled" | "cached" | "live";
     collaborationMode?: "plan" | "default";
@@ -164,6 +164,15 @@ export declare class CodexProcess extends EventEmitter<CodexProcessEvents> {
      * Sends thread/name/set which persists to ~/.codex/session_index.jsonl.
      */
     renameThread(name: string): Promise<void>;
+    /** Read the persisted goal attached to this Codex thread. */
+    getGoal(): Promise<CodexGoal | null>;
+    /** Create or update the persisted goal attached to this Codex thread. */
+    setGoal(update: {
+        objective?: string;
+        status?: CodexGoalStatus;
+    }): Promise<CodexGoal>;
+    /** Remove the persisted goal attached to this Codex thread. */
+    clearGoal(): Promise<boolean>;
     /**
      * Archive a Codex thread via the app-server `thread/archive` RPC.
      * Accepts an explicit threadId so that historical (non-active) sessions
@@ -294,3 +303,5 @@ export declare class CodexProcess extends EventEmitter<CodexProcessEvents> {
     private extractToolUseId;
     private handleServerRequestResolved;
 }
+/** Validate the app-server ThreadGoal payload at the process boundary. */
+export declare function parseCodexGoal(value: unknown): CodexGoal;

package/dist/codex-process.js

@@ -179,6 +179,43 @@ export class CodexProcess extends EventEmitter {
             name,
         });
     }
+    /** Read the persisted goal attached to this Codex thread. */
+    async getGoal() {
+        if (!this._threadId) {
+            throw new Error("No thread ID available for goal lookup");
+        }
+        const response = (await this.request("thread/goal/get", {
+            threadId: this._threadId,
+        }));
+        return response.goal == null ? null : parseCodexGoal(response.goal);
+    }
+    /** Create or update the persisted goal attached to this Codex thread. */
+    async setGoal(update) {
+        if (!this._threadId) {
+            throw new Error("No thread ID available for goal update");
+        }
+        const response = (await this.request("thread/goal/set", {
+            threadId: this._threadId,
+            ...(update.objective !== undefined
+                ? { objective: update.objective.trim() }
+                : {}),
+            ...(update.status !== undefined ? { status: update.status } : {}),
+        }));
+        return parseCodexGoal(response.goal);
+    }
+    /** Remove the persisted goal attached to this Codex thread. */
+    async clearGoal() {
+        if (!this._threadId) {
+            throw new Error("No thread ID available for goal clear");
+        }
+        const response = (await this.request("thread/goal/clear", {
+            threadId: this._threadId,
+        }));
+        if (typeof response.cleared !== "boolean") {
+            throw new Error("thread/goal/clear returned an invalid response");
+        }
+        return response.cleared;
+    }
     /**
      * Archive a Codex thread via the app-server `thread/archive` RPC.
      * Accepts an explicit threadId so that historical (non-active) sessions
@@ -1388,6 +1425,22 @@ export class CodexProcess extends EventEmitter {
                 // Name change notification — handled by session manager
                 break;
             }
+            case "thread/goal/updated": {
+                try {
+                    this.emitMessage({
+                        type: "goal_state",
+                        goal: parseCodexGoal(params.goal),
+                    });
+                }
+                catch (err) {
+                    console.warn(`[codex-process] Ignoring invalid goal notification: ${err instanceof Error ? err.message : String(err)}`);
+                }
+                break;
+            }
+            case "thread/goal/cleared": {
+                this.emitMessage({ type: "goal_state", goal: null });
+                break;
+            }
             case "thread/tokenUsage/updated": {
                 const usage = params.usage;
                 if (usage) {
@@ -2149,9 +2202,15 @@ function extractReasoningEfforts(raw) {
     const seen = new Set();
     const efforts = [];
     for (const value of values) {
-        if (typeof value !== "string")
+        const effort = typeof value === "string"
+            ? value
+            : value && typeof value === "object"
+                ? (value.reasoningEffort ??
+                    value.effort)
+                : undefined;
+        if (typeof effort !== "string")
             continue;
-        const normalized = value.trim();
+        const normalized = effort.trim();
         if (!normalized || seen.has(normalized))
             continue;
         seen.add(normalized);
@@ -2235,6 +2294,48 @@ function notificationThreadId(params) {
     }
     return null;
 }
+const CODEX_GOAL_STATUSES = new Set([
+    "active",
+    "paused",
+    "blocked",
+    "usageLimited",
+    "budgetLimited",
+    "complete",
+]);
+/** Validate the app-server ThreadGoal payload at the process boundary. */
+export function parseCodexGoal(value) {
+    if (!value || typeof value !== "object") {
+        throw new Error("Goal payload is missing");
+    }
+    const goal = value;
+    const status = goal.status;
+    const requiredNumbers = [
+        "tokensUsed",
+        "timeUsedSeconds",
+        "createdAt",
+        "updatedAt",
+    ];
+    if (typeof goal.threadId !== "string" ||
+        typeof goal.objective !== "string" ||
+        !CODEX_GOAL_STATUSES.has(status) ||
+        requiredNumbers.some((field) => typeof goal[field] !== "number" ||
+            !Number.isFinite(goal[field])) ||
+        (goal.tokenBudget !== null &&
+            (typeof goal.tokenBudget !== "number" ||
+                !Number.isFinite(goal.tokenBudget)))) {
+        throw new Error("Goal payload has an invalid shape");
+    }
+    return {
+        threadId: goal.threadId,
+        objective: goal.objective,
+        status,
+        tokenBudget: goal.tokenBudget,
+        tokensUsed: goal.tokensUsed,
+        timeUsedSeconds: goal.timeUsedSeconds,
+        createdAt: goal.createdAt,
+        updatedAt: goal.updatedAt,
+    };
+}
 function numberOrUndefined(value) {
     return typeof value === "number" && Number.isFinite(value)
         ? value