@zhihaohong52/sonata 0.4.0

package/dist/tui-ink/run.js

@@ -0,0 +1,38 @@
+import React from 'react';
+import { render } from 'ink';
+import { InitWizard } from './app.js';
+/**
+ * Runs the Ink wizard and returns only once Ink has released stdin.
+ *
+ * The wait is the whole point. `unmount()` starts a teardown that finishes
+ * asynchronously — Ink restores raw mode, detaches its own reader and pauses
+ * the stream after it returns. Resolving straight after calling it therefore
+ * handed control back to `cmdInit` mid-teardown: the next prompt (`Install the
+ * permission hook`) attached its iterator to stdin, Ink's cleanup then ran and
+ * pulled the stream out from under it, and the prompt ended without ever
+ * receiving a keystroke. The run exited with the prompt still on screen and
+ * nothing written — which is what "sonata init never saves the config" was.
+ *
+ * `waitUntilExit()` resolves after that cleanup, so stdin is quiet and
+ * unclaimed by the time the next prompt asks for it.
+ */
+export async function runInitTui(data, log = () => { }) {
+    let outcome;
+    const instance = render(React.createElement(InitWizard, {
+        data,
+        onDone: (result) => {
+            outcome ??= result;
+            instance.unmount();
+        },
+    }));
+    await instance.waitUntilExit();
+    if (outcome === undefined) {
+        // Ink ended without the wizard reporting anything — Ctrl-C, a signal, or a
+        // closed stream. Indistinguishable from a deliberate cancel in the result,
+        // and very distinguishable in a bug report, so say which one happened.
+        log('wizard: ink exited without a result (interrupt, signal or closed stdin)');
+        return { cancelled: true, state: data.initialState ?? {} };
+    }
+    return outcome;
+}
+//# sourceMappingURL=run.js.map

package/dist/tui-ink/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/tui-ink/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAmB,MAAM,UAAU,CAAC;AAGvD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAAgB,EAChB,MAA8B,GAAG,EAAE,GAAE,CAAC;IAEtC,IAAI,OAA8B,CAAC;IAEnC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,UAAU,EAAE;QACtD,IAAI;QACJ,MAAM,EAAE,CAAC,MAAiB,EAAE,EAAE;YAC5B,OAAO,KAAK,MAAM,CAAC;YACnB,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrB,CAAC;KACF,CAAC,CAAC,CAAC;IAEJ,MAAM,QAAQ,CAAC,aAAa,EAAE,CAAC;IAE/B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,2EAA2E;QAC3E,2EAA2E;QAC3E,uEAAuE;QACvE,GAAG,CAAC,yEAAyE,CAAC,CAAC;QAC/E,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,YAAY,IAAI,EAAE,EAAE,CAAC;IAC7D,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/tui-ink/test-compile.js

@@ -0,0 +1,4 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Text } from 'ink';
+export const Hello = () => _jsx(Text, { children: "hello" });
+//# sourceMappingURL=test-compile.js.map

package/dist/tui-ink/test-compile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-compile.js","sourceRoot":"","sources":["../../src/tui-ink/test-compile.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAE3B,MAAM,CAAC,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,KAAC,IAAI,wBAAa,CAAC"}

package/dist/tui-ink/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tui-ink/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tui-ink/types.ts"],"names":[],"mappings":""}

package/dist/tui.js

