aimeat 2.6.0 → 2.7.0

package/README.md

@@ -182,6 +182,60 @@ An app is also an **agent surface**: any function it exposes can be published as
 
 ## What You Can Do
 
+### Use the AI chat you like, with your node in it
+
+One command connects **Goose, Claude Code, Cursor, VS Code or Claude Desktop** to your node:
+
+```bash
+aimeat connect client goose --url https://aimeat.io --owner your-handle
+```
+
+It does three things. It authorizes an agent **of its own** for that program (you approve it from your
+profile -> Agents tab, as always). It writes the MCP settings in the shape that program expects,
+merging into whatever you already had. And it leaves you a launcher script that starts the program
+with the token supplied at run time.
+
+| Client | How it reaches the node | Config it writes |
+|---|---|---|
+| `goose` | `POST /v1/mcp` | `config.yaml` -> `extensions` |
+| `claude-code` | `POST /v1/mcp` | `claude mcp add-json`, user scope |
+| `cursor` | `POST /v1/mcp` | `~/.cursor/mcp.json` |
+| `vscode` | `POST /v1/mcp` | user `mcp.json` -> `servers` |
+| `claude-desktop` | local connector over stdio | `claude_desktop_config.json` |
+
+Options: `--agent <name>` names the agent, `--workdir <path>` decides where the program starts (an
+agent writes files where it is launched, so this keeps it out of your source repos), `--surface
+appdev` narrows the toolset to app building, `--home <path>` puts the credential somewhere else,
+`--name <server>` lets a second node live alongside the first.
+
+**Two guarantees, because this command edits files you own.** Your token is never written into a
+config file: each client is given a variable reference, a headers-helper command, or the local
+connector, and the token itself stays in the connector home. And every other MCP server you had
+configured is left exactly as it was -- the command merges, backs the file up first, and refuses to
+write at all if it cannot parse what is there.
+
+After it runs you are talking to your own memory, apps, organisms, workspaces, tasks and the
+marketplace from that window: "what do I have in my workspace", "build me an app that does X",
+"what did my agents do today".
+
+**Goose is the one to try if you want a chat that is not Claude, ChatGPT or Grok.** It is an open
+source terminal agent that takes its model from **OpenRouter**, so you pick the model and pay per
+token for exactly what you use -- a strong model for a hard build, a cheap one for everything else,
+switched in seconds:
+
+```bash
+# a model for this session only
+$env:GOOSE_MODEL = "z-ai/glm-5.2"; C:\Users\you\.aimeat-goose\launch-goose.ps1
+GOOSE_MODEL=z-ai/glm-5.2 ~/.aimeat-goose/launch-goose.sh
+
+# inside a running session
+/model deepseek/deepseek-v3.2     # switch model without restarting
+/mode auto                        # stop confirming every tool call
+```
+
+Set `OPENROUTER_API_KEY` in your environment before launching. The full toolset costs roughly 50k
+input tokens per turn; `--surface appdev` cuts that to about a third when you are only building apps.
+
 ### Connect AI agents
 
 <img src="assets/screenshots/profile-agents.png" alt="Agent connection prompt" width="600" />
@@ -452,6 +506,9 @@ npx aimeat seed     # seed example packages (in another terminal, server must be
 
 # Or just connect an agent to someone else's node
 npx aimeat connect --url https://your-node --owner your-handle
