@atomic-chat/core 0.5.1

package/dist/integrations/configure/openclaw.js

@@ -0,0 +1,99 @@
+/**
+ * OpenClaw keeps one config for the CLI and both desktop apps in `~/.openclaw/openclaw.json`
+ * (overridable with `OPENCLAW_CONFIG_PATH`); its Gateway watches the file and hot-reloads, so one
+ * write covers everything with no restart.
+ *
+ * The merge has two tiers. Keys that express a decision the user may have made deliberately are
+ * SEEDED only when absent — `models.mode`, `gateway.mode`, `gateway.auth.mode`,
+ * `agents.defaults.timeoutSeconds`, and the per-model settings entry. Keys that say "run this model
+ * now" are always OVERWRITTEN — our provider block and `agents.defaults.model.primary`.
+ *
+ * The one non-obvious rule is `modelPolicy.allow`. When it is non-empty it gates model selection
+ * entirely, so a user restricted to a cloud provider would watch Run "succeed" and then be told our
+ * model is not allowed — hence the `atomic/*` widening. But an absent key or `[]` already means
+ * "allow anything", so writing into it would INTRODUCE a restriction nobody asked for. Those are
+ * left exactly as they are.
+ */
+import { AtomicCoreError } from '../../contracts/index.js';
+import { canonicalJson, keyOr, parseJsonLenient } from '../config-io.js';
+import { asJsonArray, asJsonObject } from './json-tree.js';
+import { registerWriter } from './registry.js';
+const PROVIDER_ID = 'atomic';
+const DEFAULT_PATH = '.openclaw/openclaw.json';
+/** Small local models blow past OpenClaw's short default once wrapped in the agent prompt + tools. */
+const DEFAULT_TIMEOUT_SECONDS = 240;
+/** Read `<parent>[key]` as an object, creating it when absent; anything else is a hard error. */
+function childObject(parent, key, label) {
+    if (parent[key] === undefined)
+        parent[key] = {};
+    const child = asJsonObject(parent[key]);
+    if (!child)
+        throw new AtomicCoreError('IO_ERROR', `${label} is not a JSON object`);
+    return child;
+}
+/** Whether an allow-list already covers `modelRef`. A trailing `*` makes the entry a prefix match. */
+export function modelPolicyAllows(list, modelRef) {
+    return list.some((entry) => {
+        if (typeof entry !== 'string')
+            return false;
+        return entry.endsWith('*') ? modelRef.startsWith(entry.slice(0, -1)) : entry === modelRef;
+    });
+}
+/** The whole merge, with no I/O, so every rule above is testable against a plain object. */
+export function openclawPatchConfig(parsed, apiUrl, model, apiKey) {
+    const root = asJsonObject(parsed);
+    if (!root)
+        throw new AtomicCoreError('IO_ERROR', 'openclaw.json is not a JSON object');
+    const modelRef = `${PROVIDER_ID}/${model}`;
+    const models = childObject(root, 'models', 'models');
+    if (models['mode'] === undefined)
+        models['mode'] = 'merge';
+    const providers = childObject(models, 'providers', 'models.providers');
+    // The catalog entry's `id` is the bare model id our /v1 server reports; OpenClaw builds the ref as
+    // `<providerId>/<id>`, so prefixing here would double it to `atomic/atomic/…` and break lookup.
+    providers[PROVIDER_ID] = {
+        baseUrl: apiUrl,
+        apiKey: keyOr(apiKey, 'atomic'),
+        api: 'openai-completions',
+        models: [{ id: model, name: model }],
+    };
+    // The local gateway refuses to open its websocket without connection auth; for a loopback-only
+    // setup "none" (private-ingress open auth) is what makes the agent reachable with no token.
+    const gateway = childObject(root, 'gateway', 'gateway');
+    if (gateway['mode'] === undefined)
+        gateway['mode'] = 'local';
+    const auth = childObject(gateway, 'auth', 'gateway.auth');
+    if (auth['mode'] === undefined)
+        auth['mode'] = 'none';
+    const agents = childObject(root, 'agents', 'agents');
+    const defaults = childObject(agents, 'defaults', 'agents.defaults');
+    if (defaults['timeoutSeconds'] === undefined)
+        defaults['timeoutSeconds'] = DEFAULT_TIMEOUT_SECONDS;
+    // Both a plain string and an object are accepted here, but only the object form has room for the
+    // fallbacks OpenClaw writes itself, so a string is normalised rather than extended.
+    if (asJsonObject(defaults['model']) === undefined)
+        defaults['model'] = {};
+    const modelEntry = asJsonObject(defaults['model']);
+    modelEntry['primary'] = modelRef;
+    // `agents.defaults.models` holds aliases and per-model settings. Pre-migration builds also read it
+    // as an allowlist, so the entry is still seeded; on current builds it restricts nothing.
+    const settings = childObject(defaults, 'models', 'agents.defaults.models');
+    if (settings[modelRef] === undefined)
+        settings[modelRef] = {};
+    const allow = asJsonArray(asJsonObject(defaults['modelPolicy'])?.['allow']);
+    if (allow && allow.length > 0 && !modelPolicyAllows(allow, modelRef)) {
+        allow.push(`${PROVIDER_ID}/*`);
+    }
+    return root;
+}
+export const configureOpenclaw = async ({ apiUrl, model, apiKey, fs, env, }) => {
+    const override = env['OPENCLAW_CONFIG_PATH'];
+    const path = override && override.length > 0 ? override : DEFAULT_PATH;
+    // OpenClaw reads this file as JSON5, so we must parse with the same leniency or we reject configs
+    // it happily accepts. Comments are dropped on write; every setting is preserved.
+    const text = await fs.read(path);
+    const parsed = text === undefined ? {} : parseJsonLenient(text, fs.absolute(path));
+    await fs.write(path, canonicalJson(openclawPatchConfig(parsed, apiUrl, model, apiKey)));
+};
+registerWriter('openclaw', configureOpenclaw);
+//# sourceMappingURL=openclaw.js.map

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

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

