@zhihaohong52/sonata 0.4.0

package/dist/native/usage.js

@@ -0,0 +1,119 @@
+/**
+ * A single SSE line past this is discarded rather than accumulated. A stream
+ * that never emits a newline would otherwise grow this buffer for as long as it
+ * runs, inside the router process serving every other session.
+ */
+export const MAX_SSE_BUFFER_BYTES = 64 * 1024;
+function zero() {
+    return { input: 0, output: 0, cacheRead: 0, cacheCreation: 0 };
+}
+/** Reads the Anthropic `usage` shape, treating any absent or non-numeric field as unseen. */
+function mergeUsage(into, usage) {
+    if (usage === null || typeof usage !== 'object')
+        return false;
+    const u = usage;
+    let seen = false;
+    const take = (field, key) => {
+        const value = u[field];
+        // Only a positive count overwrites: message_delta repeats input_tokens, and
+        // some upstreams report 0 there, which must not erase the real count seen
+        // in message_start.
+        if (typeof value === 'number' && Number.isFinite(value)) {
+            seen = true;
+            if (value > 0)
+                into[key] = value;
+        }
+    };
+    take('input_tokens', 'input');
+    take('output_tokens', 'output');
+    take('cache_read_input_tokens', 'cacheRead');
+    take('cache_creation_input_tokens', 'cacheCreation');
+    return seen;
+}
+export function createUsageCollector() {
+    const tokens = zero();
+    let complete = false;
+    let buffer = new Uint8Array(0);
+    let bufferBytes = 0;
+    let overflowed = false;
+    const append = (bytes) => {
+        if (bytes.length === 0)
+            return;
+        const next = new Uint8Array(buffer.length + bytes.length);
+        next.set(buffer);
+        next.set(bytes, buffer.length);
+        buffer = next;
+        bufferBytes += bytes.byteLength;
+    };
+    const line = (raw) => {
+        const text = new TextDecoder().decode(raw);
+        const data = text.startsWith('data:') ? text.slice(5).trim() : '';
+        if (data === '' || data === '[DONE]')
+            return;
+        let frame;
+        try {
+            frame = JSON.parse(data);
+        }
+        catch {
+            return; // a partial or non-JSON data line is not ours to fail on
+        }
+        if (frame.type === 'message_start') {
+            const message = frame.message;
+            mergeUsage(tokens, message?.usage);
+            return;
+        }
+        if (frame.type === 'message_delta' && mergeUsage(tokens, frame.usage)) {
+            complete = true;
+        }
+    };
+    return {
+        push(chunk) {
+            let start = 0;
+            for (let i = 0; i < chunk.length; i += 1) {
+                if (chunk[i] !== 0x0a)
+                    continue;
+                const segment = chunk.subarray(start, i);
+                if (!overflowed && bufferBytes + segment.byteLength <= MAX_SSE_BUFFER_BYTES) {
+                    append(segment);
+                    line(buffer);
+                }
+                // Consume the completed line, including its newline, from the raw-byte
+                // accounting before looking for the next line in this chunk.
+                buffer = new Uint8Array(0);
+                bufferBytes = 0;
+                overflowed = false;
+                start = i + 1;
+            }
+            const tail = chunk.subarray(start);
+            if (overflowed)
+                return;
+            if (bufferBytes + tail.byteLength > MAX_SSE_BUFFER_BYTES) {
+                // Drop the runaway line and mark it, so its tail is not mistaken for
+                // the start of the next one.
+                buffer = new Uint8Array(0);
+                bufferBytes = 0;
+                overflowed = true;
+            }
+            else {
+                append(tail);
+            }
+        },
+        finish() {
+            return { tokens, complete };
+        },
+    };
+}
+/** The non-streaming equivalent: usage sits at the top level of the JSON body. */
+export function usageFromJsonBody(body) {
+    const tokens = zero();
+    try {
+        const doc = JSON.parse(body.toString());
+        if (doc.usage === undefined)
+            return { tokens, complete: false };
+        return { tokens, complete: mergeUsage(tokens, doc.usage) };
+    }
+    catch {
+        return { tokens, complete: false };
+    }
+}
+//# sourceMappingURL=usage.js.map

package/dist/native/usage.js.map

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

package/dist/normalize.js