+
+# Or point your own AI chat at a node in one command (goose | claude-code | cursor | vscode | claude-desktop)
+npx aimeat connect client goose --url https://aimeat.io --owner your-handle
 ```
 
 **App thumbnails (optional).** `aimeat screenshot-worker` renders each published app and stores a

package/dist/build-stamp.json

@@ -1,10 +1,10 @@
 {
   "schema_version": 1,
-  "version": "2.6.0",
-  "commit": "9cca6f004888be424d1b031da77a2a04693b856f",
+  "version": "2.7.0",
+  "commit": "c16f054a02c9198474fd62c9985ca0dcdb5419f0",
   "dirty": false,
-  "built_at": "2026-08-02T01:53:22.702Z",
-  "newest_source_mtime": 1785635326931.713,
+  "built_at": "2026-08-02T02:40:18.003Z",
+  "newest_source_mtime": 1785638212648.5315,
   "source_dirs": [
     "src",
     "bin",

package/dist/public/changelog.json

@@ -1,6 +1,19 @@
 {
   "_format": "Node change log, newest entry FIRST. Served at /changelog.json, rendered by public/views/landing-changelog.js. Add an entry in the same change that ships the thing. Fields: date (YYYY-MM-DD), version (optional, the node version it shipped in), kind (feature|fix|security|notice), title and body. title/body are either a plain string (shown to everyone) or { en, fi } when the wording deserves both languages. Write what a person gets, not what the code does.",
   "entries": [
+    {
+      "date": "2026-08-02",
+      "version": "2.7.0",
+      "kind": "feature",
+      "title": {
+        "en": "Use the AI chat you like, with your node in it",
+        "fi": "Käytä sitä tekoälychattia josta pidät, ja pidä nodesi mukana siinä"
+      },
+      "body": {
+        "en": "One command now connects Goose, Claude Code, Cursor, VS Code or Claude Desktop to your node: aimeat connect client goose. It creates an agent of its own for that program, writes the settings the program expects, and hands you a shortcut that starts it. From then on you can talk to your own data, apps and organisms from that window, with whichever model you pay for. It never writes your key into a settings file, and it leaves every other tool you had connected exactly as it was.",
+        "fi": "Yksi komento kytkee Goosen, Claude Coden, Cursorin, VS Coden tai Claude Desktopin nodeesi: aimeat connect client goose. Se luo ohjelmalle oman agentin, kirjoittaa asetukset siihen muotoon jota ohjelma odottaa, ja antaa sinulle pikakuvakkeen jolla se käynnistyy. Sen jälkeen voit jutella omalle datallesi, apeillesi ja organismeillesi siitä ikkunasta, sillä mallilla josta itse maksat. Avaintasi ei kirjoiteta asetustiedostoon, eikä yksikään aiemmin kytkemäsi työkalu muutu matkalla."
+      }
+    },
     {
       "date": "2026-08-01",
       "version": "2.4.0",

package/dist/src/cli/connect/clients/claude.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @file claude.ts
+ * @description Claude Code and Claude Desktop adapters. They are the two clients that do NOT take
+ *   a plain remote entry with a token in it:
+ *     - Claude Code has `headersHelper`, a command whose stdout becomes the request headers. That
+ *       is strictly better than a static header: the token never enters ~/.claude.json and a
+ *       re-authenticated agent is picked up without editing anything.
+ *     - Claude Desktop's config file is stdio-only. A `url` field there is not merely ignored: the
+ *       app drops the whole mcpServers block on startup. So Desktop is connected over the local
+ *       connector (`aimeat connect serve`), which is a real stdio MCP server and needs no token in
+ *       the file either.
+ * @structure
+ *   - claudeCodeAdapter — runs `claude mcp add-json` when the CLI is present, prints it when not.
+ *   - claudeDesktopAdapter — merges a stdio entry into claude_desktop_config.json.
+ * @usage Registered in clients/registry.ts as `claude-code` and `claude-desktop`.
+ * @version-history
+ *   v1.0.0 — 2026-08-02 — Initial creation: one-command client connect.
+ */
+import type { ClientAdapter } from './types.js';
+export declare const claudeCodeAdapter: ClientAdapter;
+export declare const claudeDesktopAdapter: ClientAdapter;
+//# sourceMappingURL=claude.d.ts.map

package/dist/src/cli/connect/clients/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../../../../src/cli/connect/clients/claude.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,KAAK,EAAE,aAAa,EAA6B,MAAM,YAAY,CAAC;AAoB3E,eAAO,MAAM,iBAAiB,EAAE,aAyC/B,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,aAgClC,CAAC"}

package/dist/src/cli/connect/clients/claude.js

@@ -0,0 +1,105 @@
+/**
+ * @file claude.ts
+ * @description Claude Code and Claude Desktop adapters. They are the two clients that do NOT take
+ *   a plain remote entry with a token in it:
+ *     - Claude Code has `headersHelper`, a command whose stdout becomes the request headers. That
+ *       is strictly better than a static header: the token never enters ~/.claude.json and a
+ *       re-authenticated agent is picked up without editing anything.
+ *     - Claude Desktop's config file is stdio-only. A `url` field there is not merely ignored: the
+ *       app drops the whole mcpServers block on startup. So Desktop is connected over the local
+ *       connector (`aimeat connect serve`), which is a real stdio MCP server and needs no token in
+ *       the file either.
+ * @structure
+ *   - claudeCodeAdapter — runs `claude mcp add-json` when the CLI is present, prints it when not.
+ *   - claudeDesktopAdapter — merges a stdio entry into claude_desktop_config.json.
+ * @usage Registered in clients/registry.ts as `claude-code` and `claude-desktop`.
+ * @version-history
+ *   v1.0.0 — 2026-08-02 — Initial creation: one-command client connect.
+ */
+import { spawnSync } from 'node:child_process';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { backup, objectAt, readJsonFile, writeJsonFile } from './fs-merge.js';
+import { writeHeadersHelper } from './launcher.js';
+function claudeCodeConfigPath() {
+    return join(homedir(), '.claude.json');
+}
+function claudeDesktopConfigPath() {
+    if (process.platform === 'win32') {
+        const appData = process.env.APPDATA ?? join(homedir(), 'AppData', 'Roaming');
+        return join(appData, 'Claude', 'claude_desktop_config.json');
+    }
+    if (process.platform === 'darwin') {
+        return join(homedir(), 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+    }
+    const xdg = process.env.XDG_CONFIG_HOME ?? join(homedir(), '.config');
+    return join(xdg, 'Claude', 'claude_desktop_config.json');
+}
+export const claudeCodeAdapter = {
+    id: 'claude-code',
+    label: 'Claude Code',
+    transport: 'http',
+    configPath: claudeCodeConfigPath,
+    async apply(target) {
+        const helper = writeHeadersHelper(target);
+        const entry = {
+            type: 'http',
+            url: target.mcpUrl,
+            headersHelper: process.platform === 'win32'
+                ? `powershell -NoProfile -File "${helper.ps1}"`
+                : helper.sh,
+        };
+        const addJson = `claude mcp add-json ${target.serverName} '${JSON.stringify(entry)}' --scope user`;
+        // ~/.claude.json holds far more than MCP servers, so let Claude Code write its own file
+        // rather than hand-editing it here.
+        const claude = spawnSync('claude', ['mcp', 'add-json', target.serverName, JSON.stringify(entry), '--scope', 'user'], {
+            encoding: 'utf8', shell: process.platform === 'win32',
+        });
+        if (claude.status === 0) {
+            return {
+                written: [helper.ps1, helper.sh],
+                backedUp: [],
+                nextSteps: [
+                    'Added to Claude Code at user scope. Verify with:  claude mcp list',
+                    'The token stays out of the config: headersHelper reads it from the connector home at connect time.',
+                ],
+            };
+        }
+        return {
+            written: [helper.ps1, helper.sh],
+            backedUp: [],
+            manual: `The \`claude\` CLI was not usable here (${claude.error?.message ?? `exit ${String(claude.status)}`}). Run this yourself:\n\n  ${addJson}`,
+            nextSteps: ['Then verify with:  claude mcp list'],
+        };
+    },
+};
+export const claudeDesktopAdapter = {
+    id: 'claude-desktop',
+    label: 'Claude Desktop',
+    transport: 'stdio',
+    configPath: claudeDesktopConfigPath,
+    async apply(target) {
+        const file = claudeDesktopConfigPath();
+        const config = readJsonFile(file);
+        const bak = backup(file);
+        // NOTE: no `url` key here, deliberately. Claude Desktop discards the whole mcpServers block
+        // when it meets one. The connector is a genuine stdio MCP server and reads its own token.
+        const args = ['connect', 'serve'];
+        if (target.surface)
+            args.push('--surface', target.surface);
+        objectAt(config, 'mcpServers')[target.serverName] = process.platform === 'win32'
+            ? { command: 'cmd', args: ['/c', 'aimeat', ...args], env: { AIMEAT_HOME: target.home } }
+            : { command: 'aimeat', args, env: { AIMEAT_HOME: target.home } };
+        writeJsonFile(file, config);
+        return {
+            written: [file],
+            backedUp: bak ? [bak] : [],
+            nextSteps: [
+                'Restart Claude Desktop, then check Settings > Developer for the aimeat server.',
+                'Desktop connects over the local connector (stdio), not the HTTP endpoint: its config file cannot carry a remote URL.',
+                `That connector serves the agent stored in ${target.home}.`,
+            ],
+        };
+    },
+};
+//# sourceMappingURL=claude.js.map