@@ -0,0 +1,330 @@
+/**
+ * Minimal zero-dependency TUI primitives.
+ *
+ * The interactive glue is deliberately thin: all list behaviour lives in the
+ * pure `parseKey` / `reduce` / `renderList` functions so it can be tested
+ * without a TTY. Only `runList` and `confirm` touch stdin.
+ */
+/**
+ * `filterable` decides what a letter means. In a filterable list it is text;
+ * in a plain list it is vim navigation. The lists that filter are the long
+ * ones, where typing is the only practical way to reach an entry.
+ */
+export function parseKey(seq, filterable) {
+    switch (seq) {
+        case '\u001b[A': return { kind: 'up' };
+        case '\u001b[B': return { kind: 'down' };
+        // Left steps back a screen. Free to claim even in a filterable list: the
+        // filter is append-only, with no cursor to move within it.
+        case '\u001b[D': return { kind: 'back' };
+        // Space toggles even while filtering: no provider or model ref contains
+        // one, so the filter never needs a space.
+        case ' ': return { kind: 'space' };
+        case '\r':
+        case '\n': return { kind: 'enter' };
+        case '\u0001': return { kind: 'toggleAll' };
+        case '\u0003':
+        case '\u001b': return { kind: 'cancel' };
+        case '\u007f':
+        case '\b': return { kind: 'backspace' };
+        default: break;
+    }
+    if (!filterable) {
+        if (seq === 'k')
+            return { kind: 'up' };
+        if (seq === 'j')
+            return { kind: 'down' };
+        return { kind: 'ignore' };
+    }
+    // eslint-disable-next-line no-control-regex
+    if (seq.length > 0 && !/[\u0000-\u001f\u007f]/.test(seq)) {
+        return { kind: 'char', value: seq };
+    }
+    return { kind: 'ignore' };
+}
+export function visibleIndices(choices, filter) {
+    const q = filter.trim().toLowerCase();
+    const out = [];
+    choices.forEach((c, i) => {
+        if (q.length === 0 || c.label.toLowerCase().includes(q))
+            out.push(i);
+    });
+    return out;
+}
+export function initialState(choices) {
+    const checked = new Set();
+    choices.forEach((c, i) => {
+        if (c.checked)
+            checked.add(i);
+    });
+    const firstEnabled = choices.findIndex((c) => !c.disabled);
+    return {
+        cursor: firstEnabled === -1 ? 0 : firstEnabled,
+        checked,
+        filter: '',
+        done: false,
+        cancelled: false,
+    };
+}
+/** Moves within the filtered view, skipping disabled entries. Wraps. */
+function move(choices, view, from, delta) {
+    const n = view.length;
+    if (n === 0)
+        return 0;
+    let i = from;
+    for (let step = 0; step < n; step++) {
+        i = (i + delta + n) % n;
+        if (!choices[view[i]].disabled)
+            return i;
+    }
+    return from;
+}
+function withFilter(state, choices, filter) {
+    const view = visibleIndices(choices, filter);
+    return { ...state, filter, cursor: view.length === 0 ? 0 : Math.min(state.cursor, view.length - 1) };
+}
+export function reduce(state, key, choices, multi) {
+    const view = visibleIndices(choices, state.filter);
+    const under = view[state.cursor];
+    switch (key.kind) {
+        case 'up':
+            return { ...state, cursor: move(choices, view, state.cursor, -1) };
+        case 'down':
+            return { ...state, cursor: move(choices, view, state.cursor, +1) };
+        case 'space': {
+            if (!multi || under === undefined || choices[under].disabled)
+                return state;
+            const checked = new Set(state.checked);
+            if (checked.has(under))
+                checked.delete(under);
+            else
+                checked.add(under);
+            return { ...state, checked };
+        }
+        case 'enter': {
+            if (multi)
+                return { ...state, done: true };
+            if (under === undefined || choices[under].disabled)
+                return state;
+            return { ...state, checked: new Set([under]), done: true };
+        }
+        case 'char':
+            return multi ? withFilter(state, choices, state.filter + key.value) : state;
+        case 'backspace':
+            return multi ? withFilter(state, choices, state.filter.slice(0, -1)) : state;
+        case 'toggleAll': {
+            if (!multi)
+                return state;
+            const enabled = view.filter((i) => !choices[i].disabled);
+            const allChecked = enabled.every((i) => state.checked.has(i));
+            const checked = new Set(state.checked);
+            for (const i of enabled) {
+                if (allChecked)
+                    checked.delete(i);
+                else
+                    checked.add(i);
+            }
+            return { ...state, checked };
+        }
+        case 'cancel':
+            return { ...state, cancelled: true, done: true };
+        case 'back':
+            return { ...state, back: true, done: true };
+        default:
+            return state;
+    }
+}
+/**
+ * The slice of a list to draw, centred on the cursor.
+ *
+ * Drawing every choice is not an option: the redraw moves the terminal cursor
+ * up by the block height, so a block taller than the screen corrupts it, and
+ * one provider alone offers 341 models.
+ */
+export function viewport(cursor, total, height) {
+    if (total === 0)
+        return { start: 0, end: 0, above: 0, below: 0 };
+    const h = Math.min(Math.max(3, height), total);
+    let start = cursor - Math.floor(h / 2);
+    if (start < 0)
+        start = 0;
+    if (start + h > total)
+        start = total - h;
+    const end = start + h;
+    return { start, end, above: start, below: total - end };
+}
+/** Rows available for choices, after the title, filter, counts and hint. */
+export function listHeight(rows = process.stdout.rows ?? 24) {
+    return Math.max(3, Math.min(15, rows - 8));
+}
+export function renderList(title, choices, state, multi, height = 15, back = false) {
+    const view = visibleIndices(choices, state.filter);
+    const win = viewport(state.cursor, view.length, height);
+    const lines = [`  ${title}`, ''];
+    if (multi)
+        lines.push(`  filter: ${state.filter}█`, '');
+    if (win.above > 0)
+        lines.push(`    ↑ ${win.above} more`);
+    for (let i = win.start; i < win.end; i++) {
+        const orig = view[i];
+        const choice = choices[orig];
+        const pointer = i === state.cursor ? '❯' : ' ';
+        const mark = multi ? (state.checked.has(orig) ? '◉' : '○') : '';
+        const hint = choice.hint ? `  · ${choice.hint}` : '';
+        const label = choice.disabled ? `${choice.label} (unavailable)` : choice.label;
+        lines.push(`  ${pointer} ${mark} ${label}${hint}`.replace(/\s+$/, ''));
+    }
+    if (win.below > 0)
+        lines.push(`    ↓ ${win.below} more`);
+    lines.push('');
+    lines.push(multi
+        ? `  ${view.length} of ${choices.length} · space toggle · type to filter · enter confirm${back ? ' · ← back' : ''} · esc cancel`
+        : `  ↑↓ move · enter select${back ? ' · ← back' : ''} · esc cancel`);
+    return lines.join('\n');
+}
+/**
+ * Builds one redraw of a block, and reports the height to pass back next time.
+ *
+ * Uses clear-screen rather than per-line cursor-up: some terminal
+ * environments (cmux panels, certain multiplexer panes) do not process
+ * CSI cursor-movement sequences, which causes cursor-up redraws to
+ * append the block rather than overwrite it. Clear-screen is universally
+ * handled.
+ */
+export function redraw(body, lastHeight) {
+    const lines = body.split('\n');
+    const clear = '\u001b[2J\u001b[H';
+    return {
+        out: `${clear}${lines.join('\n')}\n`,
+        height: lines.length,
+    };
+}
+/**
+ * The wordmark, for commands a person reads rather than pipes.
+ *
+ * Deliberately plain text: no colour, so it survives a pale terminal, a dark
+ * one, and a pipe into a file equally. Widest row is 54 columns, which leaves
+ * room on an 80-column terminal.
+ */
+export function banner() {
+    return [
+        '  ███████╗ ██████╗ ███╗   ██╗ █████╗ ████████╗ █████╗',
+        '  ██╔════╝██╔═══██╗████╗  ██║██╔══██╗╚══██╔══╝██╔══██╗',
+        '  ███████╗██║   ██║██╔██╗ ██║███████║   ██║   ███████║',
+        '  ╚════██║██║   ██║██║╚██╗██║██╔══██║   ██║   ██╔══██║',
+        '  ███████║╚██████╔╝██║ ╚████║██║  ██║   ██║   ██║  ██║',
+        '  ╚══════╝ ╚═════╝ ╚═╝  ╚═══╝╚═╝  ╚═╝   ╚═╝   ╚═╝  ╚═╝',
+        '',
+        '  foreign-model subagents for Claude Code',
+    ].join('\n');
+}
+export function isInteractive() {
+    return Boolean(process.stdin.isTTY && process.stdout.isTTY);
+}
+export class CancelledError extends Error {
+    constructor() {
+        super('cancelled');
+        this.name = 'CancelledError';
+    }
+}
+/**
+ * Left was pressed on a screen that offers a previous step.
+ *
+ * A thrown sentinel rather than a return value, so every prompt keeps its
+ * ordinary return type and only the wizard that knows the step order has to
+ * handle going back.
+ */
+export class BackError extends Error {
+    constructor() {
+        super('back');
+        this.name = 'BackError';
+    }
+}
+/**
+ * Puts stdin in raw mode, feeds every keystroke to `step`, and restores it.
+ *
+ * Owning the whole lifecycle here is deliberate: stdin is shared by every
+ * prompt in a run, and two details have to be right or the *next* prompt
+ * breaks rather than this one.
+ *
+ *   - `destroyOnReturn: false` — the default async iterator destroys the
+ *     stream when the loop ends, so a later prompt would reject with "The
+ *     operation was aborted".
+ *   - no `resume()` — that switches stdin to flowing mode, where chunks are
+ *     dropped in the gap before the next prompt's iterator attaches. The
+ *     iterator pulls on its own; it needs no help.
+ *   - `ref()` — a paused stdin's handle is *unreferenced*, so it does not keep
+ *     the event loop alive. Waiting on a keystroke is then not work Node knows
+ *     about: with nothing else pending it exits, code 0, mid-prompt. Nothing
+ *     paused stdin before the Ink wizard existed; Ink pauses it on unmount, so
+ *     every prompt after the wizard died the moment it was drawn — the prompt
+ *     on screen, the shell back, and no config written. That was
+ *     "sonata init never saves".
+ */
+export async function readKeys(stdin, step) {
+    stdin.setRawMode?.(true);
+    stdin.setEncoding('utf8');
+    stdin.ref?.();
+    try {
+        for await (const chunk of stdin.iterator({ destroyOnReturn: false })) {
+            if (step(String(chunk)))
+                return;
+        }
+    }
+    finally {
+        stdin.setRawMode?.(false);
+        stdin.pause();
+        // Released again, or the process would hang after the last prompt instead
+        // of exiting — the same refcount, in the opposite direction.
+        stdin.unref?.();
+    }
+}
+async function runList(title, choices, multi, back = false) {
+    if (!isInteractive()) {
+        throw new Error('sonata: this command needs an interactive terminal. ' +
+            'Use the non-interactive flags instead (see `sonata init --help`).');
+    }
+    if (choices.length === 0)
+        return [];
+    let state = initialState(choices);
+    const stdin = process.stdin;
+    const stdout = process.stdout;
+    const height = listHeight();
+    stdout.write('\u001b[?1049h');
+    let lastHeight = 0;
+    const draw = () => {
+        const { out, height: drawn } = redraw(renderList(title, choices, state, multi, height, back), lastHeight);
+        stdout.write(out);
+        lastHeight = drawn;
+    };
+    try {
+        draw();
+        await readKeys(stdin, (chunk) => {
+            state = reduce(state, parseKey(chunk, multi), choices, multi);
+            if (state.done)
+                return true;
+            draw();
+            return false;
+        });
+    }
+    finally {
+        stdout.write('\u001b[?1049l');
+    }
+    if (state.cancelled)
+        throw new CancelledError();
+    // Only honoured where the caller said a previous step exists; otherwise Left
+    // is inert rather than an error the wizard would have to swallow.
+    if (state.back && back)
+        throw new BackError();
+    return [...state.checked].sort((a, b) => a - b).map((i) => choices[i].value);
+}
+export async function select(title, choices, back = false) {
+    const picked = await runList(title, choices, false, back);
+    return picked[0];
+}
+export async function confirm(question, defaultYes, back = false) {
+    const yes = { value: true, label: 'Yes', checked: defaultYes };
+    const no = { value: false, label: 'No', checked: !defaultYes };
+    return select(question, defaultYes ? [yes, no] : [no, yes], back);
+}
+//# sourceMappingURL=tui.js.map