package/dist/integrations/configure/opencode-style.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The provider block three agents share: OpenCode, its fork MiMo Code, and Kilo Code.
+ *
+ * All three keep one JSON file whose `provider.<id>` map names an `@ai-sdk/openai-compatible`
+ * endpoint, and all three are configured by upserting a single `atomic` entry into it and then
+ * selecting `"<providerId>/<modelId>"` as the active model. The Rust side has this logic written
+ * out three times (`configure_opencode`, `configure_mimo`, `configure_kilo`); only four things
+ * differ, so here it is once with those four as parameters.
+ *
+ * Everything the user already had is preserved: other providers, unrelated top-level keys, and an
+ * existing `$schema`. The active model is overwritten on purpose — pressing Run is an explicit
+ * "use this one".
+ */
+import type { ConfigureInput } from './registry.js';
+export interface OpencodeStyleSpec {
+    /** Config directory relative to the home, e.g. `.config/opencode`. */
+    dir: string;
+    /** File name inside `dir`. Doubles as the name used in the "not a JSON object" error. */
+    file: string;
+    /** `$schema` seeded into a config that does not carry one yet. */
+    schema: string;
+    /** `.jsonc` files are read with the json5 tolerance; strict JSON files are not. */
+    lenient: boolean;
+}
+export declare function writeOpencodeStyleConfig(input: ConfigureInput, spec: OpencodeStyleSpec): Promise<void>;

package/dist/integrations/configure/opencode-style.js

