@agentex/agent 0.0.22 → 0.0.24

package/README.md

@@ -100,6 +100,64 @@ loadProvidersFromConfig({
 });
 ```
 
+**Per-call endpoint (`config.endpoint`).** When the endpoint is chosen per
+session rather than registered up front — e.g. an app that lets each user bring
+their own model — set `endpoint` on `ProviderConfig`. The library keeps no state
+and stores no config file; you pass the endpoint on the call and it is
+translated into whatever the provider's CLI understands, at spawn:
+
+```ts
+const session = await getProvider("claude").createSession({
+  cwd,
+  config: {
+    model: "sonnet", // tier alias still works — see modelMap
+    endpoint: {
+      baseUrl: "https://api.z.ai/api/anthropic",
+      authToken: "…",                 // → Authorization: Bearer (or `apiKey` → x-api-key)
+      modelMap: { sonnet: "glm-5.1" }, // alias → concrete id on the endpoint
+    },
+  },
+});
+```
+
+Translation is per provider (there is no shared wire format):
+
+| Provider | `baseUrl` / auth | `modelMap` |
+| --- | --- | --- |
+| `claude` | `ANTHROPIC_BASE_URL` + `ANTHROPIC_AUTH_TOKEN`/`ANTHROPIC_API_KEY` (`headers` → `ANTHROPIC_CUSTOM_HEADERS`) | → `ANTHROPIC_DEFAULT_{OPUS,SONNET,HAIKU,FABLE}_MODEL` |
+| `codex` | synthesized `[model_providers.custom]` block (`base_url`, `wire_api="responses"`, `env_key`) via `-c` overrides; key injected into env. Requires `baseUrl`. | ignored — Codex has no tier aliases; pass a concrete `model` |
+| others | ignored (like `allowedTools` on unsupported providers) | — |
+
+`endpoint` is applied once at spawn, so it is per-session / per-`exec`: change it
+by starting a fresh `createSession`/`exec` (resume re-applies it), never
+mid-session. Set exactly one of `authToken` / `apiKey`.
+
+**Credential hygiene (claude).** When a custom `baseUrl` is set, only the auth in
+`endpoint` reaches it — ambient `ANTHROPIC_API_KEY`/`ANTHROPIC_AUTH_TOKEN` from the
+host env is not forwarded to the third party, and ambient alternate-routing config
+(Bedrock/Vertex/Foundry) is cleared so it can't steer Claude off the endpoint.
+Pass auth explicitly. One consequence: an observability-proxy pattern (Helicone /
+LangSmith-style, where the proxy forwards using your *own* Anthropic key) no longer
+picks up the ambient key — pass it deliberately, e.g.
+`endpoint: { baseUrl, apiKey: process.env.ANTHROPIC_API_KEY }`.
+
+**Codex header safety.** Codex header values are passed to the child via env
+(`env_http_headers`), never argv, so a secret header (`Authorization`, `X-API-Key`)
+doesn't leak through `ps`. Header *names* must be TOML bare keys.
+
+**Codex speaks the Responses API.** Codex removed the Chat Completions
+(`wire_api="chat"`) protocol in Feb 2026, so a custom endpoint must implement the
+OpenAI Responses API, directly or via a translating gateway (e.g. LiteLLM). Pure
+chat-completions endpoints won't work through Codex. If you're pinned to a
+pre-Feb-2026 Codex that still needs `chat`, override it on the one-shot `exec`
+path with `extraArgs: ["-c", 'model_providers.custom.wire_api="chat"']`.
+
+Prefer derived providers when the same endpoint is reused across many calls (and
+for heavy Codex config customization); prefer `config.endpoint` when it varies
+per session and the host owns storage. To override the synthesized Codex config,
+`extraArgs` is reliable on the one-shot `exec` path (it follows the endpoint
+`-c` flags); for sessions, a derived provider is the robust path.
+
 **ACP agents.** Any agent speaking the [Agent Client Protocol](https://agentclientprotocol.com)
 is a few lines:
 

package/dist/goals/controller.d.ts

@@ -0,0 +1,106 @@
+import type { ClearGoalResult, GoalCapability, GoalOptions, GoalState, SendHandle, SetGoalResult, StreamEvent, TurnResult } from "../types.js";
+/**
+ * Everything a session must supply so the `GoalController` can run goals on its
+ * behalf. The two wiring seams every session already has — an event-dispatch
+ * point and a turn-settle point — are exposed via `dispatch` and the session
+ * calling `observe`/`onTurnSettled`.
+ */
+export interface GoalControllerDeps {
+    /** Provider type, for `goal_status` event base fields + display. */
+    providerType: string;
+    /** Current session/thread id for event base fields. */
+    getSessionId: () => string | null;
+    /**
+     * Drive one turn — a continuation, the initial kickoff, the default
+     * sentinel's meta-turn, or (for native providers) the `/goal` command itself.
+     * Usually `session.send` bound to the session.
+     */
+    send: (message: string) => Promise<SendHandle>;
+    /**
+     * Push a synthetic `goal_status` event to the host through the SAME channel
+     * the session uses for parsed events. Only the controller calls this, and
+     * only for emulation transitions — native transitions come from the parser.
+     */
+    dispatch: (event: StreamEvent) => void;
+    /** Transcript path for sentinel context. */
+    getTranscriptPath?: () => string | null;
+    /** This provider's goal capability (undefined → treated as emulated). */
+    capability?: GoalCapability;
+    /**
+     * Native arm. Implement for providers with native goal support (Claude sends
+     * `/goal <objective>`; Codex seeds thread state). Return true if armed
+     * natively — the controller then relies on parser-emitted `goal_status`
+     * events and does NOT run the emulation loop. Return false to fall back to
+     * emulation. Only invoked for `enforce:"provider"` with no custom sentinel.
+     */
+    armNative?: (objective: string) => Promise<boolean>;
+    /** Native clear (Claude sends `/goal clear`; Codex clears thread state). */
+    clearNative?: (reason: "cleared" | "blocked") => Promise<void>;
+}
+/**
+ * Capability descriptor for providers with no native goal surface. The library
+ * emulation engine enforces the goal via a sentinel + continuation loop.
+ */
+export declare const EMULATED_GOAL_CAPABILITY: GoalCapability;
+/**
+ * Provider-agnostic goal engine. Each session constructs one and delegates
+ * `setGoal`/`clearGoal`/`getGoal` to it, calls `observe(event)` for every
+ * normalized event it dispatches, and `onTurnSettled(result)` whenever a turn
+ * resolves. See internal-docs/spec-goals.md §8.
+ */
+export declare class GoalController {
+    private readonly deps;
+    private state;
+    private mode;
+    private sentinel;
+    private maxIterations;
+    private iterations;
+    /** Guards re-entrancy: meta/nested settles during evaluation are ignored. */
+    private evaluating;
+    /** One-shot: skip advancing the loop for the next settle (set on interrupt). */
+    private suspendNext;
+    /** Bumped on every set/clear so a stale in-flight loop cancels itself. */
+    private generation;
+    constructor(deps: GoalControllerDeps);
+    getGoal(): GoalState | null;
+    /**
+     * True when a non-terminal goal is active. Sessions use this to decide whether
+     * to parse + `observe()` native goal events even when the host attached no
+     * `onEvent` handler — so `getGoal()` stays accurate without a subscriber.
+     */
+    isTracking(): boolean;
+    /**
+     * Signal that the active turn was interrupted/aborted by the host. For an
+     * emulated goal this pauses the loop for one settle so the interrupt doesn't
+     * immediately trigger a fresh continuation turn. The goal stays active; the
+     * next normal turn (or a new setGoal) resumes it. clearGoal() abandons it.
+     */
+    notifyInterrupted(): void;
+    /**
+     * Restore goal state on resume — reporting only. Use with `goalStateFromEvent`
+     * / `latestGoalFromEvents` after reading a resumed session's transcript so
+     * `getGoal()` reflects the prior goal. To resume ENFORCEMENT (re-arm the
+     * sentinel/loop), call `setGoal` again; hydrate does not restart the loop.
+     */
+    hydrate(state: GoalState): void;
+    setGoal(objective: string, options?: GoalOptions): Promise<SetGoalResult>;
+    clearGoal(options?: {
+        reason?: "cleared" | "blocked";
+    }): Promise<ClearGoalResult>;
+    /**
+     * Called by the session for every normalized event it dispatches to the host.
+     * In native mode the parser is the source of truth for goal_status; adopt it.
+     */
+    observe(event: StreamEvent): void;
+    /**
+     * Called by the session whenever a turn settles. Only the emulation engine
+     * acts here; native/advisory goals are driven by provider events.
+     */
+    onTurnSettled(turn: TurnResult): Promise<void>;
+    private kickoff;
+    private makeDefaultSentinel;
+    /** Build, record, and dispatch a synthetic goal_status transition. */
+    private transition;
+    private buildEvent;
+}
+//# sourceMappingURL=controller.d.ts.map

package/dist/goals/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../src/goals/controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,WAAW,EAEX,SAAS,EACT,UAAU,EACV,aAAa,EACb,WAAW,EACX,UAAU,EACX,MAAM,aAAa,CAAC;AAerB;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,YAAY,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAClC;;;;OAIG;IACH,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/C;;;;OAIG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACvC,4CAA4C;IAC5C,iBAAiB,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACxC,yEAAyE;IACzE,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,4EAA4E;IAC5E,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE;AAID;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,cAMtC,CAAC;AAcF;;;;;GAKG;AACH,qBAAa,cAAc;IAab,OAAO,CAAC,QAAQ,CAAC,IAAI;IAZjC,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,IAAI,CAAgB;IAC5B,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,aAAa,CAAM;IAC3B,OAAO,CAAC,UAAU,CAAK;IACvB,6EAA6E;IAC7E,OAAO,CAAC,UAAU,CAAS;IAC3B,gFAAgF;IAChF,OAAO,CAAC,WAAW,CAAS;IAC5B,0EAA0E;IAC1E,OAAO,CAAC,UAAU,CAAK;gBAEM,IAAI,EAAE,kBAAkB;IAErD,OAAO,IAAI,SAAS,GAAG,IAAI;IAI3B;;;;OAIG;IACH,UAAU,IAAI,OAAO;IAIrB;;;;;OAKG;IACH,iBAAiB,IAAI,IAAI;IAIzB;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAKzB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;IA0G7E,SAAS,CAAC,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;KAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IAuD3F;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAuBjC;;;OAGG;IACG,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IA2DpD,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,mBAAmB;IAS3B,sEAAsE;IACtE,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,UAAU;CAwBnB"}

package/dist/goals/controller.js

@@ -0,0 +1,375 @@
+import { GOAL_OBJECTIVE_MAX, goalStateFromEvent, isTerminalGoalStatus, } from "./normalize.js";
+import { buildKickoffMessage, createDefaultSentinel, defaultNudge, runSentinel, } from "./sentinel.js";
+/**
+ * Capability descriptor for providers with no native goal surface. The library
+ * emulation engine enforces the goal via a sentinel + continuation loop.
+ */
+export const EMULATED_GOAL_CAPABILITY = {
+    mechanism: "emulated",
+    enforced: true,
+    statuses: ["active", "paused", "met", "blocked", "cleared"],
+    clears: "manual",
+    telemetry: false,
+};
+function nowIso() {
+    return new Date().toISOString();
+}
+async function safeBool(p) {
+    try {
+        return await p;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Provider-agnostic goal engine. Each session constructs one and delegates
+ * `setGoal`/`clearGoal`/`getGoal` to it, calls `observe(event)` for every
+ * normalized event it dispatches, and `onTurnSettled(result)` whenever a turn
+ * resolves. See internal-docs/spec-goals.md §8.
+ */
+export class GoalController {
+    deps;
+    state = null;
+    mode = "idle";
+    sentinel = null;
+    maxIterations = 12;
+    iterations = 0;
+    /** Guards re-entrancy: meta/nested settles during evaluation are ignored. */
+    evaluating = false;
+    /** One-shot: skip advancing the loop for the next settle (set on interrupt). */
+    suspendNext = false;
+    /** Bumped on every set/clear so a stale in-flight loop cancels itself. */
+    generation = 0;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    getGoal() {
+        return this.state;
+    }
+    /**
+     * True when a non-terminal goal is active. Sessions use this to decide whether
+     * to parse + `observe()` native goal events even when the host attached no
+     * `onEvent` handler — so `getGoal()` stays accurate without a subscriber.
+     */
+    isTracking() {
+        return this.state !== null && !isTerminalGoalStatus(this.state.status);
+    }
+    /**
+     * Signal that the active turn was interrupted/aborted by the host. For an
+     * emulated goal this pauses the loop for one settle so the interrupt doesn't
+     * immediately trigger a fresh continuation turn. The goal stays active; the
+     * next normal turn (or a new setGoal) resumes it. clearGoal() abandons it.
+     */
+    notifyInterrupted() {
+        if (this.mode === "emulate")
+            this.suspendNext = true;
+    }
+    /**
+     * Restore goal state on resume — reporting only. Use with `goalStateFromEvent`
+     * / `latestGoalFromEvents` after reading a resumed session's transcript so
+     * `getGoal()` reflects the prior goal. To resume ENFORCEMENT (re-arm the
+     * sentinel/loop), call `setGoal` again; hydrate does not restart the loop.
+     */
+    hydrate(state) {
+        this.state = state;
+        this.mode = "idle";
+    }
+    async setGoal(objective, options = {}) {
+        if (typeof objective !== "string" || objective.trim() === "") {
+            throw new Error("setGoal: objective must be a non-empty string");
+        }
+        if (objective.length > GOAL_OBJECTIVE_MAX) {
+            throw new RangeError(`setGoal: objective exceeds ${GOAL_OBJECTIVE_MAX} chars (got ${objective.length}); point the goal at a file instead`);
+        }
+        // Replace any active goal — emit a synthetic `cleared` for the old one.
+        if (this.state && !isTerminalGoalStatus(this.state.status)) {
+            this.transition({
+                objective: this.state.objective,
+                status: "cleared",
+                met: false,
+                enforced: this.state.enforced,
+                source: "host",
+            });
+        }
+        this.generation++;
+        const gen = this.generation;
+        this.iterations = 0;
+        this.maxIterations = options.maxIterations ?? 12;
+        this.sentinel = null;
+        this.suspendNext = false;
+        const enforce = options.enforce ?? "provider";
+        const cap = this.deps.capability;
+        const customSentinel = options.sentinel;
+        // --- advisory: record only, never gate ---
+        if (enforce === "advisory") {
+            this.mode = "advisory";
+            // Best-effort seed native state so a model-tools provider still "knows"
+            // the goal, but without any enforcement loop.
+            let nativeSeeded = false;
+            if (cap?.mechanism === "model-tools" && this.deps.armNative) {
+                nativeSeeded = await safeBool(this.deps.armNative(objective));
+            }
+            if (gen !== this.generation)
+                return { armed: false, mechanism: "emulated" };
+            if (nativeSeeded) {
+                // The native provider will emit its own `active` goal_status; set
+                // optimistic state WITHOUT dispatching (mirrors native mode) so the host
+                // doesn't see a duplicate `active`.
+                this.state = {
+                    objective,
+                    status: "active",
+                    met: false,
+                    enforced: false,
+                    source: "host",
+                    updatedAt: nowIso(),
+                };
+            }
+            else {
+                this.transition({
+                    objective,
+                    status: "active",
+                    met: false,
+                    enforced: false,
+                    source: "host",
+                });
+            }
+            return { armed: true, mechanism: cap?.mechanism ?? "emulated" };
+        }
+        // --- native passthrough (default, no custom sentinel) ---
+        const wantNative = enforce === "provider" && !customSentinel && !!this.deps.armNative;
+        if (wantNative) {
+            const armed = await safeBool(this.deps.armNative(objective));
+            if (gen !== this.generation)
+                return { armed: false, mechanism: "emulated" };
+            if (armed) {
+                this.mode = "native";
+                // Native providers emit goal_status through their parser; set optimistic
+                // state for immediate getGoal() and let `observe` reconcile. Do NOT
+                // dispatch here (the parser is the sole emitter in native mode).
+                this.state = {
+                    objective,
+                    status: "active",
+                    met: false,
+                    enforced: cap?.enforced ?? true,
+                    source: "host",
+                    updatedAt: nowIso(),
+                };
+                return {
+                    armed: true,
+                    mechanism: cap?.mechanism === "model-tools" ? "model-tools" : "sentinel",
+                };
+            }
+            // Native arm failed → fall through to emulation.
+        }
+        // --- emulation (forced, custom sentinel, or native fallback) ---
+        this.mode = "emulate";
+        this.sentinel = customSentinel ?? this.makeDefaultSentinel();
+        this.transition({
+            objective,
+            status: "active",
+            met: false,
+            enforced: true,
+            source: "agentex",
+        });
+        this.kickoff(objective, gen);
+        return { armed: true, mechanism: "emulated" };
+    }
+    async clearGoal(options = {}) {
+        if (!this.state || isTerminalGoalStatus(this.state.status)) {
+            return { cleared: false };
+        }
+        const reason = options.reason ?? "cleared";
+        const objective = this.state.objective;
+        const enforced = this.state.enforced;
+        const wasNative = this.mode === "native";
+        this.generation++; // cancel any in-flight emulation loop
+        this.mode = "idle";
+        this.sentinel = null;
+        if (wasNative && this.deps.clearNative) {
+            await this.deps.clearNative(reason).catch(() => { });
+            if (reason === "blocked") {
+                // Native providers (e.g. Codex) have no host-asserted "blocked" — their
+                // clear emits a `cleared` notification. Emit `blocked` synthetically so
+                // the host sees the intended terminal state; the observe terminal-guard
+                // then ignores the provider's trailing `cleared`.
+                this.transition({
+                    objective,
+                    status: "blocked",
+                    met: false,
+                    enforced,
+                    source: "host",
+                    blockedReason: "needs_input",
+                });
+            }
+            else {
+                // Cleared: rely on the provider's authoritative `cleared` notification;
+                // set optimistic state (no dispatch) so getGoal() is immediate.
+                this.state = {
+                    objective,
+                    status: "cleared",
+                    met: false,
+                    enforced,
+                    source: "host",
+                    updatedAt: nowIso(),
+                };
+            }
+            return { cleared: true };
+        }
+        const fields = {
+            objective,
+            status: reason === "blocked" ? "blocked" : "cleared",
+            met: false,
+            enforced,
+            source: "host",
+        };
+        if (reason === "blocked")
+            fields.blockedReason = "needs_input";
+        this.transition(fields);
+        return { cleared: true };
+    }
+    /**
+     * Called by the session for every normalized event it dispatches to the host.
+     * In native mode the parser is the source of truth for goal_status; adopt it.
+     */
+    observe(event) {
+        if (event.type !== "goal_status")
+            return;
+        // Once a goal is terminal, suppress stale late events FOR THE SAME goal (a
+        // clear-time `active`, or a `cleared` after a host-driven `blocked`) so they
+        // can't resurrect/downgrade it — but accept a genuinely NEW goal (a
+        // different, non-empty objective, e.g. the model created another).
+        if (this.state && isTerminalGoalStatus(this.state.status)) {
+            const isNewGoal = !!event.objective && event.objective !== this.state.objective;
+            if (!isNewGoal)
+                return;
+        }
+        let next = goalStateFromEvent(event);
+        // Defensive: a provider's terminal event (e.g. Codex `thread/goal/cleared`)
+        // may omit the objective. Don't let an empty objective erase the known one.
+        if (!next.objective && this.state?.objective) {
+            next = { ...next, objective: this.state.objective };
+        }
+        this.state = next;
+        if (isTerminalGoalStatus(next.status)) {
+            this.mode = "idle";
+            this.sentinel = null;
+        }
+    }
+    /**
+     * Called by the session whenever a turn settles. Only the emulation engine
+     * acts here; native/advisory goals are driven by provider events.
+     */
+    async onTurnSettled(turn) {
+        if (this.mode !== "emulate")
+            return;
+        if (this.evaluating)
+            return; // ignore the default sentinel's meta-turn + nested settles
+        if (this.suspendNext) {
+            this.suspendNext = false;
+            return;
+        } // interrupted → pause one turn
+        if (turn.status !== "completed")
+            return; // aborted/timeout/failed/max_* → don't advance
+        if (!this.state || isTerminalGoalStatus(this.state.status))
+            return;
+        if (!this.sentinel)
+            return;
+        const gen = this.generation;
+        const objective = this.state.objective;
+        this.evaluating = true;
+        try {
+            const verdict = await runSentinel(this.sentinel, {
+                objective,
+                lastTurn: turn,
+                transcriptPath: this.deps.getTranscriptPath?.() ?? null,
+                iterations: this.iterations,
+            });
+            if (gen !== this.generation)
+                return; // goal replaced/cleared during eval
+            if (verdict.met) {
+                this.transition({
+                    objective,
+                    status: "met",
+                    met: true,
+                    enforced: true,
+                    source: "sentinel",
+                });
+                this.mode = "idle";
+                this.sentinel = null;
+                return;
+            }
+            this.iterations++;
+            if (this.iterations >= this.maxIterations) {
+                this.transition({
+                    objective,
+                    status: "blocked",
+                    met: false,
+                    enforced: true,
+                    source: "agentex",
+                    blockedReason: "max_iterations",
+                });
+                this.mode = "idle";
+                this.sentinel = null;
+                return;
+            }
+            // Drive one continuation turn. Don't await its result — its own settle
+            // re-enters onTurnSettled and continues the loop.
+            const nudge = verdict.nudge ?? defaultNudge(objective, this.iterations);
+            void this.deps.send(nudge).catch(() => { });
+        }
+        finally {
+            this.evaluating = false;
+        }
+    }
+    // ---- internals ----
+    kickoff(objective, gen) {
+        if (gen !== this.generation)
+            return;
+        void this.deps.send(buildKickoffMessage(objective)).catch(() => { });
+    }
+    makeDefaultSentinel() {
+        return createDefaultSentinel({
+            metaSend: async (message) => {
+                const handle = await this.deps.send(message);
+                return handle.result;
+            },
+        });
+    }
+    /** Build, record, and dispatch a synthetic goal_status transition. */
+    transition(fields) {
+        const event = this.buildEvent(fields);
+        this.state = goalStateFromEvent(event);
+        this.deps.dispatch(event);
+    }
+    buildEvent(fields) {
+        const event = {
+            type: "goal_status",
+            objective: fields.objective,
+            status: fields.status,
+            met: fields.met,
+            enforced: fields.enforced,
+            source: fields.source,
+            timestamp: nowIso(),
+            providerType: this.deps.providerType,
+            sessionId: this.deps.getSessionId(),
+            messageId: null,
+            eventId: null,
+            turnId: null,
+            parentToolCallId: null,
+            raw: { synthetic: "goal", ...fields },
+        };
+        if (fields.blockedReason !== undefined)
+            event.blockedReason = fields.blockedReason;
+        if (fields.tokensUsed !== undefined)
+            event.tokensUsed = fields.tokensUsed;
+        if (fields.timeUsedSeconds !== undefined)
+            event.timeUsedSeconds = fields.timeUsedSeconds;
+        if (fields.tokenBudget !== undefined)
+            event.tokenBudget = fields.tokenBudget;
+        if (this.mode === "emulate")
+            event.iterations = this.iterations;
+        return event;
+    }
+}
+//# sourceMappingURL=controller.js.map

package/dist/goals/controller.js.map

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

package/dist/goals/index.d.ts

@@ -0,0 +1,6 @@
+export { GoalController, EMULATED_GOAL_CAPABILITY } from "./controller.js";
+export type { GoalControllerDeps } from "./controller.js";
+export { GOAL_OBJECTIVE_MAX, CODEX_GOAL_TOOLS, isTerminalGoalStatus, normalizeClaudeGoalAttachment, normalizeCodexGoalStatus, normalizeCodexGoalRecord, goalStateFromEvent, latestGoalFromEvents, } from "./normalize.js";
+export type { GoalStatusEvent, NormalizedGoalFields } from "./normalize.js";
+export { runSentinel, createDefaultSentinel, buildKickoffMessage, buildAssessmentPrompt, parseAssessment, defaultNudge, } from "./sentinel.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/goals/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/goals/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,6BAA6B,EAC7B,wBAAwB,EACxB,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,YAAY,GACb,MAAM,eAAe,CAAC"}

package/dist/goals/index.js

@@ -0,0 +1,4 @@
+export { GoalController, EMULATED_GOAL_CAPABILITY } from "./controller.js";
+export { GOAL_OBJECTIVE_MAX, CODEX_GOAL_TOOLS, isTerminalGoalStatus, normalizeClaudeGoalAttachment, normalizeCodexGoalStatus, normalizeCodexGoalRecord, goalStateFromEvent, latestGoalFromEvents, } from "./normalize.js";
+export { runSentinel, createDefaultSentinel, buildKickoffMessage, buildAssessmentPrompt, parseAssessment, defaultNudge, } from "./sentinel.js";
+//# sourceMappingURL=index.js.map

package/dist/goals/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/goals/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAE3E,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,6BAA6B,EAC7B,wBAAwB,EACxB,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,YAAY,GACb,MAAM,eAAe,CAAC"}

package/dist/goals/normalize.d.ts

@@ -0,0 +1,72 @@
+import type { GoalBlockedReason, GoalSource, GoalState, GoalStatus, StreamEvent } from "../types.js";
+/** Max objective length, matching both native providers (Claude + Codex). */
+export declare const GOAL_OBJECTIVE_MAX = 4000;
+/** The `goal_status` member of the StreamEvent union. */
+export type GoalStatusEvent = Extract<StreamEvent, {
+    type: "goal_status";
+}>;
+/**
+ * Codex's goal-management tool names. These surface as ordinary
+ * `tool_call`/`tool_result` events, NOT as `goal_status` — goal state is keyed
+ * off the authoritative `thread_goal_updated` notification instead. This Set is
+ * a host-facing recognizer for code that wants to spot the model managing its
+ * goal from the tool stream; the library does not consume it internally.
+ */
+export declare const CODEX_GOAL_TOOLS: Set<string>;
+/**
+ * Normalized goal fields — everything a `goal_status` event needs except the
+ * `BaseStreamEventFields` envelope. Parsers fill the envelope; the controller
+ * fills it for synthetic (emulation) transitions.
+ */
+export interface NormalizedGoalFields {
+    objective: string;
+    status: GoalStatus;
+    met: boolean;
+    enforced: boolean;
+    source: GoalSource;
+    blockedReason?: GoalBlockedReason;
+    tokensUsed?: number;
+    timeUsedSeconds?: number;
+    tokenBudget?: number;
+}
+/** A goal status is terminal when no further work happens against it. */
+export declare function isTerminalGoalStatus(status: GoalStatus): boolean;
+/**
+ * Normalize a Claude `goal_status` attachment
+ * (`{type:"goal_status", met, sentinel, condition}`) into goal fields. Returns
+ * null when the object isn't a goal_status attachment. Claude goals are always
+ * sentinel-enforced and binary (`met:false → active`, `met:true → met`).
+ */
+export declare function normalizeClaudeGoalAttachment(attachment: Record<string, unknown> | null | undefined): NormalizedGoalFields | null;
+/**
+ * Map a raw Codex goal status string into the normalized ladder. Codex's
+ * documented statuses are `active|paused|complete|budget-limited`; we also
+ * tolerate the reverse-engineered/aliased spellings (`completed`, `achieved`,
+ * `budget_limited`, `budgetLimited`, `pursuing`, `blocked`, `cleared`) so the
+ * parser survives wire drift.
+ */
+export declare function normalizeCodexGoalStatus(raw: string | null | undefined): {
+    status: GoalStatus;
+    met: boolean;
+    blockedReason?: GoalBlockedReason;
+};
+/**
+ * Normalize a Codex goal record (`{objective, status, tokensUsed?,
+ * timeUsedSeconds?, tokenBudget?}`) — as carried by `thread_goal_updated` /
+ * `thread/goal/updated` notifications or `get_goal`/`update_goal` tool output —
+ * into goal fields. Codex goals are advisory (`enforced:false`). `source`
+ * reflects who drove the transition: the model can only ever write `active`
+ * (create) and `complete` (update); other statuses come from user/system.
+ */
+export declare function normalizeCodexGoalRecord(goal: Record<string, unknown> | null | undefined, source?: GoalSource): NormalizedGoalFields | null;
+/**
+ * Fold a sequence of events into the latest goal state — the building block for
+ * resume. Pass the events read back from a transcript (`provider.transcript.read`)
+ * or any StreamEvent stream; the most recent `goal_status` wins. Returns null
+ * when no goal was ever set (or the goal's last state was terminal and you want
+ * to treat that as "no active goal", which the caller decides via `.status`).
+ */
+export declare function latestGoalFromEvents(events: Iterable<StreamEvent>): GoalState | null;
+/** Project a `goal_status` stream event back into the durable `GoalState`. */
+export declare function goalStateFromEvent(event: GoalStatusEvent): GoalState;
+//# sourceMappingURL=normalize.d.ts.map