@atomic-chat/core 0.5.1

package/dist/integrations/config-io.js

@@ -0,0 +1,229 @@
+/**
+ * The machinery every agent-config writer shares, ported from `core/system/commands.rs`.
+ *
+ * Byte-for-byte compatibility with the Rust writers is the whole point (the golden fixtures in
+ * `test/fixtures/app/agent-config/` compare exact file contents), so three details that look like
+ * formatting are actually contract:
+ *
+ *  - `serde_json` is built without `preserve_order`, so every JSON file it writes has its object
+ *    keys sorted alphabetically, recursively. `JSON.stringify` preserves insertion order and would
+ *    diverge on any file with more than one key.
+ *  - `serde_yaml` 0.9 does not indent sequence items under their key.
+ *  - The managed shell-rc block has an exact shape, including where its blank lines fall.
+ */
+import { mkdir, readFile, rename, rm, stat, writeFile } from 'node:fs/promises';
+import { dirname, isAbsolute, join, resolve } from 'node:path';
+import { stringify as yamlStringify, parse as yamlParse } from 'yaml';
+import { AtomicCoreError } from '../contracts/index.js';
+export const ATOMIC_MANAGED_BEGIN = '# >>> Atomic Chat (managed) >>>';
+export const ATOMIC_MANAGED_END = '# <<< Atomic Chat (managed) <<<';
+export function nodeConfigFs(home) {
+    const abs = (relative) => (isAbsolute(relative) ? relative : join(home, ...relative.split('/')));
+    return {
+        home,
+        absolute: abs,
+        read: (relative) => readFile(abs(relative), 'utf8').then((t) => t, () => undefined),
+        write: async (relative, contents, options = {}) => {
+            const path = abs(relative);
+            await mkdir(dirname(path), { recursive: true });
+            // Write beside the target and rename over it, so a crash cannot truncate a user's config.
+            const tmp = `${path}.atomic-tmp`;
+            await writeFile(tmp, contents, options.mode !== undefined ? { mode: options.mode } : {});
+            await rename(tmp, path).catch(async (e) => {
+                await rm(tmp, { force: true }).catch(() => { });
+                throw e;
+            });
+        },
+        mkdirp: (relative) => mkdir(abs(relative), { recursive: true }).then(() => undefined),
+        exists: (relative) => stat(abs(relative)).then(() => true, () => false),
+        remove: (relative) => rm(abs(relative), { force: true }),
+    };
+}
+/** `serde_json::to_string_pretty` + the newline every writer appends: keys sorted, 2-space indent. */
+export function canonicalJson(value) {
+    return `${stringifySorted(value, 0)}\n`;
+}
+function stringifySorted(value, depth) {
+    if (value === null || value === undefined)
+        return 'null';
+    if (typeof value === 'string' || typeof value === 'boolean')
+        return JSON.stringify(value);
+    if (typeof value === 'number')
+        return Number.isFinite(value) ? JSON.stringify(value) : 'null';
+    const pad = '  '.repeat(depth + 1);
+    const closePad = '  '.repeat(depth);
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return '[]';
+        const items = value.map((item) => `${pad}${stringifySorted(item, depth + 1)}`);
+        return `[\n${items.join(',\n')}\n${closePad}]`;
+    }
+    if (typeof value === 'object') {
+        const entries = Object.entries(value).filter(([, v]) => v !== undefined);
+        if (entries.length === 0)
+            return '{}';
+        // Rust's BTreeMap ordering: byte-wise, which for the keys these files use is code-unit order.
+        entries.sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
+        const items = entries.map(([key, v]) => `${pad}${JSON.stringify(key)}: ${stringifySorted(v, depth + 1)}`);
+        return `{\n${items.join(',\n')}\n${closePad}}`;
+    }
+    return 'null';
+}
+/** Strict `serde_json`: a parse failure is fatal and nothing gets written. */
+export function parseJsonStrict(text, path) {
+    const trimmed = text.trim();
+    if (trimmed === '')
+        return {};
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch (e) {
+        throw new AtomicCoreError('IO_ERROR', `Failed to parse ${path}`, e.message);
+    }
+}
+/**
+ * The json5 reader the Rust side uses for `.jsonc`-style files: comments and trailing commas are
+ * accepted and silently dropped on write. Only the tolerances those files actually use are
+ * implemented; anything else still has to be valid JSON.
+ */
+export function parseJsonLenient(text, path) {
+    const trimmed = text.trim();
+    if (trimmed === '')
+        return {};
+    try {
+        return JSON.parse(stripJsonComments(trimmed));
+    }
+    catch (e) {
+        throw new AtomicCoreError('IO_ERROR', `Failed to parse ${path}`, e.message);
+    }
+}
+/** Remove `//` and block comments plus trailing commas, respecting strings and escapes. */
+export function stripJsonComments(text) {
+    let out = '';
+    let inString = false;
+    let escaped = false;
+    for (let i = 0; i < text.length; i++) {
+        const char = text[i];
+        if (inString) {
+            out += char;
+            if (escaped)
+                escaped = false;
+            else if (char === '\\')
+                escaped = true;
+            else if (char === '"')
+                inString = false;
+            continue;
+        }
+        if (char === '"') {
+            inString = true;
+            out += char;
+            continue;
+        }
+        if (char === '/' && text[i + 1] === '/') {
+            while (i < text.length && text[i] !== '\n')
+                i++;
+            out += '\n';
+            continue;
+        }
+        if (char === '/' && text[i + 1] === '*') {
+            i += 2;
+            while (i < text.length && !(text[i] === '*' && text[i + 1] === '/'))
+                i++;
+            i++;
+            continue;
+        }
+        out += char;
+    }
+    return out.replace(/,(\s*[}\]])/g, '$1');
+}
+// ── YAML ────────────────────────────────────────────────────────────────────────────────────────
+/** `serde_yaml` 0.9 shape: sequence items sit at their key's indent, no document marker. */
+export function canonicalYaml(value) {
+    return yamlStringify(value, { indentSeq: false, lineWidth: 0, nullStr: 'null' });
+}
+export function parseYaml(text, path) {
+    try {
+        return yamlParse(text) ?? {};
+    }
+    catch (e) {
+        throw new AtomicCoreError('IO_ERROR', `Failed to parse ${path}`, e.message);
+    }
+}
+// ── managed blocks ──────────────────────────────────────────────────────────────────────────────
+/**
+ * Remove every `# >>> Atomic Chat (managed) >>> … # <<< Atomic Chat (managed) <<<` region. Some
+ * writers (Codex) keep two, so this strips all of them, and — like the Rust original — it does not
+ * consume the newline after the closing marker, which is why blank-line residue is expected.
+ */
+export function stripAtomicManagedBlock(content) {
+    let result = content;
+    for (;;) {
+        const start = result.indexOf(ATOMIC_MANAGED_BEGIN);
+        const end = result.indexOf(ATOMIC_MANAGED_END);
+        if (start < 0 || end < 0 || end < start)
+            return result;
+        result = result.slice(0, start) + result.slice(end + ATOMIC_MANAGED_END.length);
+    }
+}
+/** Which shell rc file the env-var agents write to, from `$SHELL` and the platform. */
+export function shellRcFile(shell, platform) {
+    if (shell && shell.endsWith('/bash'))
+        return platform === 'darwin' ? '.bash_profile' : '.bashrc';
+    return '.zshenv';
+}
+/**
+ * The rc-file block the five env-configured agents write (`write_marked_env_to_shell`).
+ *
+ * `marker` is a single comment line that opens AND closes the region — each agent has its own
+ * (`# Atomic Chat - Goose Config`), so two agents never fight over one block. A line that merely
+ * *starts with* the marker toggles the region, exactly as the Rust filter does.
+ *
+ * Besides replacing our own block, it drops any `export <PREFIX>…` line even outside it — a safety
+ * net against a stale hand-written export overriding us, which also means the user's own
+ * `export GOOSE_*` lines are removed, while an unrelated `export OPENAI_API_KEY` survives because
+ * Goose's prefix is `GOOSE_`. Values are single-quoted without escaping, exactly as the Rust writer
+ * does, and each entry carries its own newline — which is where the blank line before the closing
+ * marker comes from.
+ */
+export function renderMarkedEnvBlock(existing, marker, prefix, entries) {
+    const exportLine = `export ${prefix}`;
+    const cleaned = [];
+    let inBlock = false;
+    for (const line of existing.split('\n')) {
+        if (line.startsWith(marker)) {
+            inBlock = !inBlock;
+            continue;
+        }
+        if (inBlock)
+            continue;
+        if (line.startsWith(exportLine))
+            continue;
+        cleaned.push(line);
+    }
+    const body = entries.map((e) => `export ${e.key}='${e.value}'\n`).join('');
+    return `${cleaned.join('\n')}${marker}\n${body}\n${marker}\n`;
+}
+/** Write the block into the right rc file for this shell. */
+export async function writeMarkedEnvToShell(fs, shell, platform, marker, prefix, entries) {
+    const rc = shellRcFile(shell, platform);
+    const existing = (await fs.read(rc)) ?? '';
+    await fs.write(rc, renderMarkedEnvBlock(existing, marker, prefix, entries));
+}
+// ── small shared helpers ────────────────────────────────────────────────────────────────────────
+/** TOML basic string escaping: only `\` and `"`, as the Rust writer does. */
+export function tomlBasicStringEscape(value) {
+    return value.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+}
+/** The key an agent should use when the user configured none. Not uniform across agents. */
+export function keyOr(apiKey, fallback) {
+    return apiKey && apiKey.length > 0 ? apiKey : fallback;
+}
+/** Expand a leading `~` against the home directory, as the Rust path helpers do. */
+export function expandTilde(path, home) {
+    if (path === '~')
+        return home;
+    if (path.startsWith('~/') || path.startsWith('~\\'))
+        return resolve(home, path.slice(2));
+    return path;
+}
+//# sourceMappingURL=config-io.js.map