@@ -0,0 +1,43 @@
+/**
+ * The provider block three agents share: OpenCode, its fork MiMo Code, and Kilo Code.
+ *
+ * All three keep one JSON file whose `provider.<id>` map names an `@ai-sdk/openai-compatible`
+ * endpoint, and all three are configured by upserting a single `atomic` entry into it and then
+ * selecting `"<providerId>/<modelId>"` as the active model. The Rust side has this logic written
+ * out three times (`configure_opencode`, `configure_mimo`, `configure_kilo`); only four things
+ * differ, so here it is once with those four as parameters.
+ *
+ * Everything the user already had is preserved: other providers, unrelated top-level keys, and an
+ * existing `$schema`. The active model is overwritten on purpose — pressing Run is an explicit
+ * "use this one".
+ */
+import { AtomicCoreError } from '../../contracts/index.js';
+import { canonicalJson, keyOr, parseJsonLenient, parseJsonStrict } from '../config-io.js';
+import { asJsonObject } from './json-tree.js';
+export async function writeOpencodeStyleConfig(input, spec) {
+    const { fs, apiUrl, model, apiKey } = input;
+    const path = `${spec.dir}/${spec.file}`;
+    // The directory is created before the file is read, so a parse failure below still leaves it —
+    // matching `create_dir_all` sitting above the read in the Rust writers.
+    await fs.mkdirp(spec.dir);
+    const text = await fs.read(path);
+    const parse = spec.lenient ? parseJsonLenient : parseJsonStrict;
+    const parsed = text === undefined ? {} : parse(text, fs.absolute(path));
+    const root = asJsonObject(parsed);
+    if (!root)
+        throw new AtomicCoreError('IO_ERROR', `${spec.file} is not a JSON object`);
+    // `entry(..).or_insert_with(..)`: an existing `$schema` wins, even an explicit `null`.
+    if (!('$schema' in root))
+        root['$schema'] = spec.schema;
+    const provider = asJsonObject(root['provider']) ?? {};
+    root['provider'] = provider;
+    provider['atomic'] = {
+        name: 'Atomic Chat',
+        npm: '@ai-sdk/openai-compatible',
+        options: { baseURL: apiUrl, apiKey: keyOr(apiKey, 'atomic') },
+        models: { [model]: { name: model } },
+    };
+    root['model'] = `atomic/${model}`;
+    await fs.write(path, canonicalJson(root));
+}
+//# sourceMappingURL=opencode-style.js.map

package/dist/integrations/configure/opencode-style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-style.js","sourceRoot":"","sources":["../../../src/integrations/configure/opencode-style.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACzF,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAc7C,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,KAAqB,EACrB,IAAuB;IAEvB,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,CAAA;IAC3C,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAA;IACvC,+FAA+F;IAC/F,wEAAwE;IACxE,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAEzB,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,eAAe,CAAA;IAC/D,MAAM,MAAM,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;IACvE,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,CAAA;IACjC,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,IAAI,uBAAuB,CAAC,CAAA;IAErF,uFAAuF;IACvF,IAAI,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC;QAAE,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,MAAM,CAAA;IAEvD,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,CAAA;IACrD,IAAI,CAAC,UAAU,CAAC,GAAG,QAAQ,CAAA;IAC3B,QAAQ,CAAC,QAAQ,CAAC,GAAG;QACnB,IAAI,EAAE,aAAa;QACnB,GAAG,EAAE,2BAA2B;QAChC,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE;QAC7D,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;KACrC,CAAA;IACD,IAAI,CAAC,OAAO,CAAC,GAAG,UAAU,KAAK,EAAE,CAAA;IAEjC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAA;AAC3C,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * OpenCode — `~/.config/opencode/opencode.json`.
+ *
+ * Port of `configure_opencode` in `src-tauri/src/core/system/commands.rs`. Strict JSON: a file the
+ * parser rejects is a hard error and nothing is written, so a typo in the user's config is
+ * reported instead of being overwritten.
+ */
+import type { ConfigureInput } from './registry.js';
+export declare function configureOpencode(input: ConfigureInput): Promise<void>;

package/dist/integrations/configure/opencode.js

