@with-logic/elwood 0.1.2 → 0.2.0

package/dist/codex/transcript/types.d.ts

@@ -11,20 +11,14 @@
  * may be sensitive. Treat it as such; it is not a content-free/redacted channel.
  */
 export type CodexTranscriptSummary = {
-    /**
-     * The kind of activity this item represents. Drives which fields downstream
-     * activity carries: `message` (committed assistant prose), `tool_call` (a shell/exec
-     * or function invocation), `tool_result` (that call's output), `reasoning`
-     * (chain-of-thought summary text, when present), `web_search`, or `other` (any
-     * item type not specifically surfaced).
-     */
-    readonly kind: "message" | "tool_call" | "tool_result" | "reasoning" | "web_search" | "other";
     /**
      * A short, human-readable label whose meaning depends on `kind`: the message
-     * role (`assistant`) for `message`, the tool/function name for
+     * role (`assistant`) for `message`/`commentary`, the tool/function name for
      * `tool_call`, the correlating call id for `tool_result`, the web-search action
      * type (e.g. `search`/`open_page`) for `web_search`, the literal `"reasoning"`
-     * for `reasoning`, and the raw item `type` (or `"unknown"`) for `other`.
+     * for `reasoning`, and the payload item type, outer item type, role, or `"unknown"`
+     * for `other` (depending on the record being summarized). Async native question
+     * records use the `"question"` label and have no normalized text.
      */
     readonly label: string;
     /**
@@ -34,11 +28,28 @@ export type CodexTranscriptSummary = {
      * sensitive (full assistant messages, tool output, file contents) — subscribers
      * must not treat it as a content-free channel. Absent when the item has no
      * readable text — the common case for an empty reasoning summary or a non-textual
-     * payload — so treat it as optional. Never carries encrypted reasoning content,
+     * payload. It is required for `commentary`, absent for `other`, and optional
+     * for the remaining variants. It never carries encrypted reasoning content,
      * which is deliberately not surfaced (§7A.4).
      */
     readonly text?: string;
-};
+} & ({
+    /** User-facing assistant progress, distinct from a final reply. */
+    readonly kind: "commentary";
+    readonly label: "assistant";
+    readonly text: string;
+} | {
+    readonly kind: "message";
+    readonly label: "assistant";
+} | {
+    readonly kind: "reasoning";
+    readonly label: "reasoning";
+} | {
+    readonly kind: "other";
+    readonly text?: never;
+} | {
+    readonly kind: "tool_call" | "tool_result" | "web_search";
+});
 /**
  * One live, best-effort observation of a committed Codex transcript item.
  * Best-effort: the reader is bounded (fixed-size chunk reads, a max-pending

package/dist/codex/transcript/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/codex/transcript/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,WAAW,GAAG,YAAY,GAAG,OAAO,CAAC;IAC9F;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;;;;;;OASG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,8DAA8D;IAC9D,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,oFAAoF;IACpF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,qGAAqG;IACrG,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;CAC1C,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/codex/transcript/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC;;;;;;;;OAQG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,CACA;IACE,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;CAC7B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;CAC7B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC;CACvB,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,aAAa,GAAG,YAAY,CAAC;CAC3D,CACJ,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,8DAA8D;IAC9D,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,oFAAoF;IACpF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,qGAAqG;IACrG,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;CAC1C,CAAC"}

package/dist/codex/transcript/watcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../../src/codex/transcript/watcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,YAAY,EACV,oBAAoB,IAAI,eAAe,EACvC,yBAAyB,IAAI,oBAAoB,GAClD,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAMlE,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,QAAQ,CAA6C;IAE7D,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyC;IAErE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoC;IACnE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;IAEpD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA6B;gBAG/C,eAAe,EAAE,MAAM,EACvB,IAAI,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,EAC3C,OAAO,GAAE,sBAA2B;IActC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAY3B,OAAO,CAAC,OAAO;IAUf,IAAI,IAAI,IAAI;IAkBZ,KAAK,IAAI,IAAI;IAQb,MAAM,IAAI,IAAI;IAUd,IAAI,IAAI,IAAI;IASZ,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,YAAY;CAQrB"}
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../../src/codex/transcript/watcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,YAAY,EACV,oBAAoB,IAAI,eAAe,EACvC,yBAAyB,IAAI,oBAAoB,GAClD,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAMlE,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,QAAQ,CAA6C;IAE7D,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyC;IAErE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoC;IACnE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;IAEpD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA6B;gBAG/C,eAAe,EAAE,MAAM,EACvB,IAAI,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,EAC3C,OAAO,GAAE,sBAA2B;IActC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAc3B,OAAO,CAAC,OAAO;IAUf,IAAI,IAAI,IAAI;IAkBZ,KAAK,IAAI,IAAI;IAQb,MAAM,IAAI,IAAI;IAUd,IAAI,IAAI,IAAI;IASZ,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,YAAY;CAQrB"}

package/dist/codex/transcript/watcher.js

@@ -6,6 +6,7 @@
  * never OOMs or blocks the event loop, and lost committed data is surfaced through
  * bounded, content-free drop notices.
  */
