@atomic-chat/core 0.5.1

package/dist/integrations/configure/zcode.js

@@ -0,0 +1,260 @@
+/**
+ * ZCode (github.com/zai-org/ZCode) is Z.ai's Electron desktop app. It ignores `OPENAI_BASE_URL` and
+ * friends: the only source of custom providers is `<dataBase>/.zcode/v2/provider_config.json`,
+ * shared by the desktop app, its web UI and its CLI, and polled once a second — so writing that file
+ * is the whole integration, and a running ZCode picks the change up by itself. Port of
+ * `configure_zcode` in the app's `core/system/commands.rs` (commit `ec1fd3ea7`).
+ *
+ * The file is validated with strict Zod schemas, and an invalid file is not rejected loudly: ZCode
+ * treats it as empty, so every custom provider the user has silently disappears until it is fixed.
+ * Hence the care below — patch only the entries we own, refuse rather than guess on anything
+ * unexpected, and write under ZCode's own lock with a rename.
+ */
+import { mkdir, readdir, realpath, rm, rmdir, stat, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { AtomicCoreError } from '../../contracts/index.js';
+import { canonicalJson } from '../config-io.js';
+import { registerWriter } from './registry.js';
+/** Provider id we own inside `provider_config.json`; personal ids may be anything but `account:*`. */
+export const ZCODE_PROVIDER_ID = 'atomic-chat';
+const ZCODE_PROVIDER_NAME = 'Atomic Chat';
+/** ZCode only admits a provider whose API key is non-blank; the local server ignores it when auth is off. */
+export const ZCODE_KEY_PLACEHOLDER = 'atomic';
+/**
+ * ZCode assumes 200K of context for any model it does not recognise — a wild over-claim for a local
+ * model, which then never compacts and overflows mid-turn.
+ */
+export const ZCODE_CONTEXT_WINDOW = 65_536;
+const ZCODE_MAX_OUTPUT_TOKENS = 8_192;
+/**
+ * ZCode's default request mapping sends `thinking`, `enable_thinking`, `reasoning_effort` and
+ * `reasoning`, none of which llama-server reads. It does read `chat_template_kwargs`, and
+ * `enable_thinking` is the switch the Qwen3 / GLM / DeepSeek templates expose.
+ */
+export const ZCODE_REASONING_MAP = '{"chat_template_kwargs": {"enable_thinking": reasoningLevel == "enabled"}}';
+/** `max_completion_tokens` (ZCode's default) is OpenAI-only; `max_tokens` is what local backends read. */
+const ZCODE_MAX_TOKENS_MAP = "{'max_tokens': maxOutputTokens}";
+/** ZCode's own writers wait up to 8 s for the lock. */
+export const ZCODE_LOCK_MAX_WAIT_MS = 8_000;
+/** A ZCode write holds the lock for milliseconds; one this old was left by a process that died. */
+export const ZCODE_LOCK_STALE_AFTER_MS = 60_000;
+const LOCK_RETRY_DELAYS_MS = [25, 50, 100, 200, 400];
+const refuse = (message, details) => new AtomicCoreError('IO_ERROR', message, details);
+const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/**
+ * ZCode's `.zcode/v2` directory, resolved the way the desktop app does it: `dataBaseDir` from
+ * `~/.zcode/v2/setting.json` (set when the user moves the data folder in ZCode), then
+ * `$ZCODE_DATA_BASE_DIR`, then home. Absolute.
+ */
+export async function zcodeConfigDir(fs, envBase) {
+    let fromSetting;
+    const text = await fs.read('.zcode/v2/setting.json');
+    if (text !== undefined) {
+        try {
+            const parsed = JSON.parse(text);
+            const dir = isObject(parsed) ? parsed['dataBaseDir'] : undefined;
+            if (typeof dir === 'string' && dir.trim() !== '')
+                fromSetting = dir.trim();
+        }
+        catch {
+            // An unreadable setting.json is ZCode's to repair; its default location still applies.
+        }
+    }
+    const fromEnv = envBase?.trim() ? envBase.trim() : undefined;
+    return join(fromSetting ?? fromEnv ?? fs.home, '.zcode', 'v2');
+}
+/** `parent[key]` as an array, created when absent; a value of another type is refused, never replaced. */
+function arrayAt(parent, key, path) {
+    if (parent[key] === undefined)
+        parent[key] = [];
+    const value = parent[key];
+    if (!Array.isArray(value))
+        throw refuse(`${path} in provider_config.json is not an array`);
+    return value;
+}
+/** `parent[key]` as an object, created when absent. */
+function objectAt(parent, key, path) {
+    if (parent[key] === undefined)
+        parent[key] = {};
+    const value = parent[key];
+    if (!isObject(value))
+        throw refuse(`${path} in provider_config.json is not an object`);
+    return value;
+}
+const isOurs = (rule) => isObject(rule) && rule['providerId'] === ZCODE_PROVIDER_ID;
+/**
+ * Apply Atomic Chat's provider, its model rule and the default selection to a parsed
+ * `provider_config.json` (`undefined` when the file does not exist yet). Only entries whose
+ * `providerId` is ours are replaced; every other provider, rule and key is carried over untouched.
+ */
+export function zcodePatchProviderConfig(existing, apiUrl, model, apiKey) {
+    const modelId = model.trim();
+    if (modelId === '')
+        throw new AtomicCoreError('INVALID_ARGUMENT', 'ZCode needs a model: load one in a chat first.');
+    const key = apiKey?.trim() ? apiKey.trim() : ZCODE_KEY_PLACEHOLDER;
+    const root = existing === undefined ? { schemaVersion: 1 } : structuredClone(existing);
+    if (!isObject(root))
+        throw refuse('provider_config.json is not a JSON object');
+    // ZCode refuses a file without a version, and one newer than it knows. We know exactly one shape.
+    const version = root['schemaVersion'];
+    if (version === undefined || typeof version !== 'number' || !Number.isInteger(version) || version < 0)
+        throw refuse("ZCode's provider_config.json has no schemaVersion, so ZCode is ignoring it. Open Model Settings in ZCode to repair it, then try again.");
+    if (version !== 1)
+        throw refuse(`ZCode's provider_config.json uses schemaVersion ${version}, which this version of Atomic Chat does not know. Update Atomic Chat, or add the provider in ZCode's Model Settings.`);
+    const config = objectAt(root, 'config', 'config');
+    const provider = {
+        providerId: ZCODE_PROVIDER_ID,
+        providerName: ZCODE_PROVIDER_NAME,
+        enabled: true,
+        config: {
+            group: 'standard-personal',
+            access: { type: 'api-key', apiKey: key },
+            api: { type: 'openai-chat-completions', baseUrl: apiUrl, headers: null },
+            // Local servers expose no catalogue ZCode can discover: the provider lists the model Run was
+            // pressed for.
+            personalModelIds: [modelId],
+            modelOrder: [modelId],
+        },
+    };
+    const providerRules = arrayAt(objectAt(config, 'providerConfigRules', 'config.providerConfigRules'), 'providerRules', 'config.providerConfigRules.providerRules');
+    const existingAt = providerRules.findIndex(isOurs);
+    if (existingAt >= 0)
+        providerRules[existingAt] = provider;
+    else
+        providerRules.push(provider);
+    // `providerOrder` is optional and ZCode appends unlisted providers itself; only an existing list
+    // needs us added — at the top, where Run expects us.
+    if (config['providerOrder'] !== undefined) {
+        const order = arrayAt(config, 'providerOrder', 'config.providerOrder');
+        if (!order.includes(ZCODE_PROVIDER_ID))
+            order.unshift(ZCODE_PROVIDER_ID);
+    }
+    const modelRules = objectAt(config, 'modelConfigRules', 'config.modelConfigRules');
+    // ZCode rejects the whole file when one provider/model pair has both a regular and a manual rule,
+    // and its Advanced model settings write manual ones: drop ours from both lists first.
+    const manual = arrayAt(modelRules, 'manualProviderModelRules', 'config.modelConfigRules.manualProviderModelRules');
+    modelRules['manualProviderModelRules'] = manual.filter((rule) => !isOurs(rule));
+    const rules = arrayAt(modelRules, 'providerModelRules', 'config.modelConfigRules.providerModelRules');
+    modelRules['providerModelRules'] = [
+        ...rules.filter((rule) => !isOurs(rule)),
+        {
+            providerId: ZCODE_PROVIDER_ID,
+            modelId,
+            config: {
+                properties: {
+                    contextWindow: ZCODE_CONTEXT_WINDOW,
+                    // An id matching one of ZCode's vision patterns would otherwise claim image input.
+                    inputFormat: { supportsImage: false },
+                },
+                optionSpecs: {
+                    maxOutputTokens: { max: ZCODE_MAX_OUTPUT_TOKENS, map: ZCODE_MAX_TOKENS_MAP },
+                    reasoningLevel: { values: ['disabled', 'enabled'], map: ZCODE_REASONING_MAP },
+                },
+            },
+        },
+    ];
+    // A selection names a reasoning level the model allows; `enabled` is what ZCode itself picks.
+    config['defaultModelSelection'] = {
+        providerId: ZCODE_PROVIDER_ID,
+        modelId,
+        options: { reasoningLevel: 'enabled' },
+    };
+    return root;
+}
+const errnoCode = (error) => error?.code;
+/** Whether a lock directory was left behind, judged by its newest entry; a future time reads as new. */
+async function lockIsStale(dir, staleAfterMs, now) {
+    let newest = await stat(dir).then((s) => s.mtimeMs, () => undefined);
+    const names = await readdir(dir).catch(() => []);
+    for (const name of names) {
+        const mtime = await stat(join(dir, name)).then((s) => s.mtimeMs, () => undefined);
+        if (mtime !== undefined)
+            newest = Math.max(newest ?? mtime, mtime);
+    }
+    return newest !== undefined && now - newest >= staleAfterMs;
+}
+/** Remove an abandoned lock directory; whether it is gone. */
+async function removeLock(dir) {
+    for (const name of await readdir(dir).catch(() => []))
+        await rm(join(dir, name), { force: true }).catch(() => { });
+    return rmdir(dir).then(() => true, () => false);
+}
+/**
+ * ZCode's lock around a config file (`packages/shared/src/node/atomicFileLock.ts`): a `<file>.lock`
+ * directory holding one `owner-<token>.json`. Taking it keeps a Run from interleaving with a save in
+ * ZCode's own settings. Resolves with the release.
+ */
+export async function acquireZcodeLock(file, maxWaitMs, staleAfterMs, deps = {}) {
+    const now = deps.now ?? Date.now;
+    const sleep = deps.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+    const dir = `${file}.lock`;
+    const started = now();
+    for (let attempt = 0;;) {
+        try {
+            await mkdir(dir);
+        }
+        catch (error) {
+            if (errnoCode(error) !== 'EEXIST')
+                throw refuse(`Failed to lock ${file}`, error instanceof Error ? error.message : String(error));
+            // A lock that cannot be removed falls through to the timeout instead of a tight loop.
+            if ((await lockIsStale(dir, staleAfterMs, now())) && (await removeLock(dir)))
+                continue;
+            if (now() - started >= maxWaitMs)
+                throw refuse('ZCode is saving its model settings right now. Try again in a moment.');
+            await sleep(LOCK_RETRY_DELAYS_MS[Math.min(attempt, LOCK_RETRY_DELAYS_MS.length - 1)]);
+            attempt += 1;
+            continue;
+        }
+        const createdAt = now();
+        const token = `${process.pid}-${createdAt}-atomic-chat`;
+        const owner = join(dir, `owner-${token}.json`);
+        const release = async () => {
+            await rm(owner, { force: true }).catch(() => { });
+            await rmdir(dir).catch(() => { });
+        };
+        try {
+            await writeFile(owner, `${JSON.stringify({ pid: process.pid, createdAt, token })}\n`);
+        }
+        catch (error) {
+            await release();
+            throw refuse(`Failed to write ${owner}`, error instanceof Error ? error.message : String(error));
+        }
+        return release;
+    }
+}
+/** The filesystem half of the writer, on a resolved `.zcode/v2` directory. */
+export async function configureZcodeIn(fs, dir, apiUrl, model, apiKey, lockDeps = {}) {
+    const path = join(dir, 'provider_config.json');
+    // ZCode imports the providers of its pre-3.x `config.json` once, on the first start that finds no
+    // `provider_config.json`. Creating that file first would skip the import for good.
+    if (!(await fs.exists(path)) && (await fs.exists(join(dir, 'config.json'))))
+        throw refuse('Open ZCode once so it can import your existing model providers, then click Run again.');
+    await fs.mkdirp(dir);
+    const release = await acquireZcodeLock(path, lockDeps.maxWaitMs ?? ZCODE_LOCK_MAX_WAIT_MS, lockDeps.staleAfterMs ?? ZCODE_LOCK_STALE_AFTER_MS, lockDeps);
+    try {
+        const text = (await fs.read(path)) ?? '';
+        let existing;
+        if (text.trim() !== '') {
+            try {
+                existing = JSON.parse(text);
+            }
+            catch (error) {
+                throw refuse(`Could not parse ${path}: ${error instanceof Error ? error.message : String(error)}. ZCode ignores the file while it is invalid, so fix or remove it and try again.`);
+            }
+        }
+        const patched = zcodePatchProviderConfig(existing, apiUrl, model, apiKey);
+        // A file ZCode cannot validate costs the user every custom provider, so keep the pre-Atomic
+        // version once. It holds their API keys too, hence owner-only like the file itself.
+        const backup = join(dir, 'provider_config.json.atomic-backup');
+        if (text.trim() !== '' && !(await fs.exists(backup)))
+            await fs.write(backup, text, { mode: 0o600 }).catch(() => { });
+        // Renaming onto a symlink would replace it with a regular file and detach a managed dotfile.
+        const target = await realpath(path).catch(() => path);
+        await fs.write(target, canonicalJson(patched), { mode: 0o600 });
+    }
+    finally {
+        await release();
+    }
+}
+registerWriter('zcode', async (input) => configureZcodeIn(input.fs, await zcodeConfigDir(input.fs, input.env['ZCODE_DATA_BASE_DIR']), input.apiUrl, input.model, input.apiKey));
+//# sourceMappingURL=zcode.js.map

package/dist/integrations/configure/zcode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zcode.js","sourceRoot":"","sources":["../../../src/integrations/configure/zcode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACvF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAE1D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAE9C,sGAAsG;AACtG,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAA;AAC9C,MAAM,mBAAmB,GAAG,aAAa,CAAA;AACzC,6GAA6G;AAC7G,MAAM,CAAC,MAAM,qBAAqB,GAAG,QAAQ,CAAA;AAC7C;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAA;AAC1C,MAAM,uBAAuB,GAAG,KAAK,CAAA;AACrC;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAC9B,4EAA4E,CAAA;AAC9E,0GAA0G;AAC1G,MAAM,oBAAoB,GAAG,iCAAiC,CAAA;AAC9D,uDAAuD;AACvD,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,CAAA;AAC3C,mGAAmG;AACnG,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAA;AAC/C,MAAM,oBAAoB,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;AAEpD,MAAM,MAAM,GAAG,CAAC,OAAe,EAAE,OAAgB,EAAE,EAAE,CAAC,IAAI,eAAe,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;AAIvG,MAAM,QAAQ,GAAG,CAAC,KAA4B,EAAuB,EAAE,CACrE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAEtE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,EAAY,EAAE,OAA2B;IAC5E,IAAI,WAA+B,CAAA;IACnC,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAA;IACpD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAA;YAC1C,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAmB,CAAC,CAAC,CAAC,CAAE,MAAqB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;YAC7F,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE;gBAAE,WAAW,GAAG,GAAG,CAAC,IAAI,EAAE,CAAA;QAC5E,CAAC;QAAC,MAAM,CAAC;YACP,uFAAuF;QACzF,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;IAC5D,OAAO,IAAI,CAAC,WAAW,IAAI,OAAO,IAAI,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAA;AAChE,CAAC;AAED,0GAA0G;AAC1G,SAAS,OAAO,CAAC,MAAkB,EAAE,GAAW,EAAE,IAAY;IAC5D,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS;QAAE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAA;IAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;IACzB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,MAAM,CAAC,GAAG,IAAI,0CAA0C,CAAC,CAAA;IAC1F,OAAO,KAAK,CAAA;AACd,CAAC;AAED,uDAAuD;AACvD,SAAS,QAAQ,CAAC,MAAkB,EAAE,GAAW,EAAE,IAAY;IAC7D,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS;QAAE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAA;IAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;IACzB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,MAAM,MAAM,CAAC,GAAG,IAAI,2CAA2C,CAAC,CAAA;IACtF,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,MAAM,GAAG,CAAC,IAAe,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,KAAK,iBAAiB,CAAA;AAE9F;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAA+B,EAC/B,MAAc,EACd,KAAa,EACb,MAA0B;IAE1B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAC5B,IAAI,OAAO,KAAK,EAAE;QAChB,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,gDAAgD,CAAC,CAAA;IACjG,MAAM,GAAG,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,qBAAqB,CAAA;IAElE,MAAM,IAAI,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAA;IACtF,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,MAAM,CAAC,2CAA2C,CAAC,CAAA;IAC9E,kGAAkG;IAClG,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,CAAA;IACrC,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC;QACnG,MAAM,MAAM,CACV,wIAAwI,CACzI,CAAA;IACH,IAAI,OAAO,KAAK,CAAC;QACf,MAAM,MAAM,CACV,mDAAmD,OAAO,uHAAuH,CAClL,CAAA;IACH,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAA;IAEjD,MAAM,QAAQ,GAAe;QAC3B,UAAU,EAAE,iBAAiB;QAC7B,YAAY,EAAE,mBAAmB;QACjC,OAAO,EAAE,IAAI;QACb,MAAM,EAAE;YACN,KAAK,EAAE,mBAAmB;YAC1B,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE;YACxC,GAAG,EAAE,EAAE,IAAI,EAAE,yBAAyB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE;YACxE,6FAA6F;YAC7F,eAAe;YACf,gBAAgB,EAAE,CAAC,OAAO,CAAC;YAC3B,UAAU,EAAE,CAAC,OAAO,CAAC;SACtB;KACF,CAAA;IACD,MAAM,aAAa,GAAG,OAAO,CAC3B,QAAQ,CAAC,MAAM,EAAE,qBAAqB,EAAE,4BAA4B,CAAC,EACrE,eAAe,EACf,0CAA0C,CAC3C,CAAA;IACD,MAAM,UAAU,GAAG,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IAClD,IAAI,UAAU,IAAI,CAAC;QAAE,aAAa,CAAC,UAAU,CAAC,GAAG,QAAQ,CAAA;;QACpD,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAEjC,iGAAiG;IACjG,qDAAqD;IACrD,IAAI,MAAM,CAAC,eAAe,CAAC,KAAK,SAAS,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,eAAe,EAAE,sBAAsB,CAAC,CAAA;QACtE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC;YAAE,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAC1E,CAAC;IAED,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,EAAE,kBAAkB,EAAE,yBAAyB,CAAC,CAAA;IAClF,kGAAkG;IAClG,sFAAsF;IACtF,MAAM,MAAM,GAAG,OAAO,CACpB,UAAU,EACV,0BAA0B,EAC1B,kDAAkD,CACnD,CAAA;IACD,UAAU,CAAC,0BAA0B,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;IAC/E,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,EAAE,oBAAoB,EAAE,4CAA4C,CAAC,CAAA;IACrG,UAAU,CAAC,oBAAoB,CAAC,GAAG;QACjC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACxC;YACE,UAAU,EAAE,iBAAiB;YAC7B,OAAO;YACP,MAAM,EAAE;gBACN,UAAU,EAAE;oBACV,aAAa,EAAE,oBAAoB;oBACnC,mFAAmF;oBACnF,WAAW,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE;iBACtC;gBACD,WAAW,EAAE;oBACX,eAAe,EAAE,EAAE,GAAG,EAAE,uBAAuB,EAAE,GAAG,EAAE,oBAAoB,EAAE;oBAC5E,cAAc,EAAE,EAAE,MAAM,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC,EAAE,GAAG,EAAE,mBAAmB,EAAE;iBAC9E;aACF;SACF;KACF,CAAA;IAED,8FAA8F;IAC9F,MAAM,CAAC,uBAAuB,CAAC,GAAG;QAChC,UAAU,EAAE,iBAAiB;QAC7B,OAAO;QACP,OAAO,EAAE,EAAE,cAAc,EAAE,SAAS,EAAE;KACvC,CAAA;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAOD,MAAM,SAAS,GAAG,CAAC,KAAc,EAAE,EAAE,CAAE,KAA2C,EAAE,IAAI,CAAA;AAExF,wGAAwG;AACxG,KAAK,UAAU,WAAW,CAAC,GAAW,EAAE,YAAoB,EAAE,GAAW;IACvE,IAAI,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAC/B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAChB,GAAG,EAAE,CAAC,SAAS,CAChB,CAAA;IACD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAc,CAAC,CAAA;IAC5D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAC5C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAChB,GAAG,EAAE,CAAC,SAAS,CAChB,CAAA;QACD,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,KAAK,EAAE,KAAK,CAAC,CAAA;IACpE,CAAC;IACD,OAAO,MAAM,KAAK,SAAS,IAAI,GAAG,GAAG,MAAM,IAAI,YAAY,CAAA;AAC7D,CAAC;AAED,8DAA8D;AAC9D,KAAK,UAAU,UAAU,CAAC,GAAW;IACnC,KAAK,MAAM,IAAI,IAAI,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAc,CAAC;QAC/D,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IAC5D,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CACpB,GAAG,EAAE,CAAC,IAAI,EACV,GAAG,EAAE,CAAC,KAAK,CACZ,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAY,EACZ,SAAiB,EACjB,YAAoB,EACpB,OAAsB,EAAE;IAExB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAA;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;IACrG,MAAM,GAAG,GAAG,GAAG,IAAI,OAAO,CAAA;IAC1B,MAAM,OAAO,GAAG,GAAG,EAAE,CAAA;IACrB,KAAK,IAAI,OAAO,GAAG,CAAC,IAAK,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,GAAG,CAAC,CAAA;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,QAAQ;gBAC/B,MAAM,MAAM,CAAC,kBAAkB,IAAI,EAAE,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;YAChG,sFAAsF;YACtF,IAAI,CAAC,MAAM,WAAW,CAAC,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC;gBAAE,SAAQ;YACtF,IAAI,GAAG,EAAE,GAAG,OAAO,IAAI,SAAS;gBAC9B,MAAM,MAAM,CAAC,sEAAsE,CAAC,CAAA;YACtF,MAAM,KAAK,CAAC,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,oBAAoB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAW,CAAC,CAAA;YAC/F,OAAO,IAAI,CAAC,CAAA;YACZ,SAAQ;QACV,CAAC;QACD,MAAM,SAAS,GAAG,GAAG,EAAE,CAAA;QACvB,MAAM,KAAK,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,SAAS,cAAc,CAAA;QACvD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,SAAS,KAAK,OAAO,CAAC,CAAA;QAC9C,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;YACzB,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;YAChD,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QAClC,CAAC,CAAA;QACD,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,CAAA;QACvF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,EAAE,CAAA;YACf,MAAM,MAAM,CAAC,mBAAmB,KAAK,EAAE,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;QAClG,CAAC;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,EAAY,EACZ,GAAW,EACX,MAAc,EACd,KAAa,EACb,MAA0B,EAC1B,WAA0E,EAAE;IAE5E,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,sBAAsB,CAAC,CAAA;IAC9C,kGAAkG;IAClG,mFAAmF;IACnF,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC;QACzE,MAAM,MAAM,CAAC,uFAAuF,CAAC,CAAA;IAEvG,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IACpB,MAAM,OAAO,GAAG,MAAM,gBAAgB,CACpC,IAAI,EACJ,QAAQ,CAAC,SAAS,IAAI,sBAAsB,EAC5C,QAAQ,CAAC,YAAY,IAAI,yBAAyB,EAClD,QAAQ,CACT,CAAA;IACD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAA;QACxC,IAAI,QAA+B,CAAA;QACnC,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAc,CAAA;YAC1C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,MAAM,CACV,mBAAmB,IAAI,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,kFAAkF,CACrK,CAAA;YACH,CAAC;QACH,CAAC;QACD,MAAM,OAAO,GAAG,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;QAEzE,4FAA4F;QAC5F,oFAAoF;QACpF,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,oCAAoC,CAAC,CAAA;QAC9D,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAClD,MAAM,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QAE/D,6FAA6F;QAC7F,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;QACrD,MAAM,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IACjE,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,EAAE,CAAA;IACjB,CAAC;AACH,CAAC;AAED,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CACtC,gBAAgB,CACd,KAAK,CAAC,EAAE,EACR,MAAM,cAAc,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,EAChE,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,KAAK,EACX,KAAK,CAAC,MAAM,CACb,CACF,CAAA"}

package/dist/integrations/configure/zed.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Zed — `~/.config/zed/settings.json`.
+ *
+ * Port of `configure_zed` in `src-tauri/src/core/system/commands.rs`. Zed keeps custom endpoints
+ * under `language_models.openai_compatible.<provider name>`, and the provider name doubles as the
+ * id the agent's default-model selector refers to, hence the space in `"Atomic Chat"`.
+ *
+ * Two things are deliberate:
+ *  - The API key is never persisted. Zed reads it from its keychain or from `ATOMIC_CHAT_API_KEY`,
+ *    so `apiKey` is accepted for call-site symmetry and ignored.
+ *  - Zed has no model discovery for these providers, so the running model is advertised
+ *    explicitly. With no model loaded the provider is still registered, with an empty model list,
+ *    so it shows up in Zed's UI — but `agent.default_model` is then left untouched.
+ */
+import type { ConfigureInput } from './registry.js';
+export declare function configureZed(input: ConfigureInput): Promise<void>;

package/dist/integrations/configure/zed.js

@@ -0,0 +1,61 @@
+/**
+ * Zed — `~/.config/zed/settings.json`.
+ *
+ * Port of `configure_zed` in `src-tauri/src/core/system/commands.rs`. Zed keeps custom endpoints
+ * under `language_models.openai_compatible.<provider name>`, and the provider name doubles as the
+ * id the agent's default-model selector refers to, hence the space in `"Atomic Chat"`.
+ *
+ * Two things are deliberate:
+ *  - The API key is never persisted. Zed reads it from its keychain or from `ATOMIC_CHAT_API_KEY`,
+ *    so `apiKey` is accepted for call-site symmetry and ignored.
+ *  - Zed has no model discovery for these providers, so the running model is advertised
+ *    explicitly. With no model loaded the provider is still registered, with an empty model list,
+ *    so it shows up in Zed's UI — but `agent.default_model` is then left untouched.
+ */
+import { AtomicCoreError } from '../../contracts/index.js';
+import { canonicalJson, parseJsonLenient } from '../config-io.js';
+import { asJsonObject } from './json-tree.js';
+import { registerWriter } from './registry.js';
+const DIR = '.config/zed';
+const PATH = `${DIR}/settings.json`;
+/** Map key under `openai_compatible`, and the provider id `agent.default_model` names. */
+const ZED_PROVIDER_ID = 'Atomic Chat';
+export async function configureZed(input) {
+    const { fs, apiUrl, model } = input;
+    await fs.mkdirp(DIR);
+    // Zed's settings.json allows comments and trailing commas, so read it the same way Zed does.
+    const text = await fs.read(PATH);
+    const parsed = text === undefined ? {} : parseJsonLenient(text, fs.absolute(PATH));
+    const root = asJsonObject(parsed);
+    if (!root)
+        throw new AtomicCoreError('IO_ERROR', 'settings.json is not a JSON object');
+    const languageModels = asJsonObject(root['language_models']) ?? {};
+    root['language_models'] = languageModels;
+    const compatible = asJsonObject(languageModels['openai_compatible']) ?? {};
+    languageModels['openai_compatible'] = compatible;
+    const availableModels = model === ''
+        ? []
+        : [
+            {
+                name: model,
+                display_name: model,
+                max_tokens: 32768,
+                max_output_tokens: 8192,
+                capabilities: {
+                    tools: true,
+                    images: true,
+                    parallel_tool_calls: false,
+                    prompt_cache_key: false,
+                },
+            },
+        ];
+    compatible[ZED_PROVIDER_ID] = { api_url: apiUrl, available_models: availableModels };
+    if (model !== '') {
+        const agent = asJsonObject(root['agent']) ?? {};
+        root['agent'] = agent;
+        agent['default_model'] = { provider: ZED_PROVIDER_ID, model };
+    }
+    await fs.write(PATH, canonicalJson(root));
+}
+registerWriter('zed', configureZed);
+//# sourceMappingURL=zed.js.map

package/dist/integrations/configure/zed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zed.js","sourceRoot":"","sources":["../../../src/integrations/configure/zed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE7C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAE9C,MAAM,GAAG,GAAG,aAAa,CAAA;AACzB,MAAM,IAAI,GAAG,GAAG,GAAG,gBAAgB,CAAA;AACnC,0FAA0F;AAC1F,MAAM,eAAe,GAAG,aAAa,CAAA;AAErC,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAqB;IACtD,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAA;IACnC,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAEpB,6FAA6F;IAC7F,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAChC,MAAM,MAAM,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;IAClF,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,CAAA;IACjC,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,oCAAoC,CAAC,CAAA;IAEtF,MAAM,cAAc,GAAG,YAAY,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,IAAI,EAAE,CAAA;IAClE,IAAI,CAAC,iBAAiB,CAAC,GAAG,cAAc,CAAA;IACxC,MAAM,UAAU,GAAG,YAAY,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC,IAAI,EAAE,CAAA;IAC1E,cAAc,CAAC,mBAAmB,CAAC,GAAG,UAAU,CAAA;IAEhD,MAAM,eAAe,GACnB,KAAK,KAAK,EAAE;QACV,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC;YACE;gBACE,IAAI,EAAE,KAAK;gBACX,YAAY,EAAE,KAAK;gBACnB,UAAU,EAAE,KAAK;gBACjB,iBAAiB,EAAE,IAAI;gBACvB,YAAY,EAAE;oBACZ,KAAK,EAAE,IAAI;oBACX,MAAM,EAAE,IAAI;oBACZ,mBAAmB,EAAE,KAAK;oBAC1B,gBAAgB,EAAE,KAAK;iBACxB;aACF;SACF,CAAA;IACP,UAAU,CAAC,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAA;IAEpF,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QACjB,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAA;QAC/C,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,CAAA;QACrB,KAAK,CAAC,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,eAAe,EAAE,KAAK,EAAE,CAAA;IAC/D,CAAC;IAED,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAA;AAC3C,CAAC;AAED,cAAc,CAAC,KAAK,EAAE,YAAY,CAAC,CAAA"}

package/dist/integrations/detect.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Is an agent's launcher on this machine, and what do we execute?
+ *
+ * Same answer as the Rust CLI (`is_on_path`, `is_command_installed`, `agent_program` in
+ * `bin/jan-cli.rs`): probe PATH with `which`/`where`, then the prefix locations an installer can use
+ * without touching PATH. A launcher found on PATH is executed by its bare name so the command we
+ * print is the one the user could retype; one found off PATH is executed by absolute path.
+ */
+import type { Agent } from './catalog.js';
+export declare const PATH_PROBE_TIMEOUT_MS = 5000;
+export interface DetectDeps {
+    platform?: NodeJS.Platform;
+    env?: NodeJS.ProcessEnv;
+    home?: string;
+    /** Run the PATH probe; resolves true when the command exists. */
+    onPath?: (bin: string) => Promise<boolean>;
+    /** Does this absolute path exist as a file? */
+    isFile?: (path: string) => Promise<boolean>;
+}
+export interface AgentDetection {
+    installed: boolean;
+    /** Absolute path when the launcher was found off PATH; undefined when the bare name resolves. */
+    path: string | undefined;
+    /** What to execute: the bare name, or the absolute path. */
+    program: string;
+}
+export declare function detectAgent(agent: Agent, deps?: DetectDeps): Promise<AgentDetection>;
+/** Detect several agents at once, for `launch --list`. */
+export declare function detectAgents(agents: readonly Agent[], deps?: DetectDeps): Promise<Map<string, AgentDetection>>;

package/dist/integrations/detect.js

@@ -0,0 +1,43 @@
+/**
+ * Is an agent's launcher on this machine, and what do we execute?
+ *
+ * Same answer as the Rust CLI (`is_on_path`, `is_command_installed`, `agent_program` in
+ * `bin/jan-cli.rs`): probe PATH with `which`/`where`, then the prefix locations an installer can use
+ * without touching PATH. A launcher found on PATH is executed by its bare name so the command we
+ * print is the one the user could retype; one found off PATH is executed by absolute path.
+ */
+import { execFile } from 'node:child_process';
+import { stat } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { offPathCandidates } from './catalog.js';
+export const PATH_PROBE_TIMEOUT_MS = 5000;
+const defaultIsFile = (path) => stat(path).then((s) => s.isFile(), () => false);
+function defaultOnPath(bin, platform) {
+    const probe = platform === 'win32' ? 'where' : 'which';
+    return new Promise((resolve) => {
+        execFile(probe, [bin], { timeout: PATH_PROBE_TIMEOUT_MS, windowsHide: true }, (err) => resolve(!err));
+    });
+}
+export async function detectAgent(agent, deps = {}) {
+    const platform = deps.platform ?? process.platform;
+    const onPath = deps.onPath ?? ((bin) => defaultOnPath(bin, platform));
+    const isFile = deps.isFile ?? defaultIsFile;
+    if (await onPath(agent.detectBin)) {
+        return { installed: true, path: undefined, program: agent.detectBin };
+    }
+    const home = deps.home ?? homedir();
+    for (const candidate of offPathCandidates(agent.detectBin, home, deps.env ?? process.env, platform)) {
+        if (await isFile(candidate))
+            return { installed: true, path: candidate, program: candidate };
+    }
+    return { installed: false, path: undefined, program: agent.detectBin };
+}
+/** Detect several agents at once, for `launch --list`. */
+export async function detectAgents(agents, deps = {}) {
+    const out = new Map();
+    await Promise.all(agents.map(async (agent) => {
+        out.set(agent.id, await detectAgent(agent, deps));
+    }));
+    return out;
+}
+//# sourceMappingURL=detect.js.map

package/dist/integrations/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../src/integrations/detect.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAEhD,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAA;AAoBzC,MAAM,aAAa,GAAG,CAAC,IAAY,EAAoB,EAAE,CACvD,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CACb,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,EACjB,GAAG,EAAE,CAAC,KAAK,CACZ,CAAA;AAEH,SAAS,aAAa,CAAC,GAAW,EAAE,QAAyB;IAC3D,MAAM,KAAK,GAAG,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAA;IACtD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;IACvG,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAY,EAAE,OAAmB,EAAE;IACnE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAA;IAClD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAA;IAC7E,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,aAAa,CAAA;IAC3C,IAAI,MAAM,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,SAAS,EAAE,CAAA;IACvE,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,EAAE,CAAA;IACnC,KAAK,MAAM,SAAS,IAAI,iBAAiB,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,CAAC;QACpG,IAAI,MAAM,MAAM,CAAC,SAAS,CAAC;YAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,CAAA;IAC9F,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,SAAS,EAAE,CAAA;AACxE,CAAC;AAED,0DAA0D;AAC1D,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAwB,EACxB,OAAmB,EAAE;IAErB,MAAM,GAAG,GAAG,IAAI,GAAG,EAA0B,CAAA;IAC7C,MAAM,OAAO,CAAC,GAAG,CACf,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QACzB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAA;IACnD,CAAC,CAAC,CACH,CAAA;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/integrations/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Coding-agent integrations: the catalog `launch` works from, and the config writers that point an
+ * agent at a local model. Ported from `src-tauri/src/core/cli/integrations.rs` and the
+ * `configure_*` commands in `src-tauri/src/core/system/commands.rs` (PLAN.md §4, phase 2).
+ */
+export * from './catalog.js';
+export * from './detect.js';
+export * from './config-io.js';
+export * from './configure/index.js';

package/dist/integrations/index.js

@@ -0,0 +1,10 @@
+/**
+ * Coding-agent integrations: the catalog `launch` works from, and the config writers that point an
+ * agent at a local model. Ported from `src-tauri/src/core/cli/integrations.rs` and the
+ * `configure_*` commands in `src-tauri/src/core/system/commands.rs` (PLAN.md §4, phase 2).
+ */
+export * from './catalog.js';
+export * from './detect.js';
+export * from './config-io.js';
+export * from './configure/index.js';
+//# sourceMappingURL=index.js.map

package/dist/integrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,sBAAsB,CAAA"}

package/dist/lock/control-token.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The bearer token for `/atomic/v1/*` (PLAN.md §3.6). The owner mints it while holding the instance
+ * lock; clients read it from `<data>/atomic-core/control-token`. File permissions are the only thing
+ * guarding it, so it is created `0600` on Unix; on Windows the file inherits the user's ACL, which
+ * `test/runtime-compat` checks separately.
+ */
+import type { DataLayout } from '../config/index.js';
+export declare const CONTROL_TOKEN_BYTES = 32;
+export declare const CONTROL_TOKEN_MODE = 384;
+export declare function generateControlToken(): string;
+/** Replace any token left by a previous owner: an old client must re-read, not keep authenticating. */
+export declare function writeControlToken(layout: DataLayout, token?: string): Promise<string>;
+export declare function readControlToken(layout: DataLayout): Promise<string>;
+/** Constant-time compare so a wrong token cannot be guessed byte by byte. */
+export declare function controlTokenMatches(presented: string | undefined | null, expected: string): boolean;
+/** `Authorization: Bearer <token>`; anything else (including `X-Api-Key`) is not accepted on control. */
+export declare function bearerToken(authorization: string | undefined | null): string | undefined;
+/** Unix-only check used by tests and `doctor`: is the token readable by anyone but the owner? */
+export declare function controlTokenIsPrivate(layout: DataLayout, platform?: NodeJS.Platform): Promise<boolean>;

package/dist/lock/control-token.js

@@ -0,0 +1,58 @@
+/**
+ * The bearer token for `/atomic/v1/*` (PLAN.md §3.6). The owner mints it while holding the instance
+ * lock; clients read it from `<data>/atomic-core/control-token`. File permissions are the only thing
+ * guarding it, so it is created `0600` on Unix; on Windows the file inherits the user's ACL, which
+ * `test/runtime-compat` checks separately.
+ */
+import { randomBytes, timingSafeEqual } from 'node:crypto';
+import { chmod, mkdir, readFile, rm, stat, writeFile } from 'node:fs/promises';
+import { AtomicCoreError } from '../contracts/index.js';
+export const CONTROL_TOKEN_BYTES = 32;
+export const CONTROL_TOKEN_MODE = 0o600;
+export function generateControlToken() {
+    return randomBytes(CONTROL_TOKEN_BYTES).toString('base64url');
+}
+/** Replace any token left by a previous owner: an old client must re-read, not keep authenticating. */
+export async function writeControlToken(layout, token = generateControlToken()) {
+    await mkdir(layout.core.dir, { recursive: true });
+    await rm(layout.core.controlToken, { force: true }).catch(() => { });
+    await writeFile(layout.core.controlToken, `${token}\n`, { mode: CONTROL_TOKEN_MODE });
+    await chmod(layout.core.controlToken, CONTROL_TOKEN_MODE).catch(() => { }); // umask may have widened it
+    return token;
+}
+export async function readControlToken(layout) {
+    const text = await readFile(layout.core.controlToken, 'utf8').catch((e) => {
+        if (e.code === 'ENOENT')
+            throw new AtomicCoreError('CORE_NOT_RUNNING', 'No Atomic Chat core control token in this data folder.', layout.core.controlToken);
+        throw new AtomicCoreError('IO_ERROR', 'Cannot read the core control token.', e.message);
+    });
+    const token = text.trim();
+    if (!token)
+        throw new AtomicCoreError('IO_ERROR', 'The core control token file is empty.', layout.core.controlToken);
+    return token;
+}
+/** Constant-time compare so a wrong token cannot be guessed byte by byte. */
+export function controlTokenMatches(presented, expected) {
+    if (!presented)
+        return false;
+    const a = Buffer.from(presented);
+    const b = Buffer.from(expected);
+    if (a.length !== b.length)
+        return false;
+    return timingSafeEqual(a, b);
+}
+/** `Authorization: Bearer <token>`; anything else (including `X-Api-Key`) is not accepted on control. */
+export function bearerToken(authorization) {
+    if (!authorization)
+        return undefined;
+    const m = /^Bearer\s+(.+)$/i.exec(authorization.trim());
+    return m ? m[1]?.trim() : undefined;
+}
+/** Unix-only check used by tests and `doctor`: is the token readable by anyone but the owner? */
+export async function controlTokenIsPrivate(layout, platform = process.platform) {
+    if (platform === 'win32')
+        return true;
+    const s = await stat(layout.core.controlToken);
+    return (s.mode & 0o077) === 0;
+}
+//# sourceMappingURL=control-token.js.map

package/dist/lock/control-token.js.map

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

package/dist/lock/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Single-owner coordination for a data folder: the instance lock and its process-start identity,
+ * the control token, and the journal of spawned backend processes. PLAN.md §3.4, §3.6.
+ */
+export * from './process-identity.js';
+export * from './instance-lock.js';
+export * from './control-token.js';
+export * from './process-journal.js';
+export * from './legacy-guard.js';
+export * from './model-claim.js';

package/dist/lock/index.js

@@ -0,0 +1,11 @@
+/**
+ * Single-owner coordination for a data folder: the instance lock and its process-start identity,
+ * the control token, and the journal of spawned backend processes. PLAN.md §3.4, §3.6.
+ */
+export * from './process-identity.js';
+export * from './instance-lock.js';
+export * from './control-token.js';
+export * from './process-journal.js';
+export * from './legacy-guard.js';
+export * from './model-claim.js';
+//# sourceMappingURL=index.js.map

package/dist/lock/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lock/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,uBAAuB,CAAA;AACrC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA"}