@@ -0,0 +1,19 @@
+/**
+ * OpenCode — `~/.config/opencode/opencode.json`.
+ *
+ * Port of `configure_opencode` in `src-tauri/src/core/system/commands.rs`. Strict JSON: a file the
+ * parser rejects is a hard error and nothing is written, so a typo in the user's config is
+ * reported instead of being overwritten.
+ */
+import { registerWriter } from './registry.js';
+import { writeOpencodeStyleConfig } from './opencode-style.js';
+export function configureOpencode(input) {
+    return writeOpencodeStyleConfig(input, {
+        dir: '.config/opencode',
+        file: 'opencode.json',
+        schema: 'https://opencode.ai/config.json',
+        lenient: false,
+    });
+}
+registerWriter('opencode', configureOpencode);
+//# sourceMappingURL=opencode.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.js","sourceRoot":"","sources":["../../../src/integrations/configure/opencode.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAA;AAE9D,MAAM,UAAU,iBAAiB,CAAC,KAAqB;IACrD,OAAO,wBAAwB,CAAC,KAAK,EAAE;QACrC,GAAG,EAAE,kBAAkB;QACvB,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE,iCAAiC;QACzC,OAAO,EAAE,KAAK;KACf,CAAC,CAAA;AACJ,CAAC;AAED,cAAc,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAA"}

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

@@ -0,0 +1,8 @@
+/**
+ * OpenHands reads env overrides only when launched with `--override-with-envs`, using
+ * `LLM_API_KEY` / `LLM_BASE_URL` / `LLM_MODEL`. The litellm `openai/` prefix on the model id is
+ * required for a custom OpenAI-compatible base URL — without it litellm resolves the id against its
+ * own model registry and fails before the request leaves the process.
+ */
+import type { ConfigureWriter } from './registry.js';
+export declare const configureOpenhands: ConfigureWriter;

package/dist/integrations/configure/openhands.js

@@ -0,0 +1,12 @@
+/**
+ * OpenHands reads env overrides only when launched with `--override-with-envs`, using
+ * `LLM_API_KEY` / `LLM_BASE_URL` / `LLM_MODEL`. The litellm `openai/` prefix on the model id is
+ * required for a custom OpenAI-compatible base URL — without it litellm resolves the id against its
+ * own model registry and fails before the request leaves the process.
+ */
+import { registerWriter } from './registry.js';
+import { configureEnvAgent } from './env-agent.js';
+const MARKER = '# Atomic Chat - OpenHands Config';
+export const configureOpenhands = (input) => configureEnvAgent(input, { agentId: 'openhands', marker: MARKER, prefix: 'LLM_' });
+registerWriter('openhands', configureOpenhands);
+//# sourceMappingURL=openhands.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openhands.js","sourceRoot":"","sources":["../../../src/integrations/configure/openhands.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAElD,MAAM,MAAM,GAAG,kCAAkC,CAAA;AAEjD,MAAM,CAAC,MAAM,kBAAkB,GAAoB,CAAC,KAAK,EAAE,EAAE,CAC3D,iBAAiB,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;AAEpF,cAAc,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAA"}

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

@@ -0,0 +1,14 @@
+/**
+ * Pi — `~/.pi/agent/models.json` and `~/.pi/agent/settings.json`.
+ *
+ * Port of `configure_pi` in `src-tauri/src/core/system/commands.rs`. Pi splits the two halves of an
+ * integration across two strict-JSON files: `models.json` declares the provider and the models it
+ * serves, `settings.json` says which of them the agent opens on. Both are upserted, so other
+ * providers and unrelated settings survive.
+ *
+ * The order matters on failure: `models.json` is written before `settings.json` is even read, so a
+ * broken `settings.json` leaves a correctly updated `models.json` behind — the same half-applied
+ * result the Rust writer produces.
+ */
+import type { ConfigureInput } from './registry.js';
+export declare function configurePi(input: ConfigureInput): Promise<void>;

package/dist/integrations/configure/pi.js