+import { outsideStopInput } from "../../core/stop-input.js";
 import { BoundedTranscriptCursor } from "../../core/transcript/cursor.js";
 import { DropReporter, ReadErrorReporter } from "../../core/transcript/drops.js";
 import { drainToBudget, newTerminalBudget } from "./drain.js";
@@ -50,7 +51,7 @@ export class CodexTranscriptWatcher {
         // A scan() throw (a throwing drop/activity/warning listener) must not escape the
         // timer as an uncaught exception — contain it, stop, and route a bounded live
         // diagnostic (non-throwing recovery), mirroring Claude's poll recovery.
-        this.interval = setInterval(() => this.runScan(), this.scanIntervalMs ?? defaultScanIntervalMs);
+        this.interval = outsideStopInput(() => setInterval(() => this.runScan(), this.scanIntervalMs ?? defaultScanIntervalMs));
         this.interval.unref?.();
     }
     runScan() {

package/dist/codex/transcript/watcher.js.map

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

package/dist/codex/update/classification.d.ts

@@ -0,0 +1,27 @@
+/** Classifies one native update block for eligibility consumers (PRD §5.5, C-CODEX-12). */
+import type { NumberedOption } from "../../core/terminal-options.ts";
+export { updateScreenBanner } from "./layout.ts";
+/** Syntactic states, not authorization to write:
+ * | Frame | hasBanner | options | visible | continuation |
+ * | Banner before choices | true | [] | true | false |
+ * | Valid banner and choices | true | parsed choices | true | false |
+ * | Ambiguous bannered frame | true | undefined | true | false |
+ * | Valid bannerless choices | false | parsed choices | contains both action and safe choice | contains Skip or Continue without updating |
+ * | Other/empty frame | false | undefined/[] | false | false |
+ * Bannerless choices can identify blocking content, never authorize automation.
+ * Consumers require a current first-party banner and current attempt ownership.
+ */
+export type CodexUpdateFrame = {
+    readonly options: readonly NumberedOption[] | undefined;
+    readonly hasBanner: boolean;
+    readonly visible: boolean;
+    readonly continuation: boolean;
+};
+/** A banner blocks even before its choices paint; unknown surrounding rows cannot authorize input. */
+export declare function classifyCodexUpdateFrame(frameText: string): CodexUpdateFrame;
+/** Keeps at most the last exact viewport; instances never share terminal content. */
+export declare class CodexUpdateFrameClassifier {
+    private parsed;
+    read(text: string): CodexUpdateFrame;
+}
+//# sourceMappingURL=classification.d.ts.map

package/dist/codex/update/classification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classification.d.ts","sourceRoot":"","sources":["../../../src/codex/update/classification.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAIrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,SAAS,CAAC;IACxD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF,sGAAsG;AACtG,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAc5E;AAED,qFAAqF;AACrF,qBAAa,0BAA0B;IACrC,OAAO,CAAC,MAAM,CAA0E;IAExF,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;CAMrC"}

package/dist/codex/update/classification.js

@@ -0,0 +1,28 @@
+import { updateDialogOptions, updateScreenBanner } from "./layout.js";
+import { codexUpdateActionPattern, codexUpdateOptionPattern } from "./selection.js";
+export { updateScreenBanner } from "./layout.js";
+/** A banner blocks even before its choices paint; unknown surrounding rows cannot authorize input. */
+export function classifyCodexUpdateFrame(frameText) {
+    const hasBanner = updateScreenBanner.test(frameText);
+    const options = updateDialogOptions(frameText);
+    const choices = options ?? [];
+    return {
+        options,
+        hasBanner,
+        visible: hasBanner ||
+            (choices.some((option) => codexUpdateActionPattern.test(option.label)) &&
+                choices.some((option) => codexUpdateOptionPattern.test(option.label))),
+        continuation: !hasBanner && choices.some((option) => /continue\s*without\s*updat|skip/i.test(option.label)),
+    };
+}
+/** Keeps at most the last exact viewport; instances never share terminal content. */
+export class CodexUpdateFrameClassifier {
+    parsed;
+    read(text) {
+        if (this.parsed?.text !== text) {
+            this.parsed = { text, frame: classifyCodexUpdateFrame(text) };
+        }
+        return this.parsed.frame;
+    }
+}
+//# sourceMappingURL=classification.js.map

package/dist/codex/update/classification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classification.js","sourceRoot":"","sources":["../../../src/codex/update/classification.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAEpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAmBjD,sGAAsG;AACtG,MAAM,UAAU,wBAAwB,CAAC,SAAiB;IACxD,MAAM,SAAS,GAAG,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,OAAO,IAAI,EAAE,CAAC;IAC9B,OAAO;QACL,OAAO;QACP,SAAS;QACT,OAAO,EACL,SAAS;YACT,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,wBAAwB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACpE,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,wBAAwB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1E,YAAY,EACV,CAAC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,kCAAkC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;KAChG,CAAC;AACJ,CAAC;AAED,qFAAqF;AACrF,MAAM,OAAO,0BAA0B;IAC7B,MAAM,CAA0E;IAExF,IAAI,CAAC,IAAY;QACf,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,KAAK,IAAI,EAAE,CAAC;YAC/B,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,wBAAwB,CAAC,IAAI,CAAC,EAAE,CAAC;QAChE,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IAC3B,CAAC;CACF"}

package/dist/codex/update/evidence.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Bounded first-party option evidence for Codex updates (PRD §5.5, C-CODEX-12).
+ * Retain the current first-party block, never a union across repaints.
+ * Binding agreement alone does not authorize automation without a current banner.
+ */
+import { type NumberedOption } from "../../core/terminal-options.ts";
+export type CodexUpdateAppearanceEvidence = {
+    readonly boundOptions: ReadonlyMap<string, string>;
+    readonly hasFirstPartyEvidence: boolean;
+    readonly observedBanner: string;
+    readonly overflowed: boolean;
+};
+export declare function emptyUpdateEvidence(): CodexUpdateAppearanceEvidence;
+export declare function bannerContradictsAppearance(evidence: Pick<CodexUpdateAppearanceEvidence, "observedBanner">, frameText: string): boolean;
+export declare function withUpdateFrameEvidence(evidence: CodexUpdateAppearanceEvidence, frameText: string, isFirstPartyFrame: boolean, options?: readonly NumberedOption[]): CodexUpdateAppearanceEvidence;
+/** Partial check: rejects changed retained labels and overflow; unseen numbers are allowed. */
+export declare function retainedOptionLabelsAgree(evidence: CodexUpdateAppearanceEvidence, frameText: string, options?: readonly NumberedOption[]): boolean;
+/** Exact current bindings only; callers must also require a current validated banner. */
+export declare function currentOptionBindingsMatch(evidence: CodexUpdateAppearanceEvidence, frameText: string, options?: readonly NumberedOption[]): boolean;
+/** A removed safe binding cannot keep an earlier retry alive through renumbering. */
+export declare function retainedSafeOptionsPresent(evidence: CodexUpdateAppearanceEvidence, options: readonly NumberedOption[]): boolean;
+//# sourceMappingURL=evidence.d.ts.map

package/dist/codex/update/evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.d.ts","sourceRoot":"","sources":["../../../src/codex/update/evidence.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,cAAc,EAAmB,MAAM,gCAAgC,CAAC;AAItF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B,CAAC;AAMF,wBAAgB,mBAAmB,IAAI,6BAA6B,CAOnE;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,IAAI,CAAC,6BAA6B,EAAE,gBAAgB,CAAC,EAC/D,SAAS,EAAE,MAAM,GAChB,OAAO,CAOT;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,6BAA6B,EACvC,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,OAAO,EAC1B,OAAO,GAAE,SAAS,cAAc,EAAkC,GACjE,6BAA6B,CAmB/B;AAED,+FAA+F;AAC/F,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,6BAA6B,EACvC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,SAAS,cAAc,EAAkC,GACjE,OAAO,CAMT;AAED,yFAAyF;AACzF,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,6BAA6B,EACvC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,SAAS,cAAc,EAAkC,GACjE,OAAO,CAMT;AAOD,qFAAqF;AACrF,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,6BAA6B,EACvC,OAAO,EAAE,SAAS,cAAc,EAAE,GACjC,OAAO,CAOT"}

package/dist/codex/update/evidence.js

@@ -0,0 +1,69 @@
+/**
+ * Bounded first-party option evidence for Codex updates (PRD §5.5, C-CODEX-12).
+ * Retain the current first-party block, never a union across repaints.
+ * Binding agreement alone does not authorize automation without a current banner.
+ */
+import { numberedOptions } from "../../core/terminal-options.js";
+import { updateScreenBanner } from "./recognition.js";
+import { codexUpdateActionPattern, codexUpdateOptionPattern } from "./selection.js";
+const everyUpdateBanner = new RegExp(updateScreenBanner.source, "gim");
+const maxRetainedOptions = 32;
+const maxRetainedLabelLength = 200;
+export function emptyUpdateEvidence() {
+    return {
+        boundOptions: new Map(),
+        hasFirstPartyEvidence: false,
+        observedBanner: "",
+        overflowed: false,
+    };
+}
+export function bannerContradictsAppearance(evidence, frameText) {
+    return (evidence.observedBanner !== "" &&
+        [...frameText.matchAll(everyUpdateBanner)].some((match) => match[0].trim() !== evidence.observedBanner));
+}
+export function withUpdateFrameEvidence(evidence, frameText, isFirstPartyFrame, options = updateFrameOptions(frameText)) {
+    if (!isFirstPartyFrame)
+        return evidence;
+    const boundOptions = new Map();
+    let overflowed = evidence.overflowed;
+    for (const option of options) {
+        if (boundOptions.size >= maxRetainedOptions || option.label.length > maxRetainedLabelLength) {
+            overflowed = true;
+            continue;
+        }
+        boundOptions.set(option.number, option.label);
+    }
+    const observedBanner = evidence.observedBanner || (updateScreenBanner.exec(frameText)?.[0]?.trim() ?? "");
+    return {
+        boundOptions,
+        hasFirstPartyEvidence: evidence.hasFirstPartyEvidence || isFirstPartyFrame,
+        observedBanner,
+        overflowed,
+    };
+}
+/** Partial check: rejects changed retained labels and overflow; unseen numbers are allowed. */
+export function retainedOptionLabelsAgree(evidence, frameText, options = updateFrameOptions(frameText)) {
+    if (evidence.overflowed)
+        return false;
+    return options.every((option) => {
+        const known = evidence.boundOptions.get(option.number);
+        return known === undefined || known === option.label;
+    });
+}
+/** Exact current bindings only; callers must also require a current validated banner. */
+export function currentOptionBindingsMatch(evidence, frameText, options = updateFrameOptions(frameText)) {
+    return (evidence.hasFirstPartyEvidence &&
+        !evidence.overflowed &&
+        options.every((option) => evidence.boundOptions.get(option.number) === option.label));
+}
+/** Version fragments in the recognized banner are not selectable option rows. */
+function updateFrameOptions(frameText) {
+    return numberedOptions(frameText.replace(everyUpdateBanner, ""));
+}
+/** A removed safe binding cannot keep an earlier retry alive through renumbering. */
+export function retainedSafeOptionsPresent(evidence, options) {
+    return [...evidence.boundOptions].every(([number, label]) => !codexUpdateOptionPattern.test(label) ||
+        codexUpdateActionPattern.test(label) ||
+        options.some((option) => option.number === number && option.label === label));
+}
+//# sourceMappingURL=evidence.js.map

package/dist/codex/update/evidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.js","sourceRoot":"","sources":["../../../src/codex/update/evidence.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAuB,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AASpF,MAAM,iBAAiB,GAAG,IAAI,MAAM,CAAC,kBAAkB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AACvE,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAC9B,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAEnC,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,YAAY,EAAE,IAAI,GAAG,EAAE;QACvB,qBAAqB,EAAE,KAAK;QAC5B,cAAc,EAAE,EAAE;QAClB,UAAU,EAAE,KAAK;KAClB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,QAA+D,EAC/D,SAAiB;IAEjB,OAAO,CACL,QAAQ,CAAC,cAAc,KAAK,EAAE;QAC9B,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAC7C,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,QAAQ,CAAC,cAAc,CACvD,CACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,QAAuC,EACvC,SAAiB,EACjB,iBAA0B,EAC1B,UAAqC,kBAAkB,CAAC,SAAS,CAAC;IAElE,IAAI,CAAC,iBAAiB;QAAE,OAAO,QAAQ,CAAC;IACxC,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC/C,IAAI,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC;IACrC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,YAAY,CAAC,IAAI,IAAI,kBAAkB,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,sBAAsB,EAAE,CAAC;YAC5F,UAAU,GAAG,IAAI,CAAC;YAClB,SAAS;QACX,CAAC;QACD,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC;IACD,MAAM,cAAc,GAClB,QAAQ,CAAC,cAAc,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACrF,OAAO;QACL,YAAY;QACZ,qBAAqB,EAAE,QAAQ,CAAC,qBAAqB,IAAI,iBAAiB;QAC1E,cAAc;QACd,UAAU;KACX,CAAC;AACJ,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,yBAAyB,CACvC,QAAuC,EACvC,SAAiB,EACjB,UAAqC,kBAAkB,CAAC,SAAS,CAAC;IAElE,IAAI,QAAQ,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IACtC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE;QAC9B,MAAM,KAAK,GAAG,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACvD,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,MAAM,CAAC,KAAK,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,0BAA0B,CACxC,QAAuC,EACvC,SAAiB,EACjB,UAAqC,kBAAkB,CAAC,SAAS,CAAC;IAElE,OAAO,CACL,QAAQ,CAAC,qBAAqB;QAC9B,CAAC,QAAQ,CAAC,UAAU;QACpB,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,CACrF,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,SAAS,kBAAkB,CAAC,SAAiB;IAC3C,OAAO,eAAe,CAAC,SAAS,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,0BAA0B,CACxC,QAAuC,EACvC,OAAkC;IAElC,OAAO,CAAC,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,KAAK,CACrC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,CAClB,CAAC,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC;QACrC,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC;QACpC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK,CAAC,CAC/E,CAAC;AACJ,CAAC"}

package/dist/codex/update/layout.d.ts

@@ -0,0 +1,7 @@
+/** Bound update choices to one current dialog block (PRD §5.5, C-CODEX-12). */
+import { type NumberedOption } from "../../core/terminal-options.ts";
+/** Versioned and alternate native banners; a version pair, when present, identifies an appearance. */
+export declare const updateScreenBanner: RegExp;
+/** Unknown content after choices, or numbered scrollback before the banner, is ambiguous. */
+export declare function updateDialogOptions(frame: string): readonly NumberedOption[] | undefined;
+//# sourceMappingURL=layout.d.ts.map

package/dist/codex/update/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../src/codex/update/layout.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,OAAO,EAAE,KAAK,cAAc,EAAmB,MAAM,gCAAgC,CAAC;AAEtF,sGAAsG;AACtG,eAAO,MAAM,kBAAkB,QACsH,CAAC;AAEtJ,6FAA6F;AAC7F,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,cAAc,EAAE,GAAG,SAAS,CAQxF"}

package/dist/codex/update/layout.js

@@ -0,0 +1,65 @@
+/** Bound update choices to one current dialog block (PRD §5.5, C-CODEX-12). */
+import { numberedOptions } from "../../core/terminal-options.js";
+/** Versioned and alternate native banners; a version pair, when present, identifies an appearance. */
+export const updateScreenBanner = /^[^\S\r\n]*(?:✨[^\S\r\n]*)?(?:Update available!\s+\d+\.\d+\.\d+\s*(?:->|→)\s*\d+\.\d+\.\d+|A new version of Codex is available[.!]?)[^\S\r\n]*$/im;
+/** Unknown content after choices, or numbered scrollback before the banner, is ambiguous. */
+export function updateDialogOptions(frame) {
+    const rows = frame.split("\n");
+    const bannerRow = rows.findIndex((row) => updateScreenBanner.test(row));
+    const banner = rows[bannerRow]?.trim();
+    if (rows.some((row) => updateScreenBanner.test(row) && row.trim() !== banner))
+        return undefined;
+    const before = bannerRow < 0 ? [] : rows.slice(0, bannerRow);
+    if (before.some((row) => /(?:^|[\s›>])\d+[.)]/.test(row)))
+        return undefined;
+    return parseOptionBody(rows.slice(bannerRow + 1), bannerRow >= 0);
+}
+function parseOptionBody(body, hasBanner) {
+    const optionRows = [];
+    let footer = false;
+    for (const row of body) {
+        if (row.trim() === "")
+            continue;
+        if (/^\s*[›>]?\s*\d+[.)]\s*\S/.test(row)) {
+            if (footer)
+                return undefined;
+            optionRows.push(row);
+            continue;
+        }
+        if (optionRows.length > 0) {
+            if (/^\s*Press enter to continue\s*$/i.test(row)) {
+                footer = true;
+                continue;
+            }
+            const previous = optionRows.at(-1);
+            if (!footer && wrappedUpdateAction(previous, row)) {
+                optionRows[optionRows.length - 1] = `${previous} ${row.trim()}`;
+                continue;
+            }
+            return undefined;
+        }
+        if (!(hasBanner && updateHeaderRow(row)))
+            return undefined;
+    }
+    return orderedNativeOptions(numberedOptions(optionRows.join("\n")));
+}
+function orderedNativeOptions(options) {
+    if (options.some((option, index) => !nativeOptionLabel(option.label) ||
+        (index > 0 && Number(option.number) <= Number(options[index - 1].number))))
+        return undefined;
+    return options;
+}
+const nativeAction = "Update now (runs `sh -c 'curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_NON_INTERACTIVE=1 sh'`)";
+function nativeOptionLabel(label) {
+    return (/^(?:Update now|Skip(?: until next version)?|Continue without updating|Not now|Later)$/i.test(label) ||
+        label === "Update now (runs `npm install -g @openai/codex`)" ||
+        (label.startsWith("Update now (runs `") && nativeAction.startsWith(label)));
+}
+function wrappedUpdateAction(previous, row) {
+    return /Update now \(runs `[^`]*$/.test(previous) && /^ {4,}\S/.test(row);
+}
+function updateHeaderRow(row) {
+    return (updateScreenBanner.test(row) ||
+        /^\s*Release notes: https:\/\/github\.com\/openai\/codex\/releases\/latest\s*$/.test(row));
+}
+//# sourceMappingURL=layout.js.map

