waterplane 0.1.6 → 0.1.11

package/packages/host/dist/sessions/apiretry.js

@@ -0,0 +1,240 @@
+/**
+ * The retry of a turn the CLI GAVE UP on a transient API error (R-connection-024).
+ *
+ * The CLI retries a failed request on its own, but during a DNS or Wi-Fi outage
+ * that budget runs out and the turn ENDS on "API Error: Can't reach the API
+ * server (ENOTFOUND)" — and someone has to type "try again" by hand. Here the
+ * host does, on a widening ladder (`netlog.ts`'s `netRetryDelay`), the way the
+ * usage-limit wall types its `continue` (`wall.ts`'s `doLimitContinue`): text and
+ * Return as two writes through the facade's `write`, a history row and a
+ * `sent.json` row. Never `deliver.ts`, never a queue bypass of the phone's own.
+ *
+ * Read off the LOG only (`readNetLog`), on the ONE end-of-turn path
+ * (`turn.ts`'s `settleStop`), and only where the give-up is FRESH — stamped
+ * inside the turn that just ended. Called off by anything that says the person
+ * or the account has taken over: a keystroke or prompt (`typed`), a turn
+ * starting that is not ours (`turnStarted`), a wall (`limit.blocked` outranks),
+ * the halt latch, the session ending (`clear`). A session that is busy — a box
+ * up, a dialog, output still arriving — is PARKED, never typed into. Past the
+ * cap it stops and says so (`state: "gaveup"`); there is no loop.
+ *
+ * State is memory only: a host restart forgets a pending retry, which is the
+ * safe direction (it types nothing).
+ *
+ * What the turn end MEANT travels on `turnEnded` (`TurnEndNet`): deferred work
+ * waiting on the turn (`intents/watch.ts`) must not complete off a turn that
+ * did not happen. `retrying` holds it, `gaveup` fails it, and `checking` (our
+ * `continue`'s turn ended before its log row landed) is answered once by
+ * `netTurnSettled` after the re-read. A person's keystroke cancels the retry
+ * and the next real turn end completes the work as ever.
+ */
+import { logTag, netGaveUpDetail, netRetryLine } from "@waterplane/shared";
+import { freshGiveUp, netRetryDelay, readNetLog } from "../netlog.js";
+import { transcriptPath } from "../transcript.js";
+import { recordSent } from "../sentlog.js";
+import { derive } from "../backends/derive.js";
+import { haltRefusal as hostHalt } from "../halt.js";
+import { NET_RETRY_LADDER_MS, NET_RETRY_MAX } from "./knobs.js";
+import { netRetryOn } from "../netretrycfg.js";
+/** How long a busy session is parked before the retry looks again. */
+const PARK_MS = 30_000;
+/** Output this recent means the screen is still moving — park briefly. */
+const QUIET_MS = 3000;
+/** A turn starting this soon after our `continue` is ours. */
+const OURS_MS = 60_000;
+/** The log row can land a moment after the Stop: one re-read this much later. */
+const RECHECK_MS = 1500;
+export class NetRetrySlice {
+    core;
+    constructor(core) {
+        this.core = core;
+    }
+    /**
+     * The turn just ended (`settleStop`). `retrying` ⇒ a retry is scheduled, and
+     * the turn-finished ping is held: the turn is not done, it is being tried
+     * again. Null ⇒ an ordinary turn end.
+     */
+    turnEnded(s) {
+        if (!netRetryOn() || !s.info.running || !s.hooksActive || !derive(s.backend).keepsClaudeLog || !s.info.claudeSessionId)
+            return null;
+        const v = readNetLog(transcriptPath(s.info.cwd, s.info.claudeSessionId));
+        if (!freshGiveUp(v, s.info.turnStartedAt)) {
+            // A served reply ends the outage. The row may also land just after the
+            // Stop: look once more, without the ping. Mid-episode (our `continue`'s
+            // turn) the episode is KEPT until that look — clearing it here restarted
+            // the ladder at 0 and the cap was never reached — and the turn end is
+            // `checking`, so work waiting on it waits for the answer.
+            const live = !!s.info.netRetry;
+            if (v.state !== "clear") {
+                this.recheckLater(s);
+                return live ? { net: "checking" } : null;
+            }
+            if (live)
+                this.set(s, null);
+            return null;
+        }
+        return this.schedule(s, v.at, v.error);
+    }
+    /** A turn started. Ours (just typed) keeps the ladder; anyone else's ends it. */
+    turnStarted(s) {
+        const n = s.info.netRetry;
+        if (!n)
+            return;
+        if (n.state === "sent" && Date.now() - (s.netSentAt ?? 0) < OURS_MS)
+            return;
+        this.cancel(s, "a turn started");
+    }
+    /** Someone typed into the session — our own `continue` excepted. */
+    typed(s) {
+        if (s.netWriting || !s.info.netRetry)
+            return;
+        this.cancel(s, "typed into the session");
+    }
+    /** The phone's Cancel (`session.netRetryCancel`). */
+    cancelById(id) {
+        const s = this.core.sessions.get(id);
+        if (s?.info.netRetry)
+            this.cancel(s, "cancelled from the phone");
+    }
+    /** The session is going (exit, detach, kill, remove): drop the timer. */
+    clear(s) {
+        if (s.netTimer) {
+            clearTimeout(s.netTimer);
+            s.netTimer = null;
+        }
+        if (s.netRecheck) {
+            clearTimeout(s.netRecheck);
+            s.netRecheck = null;
+        }
+    }
+    cancel(s, why) {
+        this.clear(s);
+        console.log(`${logTag} net retry off · ${s.info.title} (${s.info.id}) · ${why}`);
+        this.set(s, null);
+    }
+    set(s, n) {
+        s.info.netRetry = n;
+        this.core.emit("updated", s.info);
+    }
+    /** Arm the next rung (`retrying`), or stop at the cap (`gaveup`); null ⇒ a wall outranks. */
+    schedule(s, at, error) {
+        const prev = s.info.netRetry;
+        const attempt = prev && prev.state === "sent" ? prev.attempt : 0;
+        const delay = netRetryDelay(attempt, NET_RETRY_MAX, NET_RETRY_LADDER_MS);
+        this.clear(s);
+        if (s.info.limit?.blocked) {
+            if (prev)
+                this.set(s, null);
+            return null;
+        } // a wall outranks
+        if (delay == null) {
+            const why = `after ${attempt} ${attempt === 1 ? "try" : "tries"}`;
+            this.set(s, { state: "gaveup", attempt, max: NET_RETRY_MAX, nextAt: null, error, at, why });
+            console.log(`${logTag} net retry gave up · ${s.info.title} (${s.info.id}) · ${error}`);
+            return { net: "gaveup", detail: netGaveUpDetail(error, why) };
+        }
+        const n = { state: "waiting", attempt, max: NET_RETRY_MAX, nextAt: Date.now() + delay, error, at };
+        this.arm(s, delay);
+        this.set(s, n);
+        console.log(`${logTag} ${netRetryLine(n, Date.now())} · ${s.info.title} (${s.info.id}) · ${error}`);
+        return { net: "retrying" };
+    }
+    arm(s, ms) {
+        if (s.netTimer)
+            clearTimeout(s.netTimer);
+        s.netTimer = setTimeout(() => { s.netTimer = null; void this.fire(s); }, ms);
+        s.netTimer.unref?.();
+    }
+    recheckLater(s) {
+        if (s.netRecheck)
+            clearTimeout(s.netRecheck);
+        const stops = s.stopCount;
+        s.netRecheck = setTimeout(() => {
+            s.netRecheck = null;
+            // Only if nothing moved since: same turn end, no turn running, nothing scheduled.
+            if (s.stopCount !== stops || s.turnActive || s.info.netRetry?.state === "waiting")
+                return;
+            if (this.core.sessions.get(s.info.id) !== s || !s.info.running || !s.info.claudeSessionId)
+                return;
+            const v = readNetLog(transcriptPath(s.info.cwd, s.info.claudeSessionId));
+            let end = null;
+            if (freshGiveUp(v, s.info.turnStartedAt))
+                end = this.schedule(s, v.at, v.error);
+            else if (s.info.netRetry)
+                this.set(s, null); // the episode `turnEnded` kept: no give-up landed
+            // The answer to a `checking` turn end (and harmless after a plain one: the
+            // work waiting on it already settled, so there is nothing to apply it to).
+            this.core.emit("netTurnSettled", s.info.id, stops, end);
+        }, RECHECK_MS);
+        s.netRecheck.unref?.();
+    }
+    park(s, why, ms = PARK_MS) {
+        const n = s.info.netRetry;
+        this.arm(s, ms);
+        this.set(s, { ...n, nextAt: Date.now() + ms, why });
+    }
+    /** The rung is due: type `continue`, unless something says not to. */
+    async fire(s) {
+        const id = s.info.id;
+        const n = s.info.netRetry;
+        if (!n || n.state !== "waiting")
+            return;
+        if (this.core.sessions.get(id) !== s || !s.info.running) {
+            s.info.netRetry = null;
+            return;
+        }
+        const halted = hostHalt();
+        if (halted) {
+            this.set(s, { ...n, state: "gaveup", nextAt: null, why: "the emergency halt is on" });
+            // No turn end follows this one: tell the work waiting on the session now.
+            this.core.emit("netTurnSettled", id, s.stopCount, { net: "gaveup", detail: netGaveUpDetail(n.error, "because the emergency halt is on") });
+            return;
+        }
+        if (s.info.limit?.blocked) {
+            this.cancel(s, "a usage or spend wall is up");
+            return;
+        }
+        if (s.turnActive) {
+            this.cancel(s, "a turn is running");
+            return;
+        }
+        if (s.info.prompt || s.info.awaitingInput) {
+            this.park(s, "waiting for the open box to be answered");
+            return;
+        }
+        if (Date.now() - s.lastDataAt < QUIET_MS) {
+            this.park(s, "waiting for the screen to settle", 5000);
+            return;
+        }
+        const attempt = n.attempt + 1;
+        s.netSentAt = Date.now();
+        // Before the first byte: a person typing between the two writes cancels, and the Return is skipped.
+        this.set(s, { ...n, state: "sent", attempt, nextAt: null, why: undefined });
+        s.netWriting = true;
+        try {
+            this.core.write(id, "continue");
+        }
+        finally {
+            s.netWriting = false;
+        }
+        await new Promise((r) => setTimeout(r, 250));
+        if (this.core.sessions.get(id) !== s || !s.info.running || s.info.netRetry?.state !== "sent")
+            return;
+        s.netWriting = true;
+        try {
+            this.core.write(id, "\r");
+        }
+        finally {
+            s.netWriting = false;
+        }
+        this.core.recordPrompt(id, "continue (auto, network error)", "backlog");
+        // `written`, as the limit wall's: the Return is pressed blind, and the
+        // outcome is the next turn end's log row.
+        recordSent({
+            sessionId: id, actor: "auto", source: "netretry", kind: "prompt",
+            text: "continue", result: "written",
+            detail: `retry after a transient API error (${attempt}/${n.max}): ${n.error}`,
+        });
+    }
+}
+//# sourceMappingURL=apiretry.js.map