package/dist/integrations/config-io.js.map

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

package/dist/integrations/configure/atomic-agent.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Atomic Agent keeps its user config in `<state dir>/config.json` (default `~/.atomic-agent`,
+ * overridable with `ATOMIC_AGENT_STATE_DIR`). The file is the agent's own trust surface, so the
+ * write is a merge: other providers, keys and blocks survive, and `version` is deliberately not
+ * stamped — the agent fills it, and every missing block, with its own defaults on the next start.
+ *
+ * Two rules are easy to get subtly wrong:
+ *
+ *  - A brand-new `llm.providers` list needs the agent's OWN default `local-llama` entry alongside
+ *    ours, because the agent refuses to load a file whose `activeEmbeddingProvider` names a provider
+ *    that is not in the list. That entry's `url` (chat) is mode-aware, and its `baseUrl` (embeddings)
+ *    mirrors where the agent would have looked with no `llm` block at all — otherwise creating the
+ *    block silently repoints embeddings at the chat daemon.
+ *  - `activeEmbeddingProvider` is repaired only when it is missing or dangling, and always to
+ *    `local-llama`. Repairing it to US would quietly hand memory recall to Atomic Chat, which is not
+ *    what Run asked for.
+ */
+import type { JsonValue } from '../config-io.js';
+import type { JsonObject } from './json-tree.js';
+import type { ConfigureWriter } from './registry.js';
+/**
+ * Where the agent would look for embeddings if we were not writing an `llm` block at all: the
+ * no-block branch of its embedding-provider registry, which reads
+ * `embeddings.enabled ? embeddings.url : localModels.url`. `chatUrl` is the mode-aware URL already
+ * computed for this entry, because `localModels.url` is itself resolved to the managed daemon before
+ * that branch sees it.
+ */
+export declare function atomicAgentEmbeddingBaseUrl(root: JsonObject, chatUrl: string): string;
+/** The `llama-server` entry Atomic Agent would synthesise for itself, from the same inputs. */
+export declare function atomicAgentLocalLlamaEntry(root: JsonObject): JsonObject;
+/** The whole merge, with no I/O, so the rules above are testable without a state directory. */
+export declare function atomicAgentPatchConfig(parsed: JsonValue, apiUrl: string, model: string, apiKey: string): JsonObject;
+export declare const configureAtomicAgent: ConfigureWriter;