package/dist/codex/update/layout.js.map

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

package/dist/codex/update/recognition.d.ts

@@ -0,0 +1,3 @@
+export { updateScreenBanner } from "./layout.ts";
+export declare function codexUpdatePromptVisible(frameText: string): boolean;
+//# sourceMappingURL=recognition.d.ts.map

package/dist/codex/update/recognition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recognition.d.ts","sourceRoot":"","sources":["../../../src/codex/update/recognition.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEnE"}

package/dist/codex/update/recognition.js

@@ -0,0 +1,7 @@
+/** Recognizes native update appearances and continuation rows (PRD §5.5, C-CODEX-12). */
+import { classifyCodexUpdateFrame } from "./classification.js";
+export { updateScreenBanner } from "./layout.js";
+export function codexUpdatePromptVisible(frameText) {
+    return classifyCodexUpdateFrame(frameText).visible;
+}
+//# sourceMappingURL=recognition.js.map

package/dist/codex/update/recognition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recognition.js","sourceRoot":"","sources":["../../../src/codex/update/recognition.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,UAAU,wBAAwB,CAAC,SAAiB;IACxD,OAAO,wBAAwB,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC;AACrD,CAAC"}

package/dist/codex/update/selection.d.ts

@@ -0,0 +1,7 @@
+/** Selects the safe Codex update option in native menu order (PRD §5.5, C-CODEX-12). */
+import type { NumberedOption } from "../../core/terminal-options.ts";
+export declare const codexUpdateOptionPattern: RegExp;
+export declare const codexUpdateActionPattern: RegExp;
+/** Initial dispatch and retries must never select a skip-shaped row before the action. */
+export declare function safeUpdateOption(frameText: string, options?: readonly NumberedOption[]): NumberedOption | undefined;
+//# sourceMappingURL=selection.d.ts.map

