@songsid/agend 2.2.0-beta.1 → 2.2.0-beta.11

package/dist/backend/launch-effort.d.ts

@@ -0,0 +1,61 @@
+/** What a launch does with a configured effort: the argument to append (with its leading space) and its level, or why none. */
+export interface LaunchEffort {
+    arg: string | null;
+    note: string | null;
+    level?: string;
+}
+export type HelpRunner = (binary: string, args: string[]) => string;
+/**
+ * A CLI's help text: its stdout, or its stderr when stdout is empty — agy (a Go CLI) prints its usage to stderr
+ * (#1825: 1.3.4 and 1.3.5 write nothing to stdout, so reading stdout alone saw no `--effort` at all). Throws when the
+ * CLI cannot run or exits non-zero.
+ */
+export declare function readHelpText(binary: string, args?: string[]): string;
+/** The binary's `--help`, read once per binary file; null when it cannot be read (then no flag is passed). */
+export declare function cliHelp(binaryPath: string, run?: HelpRunner): string | null;
+/** For tests: forget what was read. */
+export declare function resetCliHelpCache(): void;
+/**
+ * Whether the help lists `flag` as an option, and the values it gives for it: the first `(a, b, c)` or `(a|b|c)`
+ * list in the option's own entry (its row and the description lines under it), in canonical order. `levels: null`
+ * when the entry names none.
+ */
+export declare function helpOption(help: string, flag: string): {
+    listed: boolean;
+    levels: string[] | null;
+};
+/**
+ * claude-code (`--effort`), grok (`--reasoning-effort`) and antigravity (`--effort`): the flag when this binary's help
+ * lists it and the level is one it takes.
+ */
+export declare function flagEffort(backend: "claude-code" | "grok" | "antigravity", effort: string | undefined, binaryPath: string, run?: HelpRunner): LaunchEffort;
+/** agy's model and effort for one launch: `--model` (absent: none), `--effort` (null: none), and why, quietly. */
+export interface AgyLaunch {
+    model: string | undefined;
+    effort: string | null;
+    note: string | null;
+}
+/**
+ * #1825: agy's catalog has one model per effort level (`gemini-3.8-flash-medium`, `…-high`, …), and agy 1.3.4/1.3.5
+ * resolve `--model` and `--effort` together: a variant with another level ("conflicts with --effort=high"), a label
+ * with any `--effort`, a level the model does not have, or a model it does not list each make agy run ANOTHER model,
+ * with only a warning row in the pane (verified offline against the real binaries). So the effort picks the exact
+ * variant — `gemini-3.8-flash-medium` + high launches `--model gemini-3.8-flash-high`, no `--effort` — and anything
+ * else launches the configured model without `--effort`. `--model` alone (a variant's slug or its label) and a bare
+ * `--effort` on agy's own model are what agy resolves exactly. fleet.yaml is never rewritten; the note says what ran.
+ *
+ * `catalog`/`current`: the CLI env probe's cached `agy models` and settings model (null: none cached).
+ */
+export declare function resolveAgyLaunch(model: string | undefined, level: string | null, catalog: readonly {
+    id: string;
+    label: string;
+}[] | null, current?: string | null): AgyLaunch;
+/**
+ * codex: `-c model_reasoning_effort="<level>"` when the model's own catalog entry lists the level. `-c` is in every
+ * codex AgEnD runs; what it does not check is the value, so the catalog is the gate.
+ */
+export declare function codexEffort(effort: string | undefined, catalog: {
+    model: string | null;
+    levels: string[] | null;
+    unproven?: boolean;
+}): LaunchEffort;

package/dist/backend/launch-effort.js