package/dist/integrations/configure/atomic-agent.js

@@ -0,0 +1,127 @@
+/**
+ * Atomic Agent keeps its user config in `<state dir>/config.json` (default `~/.atomic-agent`,
+ * overridable with `ATOMIC_AGENT_STATE_DIR`). The file is the agent's own trust surface, so the
+ * write is a merge: other providers, keys and blocks survive, and `version` is deliberately not
+ * stamped — the agent fills it, and every missing block, with its own defaults on the next start.
+ *
+ * Two rules are easy to get subtly wrong:
+ *
+ *  - A brand-new `llm.providers` list needs the agent's OWN default `local-llama` entry alongside
+ *    ours, because the agent refuses to load a file whose `activeEmbeddingProvider` names a provider
+ *    that is not in the list. That entry's `url` (chat) is mode-aware, and its `baseUrl` (embeddings)
+ *    mirrors where the agent would have looked with no `llm` block at all — otherwise creating the
+ *    block silently repoints embeddings at the chat daemon.
+ *  - `activeEmbeddingProvider` is repaired only when it is missing or dangling, and always to
+ *    `local-llama`. Repairing it to US would quietly hand memory recall to Atomic Chat, which is not
+ *    what Run asked for.
+ */
+import { AtomicCoreError } from '../../contracts/index.js';
+import { canonicalJson, parseJsonStrict } from '../config-io.js';
+import { asJsonArray, asJsonObject } from './json-tree.js';
+import { registerWriter } from './registry.js';
+const PROVIDER_ID = 'atomic-chat';
+/** The agent's own llama.cpp entry; the repair target for a dangling embedding selection. */
+const LOCAL_PROVIDER_ID = 'local-llama';
+const DEFAULT_LLAMA_URL = 'http://127.0.0.1:8080';
+const DEFAULT_MANAGED_PORT = 19_091;
+const DEFAULT_EMBEDDINGS_PORT = 19_092;
+const REQUEST_TIMEOUT_MS = 300_000;
+function numberAt(value, key) {
+    const found = asJsonObject(value)?.[key];
+    return typeof found === 'number' ? found : undefined;
+}
+function stringAt(value, key) {
+    const found = asJsonObject(value)?.[key];
+    return typeof found === 'string' && found.length > 0 ? found : undefined;
+}
+/**
+ * Where the agent would look for embeddings if we were not writing an `llm` block at all: the
+ * no-block branch of its embedding-provider registry, which reads
+ * `embeddings.enabled ? embeddings.url : localModels.url`. `chatUrl` is the mode-aware URL already
+ * computed for this entry, because `localModels.url` is itself resolved to the managed daemon before
+ * that branch sees it.
+ */
+export function atomicAgentEmbeddingBaseUrl(root, chatUrl) {
+    const embeddings = asJsonObject(root['localModels'])?.['embeddings'];
+    if (asJsonObject(embeddings)?.['enabled'] !== true)
+        return chatUrl;
+    const explicit = stringAt(embeddings, 'url');
+    if (explicit)
+        return explicit;
+    return `http://127.0.0.1:${numberAt(embeddings, 'port') ?? DEFAULT_EMBEDDINGS_PORT}`;
+}
+/** The `llama-server` entry Atomic Agent would synthesise for itself, from the same inputs. */
+export function atomicAgentLocalLlamaEntry(root) {
+    const localModels = asJsonObject(root['localModels']);
+    // Under `mode: "managed"` the agent ignores `localModels.url` and talks to the daemon it runs.
+    const url = localModels?.['mode'] === 'managed'
+        ? `http://127.0.0.1:${numberAt(localModels['managed'], 'port') ?? DEFAULT_MANAGED_PORT}`
+        : (stringAt(root['localModels'], 'url') ?? DEFAULT_LLAMA_URL);
+    return {
+        id: LOCAL_PROVIDER_ID,
+        kind: 'llama-server',
+        baseUrl: atomicAgentEmbeddingBaseUrl(root, url),
+        url,
+    };
+}
+function lists(providers, id) {
+    return providers.some((p) => asJsonObject(p)?.['id'] === id);
+}
+/** The whole merge, with no I/O, so the rules above are testable without a state directory. */
+export function atomicAgentPatchConfig(parsed, apiUrl, model, apiKey) {
+    // The agent's `parseOptionalString` rejects `""` outright rather than treating it as absent, so an
+    // empty model would take the whole file down at its next start. Fail before touching anything.
+    if (model.trim() === '') {
+        throw new AtomicCoreError('INVALID_ARGUMENT', 'Atomic Agent needs a model: none is running.');
+    }
+    const root = asJsonObject(parsed);
+    if (!root)
+        throw new AtomicCoreError('IO_ERROR', 'config.json is not a JSON object');
+    // Read before the `llm` block is rewritten: it is derived from `localModels`, never written back.
+    const localLlama = atomicAgentLocalLlamaEntry(root);
+    if (asJsonObject(root['llm']) === undefined)
+        root['llm'] = {};
+    const llm = asJsonObject(root['llm']);
+    const currentEmbedding = typeof llm['activeEmbeddingProvider'] === 'string' ? llm['activeEmbeddingProvider'] : undefined;
+    const providers = asJsonArray(llm['providers']) ?? [];
+    llm['providers'] = providers;
+    if (providers.length === 0)
+        providers.push({ ...localLlama });
+    const existing = providers.findIndex((p) => asJsonObject(p)?.['id'] === PROVIDER_ID);
+    // A timeout the user tuned on our entry is theirs; we only fill the gap.
+    const timeout = existing >= 0
+        ? (numberAt(providers[existing], 'requestTimeoutMs') ?? REQUEST_TIMEOUT_MS)
+        : REQUEST_TIMEOUT_MS;
+    const entry = {
+        id: PROVIDER_ID,
+        kind: 'openai-compatible',
+        baseUrl: apiUrl,
+        // Stored as an `openai-compatible` provider, and most such clients reject an empty key.
+        apiKey: apiKey.trim() === '' ? 'atomic' : apiKey.trim(),
+        defaultChatModel: model.trim(),
+        supportsTools: true,
+        requestTimeoutMs: timeout,
+    };
+    if (existing >= 0)
+        providers[existing] = entry;
+    else
+        providers.push(entry);
+    // Embeddings drive memory recall, not chat, so a working selection is left alone.
+    const repair = currentEmbedding === undefined || !lists(providers, currentEmbedding);
+    if (repair && !lists(providers, LOCAL_PROVIDER_ID))
+        providers.push(localLlama);
+    // Pressing Run is an explicit "use this", so the text provider is switched outright.
+    llm['activeTextProvider'] = PROVIDER_ID;
+    if (repair)
+        llm['activeEmbeddingProvider'] = LOCAL_PROVIDER_ID;
+    return root;
+}
+export const configureAtomicAgent = async ({ apiUrl, model, apiKey, fs, env }) => {
+    const override = env['ATOMIC_AGENT_STATE_DIR']?.trim();
+    const path = `${override && override !== '' ? override : '.atomic-agent'}/config.json`;
+    const text = await fs.read(path);
+    const parsed = text === undefined ? {} : parseJsonStrict(text, fs.absolute(path));
+    await fs.write(path, canonicalJson(atomicAgentPatchConfig(parsed, apiUrl, model, apiKey)));
+};
+registerWriter('atomic-agent', configureAtomicAgent);
+//# sourceMappingURL=atomic-agent.js.map