package/dist/codex/update/selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../../src/codex/update/selection.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGrE,eAAO,MAAM,wBAAwB,QAAqD,CAAC;AAC3F,eAAO,MAAM,wBAAwB,QAAkB,CAAC;AAExD,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,SAAS,cAAc,EAAyC,GACxE,cAAc,GAAG,SAAS,CAO5B"}

package/dist/codex/update/selection.js

@@ -0,0 +1,10 @@
+import { updateDialogOptions } from "./layout.js";
+export const codexUpdateOptionPattern = /continue\s*without\s*updat|skip|not\s*now|later/i;
+export const codexUpdateActionPattern = /update\s+now/i;
+/** Initial dispatch and retries must never select a skip-shaped row before the action. */
+export function safeUpdateOption(frameText, options = updateDialogOptions(frameText) ?? []) {
+    const actionIndex = options.findIndex((option) => codexUpdateActionPattern.test(option.label));
+    const candidates = actionIndex < 0 ? options : options.slice(actionIndex + 1);
+    return candidates.find((option) => codexUpdateOptionPattern.test(option.label) && !codexUpdateActionPattern.test(option.label));
+}
+//# sourceMappingURL=selection.js.map

package/dist/codex/update/selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.js","sourceRoot":"","sources":["../../../src/codex/update/selection.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,CAAC,MAAM,wBAAwB,GAAG,kDAAkD,CAAC;AAC3F,MAAM,CAAC,MAAM,wBAAwB,GAAG,eAAe,CAAC;AAExD,0FAA0F;AAC1F,MAAM,UAAU,gBAAgB,CAC9B,SAAiB,EACjB,UAAqC,mBAAmB,CAAC,SAAS,CAAC,IAAI,EAAE;IAEzE,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,wBAAwB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/F,MAAM,UAAU,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;IAC9E,OAAO,UAAU,CAAC,IAAI,CACpB,CAAC,MAAM,EAAE,EAAE,CACT,wBAAwB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAC9F,CAAC;AACJ,CAAC"}

