@oddessentials/agent-guild 1.21.2 → 1.22.1

package/bin/agent-guild.mjs

@@ -360,6 +360,8 @@ async function main() {
     }
     case 'mcp': {
       // stdout carries only protocol messages from here on.
+      const home = args.find((a) => a.startsWith('--home='))?.slice('--home='.length);
+      if (home) process.env.AGENT_GUILD_HOME = home;
       const { serveMcp } = await import('../src/mcp/server.mjs');
       await serveMcp({ allowInput: flags.has('--allow-input') });
       return undefined;

package/config/providers.default.json

@@ -12,6 +12,7 @@
       "memory": "claude",
       "instructions": "claude",
       "reporting": "claude",
+      "mcp": "claude",
       "homeVar": "CLAUDE_CONFIG_DIR",
       "accountEnv": { "CLAUDE_SECURESTORAGE_CONFIG_DIR": "{dir}" },
       "hooks": { "path": "settings.json", "example": "claude-code-settings.json" },
@@ -55,6 +56,7 @@
       "memory": "codex",
       "instructions": "codex",
       "reporting": "codex",
+      "mcp": "codex",
       "homeVar": "CODEX_HOME",
       "hooks": { "path": "hooks.json", "example": "codex-hooks.json" },
       "modelPattern": "\\bgpt-\\d[a-z0-9.-]*",
@@ -93,6 +95,7 @@
       "history": "antigravity",
       "instructions": "google",
       "reporting": "antigravity",
+      "mcp": "antigravity",
       "modelPattern": "\\bgemini-\\d[a-z0-9.-]*",
       "args": [],
       "resumeArgs": ["--conversation", "{id}"],
@@ -126,6 +129,7 @@
       "memory": "grok",
       "instructions": "grok",
       "reporting": "grok",
+      "mcp": "grok",
       "homeVar": "GROK_HOME",
       "hooks": { "path": "hooks/agent-guild.json", "example": "grok-hooks.json" },
       "modelPattern": "\\bgrok-(?:build|\\d)[a-z0-9.-]*",

package/docs/api.md

@@ -123,8 +123,10 @@ whether its folder is on PATH. `uninstall` is null when Agent Guild cannot
 remove that copy, and `uninstallGuidance` then says how to remove it instead.
 `POST /providers/:id/uninstall` removes one copy.
 
-For a tool that is a Docker CLI plugin (Docker Agent), `installCommand` is the
-command **Install** and **Update** run. `pluginError` says why docker could not
+`installCommand` is the command **Install** and **Update** run for a tool that
+is a Docker CLI plugin (Docker Agent), or that a configured install command
+updates by running again, and null otherwise. `plugin` names the Docker CLI
+plugin the tool is, or is null. `pluginError` says why docker could not
 list the plugin's copies, or is null; `pluginPending` is true until docker has
 listed them once.
 
@@ -151,7 +153,35 @@ leaves the multiplexer's own session running, and
 
 For a tool whose agent or model reporting has to be turned on,
 `reportingEnabled` says whether it is, and `reportingNote` says why that switch
-cannot be used, or is null. `usageUrl`, `billingUrl` and `cloudUrl` are
+cannot be used, or is null.
+
+`mcp` is null unless the tool is installed and Agent Guild can add its own MCP
+server (`agent-guild mcp`, see [mcp.md](mcp.md)) to the tool's settings:
+Claude Code, Codex CLI, Antigravity CLI and Grok Build. Otherwise it is
+`{ mode, accounts }`: `mode` is `claude`, `codex`, `antigravity` or `grok`, and
+`accounts` has one `{ id, label, state, managed, from, command, allowInput,
+detail, fingerprint }` per account, read from that account's settings. A
+settings file the tool keeps as JSON is read again when it changes; a tool
+asked through its CLI is asked again after a minute.
+
+`state` is `checking` before the first read, `off`, `on`, `disabled` (turned
+off in the tool), `conflict` or `error`. `on` and `disabled` mean the entry
+named agent-guild starts Agent Guild's MCP server (`agent-guild mcp`, `npx
+@oddessentials/agent-guild mcp` or Node running its `bin/agent-guild.mjs mcp`)
+and reaches this manager's data folder, as the tool would start it: from
+the first `--home=` when it names a folder, else the entry's `AGENT_GUILD_HOME`, else `APPDATA`,
+`XDG_CONFIG_HOME` or the home folder from the tool's environment.
+`conflict` is any other entry of that name, including one whose data folder
+depends on an `AGENT_GUILD_HOME` set where the tool starts; `error` means the
+tool's settings could not be read. `detail` says why for both. `managed` is
+true for the entry Agent Guild adds itself. `from` names the other tool whose
+settings the entry comes from (Grok Build loads Claude Code's and Cursor's), or
+is null. `command` is the entry's command line. `fingerprint` identifies the
+whole entry as read, or is null for `checking` and `error`. An account whose
+home folder does not exist yet reads `off`, and turning the server on makes
+the folder.
+
+`usageUrl`, `billingUrl` and `cloudUrl` are
 `https://` links to the vendor's usage and billing pages and web app, or null.
 
 ### Manager environment
@@ -622,6 +652,7 @@ All paths are under `/api/v1`.
 | PATCH | `/providers/:id/accounts/:account` | `{ label, revision }` | `{ account, dir, providers, revision }`: renames an account, including `default`. |
 | DELETE | `/providers/:id/accounts/:account?revision=` | | `{ account, dir, providers, revision }`: removes an account from `providers.json`. Its home folder, `dir`, stays on disk. 409 `default_account` for `default`; 409 `account_in_use` while a running session uses it. |
 | POST | `/providers/:id/reporting` | `{ enabled }` | `{ provider }`: turns agent or model reporting on or off for a tool that has `reportingEnabled`. |
+| POST | `/providers/:id/mcp` | `{ account, action, expect }` | `{ provider, result }`: changes Agent Guild's MCP server in one account's settings. `action` is `on` (add it, or turn it on in the tool), `off` (remove Agent Guild's entry, or turn off one that comes from another tool's settings) or `replace` (put Agent Guild's own entry in place of the one there). `expect` is the account's `fingerprint`: the account is read again first, and nothing changes unless the entry is still that one. `result` is `{ outcome, state, detail? }`, `outcome` `changed`, `unchanged` or `failed`. 400 `not_applicable` for a tool without `mcp`; 404 `unknown_account`; 409 `provider_unavailable` when it is not installed, `busy` while a change for that tool is running, `changed` when the entry is no longer `expect`, `unreadable` when the settings cannot be read, `conflict` for `on` or `off` on another server of that name, `needs_replace` for `on` on a Codex CLI entry Agent Guild did not add. |
 | POST | `/providers/:id/install` | `{ force? }` | `201 { session }`: a session that installs or updates the tool. 409 `provider_in_use` (with `running`, the session count) while the provider's sessions are running; retry with `force: true` after the user confirms. |
 | POST | `/providers/:id/uninstall` | `{ path, force? }` | `201 { session }`: a session that removes the copy at `path`, one of the provider's `installs`. `force` as for `install`. |
 | GET | `/environment?scope=&cwd=&id=` | | An environment snapshot; see [Manager environment](#manager-environment). |

package/examples/terminal-ai-chat.json

@@ -0,0 +1,27 @@
+{
+  "providers": [
+    {
+      "id": "terminal-ai-chat",
+      "vendor": "Odd Essentials",
+      "tool": "Terminal AI Chat",
+      "command": "terminal-ai-chat",
+      "versionArgs": ["--version"],
+      "color": "#E11D48",
+      "monogram": "T",
+      "releases": "https://github.com/oddessentials/terminal-ai-chat-releases/releases/latest",
+      "install": "curl -fsSL https://github.com/oddessentials/terminal-ai-chat-releases/releases/latest/download/install.sh | sh",
+      "docs": "https://github.com/oddessentials/terminal-ai-chat-releases",
+      "channels": {
+        "native": { "paths": ["~/.local/bin/terminal-ai-chat"], "remove": ["~/.local/bin/terminal-ai-chat"], "reinstall": true, "versionEnv": "TAC_VERSION" },
+        "brew": { "names": ["terminal-ai-chat"] }
+      },
+      "win32": {
+        "install": "irm https://github.com/oddessentials/terminal-ai-chat-releases/releases/latest/download/install.ps1 | iex",
+        "channels": {
+          "native": { "paths": ["~/AppData/Local/Programs/terminal-ai-chat"], "remove": ["~/AppData/Local/Programs/terminal-ai-chat"], "reinstall": true, "versionEnv": "TAC_VERSION" },
+          "winget": { "id": "OddEssentials.TerminalAIChat" }
+        }
+      }
+    }
+  ]
+}

package/node_modules/smol-toml/LICENSE

@@ -0,0 +1,24 @@
+Copyright (c) Squirrel Chat et al., All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+3. Neither the name of the copyright holder nor the names of its contributors
+   may be used to endorse or promote products derived from this software without
+   specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.