@with-logic/elwood 0.1.2 → 0.2.0

package/dist/codex/update/tracker.js

@@ -0,0 +1,156 @@
+import { codexComposerClearance } from "../screen/clearance.js";
+import { CodexUpdateFrameClassifier } from "./classification.js";
+import { bannerContradictsAppearance, currentOptionBindingsMatch, emptyUpdateEvidence, retainedOptionLabelsAgree, retainedSafeOptionsPresent, withUpdateFrameEvidence, } from "./evidence.js";
+import { updateScreenBanner } from "./layout.js";
+import { safeUpdateOption } from "./selection.js";
+/** Tracks update eligibility separately from the session’s retained input hold. */
+export class CodexUpdatePromptTracker {
+    frames = new CodexUpdateFrameClassifier();
+    evidence = emptyUpdateEvidence();
+    active = false;
+    generation = 0;
+    requiresBanner = false;
+    pendingClearance = false;
+    clearance;
+    deferClearance;
+    /** Live responders confirm after classification; standalone callers use the supplied clearance. */
+    constructor(clearance = codexComposerClearance, deferClearance = false) {
+        this.clearance = clearance;
+        this.deferClearance = deferClearance;
+    }
+    /** Identifies the current appearance; it changes when the screen clears, appears, or revokes an attempt. */
+    get currentGeneration() {
+        return this.generation;
+    }
+    /** Ordinary frames need no clearance parsing without a pending or revoked update. */
+    get needsClearance() {
+        return this.pendingClearance || this.requiresBanner;
+    }
+    /** A replacement revokes the attempt; its positive clear is only `generation + 1`. */
+    hasSupersedingGeneration(generation) {
+        return this.generation > generation + 1;
+    }
+    appearanceChanged(frameText) {
+        const banner = updateScreenBanner.exec(frameText)?.[0].trim();
+        const options = this.classify(frameText).options;
+        return (this.active &&
+            banner !== undefined &&
+            !bannerContradictsAppearance({ observedBanner: banner }, frameText) &&
+            (bannerContradictsAppearance(this.evidence, frameText) ||
+                (options !== undefined &&
+                    safeUpdateOption(frameText, options) !== undefined &&
+                    !this.evidence.overflowed &&
+                    !(retainedOptionLabelsAgree(this.evidence, frameText, options) &&
+                        retainedSafeOptionsPresent(this.evidence, options)))));
+    }
+    /** Fresh unambiguous evidence gives a revoked generation its own bounded grace. */
+    renewsAttention(frameText) {
+        const frame = this.classify(frameText);
+        return (frame.options !== undefined &&
+            (!this.evidence.overflowed ||
+                this.appearanceChanged(frameText) ||
+                this.freshBoundedEvidence(frameText, frame)) &&
+            (!this.requiresBanner || safeUpdateOption(frameText, frame.options) !== undefined) &&
+            (this.appearanceChanged(frameText) || (this.requiresBanner && frame.hasBanner)));
+    }
+    /** Cache only this instance’s most recent exact viewport classification. */
+    classify(frameText) {
+        return this.frames.read(frameText);
+    }
+    observe(frameText) {
+        // Missing classification cannot lend a provisional clear to another frame.
+        if (this.pendingClearance)
+            this.observeClearance(false);
+        if (this.appearanceChanged(frameText)) {
+            this.generation += 1;
+            this.active = false;
+            this.evidence = emptyUpdateEvidence();
+        }
+        const frame = this.classify(frameText);
+        const validEvidence = this.observeEvidence(frameText, frame);
+        if (frame.visible && this.active && !this.requiresBanner && !validEvidence) {
+            // Retire the attempt and its positive-clear edge; ambiguity is not success.
+            this.generation += 2;
+            this.requiresBanner = true;
+        }
+        if (frame.visible) {
+            if (!this.active)
+                this.generation += 1;
+            if (validEvidence &&
+                this.requiresBanner &&
+                frame.hasBanner &&
+                safeUpdateOption(frameText, frame.options)) {
+                this.generation += 1;
+                this.requiresBanner = false;
+            }
+            this.active = true;
+            if (!validEvidence)
+                this.requiresBanner = true;
+        }
+        else {
+            if (this.active) {
+                this.generation += 1;
+                this.requiresBanner = true;
+                this.pendingClearance = true;
+            }
+            this.active = false;
+            this.evidence = emptyUpdateEvidence();
+            if (!this.deferClearance && this.needsClearance)
+                this.observeClearance(this.clearance(frameText));
+        }
+        return this.active;
+    }
+    /** Only a current banner and validated block may authorize a write. */
+    observeEvidence(frameText, frame) {
+        const firstParty = frame.hasBanner;
+        if (this.freshBoundedEvidence(frameText, frame))
+            this.evidence = emptyUpdateEvidence();
+        const priorBindingsAgree = frame.options !== undefined &&
+            retainedOptionLabelsAgree(this.evidence, frameText, frame.options) &&
+            retainedSafeOptionsPresent(this.evidence, frame.options);
+        if (firstParty && frame.options !== undefined) {
+            this.evidence = withUpdateFrameEvidence(this.evidence, frameText, true, frame.options);
+        }
+        if (frame.visible) {
+            this.evidence = {
+                ...this.evidence,
+                observedBanner: this.evidence.observedBanner || (updateScreenBanner.exec(frameText)?.[0]?.trim() ?? ""),
+            };
+        }
+        return (firstParty && frame.options !== undefined && !this.evidence.overflowed && priorBindingsAgree);
+    }
+    /** Only a fresh complete bounded block may retire an overflowed appearance. */
+    freshBoundedEvidence(frameText, frame) {
+        return (this.requiresBanner &&
+            frame.hasBanner &&
+            frame.options !== undefined &&
+            safeUpdateOption(frameText, frame.options) !== undefined &&
+            !withUpdateFrameEvidence(emptyUpdateEvidence(), frameText, true, frame.options).overflowed);
+    }
+    /** Called after the current frame's live clearance and retained input hold are known. */
+    observeClearance(cleared) {
+        if (this.pendingClearance) {
+            if (!cleared)
+                this.generation += 1;
+            this.pendingClearance = false;
+        }
+        if (cleared && !this.active)
+            this.requiresBanner = false;
+    }
+    /** Captures the current prompt generation so an async retry cannot enter a later dialog. */
+    currentFramePredicate() {
+        const generation = this.generation;
+        return (frameText) => {
+            if (!(this.active && !this.requiresBanner && this.generation === generation))
+                return false;
+            if (bannerContradictsAppearance(this.evidence, frameText))
+                return false;
+            const frame = this.classify(frameText);
+            return (frame.hasBanner &&
+                frame.options !== undefined &&
+                retainedSafeOptionsPresent(this.evidence, frame.options) &&
+                currentOptionBindingsMatch(this.evidence, frameText, frame.options));
+        };
+    }
+}
+//# sourceMappingURL=tracker.js.map

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

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