package/packages/host/dist/sessions/apiretry.js.map

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

package/packages/host/dist/sessions/askwatch.d.ts

@@ -0,0 +1,62 @@
+/**
+ * The prose question and the CLI's own proposal: whether a finished turn ended
+ * on a question to the person (`checkAsking`, `setAsking`, `ackAsking`), and
+ * the next prompt the CLI proposes (`checkCliSuggestion`), plus a plugin's
+ * suggestion (`setSuggestion`). Cut out of `turn.ts` by subject; stateless like
+ * it — every fact lives on the `Session`.
+ */
+import type { SessionAsk } from "@waterplane/shared";
+import type { Session, SessionCore } from "./core.js";
+/**
+ * Did this turn end on a question to the person, asked in prose?
+ *
+ * Run on the turn-end transition, before the ping. Deliberately NOT a
+ * detector of "is the CLI blocked" — it is not; the composer is right there.
+ * It is a detector of WORK being blocked, which is the state the phone had no
+ * word for: a finished turn whose next step is a decision only the user can
+ * make. It used to be computed only when the Gemini oracle was on duty, so
+ * without an API key nothing ever asked the tail this question.
+ *
+ * A parsed `prompt` outranks it (that is the same question with buttons), and
+ * a limit-blocked session is not waiting on an answer, it is waiting on a
+ * clock.
+ */
+export declare function checkAsking(core: SessionCore, s: Session): void;
+/**
+ * Is the composer showing the CLI's own proposal for the next prompt?
+ * (`clisuggest.ts` holds the rule and the measurement.)
+ *
+ * Re-entered on every quiet repaint, like `checkAsking` — the proposal is a
+ * model call of the CLI's own and lands a moment AFTER the Stop, so one read on
+ * the transition would miss it. The plain grid is the cheap gate; the render
+ * with attributes is paid once per distinct composer text.
+ */
+export declare function checkCliSuggestion(core: SessionCore, s: Session): void;
+export declare function setCliSuggestion(core: SessionCore, s: Session, text: string | null): void;
+/** Publish/retire the prose-question fact, on a CHANGE of wording only. */
+export declare function setAsking(core: SessionCore, s: Session, ask: SessionAsk | null): void;
+/**
+ * "I have dealt with that" — retire the prose-question badge without typing.
+ *
+ * The only two things that retire `asking` on their own are a turn starting
+ * and a keystroke, both of which mean the question was answered HERE. A
+ * question answered anywhere else — the change committed at the desk, the
+ * decision taken and no longer worth a reply — has neither, so the badge, the
+ * waiting count and the push stood over a decision already made.
+ *
+ * `text` is checked for the reason `expectPrompt` exists: the tap happened
+ * against a badge that may since have been replaced by a different question,
+ * and silencing THAT one is the failure this guard is here to prevent. A
+ * client that cannot say (absent) acknowledges whatever is standing.
+ *
+ * Types nothing, runs nothing, and is not remembered past the next turn.
+ */
+export declare function ackAsking(core: SessionCore, id: string, text?: string): void;
+/**
+ * Attach a plugin's suggestion to a session. A numbered-CHOICE suggestion is
+ * tied to a live prompt, so it's dropped if the prompt already changed (stale)
+ * — we never show a choice for a gone prompt. A free-text REPLY suggestion
+ * (choice == null) has no prompt to bind to, so it's always allowed; this is
+ * what surfaces the turn-end reply bar.
+ */
+export declare function setSuggestion(core: SessionCore, id: string, s: import("@waterplane/shared").AnswerSuggestion | null): void;