package/dist/codex/update/skip-attempt.d.ts

@@ -0,0 +1,25 @@
+/** Reconcile a bounded update attempt with its owning appearance (PRD §5.5, C-CODEX-12). */
+import type { AutomationWriteResult } from "../../core/startup/barrier.ts";
+import type { StartupWriteCompletion } from "../../core/startup/write.ts";
+import type { TrustClearance } from "../../core/trust/clearance.ts";
+import type { TrustWriteResult } from "../../core/trust/responder.ts";
+import type { CodexUpdatePromptTracker } from "./tracker.ts";
+type UpdateSkipRequest = {
+    readonly option: string;
+    readonly generation: number;
+    readonly screenText: string;
+    readonly tracker: CodexUpdatePromptTracker;
+    readonly writeAutomation: (input: string) => TrustWriteResult | Promise<AutomationWriteResult>;
+    readonly readFrame: (() => string) | undefined;
+    readonly signal: AbortSignal;
+    readonly clearance: TrustClearance;
+    readonly inputHeld: () => boolean;
+    readonly releaseLatch: () => void;
+};
+type UpdateSkipAttempt = {
+    readonly settled: Promise<StartupWriteCompletion>;
+    readonly observeClearance: (frame: string) => void;
+};
+export declare function startCodexUpdateSkip(request: UpdateSkipRequest): UpdateSkipAttempt;
+export {};
+//# sourceMappingURL=skip-attempt.d.ts.map