package/dist/integrations/configure/atomic-agent.js.map

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

package/dist/integrations/configure/claude-code.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Claude Code — `~/.claude/settings.json`.
+ *
+ * Port of `configure_claude_code` in `src-tauri/src/core/system/commands.rs`. Claude Code takes its
+ * endpoint from environment variables that its settings file can carry, so pointing it at a local
+ * model is an upsert into that file's `env` map plus the top-level `model` setting.
+ *
+ * Claude Code appends its own `/v1`, so `apiUrl` here is the bare `host:port` (the catalog marks
+ * this agent `endpointWithPrefix: false`).
+ *
+ * An empty model means "nothing is loaded". `cli::integrations::configure` turns it into `None` for
+ * this agent, and the writer then leaves every model key alone — it neither writes them nor removes
+ * ones an earlier run left behind, so a rerun without a model keeps pointing at the last one.
+ */
+import type { ConfigureInput } from './registry.js';
+export declare function configureClaudeCode(input: ConfigureInput): Promise<void>;

package/dist/integrations/configure/claude-code.js

@@ -0,0 +1,45 @@
+/**
+ * Claude Code — `~/.claude/settings.json`.
+ *
+ * Port of `configure_claude_code` in `src-tauri/src/core/system/commands.rs`. Claude Code takes its
+ * endpoint from environment variables that its settings file can carry, so pointing it at a local
+ * model is an upsert into that file's `env` map plus the top-level `model` setting.
+ *
+ * Claude Code appends its own `/v1`, so `apiUrl` here is the bare `host:port` (the catalog marks
+ * this agent `endpointWithPrefix: false`).
+ *
+ * An empty model means "nothing is loaded". `cli::integrations::configure` turns it into `None` for
+ * this agent, and the writer then leaves every model key alone — it neither writes them nor removes
+ * ones an earlier run left behind, so a rerun without a model keeps pointing at the last one.
+ */
+import { AtomicCoreError } from '../../contracts/index.js';
+import { canonicalJson, keyOr, parseJsonStrict } from '../config-io.js';
+import { asJsonObject } from './json-tree.js';
+import { registerWriter } from './registry.js';
+const DIR = '.claude';
+const PATH = `${DIR}/settings.json`;
+export async function configureClaudeCode(input) {
+    const { fs, apiUrl, model, apiKey } = input;
+    await fs.mkdirp(DIR);
+    const text = await fs.read(PATH);
+    const parsed = text === undefined ? {} : parseJsonStrict(text, fs.absolute(PATH));
+    const root = asJsonObject(parsed);
+    if (!root)
+        throw new AtomicCoreError('IO_ERROR', 'settings.json is not a JSON object');
+    const env = asJsonObject(root['env']) ?? {};
+    root['env'] = env;
+    env['ANTHROPIC_BASE_URL'] = apiUrl;
+    env['ANTHROPIC_AUTH_TOKEN'] = keyOr(apiKey, 'atomic');
+    if (model !== '') {
+        // ANTHROPIC_MODEL overrides the `model` setting; the tier aliases make every Opus/Sonnet/Haiku
+        // request route to the single local model too.
+        env['ANTHROPIC_MODEL'] = model;
+        env['ANTHROPIC_DEFAULT_OPUS_MODEL'] = model;
+        env['ANTHROPIC_DEFAULT_SONNET_MODEL'] = model;
+        env['ANTHROPIC_DEFAULT_HAIKU_MODEL'] = model;
+        root['model'] = model;
+    }
+    await fs.write(PATH, canonicalJson(root));
+}
+registerWriter('claude-code', configureClaudeCode);
+//# sourceMappingURL=claude-code.js.map