package/dist/codex/update-identity.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The identity an update-skip attempt captures, so a post-settlement check can prove the
+ * settled frame is still the dialog it started on. Implements PRD §5.5 / C-CODEX-12 (#42).
+ */
+import { type NumberedOption } from "../core/terminal-options.ts";
+/**
+ * The identity of the update choice an attempt captured: the dialog's own non-option
+ * text plus the exact option it decided to press (number AND label). Modelled on
+ * `choiceIdentity` in the trust responder, for the same reason — a post-settlement check
+ * must prove the frame is still the ONE the attempt started on, not merely that it looks
+ * similar. Nothing outside this tuple can satisfy the guard: a new generation repaints
+ * different non-option text, a renumbered dialog changes the number, a replacement
+ * dialog changes the label, and an unrelated prompt changes all three (#42).
+ */
+export declare function codexUpdateChoiceIdentity(frameText: string, option: NumberedOption): string;
+/**
+ * The post-settlement guard an attempt binds to its key: the settled frame must still be
+ * the dialog the attempt captured. Named and exported rather than an inline closure so
+ * every branch is directly testable — `stillThisUpdate` carries the generation check,
+ * and the identity comparison carries the dialog and option.
+ */
+export declare function settledFrameKeepsChoice(settledFrame: string, capturedIdentity: string, optionNumber: string, stillThisUpdate: (frameText: string) => boolean): boolean;
+//# sourceMappingURL=update-identity.d.ts.map

package/dist/codex/update-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-identity.d.ts","sourceRoot":"","sources":["../../src/codex/update-identity.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,cAAc,EAAkC,MAAM,6BAA6B,CAAC;AAGlG;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,MAAM,CAe3F;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,EACpB,gBAAgB,EAAE,MAAM,EACxB,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,GAC9C,OAAO,CAOT"}

package/dist/codex/update-identity.js

@@ -0,0 +1,46 @@
+/**
+ * The identity an update-skip attempt captures, so a post-settlement check can prove the
+ * settled frame is still the dialog it started on. Implements PRD §5.5 / C-CODEX-12 (#42).
+ */
+import { nonOptionText, numberedOptions } from "../core/terminal-options.js";
+import { updateScreenBanner } from "./update/recognition.js";
+/**
+ * The identity of the update choice an attempt captured: the dialog's own non-option
+ * text plus the exact option it decided to press (number AND label). Modelled on
+ * `choiceIdentity` in the trust responder, for the same reason — a post-settlement check
+ * must prove the frame is still the ONE the attempt started on, not merely that it looks
+ * similar. Nothing outside this tuple can satisfy the guard: a new generation repaints
+ * different non-option text, a renumbered dialog changes the number, a replacement
+ * dialog changes the label, and an unrelated prompt changes all three (#42).
+ */
+export function codexUpdateChoiceIdentity(frameText, option) {
+    // The banner carries the version pair, which is what distinguishes one appearance of
+    // the update screen from the next; `nonOptionText` alone can be empty when the caret
+    // row is parsed as an option, which would make two generations look identical.
+    const banner = updateScreenBanner.exec(frameText)?.[0]?.trim() ?? "";
+    const labels = numberedOptions(frameText)
+        .map((candidate) => `${candidate.number}:${candidate.label}`)
+        .join("|");
+    return JSON.stringify([
+        nonOptionText(frameText).trim(),
+        banner,
+        labels,
+        option.number,
+        option.label,
+    ]);
+}
+/**
+ * The post-settlement guard an attempt binds to its key: the settled frame must still be
+ * the dialog the attempt captured. Named and exported rather than an inline closure so
+ * every branch is directly testable — `stillThisUpdate` carries the generation check,
+ * and the identity comparison carries the dialog and option.
+ */
+export function settledFrameKeepsChoice(settledFrame, capturedIdentity, optionNumber, stillThisUpdate) {
+    if (!stillThisUpdate(settledFrame))
+        return false;
+    const settledOption = numberedOptions(settledFrame).find((candidate) => candidate.number === optionNumber);
+    if (settledOption === undefined)
+        return false;
+    return codexUpdateChoiceIdentity(settledFrame, settledOption) === capturedIdentity;
+}
+//# sourceMappingURL=update-identity.js.map

package/dist/codex/update-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-identity.js","sourceRoot":"","sources":["../../src/codex/update-identity.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAuB,aAAa,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAClG,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;;;;;;GAQG;AACH,MAAM,UAAU,yBAAyB,CAAC,SAAiB,EAAE,MAAsB;IACjF,qFAAqF;IACrF,qFAAqF;IACrF,+EAA+E;IAC/E,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACrE,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC;SACtC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;SAC5D,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,aAAa,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE;QAC/B,MAAM;QACN,MAAM;QACN,MAAM,CAAC,MAAM;QACb,MAAM,CAAC,KAAK;KACb,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,YAAoB,EACpB,gBAAwB,EACxB,YAAoB,EACpB,eAA+C;IAE/C,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC;QAAE,OAAO,KAAK,CAAC;IACjD,MAAM,aAAa,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC,IAAI,CACtD,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,KAAK,YAAY,CACjD,CAAC;IACF,IAAI,aAAa,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC9C,OAAO,yBAAyB,CAAC,YAAY,EAAE,aAAa,CAAC,KAAK,gBAAgB,CAAC;AACrF,CAAC"}

package/dist/codex/update-prompt.d.ts

@@ -1,23 +1,32 @@
 /**
- * Recognizes first-party Codex in-TUI update screens and their safe options.
- * Implements PRD §5.5 and C-CODEX-12 for both prompt automation and input blocking.
+ * Orchestrates guarded Codex update-skip writes and bounded retries (PRD §5.5, C-CODEX-12).
+ * Active classification lives in update/classification.ts and update/layout.ts;
+ * update/recognition.ts is the visibility facade.
  */
+import { type InputTerminal } from "../core/input/abort.ts";
+import { type AutomationWriteResult, type NonTrustAutomationWriter } 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";
-export declare const codexUpdateOptionPattern: RegExp;
+import { safeUpdateOption } from "./update/selection.ts";
+/** The Codex non-trust automation barrier, with update-option revalidation bound in. */
+export declare function guardedCodexAutomationWrite(terminal: InputTerminal, write: NonTrustAutomationWriter, readFrame: () => string, signal?: AbortSignal): (input: string, perWrite?: (frameText: string) => boolean) => Promise<AutomationWriteResult>;
 /**
- * A captured first-party banner alone counts so a partial layout fails safe
- * before its options paint. Generic "update available" prose does not count;
- * an option-only frame must carry both the update and safe choices.
+ * Revalidates an update-skip key against the SETTLED frame. The option number was read
+ * from a pre-settle frame, so a replacement or renumbered update screen can move the safe
+ * choice; sending the old number would select whatever now sits at that position. Keys
+ * that are not update-screen option numbers (other automation) are left alone.
  */
-export declare function codexUpdatePromptVisible(frameText: string): boolean;
-/** Keeps a split prompt blocking until a frame with no update evidence clears it. */
-export declare class CodexUpdatePromptTracker {
-    private active;
-    private generation;
-    observe(frameText: string): boolean;
-    /** Captures the current prompt generation so an async retry cannot enter a later dialog. */
-    currentFramePredicate(): (frameText: string) => boolean;
-}
-/** Retries a possibly swallowed startup hotkey only while its safe option remains visible. */
-export declare function writeCodexUpdateSkip(option: string, write: (input: string) => TrustWriteResult, readFrame?: () => string, currentUpdateFrame?: (frameText: string) => boolean): Promise<void>;
+export declare function codexOptionStillSafe(frameText: string, input: string): boolean;
+/** `exhausted`: the retry budget ended while the safe option was still visible. */
+export type CodexUpdateSkipCompletion = StartupWriteCompletion | "exhausted" | "unobserved";
+/**
+ * Retries a possibly swallowed startup hotkey only while its safe option remains visible.
+ *
+ * `answered` requires a fulfilled physical write and positive native composer
+ * clearance with no invalidating session input hold. Unknown replacements and
+ * missing readers cannot prove success; an unobserved fulfilled write remains
+ * latched so persistent frames cannot start another skip (C-CODEX-12/17).
+ */
+export declare function writeCodexUpdateSkip(option: string, write: (input: string, perWrite?: (frameText: string) => boolean) => TrustWriteResult | Promise<AutomationWriteResult>, readFrame?: () => string, currentUpdateFrame?: (frameText: string) => boolean, invalidated?: (frameText: string) => boolean, signal?: AbortSignal, clearance?: TrustClearance, onWritten?: () => void, selectOption?: typeof safeUpdateOption): Promise<CodexUpdateSkipCompletion>;
 //# sourceMappingURL=update-prompt.d.ts.map

package/dist/codex/update-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-prompt.d.ts","sourceRoot":"","sources":["../../src/codex/update-prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,eAAO,MAAM,wBAAwB,QAAqD,CAAC;AAI3F;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAOnE;AAED,qFAAqF;AACrF,qBAAa,wBAAwB;IACnC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAK;IAEvB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAWnC,4FAA4F;IAC5F,qBAAqB,IAAI,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO;CAOxD;AAYD,8FAA8F;AAC9F,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,gBAAgB,EAC1C,SAAS,CAAC,EAAE,MAAM,MAAM,EACxB,kBAAkB,GAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAkC,GAC5E,OAAO,CAAC,IAAI,CAAC,CAmBf"}
+{"version":3,"file":"update-prompt.d.ts","sourceRoot":"","sources":["../../src/codex/update-prompt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,aAAa,EAAgB,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EACL,KAAK,qBAAqB,EAE1B,KAAK,wBAAwB,EAC9B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAInE,OAAO,EAA4B,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAMnF,wFAAwF;AACxF,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,aAAa,EACvB,KAAK,EAAE,wBAAwB,EAC/B,SAAS,EAAE,MAAM,MAAM,EACvB,MAAM,CAAC,EAAE,WAAW,GACnB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAY9F;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAU9E;AAED,mFAAmF;AACnF,MAAM,MAAM,yBAAyB,GAAG,sBAAsB,GAAG,WAAW,GAAG,YAAY,CAAC;AAE5F;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,CACL,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,KACtC,gBAAgB,GAAG,OAAO,CAAC,qBAAqB,CAAC,EACtD,SAAS,CAAC,EAAE,MAAM,MAAM,EACxB,kBAAkB,GAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAmD,EAC9F,WAAW,GAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAqB,EACzD,MAAM,CAAC,EAAE,WAAW,EACpB,SAAS,GAAE,cAAuC,EAClD,SAAS,CAAC,EAAE,MAAM,IAAI,EACtB,YAAY,GAAE,OAAO,gBAAmC,GACvD,OAAO,CAAC,yBAAyB,CAAC,CAiCpC"}

package/dist/codex/update-prompt.js

@@ -1,78 +1,81 @@
 /**
- * Recognizes first-party Codex in-TUI update screens and their safe options.
- * Implements PRD §5.5 and C-CODEX-12 for both prompt automation and input blocking.
+ * Orchestrates guarded Codex update-skip writes and bounded retries (PRD §5.5, C-CODEX-12).
+ * Active classification lives in update/classification.ts and update/layout.ts;
+ * update/recognition.ts is the visibility facade.
  */
-import { nonOptionText, numberedOptions } from "../core/terminal-options.js";
-export const codexUpdateOptionPattern = /continue\s*without\s*updat|skip|not\s*now|later/i;
-const updateScreenBanner = /^[^\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;
+import { waitForInput } from "../core/input/abort.js";
+import { guardedNonTrustAutomationWrite, } from "../core/startup/barrier.js";
+import { codexComposerClearance } from "./screen/clearance.js";
+import { classifyCodexUpdateFrame } from "./update/classification.js";
+import { updateScreenBanner } from "./update/recognition.js";
+import { codexUpdateOptionPattern, safeUpdateOption } from "./update/selection.js";
+import { codexUpdateChoiceIdentity, settledFrameKeepsChoice } from "./update-identity.js";
+const retryIntervalMs = 250;
+const retryTimeoutMs = 5_000;
+/** The Codex non-trust automation barrier, with update-option revalidation bound in. */
+export function guardedCodexAutomationWrite(terminal, write, readFrame, signal) {
+    // The generation-aware predicate is supplied PER WRITE by `writeCodexUpdateSkip`, so an
+    // older attempt can never validate against a newer appearance's state (#42 round 3).
+    return guardedNonTrustAutomationWrite(terminal, write, readFrame, "codex", codexOptionStillSafe, () => signal?.aborted ?? false, signal);
+}
 /**
- * A captured first-party banner alone counts so a partial layout fails safe
- * before its options paint. Generic "update available" prose does not count;
- * an option-only frame must carry both the update and safe choices.
+ * Revalidates an update-skip key against the SETTLED frame. The option number was read
+ * from a pre-settle frame, so a replacement or renumbered update screen can move the safe
+ * choice; sending the old number would select whatever now sits at that position. Keys
+ * that are not update-screen option numbers (other automation) are left alone.
  */
-export function codexUpdatePromptVisible(frameText) {
-    if (updateScreenBanner.test(frameText))
+export function codexOptionStillSafe(frameText, input) {
+    if (!/^\d+$/.test(input))
         return true;
-    const options = numberedOptions(frameText);
-    return (options.some((option) => /update\s+now/i.test(option.label)) &&
-        options.some((option) => codexUpdateOptionPattern.test(option.label)));
-}
-/** Keeps a split prompt blocking until a frame with no update evidence clears it. */
-export class CodexUpdatePromptTracker {
-    active = false;
-    generation = 0;
-    observe(frameText) {
-        if (codexUpdatePromptVisible(frameText)) {
-            if (!this.active)
-                this.generation += 1;
-            this.active = true;
-        }
-        else if (!(this.active && isSafeUpdateContinuation(frameText))) {
-            if (this.active)
-                this.generation += 1;
-            this.active = false;
-        }
-        return this.active;
-    }
-    /** Captures the current prompt generation so an async retry cannot enter a later dialog. */
-    currentFramePredicate() {
-        const generation = this.generation;
-        return (frameText) => this.active &&
-            this.generation === generation &&
-            (codexUpdatePromptVisible(frameText) || isSafeUpdateContinuation(frameText));
-    }
-}
-function isSafeUpdateContinuation(frameText) {
-    if (nonOptionText(frameText).trim() !== "")
+    const frame = classifyCodexUpdateFrame(frameText);
+    const options = frame.options ?? [];
+    // The current first-party banner is required even when old option bindings match.
+    // Bannerless choices remain input-blocking evidence, never write authorization.
+    if (!frame.hasBanner || options.length === 0)
         return false;
-    return numberedOptions(frameText).some((option) => /continue\s*without\s*updat|skip/i.test(option.label));
+    return options.some((option) => option.number === input && codexUpdateOptionPattern.test(option.label));
 }
-const retryIntervalMs = 250;
-const retryTimeoutMs = 5_000;
-/** Retries a possibly swallowed startup hotkey only while its safe option remains visible. */
-export async function writeCodexUpdateSkip(option, write, readFrame, currentUpdateFrame = codexUpdatePromptVisible) {
+/**
+ * Retries a possibly swallowed startup hotkey only while its safe option remains visible.
+ *
+ * `answered` requires a fulfilled physical write and positive native composer
+ * clearance with no invalidating session input hold. Unknown replacements and
+ * missing readers cannot prove success; an unobserved fulfilled write remains
+ * latched so persistent frames cannot start another skip (C-CODEX-12/17).
+ */
+export async function writeCodexUpdateSkip(option, write, readFrame, currentUpdateFrame = (frame) => updateScreenBanner.test(frame), invalidated = () => false, signal, clearance = codexComposerClearance, onWritten, selectOption = safeUpdateOption) {
+    const eligible = (frame) => updateScreenBanner.test(frame) && currentUpdateFrame(frame);
     if (readFrame === undefined) {
-        await write(option);
-        return;
+        // A fulfilled write alone cannot prove the dialog cleared.
+        return (await write(option, eligible)) === "withheld" ? "cancelled" : "unobserved";
     }
     const deadline = Date.now() + retryTimeoutMs;
+    let wrote = false;
     while (Date.now() < deadline) {
         const frame = readFrame();
-        if (!currentUpdateFrame(frame))
-            return;
-        const safeOption = numberedOptions(frame).find((candidate) => codexUpdateOptionPattern.test(candidate.label));
-        if (safeOption === undefined) {
-            throw new Error("Codex update prompt no longer exposes a safe skip option.");
+        if (!eligible(frame)) {
+            const cleared = wrote && clearance(frame) && !invalidated(frame);
+            return cleared ? "answered" : "cancelled";
         }
-        await write(safeOption.number);
-        await wait(retryIntervalMs);
+        const safeOption = selectOption(frame);
+        if (safeOption === undefined)
+            return "cancelled";
+        // A guarded writer settles rendering before the key goes out, so it may report the
+        // key WITHHELD (a trust gate, or this option number no longer the safe one on the
+        // settled frame). That is not an answer: leave the screen unanswered for a human
+        // rather than counting a key nobody sent (C-CODEX-12, C-TRUST-01).
+        // Bind the write to the identity captured HERE: the same generation predicate AND
+        // the exact dialog/option this attempt decided on. The settled frame must still be
+        // that one, so a later generation, a renumbered dialog, a replacement dialog, or an
+        // unrelated prompt offering a "Skip" all fail the guard rather than take this key.
+        const identity = codexUpdateChoiceIdentity(frame, safeOption);
+        const stillThisChoice = (settledFrame) => settledFrameKeepsChoice(settledFrame, identity, safeOption.number, eligible);
+        if ((await write(safeOption.number, stillThisChoice)) === "withheld")
+            return "cancelled";
+        wrote = true;
+        onWritten?.();
+        await waitForInput(retryIntervalMs, signal);
     }
-    throw new Error("Codex update prompt did not clear after safe-option retries.");
-}
-function wait(ms) {
-    return new Promise((resolve) => {
-        const timer = setTimeout(resolve, ms);
-        timer.unref();
-    });
+    return "exhausted";
 }
 //# sourceMappingURL=update-prompt.js.map

package/dist/codex/update-prompt.js.map

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

package/dist/core/activity/index.d.ts

@@ -4,17 +4,18 @@
  */
 import type { ClaudeHookEvent } from "../../claude/hooks/index.ts";
 import type { CodexHookEvent } from "../../codex/hooks/index.ts";
+import type { ElwoodQuestionEvent } from "../questions/types.ts";
 import type { ElwoodSessionStatus, ElwoodWarningEvent, HookErrorEvent } from "../types.ts";
 export type ElwoodAgentKind = "claude" | "codex";
 export type ElwoodActivitySource = "hook" | "transcript" | "terminal" | "lifecycle";
-export type ElwoodActivityKind = "status" | "terminal_exit" | "user_message" | "assistant_message" | "reasoning" | "tool_call" | "tool_result" | "web_search" | "other" | "notification" | "warning" | "startup_prompt" | "attention" | "hook" | "hook_result" | "hook_error";
-export type ElwoodActivityEvent = {
+export type ElwoodActivityKind = "status" | "terminal_exit" | "user_message" | "assistant_message" | "assistant_progress" | "question" | "reasoning" | "tool_call" | "tool_result" | "web_search" | "other" | "notification" | "warning" | "startup_prompt" | "attention" | "hook" | "hook_result" | "hook_error";
+type ActivityFields = {
     readonly elwoodSessionId: string;
     readonly agent: ElwoodAgentKind;
     readonly source: ElwoodActivitySource;
-    readonly kind: ElwoodActivityKind;
     readonly label: string;
     readonly text?: string;
+    readonly promptGeneration?: number;
     readonly hookEventName?: string;
     readonly turnId?: string;
     readonly toolName?: string;
@@ -27,6 +28,26 @@ export type ElwoodActivityEvent = {
     readonly transcriptPath?: string;
     readonly raw?: unknown;
 };
+/** Distribute the agent-and-phase event union so the activity label, nested phase,
+ * and both agent fields stay correlated. */
+type QuestionActivityFields<Event extends ElwoodQuestionEvent = ElwoodQuestionEvent> = Event extends ElwoodQuestionEvent ? {
+    readonly kind: "question";
+    readonly agent: Event["agent"];
+    readonly source: "terminal";
+    readonly label: Event["phase"];
+    readonly question: Event;
+} : never;
+export type ElwoodActivityEvent = ActivityFields & ({
+    readonly kind: Exclude<ElwoodActivityKind, "question" | "assistant_progress">;
+} | {
+    readonly kind: "assistant_progress";
+    readonly agent: "codex";
+    readonly source: "transcript";
+    readonly label: "assistant";
+    readonly text: string;
+    readonly transcriptPath: string;
+    readonly raw: unknown;
+} | QuestionActivityFields);
 export { activityFromStatus, activityFromTerminalExit, reapFailureWarning, } from "./lifecycle.ts";
 /**
  * Claude hook → activity. Agent/event correlation stops a Claude event routing

package/dist/core/activity/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/activity/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG3F,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,OAAO,CAAC;AACjD,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,YAAY,GAAG,UAAU,GAAG,WAAW,CAAC;AACpF,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,eAAe,GACf,cAAc,GACd,mBAAmB,GACnB,WAAW,GACX,WAAW,GACX,aAAa,GACb,YAAY,GACZ,OAAO,GACP,cAAc,GACd,SAAS,GACT,gBAAgB,GAChB,WAAW,GACX,MAAM,GACN,aAAa,GACb,YAAY,CAAC;AAEjB,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAgBxB;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,eAAe,GACrB,mBAAmB,CAIrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,cAAc,GACpB,mBAAmB,CAIrB;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,cAAc,GACpB,mBAAmB,CAWrB;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,eAAe,EACtB,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,OAAO,GAClB,mBAAmB,CAWrB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,kBAAkB,GAAG,mBAAmB,CAUlF;AAED,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/activity/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG3F,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,OAAO,CAAC;AACjD,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,YAAY,GAAG,UAAU,GAAG,WAAW,CAAC;AACpF,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,eAAe,GACf,cAAc,GACd,mBAAmB,GACnB,oBAAoB,GACpB,UAAU,GACV,WAAW,GACX,WAAW,GACX,aAAa,GACb,YAAY,GACZ,OAAO,GACP,cAAc,GACd,SAAS,GACT,gBAAgB,GAChB,WAAW,GACX,MAAM,GACN,aAAa,GACb,YAAY,CAAC;AAEjB,KAAK,cAAc,GAAG;IACpB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF;4CAC4C;AAC5C,KAAK,sBAAsB,CAAC,KAAK,SAAS,mBAAmB,GAAG,mBAAmB,IACjF,KAAK,SAAS,mBAAmB,GAC7B;IACE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;CAC1B,GACD,KAAK,CAAC;AAEZ,MAAM,MAAM,mBAAmB,GAAG,cAAc,GAC9C,CACI;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,kBAAkB,EAAE,UAAU,GAAG,oBAAoB,CAAC,CAAA;CAAE,GACjF;IACE,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CACvB,GACD,sBAAsB,CACzB,CAAC;AAEJ,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAgBxB;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,eAAe,GACrB,mBAAmB,CAIrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,cAAc,GACpB,mBAAmB,CAIrB;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,cAAc,GACpB,mBAAmB,CAWrB;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,eAAe,EACtB,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,OAAO,GAClB,mBAAmB,CAWrB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,kBAAkB,GAAG,mBAAmB,CAUlF;AAED,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC"}

package/dist/core/activity/index.js.map

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

package/dist/core/activity/meta.d.ts

@@ -7,7 +7,12 @@ import type { CodexHookEvent } from "../../codex/hooks/index.ts";
 import { type CodexTranscriptEvent } from "../../codex/transcript/index.ts";
 import type { ElwoodActivityEvent, ElwoodAgentKind } from "./index.ts";
 export declare function hookActivityBase(agent: ElwoodAgentKind, elwoodSessionId: string, event: ClaudeHookEvent | CodexHookEvent): Omit<ElwoodActivityEvent, "kind" | "label" | "text">;
-export declare function transcriptActivityMeta(event: CodexTranscriptEvent): Partial<ElwoodActivityEvent>;
+type OptionalTranscriptMeta = Pick<ElwoodActivityEvent, "turnId" | "toolName" | "toolUseId" | "toolInput" | "toolOutput">;
+type TranscriptActivityMeta = OptionalTranscriptMeta & {
+    readonly transcriptPath: string;
+};
+export declare function transcriptActivityMeta(event: CodexTranscriptEvent): TranscriptActivityMeta;
 export declare function record(value: unknown): Record<string, unknown>;
 export declare function stringValue(value: unknown): string | undefined;
+export {};
 //# sourceMappingURL=meta.d.ts.map

package/dist/core/activity/meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../../src/core/activity/meta.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,KAAK,oBAAoB,EAAkB,MAAM,iCAAiC,CAAC;AAE5F,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEvE,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,eAAe,EACtB,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,eAAe,GAAG,cAAc,GACtC,IAAI,CAAC,mBAAmB,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC,CAYtD;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAUhG;AAqBD,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAI9D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAE9D"}
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../../src/core/activity/meta.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,KAAK,oBAAoB,EAAkB,MAAM,iCAAiC,CAAC;AAE5F,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEvE,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,eAAe,EACtB,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,eAAe,GAAG,cAAc,GACtC,IAAI,CAAC,mBAAmB,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC,CAYtD;AAED,KAAK,sBAAsB,GAAG,IAAI,CAChC,mBAAmB,EACnB,QAAQ,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,GAAG,YAAY,CACjE,CAAC;AACF,KAAK,sBAAsB,GAAG,sBAAsB,GAAG;IAAE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3F,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,oBAAoB,GAAG,sBAAsB,CAU1F;AAqBD,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAI9D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAE9D"}

package/dist/core/activity/meta.js.map

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