@@ -0,0 +1,170 @@
+/**
+ * #1811: a configured `effort`, as a launch flag. Before this only kiro-cli and muse launched with it; codex,
+ * claude-code, grok and antigravity saved it and launched without (codex's `/effort` restarted into nothing).
+ *
+ * A stored effort must never break a launch. The flag is passed only when
+ *  - this binary advertises it: its own `--help` lists the flag (an older CLI without it would refuse the unknown
+ *    option and not start — verified: grok 1.0.46 and agy 1.3.4 exit on an unknown flag, claude 2.1.299 too), and
+ *  - the level is one it takes: the values its help lists (claude, agy), grok's known three (its help lists none,
+ *    and it takes any string at parse time — verified with 1.0.46), or for codex the levels the model's own catalog
+ *    entry lists (codex 0.162.1 launches with any `model_reasoning_effort`, "bogus" included, and the API would
+ *    refuse it at the first turn).
+ * Anything else launches without the flag and says why in a quiet note (daemon.log and the Log tab), never a channel
+ * notice. A resumed session gets the flag too (verified: claude `--continue`/`--resume` with `--effort`, codex
+ * `resume <id>` with `-c`). The runtime `/effort` paste is unchanged.
+ */
+import { spawnSync } from "node:child_process";
+import { statSync } from "node:fs";
+import { measureSyncWork } from "../sync-work-attribution.js";
+import { EFFORT_CAPABILITIES, CANONICAL_EFFORT, agyModelFamily } from "./effort-metadata.js";
+import { t } from "../locale.js";
+import { shellQuote } from "./types.js";
+/**
+ * A CLI's help text: its stdout, or its stderr when stdout is empty — agy (a Go CLI) prints its usage to stderr
+ * (#1825: 1.3.4 and 1.3.5 write nothing to stdout, so reading stdout alone saw no `--effort` at all). Throws when the
+ * CLI cannot run or exits non-zero.
+ */
+export function readHelpText(binary, args = ["--help"]) {
+    const run = spawnSync(binary, args, { encoding: "utf-8", timeout: 5000, stdio: ["ignore", "pipe", "pipe"] });
+    if (run.error)
+        throw run.error;
+    if (run.status !== 0)
+        throw new Error(`${binary} ${args.join(" ")} exited ${run.status ?? run.signal}`);
+    return run.stdout || run.stderr;
+}
+const defaultRun = (binary, args) => readHelpText(binary, args);
+/** `--help` per binary FILE: the path and what is there (size, mtime) — an update gives a new answer. */
+const helpCache = new Map();
+/** The binary's `--help`, read once per binary file; null when it cannot be read (then no flag is passed). */
+export function cliHelp(binaryPath, run = defaultRun) {
+    let key;
+    try {
+        const st = statSync(binaryPath);
+        key = `${binaryPath}\u0000${st.size}\u0000${st.mtimeMs}`;
+    }
+    catch {
+        return null;
+    } // not a file we can identify: never guess
+    if (helpCache.has(key))
+        return helpCache.get(key);
+    let help = null;
+    try {
+        help = measureSyncWork("backend.effortHelp", () => run(binaryPath, ["--help"]));
+    }
+    catch {
+        help = null;
+    }
+    helpCache.set(key, help);
+    return help;
+}
+/** For tests: forget what was read. */
+export function resetCliHelpCache() { helpCache.clear(); }
+/**
+ * Whether the help lists `flag` as an option, and the values it gives for it: the first `(a, b, c)` or `(a|b|c)`
+ * list in the option's own entry (its row and the description lines under it), in canonical order. `levels: null`
+ * when the entry names none.
+ */
+export function helpOption(help, flag) {
+    const lines = help.split("\n");
+    const at = lines.findIndex(line => new RegExp(`^\\s*(?:-\\w,\\s*)?${flag.replace(/[-]/g, "\\-")}(?=[\\s,=<]|$)`).test(line));
+    if (at < 0)
+        return { listed: false, levels: null };
+    const entry = [lines[at]];
+    for (let i = at + 1; i < lines.length; i++) {
+        const line = lines[i];
+        if (/^\s*-{1,2}\w/.test(line))
+            break; // the next option
+        entry.push(line);
+    }
+    const list = /\(([a-z]+(?:\s*[,|]\s*[a-z]+)+)\)/.exec(entry.join(" "));
+    if (!list)
+        return { listed: true, levels: null };
+    const offered = new Set(list[1].split(/\s*[,|]\s*/));
+    return { listed: true, levels: CANONICAL_EFFORT.filter(level => offered.has(level)) };
+}
+/** The effort, if it is one of AgEnD's levels at all (normalized), else null. */
+function canonical(effort) {
+    const level = effort.trim().toLowerCase();
+    return CANONICAL_EFFORT.includes(level) ? level : null;
+}
+const skip = (backend, effort, why) => ({ arg: null, note: t("effort.launch_skipped", effort, backend, why) });
+/**
+ * claude-code (`--effort`), grok (`--reasoning-effort`) and antigravity (`--effort`): the flag when this binary's help
+ * lists it and the level is one it takes.
+ */
+export function flagEffort(backend, effort, binaryPath, run) {
+    if (!effort)
+        return { arg: null, note: null };
+    const level = canonical(effort);
+    if (!level)
+        return skip(backend, effort, t("effort.launch_not_a_level", CANONICAL_EFFORT.join(", ")));
+    const flag = backend === "grok" ? "--reasoning-effort" : "--effort";
+    const help = cliHelp(binaryPath, run);
+    if (help === null)
+        return skip(backend, level, t("effort.launch_no_help"));
+    const option = helpOption(help, flag);
+    if (!option.listed)
+        return skip(backend, level, t("effort.launch_no_flag", flag));
+    // grok's help lists no values (and it takes any string): only the levels AgEnD knows it has.
+    const levels = option.levels ?? (backend === "grok" ? [...EFFORT_CAPABILITIES.grok.levels] : null);
+    if (!levels)
+        return skip(backend, level, t("effort.launch_no_levels", flag));
+    if (!levels.includes(level))
+        return skip(backend, level, t("effort.launch_level_not_offered", levels.join(", ")));
+    return { arg: ` ${flag} ${level}`, note: null, level };
+}
+/**
+ * #1825: agy's catalog has one model per effort level (`gemini-3.8-flash-medium`, `…-high`, …), and agy 1.3.4/1.3.5
+ * resolve `--model` and `--effort` together: a variant with another level ("conflicts with --effort=high"), a label
+ * with any `--effort`, a level the model does not have, or a model it does not list each make agy run ANOTHER model,
+ * with only a warning row in the pane (verified offline against the real binaries). So the effort picks the exact
+ * variant — `gemini-3.8-flash-medium` + high launches `--model gemini-3.8-flash-high`, no `--effort` — and anything
+ * else launches the configured model without `--effort`. `--model` alone (a variant's slug or its label) and a bare
+ * `--effort` on agy's own model are what agy resolves exactly. fleet.yaml is never rewritten; the note says what ran.
+ *
+ * `catalog`/`current`: the CLI env probe's cached `agy models` and settings model (null: none cached).
+ */
+export function resolveAgyLaunch(model, level, catalog, current = null) {
+    if (!level)
+        return { model, effort: null, note: null };
+    const skipped = (why) => ({ model, effort: null, note: t("effort.launch_skipped", level, "antigravity", why) });
+    const listed = (name) => !!catalog?.some(m => m.id === name || m.label === name);
+    if (!model) {
+        // A bare --effort applies to agy's own model; one it knows to lack the level would make agy run another.
+        const family = current && catalog ? agyModelFamily(current, catalog) : null;
+        if (family && !family.variants.has(level)) {
+            return skipped(t("effort.launch_level_not_offered", [...family.variants.keys()].join(", ")));
+        }
+        if (!family && current && listed(current))
+            return skipped(t("effort.launch_agy_model_no_levels", current));
+        return { model, effort: level, note: null };
+    }
+    if (!catalog?.length)
+        return skipped(t("effort.launch_agy_no_catalog", model));
+    const family = agyModelFamily(model, catalog);
+    if (!family)
+        return skipped(t(listed(model) ? "effort.launch_agy_model_no_levels" : "effort.launch_agy_model_not_listed", model));
+    const variant = family.variants.get(level);
+    if (!variant)
+        return skipped(t("effort.launch_level_not_offered", [...family.variants.keys()].join(", ")));
+    return { model: variant, effort: null, note: variant === model ? null : t("effort.launch_agy_variant", level, variant, model) };
+}
+/**
+ * codex: `-c model_reasoning_effort="<level>"` when the model's own catalog entry lists the level. `-c` is in every
+ * codex AgEnD runs; what it does not check is the value, so the catalog is the gate.
+ */
+export function codexEffort(effort, catalog) {
+    if (!effort)
+        return { arg: null, note: null };
+    const level = canonical(effort);
+    if (!level)
+        return skip("codex", effort, t("effort.launch_not_a_level", CANONICAL_EFFORT.join(", ")));
+    if (catalog.unproven)
+        return skip("codex", level, t("effort.launch_codex_model_unproven"));
+    if (!catalog.levels)
+        return skip("codex", level, t("effort.launch_codex_unknown_model", catalog.model ?? "—"));
+    if (!catalog.levels.includes(level))
+        return skip("codex", level, t("effort.launch_level_not_offered", catalog.levels.join(", ")));
+    return { arg: ` -c ${shellQuote(`model_reasoning_effort="${level}"`)}`, note: null };
+}
+//# sourceMappingURL=launch-effort.js.map