package/dist/integrations/configure/claude-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../../src/integrations/configure/claude-code.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE7C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAE9C,MAAM,GAAG,GAAG,SAAS,CAAA;AACrB,MAAM,IAAI,GAAG,GAAG,GAAG,gBAAgB,CAAA;AAEnC,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAAqB;IAC7D,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,CAAA;IAC3C,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAEpB,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,eAAe,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;IACjF,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,CAAA;IACjC,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,oCAAoC,CAAC,CAAA;IAEtF,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAA;IAC3C,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAA;IACjB,GAAG,CAAC,oBAAoB,CAAC,GAAG,MAAM,CAAA;IAClC,GAAG,CAAC,sBAAsB,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAErD,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QACjB,+FAA+F;QAC/F,+CAA+C;QAC/C,GAAG,CAAC,iBAAiB,CAAC,GAAG,KAAK,CAAA;QAC9B,GAAG,CAAC,8BAA8B,CAAC,GAAG,KAAK,CAAA;QAC3C,GAAG,CAAC,gCAAgC,CAAC,GAAG,KAAK,CAAA;QAC7C,GAAG,CAAC,+BAA+B,CAAC,GAAG,KAAK,CAAA;QAC5C,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,CAAA;IACvB,CAAC;IAED,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAA;AAC3C,CAAC;AAED,cAAc,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAA"}

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