package/dist/codex/update/skip-attempt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skip-attempt.d.ts","sourceRoot":"","sources":["../../../src/codex/update/skip-attempt.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAE1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAE7D,KAAK,iBAAiB,GAAG;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CAAC;IAC3C,QAAQ,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,gBAAgB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC/F,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,IAAI,CAAC;CACnC,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAClD,QAAQ,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACpD,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,CAgElF"}

package/dist/codex/update/skip-attempt.js

@@ -0,0 +1,64 @@
+import { trustGateVisible } from "../../core/trust/blocking.js";
+import { writeCodexUpdateSkip } from "../update-prompt.js";
+import { safeUpdateOption } from "./selection.js";
+export function startCodexUpdateSkip(request) {
+    const { tracker, generation, readFrame, screenText, signal, releaseLatch } = request;
+    const completion = Promise.withResolvers();
+    const retries = new AbortController();
+    const retrySignal = AbortSignal.any([signal, retries.signal]);
+    const sameUpdate = tracker.currentFramePredicate();
+    const current = (frame) => !retrySignal.aborted && sameUpdate(frame) && !trustGateVisible(frame, "codex");
+    const invalidated = (frame) => trustGateVisible(frame, "codex") || request.inputHeld();
+    const ownsAttempt = () => !(signal.aborted || tracker.hasSupersedingGeneration(generation));
+    let written = false;
+    let cleared = false;
+    const finish = (result) => {
+        completion.resolve(result);
+        retries.abort();
+    };
+    const answerIfCleared = () => {
+        if (!retries.signal.aborted && written && cleared && ownsAttempt())
+            finish("answered");
+    };
+    void writeCodexUpdateSkip(request.option, request.writeAutomation, readFrame, current, invalidated, retrySignal, request.clearance, () => {
+        written = true;
+        answerIfCleared();
+    }, (frame) => safeUpdateOption(frame, tracker.classify(frame).options)).then((result) => {
+        if (retries.signal.aborted)
+            return;
+        if (!ownsAttempt() || result === "exhausted" || result === "unobserved") {
+            finish("cancelled");
+            return;
+        }
+        if (result === "cancelled")
+            releaseLatch();
+        finish(result);
+    }, (error) => {
+        if (retries.signal.aborted)
+            return;
+        if (signal.aborted)
+            return finish("cancelled");
+        const replaced = tracker.hasSupersedingGeneration(generation);
+        if (!replaced)
+            releaseLatch();
+        // The live screen can clear before the next responder observation.
+        if (!current(readFrame?.() ?? screenText))
+            return finish("cancelled");
+        completion.reject(error);
+        retries.abort();
+    });
+    return {
+        settled: completion.promise,
+        observeClearance(frame) {
+            if (retries.signal.aborted || readFrame === undefined || !ownsAttempt())
+                return;
+            if (invalidated(frame) || !request.clearance(frame))
+                return;
+            // Keep this attempt's native edge before queued input can repaint it. A
+            // pending write still has to fulfill; withheld/rejected writes never answer.
+            cleared = true;
+            answerIfCleared();
+        },
+    };
+}
+//# sourceMappingURL=skip-attempt.js.map