package/dist/backend/launch-effort.js.map

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

package/dist/backend/muse.d.ts

@@ -15,6 +15,15 @@ export declare function museSessionCwd(head: string): string | null;
  * readers — never on the fleet event loop.
  */
 export declare function readFileHeadSync(filePath: string, maxChars: number): string | null;
+/**
+ * #1717: true when the pane shows muse's terminals panel with at least one
+ * running task — the "local work still active" state. Anchored to the last
+ * separator, where the live panel sits under the input box: a transcript
+ * quoting an old panel above a separator never counts. The idle proof checks
+ * the same shape positionally via museStatusFooter; this boolean feeds the
+ * pause gate below.
+ */
+export declare function museBackgroundWorkActive(pane: string): boolean;
 /**
  * The rows of muse's live input box, or null when the bottom of the pane is not
  * muse's layout (#829). The box is the LAST thing above the status bar:
@@ -50,6 +59,72 @@ export declare function museDraftShows(rows: readonly string[], width: number, t
  * glyph allowed in front of a choice.
  */
 export declare function museLoginScreenActive(pane: string): boolean;
+/**
+ * #1716: `/quit` while a background task runs is answered with a confirmation
+ * instead of an exit (live 1.4.6,
+ * tests/fixtures/muse-1.4.6/prod-quit-with-local-work.pane.txt):
+ *   ❯
+ *     Local work is still active
+ *     The following will stop when you exit:
+ *     background task · tool.bash
+ *     ❯ 1. Exit anyway
+ *       2. Stay
+ *     Enter to confirm · Esc to cancel
+ *   ──────────
+ *   main · ↓ to select
+ *   └ ◇ Wait in the background  running   15s
+ *     mock-model · high · ~/work · Launch overrides
+ * Unlike Claude's prompt this menu is NOT bottom-anchored — the terminals
+ * panel sits under it — so the match is anchored to the hint row instead:
+ * the header must be within 12 rows above it with both options in between.
+ * Enter would take the selected option ("Exit anyway"), so like #1217 this is
+ * recognised whole and never answered here: the stop flow cancels it.
+ */
+/**
+ * #1715: with `skip_permissions: false` muse asks before running a command
+ * needing approval (live 1.4.6,
+ * tests/fixtures/muse-1.4.6/approval-escalated.pane.txt and
+ * approval-untrusted-staged.pane.txt):
+ *   Would you like to run the following command?
+ *     $ echo perm-check
+ *   › 1. Yes, proceed (y)
+ *     2. No, and tell Muse Code what to do differently (esc)
+ *   Change approval defaults in /permissions
+ * `--approval-mode untrusted` (new in 1.4.6) stages the command first
+ * (`Stage 1/1`, `Current argv: [...]`) and offers three options (allow once /
+ * always allow in this workspace / abort). 1.4.4 shows the same prompt with a
+ * `›` marker and no footer line. Enter would take the preselected allow
+ * option, so like #1716 this is recognised whole and never answered here.
+ * 1.4.7 draws the selection cursor as `⟩` on this prompt and on the #1716
+ * quit menu (tests/fixtures/muse-1.4.7); the other rows of those blocks are
+ * unchanged.
+ */
+export declare const MUSE_APPROVAL_PROMPT: RegExp;
+/**
+ * #1715: which request the approval prompt is showing — its `$ command` row.
+ * Stable across the `Calling tools (Ns)` timer redraws, so the episode can
+ * confirm; a whole-pane hash never would. Derived from the SAME selected
+ * block as the predicate (#1715 r2): a scrollback quote's command must never
+ * become the current request's identity.
+ */
+export declare function museApprovalRequestIdentity(pane: string): string | null;
+export declare function museApprovalPromptActive(pane: string): boolean;
+export declare const MUSE_LOCAL_WORK_QUIT: RegExp;
+export declare function museLocalWorkQuitActive(pane: string): boolean;
+/**
+ * #1796: read the provider catalog muse caches on disk
+ * (`<state>/model-catalog/<provider>__<profile>.json`). Bounded (at most 16
+ * files, 256 KiB each) and best-effort — anything unexpected yields the
+ * fallback. Listed rows only: `visibility: "visible"` is what the 1.4.7
+ * picker shows (the `-contributor` siblings and the image model are hidden),
+ * and a null `context_limit` additionally marks a non-chat model. File order
+ * is kept and ids deduped.
+ *
+ * `stateDir` is injectable for tests; production passes nothing and reads the
+ * host state dir (the fleet never isolates XDG_DATA_HOME, mirroring the
+ * session lookup).
+ */
+export declare function readMuseModelCatalog(stateDir?: string): ModelOption[];
 /**
  * Meta Muse Code — the `muse` CLI (v1.3.0 verified).
  *
@@ -169,6 +244,15 @@ export declare class MuseBackend implements CliBackend {
     getQuitCommand(): string | null;
     getQuitKey(): string;
     getQuitKeyPresses(): number;
+    /** #1716: `/quit` with a background task running stops at the "Local work is still active" menu. */
+    quitBlockedByDialog(pane: string): boolean;
+    /**
+     * #1717: the terminals panel with a `running` task — the pause flow defers
+     * an idle pause while this holds, so an AgEnD-initiated silent pause never
+     * kills the user's running background work. Explicit stop/restart still
+     * proceed via quitBlockedByDialog above.
+     */
+    backgroundWorkRunning(pane: string): boolean;
     getCompactCommand(): string;
     getClearCommand(): string | null;
     /**