@@ -0,0 +1,28 @@
+/**
+ * Cline — no config file at all.
+ *
+ * Port of `configure_cline` in `src-tauri/src/core/system/commands.rs`. Cline stores its provider
+ * settings itself; the supported way in is its own `cline auth` subcommand, so configuring it means
+ * running a process and reporting what it said. Nothing is written to disk by us.
+ *
+ * On Windows the npm-installed `cline` is a batch shim (`cline.cmd`), which `CreateProcessW` refuses
+ * to execute directly, so the call is routed through `cmd /C`.
+ */
+import type { ConfigureInput } from './registry.js';
+export interface SpawnResult {
+    code: number;
+    stdout: string;
+    stderr: string;
+}
+/** Argv for `cline auth`, split out so both the writer and its tests can name the exact command. */
+export declare function clineAuthCommand(apiUrl: string, model: string, apiKey: string, platform: NodeJS.Platform): {
+    program: string;
+    args: string[];
+};
+/**
+ * The runner used when the caller injects none. A process that ran and failed is a result, not an
+ * exception — only a process that could not be started at all rejects, because those are the two
+ * outcomes Cline's caller has to report differently.
+ */
+export declare function spawnProcess(program: string, args: string[]): Promise<SpawnResult>;
+export declare function configureCline(input: ConfigureInput): Promise<void>;