package/dist/tui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui.js","sourceRoot":"","sources":["../src/tui.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgBH;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,UAAmB;IACvD,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,UAAU,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACvC,KAAK,UAAU,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACzC,yEAAyE;QACzE,2DAA2D;QAC3D,KAAK,UAAU,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACzC,wEAAwE;QACxE,0CAA0C;QAC1C,KAAK,GAAG,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QACnC,KAAK,IAAI,CAAC;QAAC,KAAK,IAAI,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAC/C,KAAK,QAAQ,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;QAC5C,KAAK,QAAQ,CAAC;QAAC,KAAK,QAAQ,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACxD,KAAK,QAAQ,CAAC;QAAC,KAAK,IAAI,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;QACvD,OAAO,CAAC,CAAC,MAAM;IACjB,CAAC;IACD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,IAAI,GAAG,KAAK,GAAG;YAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACvC,IAAI,GAAG,KAAK,GAAG;YAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACzC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC5B,CAAC;IACD,4CAA4C;IAC5C,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACzD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IACtC,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAcD,MAAM,UAAU,cAAc,CAAI,OAAoB,EAAE,MAAc;IACpE,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACtC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACvB,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,YAAY,CAAI,OAAoB;IAClD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACvB,IAAI,CAAC,CAAC,OAAO;YAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC3D,OAAO;QACL,MAAM,EAAE,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY;QAC9C,OAAO;QACP,MAAM,EAAE,EAAE;QACV,IAAI,EAAE,KAAK;QACX,SAAS,EAAE,KAAK;KACjB,CAAC;AACJ,CAAC;AAED,wEAAwE;AACxE,SAAS,IAAI,CAAI,OAAoB,EAAE,IAAc,EAAE,IAAY,EAAE,KAAa;IAChF,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;IACtB,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtB,IAAI,CAAC,GAAG,IAAI,CAAC;IACb,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC;QACpC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QACxB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ;YAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,UAAU,CAAI,KAAgB,EAAE,OAAoB,EAAE,MAAc;IAC3E,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7C,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;AACvG,CAAC;AAED,MAAM,UAAU,MAAM,CACpB,KAAgB,EAChB,GAAY,EACZ,OAAoB,EACpB,KAAc;IAEd,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAEjC,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,IAAI;YACP,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,KAAK,MAAM;YACT,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,IAAI,CAAC,KAAK,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ;gBAAE,OAAO,KAAK,CAAC;YAC3E,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACvC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;;gBACzC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACxB,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,CAAC;QAC/B,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,IAAI,KAAK;gBAAE,OAAO,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YAC3C,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ;gBAAE,OAAO,KAAK,CAAC;YACjE,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC7D,CAAC;QACD,KAAK,MAAM;YACT,OAAO,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAC9E,KAAK,WAAW;YACd,OAAO,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAC/E,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,IAAI,CAAC,KAAK;gBAAE,OAAO,KAAK,CAAC;YACzB,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YACzD,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9D,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACvC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,IAAI,UAAU;oBAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;;oBAAM,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACzD,CAAC;YACD,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,CAAC;QAC/B,CAAC;QACD,KAAK,QAAQ;YACX,OAAO,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACnD,KAAK,MAAM;YACT,OAAO,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC9C;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AASD;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,KAAa,EAAE,MAAc;IACpE,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACjE,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC;IAC/C,IAAI,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACvC,IAAI,KAAK,GAAG,CAAC;QAAE,KAAK,GAAG,CAAC,CAAC;IACzB,IAAI,KAAK,GAAG,CAAC,GAAG,KAAK;QAAE,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,KAAK,GAAG,CAAC,CAAC;IACtB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,GAAG,EAAE,CAAC;AAC1D,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,UAAU,CAAC,OAAe,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE;IACjE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,KAAa,EACb,OAAoB,EACpB,KAAgB,EAChB,KAAc,EACd,MAAM,GAAG,EAAE,EACX,IAAI,GAAG,KAAK;IAEZ,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxD,MAAM,KAAK,GAAa,CAAC,KAAK,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IAC3C,IAAI,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC,CAAC;IAExD,IAAI,GAAG,CAAC,KAAK,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,KAAK,OAAO,CAAC,CAAC;IACzD,KAAK,IAAI,CAAC,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,OAAO,GAAG,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAC/C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QAC/E,KAAK,CAAC,IAAI,CAAC,KAAK,OAAO,IAAI,IAAI,IAAI,KAAK,GAAG,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,GAAG,CAAC,KAAK,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,KAAK,OAAO,CAAC,CAAC;IAEzD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,KAAK;QACd,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,OAAO,OAAO,CAAC,MAAM,mDAAmD,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,eAAe;QAChI,CAAC,CAAC,2BAA2B,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;IACvE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,UAAkB;IACrD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,mBAAmB,CAAC;IAClC,OAAO;QACL,GAAG,EAAE,GAAG,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;QACpC,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,MAAM;IACpB,OAAO;QACP,uDAAuD;QACvD,wDAAwD;QACxD,wDAAwD;QACxD,wDAAwD;QACxD,wDAAwD;QACxD,wDAAwD;QACtD,EAAE;QACF,2CAA2C;KAC5C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC;QACE,KAAK,CAAC,WAAW,CAAC,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC;QACE,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAUD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,KAAgB,EAChB,IAAgC;IAEhC,KAAK,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC;IACzB,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1B,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC;IACd,IAAI,CAAC;QACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,KAAK,CAAC,QAAQ,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;YACrE,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAAE,OAAO;QAClC,CAAC;IACH,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC;QAC1B,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,0EAA0E;QAC1E,6DAA6D;QAC7D,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;IAClB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,OAAO,CACpB,KAAa,EACb,OAAoB,EACpB,KAAc,EACd,IAAI,GAAG,KAAK;IAEZ,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,sDAAsD;YACtD,mEAAmE,CACpE,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,IAAI,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAE5B,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAE9B,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,MAAM,IAAI,GAAG,GAAS,EAAE;QACtB,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAC1B,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC;QAC7E,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAClB,UAAU,GAAG,KAAK,CAAC;IACrB,CAAC,CAAC;IAEF,IAAI,CAAC;QACH,IAAI,EAAE,CAAC;QACP,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE;YAC9B,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;YAC9D,IAAI,KAAK,CAAC,IAAI;gBAAE,OAAO,IAAI,CAAC;YAC5B,IAAI,EAAE,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,KAAK,CAAC,SAAS;QAAE,MAAM,IAAI,cAAc,EAAE,CAAC;IAChD,6EAA6E;IAC7E,kEAAkE;IAClE,IAAI,KAAK,CAAC,IAAI,IAAI,IAAI;QAAE,MAAM,IAAI,SAAS,EAAE,CAAC;IAC9C,OAAO,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAI,KAAa,EAAE,OAAoB,EAAE,IAAI,GAAG,KAAK;IAC/E,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAC1D,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,QAAgB,EAAE,UAAmB,EAAE,IAAI,GAAG,KAAK;IAEnD,MAAM,GAAG,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IAC/D,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,UAAU,EAAE,CAAC;IAC/D,OAAO,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;AACpE,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/watchdog.js