@@ -0,0 +1,49 @@
+/**
+ * Pi — `~/.pi/agent/models.json` and `~/.pi/agent/settings.json`.
+ *
+ * Port of `configure_pi` in `src-tauri/src/core/system/commands.rs`. Pi splits the two halves of an
+ * integration across two strict-JSON files: `models.json` declares the provider and the models it
+ * serves, `settings.json` says which of them the agent opens on. Both are upserted, so other
+ * providers and unrelated settings survive.
+ *
+ * The order matters on failure: `models.json` is written before `settings.json` is even read, so a
+ * broken `settings.json` leaves a correctly updated `models.json` behind — the same half-applied
+ * result the Rust writer produces.
+ */
+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 = '.pi/agent';
+/** Read one of Pi's two files as a JSON object, treating missing/blank as `{}`. */
+async function readObject(fs, path, name) {
+    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', `${name} is not a JSON object`);
+    return root;
+}
+export async function configurePi(input) {
+    const { fs, apiUrl, model, apiKey } = input;
+    await fs.mkdirp(DIR);
+    const keyVal = keyOr(apiKey, 'atomic');
+    const modelsPath = `${DIR}/models.json`;
+    const modelsRoot = await readObject(fs, modelsPath, 'models.json');
+    const providers = asJsonObject(modelsRoot['providers']) ?? {};
+    modelsRoot['providers'] = providers;
+    providers['atomic'] = {
+        api: 'openai-completions',
+        apiKey: keyVal,
+        baseUrl: apiUrl,
+        models: [{ id: model }],
+    };
+    await fs.write(modelsPath, canonicalJson(modelsRoot));
+    const settingsPath = `${DIR}/settings.json`;
+    const settingsRoot = await readObject(fs, settingsPath, 'settings.json');
+    settingsRoot['defaultProvider'] = 'atomic';
+    settingsRoot['defaultModel'] = model;
+    await fs.write(settingsPath, canonicalJson(settingsRoot));
+}
+registerWriter('pi', configurePi);
+//# sourceMappingURL=pi.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pi.js","sourceRoot":"","sources":["../../../src/integrations/configure/pi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;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;AAG7C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAE9C,MAAM,GAAG,GAAG,WAAW,CAAA;AAEvB,mFAAmF;AACnF,KAAK,UAAU,UAAU,CAAC,EAAY,EAAE,IAAY,EAAE,IAAY;IAChE,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,GAAG,IAAI,uBAAuB,CAAC,CAAA;IAChF,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAqB;IACrD,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,CAAA;IAC3C,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IACpB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAEtC,MAAM,UAAU,GAAG,GAAG,GAAG,cAAc,CAAA;IACvC,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,EAAE,EAAE,UAAU,EAAE,aAAa,CAAC,CAAA;IAClE,MAAM,SAAS,GAAG,YAAY,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,CAAA;IAC7D,UAAU,CAAC,WAAW,CAAC,GAAG,SAAS,CAAA;IACnC,SAAS,CAAC,QAAQ,CAAC,GAAG;QACpB,GAAG,EAAE,oBAAoB;QACzB,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,MAAM;QACf,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;KACxB,CAAA;IACD,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC,CAAA;IAErD,MAAM,YAAY,GAAG,GAAG,GAAG,gBAAgB,CAAA;IAC3C,MAAM,YAAY,GAAG,MAAM,UAAU,CAAC,EAAE,EAAE,YAAY,EAAE,eAAe,CAAC,CAAA;IACxE,YAAY,CAAC,iBAAiB,CAAC,GAAG,QAAQ,CAAA;IAC1C,YAAY,CAAC,cAAc,CAAC,GAAG,KAAK,CAAA;IACpC,MAAM,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC,CAAA;AAC3D,CAAC;AAED,cAAc,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA"}

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

@@ -0,0 +1,8 @@
+/**
+ * Poolside CLI has no BYOK config file; it reads `POOLSIDE_STANDALONE_*` from the environment.
+ * The base URL is normalised by `poolsideStandaloneBaseUrl` (trim, strip trailing slashes, strip one
+ * `/v1`, strip trailing slashes again) because Poolside appends its own paths — leaving `/v1` on
+ * would make it request `/v1/v1/...`.
+ */
+import type { ConfigureWriter } from './registry.js';
+export declare const configurePoolside: ConfigureWriter;

package/dist/integrations/configure/poolside.js