package/dist/src/cli/connect/clients/claude.js.map

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

package/dist/src/cli/connect/clients/cursor-vscode.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @file cursor-vscode.ts
+ * @description Cursor and VS Code adapters. Both keep a JSON MCP config and both expand
+ *   `${env:NAME}` inside header values, so the token stays in the environment. They differ in the
+ *   top-level key (`mcpServers` vs `servers`), in whether `type` is required, and in where the file
+ *   lives.
+ * @structure
+ *   - cursorAdapter — ~/.cursor/mcp.json, `mcpServers`.
+ *   - vscodeAdapter — per-platform user mcp.json, `servers` with `type: http`.
+ * @usage Registered in clients/registry.ts as `cursor` and `vscode`.
+ * @version-history
+ *   v1.0.0 — 2026-08-02 — Initial creation: one-command client connect.
+ */
+import type { ClientAdapter } from './types.js';
+export declare const cursorAdapter: ClientAdapter;
+export declare const vscodeAdapter: ClientAdapter;
+//# sourceMappingURL=cursor-vscode.d.ts.map

package/dist/src/cli/connect/clients/cursor-vscode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-vscode.d.ts","sourceRoot":"","sources":["../../../../../src/cli/connect/clients/cursor-vscode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,aAAa,EAA6B,MAAM,YAAY,CAAC;AAuB3E,eAAO,MAAM,aAAa,EAAE,aA6B3B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,aA+B3B,CAAC"}

