ada-agent 0.1.0 → 0.2.0

package/docs/connectors.md

@@ -1,48 +1,49 @@
-# Connectors (MCP)
-
-ada connects to external tools and data through the **Model Context Protocol (MCP)**. Each connector
-is an MCP server; ada spawns or calls it, lists its tools, and registers them as ada tools named
-`<server>__<tool>` — approval-gated, and only loaded for **trusted projects**.
-
-## Quick start
-
-```bash
-ada mcp                       # list the connector catalog (● configured · ○ available)
-ada mcp add github            # write the github entry into .ada/mcp.json
-ada mcp remove github         # remove it
-```
-
-After `add`, set any env vars it prints (e.g. `GITHUB_PERSONAL_ACCESS_TOKEN`), then start `ada` in
-that project — the connector's tools appear automatically.
-
-## Catalog
-
-`filesystem` · `github` · `git` · `postgres` · `sqlite` · `fetch` · `brave-search` · `puppeteer` ·
-`slack` · `memory` · `sentry`. Run `ada mcp` for the live list and which env vars each needs.
-
-## Config: `.ada/mcp.json`
-
-`ada mcp add` edits this file, but you can also write entries by hand. Two transports:
-
-```jsonc
-{
-  "servers": {
-    // local stdio server (a subprocess)
-    "fs":     { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "."] },
-    // remote server over Streamable HTTP
-    "remote": { "url": "https://mcp.example.com/v1", "headers": { "Authorization": "Bearer <token>" } }
-  }
-}
-```
-
-- **stdio** — `{ command, args, env }`: ada launches the process and speaks JSON-RPC over stdin/stdout.
-- **http** — `{ url, headers }`: ada POSTs JSON-RPC and reads a JSON or SSE response (Streamable HTTP).
-
-## Notes
-
-- MCP servers run code / reach the network, so they load **only in trusted projects** (the same trust
-  gate as `.ada` prompts and settings). Untrusted projects skip them.
-- Every MCP tool is **approval-gated** — ada prompts before each call.
-- Secrets come from **env vars** (referenced in the server's `env`), never committed to `.ada/mcp.json`.
-- See the `connectors` skill category (`list_skills {category: "connectors"}`) for per-connector setup
-  walk-throughs, and the `mcp-server` skill to build your own.
+# Connectors (MCP)
+
+ada connects to external tools and data through the **Model Context Protocol (MCP)**. Each connector
+is an MCP server; ada spawns or calls it, lists its tools, and registers them as ada tools named
+`<server>__<tool>` — approval-gated, and only loaded for **trusted projects**.
+
+## Quick start
+
+```bash
+ada mcp                       # list the connector catalog (● configured · ○ available)
+ada mcp add github            # write the github entry into .ada/mcp.json
+ada mcp remove github         # remove it
+```
+
+After `add`, set any env vars it prints (e.g. `GITHUB_PERSONAL_ACCESS_TOKEN`), then start `ada` in
+that project — the connector's tools appear automatically.
+
+## Catalog
+
+`filesystem` · `github` · `git` · `postgres` · `sqlite` · `fetch` · `brave-search` · `puppeteer` ·
+`slack` · `memory` · `sentry`. Run `ada mcp` for the live list and which env vars each needs.
+
+## Config: `.ada/mcp.json`
+
+`ada mcp add` edits this file, but you can also write entries by hand. Two transports:
+
+```jsonc
+{
+  "servers": {
+    // local stdio server (a subprocess)
+    "fs":     { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "."] },
+    // remote server over Streamable HTTP
+    "remote": { "url": "https://mcp.example.com/v1", "headers": { "Authorization": "Bearer <token>" } }
+  }
+}
+```
+
+- **stdio** — `{ command, args, env }`: ada launches the process and speaks JSON-RPC over stdin/stdout.
+- **http** — `{ url, headers }`: ada POSTs JSON-RPC and reads a JSON or SSE response (Streamable HTTP).
+
+## Notes
+
+- MCP servers run code / reach the network, so they load **only in trusted projects** (the same trust
+  gate as `.ada` prompts and settings). Untrusted projects skip them.
+- Every MCP tool is **approval-gated** — ada prompts before each call (in `ask` mode).
+- A server's **resources** are reachable through a generated `<server>__read_resource` tool.
+- Secrets come from **env vars** (referenced in the server's `env`), never committed to `.ada/mcp.json`.
+- See the `connectors` skill category (`list_skills {category: "connectors"}`) for per-connector setup
+  walk-throughs, and the `mcp-server` skill to build your own.

package/docs/integrations.md

@@ -1,59 +1,62 @@
-# Integrating with ada
-
-ada exposes a few programmatic surfaces so other tools can drive it. The buildable foundations are
-shipped; the product surfaces that need *external* infrastructure (a Slack app, hosting, an Electron
-build, an IdP) are described with what they'd take — they can't be "live" without your accounts.
-
-## HTTP API — `ada serve`
-
-```bash
-ada serve            # → http://localhost:8788  (ADA_HTTP_PORT to change)
-```
-- `GET /health` → `{ ok, model }`
-- `POST /v1/prompt` `{ "text": "...", "model"?: "..." }` → `{ text, usage }` (runs a fresh agent turn)
-
-## Typed SDK — `src/sdk`
-
-```ts
-import { createClient } from "ada/sdk"; // or "./src/sdk/index.ts" in-repo
-const ada = createClient("http://localhost:8788");
-console.log(await ada.health());
-const { text } = await ada.prompt("list the files in this project");
-```
-
-## ACP bridge — `ada acp`
-
-A minimal Agent Client Protocol bridge over stdio (JSON-RPC 2.0, newline-delimited): handles
-`initialize` and `session/prompt`, so an ACP-aware editor can drive ada. It's a **scaffold** — method
-names and framing may need adjusting to your client's ACP version.
-
-## Session share — `ada share`
-
-```bash
-ada share              # serve the latest session as a read-only web page (localhost)
-ada share <name|file>  # a specific session
-```
-Local and read-only. A *public* share link would need a hosted backend to receive and serve the
-transcript (see below).
-
----
-
-## Needs your infrastructure (foundations are here; the rest is your accounts/hosting)
-
-These are all buildable **on top of the HTTP API / SDK above** — what's missing is the external
-service, which only you can provision.
-
-- **Slack bot** — a [Slack Bolt](https://slack.dev/bolt-js) app that, per thread, calls
-  `createClient().prompt(message)` and posts the reply. Needs a **Slack app + bot token** (`SLACK_BOT_TOKEN`)
-  and a running process. ~30 lines on top of the SDK.
-- **Web console** — a single page that POSTs to `/v1/prompt` and renders the reply (the `ada share`
-  server is a minimal read-only version). Needs **hosting** + CORS if cross-origin.
-- **Desktop app** — an Electron shell that spawns `ada serve` and points a webview at it. Needs the
-  **Electron build/packaging** pipeline (you already have the separate `ada-ide` VS Code fork).
-- **Public session sharing** — `ada share` is local; a public link needs a **hosted endpoint** to
-  receive the transcript and a viewer (like opencode's `console.opncd.ai`).
-- **Enterprise / identity / teams** — multi-tenant accounts + SSO need an **IdP and a control plane**;
-  out of scope for a single-binary CLI.
-- **SQLite session store** — ada uses append-only JSONL (`.ada/sessions/*.jsonl`) by design (no native
-  dep, greppable, trivially portable). Node 24 ships an experimental `node:sqlite`; a SQLite backend is
-  a drop-in for `session.ts` if you want indexed queries — say the word and it's a small module.
+# Integrating with ada
+
+ada exposes a few programmatic surfaces so other tools can drive it. The buildable foundations are
+shipped; the product surfaces that need *external* infrastructure (a Slack app, hosting, an Electron
+build, an IdP) are described with what they'd take — they can't be "live" without your accounts.
+
+## HTTP API — `ada serve`
+
+```bash
+ada serve            # → http://localhost:8788  (ADA_HTTP_PORT to change)
+```
+- `GET /health` → `{ ok, model }`
+- `POST /v1/prompt` `{ "text": "...", "model"?: "..." }` → `{ text, usage }` (runs a fresh agent turn)
+
+## Typed SDK — `src/sdk`
+
+```ts
+import { createClient } from "ada-agent/sdk"; // in-repo: "./src/sdk/index.ts"
+const ada = createClient("http://localhost:8788");
+console.log(await ada.health());
+const { text } = await ada.prompt("list the files in this project");
+```
+
+It's a ~30-line `fetch` wrapper over the HTTP API above — if you'd rather not pull in the source,
+just POST to `/v1/prompt` directly.
+
+## ACP bridge — `ada acp`
+
+A minimal Agent Client Protocol bridge over stdio (JSON-RPC 2.0, newline-delimited): handles
+`initialize` and `session/prompt`, so an ACP-aware editor can drive ada. It's a **scaffold** — method
+names and framing may need adjusting to your client's ACP version.
+
+## Session share — `ada share`
+
+```bash
+ada share              # serve the latest session as a read-only web page (localhost)
+ada share <name|file>  # a specific session
+```
+Local and read-only. A *public* share link would need a hosted backend to receive and serve the
+transcript (see below).
+
+---
+
+## Needs your infrastructure (foundations are here; the rest is your accounts/hosting)
+
+These are all buildable **on top of the HTTP API / SDK above** — what's missing is the external
+service, which only you can provision.
+
+- **Slack bot** — a [Slack Bolt](https://slack.dev/bolt-js) app that, per thread, calls
+  `createClient().prompt(message)` and posts the reply. Needs a **Slack app + bot token** (`SLACK_BOT_TOKEN`)
+  and a running process. ~30 lines on top of the SDK.
+- **Web console** — a single page that POSTs to `/v1/prompt` and renders the reply (the `ada share`
+  server is a minimal read-only version). Needs **hosting** + CORS if cross-origin.
+- **Desktop app** — an Electron shell that spawns `ada serve` and points a webview at it. Needs the
+  **Electron build/packaging** pipeline (you already have the separate `ada-ide` VS Code fork).
+- **Public session sharing** — `ada share` is local; a public link needs a **hosted endpoint** to
+  receive the transcript and a viewer (like opencode's `console.opncd.ai`).
+- **Enterprise / identity / teams** — multi-tenant accounts + SSO need an **IdP and a control plane**;
+  out of scope for a single-binary CLI.
+- **SQLite session store** — ada uses append-only JSONL (`.ada/sessions/*.jsonl`) by design (no native
+  dep, greppable, trivially portable). Node 24 ships an experimental `node:sqlite`; a SQLite backend is
+  a drop-in for `session.ts` if you want indexed queries — say the word and it's a small module.

package/package.json

@@ -1,64 +1,65 @@
-{
-  "name": "ada-agent",
-  "version": "0.1.0",
-  "description": "A from-zero terminal coding agent with a Cursor-style routing backend, ~285 skills, MCP connectors, and ask/plan/auto modes",
-  "type": "module",
-  "license": "MIT",
-  "author": "Aditya",
-  "homepage": "https://github.com/black141312/ada#readme",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/black141312/ada.git"
-  },
-  "bugs": {
-    "url": "https://github.com/black141312/ada/issues"
-  },
-  "keywords": [
-    "coding-agent",
-    "ai-agent",
-    "llm",
-    "cli",
-    "terminal",
-    "tui",
-    "mcp",
-    "openai",
-    "anthropic",
-    "ollama",
-    "agentic",
-    "developer-tools"
-  ],
-  "bin": {
-    "ada": "bin/ada.mjs",
-    "ada-server": "bin/ada-server.mjs"
-  },
-  "files": [
-    "bin/",
-    "src/",
-    "skills/",
-    "docs/",
-    "bench/",
-    "tsconfig.json",
-    "README.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "scripts": {
-    "start": "tsx src/client/cli.ts",
-    "server": "tsx src/server/index.ts",
-    "typecheck": "tsc --noEmit",
-    "selfcheck": "tsx src/selfcheck.ts",
-    "bench:swebench": "node bench/swebench.mjs"
-  },
-  "dependencies": {
-    "@anthropic-ai/sdk": "^0.106.0",
-    "node-pty": "^1.1.0",
-    "openai": "^6.45.0",
-    "tsx": "^4.22.4"
-  },
-  "devDependencies": {
-    "@types/node": "^26.0.1",
-    "typescript": "^6.0.3"
-  }
-}
+{
+  "name": "ada-agent",
+  "version": "0.2.0",
+  "description": "A from-zero terminal coding agent with a Cursor-style routing backend, ~285 skills, MCP connectors, and ask/plan/auto modes",
+  "type": "module",
+  "license": "MIT",
+  "author": "Aditya",
+  "homepage": "https://github.com/black141312/ada#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/black141312/ada.git"
+  },
+  "bugs": {
+    "url": "https://github.com/black141312/ada/issues"
+  },
+  "keywords": [
+    "coding-agent",
+    "ai-agent",
+    "llm",
+    "cli",
+    "terminal",
+    "tui",
+    "mcp",
+    "openai",
+    "anthropic",
+    "ollama",
+    "agentic",
+    "developer-tools"
+  ],
+  "bin": {
+    "ada": "bin/ada.mjs",
+    "ada-server": "bin/ada-server.mjs"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "skills/",
+    "docs/",
+    "bench/",
+    "tsconfig.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "start": "tsx src/client/cli.ts",
+    "server": "tsx src/server/index.ts",
+    "typecheck": "tsc --noEmit",
+    "selfcheck": "tsx src/selfcheck.ts",
+    "bench:swebench": "node bench/swebench.mjs",
+    "catalog:refresh": "node scripts/refresh-catalog.mjs"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.106.0",
+    "node-pty": "^1.1.0",
+    "openai": "^6.45.0",
+    "tsx": "^4.22.4"
+  },
+  "devDependencies": {
+    "@types/node": "^26.0.1",
+    "typescript": "^6.0.3"
+  }
+}