@@ -0,0 +1,85 @@
+import { join } from 'node:path';
+/**
+ * Wraps a harness script with a watchdog that kills it if it overruns.
+ * Enforcement lives in the launched shell, not in `sonata tail`, so a run
+ * with nobody watching is still bounded.
+ */
+export function wrapWithTimeout(input) {
+    const harnessLog = join(input.runDir, 'harness.log');
+    const timeoutMark = join(input.runDir, 'timeout');
+    const exitPath = join(input.runDir, 'exit');
+    return [
+        '#!/bin/bash',
+        '# Job control gives the background harness its own process group, so the',
+        '# watchdog can kill the whole tree. A harness is typically a shell running',
+        '# a Node CLI that spawns further children; killing only direct children',
+        '# leaves those grandchildren running.',
+        'set -m',
+        `bash '${input.harnessScriptPath}' &`,
+        'HARNESS_PID=$!',
+        '',
+        '(',
+        `  sleep ${input.timeoutSeconds}`,
+        '  if kill -0 $HARNESS_PID 2>/dev/null; then',
+        `    echo 'sonata: run timeout after ${input.timeoutSeconds}s' >> '${harnessLog}'`,
+        `    echo timeout > '${timeoutMark}'`,
+        '    pkill -P $HARNESS_PID 2>/dev/null',
+        '    kill -TERM -$HARNESS_PID 2>/dev/null || kill -TERM $HARNESS_PID 2>/dev/null',
+        '    sleep 5',
+        '    kill -KILL -$HARNESS_PID 2>/dev/null || kill -KILL $HARNESS_PID 2>/dev/null',
+        '  fi',
+        ') &',
+        'WATCHDOG_PID=$!',
+        '# Job control reports a killed background job to the terminal. On a normal',
+        '# run the watchdog is always killed, so without this every completed run',
+        '# ended with a "Terminated: 15" line in the pane — which then became the',
+        '# tail of any degraded report. Disowning it silences the report only; the',
+        '# watchdog still runs, and still kills the tree if it fires.',
+        'disown $WATCHDOG_PID 2>/dev/null',
+        '',
+        '# `set -m` above put the harness in its own process group, which means it is',
+        '# NOT the terminal\'s foreground group. Any harness that reads the terminal —',
+        '# every interactive TUI, which is how sonata honours `default` mode — then',
+        '# takes SIGTTIN and stops dead. Reproduced with a one-line harness that reads',
+        '# a single key: the pane freezes and the process sits in state T forever,',
+        '# until the run timeout kills something that never started.',
+        '#',
+        '# `fg` hands the terminal to that process group and waits for it exactly as',
+        '# `wait` did, returning the same status.',
+        '#',
+        '# Its output is deliberately NOT redirected. `fg %1 >/dev/null 2>&1` runs and',
+        '# reports success, but the job stays stopped — the handover simply does not',
+        '# happen. Reproduced both ways against the same wrapper. The cost is one',
+        '# extra pane line, the job command that fg echoes.',
+        '#',
+        '# With no terminal there is nothing to hand over and no job control to do it',
+        '# with, so fall back to the plain wait.',
+        ...(input.interactive !== false
+            ? [
+                'if [ -t 0 ]; then',
+                '  fg %1',
+                '  STATUS=$?',
+                'else',
+                '  wait $HARNESS_PID',
+                '  STATUS=$?',
+                'fi',
+            ]
+            : [
+                '# Non-interactive harness: skip fg, use wait. fg interferes with',
+                '# output redirection in some harnesses (claude -p hangs under fg).',
+                'wait $HARNESS_PID',
+                'STATUS=$?',
+            ]),
+        '',
+        'kill $WATCHDOG_PID 2>/dev/null',
+        'pkill -P $WATCHDOG_PID 2>/dev/null',
+        'wait $WATCHDOG_PID 2>/dev/null',
+        '',
+        `if [ ! -f '${exitPath}' ]; then`,
+        `  echo $STATUS > '${exitPath}'`,
+        'fi',
+        '',
+        'exit $STATUS',
+    ].join('\n') + '\n';
+}
+//# sourceMappingURL=watchdog.js.map

