@atomic-chat/core 0.5.1

package/dist/integrations/catalog.js

@@ -0,0 +1,385 @@
+/**
+ * The coding agents `launch` can wire to a local model — a port of
+ * `src-tauri/src/core/cli/integrations.rs`, which itself mirrors
+ * `web-app/src/constants/integrations.ts` so the CLI and the desktop Launch page configure the same
+ * set in the same order. The three GUI editors in the web list (`vscode`, `jetbrains`, `xcode`) are
+ * absent on purpose: they keep their provider in IDE storage with no writable config file.
+ *
+ * Order is contract: the app's drift test compares this list against the TypeScript source
+ * position by position, and `tests/cli-launch-catalog.test.mjs` compares it against the CLI.
+ */
+/** Hermes Agent refuses to start below a 64K context window. Matches the Launch page. */
+export const HERMES_CONTEXT_LENGTH = 65_536;
+export const AGENTS = [
+    {
+        id: 'kilo',
+        name: 'Kilo Code',
+        detectBin: 'kilo',
+        aliases: [],
+        requiresModel: true,
+        endpointWithPrefix: true,
+        docsUrl: 'https://kilo.ai/docs',
+        runArgs: [],
+        runMode: 'terminal',
+    },
+    {
+        id: 'claude-code',
+        name: 'Claude Code',
+        detectBin: 'claude',
+        aliases: ['claude', 'claudecode'],
+        requiresModel: false,
+        // Claude Code appends its own `/v1`.
+        endpointWithPrefix: false,
+        docsUrl: 'https://docs.anthropic.com/en/docs/claude-code',
+        runArgs: [],
+        runMode: 'terminal',
+    },
+    {
+        id: 'pi',
+        name: 'pi',
+        detectBin: 'pi',
+        aliases: [],
+        requiresModel: true,
+        endpointWithPrefix: true,
+        docsUrl: 'https://github.com/earendil-works/pi',
+        runArgs: [],
+        runMode: 'terminal',
+    },
+    {
+        id: 'codex',
+        name: 'Codex CLI',
+        detectBin: 'codex',
+        aliases: [],
+        requiresModel: true,
+        endpointWithPrefix: true,
+        docsUrl: 'https://github.com/openai/codex',
+        runArgs: [],
+        runMode: 'terminal',
+    },
+    {
+        id: 'opencode',
+        name: 'OpenCode',
+        detectBin: 'opencode',
+        aliases: [],
+        requiresModel: true,
+        endpointWithPrefix: true,
+        docsUrl: 'https://opencode.ai',
+        runArgs: [],
+        runMode: 'terminal',
+    },
+    {
+        id: 'openclaude',
+        name: 'OpenClaude',
+        detectBin: 'openclaude',
+        aliases: [],
+        requiresModel: true,
+        endpointWithPrefix: true,
+        docsUrl: 'https://github.com/Gitlawb/openclaude',
+        runArgs: [],
+        runMode: 'terminal',
+    },
+    {
+        id: 'cline',
+        name: 'Cline CLI',
+        detectBin: 'cline',
+        aliases: [],
+        requiresModel: true,
+        endpointWithPrefix: true,
+        docsUrl: 'https://docs.cline.bot/cline-cli/getting-started',
+        runArgs: [],
+        runMode: 'terminal',
+    },
+    {
+        id: 'dsh',
+        name: 'DeepSeek Harness',
+        detectBin: 'dsh',
+        aliases: [],
+        requiresModel: true,
+        endpointWithPrefix: true,
+        docsUrl: 'https://github.com/deepseek-ai/deepseek-harness',
+        // A bare `dsh` has no profile to hand its arguments to and only prints the launcher's help;
+        // `dsh web` serves the UI on 127.0.0.1:3080.
+        runArgs: ['web'],
+        runMode: 'terminal',
+    },
+    {
+        id: 'zed',
+        name: 'Zed',
+        detectBin: 'zed',
+        aliases: [],
+        requiresModel: true,
+        endpointWithPrefix: true,
+        docsUrl: 'https://zed.dev/docs/ai/llm-providers',
+        runArgs: [],
+        // Zed's AI agent lives in its own window; the launcher returns at once.
+        runMode: 'gui',
+    },
+    {
+        id: 'zcode',
+        name: 'ZCode',
+        // The desktop app's executable: `/usr/bin/zcode` on Linux, found off PATH elsewhere
+        // (see `offPathCandidates`).
+        detectBin: 'zcode',
+        aliases: [],
+        requiresModel: true,
+        endpointWithPrefix: true,
+        docsUrl: 'https://zcode.z.ai/en/docs/configuration',
+        runArgs: [],
+        // A desktop app that reads the provider file we write; it returns at once.
+        runMode: 'gui',
+    },
+    {
+        id: 'mimo',
+        name: 'MiMo Code',
+        detectBin: 'mimo',
+        aliases: [],
+        requiresModel: true,
+        endpointWithPrefix: true,
+        docsUrl: 'https://mimo.xiaomi.com/mimocode/',
+        runArgs: [],
+        runMode: 'terminal',
+    },
+    {
+        id: 'droid',
+        name: 'Droid',
+        detectBin: 'droid',
+        aliases: [],
+        requiresModel: true,
+        endpointWithPrefix: true,
+        docsUrl: 'https://docs.factory.ai/cli/getting-started/quickstart',
+        runArgs: [],
+        runMode: 'terminal',
+    },
+    {
+        id: 'copilot',
+        name: 'Copilot CLI',
+        detectBin: 'copilot',
+        aliases: [],
+        requiresModel: true,
+        endpointWithPrefix: true,
+        docsUrl: 'https://docs.github.com/en/copilot/how-tos/copilot-cli',
+        runArgs: [],
+        runMode: 'terminal',
+    },
+    {
+        id: 'openhands',
+        name: 'OpenHands',
+        detectBin: 'openhands',
+        aliases: [],
+        requiresModel: true,
+        endpointWithPrefix: true,
+        docsUrl: 'https://docs.openhands.dev/openhands/usage/cli/installation',
+        // OpenHands reads the env overrides only with this flag.
+        runArgs: ['--override-with-envs'],
+        runMode: 'terminal',
+    },
+    {
+        id: 'poolside',
+        name: 'Poolside',
+        detectBin: 'pool',
+        aliases: ['poolside'],
+        requiresModel: true,
+        endpointWithPrefix: true,
+        docsUrl: 'https://docs.poolside.ai/cli',
+        runArgs: [],
+        runMode: 'terminal',
+    },
+    {
+        id: 'goose',
+        name: 'Goose',
+        detectBin: 'goose',
+        aliases: [],
+        requiresModel: true,
+        // Goose appends its own path via OPENAI_BASE_PATH.
+        endpointWithPrefix: false,
+        docsUrl: 'https://block.github.io/goose/',
+        // A bare `goose` only prints help.
+        runArgs: ['session'],
+        runMode: 'terminal',
+    },
+    {
+        id: 'muse',
+        name: 'Muse Code',
+        detectBin: 'muse',
+        aliases: ['muse-code', 'musecode'],
+        requiresModel: true,
+        // `--base-url` replaces the Meta Model API root; Muse appends `/responses` itself.
+        endpointWithPrefix: true,
+        docsUrl: 'https://developer.meta.com/ai/products/muse-code/',
+        runArgs: [],
+        runMode: 'terminal',
+    },
+    {
+        id: 'atomic-agent',
+        name: 'Atomic Agent',
+        detectBin: 'atomic-agent',
+        // `atag` is the short alias the installer drops next to the binary.
+        aliases: ['atag'],
+        requiresModel: true,
+        endpointWithPrefix: true,
+        docsUrl: 'https://github.com/AtomicBot-ai/atomic-agent',
+        runArgs: [],
+        runMode: 'terminal',
+    },
+    {
+        id: 'hermes',
+        name: 'Hermes Agent',
+        detectBin: 'hermes',
+        aliases: [],
+        requiresModel: true,
+        endpointWithPrefix: true,
+        docsUrl: 'https://github.com/NousResearch/hermes-agent',
+        runArgs: [],
+        runMode: 'terminal',
+    },
+    {
+        id: 'openclaw',
+        name: 'OpenClaw',
+        detectBin: 'openclaw',
+        aliases: [],
+        requiresModel: true,
+        endpointWithPrefix: true,
+        docsUrl: 'https://docs.openclaw.ai',
+        // A bare `openclaw` is the setup/repair helper; `chat` runs the agent.
+        runArgs: ['chat'],
+        runMode: 'terminal',
+    },
+];
+/** Look an agent up by id, binary name, or alias. Case-insensitive. */
+export function findAgent(name) {
+    const needle = name.trim().toLowerCase();
+    return AGENTS.find((a) => a.id === needle || a.detectBin === needle || a.aliases.includes(needle));
+}
+/** The endpoint an agent is pointed at: the base URL, plus the prefix only when it expects one. */
+export function apiUrlFor(agent, baseUrl, prefix) {
+    return agent.endpointWithPrefix ? `${baseUrl}${prefix}` : baseUrl;
+}
+/**
+ * Provider credentials in the ambient environment that would override the config we just wrote.
+ * Cleared on the child before launching, or the agent quietly talks to a cloud provider instead.
+ */
+export const CONFLICTING_PROVIDER_ENV = [
+    'OPENAI_API_KEY',
+    'OPENAI_BASE_URL',
+    'ANTHROPIC_API_KEY',
+    'ANTHROPIC_AUTH_TOKEN',
+    'ANTHROPIC_OAUTH_TOKEN',
+    'GEMINI_API_KEY',
+    'MISTRAL_API_KEY',
+    'GROQ_API_KEY',
+    'XAI_API_KEY',
+    'OPENROUTER_API_KEY',
+];
+/**
+ * Environment the spawned agent needs on top of its config file. Five agents are configured purely
+ * through environment variables that `configure_*` persists to the user's shell rc — that file is
+ * not live in a process we are about to spawn, so the same variables are set on the child.
+ */
+export function childEnv(agent, apiUrl, model, apiKey) {
+    const key = apiKey || 'atomic';
+    switch (agent.id) {
+        case 'copilot':
+            return {
+                COPILOT_PROVIDER_BASE_URL: apiUrl,
+                COPILOT_PROVIDER_TYPE: 'openai',
+                COPILOT_MODEL: model,
+                COPILOT_OFFLINE: 'true',
+                // Copilot is the one that omits the key entirely when there is none.
+                ...(apiKey ? { COPILOT_PROVIDER_API_KEY: apiKey } : {}),
+            };
+        case 'goose':
+            return {
+                GOOSE_PROVIDER: 'openai',
+                GOOSE_MODEL: model,
+                OPENAI_HOST: apiUrl,
+                OPENAI_BASE_PATH: 'v1/chat/completions',
+                OPENAI_API_KEY: key,
+            };
+        case 'openhands':
+            // The litellm `openai/` prefix is required for a custom OpenAI-compatible base_url.
+            return { LLM_MODEL: `openai/${model}`, LLM_BASE_URL: apiUrl, LLM_API_KEY: key };
+        case 'poolside':
+            return {
+                POOLSIDE_STANDALONE_BASE_URL: poolsideStandaloneBaseUrl(apiUrl),
+                POOLSIDE_API_KEY: key,
+                POOLSIDE_STANDALONE_MODEL: model,
+            };
+        case 'muse':
+            return { META_API_KEY: key };
+        default:
+            return {};
+    }
+}
+/** Poolside wants the root without `/v1`; it appends its own paths. */
+export function poolsideStandaloneBaseUrl(apiUrl) {
+    const trimmed = apiUrl.trim().replace(/\/+$/, '');
+    const withoutV1 = trimmed.endsWith('/v1') ? trimmed.slice(0, -'/v1'.length) : trimmed;
+    return withoutV1.replace(/\/+$/, '');
+}
+/**
+ * Launchers that installers drop outside PATH. OpenClaw's installer writes into `~/.openclaw/bin`
+ * or `~/.local/bin` (or `$OPENCLAW_PREFIX`), which a login shell may not have on PATH yet. ZCode is a
+ * desktop app that puts nothing on PATH outside Linux, so its candidates are the executables its
+ * installers write. Every other agent installs onto PATH, and guessing would only produce false
+ * positives.
+ */
+export function offPathCandidates(bin, home, env = process.env, platform = process.platform) {
+    const separator = platform === 'win32' ? '\\' : '/';
+    const join = (...parts) => parts.map((p) => p.replace(/[\\/]+$/, '')).join(separator);
+    if (bin === 'zcode')
+        return zcodeAppCandidates(home, env, platform, join);
+    if (bin !== 'openclaw' || !home)
+        return [];
+    const roots = [];
+    const prefix = env['OPENCLAW_PREFIX'];
+    if (prefix && prefix.trim() !== '')
+        roots.push(prefix);
+    roots.push(join(home, '.openclaw'), join(home, '.local'));
+    // Windows launchers are `.cmd` shims; POSIX ones are extensionless.
+    const names = platform === 'win32' ? ['openclaw.cmd', 'openclaw.exe', 'openclaw'] : ['openclaw'];
+    const out = [];
+    for (const root of roots)
+        for (const name of names)
+            out.push(join(root, 'bin', name));
+    return out;
+}
+/**
+ * Where each ZCode installer puts the desktop app's executable (`zcode_app_candidates` in the app's
+ * `core/system/commands.rs`, commit `ec1fd3ea7`). The Linux deb/rpm packages also link
+ * `/usr/bin/zcode`, which the PATH probe finds first.
+ */
+function zcodeAppCandidates(home, env, platform, join) {
+    if (platform === 'darwin') {
+        const out = ['/Applications/ZCode.app/Contents/MacOS/ZCode'];
+        if (home)
+            out.push(join(home, 'Applications/ZCode.app/Contents/MacOS/ZCode'));
+        return out;
+    }
+    if (platform === 'win32') {
+        // NSIS installs per user under `%LOCALAPPDATA%\Programs` and for all users under `%ProgramFiles%`.
+        const out = [];
+        for (const [variable, sub] of [
+            ['LOCALAPPDATA', 'Programs\\ZCode'],
+            ['ProgramFiles', 'ZCode'],
+        ]) {
+            const root = env[variable];
+            if (root)
+                out.push(join(root, sub, 'ZCode.exe'));
+        }
+        return out;
+    }
+    return ['/opt/ZCode/zcode'];
+}
+/**
+ * `launch` runs a bare llama-server, and Muse Code fetches `/muse-code/models` before its first
+ * turn — a catalogue only the desktop app's Local API Server serves. Refusing up front beats
+ * loading a model and handing the user Muse's own opaque failure.
+ */
+export const MUSE_CLI_REFUSAL = [
+    'Muse Code needs the desktop app’s Local API Server, which serves the',
+    '`/muse-code/models` catalogue Muse requires at startup. `launch` runs a',
+    'bare llama-server, which does not.',
+    '',
+    'Start the server in Atomic Chat, then use Integrations → Muse Code.',
+];
+//# sourceMappingURL=catalog.js.map