@@ -0,0 +1,12 @@
+/**
+ * Poolside CLI has no BYOK config file; it reads `POOLSIDE_STANDALONE_*` from the environment.
+ * The base URL is normalised by `poolsideStandaloneBaseUrl` (trim, strip trailing slashes, strip one
+ * `/v1`, strip trailing slashes again) because Poolside appends its own paths — leaving `/v1` on
+ * would make it request `/v1/v1/...`.
+ */
+import { registerWriter } from './registry.js';
+import { configureEnvAgent } from './env-agent.js';
+const MARKER = '# Atomic Chat - Poolside Config';
+export const configurePoolside = (input) => configureEnvAgent(input, { agentId: 'poolside', marker: MARKER, prefix: 'POOLSIDE_' });
+registerWriter('poolside', configurePoolside);
+//# sourceMappingURL=poolside.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"poolside.js","sourceRoot":"","sources":["../../../src/integrations/configure/poolside.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAElD,MAAM,MAAM,GAAG,iCAAiC,CAAA;AAEhD,MAAM,CAAC,MAAM,iBAAiB,GAAoB,CAAC,KAAK,EAAE,EAAE,CAC1D,iBAAiB,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAA;AAExF,cAAc,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAA"}

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

@@ -0,0 +1,41 @@
+/**
+ * The dispatch point every agent config writer registers with — the TypeScript side of
+ * `cli::integrations::configure`. `launch` calls `configureAgent`, and nothing else needs to know
+ * which agent writes JSON, YAML, a shell rc, or no file at all.
+ */
+import type { Agent } from '../catalog.js';
+import type { ConfigFs } from '../config-io.js';
+export interface ConfigureInput {
+    apiUrl: string;
+    model: string;
+    apiKey: string;
+    fs: ConfigFs;
+    platform: NodeJS.Platform;
+    /** `$SHELL`; decides which rc file the env-var agents write to. */
+    shell: string | undefined;
+    env: NodeJS.ProcessEnv;
+    /** Run a command (only Cline needs one). Resolves with its exit status and output. */
+    spawn?: (program: string, args: string[]) => Promise<{
+        code: number;
+        stdout: string;
+        stderr: string;
+    }>;
+}
+export type ConfigureWriter = (input: ConfigureInput) => Promise<void>;
+/** Register a writer for an agent id. Called once per module at import time. */
+export declare function registerWriter(agentId: string, writer: ConfigureWriter): void;
+export declare function writerFor(agentId: string): ConfigureWriter | undefined;
+export declare function registeredAgents(): string[];
+export interface ConfigureOptions {
+    home?: string;
+    fs?: ConfigFs;
+    platform?: NodeJS.Platform;
+    shell?: string | undefined;
+    env?: NodeJS.ProcessEnv;
+    spawn?: ConfigureInput['spawn'];
+}
+/**
+ * Point an agent at a local endpoint. `model` may be empty only for the agents whose Rust
+ * counterpart accepts it (Claude Code and Zed treat it as "no model selected").
+ */
+export declare function configureAgent(agent: Agent | string, apiUrl: string, model: string, apiKey: string, options?: ConfigureOptions): Promise<void>;

package/dist/integrations/configure/registry.js