package/dist/watchdog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watchdog.js","sourceRoot":"","sources":["../src/watchdog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAajC;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAoB;IAClD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACrD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE5C,OAAO;QACL,aAAa;QACb,0EAA0E;QAC1E,4EAA4E;QAC5E,yEAAyE;QACzE,uCAAuC;QACvC,QAAQ;QACR,SAAS,KAAK,CAAC,iBAAiB,KAAK;QACrC,gBAAgB;QAChB,EAAE;QACF,GAAG;QACH,WAAW,KAAK,CAAC,cAAc,EAAE;QACjC,6CAA6C;QAC7C,uCAAuC,KAAK,CAAC,cAAc,UAAU,UAAU,GAAG;QAClF,uBAAuB,WAAW,GAAG;QACrC,uCAAuC;QACvC,iFAAiF;QACjF,aAAa;QACb,iFAAiF;QACjF,MAAM;QACN,KAAK;QACL,iBAAiB;QACjB,4EAA4E;QAC5E,0EAA0E;QAC1E,0EAA0E;QAC1E,2EAA2E;QAC3E,8DAA8D;QAC9D,kCAAkC;QAClC,EAAE;QACF,8EAA8E;QAC9E,+EAA+E;QAC/E,4EAA4E;QAC5E,+EAA+E;QAC/E,2EAA2E;QAC3E,6DAA6D;QAC7D,GAAG;QACH,6EAA6E;QAC7E,0CAA0C;QAC1C,GAAG;QACH,+EAA+E;QAC/E,6EAA6E;QAC7E,0EAA0E;QAC1E,oDAAoD;QACpD,GAAG;QACH,8EAA8E;QAC9E,yCAAyC;QACzC,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,KAAK;YAC7B,CAAC,CAAC;gBACA,mBAAmB;gBACnB,SAAS;gBACT,aAAa;gBACb,MAAM;gBACN,qBAAqB;gBACrB,aAAa;gBACb,IAAI;aACL;YACD,CAAC,CAAC;gBACA,kEAAkE;gBAClE,oEAAoE;gBACpE,mBAAmB;gBACnB,WAAW;aACZ,CAAC;QACJ,EAAE;QACF,gCAAgC;QAChC,oCAAoC;QACpC,gCAAgC;QAChC,EAAE;QACF,cAAc,QAAQ,WAAW;QACjC,qBAAqB,QAAQ,GAAG;QAChC,IAAI;QACJ,EAAE;QACF,cAAc;KACf,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACtB,CAAC"}

