@with-logic/elwood 0.1.2 → 0.2.0

package/dist/core/questions/validate.js

@@ -0,0 +1,95 @@
+/** Validate a complete answer batch before native input (PRD §4). */
+import { sanitizePasteText } from "../input/sanitize.js";
+import { questionError } from "./errors.js";
+const DEFAULT_QUESTION_TIMEOUT_MS = 20_000;
+const MAX_ANSWER_BATCH_BYTES = 8 * 1024 * 1024;
+/** Return a positive finite duration in milliseconds. The 20-second default bounds
+ * stalled native confirmation; callers can extend it for slower interfaces. */
+export function questionTimeoutMs(options) {
+    if (options !== undefined && (typeof options !== "object" || options === null))
+        throw invalid();
+    const timeoutMs = options?.timeoutMs;
+    const value = timeoutMs === undefined ? DEFAULT_QUESTION_TIMEOUT_MS : timeoutMs;
+    if (!Number.isFinite(value) || value <= 0)
+        throw invalid();
+    return value;
+}
+/** Require exactly one answer per question within its selection/text capabilities
+ * and one aggregate 8 MiB UTF-8-byte budget across the batch for question IDs, selected
+ * option IDs, and answer text; return native indexes in request-question order.
+ * The caller owns checking whether the request is still live. */
+export function validateQuestionAnswers(request, answers) {
+    if (!Array.isArray(answers))
+        throw invalid();
+    const answerCount = answers.length;
+    if (answerCount !== request.questions.length)
+        throw invalid();
+    let bytes = 0;
+    const countBytes = (value) => {
+        bytes += Buffer.byteLength(value, "utf8");
+        if (bytes > MAX_ANSWER_BATCH_BYTES)
+            throw invalid();
+    };
+    const validated = new Map();
+    const questionsById = new Map(request.questions.map((question) => [question.id, question]));
+    for (let index = 0; index < answerCount; index++) {
+        if (!Object.hasOwn(answers, index))
+            throw invalid();
+        const answer = answers[index];
+        if (!answer)
+            throw invalid();
+        const { questionId, optionIds, text } = answer;
+        const question = questionsById.get(questionId);
+        if (!question || validated.has(questionId))
+            throw invalid();
+        countBytes(questionId);
+        const indexes = questionOptionIndexes(question, optionIds === undefined ? [] : optionIds, countBytes);
+        if (typeof text === "string")
+            countBytes(text);
+        validated.set(questionId, validateAnswer(question, indexes, text));
+    }
+    return request.questions.map((question) => validated.get(question.id));
+}
+function validateAnswer(question, indexes, text) {
+    const invalidSelection = indexes.some((index) => index < 0);
+    const invalidText = text !== undefined &&
+        (typeof text !== "string" ||
+            !text.isWellFormed() ||
+            !text.trim() ||
+            sanitizePasteText(text) !== text ||
+            question.textMode === "none");
+    const incompatibleText = text !== undefined && indexes.length > 0 && question.textMode !== "additional";
+    const missingAnswer = indexes.length === 0 && text === undefined;
+    if (invalidSelection || invalidText || incompatibleText || missingAnswer)
+        throw invalid();
+    return {
+        optionIndexes: Object.freeze(indexes.sort((left, right) => left - right)),
+        ...(text === undefined ? {} : { text }),
+    };
+}
+function questionOptionIndexes(question, ids, countBytes) {
+    if (!Array.isArray(ids))
+        throw invalid();
+    const length = ids.length;
+    const invalidCount = length > question.options.length ||
+        (question.selection === "single" && length > 1) ||
+        (question.selection === "none" && length > 0);
+    if (invalidCount)
+        throw invalid();
+    const selected = new Set();
+    const optionIndexesById = new Map(question.options.map((option, index) => [option.id, index]));
+    const indexes = [];
+    for (let index = 0; index < length; index++) {
+        const id = ids[index];
+        if (!Object.hasOwn(ids, index) || typeof id !== "string" || selected.has(id))
+            throw invalid();
+        countBytes(id);
+        selected.add(id);
+        indexes.push(optionIndexesById.get(id) ?? -1);
+    }
+    return indexes;
+}
+function invalid() {
+    return questionError("invalid_question_answer", "The complete question answer batch or options are invalid.");
+}
+//# sourceMappingURL=validate.js.map

package/dist/core/questions/validate.js.map

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

package/dist/core/rendered-observers.d.ts

