@agentex/agent 0.0.21 → 0.0.23

package/README.md

@@ -64,7 +64,7 @@ Providers fall into three tiers:
 
 > `cursor` stays one-shot until `cursor-agent` ships an ACP mode; it can then move to Tier 2 via `extends: "acp"`.
 
-Capabilities (sessions, modes, skills, workspaces, MCP, model discovery, quota probing, instructions, concurrent send, cancel queued messages) are declared on each module's `capabilities` field — check `provider.capabilities` to branch on what's supported. ACP providers set `dynamicCapabilities: true` (their real capability set is negotiated at the ACP `initialize` handshake). Skill-aware providers also report:
+Capabilities (sessions, modes, skills, workspaces, MCP, model discovery, quota probing, instructions, concurrent send, cancel queued messages, stop task) are declared on each module's `capabilities` field — check `provider.capabilities` to branch on what's supported. ACP providers set `dynamicCapabilities: true` (their real capability set is negotiated at the ACP `initialize` handshake). Skill-aware providers also report:
 
 - `skillInventory` — `"provider-init"` for Claude's runtime inventory, `"local-discovery"` for Codex, or `"none"`.
 - `skillInvocation` — `"native-slash"` for Claude, `"expanded-prompt"` for Codex, `"configured-only"`, or `"unsupported"`.
@@ -416,6 +416,31 @@ else console.log("Too late — the agent already drained it.");
 
 > **Race note.** Cancellation is best-effort. If the CLI drained the message mid-turn (Claude's `query.ts` between-tool-batches drain) before your `cancel()` request landed, you get `{ cancelled: false }` — and the message will be visible to the model as a `<system-reminder>`. The library does not unmount what the model has already seen.
 
+### Stopping one background task
+
+A turn can spawn work that outlives it — a backgrounded shell (`next dev`, a test watcher) or an async subagent. For providers with `capabilities.stopTask = true` (Claude only), `session.stopTask(taskId)` kills **one** such task without disturbing the session or its other tasks. This is distinct from `interrupt()` (ends the whole active turn, and can't reach a detached background process) and `close()` (kills the entire session).
+
+```typescript
+// taskId comes from a background-task lifecycle event (see below).
+const { stopped } = await session.stopTask(taskId);
+if (stopped) console.log("Asked the CLI to kill that task.");
+```
+
+`stopTask()` is always callable. For providers with `stopTask = false` it returns `{ stopped: false }` immediately. For Claude it sends a `stop_task` control_request; the **CLI/harness** owns the process and performs the kill (the model is never in the loop). The acknowledgement carries no payload, so `stopped: true` just means "accepted" — an unknown or already-ended `taskId` (or a closed session) yields `{ stopped: false }`. The task's terminal status arrives asynchronously on the event stream as its next `task_updated` / `task_notification`.
+
+Background-task lifecycle events (`task_started`, `task_progress`, `task_updated`, `task_notification`) reach you as `type: "unknown"` StreamEvents (Claude emits them as `system` subtypes; only `system`+`init` gets its own typed variant, so the rest fall through the forward-compat escape hatch with the payload on `raw`). Use `getClaudeTaskDetails(event)` to decode one into typed fields — `{ phase, taskId, taskType, status, usage, … }` — or `null` if it isn't a task event. It's a stateless per-event decode, not a reducer: `status` reflects only the event in hand (and `task_updated` is a sparse `patch`), so collapsing a task's events into one current state over its lifetime is the consumer's job.
+
+```typescript
+import { getClaudeTaskDetails } from "@agentex/agent";
+
+createSession({
+  onEvent(event) {
+    const task = getClaudeTaskDetails(event);
+    if (task?.phase === "started") console.log("background task:", task.taskId, task.description);
+  },
+});
+```
+
 ### Graceful shutdown with `drain()`
 
 `close()` kills the process (SIGTERM → SIGKILL after `graceSec`, default 5) — fine for "stop now," wrong when a tool is mid-flight. `drain()` is the graceful stop: it refuses new `send()` calls (they throw), waits for any in-flight turn's `result` to settle, then closes. Use it for budget gates, `SIGTERM` handlers, and schedule pauses where a running turn should finish rather than be cut off.

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/goals/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACV,SAAS,EACT,UAAU,EACV,WAAW,EACZ,MAAM,aAAa,CAAC;AAErB,6EAA6E;AAC7E,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC,yDAAyD;AACzD,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,WAAW,EAAE;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC,CAAC;AAE5E;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,aAAsD,CAAC;AAEpF;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB,GAAG,EAAE,OAAO,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,yEAAyE;AACzE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAEhE;AAMD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACrD,oBAAoB,GAAG,IAAI,CAW7B;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG;IACxE,MAAM,EAAE,UAAU,CAAC;IACnB,GAAG,EAAE,OAAO,CAAC;IACb,aAAa,CAAC,EAAE,iBAAiB,CAAC;CACnC,CAqBA;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EAChD,MAAM,GAAE,UAAoB,GAC3B,oBAAoB,GAAG,IAAI,CAwB7B;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,SAAS,GAAG,IAAI,CAMpF;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,SAAS,CAepE"}