package/dist/codex/update/skip-attempt.js.map

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

package/dist/codex/update/tracker.d.ts

@@ -0,0 +1,37 @@
+/** Tracks native update generations for bounded automation (PRD §5.5, C-CODEX-12). */
+import type { TrustClearance } from "../../core/trust/clearance.ts";
+import { type CodexUpdateFrame } from "./classification.ts";
+/** Tracks update eligibility separately from the session’s retained input hold. */
+export declare class CodexUpdatePromptTracker {
+    private readonly frames;
+    private evidence;
+    private active;
+    private generation;
+    private requiresBanner;
+    private pendingClearance;
+    private readonly clearance;
+    private readonly deferClearance;
+    /** Live responders confirm after classification; standalone callers use the supplied clearance. */
+    constructor(clearance?: TrustClearance, deferClearance?: boolean);
+    /** Identifies the current appearance; it changes when the screen clears, appears, or revokes an attempt. */
+    get currentGeneration(): number;
+    /** Ordinary frames need no clearance parsing without a pending or revoked update. */
+    get needsClearance(): boolean;
+    /** A replacement revokes the attempt; its positive clear is only `generation + 1`. */
+    hasSupersedingGeneration(generation: number): boolean;
+    appearanceChanged(frameText: string): boolean;
+    /** Fresh unambiguous evidence gives a revoked generation its own bounded grace. */
+    renewsAttention(frameText: string): boolean;
+    /** Cache only this instance’s most recent exact viewport classification. */
+    classify(frameText: string): CodexUpdateFrame;
+    observe(frameText: string): boolean;
+    /** Only a current banner and validated block may authorize a write. */
+    private observeEvidence;
+    /** Only a fresh complete bounded block may retire an overflowed appearance. */
+    private freshBoundedEvidence;
+    /** Called after the current frame's live clearance and retained input hold are known. */
+    observeClearance(cleared: boolean): void;
+    /** Captures the current prompt generation so an async retry cannot enter a later dialog. */
+    currentFramePredicate(): (frameText: string) => boolean;
+}
+//# sourceMappingURL=tracker.d.ts.map

package/dist/codex/update/tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../../src/codex/update/tracker.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,OAAO,EAAE,KAAK,gBAAgB,EAA8B,MAAM,qBAAqB,CAAC;AAYxF,mFAAmF;AACnF,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAC3D,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,gBAAgB,CAAS;IAEjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;IACzC,mGAAmG;gBACvF,SAAS,GAAE,cAAuC,EAAE,cAAc,UAAQ;IAKtF,4GAA4G;IAC5G,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED,qFAAqF;IACrF,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,sFAAsF;IACtF,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIrD,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAkB7C,mFAAmF;IACnF,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAY3C,4EAA4E;IAC5E,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB;IAI7C,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IA0CnC,uEAAuE;IACvE,OAAO,CAAC,eAAe;IAsBvB,+EAA+E;IAC/E,OAAO,CAAC,oBAAoB;IAU5B,yFAAyF;IACzF,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAQxC,4FAA4F;IAC5F,qBAAqB,IAAI,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO;CAcxD"}