package/dist/src/cli/connect/clients/cursor-vscode.js

@@ -0,0 +1,88 @@
+/**
+ * @file cursor-vscode.ts
+ * @description Cursor and VS Code adapters. Both keep a JSON MCP config and both expand
+ *   `${env:NAME}` inside header values, so the token stays in the environment. They differ in the
+ *   top-level key (`mcpServers` vs `servers`), in whether `type` is required, and in where the file
+ *   lives.
+ * @structure
+ *   - cursorAdapter — ~/.cursor/mcp.json, `mcpServers`.
+ *   - vscodeAdapter — per-platform user mcp.json, `servers` with `type: http`.
+ * @usage Registered in clients/registry.ts as `cursor` and `vscode`.
+ * @version-history
+ *   v1.0.0 — 2026-08-02 — Initial creation: one-command client connect.
+ */
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { backup, objectAt, readJsonFile, writeJsonFile } from './fs-merge.js';
+import { writeLauncher } from './launcher.js';
+/** Both clients read the token from the environment; this is the value they expand. */
+const HEADER_VALUE = 'Bearer ${env:AIMEAT_AGENT_TOKEN}';
+function cursorConfigPath() {
+    return join(homedir(), '.cursor', 'mcp.json');
+}
+function vscodeConfigPath() {
+    if (process.platform === 'win32') {
+        const appData = process.env.APPDATA ?? join(homedir(), 'AppData', 'Roaming');
+        return join(appData, 'Code', 'User', 'mcp.json');
+    }
+    if (process.platform === 'darwin') {
+        return join(homedir(), 'Library', 'Application Support', 'Code', 'User', 'mcp.json');
+    }
+    const xdg = process.env.XDG_CONFIG_HOME ?? join(homedir(), '.config');
+    return join(xdg, 'Code', 'User', 'mcp.json');
+}
+export const cursorAdapter = {
+    id: 'cursor',
+    label: 'Cursor',
+    transport: 'http',
+    configPath: cursorConfigPath,
+    async apply(target) {
+        const file = cursorConfigPath();
+        const config = readJsonFile(file);
+        const bak = backup(file);
+        objectAt(config, 'mcpServers')[target.serverName] = {
+            url: target.mcpUrl,
+            headers: { Authorization: HEADER_VALUE },
+        };
+        writeJsonFile(file, config);
+        const scripts = writeLauncher(target, 'cursor', 'cursor', ['.']);
+        return {
+            written: [file, ...scripts],
+            backedUp: bak ? [bak] : [],
+            nextSteps: [
+                `Cursor must see AIMEAT_AGENT_TOKEN in its environment. Launch it with:  ${scripts[0]}`,
+                'Or export the variable in your shell profile and start Cursor normally.',
+                'Check it under Settings > MCP: the server should list its tools.',
+            ],
+        };
+    },
+};
+export const vscodeAdapter = {
+    id: 'vscode',
+    label: 'VS Code',
+    transport: 'http',
+    configPath: vscodeConfigPath,
+    async apply(target) {
+        const file = vscodeConfigPath();
+        const config = readJsonFile(file);
+        const bak = backup(file);
+        objectAt(config, 'servers')[target.serverName] = {
+            type: 'http',
+            url: target.mcpUrl,
+            headers: { Authorization: HEADER_VALUE },
+        };
+        writeJsonFile(file, config);
+        const scripts = writeLauncher(target, 'vscode', 'code', ['.']);
+        return {
+            written: [file, ...scripts],
+            backedUp: bak ? [bak] : [],
+            nextSteps: [
+                `VS Code must see AIMEAT_AGENT_TOKEN in its environment. Launch it with:  ${scripts[0]}`,
+                'Then run "MCP: List Servers" from the command palette and start the aimeat server.',
+                'If your build does not expand ${env:...} in headers, replace the header value with',
+                '  "Bearer ${input:aimeat_token}" and add an inputs entry of type promptString.',
+            ],
+        };
+    },
+};
+//# sourceMappingURL=cursor-vscode.js.map