@@ -0,0 +1,98 @@
+// eslint-disable-next-line no-control-regex
+const ANSI = /\u001b\[[0-9;?]*[ -/]*[@-~]/g;
+const SPINNER_ONLY = /^[⠁-⣿|/\\-]+$/;
+import { normalizeModelName } from './catalog.js';
+export function stripAnsi(s) {
+    return s.replace(ANSI, '');
+}
+export function cleanPane(raw) {
+    return stripAnsi(raw)
+        .split('\n')
+        .map((l) => l.replace(/\s+$/, ''))
+        .filter((l) => l.length > 0 && !SPINNER_ONLY.test(l.trim()));
+}
+export function newLines(prev, next) {
+    if (prev.length === 0)
+        return next;
+    const maxK = Math.min(prev.length, next.length);
+    for (let k = maxK; k > 0; k--) {
+        const prevTail = prev.slice(prev.length - k);
+        const nextHead = next.slice(0, k);
+        if (prevTail.every((line, i) => line === nextHead[i])) {
+            return next.slice(k);
+        }
+    }
+    return next;
+}
+/**
+ * Convert the pre-tier registry and generators into the unified registry and
+ * ranked lists. Legacy keys are retained when normalization would confuse two
+ * different upstream models.
+ */
+export function migrateLegacyConfig(config) {
+    const models = {};
+    const normalizedUpstreams = new Map();
+    // Two different gateways can each hold a model whose id normalizes to the
+    // same string (e.g. "gateway-a/latest" and "gateway-b/latest" both reduce
+    // to "latest") — that collision carries no gateway/provider identity to
+    // disambiguate by, since a legacy harness entry (harness + id only) has
+    // none either. Marking the upstream ambiguous instead of letting the
+    // second native key silently overwrite the first in normalizedUpstreams
+    // stops a later legacy entry from being merged into whichever native
+    // model happened to be inserted last — pairing one provider's harness
+    // route with a different provider's native route without anyone choosing
+    // that pairing.
+    const ambiguousUpstreams = new Set();
+    for (const [key, model] of Object.entries(config.native?.models ?? {})) {
+        models[key] = { gateway: model.gateway, id: model.id, contextWindow: model.contextWindow };
+        const upstream = normalizeModelName(model.id);
+        if (normalizedUpstreams.has(upstream)) {
+            ambiguousUpstreams.add(upstream);
+        }
+        else {
+            normalizedUpstreams.set(upstream, key);
+        }
+    }
+    const migratedKeys = new Map();
+    for (const [oldKey, model] of Object.entries(config.models)) {
+        const candidate = normalizeModelName(oldKey);
+        const upstream = normalizeModelName(model.id);
+        const existingKey = ambiguousUpstreams.has(upstream) ? undefined : normalizedUpstreams.get(upstream);
+        if (existingKey !== undefined) {
+            models[existingKey] = { ...models[existingKey], harness: model.harness, harnessId: model.id };
+            migratedKeys.set(oldKey, existingKey);
+            continue;
+        }
+        const occupied = models[candidate];
+        if (occupied !== undefined) {
+            // Same normalized key, but different upstream. If the legacy spelling
+            // itself is already occupied too (an exact-key collision, e.g. a
+            // [native.models."x"] and a non-mergeable legacy [models."x"]), there
+            // is nothing distinct left to fall back to — invent a key that cannot
+            // collide with anything already in `models`, rather than overwriting
+            // whichever entry got there first.
+            let fallbackKey = oldKey;
+            if (models[fallbackKey] !== undefined) {
+                let suffix = 2;
+                while (models[`${oldKey}-${suffix}`] !== undefined)
+                    suffix++;
+                fallbackKey = `${oldKey}-${suffix}`;
+            }
+            models[fallbackKey] = { harness: model.harness, harnessId: model.id };
+            migratedKeys.set(oldKey, fallbackKey);
+            continue;
+        }
+        models[candidate] = { harness: model.harness, harnessId: model.id };
+        migratedKeys.set(oldKey, candidate);
+    }
+    const tiers = {};
+    const roles = new Set([...Object.keys(config.generate.roles), ...Object.keys(config.native?.generate ?? {})]);
+    for (const role of roles) {
+        const native = config.native?.generate?.[role] ?? [];
+        const harness = (config.generate.roles[role] ?? []).map((key) => migratedKeys.get(key) ?? key);
+        const ordered = [...native, ...harness].filter((key, index, list) => list.indexOf(key) === index);
+        tiers[role] = { simple: [...ordered], complex: [...ordered] };
+    }
+    return { models, tiers };
+}
+//# sourceMappingURL=normalize.js.map

package/dist/normalize.js.map

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

package/dist/pricing.js

@@ -0,0 +1,86 @@
+import { normalizeModelName } from './catalog.js';
+function minutes(hhmm) {
+    const [hours, minutesPart] = hhmm.split(':');
+    return Number(hours) * 60 + Number(minutesPart);
+}
+function hasRates(rates) {
+    return rates.input !== undefined || rates.cachedInput !== undefined || rates.output !== undefined;
+}
+/**
+ * UTC only. A window ending at or before its start wraps over midnight, so its
+ * two matching ranges must be joined rather than treated as an empty interval.
+ */
+export function inWindow(window, at) {
+    const time = at.getUTCHours() * 60 + at.getUTCMinutes();
+    const from = minutes(window.from);
+    const to = minutes(window.to);
+    return from <= to ? time >= from && time < to : time >= from || time < to;
+}
+export function ratesFor(price, at) {
+    if (price === undefined)
+        return undefined;
+    for (const window of price.windows ?? []) {
+        if (inWindow(window, at)) {
+            const windowRates = {
+                input: window.input,
+                cachedInput: window.cachedInput,
+                output: window.output,
+            };
+            // An empty override must not turn unknown pricing into a confident zero.
+            if (hasRates(windowRates))
+                return windowRates;
+        }
+    }
+    const flat = {
+        input: price.input,
+        cachedInput: price.cachedInput,
+        output: price.output,
+    };
+    return hasRates(flat) ? flat : undefined;
+}
+const PER_MILLION = 1_000_000;
+export function costOf(tokens, rates) {
+    return ((tokens.input * (rates.input ?? 0)
+        + tokens.cacheRead * (rates.cachedInput ?? 0)
+        + tokens.cacheCreation * (rates.input ?? 0)
+        + tokens.output * (rates.output ?? 0))
+        / PER_MILLION);
+}
+export function resolvePrice(config, key, tokens, at, aiPricing) {
+    if (key === undefined)
+        return { source: 'none' };
+    const model = config.unifiedModels[key];
+    if (model === undefined)
+        return { source: 'none' };
+    const modelRates = ratesFor(model.price, at);
+    if (modelRates !== undefined) {
+        const totalUsd = costOf(tokens, modelRates);
+        if (!Number.isFinite(totalUsd))
+            return { source: 'none' };
+        return { source: 'model', totalUsd };
+    }
+    const gateway = model.gateway === undefined ? undefined : config.native?.gateways[model.gateway];
+    const gatewayRates = ratesFor(gateway?.price, at);
+    if (gatewayRates !== undefined) {
+        const totalUsd = costOf(tokens, gatewayRates);
+        if (!Number.isFinite(totalUsd))
+            return { source: 'none' };
+        return { source: 'gateway', totalUsd };
+    }
+    const provider = gateway?.pricingProvider;
+    if (provider === undefined || aiPricing === undefined || model.id === undefined) {
+        return { source: 'none' };
+    }
+    const scraped = aiPricing.models[normalizeModelName(model.id)]?.[provider];
+    if (scraped === undefined)
+        return { source: 'none' };
+    const totalUsd = costOf(tokens, scraped);
+    if (!Number.isFinite(totalUsd))
+        return { source: 'none' };
+    return {
+        source: 'ai-pricing',
+        totalUsd,
+        observedAt: aiPricing.fetchedAt,
+    };
+}
+//# sourceMappingURL=pricing.js.map

package/dist/pricing.js.map

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

package/dist/roles.js

@@ -0,0 +1,49 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * One line per role, in the same words the generated agent's `description`
+ * uses. Lives here rather than in `sync.ts` so `sonata init`'s role picker can
+ * label its rows with it: the wizard used to list the four roles as bare words,
+ * leaving a first-time user to guess what `plan` did that `explore` did not.
+ */
+export const ROLE_BLURB = {
+    code: 'implementation, refactors, and mechanical code changes',
+    review: 'reviewing existing code for defects, without modifying it',
+    explore: 'locating code and answering questions about the codebase, without modifying it',
+    plan: 'producing an implementation plan for a change, without performing it',
+};
+export function loadRole(role, rolesDir) {
+    const path = join(rolesDir, `${role}.md`);
+    if (!existsSync(path)) {
+        throw new Error(`sonata: no role prompt for "${role}" at ${path}`);
+    }
+    return readFileSync(path, 'utf8');
+}
+export function composeInstructions(input) {
+    const parts = [];
+    parts.push(`# Role: ${input.role}`, '', input.roleText.trim(), '');
+    parts.push('## Task', '', input.task.trim(), '');
+    // Some harnesses load the working directory's .mcp.json on top of their own
+    // config, which in a sonata-registered repo hands the model sonata's own
+    // dispatch tools. Nothing can withhold them per run, so say it outright.
+    if (input.inheritedSonataTools === true) {
+        parts.push('## Do not dispatch', '', "You may find tools named `sonata`, `dispatch`, `wait` or `approve` among", 'your available tools. They start further foreign-model runs. **You are', 'already one of those runs.** Never call them, whatever the task appears to', 'ask for: doing so spawns work nobody is watching and can recurse without', 'bound. If the task seems to require dispatching, say so in your report and', 'stop.', '');
+    }
+    if (input.repoContext.trim().length > 0) {
+        parts.push('## Repository context', '', input.repoContext.trim(), '');
+    }
+    // Asking for a file the sandbox forbids is not a harmless instruction. A
+    // read-only codex run once read 92k tokens of a codebase, completed the
+    // work, and then spent its whole final message apologising for being unable
+    // to write report.md — which is what the harness fallback captured, so the
+    // findings were lost and the run was reported DONE and not degraded.
+    if (input.canWriteReport === false) {
+        parts.push('## Reporting', '', 'This run cannot write files: your sandbox is read-only by design, and that', 'includes the report file. Do not attempt to write one, and do not spend your', 'final message explaining that you could not — sonata already knows.', '', 'Your final message IS the report. Put the whole result there: what you found,', 'what you verified, and anything you could not finish. If you did not complete', 'the task, say so in the first line.', '');
+    }
+    else {
+        parts.push('## Reporting', '', 'As your final action, write a short report to this exact path:', '', `    ${input.reportPath}`, '', 'The report must state what you changed, what you verified, and anything you', 'could not finish. If you did not complete the task, say so in the first line.', 'Nothing reads your terminal output — the report file is the only result that', 'is returned.', '');
+    }
+    parts.push('## Task reminder', '', 'Complete the task exactly as stated above:', '', input.task.trim(), '');
+    return parts.join('\n');
+}
+//# sourceMappingURL=roles.js.map

package/dist/roles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.js","sourceRoot":"","sources":["../src/roles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAA2B;IAChD,IAAI,EAAE,wDAAwD;IAC9D,MAAM,EAAE,2DAA2D;IACnE,OAAO,EAAE,gFAAgF;IACzF,IAAI,EAAE,sEAAsE;CAC7E,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,QAAgB;IACrD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;IAC1C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,+BAA+B,IAAI,QAAQ,IAAI,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACpC,CAAC;AAoBD,MAAM,UAAU,mBAAmB,CAAC,KAAmB;IACrD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAEnE,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAEjD,4EAA4E;IAC5E,yEAAyE;IACzE,yEAAyE;IACzE,IAAI,KAAK,CAAC,oBAAoB,KAAK,IAAI,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CACR,oBAAoB,EACpB,EAAE,EACF,0EAA0E,EAC1E,wEAAwE,EACxE,4EAA4E,EAC5E,0EAA0E,EAC1E,4EAA4E,EAC5E,OAAO,EACP,EAAE,CACH,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,EAAE,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,yEAAyE;IACzE,wEAAwE;IACxE,4EAA4E;IAC5E,2EAA2E;IAC3E,qEAAqE;IACrE,IAAI,KAAK,CAAC,cAAc,KAAK,KAAK,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CACR,cAAc,EACd,EAAE,EACF,4EAA4E,EAC5E,8EAA8E,EAC9E,qEAAqE,EACrE,EAAE,EACF,+EAA+E,EAC/E,+EAA+E,EAC/E,qCAAqC,EACrC,EAAE,CACH,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CACR,cAAc,EACd,EAAE,EACF,gEAAgE,EAChE,EAAE,EACF,OAAO,KAAK,CAAC,UAAU,EAAE,EACzB,EAAE,EACF,6EAA6E,EAC7E,+EAA+E,EAC/E,8EAA8E,EAC9E,cAAc,EACd,EAAE,CACH,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,EAAE,4CAA4C,EAAE,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAE5G,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/sessions.js

@@ -0,0 +1,62 @@
+/**
+ * Which project each routed session belonged to.
+ *
+ * The router sees a session id on a header but never a working directory, so
+ * per-project reporting has to be joined from somewhere else. `cmdRouteSession`
+ * runs at SessionStart and knows both.
+ *
+ * This is deliberately NOT `route-sessions.json`, which is a live refcount that
+ * shrinks as sessions end. This is history: a ledger row from last week still
+ * needs its project resolved long after that session is gone. It is pruned on
+ * the same window as the ledger so the two cannot drift into a state where rows
+ * exist with no map to join.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { withSessionLock } from './filelock.js';
+export function sessionsPath(home) {
+    return join(home, '.config', 'sonata', 'sessions.json');
+}
+export function loadSessions(home) {
+    const path = sessionsPath(home);
+    if (!existsSync(path))
+        return {};
+    try {
+        const doc = JSON.parse(readFileSync(path, 'utf8'));
+        if (doc === null || typeof doc !== 'object' || Array.isArray(doc))
+            return {};
+        return doc;
+    }
+    catch {
+        return {};
+    }
+}
+export async function recordSession(home, record) {
+    await withSessionLock(sessionsPath(home), () => {
+        const all = loadSessions(home);
+        all[record.session] = record;
+        mkdirSync(dirname(sessionsPath(home)), { recursive: true });
+        writeFileSync(sessionsPath(home), `${JSON.stringify(all, null, 2)}\n`);
+    });
+}
+export async function pruneSessions(home, retentionDays, now = new Date()) {
+    return withSessionLock(sessionsPath(home), () => {
+        const all = loadSessions(home);
+        // Same day-floor as `pruneLedger`: the window is measured in whole UTC days,
+        // not in exact milliseconds, so a session started at the boundary keeps
+        // both prunes agreeing on which entries are "older than N days".
+        const cutoff = Math.floor((now.getTime() - retentionDays * 24 * 3600 * 1000) / (24 * 3600 * 1000)) * (24 * 3600 * 1000);
+        let removed = 0;
+        for (const [id, record] of Object.entries(all)) {
+            const started = Date.parse(record?.started ?? '');
+            if (Number.isFinite(started) && started >= cutoff)
+                continue;
+            delete all[id];
+            removed += 1;
+        }
+        if (removed > 0)
+            writeFileSync(sessionsPath(home), `${JSON.stringify(all, null, 2)}\n`);
+        return removed;
+    });
+}
+//# sourceMappingURL=sessions.js.map

package/dist/sessions.js.map

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

package/dist/settings.js

@@ -0,0 +1,131 @@
+/**
+ * Reading and safely amending Claude Code settings files.
+ *
+ * These files belong to the user and routinely contain unrelated hooks and
+ * configuration. Every function here preserves unknown keys verbatim, and
+ * installation is idempotent so re-running `sonata init` cannot accumulate
+ * duplicate hook entries.
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync, copyFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+/**
+ * The three Bash commands a sonata wrapper is given.
+ *
+ * The tool surface moved from MCP to the blocking dispatch/wait/approve CLI.
+ *
+ * These must be on the allow list, not left to Claude Code's `auto` mode
+ * classifier. The classifier judges each call separately and its decisions are
+ * not stable across calls: on 2026-08-12 a wrapper had `run` allowed and `tail`
+ * allowed twice, then denied twice mid-run — "Blocked by classifier" — which
+ * left a foreign model writing to the repository with nothing able to observe
+ * it. (`run` and `tail` were the tool names then; `dispatch` and `wait`
+ * replaced them when polling did.)
+ *
+ * The shape of that failure changed but did not go away. `dispatch` both
+ * executes and reads back, so it can no longer be permitted while the
+ * read-back is blocked — but a denied `wait` still strands a paused run
+ * unobserved, which is the same hazard with a smaller blast radius.
+ */
+export const SONATA_TOOLS = [
+    'Bash(sonata dispatch:*)',
+    'Bash(sonata wait:*)',
+    'Bash(sonata approve:*)',
+];
+/** Which of the sonata tools are missing from `permissions.allow`. */
+export function missingAllowEntries(settings) {
+    const allow = settings.permissions?.allow ?? [];
+    return SONATA_TOOLS.filter((t) => !allow.includes(t));
+}
+/**
+ * Adds the sonata tools to `permissions.allow`, preserving order and every
+ * unrelated entry. Idempotent: re-running `sonata init` cannot duplicate them.
+ */
+export function allowSonataTools(settings) {
+    const missing = missingAllowEntries(settings);
+    if (missing.length === 0)
+        return { settings, changed: false };
+    const permissions = { ...(settings.permissions ?? {}) };
+    permissions.allow = [...(settings.permissions?.allow ?? []), ...missing];
+    return { settings: { ...settings, permissions }, changed: true };
+}
+export function settingsPath(scope, cwd, home) {
+    return scope === 'global'
+        ? join(home, '.claude', 'settings.json')
+        : join(cwd, '.claude', 'settings.json');
+}
+export function readSettings(path) {
+    if (!existsSync(path))
+        return {};
+    const raw = readFileSync(path, 'utf8').trim();
+    if (raw.length === 0)
+        return {};
+    return JSON.parse(raw);
+}
+/**
+ * Writes settings, keeping a one-shot `.bak` of any pre-existing file. A bad
+ * merge should always be recoverable by hand.
+ */
+export function writeSettings(path, settings) {
+    mkdirSync(dirname(path), { recursive: true });
+    if (existsSync(path))
+        copyFileSync(path, `${path}.bak`);
+    writeFileSync(path, `${JSON.stringify(settings, null, 2)}\n`);
+}
+/**
+ * Whether *some* sonata mode-capture hook is present, wherever it was installed
+ * from. `hookInstalled` matches one exact command string, which is the right
+ * check when installing; this is the right check when diagnosing, since a hook
+ * installed by a different sonata checkout still does the job.
+ */
+export function modeHookPresent(settings, event = 'PreToolUse') {
+    return (settings.hooks?.[event] ?? []).some((entry) => entry.hooks.some((h) => h.command.includes('capture-mode.mjs')));
+}
+export function hookInstalled(settings, command, event = 'PreToolUse') {
+    return (settings.hooks?.[event] ?? []).some((entry) => entry.hooks.some((h) => h.command === command));
+}
+/**
+ * Adds the hook as its own matcher entry, leaving every existing entry — and
+ * every unrelated top-level key — untouched. Returns `changed: false` when the
+ * exact command is already present.
+ */
+export function installHook(settings, command, matcher = 'Bash', event = 'PreToolUse') {
+    if (hookInstalled(settings, command, event)) {
+        return { settings, changed: false };
+    }
+    const next = { ...settings };
+    const hooks = { ...(settings.hooks ?? {}) };
+    const entries = [...(hooks[event] ?? [])];
+    // A PreToolUse hook needs its `matcher` ("Bash"), but a SessionStart hook has
+    // no matcher at all — writing `matcher: ""` would be noise in the file, so
+    // omit the key entirely when none was supplied.
+    const entry = matcher ? { matcher, hooks: [{ type: 'command', command }] }
+        : { hooks: [{ type: 'command', command }] };
+    entries.push(entry);
+    hooks[event] = entries;
+    next.hooks = hooks;
+    return { settings: next, changed: true };
+}
+export function uninstallHook(settings, command, event = 'PreToolUse') {
+    const entries = settings.hooks?.[event];
+    if (!entries)
+        return { settings, changed: false };
+    const pruned = entries
+        .map((entry) => ({ ...entry, hooks: entry.hooks.filter((h) => h.command !== command) }))
+        .filter((entry) => entry.hooks.length > 0);
+    if (pruned.length === entries.length)
+        return { settings, changed: false };
+    const hooks = { ...settings.hooks };
+    if (pruned.length === 0)
+        delete hooks[event];
+    else
+        hooks[event] = pruned;
+    const next = { ...settings, hooks };
+    if (Object.keys(hooks).length === 0)
+        delete next.hooks;
+    return { settings: next, changed: true };
+}
+/** The command string sonata installs, pointing at this installation's hook. */
+export function hookCommand(packageRoot) {
+    return `node ${JSON.stringify(join(packageRoot, 'hooks', 'capture-mode.mjs'))}`;
+}
+//# sourceMappingURL=settings.js.map

package/dist/settings.js.map

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