@@ -1,6 +1,7 @@
 /**
  * Applies turn-state and attention watchers to a rendered frame and submits
- * the resulting evidence, emitting the attention activity on a real block.
+ * the resulting evidence. Attention activity marks new blocks and changed blocking
+ * rules; identical-rule repaints stay quiet.
  * Implements PRD §5.3 turn and blocked detection.
  */
 import type { ElwoodActivityEvent, ElwoodAgentKind } from "./activity/index.ts";
@@ -9,7 +10,7 @@ import { type RenderedFrame, type ScreenFactReading, type ScreenFactTable } from
 import type { TurnStateWatcher } from "./turn-state.ts";
 import type { ElwoodSessionStatus, ElwoodStatusDecision, ElwoodStatusEvidence } from "./types.ts";
 export type RenderedObserverTarget = {
-    submitEvidence(kind: ElwoodStatusEvidence): Pick<ElwoodStatusDecision, "to">;
+    submitEvidence(kind: ElwoodStatusEvidence, workingVisible?: boolean): Pick<ElwoodStatusDecision, "to">;
     /** The session's current lifecycle status — lets the turn watcher release resume
      * settling when a turn is already running from EVIDENCE (see
      * TurnStateWatcher.observe). Typed as the bounded status union so an invalid test
@@ -26,4 +27,8 @@ export type RenderedObservers = {
     readonly emitActivity: (event: ElwoodActivityEvent) => void;
 };
 export declare function observeRenderedFrame(observers: RenderedObservers, frame: RenderedFrame, session: RenderedObserverTarget | undefined): ScreenFactReading;
+/** Include a retained trust hold as an ordinary blocking fact (C-TRUST-01). */
+export declare function readRenderedFrame(observers: RenderedObservers, frame: RenderedFrame, trustBlock?: string, trustInputBlocking?: boolean): ScreenFactReading;
+/** Apply one classified reading after the caller has latched its input guards. */
+export declare function observeRenderedReading(observers: RenderedObservers, reading: ScreenFactReading, session: RenderedObserverTarget | undefined): void;
 //# sourceMappingURL=rendered-observers.d.ts.map

package/dist/core/rendered-observers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rendered-observers.d.ts","sourceRoot":"","sources":["../../src/core/rendered-observers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,KAAK,gBAAgB,EAAyB,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElG,MAAM,MAAM,sBAAsB,GAAG;IACnC,cAAc,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAC;IAC7E;;;gFAG4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;CAC7D,CAAC;AAEF,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,iBAAiB,EAC5B,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,sBAAsB,GAAG,SAAS,GAC1C,iBAAiB,CAiBnB"}
+{"version":3,"file":"rendered-observers.d.ts","sourceRoot":"","sources":["../../src/core/rendered-observers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,KAAK,gBAAgB,EAAyB,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElG,MAAM,MAAM,sBAAsB,GAAG;IACnC,cAAc,CACZ,IAAI,EAAE,oBAAoB,EAC1B,cAAc,CAAC,EAAE,OAAO,GACvB,IAAI,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAC;IACpC;;;gFAG4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;CAC7D,CAAC;AAEF,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,iBAAiB,EAC5B,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,sBAAsB,GAAG,SAAS,GAC1C,iBAAiB,CAInB;AAED,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,iBAAiB,EAC5B,KAAK,EAAE,aAAa,EACpB,UAAU,CAAC,EAAE,MAAM,EACnB,kBAAkB,UAAQ,GACzB,iBAAiB,CAsBnB;AAED,kFAAkF;AAClF,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,sBAAsB,GAAG,SAAS,GAC1C,IAAI,CAyBN"}

package/dist/core/rendered-observers.js

@@ -1,29 +1,63 @@
 /**
  * Applies turn-state and attention watchers to a rendered frame and submits
- * the resulting evidence, emitting the attention activity on a real block.
+ * the resulting evidence. Attention activity marks new blocks and changed blocking
+ * rules; identical-rule repaints stay quiet.
  * Implements PRD §5.3 turn and blocked detection.
  */
 import { activityFromAttention } from "./attention.js";
 import { readScreenFacts, } from "./screen-facts.js";
+import { confirmNativeBoundary } from "./simple/native-boundary.js";
 export function observeRenderedFrame(observers, frame, session) {
+    const reading = readRenderedFrame(observers, frame);
+    observeRenderedReading(observers, reading, session);
+    return reading;
+}
+/** Include a retained trust hold as an ordinary blocking fact (C-TRUST-01). */
+export function readRenderedFrame(observers, frame, trustBlock, trustInputBlocking = false) {
     // Classify the frame once; turn and attention watchers share the reading, and the
     // reading is returned so the caller can drive resume-readiness off the same facts.
-    const reading = readScreenFacts(observers.table, frame);
+    // Pending automation owns partial trust repaints, but current human gates still win.
+    const reading = readScreenFacts(observers.table, frame, trustInputBlocking || trustBlock !== undefined ? observers.table.trustOwnedFallback : undefined);
+    if (trustBlock === undefined || reading.facts.blocking_prompt_visible)
+        return reading;
+    const id = `${observers.agent}-${trustBlock}-prompt`;
+    return {
+        facts: { ...reading.facts, blocking_prompt_visible: true },
+        matched: [
+            ...reading.matched,
+            {
+                id,
+                fact: "blocking_prompt_visible",
+                region: "screen",
+            },
+        ],
+    };
+}
+/** Apply one classified reading after the caller has latched its input guards. */
+export function observeRenderedReading(observers, reading, session) {
     const turnEdge = observers.turn.observe(reading.facts, session?.status === "running");
     if (turnEdge === "started")
         session?.submitEvidence("rendered_turn_started");
-    if (turnEdge === "ended")
-        session?.submitEvidence("rendered_turn_ended");
+    if (turnEdge === "ended" && session) {
+        session.submitEvidence("rendered_turn_ended");
+        confirmNativeBoundary(session, { kind: "rendered" });
+    }
     const attention = observers.attention.observe(reading);
-    if (attention?.edge === "raised") {
-        const decision = session?.submitEvidence("blocking_prompt_shown");
-        if (session === undefined || decision?.to === "blocked") {
+    if (attention?.edge === "raised" || attention?.edge === "updated") {
+        const decision = attention.edge === "raised" || session?.status !== "blocked"
+            ? session?.submitEvidence("blocking_prompt_shown")
+            : undefined;
+        if (session === undefined || decision?.to === "blocked" || session.status === "blocked") {
             const { agent, elwoodSessionId } = observers;
             observers.emitActivity(activityFromAttention(agent, elwoodSessionId, attention.ruleIds));
         }
     }
-    if (attention?.edge === "cleared")
-        session?.submitEvidence("blocking_prompt_cleared");
-    return reading;
+    if (attention?.edge === "cleared") {
+        // Establish this real turn before public status listeners can observe running.
+        // Resume replay settling must not swallow its next idle end edge.
+        if (reading.facts.working_visible && session?.status === "blocked")
+            observers.turn.adoptWorkingClearance(reading.facts);
+        session?.submitEvidence("blocking_prompt_cleared", reading.facts.working_visible);
+    }
 }
 //# sourceMappingURL=rendered-observers.js.map

package/dist/core/rendered-observers.js.map

@@ -1 +1 @@
-{"version":3,"file":"rendered-observers.js","sourceRoot":"","sources":["../../src/core/rendered-observers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAyB,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAEL,eAAe,GAGhB,MAAM,mBAAmB,CAAC;AAuB3B,MAAM,UAAU,oBAAoB,CAClC,SAA4B,EAC5B,KAAoB,EACpB,OAA2C;IAE3C,kFAAkF;IAClF,mFAAmF;IACnF,MAAM,OAAO,GAAG,eAAe,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC;IACtF,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,EAAE,cAAc,CAAC,uBAAuB,CAAC,CAAC;IAC7E,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,EAAE,cAAc,CAAC,qBAAqB,CAAC,CAAC;IACzE,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,SAAS,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,OAAO,EAAE,cAAc,CAAC,uBAAuB,CAAC,CAAC;QAClE,IAAI,OAAO,KAAK,SAAS,IAAI,QAAQ,EAAE,EAAE,KAAK,SAAS,EAAE,CAAC;YACxD,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,GAAG,SAAS,CAAC;YAC7C,SAAS,CAAC,YAAY,CAAC,qBAAqB,CAAC,KAAK,EAAE,eAAe,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;IACD,IAAI,SAAS,EAAE,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,cAAc,CAAC,yBAAyB,CAAC,CAAC;IACtF,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"rendered-observers.js","sourceRoot":"","sources":["../../src/core/rendered-observers.ts"],"names":[],"mappings":"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"}

package/dist/core/screen-facts.d.ts

@@ -29,12 +29,16 @@ export type ScreenFactRule = {
     readonly fact: ScreenFactKind;
     /** Where the patterns are evaluated; defaults to the viewport text. */
     readonly region?: ScreenFactRegion;
+    /** Evaluated only while no earlier rule has set this fact, so a specific rule keeps its label. */
+    readonly fallback?: true;
 } & ScreenFactRuleCondition;
 export type ScreenFactTable = {
     readonly agent: ElwoodAgentKind;
-    /** CLI version these rules were last verified against by the e2e suites. */
+    /** CLI versions used to establish native grammar through captured frames or e2e suites. */
     readonly verifiedAgainst: string;
     readonly rules: readonly ScreenFactRule[];
+    /** Adapter fallback hidden while trust owns a partial repaint. */
+    readonly trustOwnedFallback?: string;
 };
 export type ScreenFacts = Readonly<Record<ScreenFactKind, boolean>>;
 export type MatchedScreenRule = {
@@ -55,7 +59,8 @@ export type RenderedFrame = {
 /**
  * Evaluates the full table against a frame: sets every fact whose rules match
  * (a fact is true if any of its rules match) and returns the list of matched
- * rules — with their fact and region — for explain-trace diagnostics.
+ * rules — with their fact and region — for explain-trace diagnostics. A caller may
+ * suppress one fallback by id without copying the immutable table.
  */
-export declare function readScreenFacts(table: ScreenFactTable, frame: RenderedFrame): ScreenFactReading;
+export declare function readScreenFacts(table: ScreenFactTable, frame: RenderedFrame, suppressedRule?: string): ScreenFactReading;
 //# sourceMappingURL=screen-facts.d.ts.map

package/dist/core/screen-facts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"screen-facts.d.ts","sourceRoot":"","sources":["../../src/core/screen-facts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,MAAM,cAAc,GACtB,kBAAkB,GAClB,iBAAiB,GACjB,4BAA4B,GAC5B,yBAAyB,CAAC;AAE9B,6DAA6D;AAC7D,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,OAAO,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,MAAM,uBAAuB,GAC/B;IAAE,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,GAC3D;IAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;CAAE,CAAC;AAExE,MAAM,MAAM,cAAc,GAAG;IAC3B,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,uEAAuE;IACvE,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;CACpC,GAAG,uBAAuB,CAAC;AAE5B,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,4EAA4E;IAC5E,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC;AAEpE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC;AASF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,GAAG,iBAAiB,CAgB/F"}
+{"version":3,"file":"screen-facts.d.ts","sourceRoot":"","sources":["../../src/core/screen-facts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,MAAM,cAAc,GACtB,kBAAkB,GAClB,iBAAiB,GACjB,4BAA4B,GAC5B,yBAAyB,CAAC;AAE9B,6DAA6D;AAC7D,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,OAAO,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,MAAM,uBAAuB,GAC/B;IAAE,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,GAC3D;IAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;CAAE,CAAC;AAExE,MAAM,MAAM,cAAc,GAAG;IAC3B,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,uEAAuE;IACvE,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IACnC,kGAAkG;IAClG,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;CAC1B,GAAG,uBAAuB,CAAC;AAE5B,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,2FAA2F;IAC3F,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IAC1C,kEAAkE;IAClE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC;AAEpE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC;AASF;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,aAAa,EACpB,cAAc,CAAC,EAAE,MAAM,GACtB,iBAAiB,CAiBnB"}

package/dist/core/screen-facts.js

@@ -13,9 +13,10 @@ function ruleMatches(rule, target) {
 /**
  * Evaluates the full table against a frame: sets every fact whose rules match
  * (a fact is true if any of its rules match) and returns the list of matched
- * rules — with their fact and region — for explain-trace diagnostics.
+ * rules — with their fact and region — for explain-trace diagnostics. A caller may
+ * suppress one fallback by id without copying the immutable table.
  */
-export function readScreenFacts(table, frame) {
+export function readScreenFacts(table, frame, suppressedRule) {
     const facts = {
         composer_visible: false,
         working_visible: false,
@@ -24,9 +25,11 @@ export function readScreenFacts(table, frame) {
     };
     const matched = [];
     for (const rule of table.rules) {
+        if (rule.id === suppressedRule)
+            continue;
         const region = rule.region ?? "screen";
         const target = region === "title" ? frame.title : frame.text;
-        if (!ruleMatches(rule, target))
+        if ((rule.fallback && facts[rule.fact]) || !ruleMatches(rule, target))
             continue;
         facts[rule.fact] = true;
         matched.push({ id: rule.id, fact: rule.fact, region });

package/dist/core/screen-facts.js.map

@@ -1 +1 @@
-{"version":3,"file":"screen-facts.js","sourceRoot":"","sources":["../../src/core/screen-facts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4DH,qFAAqF;AACrF,SAAS,WAAW,CAAC,IAAoB,EAAE,MAAc;IACvD,OAAO,IAAI,CAAC,GAAG,KAAK,SAAS;QAC3B,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;QACpB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAsB,EAAE,KAAoB;IAC1E,MAAM,KAAK,GAAoC;QAC7C,gBAAgB,EAAE,KAAK;QACvB,eAAe,EAAE,KAAK;QACtB,0BAA0B,EAAE,KAAK;QACjC,uBAAuB,EAAE,KAAK;KAC/B,CAAC;IACF,MAAM,OAAO,GAAwB,EAAE,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;QAC7D,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC;YAAE,SAAS;QACzC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5B,CAAC"}
+{"version":3,"file":"screen-facts.js","sourceRoot":"","sources":["../../src/core/screen-facts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgEH,qFAAqF;AACrF,SAAS,WAAW,CAAC,IAAoB,EAAE,MAAc;IACvD,OAAO,IAAI,CAAC,GAAG,KAAK,SAAS;QAC3B,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;QACpB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AACxD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAsB,EACtB,KAAoB,EACpB,cAAuB;IAEvB,MAAM,KAAK,GAAoC;QAC7C,gBAAgB,EAAE,KAAK;QACvB,eAAe,EAAE,KAAK;QACtB,0BAA0B,EAAE,KAAK;QACjC,uBAAuB,EAAE,KAAK;KAC/B,CAAC;IACF,MAAM,OAAO,GAAwB,EAAE,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,IAAI,IAAI,CAAC,EAAE,KAAK,cAAc;YAAE,SAAS;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;QAC7D,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC;YAAE,SAAS;QAChF,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5B,CAAC"}

package/dist/core/simple/boundary-observer.d.ts

@@ -0,0 +1,30 @@
+/** Observe an internal turn through completeness and trailing drain (PRD §5.8, C-API-48/50). */
+import type { ElwoodActivityEvent } from "../activity/index.ts";
+import type { ElwoodSessionStatus } from "../types.ts";
+import { type TurnBoundaryHook } from "./turn-types.ts";
+/**
+ * Owned mode requires prior native acceptance; only private confirmed outcomes supply Stop.
+ * Owned mode ignores public hooks; only confirmStop supplies an authoritative outcome.
+ * Pre-Stop ready cannot be attributed: subsequent status is insufficient until fresh idle
+ * confirmation. Explicit interrupted idle may settle accepted work without a Stop hook.
+ */
+export type BoundaryOwnership = {
+    readonly accepted: () => boolean;
+};
+/** Passive observation: the caller owns submission; this never sends or replays input. */
+export declare function createBoundaryObserver(closing: AbortSignal, ownership: BoundaryOwnership | undefined, onDispose: () => void): {
+    observeActivity: (event: ElwoodActivityEvent) => void;
+    observeHook: (event: TurnBoundaryHook, status: ElwoodSessionStatus) => void;
+    observeStatus: ({ status }: {
+        readonly status: ElwoodSessionStatus;
+    }) => void;
+    promise: Promise<void>;
+    discard: () => void;
+    /** Only accepted owned work may record a confirmed outcome. */
+    confirmStop: (text: string, requireFreshIdle: boolean) => void;
+    /** Call only for a fresh idle frame; interrupted additionally attests hookless termination. */
+    confirmIdle: (options: {
+        readonly interrupted?: boolean;
+    }) => void;
+};
+//# sourceMappingURL=boundary-observer.d.ts.map

package/dist/core/simple/boundary-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundary-observer.d.ts","sourceRoot":"","sources":["../../../src/core/simple/boundary-observer.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAEhG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAGhE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAKvD,OAAO,EAAyB,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE/E;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC;CAClC,CAAC;AAEF,0FAA0F;AAC1F,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,iBAAiB,GAAG,SAAS,EACxC,SAAS,EAAE,MAAM,IAAI;6BA+BW,mBAAmB;yBAUvB,gBAAgB,UAAU,mBAAmB;gCAStC;QAAE,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAA;KAAE;;;IA2BzE,+DAA+D;wBAC3C,MAAM,oBAAoB,OAAO;IAOrD,+FAA+F;2BACxE;QAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE;EAG5D"}

package/dist/core/simple/boundary-observer.js

@@ -0,0 +1,111 @@
+/** Observe an internal turn through completeness and trailing drain (PRD §5.8, C-API-48/50). */
+import { elwoodError } from "../errors.js";
+import { terminalStatuses } from "../status-categories.js";
+import { boundaryExpectation } from "./boundary-signal.js";
+import { toTurnEvent } from "./events.js";
+import { gateForTurn } from "./turn/defaults.js";
+import { TurnBoundary } from "./turn-boundary.js";
+import { defaultBoundarySignal } from "./turn-types.js";
+/** Passive observation: the caller owns submission; this never sends or replays input. */
+export function createBoundaryObserver(closing, ownership, onDispose) {
+    const gate = gateForTurn({});
+    let started = false;
+    let ownedStop = false;
+    let sawReady = false;
+    let requiresFreshPostStopIdle = false;
+    const boundary = new TurnBoundary(() => {
+        gate.dispose();
+        onDispose();
+        closing.removeEventListener("abort", onClosing);
+    });
+    const ready = (confirmed = false, interrupted = false) => {
+        if (ownership) {
+            if (!ownership.accepted())
+                return;
+            if (!(ownedStop || interrupted)) {
+                requiresFreshPostStopIdle = true;
+                return;
+            }
+            if (requiresFreshPostStopIdle && !confirmed)
+                return;
+            started = true;
+        }
+        if (!started)
+            return;
+        sawReady = true;
+        gate.observeReady();
+        boundary.armDrain();
+    };
+    const discard = () => {
+        gate.end();
+        boundary.reach();
+    };
+    const observeActivity = (event) => {
+        if (ownership && !ownership.accepted())
+            return;
+        const content = toTurnEvent(event);
+        if (content) {
+            started = true;
+            gate.push(content);
+            if (content.type === "text")
+                gate.observeText(content.text);
+        }
+        if (boundary.draining)
+            boundary.armDrain();
+    };
+    const observeHook = (event, status) => {
+        if (ownership)
+            return;
+        const signal = defaultBoundarySignal(event);
+        gate.expectText(boundaryExpectation(signal));
+        if (signal !== undefined) {
+            started = true;
+            if (status === "ready")
+                ready();
+        }
+    };
+    const observeStatus = ({ status }) => {
+        if (status === "running")
+            started = true;
+        if (terminalStatuses.has(status))
+            discard();
+        else if (status === "ready")
+            ready();
+    };
+    const onClosing = () => discard();
+    closing.addEventListener("abort", onClosing, { once: true });
+    if (closing.aborted)
+        onClosing();
+    gate.done().then(() => boundary.reach(), () => {
+        boundary.markConsumerFailed();
+        if (sawReady)
+            boundary.armDrain();
+    });
+    // Internal turn output still flows through public activity; discard only this collector's copy.
+    void (async () => {
+        for await (const event of gate.drain())
+            void event;
+    })().catch(() => undefined);
+    return {
+        observeActivity,
+        observeHook,
+        observeStatus,
+        promise: boundary.promise.then(() => {
+            if (closing.aborted)
+                throw elwoodError("session_not_running", "Session is closing.");
+        }),
+        discard,
+        /** Only accepted owned work may record a confirmed outcome. */
+        confirmStop: (text, requireFreshIdle) => {
+            if (!ownership?.accepted())
+                return;
+            ownedStop = true;
+            requiresFreshPostStopIdle ||= requireFreshIdle;
+            gate.expectText(text);
+            started = true;
+        },
+        /** Call only for a fresh idle frame; interrupted additionally attests hookless termination. */
+        confirmIdle: (options) => ready(true, options.interrupted === true),
+    };
+}
+//# sourceMappingURL=boundary-observer.js.map

package/dist/core/simple/boundary-observer.js.map

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

package/dist/core/simple/boundary-signal.d.ts

@@ -0,0 +1,31 @@
+/**
+ * What an adapter's turn boundary carries, and the accessors the runner reads it with.
+ * Implements PRD §5.8 / §12A: the completeness signal, plus OPTIONAL evidence that the
+ * agent itself rejected the turn. Separate from the reader contract so the failure shape
+ * has one home (#19).
+ */
+/**
+ * What a boundary carries. A bare string is the completeness signal on its own — the shorthand
+ * every adapter uses today — while the object form additionally reports that the agent FAILED
+ * the turn. The two are kept distinct because an empty response is NOT evidence of failure
+ * (PRD §12A.3 allows a legitimately empty successful reply): only an adapter's own failure
+ * evidence may set `failure`, never the absence of text.
+ */
+export type BoundarySignal = string | {
+    readonly text: string;
+    readonly failure: TurnFailure;
+};
+/** An adapter's evidence that the agent itself rejected the turn (PRD §12A.5). */
+export type TurnFailure = {
+    /** Human-readable reason, bounded by the adapter. */
+    readonly message: string;
+    /** Adapter-specific classification, DIAGNOSTIC ONLY — never used to decide failure. */
+    readonly info?: string | undefined;
+};
+/** The expected-text half of a boundary signal, whichever form the adapter returned. */
+export declare function boundaryText(signal: BoundarySignal): string;
+/** The failure half, if the adapter reported one. Absent for every string-form signal. */
+export declare function boundaryFailure(signal: BoundarySignal): TurnFailure | undefined;
+/** The gate's expected text for a signal that may be absent: `undefined` stays `undefined`. */
+export declare function boundaryExpectation(signal: BoundarySignal | undefined): string | undefined;
+//# sourceMappingURL=boundary-signal.d.ts.map

package/dist/core/simple/boundary-signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundary-signal.d.ts","sourceRoot":"","sources":["../../../src/core/simple/boundary-signal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAAC;AAE/F,kFAAkF;AAClF,MAAM,MAAM,WAAW,GAAG;IACxB,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uFAAuF;IACvF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,CAAC;AACF,wFAAwF;AACxF,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAE3D;AAED,0FAA0F;AAC1F,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,WAAW,GAAG,SAAS,CAE/E;AAED,+FAA+F;AAC/F,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAE1F"}

package/dist/core/simple/boundary-signal.js

@@ -0,0 +1,19 @@
+/**
+ * What an adapter's turn boundary carries, and the accessors the runner reads it with.
+ * Implements PRD §5.8 / §12A: the completeness signal, plus OPTIONAL evidence that the
+ * agent itself rejected the turn. Separate from the reader contract so the failure shape
+ * has one home (#19).
+ */
+/** The expected-text half of a boundary signal, whichever form the adapter returned. */
+export function boundaryText(signal) {
+    return typeof signal === "string" ? signal : signal.text;
+}
+/** The failure half, if the adapter reported one. Absent for every string-form signal. */
+export function boundaryFailure(signal) {
+    return typeof signal === "string" ? undefined : signal.failure;
+}
+/** The gate's expected text for a signal that may be absent: `undefined` stays `undefined`. */
+export function boundaryExpectation(signal) {
+    return signal === undefined ? undefined : boundaryText(signal);
+}
+//# sourceMappingURL=boundary-signal.js.map

package/dist/core/simple/boundary-signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundary-signal.js","sourceRoot":"","sources":["../../../src/core/simple/boundary-signal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH,wFAAwF;AACxF,MAAM,UAAU,YAAY,CAAC,MAAsB;IACjD,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;AAC3D,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,eAAe,CAAC,MAAsB;IACpD,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;AACjE,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,mBAAmB,CAAC,MAAkC;IACpE,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;AACjE,CAAC"}

package/dist/core/simple/captured-input.d.ts

@@ -0,0 +1,19 @@
+/** Snapshot facade turn options before queueing (PRD §5.8, C-API-44/50). */
+import type { ElwoodAgentSession } from "../agent-session.ts";
+import type { ImageCaptures } from "../images/capture.ts";
+import type { SendOptions } from "../images/types.ts";
+import { type ElwoodSessionStatus } from "../status-categories.ts";
+import type { TurnEvent } from "./events.ts";
+import type { NativeTurnReader } from "./turn-identity.ts";
+import type { TurnQueue } from "./turn-queue.ts";
+import type { BoundarySignalReader, TurnOptions } from "./turn-types.ts";
+type Facade = {
+    readonly status: ElwoodSessionStatus;
+    readonly session?: ElwoodAgentSession | undefined;
+    start(): Promise<ElwoodAgentSession>;
+};
+export declare function capturedTurn(captures: ImageCaptures, queue: TurnQueue, facade: Facade, readBoundarySignal: BoundarySignalReader, prompt: string, options?: TurnOptions, readNativeTurn?: NativeTurnReader): AsyncGenerator<TurnEvent>;
+/** Raw facade controls capture before the lazy-start await as ergonomic turns do. */
+export declare function capturedSend(captures: ImageCaptures, facade: Facade, method: "sendPrompt" | "sendMessage" | "sendGuidance", input: string, options?: SendOptions): Promise<void>;
+export {};
+//# sourceMappingURL=captured-input.d.ts.map

package/dist/core/simple/captured-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"captured-input.d.ts","sourceRoot":"","sources":["../../../src/core/simple/captured-input.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,KAAK,mBAAmB,EAAoB,MAAM,yBAAyB,CAAC;AAErF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEzE,KAAK,MAAM,GAAG;IACZ,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAClD,KAAK,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACtC,CAAC;AAaF,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,aAAa,EACvB,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM,EACd,kBAAkB,EAAE,oBAAoB,EACxC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,WAAW,EACrB,cAAc,CAAC,EAAE,gBAAgB,GAChC,cAAc,CAAC,SAAS,CAAC,CA6C3B;AAMD,qFAAqF;AACrF,wBAAsB,YAAY,CAChC,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,YAAY,GAAG,aAAa,GAAG,cAAc,EACrD,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/core/simple/captured-input.js

@@ -0,0 +1,78 @@
+import { elwoodError } from "../errors.js";
+import { personaBoundary } from "../persona.js";
+import { terminalStatuses } from "../status-categories.js";
+import { assertStopInput } from "../stop-input.js";
+import { loopBoundaryTail } from "./loop-boundary.js";
+import { holdTurnLoops } from "./loop-hold.js";
+import { runTurn } from "./turn.js";
+function capture(captures, facade, options) {
+    if (facade.session)
+        assertStopInput(facade.session);
+    if (terminalStatuses.has(facade.status))
+        throw elwoodError("session_not_running", "Session is not running.");
+    return captures.capture(options);
+}
+export function capturedTurn(captures, queue, facade, readBoundarySignal, prompt, options, readNativeTurn) {
+    let captured;
+    try {
+        captured = capture(captures, facade, options);
+    }
+    catch (error) {
+        return failedTurn(error);
+    }
+    // Start and reserve the slot at the call, so close joins this same launch.
+    let starting;
+    const live = facade.session;
+    // A ready listener can reserve a turn before the same transition drains due loops.
+    // Install its hold synchronously when startup has already supplied a live session.
+    let releaseLoopHold = live ? holdTurnLoops(live) : () => undefined;
+    const release = () => {
+        captured.release();
+        releaseLoopHold();
+    };
+    try {
+        starting = facade.start().then((session) => {
+            if (!live)
+                releaseLoopHold = holdTurnLoops(session);
+            return session;
+        });
+        // Startup may reject while this reserved turn still awaits its predecessor.
+        void starting.catch(() => undefined);
+    }
+    catch (error) {
+        release();
+        return failedTurn(error);
+    }
+    return queue.enqueue(async () => {
+        try {
+            const session = await starting;
+            await personaBoundary(session);
+            await loopBoundaryTail(session);
+            const turn = runTurn(session, prompt, {
+                ...captured.options,
+                readBoundarySignal,
+                readNativeTurn,
+            });
+            void turn.boundary.then(release);
+            return turn;
+        }
+        catch (error) {
+            release();
+            throw error;
+        }
+    });
+}
+async function* failedTurn(error) {
+    yield await Promise.reject(error);
+}
+/** Raw facade controls capture before the lazy-start await as ergonomic turns do. */
+export async function capturedSend(captures, facade, method, input, options) {
+    const captured = capture(captures, facade, options);
+    try {
+        return await (await facade.start())[method](input, captured.options);
+    }
+    finally {
+        captured.release();
+    }
+}
+//# sourceMappingURL=captured-input.js.map

package/dist/core/simple/captured-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"captured-input.js","sourceRoot":"","sources":["../../../src/core/simple/captured-input.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAA4B,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,SAAS,OAAO,CACd,QAAuB,EACvB,MAAc,EACd,OAAsB;IAEtB,IAAI,MAAM,CAAC,OAAO;QAAE,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACpD,IAAI,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC;QACrC,MAAM,WAAW,CAAC,qBAAqB,EAAE,yBAAyB,CAAC,CAAC;IACtE,OAAO,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,QAAuB,EACvB,KAAgB,EAChB,MAAc,EACd,kBAAwC,EACxC,MAAc,EACd,OAAqB,EACrB,cAAiC;IAEjC,IAAI,QAAqF,CAAC;IAC1F,IAAI,CAAC;QACH,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IACD,2EAA2E;IAC3E,IAAI,QAAqC,CAAC;IAC1C,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC;IAC5B,mFAAmF;IACnF,mFAAmF;IACnF,IAAI,eAAe,GAAe,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;IAC/E,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,QAAQ,CAAC,OAAO,EAAE,CAAC;QACnB,eAAe,EAAE,CAAC;IACpB,CAAC,CAAC;IACF,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;YACzC,IAAI,CAAC,IAAI;gBAAE,eAAe,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;YACpD,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC,CAAC;QACH,4EAA4E;QAC5E,KAAK,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,CAAC;QACV,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE;QAC9B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC;YAC/B,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;YAC/B,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;YAChC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE;gBACpC,GAAG,QAAQ,CAAC,OAAO;gBACnB,kBAAkB;gBAClB,cAAc;aACf,CAAC,CAAC;YACH,KAAK,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACjC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,CAAC;YACV,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,SAAS,CAAC,CAAC,UAAU,CAAC,KAAc;IACvC,MAAM,MAAM,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC;AAED,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAuB,EACvB,MAAc,EACd,MAAqD,EACrD,KAAa,EACb,OAAqB;IAErB,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACpD,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IACvE,CAAC;YAAS,CAAC;QACT,QAAQ,CAAC,OAAO,EAAE,CAAC;IACrB,CAAC;AACH,CAAC"}