package/dist/src/cli/connect/clients/cursor-vscode.js.map

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

package/dist/src/cli/connect/clients/fs-merge.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @file fs-merge.ts
+ * @description Read-modify-write helpers shared by the client adapters. Every adapter edits a file
+ *   the user already owns and that usually holds OTHER servers, so the rules here are the same for
+ *   all of them: parse what is there, replace only our own key, back the file up first, and never
+ *   drop a key we did not put there.
+ * @structure
+ *   - readJsonFile / writeJsonFile — tolerant JSON round-trip (missing file = {}).
+ *   - readYamlFile / writeYamlFile — same for YAML (Goose).
+ *   - backup — timestamp-free `.aimeat-bak` copy, taken once per run before the first write.
+ *   - ensureDirFor — mkdir -p for a file path.
+ * @usage Imported by clients/goose.ts, cursor.ts, vscode.ts, claude-desktop.ts.
+ * @version-history
+ *   v1.0.0 — 2026-08-02 — Initial creation: one-command client connect.
+ */
+/** mkdir -p for the directory holding `file`. */
+export declare function ensureDirFor(file: string): void;
+/**
+ * Copy `file` to `<file>.aimeat-bak` before we touch it. Returns the backup path, or null when
+ * there was nothing to back up (first-time config). A single fixed suffix keeps the user's config
+ * directory from filling with copies on every re-run.
+ */
+export declare function backup(file: string): string | null;
+/**
+ * Parse a JSON config. A missing file yields `{}`. A file that exists but does not parse THROWS —
+ * silently starting from `{}` there would delete every server the user had configured.
+ */
+export declare function readJsonFile(file: string): Record<string, unknown>;
+export declare function writeJsonFile(file: string, data: Record<string, unknown>): void;
+/** Same contract as readJsonFile, for YAML. */
+export declare function readYamlFile(file: string): Record<string, unknown>;
+export declare function writeYamlFile(file: string, data: Record<string, unknown>): void;
+/** Fetch (or create) a nested object property without discarding what is already inside it. */
+export declare function objectAt(root: Record<string, unknown>, key: string): Record<string, unknown>;
+//# sourceMappingURL=fs-merge.d.ts.map

package/dist/src/cli/connect/clients/fs-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-merge.d.ts","sourceRoot":"","sources":["../../../../../src/cli/connect/clients/fs-merge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,iDAAiD;AACjD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAG/C;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKlD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUlE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAG/E;AAED,+CAA+C;AAC/C,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUlE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAG/E;AAED,+FAA+F;AAC/F,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAM5F"}