@@ -0,0 +1,50 @@
+/**
+ * The dispatch point every agent config writer registers with — the TypeScript side of
+ * `cli::integrations::configure`. `launch` calls `configureAgent`, and nothing else needs to know
+ * which agent writes JSON, YAML, a shell rc, or no file at all.
+ */
+import { AtomicCoreError } from '../../contracts/index.js';
+import { findAgent } from '../catalog.js';
+import { nodeConfigFs } from '../config-io.js';
+const WRITERS = new Map();
+/** Register a writer for an agent id. Called once per module at import time. */
+export function registerWriter(agentId, writer) {
+    WRITERS.set(agentId, writer);
+}
+export function writerFor(agentId) {
+    return WRITERS.get(agentId);
+}
+export function registeredAgents() {
+    return [...WRITERS.keys()].sort();
+}
+/**
+ * Point an agent at a local endpoint. `model` may be empty only for the agents whose Rust
+ * counterpart accepts it (Claude Code and Zed treat it as "no model selected").
+ */
+export async function configureAgent(agent, apiUrl, model, apiKey, options = {}) {
+    const resolved = typeof agent === 'string' ? findAgent(agent) : agent;
+    if (!resolved) {
+        throw new AtomicCoreError('INVALID_ARGUMENT', `Unknown agent: ${String(agent)}`);
+    }
+    const writer = WRITERS.get(resolved.id);
+    if (!writer) {
+        throw new AtomicCoreError('INTERNAL_ERROR', `Configuring ${resolved.name} is not implemented in this build.`, `no writer registered for "${resolved.id}"`);
+    }
+    const env = options.env ?? process.env;
+    const platform = options.platform ?? process.platform;
+    const home = options.home ?? (platform === 'win32' ? env['USERPROFILE'] : env['HOME']);
+    if (!options.fs && !home) {
+        throw new AtomicCoreError('IO_ERROR', 'Cannot resolve the home directory to write agent config into.');
+    }
+    await writer({
+        apiUrl,
+        model,
+        apiKey,
+        fs: options.fs ?? nodeConfigFs(home),
+        platform,
+        shell: options.shell ?? env['SHELL'],
+        env,
+        ...(options.spawn ? { spawn: options.spawn } : {}),
+    });
+}
+//# sourceMappingURL=registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/integrations/configure/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAE1D,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAiB9C,MAAM,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAA;AAElD,gFAAgF;AAChF,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,MAAuB;IACrE,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;AAC9B,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;AAC7B,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;AACnC,CAAC;AAWD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAqB,EACrB,MAAc,EACd,KAAa,EACb,MAAc,EACd,UAA4B,EAAE;IAE9B,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;IACrE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,kBAAkB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAClF,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;IACvC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,eAAe,CACvB,gBAAgB,EAChB,eAAe,QAAQ,CAAC,IAAI,oCAAoC,EAChE,6BAA6B,QAAQ,CAAC,EAAE,GAAG,CAC5C,CAAA;IACH,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAA;IACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAA;IACrD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IACtF,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QACzB,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,+DAA+D,CAAC,CAAA;IACxG,CAAC;IACD,MAAM,MAAM,CAAC;QACX,MAAM;QACN,KAAK;QACL,MAAM;QACN,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,YAAY,CAAC,IAAc,CAAC;QAC9C,QAAQ;QACR,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC;QACpC,GAAG;QACH,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACnD,CAAC,CAAA;AACJ,CAAC"}

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

@@ -0,0 +1,59 @@
+/**
+ * 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 type { ConfigFs, JsonValue } from '../config-io.js';
+/** Provider id we own inside `provider_config.json`; personal ids may be anything but `account:*`. */
+export declare const ZCODE_PROVIDER_ID = "atomic-chat";
+/** ZCode only admits a provider whose API key is non-blank; the local server ignores it when auth is off. */
+export declare 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 declare const ZCODE_CONTEXT_WINDOW = 65536;
+/**
+ * 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 declare const ZCODE_REASONING_MAP = "{\"chat_template_kwargs\": {\"enable_thinking\": reasoningLevel == \"enabled\"}}";
+/** ZCode's own writers wait up to 8 s for the lock. */
+export declare const ZCODE_LOCK_MAX_WAIT_MS = 8000;
+/** A ZCode write holds the lock for milliseconds; one this old was left by a process that died. */
+export declare const ZCODE_LOCK_STALE_AFTER_MS = 60000;
+/**
+ * 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 declare function zcodeConfigDir(fs: ConfigFs, envBase: string | undefined): Promise<string>;
+/**
+ * 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 declare function zcodePatchProviderConfig(existing: JsonValue | undefined, apiUrl: string, model: string, apiKey: string | undefined): JsonValue;
+export interface ZcodeLockDeps {
+    now?: () => number;
+    sleep?: (ms: number) => Promise<void>;
+}
+/**
+ * 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 declare function acquireZcodeLock(file: string, maxWaitMs: number, staleAfterMs: number, deps?: ZcodeLockDeps): Promise<() => Promise<void>>;
+/** The filesystem half of the writer, on a resolved `.zcode/v2` directory. */
+export declare function configureZcodeIn(fs: ConfigFs, dir: string, apiUrl: string, model: string, apiKey: string | undefined, lockDeps?: ZcodeLockDeps & {
+    maxWaitMs?: number;
+    staleAfterMs?: number;
+}): Promise<void>;