package/packages/host/dist/sessions/askwatch.js

@@ -0,0 +1,169 @@
+import { derive } from "../backends/derive.js";
+import { stripAnsi } from "../prompt.js";
+import { askLine, looksLikeQuestion, sameAsk } from "../question.js";
+import { cliSuggestionOf, composerPlain } from "../clisuggest.js";
+import { QUESTION_TAIL_BYTES } from "./knobs.js";
+/**
+ * Did this turn end on a question to the person, asked in prose?
+ *
+ * Run on the turn-end transition, before the ping. Deliberately NOT a
+ * detector of "is the CLI blocked" — it is not; the composer is right there.
+ * It is a detector of WORK being blocked, which is the state the phone had no
+ * word for: a finished turn whose next step is a decision only the user can
+ * make. It used to be computed only when the Gemini oracle was on duty, so
+ * without an API key nothing ever asked the tail this question.
+ *
+ * A parsed `prompt` outranks it (that is the same question with buttons), and
+ * a limit-blocked session is not waiting on an answer, it is waiting on a
+ * clock.
+ */
+export function checkAsking(core, s) {
+    // "Did the turn end on a question with no box" is a rule about how THIS CLI
+    // signs off a turn. A backend it was not written against records nothing:
+    // `SessionInfo.asking` stays absent, and the phone's "asked you" badge can
+    // never be raised by a paragraph that merely ends in a question mark.
+    if (derive(s.backend).screen("asking") !== "question-ts") {
+        setAsking(core, s, null);
+        return;
+    }
+    if (s.info.prompt || s.info.limit?.blocked) {
+        setAsking(core, s, null);
+        return;
+    }
+    // A turn still IN FLIGHT is not a turn that ended on a question. The
+    // silence timer re-enters `markIdle` four seconds after any output, so on a
+    // hooked session a long quiet tool run would otherwise read the agent's
+    // mid-turn "should I also…?" as a handover and badge a working session
+    // "asked you" until someone typed. Only a turn that is over may raise it;
+    // by this point `markIdle`/the Stop hook have already cleared the flag for
+    // the sessions that legitimately finished.
+    if (s.turnActive)
+        return;
+    // The rendered grid, not the byte tail: the CLI lays words out with cursor
+    // moves, and the stripped bytes read "TheUIisstillwronghere" on the card.
+    const tail = s.screenLog?.gridText() || stripAnsi(s.scrollback.slice(-QUESTION_TAIL_BYTES));
+    if (!looksLikeQuestion(tail)) {
+        setAsking(core, s, null);
+        return;
+    }
+    const text = askLine(tail);
+    if (!text) {
+        setAsking(core, s, null);
+        return;
+    }
+    // Already dealt with — outside this session, which is the only place it
+    // COULD have been dealt with without a turn starting. The tail still ends
+    // on the question and always will, so without this the badge re-raises on
+    // the next repaint and the acknowledgement lasts about a second.
+    const d = s.askDismissed;
+    if (d && ((s.hooksActive && d.stop === s.stopCount) || sameAsk(text, d.text))) {
+        setAsking(core, s, null);
+        return;
+    }
+    // Keep the original `at`: idle re-enters here on every repaint, and a
+    // question whose clock restarted twice a second would read "asked 0s ago"
+    // for as long as it went unanswered.
+    setAsking(core, s, { text, at: s.info.asking?.at ?? Date.now() });
+}
+/**
+ * Is the composer showing the CLI's own proposal for the next prompt?
+ * (`clisuggest.ts` holds the rule and the measurement.)
+ *
+ * Re-entered on every quiet repaint, like `checkAsking` — the proposal is a
+ * model call of the CLI's own and lands a moment AFTER the Stop, so one read on
+ * the transition would miss it. The plain grid is the cheap gate; the render
+ * with attributes is paid once per distinct composer text.
+ */
+export function checkCliSuggestion(core, s) {
+    // Measured on claude's TUI only (`clisuggest.ts`); another TUI's dim hint is a placeholder. The
+    // claude TUI is the one whose dialogs `prompt.ts` reads — so every backend that runs it.
+    if (derive(s.backend).screen("dialogs") !== "claude-numbered" || s.turnActive || s.info.prompt || s.info.limit?.blocked) {
+        s.hintRead = null;
+        setCliSuggestion(core, s, null);
+        return;
+    }
+    const grid = s.screenLog?.gridText();
+    if (!grid)
+        return;
+    const rows = grid.split("\n");
+    const plain = composerPlain(rows);
+    if (!plain) {
+        s.hintRead = null;
+        setCliSuggestion(core, s, null);
+        return;
+    }
+    if (plain === s.hintRead)
+        return;
+    s.hintRead = plain;
+    void core.screenCells(s.info.id, rows.length).then((cells) => {
+        if (s.hintRead !== plain || s.turnActive)
+            return; // the screen moved on while this rendered
+        setCliSuggestion(core, s, cliSuggestionOf(rows, cells.map((r) => r.undimmed)));
+    }).catch(() => { });
+}
+export function setCliSuggestion(core, s, text) {
+    if ((s.info.cliSuggestion ?? null) === text)
+        return;
+    s.info.cliSuggestion = text;
+    core.emit("updated", s.info);
+}
+/** Publish/retire the prose-question fact, on a CHANGE of wording only. */
+export function setAsking(core, s, ask) {
+    const had = s.info.asking?.text ?? null;
+    if ((ask?.text ?? null) === had)
+        return;
+    s.info.asking = ask;
+    core.emit("updated", s.info);
+}
+/**
+ * "I have dealt with that" — retire the prose-question badge without typing.
+ *
+ * The only two things that retire `asking` on their own are a turn starting
+ * and a keystroke, both of which mean the question was answered HERE. A
+ * question answered anywhere else — the change committed at the desk, the
+ * decision taken and no longer worth a reply — has neither, so the badge, the
+ * waiting count and the push stood over a decision already made.
+ *
+ * `text` is checked for the reason `expectPrompt` exists: the tap happened
+ * against a badge that may since have been replaced by a different question,
+ * and silencing THAT one is the failure this guard is here to prevent. A
+ * client that cannot say (absent) acknowledges whatever is standing.
+ *
+ * Types nothing, runs nothing, and is not remembered past the next turn.
+ */
+export function ackAsking(core, id, text) {
+    const s = core.sessions.get(id);
+    if (!s?.info.asking)
+        return;
+    const cur = s.info.asking.text;
+    if (text != null && !sameAsk(text, cur))
+        return;
+    s.askDismissed = { text: cur, stop: s.stopCount };
+    s.info.asking = null;
+    persistAsk(core, s);
+    core.emit("updated", s.info);
+}
+/** Rewrite the `live/` record so "handled" survives a restart — `persistLive`
+ *  takes `askDismissed` off the live session. */
+function persistAsk(core, s) {
+    const m = core.loadLive(s.info.id);
+    if (m)
+        core.persistLive(m);
+}
+/**
+ * Attach a plugin's suggestion to a session. A numbered-CHOICE suggestion is
+ * tied to a live prompt, so it's dropped if the prompt already changed (stale)
+ * — we never show a choice for a gone prompt. A free-text REPLY suggestion
+ * (choice == null) has no prompt to bind to, so it's always allowed; this is
+ * what surfaces the turn-end reply bar.
+ */
+export function setSuggestion(core, id, s) {
+    const sess = core.sessions.get(id);
+    if (!sess)
+        return;
+    if (s && s.choice != null && !sess.info.prompt)
+        return; // stale numbered choice
+    sess.info.suggestion = s;
+    core.emit("updated", sess.info);
+}
+//# sourceMappingURL=askwatch.js.map