package/dist/src/cli/connect/clients/fs-merge.js

@@ -0,0 +1,87 @@
+/**
+ * @file fs-merge.ts
+ * @description Read-modify-write helpers shared by the client adapters. Every adapter edits a file
+ *   the user already owns and that usually holds OTHER servers, so the rules here are the same for
+ *   all of them: parse what is there, replace only our own key, back the file up first, and never
+ *   drop a key we did not put there.
+ * @structure
+ *   - readJsonFile / writeJsonFile — tolerant JSON round-trip (missing file = {}).
+ *   - readYamlFile / writeYamlFile — same for YAML (Goose).
+ *   - backup — timestamp-free `.aimeat-bak` copy, taken once per run before the first write.
+ *   - ensureDirFor — mkdir -p for a file path.
+ * @usage Imported by clients/goose.ts, cursor.ts, vscode.ts, claude-desktop.ts.
+ * @version-history
+ *   v1.0.0 — 2026-08-02 — Initial creation: one-command client connect.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync, copyFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+/** mkdir -p for the directory holding `file`. */
+export function ensureDirFor(file) {
+    const dir = dirname(file);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+}
+/**
+ * Copy `file` to `<file>.aimeat-bak` before we touch it. Returns the backup path, or null when
+ * there was nothing to back up (first-time config). A single fixed suffix keeps the user's config
+ * directory from filling with copies on every re-run.
+ */
+export function backup(file) {
+    if (!existsSync(file))
+        return null;
+    const bak = `${file}.aimeat-bak`;
+    copyFileSync(file, bak);
+    return bak;
+}
+/**
+ * Parse a JSON config. A missing file yields `{}`. A file that exists but does not parse THROWS —
+ * silently starting from `{}` there would delete every server the user had configured.
+ */
+export function readJsonFile(file) {
+    if (!existsSync(file))
+        return {};
+    const raw = readFileSync(file, 'utf8').trim();
+    if (!raw)
+        return {};
+    try {
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === 'object' ? parsed : {};
+    }
+    catch (e) {
+        throw new Error(`${file} is not valid JSON. Fix or move it, then re-run — refusing to overwrite it.`, { cause: e });
+    }
+}
+export function writeJsonFile(file, data) {
+    ensureDirFor(file);
+    writeFileSync(file, `${JSON.stringify(data, null, 2)}\n`, 'utf8');
+}
+/** Same contract as readJsonFile, for YAML. */
+export function readYamlFile(file) {
+    if (!existsSync(file))
+        return {};
+    const raw = readFileSync(file, 'utf8').trim();
+    if (!raw)
+        return {};
+    try {
+        const parsed = parseYaml(raw);
+        return parsed && typeof parsed === 'object' ? parsed : {};
+    }
+    catch (e) {
+        throw new Error(`${file} is not valid YAML. Fix or move it, then re-run — refusing to overwrite it.`, { cause: e });
+    }
+}
+export function writeYamlFile(file, data) {
+    ensureDirFor(file);
+    writeFileSync(file, stringifyYaml(data), 'utf8');
+}
+/** Fetch (or create) a nested object property without discarding what is already inside it. */
+export function objectAt(root, key) {
+    const cur = root[key];
+    if (cur && typeof cur === 'object' && !Array.isArray(cur))
+        return cur;
+    const fresh = {};
+    root[key] = fresh;
+    return fresh;
+}
+//# sourceMappingURL=fs-merge.js.map

