@cuna_labs/cli 0.1.0 → 0.1.1

package/dist/bin/cuna.js

@@ -1,4 +1,17 @@
 #!/usr/bin/env node
-import { runProcessCli } from "../cli/process-entrypoint.js";
-process.exitCode = await runProcessCli(process.argv.slice(2), { stdin: process.stdin });
+import { paintFirstLine } from "../cli/first-line.js";
+// The first line is painted before the rest of the CLI is imported: loading
+// that graph is most of the time before anything appears (cli/first-line.ts).
+const argv = process.argv.slice(2);
+const firstLine = paintFirstLine(argv, {
+    env: process.env,
+    stdinIsTTY: process.stdin.isTTY === true,
+    stdoutIsTTY: process.stdout.isTTY === true,
+    stderr: process.stderr,
+});
+const { runProcessCli } = await import("../cli/process-entrypoint.js");
+process.exitCode = await runProcessCli(argv, {
+    stdin: process.stdin,
+    ...(firstLine === undefined ? {} : { firstLine }),
+});
 //# sourceMappingURL=cuna.js.map

package/dist/bin/cuna.js.map

@@ -1 +1 @@
-{"version":3,"file":"cuna.js","sourceRoot":"","sources":["../../src/bin/cuna.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D,OAAO,CAAC,QAAQ,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC"}
+{"version":3,"file":"cuna.js","sourceRoot":"","sources":["../../src/bin/cuna.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,4EAA4E;AAC5E,8EAA8E;AAC9E,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,EAAE;IACrC,GAAG,EAAE,OAAO,CAAC,GAAG;IAChB,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI;IACxC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI;IAC1C,MAAM,EAAE,OAAO,CAAC,MAAM;CACvB,CAAC,CAAC;AACH,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,8BAA8B,CAAC,CAAC;AACvE,OAAO,CAAC,QAAQ,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE;IAC3C,KAAK,EAAE,OAAO,CAAC,KAAK;IACpB,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;CAClD,CAAC,CAAC"}

package/dist/cli/command-help.js

@@ -86,8 +86,8 @@ const COMMAND_HELP = Object.freeze({
     "machines resume": topic("Usage:\n  cuna machines resume MACHINE_ID --yes", "Resume one machine when server-advertised.\n\nRequired:\n  --yes               Confirm this mutating operation"),
     "machines stop": topic("Usage:\n  cuna machines stop MACHINE_ID --yes", "Stop one machine when server-advertised.\n\nRequired:\n  --yes               Confirm this mutating operation"),
     "machines update-supervisor": topic("Usage:\n  cuna machines update-supervisor MACHINE_ID --yes", [
-        "Update the terminal supervisor on one stopped OpenCode machine when Cuna",
-        "reports that exact prerequisite.",
+        "Recover the terminal supervisor on one stopped machine.",
+        "Cuna verifies eligibility and active-session blockers before updating.",
         "",
         "Cuna never stops the machine or terminates AgentSessions for this action.",
         "End only the sessions you intend to end, stop the Machine yourself, then run it.",

package/dist/cli/command-help.js.map

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

package/dist/cli/first-line.d.ts

@@ -0,0 +1,80 @@
+import type { Writable } from "node:stream";
+/**
+ * THE FIRST TRUTHFUL LINE, PAINTED BEFORE THE CLI'S CODE HAS LOADED.
+ *
+ * WHY THIS FILE EXISTS. Measured 2026-09-22: from `runCli` to the first paint
+ * takes about 11 ms; everything before it is Node loading the static import
+ * graph behind `cli/run.ts`, about 2.2 MB in 138 files, ~98% of the time to the
+ * first line. The same unchanged build painted at 499 ms on a quiet host and at
+ * 1 391 ms on a loaded one, so no change inside that graph can hold the line
+ * down. `bin/cuna.ts` therefore imports only this module (and the small ones it
+ * needs), paints here, and only then loads the rest.
+ *
+ * WHAT IT MAY PAINT, EXACTLY. Only the row `runCli` would itself paint first,
+ * decided by the same calls in the same order: the `Starting Cuna` row for an
+ * interactive bare `cuna`, and the `Preparing …` row for `cuna claude`, `codex`
+ * or `opencode` once `assertRegisteredCliRoute` and
+ * `preflightAgentJourneyInvocation` accept the arguments. Nothing is painted
+ * unless stdin, stdout and stderr are all terminals and `--json` is absent, so a
+ * redirected or structured invocation writes exactly what it wrote before.
+ *
+ * HOW IT IS HANDED OVER. The paint site in `cli/run.ts` that would have drawn
+ * this row `claim`s it and continues from frame 1 without drawing frame 0
+ * again. If `runCli` fails before that site, its error path `release`s the row
+ * first, so the error is not written onto the end of it.
+ */
+export declare const ROOT_FIRST_LINE_LABEL = "Starting Cuna";
+export declare function agentDisplayName(agent: string): string;
+export declare function journeyPreparationLabel(agent: string): string;
+export interface FirstLineDecision {
+    readonly kind: "root" | "journey";
+    readonly label: string;
+    readonly color: boolean;
+}
+/** What a paint site needs to continue a row it did not draw. */
+export interface PaintedFirstLine {
+    readonly paintedAt: number;
+    readonly columns: number;
+    readonly cells: number;
+}
+export interface FirstLine {
+    /**
+     * Hand the painted row to the paint site that would have drawn `expected`.
+     * Answers once: a different row, colour or stream releases it instead, and so
+     * does every later call, so a nested `runCli` can never take it a second time.
+     */
+    claim(expected: FirstLineDecision & {
+        readonly stream: Writable;
+    }): PaintedFirstLine | undefined;
+    /** Clear the row unless a paint site already took it. Safe to call again. */
+    release(): void;
+}
+/**
+ * The row `runCli` will paint first for this invocation, or `undefined` when it
+ * would paint nothing first or something this module cannot prove.
+ */
+export declare function firstLineFor(argv: readonly string[], context: {
+    readonly env: NodeJS.ProcessEnv;
+    readonly stdinIsTTY: boolean;
+    readonly stdoutIsTTY: boolean;
+    readonly stderrIsTTY: boolean;
+}): FirstLineDecision | undefined;
+/** Frame 0 of the row, exactly as `startInlineProgress` would paint it. */
+export declare function firstLineFrame(label: string, color: boolean, columns: number): {
+    readonly bytes: string;
+    readonly cells: number;
+};
+/**
+ * Paint the first line if this invocation has one, and return the handle that
+ * gives it to `runCli`.
+ */
+export declare function paintFirstLine(argv: readonly string[], host: {
+    readonly env: NodeJS.ProcessEnv;
+    readonly stdinIsTTY: boolean;
+    readonly stdoutIsTTY: boolean;
+    readonly stderr: Writable & {
+        readonly isTTY?: boolean;
+    };
+    readonly now?: () => number;
+}): FirstLine | undefined;
+//# sourceMappingURL=first-line.d.ts.map

package/dist/cli/first-line.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-line.d.ts","sourceRoot":"","sources":["../../src/cli/first-line.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAU5C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,eAAO,MAAM,qBAAqB,kBAAkB,CAAC;AAErD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKtD;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI7D;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,iEAAiE;AACjE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,iBAAiB,GAAG;QAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;KAAE,GAAG,gBAAgB,GAAG,SAAS,CAAC;IACjG,6EAA6E;IAC7E,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE;IACP,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B,GACA,iBAAiB,GAAG,SAAS,CAsB/B;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAIjI;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,IAAI,EAAE;IACJ,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACzD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B,GACA,SAAS,GAAG,SAAS,CA+BvB"}

package/dist/cli/first-line.js

@@ -0,0 +1,119 @@
+import { assertRegisteredCliRoute, booleanOption, parseArgv } from "./parser.js";
+import { preflightAgentJourneyInvocation } from "../journey/intent.js";
+import { composeInlineProgressLine, inlineProgressColumns, renderInlineProgressFrame, } from "./progress-line.js";
+import { terminalCellWidth } from "../terminal/cell-width.js";
+/**
+ * THE FIRST TRUTHFUL LINE, PAINTED BEFORE THE CLI'S CODE HAS LOADED.
+ *
+ * WHY THIS FILE EXISTS. Measured 2026-09-22: from `runCli` to the first paint
+ * takes about 11 ms; everything before it is Node loading the static import
+ * graph behind `cli/run.ts`, about 2.2 MB in 138 files, ~98% of the time to the
+ * first line. The same unchanged build painted at 499 ms on a quiet host and at
+ * 1 391 ms on a loaded one, so no change inside that graph can hold the line
+ * down. `bin/cuna.ts` therefore imports only this module (and the small ones it
+ * needs), paints here, and only then loads the rest.
+ *
+ * WHAT IT MAY PAINT, EXACTLY. Only the row `runCli` would itself paint first,
+ * decided by the same calls in the same order: the `Starting Cuna` row for an
+ * interactive bare `cuna`, and the `Preparing …` row for `cuna claude`, `codex`
+ * or `opencode` once `assertRegisteredCliRoute` and
+ * `preflightAgentJourneyInvocation` accept the arguments. Nothing is painted
+ * unless stdin, stdout and stderr are all terminals and `--json` is absent, so a
+ * redirected or structured invocation writes exactly what it wrote before.
+ *
+ * HOW IT IS HANDED OVER. The paint site in `cli/run.ts` that would have drawn
+ * this row `claim`s it and continues from frame 1 without drawing frame 0
+ * again. If `runCli` fails before that site, its error path `release`s the row
+ * first, so the error is not written onto the end of it.
+ */
+export const ROOT_FIRST_LINE_LABEL = "Starting Cuna";
+export function agentDisplayName(agent) {
+    return agent === "claude-code" ? "Claude Code"
+        : agent === "codex" ? "Codex"
+            : agent === "opencode" ? "OpenCode"
+                : "OpenClaw";
+}
+export function journeyPreparationLabel(agent) {
+    return agent === "opencode"
+        ? "Preparing OpenCode — use /connect in its terminal"
+        : `Preparing ${agentDisplayName(agent)}`;
+}
+/**
+ * The row `runCli` will paint first for this invocation, or `undefined` when it
+ * would paint nothing first or something this module cannot prove.
+ */
+export function firstLineFor(argv, context) {
+    if (!context.stdinIsTTY || !context.stdoutIsTTY || !context.stderrIsTTY)
+        return undefined;
+    if (argv.includes("--json"))
+        return undefined;
+    try {
+        const parsed = parseArgv(argv);
+        if (parsed.command === "help" || parsed.command === "version" ||
+            booleanOption(parsed, "help") || booleanOption(parsed, "version"))
+            return undefined;
+        const color = !booleanOption(parsed, "no-color") && !Object.hasOwn(context.env, "NO_COLOR");
+        if (parsed.command === undefined) {
+            // `runCli` refuses any other option on a bare invocation before it paints.
+            const allowed = new Set(["help", "version", "json", "no-color"]);
+            if (Object.keys(parsed.options).some((name) => !allowed.has(name)))
+                return undefined;
+            return Object.freeze({ kind: "root", label: ROOT_FIRST_LINE_LABEL, color });
+        }
+        if (parsed.command !== "claude" && parsed.command !== "codex" && parsed.command !== "opencode")
+            return undefined;
+        assertRegisteredCliRoute(parsed);
+        const intent = preflightAgentJourneyInvocation(parsed);
+        return Object.freeze({ kind: "journey", label: journeyPreparationLabel(intent.agent), color });
+    }
+    catch {
+        // Every refusal here is `runCli`'s to render, in its own words.
+        return undefined;
+    }
+}
+/** Frame 0 of the row, exactly as `startInlineProgress` would paint it. */
+export function firstLineFrame(label, color, columns) {
+    const { headline, trailer } = composeInlineProgressLine({ label, labelElapsedMs: 0, totalElapsedMs: 0 });
+    const { styled, fitted } = renderInlineProgressFrame({ headline, trailer, frame: 0, columns, color });
+    return Object.freeze({ bytes: `\r\u001b[2K${styled}`, cells: terminalCellWidth(fitted) });
+}
+/**
+ * Paint the first line if this invocation has one, and return the handle that
+ * gives it to `runCli`.
+ */
+export function paintFirstLine(argv, host) {
+    const decision = firstLineFor(argv, {
+        env: host.env,
+        stdinIsTTY: host.stdinIsTTY,
+        stdoutIsTTY: host.stdoutIsTTY,
+        stderrIsTTY: host.stderr.isTTY === true,
+    });
+    if (decision === undefined)
+        return undefined;
+    const columns = inlineProgressColumns(host.stderr);
+    const frame = firstLineFrame(decision.label, decision.color, columns);
+    const paintedAt = (host.now ?? Date.now)();
+    host.stderr.write(frame.bytes);
+    let open = true;
+    const release = () => {
+        if (!open)
+            return;
+        open = false;
+        host.stderr.write("\r\u001b[2K");
+    };
+    return Object.freeze({
+        claim(expected) {
+            if (!open)
+                return undefined;
+            if (expected.stream !== host.stderr || expected.kind !== decision.kind ||
+                expected.label !== decision.label || expected.color !== decision.color) {
+                release();
+                return undefined;
+            }
+            open = false;
+            return Object.freeze({ paintedAt, columns, cells: frame.cells });
+        },
+        release,
+    });
+}
+//# sourceMappingURL=first-line.js.map

package/dist/cli/first-line.js.map

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

package/dist/cli/help.js

@@ -137,7 +137,7 @@ Available now:
   machines list                        List owned Cuna machines
   machines create [options]            Create a machine when server-advertised
   machines start|pause|resume|stop ID  Change lifecycle when server-advertised
-  machines update-supervisor ID        Update a stopped OpenCode terminal supervisor
+  machines update-supervisor ID        Recover a stopped machine's terminal supervisor
   machines live-update-supervisor ID   Update a running terminal supervisor in place;
                                        reports one custody line per AgentSession
   machines live-update-status ID       Read what one in-place update did; sends nothing

package/dist/cli/process-entrypoint.d.ts

@@ -1,4 +1,5 @@
 import { runCli } from "./run.js";
+import type { FirstLine } from "./first-line.js";
 type SupportedProcessSignal = "SIGINT" | "SIGTERM" | "SIGHUP";
 export interface ProcessSignalHost {
     once(signal: SupportedProcessSignal, listener: () => void): unknown;
@@ -13,6 +14,8 @@ export declare function runProcessCli(argv: readonly string[], input?: {
     /** The real process stdin, supplied only by the executable entrypoint. */
     readonly stdin?: ProcessInputHost;
     readonly run?: typeof runCli;
+    /** The row the executable painted before this module loaded; see `cli/first-line.ts`. */
+    readonly firstLine?: FirstLine;
 }): Promise<number>;
 export {};
 //# sourceMappingURL=process-entrypoint.d.ts.map

package/dist/cli/process-entrypoint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process-entrypoint.d.ts","sourceRoot":"","sources":["../../src/cli/process-entrypoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,KAAK,sBAAsB,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE9D,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,MAAM,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;IACpE,cAAc,CAAC,MAAM,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;CAC/E;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,IAAI,OAAO,CAAC;IACjB,OAAO,IAAI,OAAO,CAAC;CACpB;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,KAAK,GAAE;IACL,QAAQ,CAAC,IAAI,CAAC,EAAE,iBAAiB,CAAC;IAClC,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,MAAM,CAAC;CACzB,GACL,OAAO,CAAC,MAAM,CAAC,CAsBjB"}
+{"version":3,"file":"process-entrypoint.d.ts","sourceRoot":"","sources":["../../src/cli/process-entrypoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,KAAK,sBAAsB,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE9D,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,MAAM,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;IACpE,cAAc,CAAC,MAAM,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;CAC/E;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,IAAI,OAAO,CAAC;IACjB,OAAO,IAAI,OAAO,CAAC;CACpB;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,KAAK,GAAE;IACL,QAAQ,CAAC,IAAI,CAAC,EAAE,iBAAiB,CAAC;IAClC,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,MAAM,CAAC;IAC7B,yFAAyF;IACzF,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;CAC3B,GACL,OAAO,CAAC,MAAM,CAAC,CAwBjB"}

package/dist/cli/process-entrypoint.js

@@ -10,9 +10,11 @@ export async function runProcessCli(argv, input = {}) {
     host.once("SIGTERM", terminate);
     host.once("SIGHUP", hangup);
     try {
-        return await run(argv, { signal: controller.signal });
+        return await run(argv, { signal: controller.signal, ...(input.firstLine === undefined ? {} : { firstLine: input.firstLine }) });
     }
     finally {
+        // A row nothing took over must not outlive the command on the prompt line.
+        input.firstLine?.release();
         host.removeListener("SIGINT", interrupt);
         host.removeListener("SIGTERM", terminate);
         host.removeListener("SIGHUP", hangup);

package/dist/cli/process-entrypoint.js.map

@@ -1 +1 @@
-{"version":3,"file":"process-entrypoint.js","sourceRoot":"","sources":["../../src/cli/process-entrypoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAclC,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAuB,EACvB,QAKI,EAAE;IAEN,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,OAAO,CAAC;IACnC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,MAAM,CAAC;IAChC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC,CAAC;IACvF,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC,CAAC;IACvF,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC,CAAC;IACpF,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC/B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAChC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC5B,IAAI,CAAC;QACH,OAAO,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;IACxD,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACzC,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC1C,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACtC,wEAAwE;QACxE,oEAAoE;QACpE,0EAA0E;QAC1E,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC;QACrB,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;IACzB,CAAC;AACH,CAAC"}
+{"version":3,"file":"process-entrypoint.js","sourceRoot":"","sources":["../../src/cli/process-entrypoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAelC,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAuB,EACvB,QAOI,EAAE;IAEN,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,OAAO,CAAC;IACnC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,MAAM,CAAC;IAChC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC,CAAC;IACvF,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC,CAAC;IACvF,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC,CAAC;IACpF,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC/B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAChC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC5B,IAAI,CAAC;QACH,OAAO,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;IAClI,CAAC;YAAS,CAAC;QACT,2EAA2E;QAC3E,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC;QAC3B,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACzC,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC1C,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACtC,wEAAwE;QACxE,oEAAoE;QACpE,0EAA0E;QAC1E,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC;QACrB,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;IACzB,CAAC;AACH,CAAC"}

package/dist/cli/progress-line.d.ts

@@ -0,0 +1,78 @@
+import type { Writable } from "node:stream";
+import { type JourneyWait } from "../journey/wait-policy.js";
+import type { JourneyAgentSessionDisposition } from "../journey/orchestrator.js";
+/**
+ * What the one inline progress row SAYS, separated from how it is painted.
+ *
+ * WHY IT IS ITS OWN FILE. The paint loop owns cursor control, terminal width,
+ * colour and a 90 ms timer; none of that can be asserted without a real clock
+ * and a real TTY, and the defect being repaired here is entirely about words.
+ * Measured 2026-09-22 (`prds/cuna-cli-latency-before-20260922.md` § 3): the row
+ * repainted every 90 ms for 61 259 ms while saying the same eleven words, so
+ * every byte-level liveness check passed and the screen was still frozen to a
+ * reader. Keeping the sentence testable is the only way that stays fixed.
+ */
+/**
+ * When the elapsed counter joins the label.
+ *
+ * DERIVATION. The goal's own silence threshold is 2 000 ms, and the measured
+ * dwell floor worth reporting was `Preparing Claude Code` at 2.0–3.7 s in
+ * all five runs (§ 3, finding 4). Below this a step is finishing normally and
+ * a counter is noise; above it, the number is the only evidence a person has.
+ */
+export declare const INLINE_DWELL_HINT_MS = 2000;
+/**
+ * When the Ctrl-C affordance joins the line. Unchanged from the behaviour this
+ * replaces, and deliberately measured against the WHOLE command rather than
+ * the current step: the affordance is about this process, and resetting it on
+ * every phase change would hide it from exactly the long journeys that need it.
+ */
+export declare const INLINE_CANCEL_HINT_MS = 12000;
+export interface InlineProgressLineInput {
+    readonly label: string;
+    /** Present while a declared wait owns the row; it supplies its own sentence. */
+    readonly waiting?: JourneyWait | undefined;
+    /** How long the CURRENT label has been on screen, not the whole command. */
+    readonly labelElapsedMs: number;
+    readonly totalElapsedMs: number;
+}
+export interface InlineProgressLine {
+    /** The bright half: the step, or the wait that replaced it. */
+    readonly headline: string;
+    /** The dim half: elapsed seconds and the cancel affordance. */
+    readonly trailer: string;
+}
+export declare function composeInlineProgressLine(input: InlineProgressLineInput): InlineProgressLine;
+/**
+ * One painted frame of the row, as the bytes after `\r\x1b[2K`.
+ *
+ * Here rather than inside the paint loop because two writers must produce the
+ * same frame: `cli/first-line.ts` paints frame 0 before the CLI's modules have
+ * loaded, and the loop in `cli/run.ts` takes the row over from frame 1. Two
+ * spellings of one frame would show as a flicker at the handover.
+ */
+export declare function renderInlineProgressFrame(input: {
+    readonly headline: string;
+    readonly trailer: string;
+    readonly frame: number;
+    readonly columns: number;
+    readonly color: boolean;
+}): {
+    readonly styled: string;
+    readonly fitted: string;
+};
+export declare function inlineProgressColumns(stream: Writable): number;
+/**
+ * The one durable line that says which AgentSession this journey settled on.
+ *
+ * Measured 2026-09-22 (§ 2, finding (ii)): no such line existed. The CLI
+ * printed the intent `Creating Claude Code session` and never a completion, so
+ * the row `00b6d65a` was created at t+11 446 ms while the screen still read
+ * `Starting Claude Code`, and nothing named it for the rest of the run; the
+ * only thing resembling a reuse statement was a QUESTION. The id is shown as
+ * an 8-character prefix, the truncation `runtime/owner-grants-screen.ts`
+ * already uses when it puts a resource id on screen, so it can never read as a
+ * whole identifier.
+ */
+export declare function agentSessionDispositionLine(event: JourneyAgentSessionDisposition): string;
+//# sourceMappingURL=progress-line.d.ts.map

package/dist/cli/progress-line.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-line.d.ts","sourceRoot":"","sources":["../../src/cli/progress-line.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AAGjF;;;;;;;;;;GAUG;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,OAAQ,CAAC;AAE1C;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAE5C,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gFAAgF;IAChF,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC3C,4EAA4E;IAC5E,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,uBAAuB,GAAG,kBAAkB,CAU5F;AAKD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CASvD;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAkB9D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,8BAA8B,GAAG,MAAM,CAEzF"}

package/dist/cli/progress-line.js

@@ -0,0 +1,94 @@
+import { journeyWaitLine } from "../journey/wait-policy.js";
+import { truncateTerminalLine } from "../terminal/cell-width.js";
+/**
+ * What the one inline progress row SAYS, separated from how it is painted.
+ *
+ * WHY IT IS ITS OWN FILE. The paint loop owns cursor control, terminal width,
+ * colour and a 90 ms timer; none of that can be asserted without a real clock
+ * and a real TTY, and the defect being repaired here is entirely about words.
+ * Measured 2026-09-22 (`prds/cuna-cli-latency-before-20260922.md` § 3): the row
+ * repainted every 90 ms for 61 259 ms while saying the same eleven words, so
+ * every byte-level liveness check passed and the screen was still frozen to a
+ * reader. Keeping the sentence testable is the only way that stays fixed.
+ */
+/**
+ * When the elapsed counter joins the label.
+ *
+ * DERIVATION. The goal's own silence threshold is 2 000 ms, and the measured
+ * dwell floor worth reporting was `Preparing Claude Code` at 2.0–3.7 s in
+ * all five runs (§ 3, finding 4). Below this a step is finishing normally and
+ * a counter is noise; above it, the number is the only evidence a person has.
+ */
+export const INLINE_DWELL_HINT_MS = 2_000;
+/**
+ * When the Ctrl-C affordance joins the line. Unchanged from the behaviour this
+ * replaces, and deliberately measured against the WHOLE command rather than
+ * the current step: the affordance is about this process, and resetting it on
+ * every phase change would hide it from exactly the long journeys that need it.
+ */
+export const INLINE_CANCEL_HINT_MS = 12_000;
+export function composeInlineProgressLine(input) {
+    const headline = input.waiting === undefined ? input.label : journeyWaitLine(input.waiting);
+    // A wait headline already carries its own seconds AND its deadline, which is
+    // strictly more than the counter would add. Two elapsed figures on one row
+    // is the kind of thing a reader has to stop and reconcile.
+    const dwellHint = input.waiting === undefined && input.labelElapsedMs >= INLINE_DWELL_HINT_MS
+        ? ` · ${Math.floor(input.labelElapsedMs / 1_000)}s`
+        : "";
+    const cancelHint = input.totalElapsedMs >= INLINE_CANCEL_HINT_MS ? " — Ctrl-C cancels" : "";
+    return Object.freeze({ headline, trailer: `${dwellHint}${cancelHint}` });
+}
+const INLINE_PROGRESS_SPINNER = Object.freeze(["◐", "◓", "◑", "◒"]);
+const INLINE_PROGRESS_BARS = Object.freeze(["━╺━━━━", "━━╺━━━", "━━━╺━━", "━━━━╺━", "━━━━━╺", "━━━━╸━", "━━━╸━━", "━━╸━━━"]);
+/**
+ * One painted frame of the row, as the bytes after `\r\x1b[2K`.
+ *
+ * Here rather than inside the paint loop because two writers must produce the
+ * same frame: `cli/first-line.ts` paints frame 0 before the CLI's modules have
+ * loaded, and the loop in `cli/run.ts` takes the row over from frame 1. Two
+ * spellings of one frame would show as a flicker at the handover.
+ */
+export function renderInlineProgressFrame(input) {
+    const spinner = INLINE_PROGRESS_SPINNER[input.frame % INLINE_PROGRESS_SPINNER.length];
+    const bar = INLINE_PROGRESS_BARS[input.frame % INLINE_PROGRESS_BARS.length];
+    const text = `◆ CUNA  ${spinner} ${input.headline}${input.trailer}  ${bar}`;
+    const fitted = truncateTerminalLine(text, input.columns - 1);
+    const styled = input.color && fitted === text
+        ? `\u001b[38;5;202m\u001b[1m◆ CUNA\u001b[0m  \u001b[38;5;202m${spinner}\u001b[0m \u001b[38;5;255m\u001b[1m${input.headline}\u001b[0m\u001b[38;5;245m${input.trailer}\u001b[0m  \u001b[38;5;208m${bar}\u001b[0m`
+        : input.color ? `\u001b[38;5;255m${fitted}\u001b[0m` : fitted;
+    return Object.freeze({ styled, fitted });
+}
+export function inlineProgressColumns(stream) {
+    const tty = stream;
+    // Node 24 on Windows can retain stale public columns after ConPTY resize.
+    // Read this stream's native TTY observation without changing its prototype
+    // or cached fields. This guarded private API depends on the supported Node
+    // engine; absent/failed/malformed observations retain the ordinary fallback.
+    if (process.platform === "win32" && typeof tty._handle?.getWindowSize === "function") {
+        try {
+            const size = [];
+            if (tty._handle.getWindowSize(size) === 0 && size.length === 2 &&
+                Number.isSafeInteger(size[0]) && size[0] >= 2 && size[0] <= 4096 &&
+                Number.isSafeInteger(size[1]) && size[1] >= 1 && size[1] <= 4096)
+                return size[0];
+        }
+        catch { /* An unavailable native observation does not break progress. */ }
+    }
+    return Number.isSafeInteger(tty.columns) && tty.columns >= 2 && tty.columns <= 4096 ? tty.columns : 80;
+}
+/**
+ * The one durable line that says which AgentSession this journey settled on.
+ *
+ * Measured 2026-09-22 (§ 2, finding (ii)): no such line existed. The CLI
+ * printed the intent `Creating Claude Code session` and never a completion, so
+ * the row `00b6d65a` was created at t+11 446 ms while the screen still read
+ * `Starting Claude Code`, and nothing named it for the rest of the run; the
+ * only thing resembling a reuse statement was a QUESTION. The id is shown as
+ * an 8-character prefix, the truncation `runtime/owner-grants-screen.ts`
+ * already uses when it puts a resource id on screen, so it can never read as a
+ * whole identifier.
+ */
+export function agentSessionDispositionLine(event) {
+    return `AgentSession ${event.agentSessionId.slice(0, 8)} · ${event.disposition}`;
+}
+//# sourceMappingURL=progress-line.js.map

package/dist/cli/progress-line.js.map

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

package/dist/cli/recorded-launch-prompt.d.ts

@@ -0,0 +1,83 @@
+/**
+ * THE ONE QUESTION THE CLI ASKS MID-JOURNEY, AND WHAT THE SCREEN OWES THE
+ * PERSON THE MOMENT THEY ANSWER IT.
+ *
+ * WHY THIS IS A MODULE AND NOT FOUR LINES IN `run.ts`. Measured 2026-09-22
+ * (`prds/cuna-cli-latency-before-20260922.md` § 3, finding 1): after this
+ * answer was accepted, the terminal went BYTE-silent — no output at all, not a
+ * repeating spinner — for 2 317 ms, 3 864 ms and 18 314 ms in three of five
+ * runs. The screen froze on the person's own keystroke, which is the worst
+ * shape a stall can take, because the last thing they did is the thing that
+ * appears to have broken it.
+ *
+ * The cause was structural: the question gave the progress row up in order to
+ * be readable, and nothing took the row back until the next remote step
+ * happened to report. Whatever that step cost was silence. So the repair is not
+ * "make the next step faster" — it is that the answer itself is an event worth
+ * rendering, and it is rendered from the branch that was actually taken rather
+ * than from the question that was asked.
+ *
+ * Keeping it here rather than inline is what makes that assertable: `run.ts`
+ * reaches this code only through a real TTY, a real `process.stdin` and a
+ * 90 ms paint timer, none of which can express the defect, which was entirely
+ * about WHEN a line appears relative to an answer.
+ */
+/**
+ * Asked verbatim, and quoted verbatim in the measurement, so the two can be
+ * compared without guessing which build produced a transcript.
+ */
+export declare const RECORDED_LAUNCH_QUESTION = "A previous launch is recorded. Create another session? [y/N; No resumes the recorded launch] ";
+/**
+ * How long the screen may stay unchanged after the answer is accepted.
+ *
+ * DERIVATION. Not a tuning knob: it is the bound this module exists to hold,
+ * and it is deliberately far below the 2 000 ms threshold the measurement used
+ * to call a stall a stall, because a stall that begins on the person's own
+ * keypress reads as a crash rather than as waiting. The measured worst case was
+ * 18 314 ms, which is 36 times this.
+ */
+export declare const RECORDED_LAUNCH_ACKNOWLEDGEMENT_BUDGET_MS = 500;
+/**
+ * What answers the recorded-launch question for a folder journey.
+ * `--new-session` is that answer already given on the command line, so it is
+ * not asked again: asking let a No, or a slow answer, override the flag (qa6
+ * witness 2026-09-22). Without the flag the person is asked.
+ */
+export declare function recordedLaunchConfirmation<S>(newSessionFlag: boolean, ask: (signal: S) => Promise<boolean>): (signal: S) => Promise<boolean>;
+/** Only an explicit yes creates; anything else, including empty, resumes. */
+export declare function recordedLaunchWantsNewSession(answer: string): boolean;
+/**
+ * What the screen says next, named for the branch that was taken rather than
+ * for the question that was asked.
+ *
+ * `No` resumes a launch that already exists, and calling that "Creating" would
+ * be the CLI announcing work it is not about to do — which is the same defect
+ * as the silence, one layer up: a screen that does not describe what is
+ * happening.
+ */
+export declare function recordedLaunchAcknowledgement(wantsNewSession: boolean, createLabel: string): string;
+export interface RecordedLaunchPromptInput {
+    /**
+     * Asks the question and resolves with the raw answer. It MUST complete its
+     * own teardown before resolving: the acknowledgement writes to the same
+     * stream, and a line painted underneath a live readline fights it for the
+     * cursor.
+     */
+    readonly ask: (question: string) => Promise<string>;
+    /** Puts the acknowledgement on screen. Called before this function resolves. */
+    readonly acknowledge: (line: string) => void;
+    /** What the create branch is called, e.g. `Creating Claude Code session`. */
+    readonly createLabel: string;
+}
+/**
+ * Ask the recorded-launch question and answer the screen at once.
+ *
+ * THE BOUND THIS GIVES, STATED EXACTLY. `acknowledge` is called synchronously
+ * between the answer arriving and this function resolving, so no remote work
+ * can be dispatched in between — not because a timer says so, but because
+ * there is nowhere for it to go. The caller therefore cannot reintroduce the
+ * measured silence by being slow; it can only reintroduce it by writing
+ * nothing, which is what `acknowledge` exists to prevent.
+ */
+export declare function askRecordedLaunch(input: RecordedLaunchPromptInput): Promise<boolean>;
+//# sourceMappingURL=recorded-launch-prompt.d.ts.map

package/dist/cli/recorded-launch-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorded-launch-prompt.d.ts","sourceRoot":"","sources":["../../src/cli/recorded-launch-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH;;;GAGG;AACH,eAAO,MAAM,wBAAwB,kGAC4D,CAAC;AAElG;;;;;;;;GAQG;AACH,eAAO,MAAM,yCAAyC,MAAM,CAAC;AAE7D;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,EAC1C,cAAc,EAAE,OAAO,EACvB,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GACnC,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAEjC;AAED,6EAA6E;AAC7E,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAErE;AAED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAAC,eAAe,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEnG;AAED,MAAM,WAAW,yBAAyB;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,gFAAgF;IAChF,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,OAAO,CAAC,CAI1F"}