package/dist/integrations/configure/cline.js

@@ -0,0 +1,70 @@
+/**
+ * Cline — no config file at all.
+ *
+ * Port of `configure_cline` in `src-tauri/src/core/system/commands.rs`. Cline stores its provider
+ * settings itself; the supported way in is its own `cline auth` subcommand, so configuring it means
+ * running a process and reporting what it said. Nothing is written to disk by us.
+ *
+ * On Windows the npm-installed `cline` is a batch shim (`cline.cmd`), which `CreateProcessW` refuses
+ * to execute directly, so the call is routed through `cmd /C`.
+ */
+import { execFile } from 'node:child_process';
+import { AtomicCoreError } from '../../contracts/index.js';
+import { keyOr } from '../config-io.js';
+import { registerWriter } from './registry.js';
+/** Argv for `cline auth`, split out so both the writer and its tests can name the exact command. */
+export function clineAuthCommand(apiUrl, model, apiKey, platform) {
+    // Cline rejects an empty `--apikey` (and an empty `--modelid`), so a keyless local server gets a
+    // non-empty placeholder. Note it is `local` here, not the `atomic` the file-writing agents use.
+    const args = [
+        'auth',
+        '--provider',
+        'openai-compatible',
+        '--apikey',
+        keyOr(apiKey, 'local'),
+        '--modelid',
+        model,
+        '--baseurl',
+        apiUrl,
+    ];
+    return platform === 'win32'
+        ? { program: 'cmd', args: ['/C', 'cline', ...args] }
+        : { program: 'cline', args };
+}
+/**
+ * The runner used when the caller injects none. A process that ran and failed is a result, not an
+ * exception — only a process that could not be started at all rejects, because those are the two
+ * outcomes Cline's caller has to report differently.
+ */
+export function spawnProcess(program, args) {
+    return new Promise((resolve, reject) => {
+        execFile(program, args, { windowsHide: true }, (error, stdout, stderr) => {
+            // `execFile` reports a non-zero exit and a failure to start the same way; only the latter has
+            // no exit code, and only the latter is a spawn error as far as the message goes.
+            const code = error && typeof error.code === 'number' ? error.code : error ? -1 : 0;
+            if (error && typeof error.code !== 'number')
+                reject(error);
+            else
+                resolve({ code, stdout, stderr });
+        });
+    });
+}
+export async function configureCline(input) {
+    const { program, args } = clineAuthCommand(input.apiUrl, input.model, input.apiKey, input.platform);
+    const spawn = input.spawn ?? spawnProcess;
+    let result;
+    try {
+        result = await spawn(program, args);
+    }
+    catch (e) {
+        throw new AtomicCoreError('IO_ERROR', `Failed to spawn 'cline': ${e.message}`);
+    }
+    if (result.code !== 0) {
+        // The stream split for `cline auth` is undocumented, so prefer stderr and fall back to stdout.
+        const stderr = result.stderr.trim();
+        const detail = stderr === '' ? result.stdout.trim() : stderr;
+        throw new AtomicCoreError('INTERNAL_ERROR', `\`cline auth\` failed: ${detail}`);
+    }
+}
+registerWriter('cline', configureCline);
+//# sourceMappingURL=cline.js.map

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

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

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

@@ -0,0 +1,17 @@
+/**
+ * Codex CLI — `~/.codex/config.toml`.
+ *
+ * Port of `configure_codex` in `src-tauri/src/core/system/commands.rs`. This is the only writer that
+ * edits TOML, and it does it textually rather than by parsing: the file is the user's, so the two
+ * regions we own are delimited by managed markers and everything between them is left alone.
+ *
+ * Two regions, not one, because Codex 0.135+ makes Atomic the default provider through the bare
+ * root keys `model` / `model_provider`, and bare TOML keys must precede every `[table]`. So a head
+ * block goes at the very top, the user's content follows, and the `[model_providers.atomic]` table
+ * goes last. Rerunning strips both regions first, which is why a rerun is idempotent.
+ *
+ * The user's content is `trimEnd`-ed but never trimmed at the start: leading blank lines left by
+ * stripping a previous head block are part of the recorded output.
+ */
+import type { ConfigureInput } from './registry.js';
+export declare function configureCodex(input: ConfigureInput): Promise<void>;