@zhihaohong52/sonata 0.4.0

package/dist/ledger.js

@@ -0,0 +1,123 @@
+/**
+ * The append-only record of what the router did.
+ *
+ * One JSON line per completed request, in a file per UTC day. Global rather
+ * than per-project because the router is a daemon shared across every project;
+ * per-project reporting comes from the session map in `src/sessions.ts`.
+ *
+ * Daily files exist so retention is a file deletion rather than a rewrite.
+ * "opencode's event table grows without bound — 6.5 GB across 140k rows" is
+ * already a documented limitation caused by another tool doing this
+ * carelessly, and sonata does not get to repeat it in its own store.
+ */
+import { appendFileSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+export const LEDGER_RETENTION_DAYS = 30;
+const FILE_PATTERN = /^(\d{4}-\d{2}-\d{2})\.jsonl$/;
+export function ledgerDir(home) {
+    return join(home, '.config', 'sonata', 'usage');
+}
+/** UTC date, never local: a local date would roll the file over at the wrong moment. */
+export function ledgerPathFor(home, at) {
+    return join(ledgerDir(home), `${at.toISOString().slice(0, 10)}.jsonl`);
+}
+export function appendRow(home, row) {
+    const at = new Date(row.ts);
+    mkdirSync(ledgerDir(home), { recursive: true });
+    // O_APPEND plus one write keeps concurrent appends as whole lines.
+    appendFileSync(ledgerPathFor(home, at), `${JSON.stringify(row)}\n`);
+}
+export function readRows(home, sinceMs, now = Date.now()) {
+    const dir = ledgerDir(home);
+    if (!existsSync(dir))
+        return [];
+    const out = [];
+    for (const name of readdirSync(dir).sort()) {
+        if (!FILE_PATTERN.test(name))
+            continue;
+        let raw;
+        try {
+            raw = readFileSync(join(dir, name), 'utf8');
+        }
+        catch {
+            continue;
+        }
+        for (const line of raw.split('\n')) {
+            if (line === '')
+                continue;
+            let row;
+            try {
+                const parsed = JSON.parse(line);
+                if (parsed === null || typeof parsed !== 'object' || typeof parsed.ts !== 'string')
+                    continue;
+                row = parsed;
+                if (!Number.isFinite(Date.parse(row.ts)))
+                    continue;
+                if (!hasRequiredFields(row))
+                    continue;
+            }
+            catch {
+                // A torn final line (a crash mid-append) must not cost the whole report.
+                continue;
+            }
+            const ts = Date.parse(row.ts);
+            if (!Number.isFinite(ts) || ts < sinceMs || ts > now)
+                continue;
+            out.push(row);
+        }
+    }
+    return out;
+}
+function priceIsValid(price) {
+    if (price === null || typeof price !== 'object' || Array.isArray(price))
+        return false;
+    if (price.source === 'none')
+        return true;
+    if (price.source === 'model' || price.source === 'gateway' || price.source === 'ai-pricing') {
+        return typeof price.totalUsd === 'number' && Number.isFinite(price.totalUsd);
+    }
+    return false;
+}
+/**
+ * A persisted row is untrusted input. Every downstream reader (`aggregate`,
+ * `recentRoutes`) reaches into `tokens.input`/`tokens.output`, `attempts.length`
+ * and `price.source`/`price.totalUsd`, so a parseable-but-incomplete row must be
+ * dropped here rather than crash those readers later. `aggregate` dereferences
+ * `price.source` directly, so a `null` or otherwise malformed price must be
+ * rejected too, not just an absent `tokens`/`attempts`.
+ */
+function hasRequiredFields(row) {
+    const tokens = row.tokens;
+    if (tokens === null || typeof tokens !== 'object' || Array.isArray(tokens))
+        return false;
+    if (typeof tokens.input !== 'number' || !Number.isFinite(tokens.input))
+        return false;
+    if (typeof tokens.output !== 'number' || !Number.isFinite(tokens.output))
+        return false;
+    if (!priceIsValid(row.price))
+        return false;
+    return Array.isArray(row.attempts);
+}
+/** Deletes whole day-files older than the window. Returns how many were removed. */
+export function pruneLedger(home, retentionDays, now = new Date()) {
+    const dir = ledgerDir(home);
+    if (!existsSync(dir))
+        return 0;
+    const cutoff = Math.floor((now.getTime() - retentionDays * 24 * 3600 * 1000) / (24 * 3600 * 1000)) * (24 * 3600 * 1000);
+    let removed = 0;
+    for (const name of readdirSync(dir)) {
+        const match = FILE_PATTERN.exec(name);
+        if (match === null)
+            continue; // never delete a file this module did not write
+        const day = Date.parse(`${match[1]}T00:00:00.000Z`);
+        if (!Number.isFinite(day) || day >= cutoff)
+            continue;
+        try {
+            rmSync(join(dir, name), { force: true });
+            removed += 1;
+        }
+        catch { /* a file we cannot remove is not worth failing serve over */ }
+    }
+    return removed;
+}
+//# sourceMappingURL=ledger.js.map

package/dist/ledger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.js","sourceRoot":"","sources":["../src/ledger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACnG,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AA4BjC,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAExC,MAAM,YAAY,GAAG,8BAA8B,CAAC;AAEpD,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AAClD,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,EAAQ;IAClD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,GAAc;IACpD,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5B,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,mEAAmE;IACnE,cAAc,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,OAAe,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;IAC9E,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,MAAM,GAAG,GAAgB,EAAE,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC3C,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,SAAS;QACvC,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACH,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,IAAI,IAAI,KAAK,EAAE;gBAAE,SAAS;YAC1B,IAAI,GAAc,CAAC;YACnB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACzC,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAQ,MAA2B,CAAC,EAAE,KAAK,QAAQ;oBAAE,SAAS;gBACnH,GAAG,GAAG,MAAmB,CAAC;gBAC1B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;oBAAE,SAAS;gBACnD,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC;oBAAE,SAAS;YACxC,CAAC;YAAC,MAAM,CAAC;gBACP,yEAAyE;gBACzE,SAAS;YACX,CAAC;YACD,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,OAAO,IAAI,EAAE,GAAG,GAAG;gBAAE,SAAS;YAC/D,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,YAAY,CAAC,KAAyB;IAC7C,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtF,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACzC,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;QAC5F,OAAO,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,iBAAiB,CAAC,GAAc;IACvC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAC1B,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IACzF,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACrF,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IACvF,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,aAAqB,EAAE,MAAY,IAAI,IAAI,EAAE;IACrF,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,aAAa,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;IACxH,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,KAAK,KAAK,IAAI;YAAE,SAAS,CAAC,gDAAgD;QAC9E,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;QACpD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,MAAM;YAAE,SAAS;QACrD,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACzC,OAAO,IAAI,CAAC,CAAC;QACf,CAAC;QAAC,MAAM,CAAC,CAAC,6DAA6D,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/mcp/protocol.js

@@ -0,0 +1,64 @@
+/**
+ * The MCP surface sonata needs, as a pure function.
+ *
+ * MCP is JSON-RPC 2.0 over newline-delimited stdio. Only four messages matter
+ * here, so the protocol lives in one testable function and the transport is a
+ * thin loop around it — the same split as parseKey/runList in tui.ts.
+ */
+/**
+ * Used only when a client omits its version; the real one is echoed back.
+ * Captured from Claude Code 2.1.228 on 2026-08-12 — see
+ * tests/fixtures/mcp-handshake.jsonl. It was written as 2025-06-18 from
+ * documentation, which the capture disproved.
+ */
+const FALLBACK_PROTOCOL_VERSION = '2025-11-25';
+export async function handle(req, deps, onLines) {
+    // Notifications have no id and take no response.
+    if (req.id === undefined)
+        return null;
+    const id = req.id;
+    switch (req.method) {
+        case 'initialize':
+            return {
+                jsonrpc: '2.0',
+                id,
+                result: {
+                    protocolVersion: req.params?.protocolVersion ?? FALLBACK_PROTOCOL_VERSION,
+                    capabilities: { tools: {} },
+                    serverInfo: { name: 'sonata', version: '0.0.1' },
+                },
+            };
+        case 'tools/list':
+            return { jsonrpc: '2.0', id, result: { tools: deps.tools } };
+        case 'tools/call': {
+            const name = req.params?.name;
+            const args = req.params?.arguments ?? {};
+            try {
+                if (!deps.tools.some((t) => t.name === name)) {
+                    throw new Error(`unknown tool "${name}"`);
+                }
+                const text = await deps.call(name, args, onLines);
+                return { jsonrpc: '2.0', id, result: { content: [{ type: 'text', text }] } };
+            }
+            catch (err) {
+                // A refused dispatch must reach the wrapper as text it can relay,
+                // never as a dropped call it reports nothing about.
+                return {
+                    jsonrpc: '2.0',
+                    id,
+                    result: {
+                        content: [{ type: 'text', text: err.message }],
+                        isError: true,
+                    },
+                };
+            }
+        }
+        default:
+            return {
+                jsonrpc: '2.0',
+                id,
+                error: { code: -32601, message: `method not found: ${req.method}` },
+            };
+    }
+}
+//# sourceMappingURL=protocol.js.map

package/dist/mcp/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/mcp/protocol.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA6BH;;;;;GAKG;AACH,MAAM,yBAAyB,GAAG,YAAY,CAAC;AAE/C,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,GAAmB,EACnB,IAAU,EACV,OAAmC;IAEnC,iDAAiD;IACjD,IAAI,GAAG,CAAC,EAAE,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC;IAElB,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC;QACnB,KAAK,YAAY;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,EAAE;gBACF,MAAM,EAAE;oBACN,eAAe,EAAG,GAAG,CAAC,MAAM,EAAE,eAA0B,IAAI,yBAAyB;oBACrF,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;oBAC3B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE;iBACjD;aACF,CAAC;QAEJ,KAAK,YAAY;YACf,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;QAE/D,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,EAAE,IAAc,CAAC;YACxC,MAAM,IAAI,GAAI,GAAG,CAAC,MAAM,EAAE,SAAqC,IAAI,EAAE,CAAC;YACtE,IAAI,CAAC;gBACH,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;oBAC7C,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,GAAG,CAAC,CAAC;gBAC5C,CAAC;gBACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;gBAClD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/E,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,kEAAkE;gBAClE,oDAAoD;gBACpD,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,EAAE;oBACF,MAAM,EAAE;wBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAG,GAAa,CAAC,OAAO,EAAE,CAAC;wBACzD,OAAO,EAAE,IAAI;qBACd;iBACF,CAAC;YACJ,CAAC;QACH,CAAC;QAED;YACE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,EAAE;gBACF,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,qBAAqB,GAAG,CAAC,MAAM,EAAE,EAAE;aACpE,CAAC;IACN,CAAC;AACH,CAAC"}

package/dist/mcp/server.js

@@ -0,0 +1,96 @@
+import { createInterface } from 'node:readline';
+import { appendFileSync } from 'node:fs';
+import { handle } from './protocol.js';
+import { TOOL_DEFS, callTool } from './tools.js';
+/**
+ * Records every incoming request verbatim when `SONATA_MCP_DEBUG` names a file.
+ *
+ * The client's own framing is otherwise invisible: sonata never sees whether
+ * Claude Code supplies a `_meta.progressToken`, which is what decides whether
+ * the server may push `notifications/progress` at all. Off unless the variable
+ * is set, and it never touches stdout — anything written there is protocol.
+ */
+function debugLog(line) {
+    const path = process.env.SONATA_MCP_DEBUG;
+    if (!path)
+        return;
+    try {
+        appendFileSync(path, `${new Date().toISOString()} ${line}\n`);
+    }
+    catch {
+        // Debug logging must never take the session's dispatch capability down.
+    }
+}
+/**
+ * The stdio loop. Input is injected so the whole server is testable without a
+ * process, which is the same seam readKeys uses for stdin in tui.ts.
+ */
+export async function serveMcp(input, write, env) {
+    for await (const raw of input) {
+        const line = raw.trim();
+        if (line.length === 0)
+            continue;
+        debugLog(line);
+        let req;
+        try {
+            req = JSON.parse(line);
+        }
+        catch {
+            // Never die on bad input: the session loses dispatch entirely.
+            write(JSON.stringify({
+                jsonrpc: '2.0', id: null,
+                error: { code: -32700, message: 'parse error' },
+            }));
+            continue;
+        }
+        // JSON.parse accepts `null`, `5`, `"x"` and `[1]`. Reading .id off any of
+        // them threw, which killed the loop — and a dead server takes the
+        // session's dispatch capability with it.
+        if (typeof req !== 'object' || req === null || Array.isArray(req)) {
+            write(JSON.stringify({
+                jsonrpc: '2.0', id: null,
+                error: { code: -32600, message: 'invalid request' },
+            }));
+            continue;
+        }
+        const token = req.method === 'tools/call'
+            && req.params?._meta
+            && typeof req.params._meta === 'object'
+            ? req.params._meta.progressToken
+            : undefined;
+        let progress = 0;
+        const onLines = typeof token === 'string' || typeof token === 'number'
+            ? (lines) => {
+                // One line per notification, deliberately.
+                //
+                // Sending a rolling window instead was tried and measured worse
+                // (2026-08-19, Claude Code 2.1.233): the client flattens the newlines,
+                // then clips the message head-first at roughly two wrapped rows. The
+                // newest line sits at the end of a window, so it is precisely what the
+                // clip removes — a screenshot showed four old commands and the live one
+                // truncated to `$ nod…`. One line always fits, and is always the line
+                // the run is on. History belongs in the transcript, not in a display
+                // that keeps only its head.
+                for (const message of lines) {
+                    write(JSON.stringify({
+                        jsonrpc: '2.0',
+                        method: 'notifications/progress',
+                        params: { progressToken: token, progress: ++progress, message },
+                    }));
+                }
+            }
+            : undefined;
+        const res = await handle(req, {
+            tools: TOOL_DEFS,
+            call: (name, args, onLines) => callTool(name, args, env, onLines),
+        }, onLines);
+        if (res !== null)
+            write(JSON.stringify(res));
+    }
+}
+/** Wires the loop to the real stdio streams. */
+export async function runMcpStdio(env) {
+    const rl = createInterface({ input: process.stdin });
+    await serveMcp(rl, (l) => process.stdout.write(`${l}\n`), env);
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,MAAM,EAAuB,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAgB,MAAM,YAAY,CAAC;AAE/D;;;;;;;GAOG;AACH,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAC1C,IAAI,CAAC,IAAI;QAAE,OAAO;IAClB,IAAI,CAAC;QACH,cAAc,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,IAAI,IAAI,CAAC,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,wEAAwE;IAC1E,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,KAA4B,EAC5B,KAA6B,EAC7B,GAAY;IAEZ,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACxB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAChC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,GAAmB,CAAC;QACxB,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAmB,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,+DAA+D;YAC/D,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;gBACnB,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI;gBACxB,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE;aAChD,CAAC,CAAC,CAAC;YACJ,SAAS;QACX,CAAC;QAED,0EAA0E;QAC1E,kEAAkE;QAClE,yCAAyC;QACzC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAClE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;gBACnB,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI;gBACxB,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE;aACpD,CAAC,CAAC,CAAC;YACJ,SAAS;QACX,CAAC;QAED,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,KAAK,YAAY;eACpC,GAAG,CAAC,MAAM,EAAE,KAAK;eACjB,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,QAAQ;YACvC,CAAC,CAAE,GAAG,CAAC,MAAM,CAAC,KAAiC,CAAC,aAAa;YAC7D,CAAC,CAAC,SAAS,CAAC;QACd,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,MAAM,OAAO,GAAG,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ;YACpE,CAAC,CAAC,CAAC,KAAe,EAAE,EAAE;gBACpB,2CAA2C;gBAC3C,EAAE;gBACF,gEAAgE;gBAChE,uEAAuE;gBACvE,qEAAqE;gBACrE,uEAAuE;gBACvE,wEAAwE;gBACxE,sEAAsE;gBACtE,qEAAqE;gBACrE,4BAA4B;gBAC5B,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;oBAC5B,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;wBACnB,OAAO,EAAE,KAAK;wBACd,MAAM,EAAE,wBAAwB;wBAChC,MAAM,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE;qBAChE,CAAC,CAAC,CAAC;gBACN,CAAC;YACH,CAAC;YACD,CAAC,CAAC,SAAS,CAAC;QAEd,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE;YAC5B,KAAK,EAAE,SAAS;YAChB,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC;SAClE,EAAE,OAAO,CAAC,CAAC;QACZ,IAAI,GAAG,KAAK,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC;AAED,gDAAgD;AAChD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAY;IAC5C,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACrD,MAAM,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;AACjE,CAAC"}

package/dist/mcp/tools.js

@@ -0,0 +1,210 @@
+import { writeFileSync, statSync, existsSync } from 'node:fs';
+import { randomUUID } from 'node:crypto';
+import { join, resolve } from 'node:path';
+import { tmpdir } from 'node:os';
+import { cmdRun } from '../commands/run.js';
+import { cmdWait } from '../commands/wait.js';
+import { cmdApprove } from '../commands/approve.js';
+import { readEvents } from '../store.js';
+/**
+ * Ceiling on a report returned through MCP.
+ *
+ * Claude Code warns above 10k tokens of tool output and caps at 25k, and a
+ * result over its persist-to-disk threshold is replaced in the conversation by
+ * a file reference — which stops the report being the wrapper's final message,
+ * the one thing the orchestrator actually reads. 40k characters is roughly 10k
+ * tokens, so an ordinary report stays inline and under the warning.
+ */
+export const MAX_REPORT_CHARS = 40_000;
+/** Keeps the head of an oversized report and says where the whole thing is. */
+export function truncateReport(report, id, max = MAX_REPORT_CHARS) {
+    if (report.length <= max)
+        return report;
+    return `${report.slice(0, max)}\n\n[truncated: full transcript at \`sonata log ${id}\`]`;
+}
+const MAX_RESULT_SIZE_CHARS = 200_000;
+const REPORT_META = { 'anthropic/maxResultSizeChars': MAX_RESULT_SIZE_CHARS };
+export const TOOL_DEFS = [
+    {
+        name: 'dispatch',
+        description: 'Run a task on a foreign model and return its report. Blocks until the run ' +
+            'finishes, needs an approval, or stalls — so one call is usually the whole ' +
+            'dispatch. Returns state DONE, PAUSED, STALLED or RUNNING.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                role: { type: 'string', description: 'code | review | explore | plan' },
+                model: { type: 'string', description: 'a model key from sonata.toml' },
+                task: { type: 'string', description: 'The task text, verbatim and byte for byte. Never summarise, shorten, or rewrite it. If the caller gave you a file path instead, use task_file.' },
+                task_file: { type: 'string', description: 'Path to a file holding the task. Prefer this whenever the caller gives you one: a path cannot be paraphrased, and the model receives exactly what was written. Give either task or task_file, not both.' },
+                transcript: { type: 'boolean', description: 'Return the run\'s whole terminal transcript beside the report. Pass true when the caller asks to read what the model did, turn by turn; leave it out otherwise, since a transcript is far larger than a report.' },
+                cwd: { type: 'string', description: 'optional existing directory in which to launch the run' },
+            },
+            required: ['role', 'model'],
+        },
+        _meta: REPORT_META,
+    },
+    {
+        name: 'wait',
+        description: 'Resume waiting on a run already launched — after answering a PAUSED prompt, ' +
+            'or when a previous call returned RUNNING. Same states as dispatch.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'the run id' },
+                cwd: { type: 'string', description: 'the same directory returned by dispatch' },
+                transcript: { type: 'boolean', description: 'Return the run\'s whole terminal transcript beside the report.' },
+            },
+            required: ['id'],
+        },
+        _meta: REPORT_META,
+    },
+    {
+        name: 'approve',
+        description: 'Answer a run that is PAUSED awaiting approval.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string' },
+                answer: { type: 'string', description: 'yes or no' },
+                cwd: { type: 'string', description: 'the same directory returned by dispatch' },
+            },
+            required: ['id', 'answer'],
+        },
+    },
+];
+/** Trims the report in a result, leaving every other field alone. */
+function withTrimmedReport(result) {
+    return result.report === undefined
+        ? result
+        : { ...result, report: truncateReport(result.report, result.id) };
+}
+/** The result payload, carrying the transcript only when it was asked for. */
+function withTranscript(result, cwd, args) {
+    const payload = { ...result, cwd };
+    if (args.transcript !== true)
+        return payload;
+    const transcript = transcriptFor(cwd, result.id, (result.report ?? '').length);
+    if (transcript !== undefined)
+        payload.transcript = transcript;
+    return payload;
+}
+/**
+ * The run's whole pane transcript, for a caller who asked to read it.
+ *
+ * The events file has held every line all along — this is `sonata log`'s
+ * content delivered through MCP, so a wrapper can show its caller what the
+ * foreign model actually did rather than only what it concluded.
+ *
+ * Budgeted against the report beside it, because the two share one result and
+ * the report is the part that must never be pushed out. Head rather than tail:
+ * the end of a run is what the report already describes, so what is missing is
+ * how it got there.
+ */
+export function transcriptFor(cwd, id, reportChars, max = MAX_REPORT_CHARS) {
+    const lines = readEvents(cwd, id);
+    if (lines.length === 0)
+        return undefined;
+    const budget = max - reportChars;
+    if (budget <= 0)
+        return `[omitted: the report used the whole result — \`sonata log ${id}\`]`;
+    const text = lines.join('\n');
+    return text.length <= budget
+        ? text
+        : `${text.slice(0, budget)}\n\n[truncated: whole transcript at \`sonata log ${id}\`]`;
+}
+/**
+ * Where the task text comes from: an inline string, or a file the caller wrote.
+ *
+ * `task_file` exists because the wrapper agent is a small model relaying
+ * arguments, and it paraphrases — a ~3K step-by-step spec once reached the
+ * harness as a one-line summary. A path cannot be paraphrased: it either
+ * arrives intact or the dispatch fails loudly. Prose asking a model not to
+ * summarise is a request; this is a mechanism.
+ *
+ * Exactly one of the two, because silently preferring one when both are given
+ * would let a paraphrased `task` win over the file the caller meant.
+ */
+export function resolveTaskFile(args, cwd) {
+    const inline = typeof args.task === 'string' && args.task.length > 0;
+    const path = typeof args.task_file === 'string' && args.task_file.length > 0;
+    if (inline && path) {
+        throw new Error('sonata: give either "task" or "task_file", not both');
+    }
+    if (path) {
+        const resolved = resolve(cwd, args.task_file);
+        if (!existsSync(resolved)) {
+            throw new Error(`sonata: task_file "${args.task_file}" does not exist`);
+        }
+        // Copied rather than read-and-rewritten so the bytes the caller wrote are
+        // the bytes composeInstructions receives.
+        return resolved;
+    }
+    if (!inline) {
+        throw new Error('sonata: the "task" or "task_file" argument is required');
+    }
+    const tmp = join(tmpdir(), `sonata-task-${Date.now()}-${randomUUID().slice(0, 8)}.md`);
+    writeFileSync(tmp, args.task);
+    return tmp;
+}
+function need(args, key) {
+    const value = args[key];
+    if (typeof value !== 'string' || value.length === 0) {
+        throw new Error(`sonata: the "${key}" argument is required`);
+    }
+    return value;
+}
+export function resolveToolCwd(args, env) {
+    if (args.cwd === undefined)
+        return env.cwd;
+    if (typeof args.cwd !== 'string' || args.cwd.length === 0) {
+        throw new Error('sonata: the "cwd" argument must be a non-empty directory path');
+    }
+    const cwd = resolve(env.cwd, args.cwd);
+    try {
+        if (!statSync(cwd).isDirectory())
+            throw new Error('not a directory');
+    }
+    catch {
+        throw new Error(`sonata: requested cwd "${args.cwd}" does not exist or is not a directory`);
+    }
+    return cwd;
+}
+export async function callTool(name, args, env, onLines) {
+    switch (name) {
+        case 'dispatch': {
+            const role = need(args, 'role');
+            const model = need(args, 'model');
+            const cwd = resolveToolCwd(args, env);
+            const taskFile = resolveTaskFile(args, cwd);
+            const started = await (env.run ?? cmdRun)({
+                cwd,
+                role,
+                model,
+                taskFile,
+                rolesDir: env.rolesDir,
+                sessionId: env.sessionId,
+            });
+            const result = await (env.wait ?? cmdWait)({ cwd, id: started.id, onLines });
+            return JSON.stringify(withTranscript(withTrimmedReport(result), cwd, args));
+        }
+        case 'wait': {
+            const cwd = resolveToolCwd(args, env);
+            const result = await (env.wait ?? cmdWait)({ cwd, id: need(args, 'id'), onLines });
+            return JSON.stringify(withTranscript(withTrimmedReport(result), cwd, args));
+        }
+        case 'approve': {
+            const answer = need(args, 'answer');
+            if (answer !== 'yes' && answer !== 'no') {
+                throw new Error('sonata: the "answer" argument must be yes or no');
+            }
+            await (env.approve ?? cmdApprove)({
+                cwd: resolveToolCwd(args, env), id: need(args, 'id'), yes: answer === 'yes',
+            });
+            return 'answered';
+        }
+        default:
+            throw new Error(`sonata: unknown tool "${name}"`);
+    }
+}
+//# sourceMappingURL=tools.js.map