package/dist/src/cli/connect/clients/fs-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-merge.js","sourceRoot":"","sources":["../../../../../src/cli/connect/clients/fs-merge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC3F,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AAEtE,iDAAiD;AACjD,MAAM,UAAU,YAAY,CAAC,IAAY;IACrC,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,IAAY;IAC/B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,GAAG,GAAG,GAAG,IAAI,aAAa,CAAC;IACjC,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACxB,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACrC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,IAAI,CAAC;QACD,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,OAAO,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAiC,CAAC,CAAC,CAAC,EAAE,CAAC;IACzF,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,6EAA6E,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IACxH,CAAC;AACL,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,IAA6B;IACrE,YAAY,CAAC,IAAI,CAAC,CAAC;IACnB,aAAa,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACtE,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,YAAY,CAAC,IAAY;IACrC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,IAAI,CAAC;QACD,MAAM,MAAM,GAAY,SAAS,CAAC,GAAG,CAAC,CAAC;QACvC,OAAO,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAiC,CAAC,CAAC,CAAC,EAAE,CAAC;IACzF,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,6EAA6E,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IACxH,CAAC;AACL,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,IAA6B;IACrE,YAAY,CAAC,IAAI,CAAC,CAAC;IACnB,aAAa,CAAC,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;AACrD,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,QAAQ,CAAC,IAA6B,EAAE,GAAW;IAC/D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACtB,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,GAA8B,CAAC;IACjG,MAAM,KAAK,GAA4B,EAAE,CAAC;IAC1C,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAClB,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/dist/src/cli/connect/clients/goose.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @file goose.ts
+ * @description Goose adapter. Goose keeps one YAML config with an `extensions` map and speaks
+ *   Streamable HTTP natively, and it expands `${VAR}` inside header values from the merged
+ *   env/env_keys map — so the agent token stays in the environment and never in the file.
+ * @structure
+ *   - configPath() — per-platform config.yaml location.
+ *   - apply() — merge one `extensions.<name>` entry, write the launcher, report next steps.
+ * @usage Registered in clients/registry.ts as `goose`.
+ * @version-history
+ *   v1.0.0 — 2026-08-02 — Initial creation: one-command client connect.
+ */
+import type { ClientAdapter } from './types.js';
+export declare const gooseAdapter: ClientAdapter;
+//# sourceMappingURL=goose.d.ts.map

package/dist/src/cli/connect/clients/goose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goose.d.ts","sourceRoot":"","sources":["../../../../../src/cli/connect/clients/goose.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,aAAa,EAA6B,MAAM,YAAY,CAAC;AAc3E,eAAO,MAAM,YAAY,EAAE,aA6C1B,CAAC"}

package/dist/src/cli/connect/clients/goose.js

@@ -0,0 +1,67 @@
+/**
+ * @file goose.ts
+ * @description Goose adapter. Goose keeps one YAML config with an `extensions` map and speaks
+ *   Streamable HTTP natively, and it expands `${VAR}` inside header values from the merged
+ *   env/env_keys map — so the agent token stays in the environment and never in the file.
+ * @structure
+ *   - configPath() — per-platform config.yaml location.
+ *   - apply() — merge one `extensions.<name>` entry, write the launcher, report next steps.
+ * @usage Registered in clients/registry.ts as `goose`.
+ * @version-history
+ *   v1.0.0 — 2026-08-02 — Initial creation: one-command client connect.
+ */
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { backup, objectAt, readYamlFile, writeYamlFile } from './fs-merge.js';
+import { writeLauncher } from './launcher.js';
+function gooseConfigPath() {
+    if (process.platform === 'win32') {
+        const appData = process.env.APPDATA ?? join(homedir(), 'AppData', 'Roaming');
+        return join(appData, 'Block', 'goose', 'config', 'config.yaml');
+    }
+    // macOS and Linux both use the XDG-style path.
+    const xdg = process.env.XDG_CONFIG_HOME ?? join(homedir(), '.config');
+    return join(xdg, 'goose', 'config.yaml');
+}
+export const gooseAdapter = {
+    id: 'goose',
+    label: 'Goose',
+    transport: 'http',
+    configPath: gooseConfigPath,
+    async apply(target) {
+        const file = gooseConfigPath();
+        const config = readYamlFile(file);
+        const bak = backup(file);
+        const extensions = objectAt(config, 'extensions');
+        extensions[target.serverName] = {
+            type: 'streamable_http',
+            name: target.serverName,
+            description: `AIMEAT node tools from ${target.nodeUrl}`,
+            uri: target.mcpUrl,
+            headers: { Authorization: 'Bearer ${AIMEAT_AGENT_TOKEN}' },
+            env_keys: ['AIMEAT_AGENT_TOKEN'],
+            enabled: true,
+            timeout: 600,
+        };
+        // Goose needs its own file/shell extension to write the apps it builds. Leave an existing
+        // entry exactly as the user set it; only add it when it is absent.
+        if (!extensions.developer) {
+            extensions.developer = {
+                type: 'builtin', name: 'developer', display_name: 'Developer',
+                enabled: true, bundled: true, timeout: 300,
+            };
+        }
+        writeYamlFile(file, config);
+        const scripts = writeLauncher(target, 'goose', 'goose', ['session']);
+        return {
+            written: [file, ...scripts],
+            backedUp: bak ? [bak] : [],
+            nextSteps: [
+                `Start it with:  ${scripts[0]}`,
+                'Inside the session, /mode auto stops the per-tool confirmations and /model <id> switches model.',
+                'Set OPENROUTER_API_KEY (or your provider key) in the environment before launching.',
+            ],
+        };
+    },
+};
+//# sourceMappingURL=goose.js.map