package/dist/integrations/catalog.js.map

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

package/dist/integrations/config-io.d.ts

@@ -0,0 +1,86 @@
+/**
+ * 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.
+ */
+export declare const ATOMIC_MANAGED_BEGIN = "# >>> Atomic Chat (managed) >>>";
+export declare const ATOMIC_MANAGED_END = "# <<< Atomic Chat (managed) <<<";
+/**
+ * A filesystem rooted at the user's home directory. Writers only ever address paths relative to it,
+ * which is what lets the fixtures replay against a throwaway directory.
+ */
+export interface ConfigFs {
+    /** Absolute path of the home directory. */
+    home: string;
+    read: (relative: string) => Promise<string | undefined>;
+    write: (relative: string, contents: string, options?: {
+        mode?: number;
+    }) => Promise<void>;
+    mkdirp: (relative: string) => Promise<void>;
+    exists: (relative: string) => Promise<boolean>;
+    remove: (relative: string) => Promise<void>;
+    /** Absolute path for a relative one, for the rare writer that records its own location. */
+    absolute: (relative: string) => string;
+}
+export declare function nodeConfigFs(home: string): ConfigFs;
+export type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+/** `serde_json::to_string_pretty` + the newline every writer appends: keys sorted, 2-space indent. */
+export declare function canonicalJson(value: unknown): string;
+/** Strict `serde_json`: a parse failure is fatal and nothing gets written. */
+export declare function parseJsonStrict(text: string, path: string): JsonValue;
+/**
+ * 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 declare function parseJsonLenient(text: string, path: string): JsonValue;
+/** Remove `//` and block comments plus trailing commas, respecting strings and escapes. */
+export declare function stripJsonComments(text: string): string;
+/** `serde_yaml` 0.9 shape: sequence items sit at their key's indent, no document marker. */
+export declare function canonicalYaml(value: unknown): string;
+export declare function parseYaml(text: string, path: string): unknown;
+/**
+ * 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 declare function stripAtomicManagedBlock(content: string): string;
+/** Which shell rc file the env-var agents write to, from `$SHELL` and the platform. */
+export declare function shellRcFile(shell: string | undefined, platform: NodeJS.Platform): string;
+export interface EnvEntry {
+    key: string;
+    value: string;
+}
+/**
+ * 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 declare function renderMarkedEnvBlock(existing: string, marker: string, prefix: string, entries: EnvEntry[]): string;
+/** Write the block into the right rc file for this shell. */
+export declare function writeMarkedEnvToShell(fs: ConfigFs, shell: string | undefined, platform: NodeJS.Platform, marker: string, prefix: string, entries: EnvEntry[]): Promise<void>;
+/** TOML basic string escaping: only `\` and `"`, as the Rust writer does. */
+export declare function tomlBasicStringEscape(value: string): string;
+/** The key an agent should use when the user configured none. Not uniform across agents. */
+export declare function keyOr(apiKey: string, fallback: string): string;
+/** Expand a leading `~` against the home directory, as the Rust path helpers do. */
+export declare function expandTilde(path: string, home: string): string;