package/packages/host/dist/sessions/askwatch.js.map

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

package/packages/host/dist/sessions/boxes.d.ts

@@ -1,20 +1,4 @@
-/**
- * The choice box: when to look for one, reading it off the rendered screen
- * (claude's numbered box and opencode's highlighted row), publishing it, the
- * "unparsable dialog" fallback flag, the sign-in link that rides on the same
- * render, and the two answer walks that place a selection before pressing
- * Return. Stateless — every per-session fact lives on the `Session` record.
- * Reasoning: `waterplane-heuristics` (`prompt.ts`, `ocprompt.ts`, `askbox.ts`,
- * `login.ts`) and docs/notes/host-architecture.md.
- */
-import { type DetectedPrompt } from "@waterplane/shared";
-export { sourceKeysProblem } from "../sourceanswer.js";
-import type { Session, SessionCore } from "./core.js";
-export declare function scheduleChecks(core: SessionCore, s: Session): void;
-/** Arm the prompt check, EARLIEST-wins: a later caller may pull the check
- *  forward but never push a pending one back (that is what made the debounce
- *  starve under constant output). */
-export declare function armPromptCheck(core: SessionCore, s: Session, delayMs: number): void;
+import type { SessionCore } from "./core.js";
 /**
  * Answer an unnumbered box by placing the selection on the option the user
  * named, and only then pressing Return.
@@ -39,9 +23,6 @@ export declare function choosePromptBox(core: SessionCore, id: string, choice: n
     ok: boolean;
     reason?: string;
 }>;
-/** Is the published box the side channel's, or is the channel reconciled and
- *  owning every box? Either way the screen has nothing to add. */
-export declare function screenReaderOff(s: Session): boolean;
 /**
  * **The one answer dispatcher** — every answer to a choice box goes through
  * here: the phone's tap (`routes/session.ts`, a digit, a `promptChoice`, typed
@@ -80,9 +61,6 @@ export declare function answerBox(core: SessionCore, id: string, choice: number,
     ok: boolean;
     reason?: string;
 }>;
-/** Publish the "unparsable dialog on screen" fallback flag. */
-export declare function setAwaiting(core: SessionCore, s: Session, on: boolean, screen?: string): void;
-export declare function applyPrompt(core: SessionCore, s: Session, prompt: DetectedPrompt | null): void;
 /**
  * Press Return on a checkbox box's **Submit row**, walking the selection
  * cursor there first.
@@ -110,3 +88,4 @@ export declare function submitPromptBox(core: SessionCore, id: string): Promise<
     ok: boolean;
     placed: boolean;
 }>;
+export { sourceKeysProblem } from "../sourceanswer.js";