@zhihaohong52/sonata 0.4.0

package/dist/detect.js

@@ -0,0 +1,445 @@
+/**
+ * Environment detection for `sonata init` and `sonata doctor`.
+ *
+ * Parsing is separated from process execution so the interesting logic can be
+ * tested against real fixture files rather than a live machine.
+ */
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { existsSync, readFileSync, readdirSync, unlinkSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { checkVersion } from './commands/doctor.js';
+import { TIER_AGENT_MARKER } from './agent-markers.js';
+import { parsePiRefs } from './adapters/pi.js';
+import { parseCodexModels, codexModelList } from './adapters/codex.js';
+import { parseReasonixRefs, reasonixDoctorJson } from './adapters/reasonix.js';
+const run = promisify(execFile);
+export function parseOpenCodeModels(text) {
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const [provider, def] of Object.entries(parsed?.provider ?? {})) {
+        for (const [id, model] of Object.entries(def?.models ?? {})) {
+            out.push({ provider, id, name: model?.name });
+        }
+    }
+    return out;
+}
+// Well-known provider endpoints, merged from:
+// - https://opencode.ai/docs/providers/ (opencode's built-in providers)
+// - litellm.openai_compatible_endpoints (litellm's authoritative list)
+// - https://docs.litellm.ai/docs/providers (litellm docs)
+// Custom/self-hosted provider URLs are discovered from harness configs.
+export const WELL_KNOWN_PROVIDER_URLS = {
+    // OpenAI ecosystem
+    'openai': 'https://api.openai.com/v1',
+    'openai-codex': 'https://api.openai.com/v1',
+    'codex': 'https://api.openai.com/v1',
+    // OpenCode's own gateways
+    'opencode': 'https://api.opencode.ai/v1',
+    'opencode-go': 'https://opencode.ai/zen/go/v1',
+    // Major providers
+    'anthropic': 'https://api.anthropic.com/v1',
+    'deepseek': 'https://api.deepseek.com/v1',
+    'google': 'https://generativelanguage.googleapis.com/v1beta',
+    'mistral': 'https://api.mistral.ai/v1',
+    'xai': 'https://api.x.ai/v1',
+    'meta_llama': 'https://api.llama.com/compat/v1',
+    // Aggregators / routers
+    'openrouter': 'https://openrouter.ai/api/v1',
+    // Inference providers
+    'groq': 'https://api.groq.com/openai/v1',
+    'together': 'https://api.together.xyz/v1',
+    'together_ai': 'https://api.together.xyz/v1',
+    'fireworks': 'https://api.fireworks.ai/inference/v1',
+    'fireworks_ai': 'https://api.fireworks.ai/inference/v1',
+    'cerebras': 'https://api.cerebras.ai/v1',
+    'deep-infra': 'https://api.deepinfra.com/v1',
+    'deepinfra': 'https://api.deepinfra.com/v1/openai',
+    'sambanova': 'https://api.sambanova.ai/v1',
+    'nebius': 'https://api.studio.nebius.ai/v1',
+    'lambda_ai': 'https://api.lambda.ai/v1',
+    'hyperbolic': 'https://api.hyperbolic.xyz/v1',
+    'perplexity': 'https://api.perplexity.ai',
+    'nvidia_nim': 'https://integrate.api.nvidia.com/v1',
+    'featherless_ai': 'https://api.featherless.ai/v1',
+    'novita': 'https://api.novita.ai/v3/openai',
+    'nscale': 'https://inference.api.nscale.com/v1',
+    // Other known providers
+    'moonshot': 'https://api.moonshot.ai/v1',
+    'dashscope': 'https://dashscope-intl.aliyuncs.com/compatible-mode/v1',
+    'galadriel': 'https://api.galadriel.ai/v1',
+    'friendliai': 'https://api.friendli.ai/serverless/v1',
+    'chutes': 'https://llm.chutes.ai/v1',
+    'empower': 'https://app.empower.dev/api/v1',
+    'morph': 'https://api.morphllm.com/v1',
+};
+export function parseOpenCodeProviderBaseUrls(text) {
+    // Start with well-known defaults — opencode's built-in providers are not
+    // listed in the config file at all, so iterating config entries alone misses
+    // every standard provider.
+    const out = { ...WELL_KNOWN_PROVIDER_URLS };
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        return out;
+    }
+    for (const [provider, def] of Object.entries(parsed?.provider ?? {})) {
+        const baseUrl = def?.options?.baseURL;
+        if (typeof baseUrl === 'string' && baseUrl.trim() !== '') {
+            out[provider] = baseUrl;
+        }
+    }
+    return out;
+}
+export function parseAuthedProviders(text) {
+    try {
+        return Object.keys(JSON.parse(text) ?? {});
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Parses `opencode models`, which prints one `provider/model` ref per line —
+ * exactly the string `-m` accepts.
+ */
+export function parseOpenCodeRefs(stdout) {
+    const out = [];
+    for (const raw of stdout.split('\n')) {
+        const line = raw.trim();
+        const slash = line.indexOf('/');
+        // A ref needs a non-empty provider and a non-empty id either side.
+        if (slash <= 0 || slash === line.length - 1)
+            continue;
+        out.push({
+            harness: 'opencode',
+            provider: line.slice(0, slash),
+            id: line.slice(slash + 1),
+            ref: line,
+        });
+    }
+    return out;
+}
+/**
+ * OpenCode's free tier needs no auth entry, so it is offered alongside the
+ * authenticated providers.
+ */
+const FREE_OPENCODE_PROVIDERS = ['opencode'];
+/**
+ * Groups refs into picker rows.
+ *
+ * The auth filter applies to opencode only. `pi --list-models` lists just the
+ * models pi can actually run — that is what piHealth relies on when it treats
+ * an empty list as "no usable provider" — so filtering pi by an auth file
+ * would invent a concept pi does not have.
+ */
+export function offerableProviders(refs, authed) {
+    const allowed = new Set([...authed, ...FREE_OPENCODE_PROVIDERS]);
+    const counts = new Map();
+    for (const ref of refs) {
+        if (ref.harness === 'opencode' && !allowed.has(ref.provider))
+            continue;
+        const key = `${ref.harness}/${ref.provider}`;
+        const seen = counts.get(key);
+        if (seen)
+            seen.count += 1;
+        else
+            counts.set(key, { harness: ref.harness, provider: ref.provider, count: 1, key });
+    }
+    return [...counts.values()].sort((a, b) => a.key.localeCompare(b.key));
+}
+/** Agent files that sonata generated but the current config no longer covers. */
+export function staleAgents(agentsDir, expected) {
+    if (!existsSync(agentsDir))
+        return [];
+    const wanted = new Set(expected.map((n) => `${n}.md`));
+    return readdirSync(agentsDir)
+        .filter((f) => f.endsWith('.md'))
+        .filter((f) => isSonataAgent(join(agentsDir, f)))
+        .filter((f) => !wanted.has(f))
+        .sort();
+}
+export function isSonataAgent(path) {
+    try {
+        const text = readFileSync(path, 'utf8');
+        return text.includes('forwarding wrapper around the sonata runtime')
+            || text.includes(TIER_AGENT_MARKER)
+            || /^name:\s+native-[^\s]+/m.test(text);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Deletes the named agent files, returning those actually removed.
+ *
+ * Takes an explicit list rather than recomputing, so the files shown to a user
+ * are exactly the files deleted — there is no window in which the set changes
+ * between the question and the deletion.
+ */
+export function pruneAgents(agentsDir, files) {
+    const removed = [];
+    for (const f of files) {
+        try {
+            unlinkSync(join(agentsDir, f));
+            removed.push(f);
+        }
+        catch {
+            // Already gone. A concurrent sync is a race, not a failure.
+        }
+    }
+    return removed;
+}
+async function tryRun(cmd, args, env) {
+    try {
+        const { stdout } = await run(cmd, args, { env: env ?? process.env });
+        return stdout.trim();
+    }
+    catch {
+        return null;
+    }
+}
+/** Like `tryRun`, but bounded — a hung provider must not stall `init`. */
+async function tryRunLimited(cmd, args, env, ms) {
+    try {
+        const { stdout } = await run(cmd, args, { env, timeout: ms });
+        return stdout.trim();
+    }
+    catch {
+        return null;
+    }
+}
+export async function detectTmux() {
+    const out = await tryRun('tmux', ['-V']);
+    if (out === null) {
+        return {
+            installed: false,
+            problems: [{
+                    severity: 'error',
+                    message: 'tmux is not installed — sonata runs every harness inside a tmux session',
+                    fix: 'brew install tmux',
+                }],
+        };
+    }
+    return { installed: true, version: out.replace(/^tmux\s+/, ''), problems: [] };
+}
+export async function detectOpenCode(env) {
+    const problems = [];
+    const localBin = join(env.home, '.opencode', 'bin', 'opencode');
+    const path = `${join(env.home, '.opencode', 'bin')}:${process.env.PATH ?? ''}`;
+    const version = await tryRun('opencode', ['--version'], { ...process.env, PATH: path });
+    if (version === null) {
+        return {
+            name: 'opencode',
+            installed: false,
+            supported: false,
+            refs: [],
+            authedProviders: [],
+            problems: [{
+                    severity: 'error',
+                    message: 'opencode is not installed',
+                    fix: 'curl -fsSL https://opencode.ai/install | bash',
+                }],
+        };
+    }
+    const supported = checkVersion(version, env.supportedVersions);
+    if (!supported) {
+        problems.push({
+            severity: 'warn',
+            message: `opencode ${version} is outside the tested range ${env.supportedVersions}`,
+            fix: 'Prompt detection may misbehave; upgrade or pin a tested version.',
+        });
+    }
+    const listing = await tryRun('opencode', ['models'], { ...process.env, PATH: path });
+    const refs = listing === null ? [] : parseOpenCodeRefs(listing);
+    // The CLI emits no display names; the config has them for custom providers.
+    const configPath = join(env.home, '.config', 'opencode', 'opencode.json');
+    const configText = existsSync(configPath) ? readFileSync(configPath, 'utf8') : '';
+    const named = configText === '' ? [] : parseOpenCodeModels(configText);
+    for (const ref of refs) {
+        ref.name = named.find((m) => m.provider === ref.provider && m.id === ref.id)?.name;
+    }
+    const providerBaseUrls = parseOpenCodeProviderBaseUrls(configText);
+    const authPath = join(env.home, '.local', 'share', 'opencode', 'auth.json');
+    const authedProviders = existsSync(authPath)
+        ? parseAuthedProviders(readFileSync(authPath, 'utf8'))
+        : [];
+    if (refs.length === 0) {
+        problems.push({
+            severity: 'error',
+            message: 'opencode reported no models',
+            fix: 'opencode auth login',
+        });
+    }
+    return {
+        name: 'opencode',
+        installed: true,
+        version,
+        supported,
+        binPath: existsSync(localBin) ? localBin : 'opencode',
+        refs,
+        authedProviders,
+        providerBaseUrls,
+        problems,
+    };
+}
+export async function detectPi(env) {
+    const path = `${join(env.home, '.local', 'bin')}:${process.env.PATH ?? ''}`;
+    const version = await tryRun('pi', ['--version'], { ...process.env, PATH: path });
+    // Absence is not an error. A machine with only opencode is normal.
+    if (version === null) {
+        return { name: 'pi', installed: false, supported: false, refs: [], authedProviders: [], problems: [] };
+    }
+    // Pi can block when a provider is unreachable, and doctor must never hang.
+    const listing = await tryRunLimited('pi', ['--list-models'], { ...process.env, PATH: path }, 5_000);
+    const problems = [];
+    if (listing === null) {
+        problems.push({
+            severity: 'warn',
+            message: 'pi is installed but did not list any models',
+            fix: 'pi auth check --provider <name>',
+        });
+    }
+    return {
+        name: 'pi',
+        installed: true,
+        version,
+        supported: true,
+        refs: listing === null ? [] : parsePiRefs(listing),
+        authedProviders: [],
+        problems,
+    };
+}
+/**
+ * Codex, discovered through `codex app-server`'s `model/list`.
+ *
+ * Codex has no provider dimension, so every model lands under the single
+ * pseudo-provider `codex`. An install that is present but not logged in lists
+ * nothing, which is reported as a warning rather than an error: a machine with
+ * only opencode is normal.
+ */
+export async function detectCodex(env) {
+    const version = await tryRun('codex', ['--version'], process.env);
+    if (version === null) {
+        return { name: 'codex', installed: false, supported: false, refs: [], authedProviders: [], problems: [] };
+    }
+    const listing = await codexModelList();
+    const refs = listing === null ? [] : parseCodexModels(listing);
+    const problems = [];
+    if (refs.length === 0) {
+        problems.push({
+            severity: 'warn',
+            message: 'codex is installed but listed no models',
+            fix: 'codex login',
+        });
+    }
+    return {
+        name: 'codex',
+        installed: true,
+        version,
+        supported: true,
+        refs,
+        // Codex has one account rather than per-provider auth; listing models at
+        // all is the evidence that it is usable.
+        authedProviders: refs.length > 0 ? ['codex'] : [],
+        problems,
+    };
+}
+/**
+ * Reasonix, discovered through `reasonix doctor --json`.
+ *
+ * There is no `models` subcommand, but `doctor --json` carries the provider
+ * catalogue and the per-provider key state in one call, so discovery and the
+ * auth check are the same request. `parseReasonixRefs` drops providers without
+ * a key, which is why an install that lists nothing is reported as a warning
+ * rather than an error: a machine with only opencode is normal.
+ */
+export async function detectReasonix(_env) {
+    const version = await tryRun('reasonix', ['--version'], process.env);
+    if (version === null) {
+        return { name: 'reasonix', installed: false, supported: false, refs: [], authedProviders: [], problems: [] };
+    }
+    const json = await reasonixDoctorJson();
+    const refs = json === null ? [] : parseReasonixRefs(json);
+    const problems = [];
+    if (refs.length === 0) {
+        problems.push({
+            severity: 'warn',
+            message: 'reasonix is installed but no provider has a usable API key',
+            fix: 'reasonix setup',
+        });
+    }
+    return {
+        name: 'reasonix',
+        installed: true,
+        version,
+        supported: true,
+        refs,
+        // `key_present` has already filtered these, so every provider that survived
+        // is one reasonix can actually run against.
+        authedProviders: [...new Set(refs.map((r) => r.provider))],
+        problems,
+    };
+}
+export async function detectHarnesses(env) {
+    return Promise.all([detectOpenCode(env), detectPi(env), detectCodex(env), detectReasonix(env)]);
+}
+/** Where opencode keeps its own configuration. */
+function opencodeConfigPath(home) {
+    return join(home, '.config', 'opencode', 'opencode.json');
+}
+function readOpencodeConfig(home) {
+    const path = opencodeConfigPath(home);
+    if (!existsSync(path))
+        return null;
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        // opencode's config is not sonata's to repair. An unreadable one is
+        // opencode's problem to report, not a reason for doctor to fail.
+        return null;
+    }
+}
+/**
+ * Agents the user's opencode config switches off.
+ *
+ * A disabled agent is not an error opencode reports: `opencode run --agent
+ * explore` falls back to the default agent with a warning in the pane that
+ * nothing parses. A read-only role then runs under the write-capable `build`,
+ * which is how sonata came to document an enforcement it did not have.
+ */
+export function disabledOpencodeAgents(home) {
+    const cfg = readOpencodeConfig(home);
+    const agents = (cfg?.agent ?? {});
+    return Object.entries(agents)
+        .filter(([, v]) => v?.disable === true)
+        .map(([name]) => name);
+}
+/**
+ * Switches one opencode agent back on, returning whether anything changed.
+ *
+ * This writes another tool's configuration, so it changes exactly one field
+ * and leaves the rest of the document alone. It never creates a config that
+ * was not already there.
+ */
+export function enableOpencodeAgent(home, name) {
+    const path = opencodeConfigPath(home);
+    const cfg = readOpencodeConfig(home);
+    if (cfg === null)
+        return false;
+    if (cfg.agent?.[name]?.disable !== true)
+        return false;
+    cfg.agent[name].disable = false;
+    writeFileSync(path, `${JSON.stringify(cfg, null, 2)}\n`);
+    return true;
+}
+//# sourceMappingURL=detect.js.map

package/dist/detect.js.map

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

package/dist/filelock.js

@@ -0,0 +1,83 @@
+/**
+ * A mkdir-based lockfile mutex, shared by the route and usage systems that do
+ * read-modify-write on a JSON file from separate processes.
+ *
+ * Two `SessionStart` hooks can fire near-simultaneously (a user can launch
+ * sessions in different projects around the same time). If their updates to a
+ * shared file each did a plain `load`-then-`write`, one's write would silently
+ * clobber the other's — neither ever sees the other's in-flight change. This
+ * serialises those updates so the read-modify-write is atomic across processes.
+ *
+ * The lock is the creation of a sibling `<file>.lock` directory (mkdir is
+ * atomic): the winner of `mkdirSync` owns the lock. The loser polls until the
+ * owner removes it, giving up after 2s; a lock older than 5s is treated as
+ * stale (the holder crashed) and reclaimed.
+ *
+ * A lock is a renewable lease, not a fixed claim. On winning, the holder writes
+ * a unique owner token into `<lock>/owner` and refreshes the lock's mtime every
+ * 2s (well under the 5s staleness threshold) for as long as `fn()` runs, so a
+ * holder that is legitimately slow — `route.ts` awaits `cmdRoute('on'/'off')`
+ * inside the lock — is never mistaken for a crash. When `fn()` finishes the
+ * holder only deletes the lock if `<lock>/owner` still holds *its own* token:
+ * if another process reclaimed it in the meantime (a stale lock the holder
+ * failed to renew), that process's live lock is left alone.
+ */
+import { mkdirSync, rmSync, statSync, writeFileSync, readFileSync, utimesSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+const RENEW_INTERVAL_MS = 2000;
+export async function withSessionLock(file, fn) {
+    const lock = `${file}.lock`;
+    const ownerPath = join(lock, 'owner');
+    mkdirSync(dirname(file), { recursive: true });
+    const deadline = Date.now() + 2000;
+    for (;;) {
+        try {
+            mkdirSync(lock);
+            break;
+        }
+        catch {
+            try {
+                const age = Date.now() - statSync(lock).mtimeMs;
+                if (age > 5000)
+                    rmSync(lock, { recursive: true, force: true });
+            }
+            catch { /* raced with the holder releasing it */ }
+            if (Date.now() > deadline) {
+                throw new Error(`sonata: timed out waiting for lock on ${file}`);
+            }
+            await new Promise((r) => setTimeout(r, 25));
+        }
+    }
+    const token = randomUUID();
+    writeFileSync(ownerPath, token);
+    let timer;
+    const renew = () => {
+        try {
+            // Someone else owns it now (a reclaim wrote their token): stop touching
+            // their lock, or we would keep it alive on their behalf.
+            if (readFileSync(ownerPath, 'utf8') !== token) {
+                clearInterval(timer);
+                return;
+            }
+            utimesSync(lock, new Date(), new Date());
+        }
+        catch { /* lock gone — nothing left to renew */
+            clearInterval(timer);
+        }
+    };
+    timer = setInterval(renew, RENEW_INTERVAL_MS);
+    try {
+        return await fn();
+    }
+    finally {
+        clearInterval(timer);
+        try {
+            if (readFileSync(ownerPath, 'utf8') === token) {
+                rmSync(lock, { recursive: true, force: true });
+            }
+        }
+        catch { /* already gone */ }
+    }
+}
+//# sourceMappingURL=filelock.js.map

package/dist/filelock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filelock.js","sourceRoot":"","sources":["../src/filelock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC/F,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAE/B,MAAM,CAAC,KAAK,UAAU,eAAe,CAAI,IAAY,EAAE,EAAwB;IAC7E,MAAM,IAAI,GAAG,GAAG,IAAI,OAAO,CAAC;IAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACtC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;IACnC,SAAS,CAAC;QACR,IAAI,CAAC;YACH,SAAS,CAAC,IAAI,CAAC,CAAC;YAChB,MAAM;QACR,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC;gBAChD,IAAI,GAAG,GAAG,IAAI;oBAAE,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACjE,CAAC;YAAC,MAAM,CAAC,CAAC,wCAAwC,CAAC,CAAC;YACpD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CAAC,yCAAyC,IAAI,EAAE,CAAC,CAAC;YACnE,CAAC;YACD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;IAC3B,aAAa,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAEhC,IAAI,KAAqC,CAAC;IAC1C,MAAM,KAAK,GAAG,GAAS,EAAE;QACvB,IAAI,CAAC;YACH,wEAAwE;YACxE,yDAAyD;YACzD,IAAI,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,KAAK,EAAE,CAAC;gBAC9C,aAAa,CAAC,KAAK,CAAC,CAAC;gBACrB,OAAO;YACT,CAAC;YACD,UAAU,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC,CAAC,uCAAuC;YAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAAC,CAAC;IAC3E,CAAC,CAAC;IACF,KAAK,GAAG,WAAW,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;IAE9C,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;YAAS,CAAC;QACT,aAAa,CAAC,KAAK,CAAC,CAAC;QACrB,IAAI,CAAC;YACH,IAAI,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,KAAK,EAAE,CAAC;gBAC9C,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;IAChC,CAAC;AACH,CAAC"}

package/dist/init/apply.js

@@ -0,0 +1,96 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { installHook, allowSonataTools, hookCommand, readSettings, settingsPath, writeSettings, } from '../settings.js';
+import { pruneAgents } from '../detect.js';
+import { cmdSync } from '../commands/sync.js';
+import { cmdRoute } from '../commands/route.js';
+import { writeSonataKey } from '../native/credentials.js';
+export async function apply(plan, opts, io) {
+    const { cwd, home, packageRoot } = opts;
+    // ---- credentials (first, so a partially-failed run still leaves keys behind) ----
+    // Keys typed in the wizard are stored here and nowhere earlier: a cancelled
+    // run must leave no credential behind. The gateway is printed, never the key.
+    for (const { gateway, key } of plan.keysToStore) {
+        writeSonataKey(home, gateway, key);
+        io.out(`  ✓ stored the key for ${gateway}`);
+    }
+    // ---- config ----
+    mkdirSync(dirname(plan.configPath), { recursive: true });
+    writeFileSync(plan.configPath, plan.configToml);
+    io.out(`  ✓ wrote ${plan.configPath}`);
+    // ---- settings (hook + allow-list) ----
+    let hookChanged = false;
+    // `runInit` resolves `allowListScope` against `env.existingHookScope`
+    // (an upgrade from the MCP-based release otherwise keeps its old
+    // mcp__sonata__* entries forever, since "hook already installed" used to
+    // mean skipping this whole block) and writes the result onto the plan.
+    if (plan.hook.allowListScope !== undefined && plan.hook.allowListScope !== 'skip') {
+        const allowListScope = plan.hook.allowListScope;
+        const path = settingsPath(allowListScope, cwd, home);
+        const cmd = hookCommand(packageRoot);
+        const withHook = plan.hook.scope !== 'skip'
+            ? installHook(readSettings(path), cmd)
+            : { settings: readSettings(path), changed: false };
+        const withAllow = allowSonataTools(withHook.settings);
+        if (withHook.changed || withAllow.changed)
+            writeSettings(path, withAllow.settings);
+        hookChanged = withHook.changed;
+        if (plan.hook.scope !== 'skip') {
+            io.out(withHook.changed ? `  ✓ installed hook in ${path}` : `  · hook already present in ${path}`);
+        }
+        io.out(withAllow.changed
+            ? `  ✓ allow-listed the sonata tools in ${path}`
+            : `  · sonata tools already allow-listed in ${path}`);
+    }
+    // ---- skill ----
+    mkdirSync(dirname(plan.skillPath), { recursive: true });
+    const packageSkill = join(packageRoot, 'skills', 'loop', 'SKILL.md');
+    const skillSource = existsSync(packageSkill)
+        ? packageSkill
+        : join(process.cwd(), 'skills', 'loop', 'SKILL.md');
+    writeFileSync(plan.skillPath, readFileSync(skillSource));
+    io.out(`  ✓ installed loop skill in ${plan.skillPath}`);
+    // ---- routing ----
+    if (plan.routing !== 'skip') {
+        await cmdRoute('auto', {
+            cwd,
+            home,
+            packageRoot,
+            scope: plan.routing,
+        });
+        io.out(`  ✓ configured sonata route auto${plan.routing === 'global' ? ' --global' : ''}`);
+    }
+    // ---- sync (generates agent files) ----
+    const sync = cmdSync({ cwd: plan.syncCwd, home, agentsDir: plan.agentsDir });
+    const agentsWritten = sync.written;
+    io.out(`  ✓ generated ${agentsWritten.length} agents in ${plan.agentsDir}`);
+    if (sync.skipped.length > 0) {
+        io.out('');
+        io.out(`  ! ${sync.skipped.length} existing agent file(s) were NOT overwritten (not sonata-generated):`);
+        for (const f of sync.skipped.slice(0, 5))
+            io.out(`      ${f}`);
+        if (sync.skipped.length > 5)
+            io.out(`      … and ${sync.skipped.length - 5} more`);
+    }
+    // ---- prune (after sync, since stale files are only known now) ----
+    const stale = sync.stale;
+    let pruned = [];
+    if (stale.length > 0) {
+        io.out('');
+        io.out(`  ! ${stale.length} stale agent file(s) no longer in your config:`);
+        for (const f of stale.slice(0, 5))
+            io.out(`      ${f}`);
+        if (stale.length > 5)
+            io.out(`      … and ${stale.length - 5} more`);
+        const remove = typeof io.prune === 'function' ? await io.prune(stale) : io.prune;
+        if (remove) {
+            pruned = pruneAgents(plan.agentsDir, stale);
+            io.out(`  ✓ removed ${pruned.length} stale agent file(s)`);
+        }
+        else {
+            io.out('      ❯ delete them by hand, or re-run with --prune');
+        }
+    }
+    return { agentsWritten, pruned, hookChanged };
+}
+//# sourceMappingURL=apply.js.map

package/dist/init/apply.js.map

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