package/dist/mcp/tools.js.map

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

package/dist/mode.js

@@ -0,0 +1,64 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+const VALID = ['plan', 'default', 'acceptEdits', 'bypassPermissions'];
+/**
+ * Claude Code modes that sonata does not model directly, mapped to the closest
+ * mode it can actually enforce on a foreign harness.
+ *
+ * `auto` is Claude Code's current default: it runs tool calls its classifier
+ * judges lower-risk without prompting, and blocks the rest. Sonata cannot
+ * reproduce that classifier in another harness, so the honest equivalent is
+ * `acceptEdits` — work proceeds without prompting the user, which is what the
+ * parent session is doing too.
+ *
+ * Treating it as `default` instead — which is what an unrecognised value used
+ * to do — is wrong in both directions: it claims the parent prompts for every
+ * action when it does not, and since opencode cannot honour `default` at all,
+ * it silently made every opencode dispatch refuse.
+ *
+ * The residual gap is real and worth stating: the foreign harness has no
+ * classifier, so it will run things auto mode would have blocked. Dispatch in
+ * `plan` for a read-only run when that matters.
+ */
+const ALIASES = {
+    auto: 'acceptEdits',
+};
+/**
+ * Claude Code does not expose the permission mode as an environment variable.
+ * A PreToolUse hook writes it to .sonata/session-<id>.json; this reads it back.
+ * Falls back to the safest mode when unknown.
+ */
+/**
+ * `home` mirrors `loadConfig`: it is optional so existing callers keep working,
+ * and always injected in tests, which must never read the real home directory.
+ *
+ * The two locations match where the hook writes. A project with its own sonata
+ * setup keeps its mode beside it; a project relying on the machine config keeps
+ * its mode beside that, because the hook must not scatter `.sonata/`
+ * directories across every repository on the machine.
+ */
+export function readPermissionMode(cwd, sessionId, home = homedir()) {
+    if (!sessionId)
+        return 'default';
+    const candidates = [
+        join(cwd, '.sonata', `session-${sessionId}.json`),
+        join(home, '.config', 'sonata', `session-${sessionId}.json`),
+    ];
+    const path = candidates.find((p) => existsSync(p));
+    if (path === undefined)
+        return 'default';
+    try {
+        const parsed = JSON.parse(readFileSync(path, 'utf8'));
+        const raw = parsed.permissionMode;
+        if (!raw)
+            return 'default';
+        if (ALIASES[raw])
+            return ALIASES[raw];
+        return VALID.includes(raw) ? raw : 'default';
+    }
+    catch {
+        return 'default';
+    }
+}
+//# sourceMappingURL=mode.js.map

package/dist/mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode.js","sourceRoot":"","sources":["../src/mode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,MAAM,KAAK,GAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,mBAAmB,CAAC,CAAC;AAExF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,GAAmC;IAC9C,IAAI,EAAE,aAAa;CACpB,CAAC;AAEF;;;;GAIG;AACH;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,GAAW,EACX,SAA6B,EAC7B,OAAe,OAAO,EAAE;IAExB,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IACjC,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,WAAW,SAAS,OAAO,CAAC;QACjD,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,SAAS,OAAO,CAAC;KAC7D,CAAC;IACF,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACnD,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAgC,CAAC;QACrF,MAAM,GAAG,GAAG,MAAM,CAAC,cAAc,CAAC;QAClC,IAAI,CAAC,GAAG;YAAE,OAAO,SAAS,CAAC;QAC3B,IAAI,OAAO,CAAC,GAAG,CAAC;YAAE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;QACtC,OAAO,KAAK,CAAC,QAAQ,CAAC,GAAqB,CAAC,CAAC,CAAC,CAAE,GAAsB,CAAC,CAAC,CAAC,SAAS,CAAC;IACrF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}