package/hooks/capture-mode.mjs

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+// PreToolUse hook: records Claude Code's live permission mode so sonata can
+// mirror it onto a foreign harness. The mode is not available as an env var.
+import { mkdirSync, writeFileSync, existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+
+/**
+ * Where this session's mode belongs, or null when sonata is not in play.
+ *
+ * Mirrors how sonata resolves its config: a project that has its own setup
+ * keeps its mode beside it, and a project relying on the machine config keeps
+ * its mode beside *that*.
+ *
+ * The second case is why this is not simply "does the repo use sonata". With a
+ * machine config, every directory is potentially a sonata project — but the
+ * hook is installed globally and fires on every Bash call, so writing into the
+ * repo would scatter .sonata/ directories across the whole machine. Writing
+ * beside the machine config instead keeps one location for the sessions that
+ * have no project of their own.
+ */
+function modeDir(cwd, home) {
+  if (existsSync(join(cwd, 'sonata.toml')) || existsSync(join(cwd, '.sonata'))) {
+    return join(cwd, '.sonata');
+  }
+  const machine = join(home, '.config', 'sonata');
+  if (existsSync(join(machine, 'sonata.toml'))) return machine;
+  return null;
+}
+
+let input = '';
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', (c) => { input += c; });
+process.stdin.on('end', () => {
+  try {
+    const payload = JSON.parse(input || '{}');
+    const sessionId = payload.session_id ?? payload.sessionId;
+    const mode = payload.permission_mode ?? payload.permissionMode ?? 'default';
+    if (!sessionId) process.exit(0);
+
+    const cwd = process.env.SONATA_CWD ?? payload.cwd ?? process.cwd();
+    const home = process.env.SONATA_HOME ?? homedir();
+
+    const dir = modeDir(cwd, home);
+    if (dir === null) process.exit(0);
+
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(
+      join(dir, `session-${sessionId}.json`),
+      JSON.stringify({ permissionMode: mode, updatedAt: new Date().toISOString() }),
+    );
+  } catch {
+    // A hook must never break the session it observes.
+  }
+  process.exit(0);
+});