package/dist/src/cli/connect/clients/goose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goose.js","sourceRoot":"","sources":["../../../../../src/cli/connect/clients/goose.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,SAAS,eAAe;IACpB,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QAC7E,OAAO,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IACpE,CAAC;IACD,+CAA+C;IAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IACtE,OAAO,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAkB;IACvC,EAAE,EAAE,OAAO;IACX,KAAK,EAAE,OAAO;IACd,SAAS,EAAE,MAAM;IACjB,UAAU,EAAE,eAAe;IAE3B,KAAK,CAAC,KAAK,CAAC,MAAoB;QAC5B,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAEzB,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAClD,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG;YAC5B,IAAI,EAAE,iBAAiB;YACvB,IAAI,EAAE,MAAM,CAAC,UAAU;YACvB,WAAW,EAAE,0BAA0B,MAAM,CAAC,OAAO,EAAE;YACvD,GAAG,EAAE,MAAM,CAAC,MAAM;YAClB,OAAO,EAAE,EAAE,aAAa,EAAE,8BAA8B,EAAE;YAC1D,QAAQ,EAAE,CAAC,oBAAoB,CAAC;YAChC,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,GAAG;SACf,CAAC;QAEF,0FAA0F;QAC1F,mEAAmE;QACnE,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC;YACxB,UAAU,CAAC,SAAS,GAAG;gBACnB,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW;gBAC7D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG;aAC7C,CAAC;QACN,CAAC;QAED,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC5B,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;QAErE,OAAO;YACH,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,OAAO,CAAC;YAC3B,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE;YAC1B,SAAS,EAAE;gBACP,mBAAmB,OAAO,CAAC,CAAC,CAAC,EAAE;gBAC/B,iGAAiG;gBACjG,oFAAoF;aACvF;SACJ,CAAC;IACN,CAAC;CACJ,CAAC"}

package/dist/src/cli/connect/clients/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @file index.ts
+ * @description `aimeat connect client <id>` — one command that points a chat client at this node:
+ *   it authorizes a dedicated agent into its own connector home, writes the client's MCP config,
+ *   and leaves a launcher that supplies the token at run time. The point is that talking to AIMEAT
+ *   from a client of your choice should be one command, not a page of manual steps.
+ * @structure
+ *   - CLIENTS — the adapter registry (goose, claude-code, cursor, vscode, claude-desktop).
+ *   - runConnectClient() — resolve client, ensure credential, apply adapter, report.
+ *   - resolveTarget() — flags + defaults into a ClientTarget (home, workdir, server name, surface).
+ * @usage Dispatched from src/index-connect.ts on `aimeat connect client <id> [flags]`.
+ * @version-history
+ *   v1.0.0 — 2026-08-02 — Initial creation: one-command client connect.
+ */
+import type { ClientAdapter } from './types.js';
+export declare const CLIENTS: ClientAdapter[];
+/**
+ * Run the one-command connect. Device authorization happens FIRST and inside the client's own
+ * home, so a failed or cancelled login never leaves a config pointing at an agent that does not
+ * exist.
+ */
+export declare function runConnectClient(clientId: string | undefined, flags: Record<string, string>): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/cli/connect/clients/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/cli/connect/clients/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,YAAY,CAAC;AAK9D,eAAO,MAAM,OAAO,EAAE,aAAa,EAElC,CAAC;AAoEF;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAyDjH"}