@contextq/mcp 0.0.1 → 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 HENIART
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,9 +1,165 @@
 # @contextq/mcp
 
-**This is a name-reservation placeholder. It contains no code and does nothing.**
+MCP server for ContextQ -- exposes the ContextQ knowledge-management API (89 tools: save, search, ingest, goal graphs, agent sessions, relays, and more) as Model Context Protocol tools. A curated ~24-tool default set loads at connection to keep the token cost of `tools/list` low; the rest load on demand or via `CONTEXT_MCP_TOOL_PROFILE=full` -- see below.
 
-The real `@contextq/mcp` is built at
-[HENIART/contextq](https://github.com/HENIART/contextq) under `mcp/`
-(version 2.0.0 at the time of this reservation) and is not published yet.
+```bash
+npx -y @contextq/mcp
+```
 
-Do not depend on this version. Watch the repository for the first real release.
+## Client configuration
+
+Two environment variables are required in every client:
+
+| Variable | Description |
+|---|---|
+| `CONTEXT_API_URL` | Base URL of your ContextQ server (e.g. `https://ctx.example.com`) |
+| `CONTEXT_API_KEY` | API key sent as `Authorization: Bearer` on every request |
+
+Optional:
+
+| Variable | Description |
+|---|---|
+| `CONTEXT_MCP_TOOL_PROFILE` | `default` (default if unset) loads a curated ~24-tool set at connection, well under most hosts' comfortable tool-list budget; `full` loads all ~89 tools from the start. On `default`, the rest stay reachable via the `ctx_tool_groups` (list) / `ctx_load_tool_group` (load) tools without reconnecting -- see `docs/mcp-tools.md` "Discoverability under ToolSearch deferral" |
+
+**Setup paths**: Claude Code and Claude Desktop have automated setup via the `contextq init` CLI command. Cursor, Windsurf, and Cline require manual config file editing — see `docs/mcp-setup.md` for the full reference.
+
+### Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "contextq": {
+      "command": "npx",
+      "args": ["-y", "@contextq/mcp"],
+      "env": {
+        "CONTEXT_API_KEY": "sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+        "CONTEXT_API_URL": "https://ctx.example.com"
+      }
+    }
+  }
+}
+```
+
+### Claude Code
+
+```bash
+claude mcp add contextq \
+  -e CONTEXT_API_KEY=sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx \
+  -e CONTEXT_API_URL=https://ctx.example.com \
+  -- npx -y @contextq/mcp
+```
+
+### Cursor
+
+Add to your Cursor MCP config (`.cursor/mcp.json` or Settings > MCP):
+
+```json
+{
+  "mcpServers": {
+    "contextq": {
+      "command": "npx",
+      "args": ["-y", "@contextq/mcp"],
+      "env": {
+        "CONTEXT_API_KEY": "sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+        "CONTEXT_API_URL": "https://ctx.example.com"
+      }
+    }
+  }
+}
+```
+
+### Windsurf
+
+**STATUS (2026-06-02)**: Windsurf was rebranded as Devin Desktop and Cascade was end-of-lifed (2026-07-01). If you have an existing Windsurf install, the configuration below still applies, but new installations should use Devin Desktop instead. Devin Desktop uses the same MCP config format under `.devin/mcp.json`.
+
+Add to your Windsurf MCP config (`.windsurf/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "contextq": {
+      "command": "npx",
+      "args": ["-y", "@contextq/mcp"],
+      "env": {
+        "CONTEXT_API_KEY": "sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+        "CONTEXT_API_URL": "https://ctx.example.com"
+      }
+    }
+  }
+}
+```
+
+## What data is sent and tenant isolation
+
+- **Only the requests your agent makes are sent.** The MCP server is a stateless proxy -- it forwards each tool call to the ContextQ API via `CONTEXT_API_URL` and returns the response. No telemetry, no background sync, no usage tracking beyond what your ContextQ server logs.
+- **Tenant-scoped API keys.** Every ContextQ API key is bound to a single tenant. All `/api/*` endpoints enforce tenant isolation -- an API key can only access the tenant it was issued for. Cross-tenant data leaks are impossible at the API layer.
+- **Per-request auth.** Your `CONTEXT_API_KEY` is sent as an `Authorization: Bearer` header on every call. It never appears in tool names, argument schemas, or responses returned to the LLM.
+
+## Client timeout configuration
+
+A handful of ContextQ tools run LLM calls, kNN scans, or bulk DB operations server-side and can legitimately take longer than a typical MCP client's default request timeout. If your client aborts before the server responds, you will see a timeout error that looks like a broken tool — it usually isn't. Configure a longer per-server timeout for this MCP server rather than assuming the tool is hung.
+
+**Slow-class tools** (recommend a longer timeout, e.g. 120000-180000 ms depending on workspace size):
+
+| Tool | Why it's slow |
+|---|---|
+| `ctx_dream` | Clusters a workspace's contexts via vector similarity, then runs one LLM synthesis call per cluster. |
+| `ctx_evolve` | Runs LLM judging over up to 20 nearest-neighbor contexts to decide links/archival. |
+| `ctx_ingest` | Fetches/parses a source and runs LLM claim extraction + kNN diffing. Large or URL-sourced ingests already return `{ jobId, statusUrl }` and expect polling via `ctx_ingest_status` — but small inline ingests still run synchronously and can take several seconds. |
+| `ctx_regenerate_mocs` | Re-clusters all of a tenant's contexts and runs one LLM synthesis call per cluster (admin scope). |
+| `ctx_memory_review_run` | Samples older contexts and asks the LLM to verdict each one (superadmin scope). |
+| `ctx_bulk_update` | Applies a lifecycle/archive patch to up to 200 context ids in one call — bounded, but still slower than a single-row update. |
+| `ctx_audit_cleanup_run` | Deletes up to 5000 `activity_logs` rows in one pass (superadmin scope). |
+| `ctx_snapshot_create` / `ctx_fork_world` / `ctx_diff_world` | Clone or diff a workspace's full memory state (contexts, links, goal graph) — cost scales with workspace size. |
+
+Everything else (`ctx_search`, `ctx_get`, `ctx_save`, `ctx_list`, `agent_*`, `goal_*`, `relay_*`, etc.) is ordinary CRUD/search and should complete well within a default client timeout.
+
+These numbers are starting points, not guarantees — actual latency depends on your ContextQ server's hardware, workspace size, and configured LLM/embedding provider. Measure against your own deployment before tuning tighter.
+
+### `.mcp.json` per-server `request_timeout_ms`
+
+Most MCP clients that support `.mcp.json` (including Claude Code) accept a per-server `request_timeout_ms` to override the client's default request timeout for every tool call on that server:
+
+```json
+{
+  "mcpServers": {
+    "contextq": {
+      "command": "npx",
+      "args": ["-y", "@contextq/mcp"],
+      "env": {
+        "CONTEXT_API_KEY": "sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+        "CONTEXT_API_URL": "https://ctx.example.com"
+      },
+      "request_timeout_ms": 120000
+    }
+  }
+}
+```
+
+`request_timeout_ms` applies per server, not per tool — if you regularly call slow-class tools, size it for the slowest one you expect to hit, not the average. Claude Code 2.1.206 fixed a bug where this field was silently ignored (a 60s default was applied regardless); confirm your Claude Code version is at least 2.1.206 if the setting doesn't seem to take effect.
+
+### Claude Code idle timeout
+
+Independently of `request_timeout_ms`, Claude Code (2.1.187+) also enforces `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` — an idle-abort timeout (default around 5 minutes) that fires if an MCP tool call produces no activity for that long. Set it in your shell environment (not `.mcp.json`) when calling slow-class tools against a large workspace:
+
+```bash
+export CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT=300000   # milliseconds; raise if ctx_dream/ctx_ingest still time out
+```
+
+Treat both settings as recommendations, not guarantees, of how long any given call will take.
+
+## API version compatibility
+
+The 89-tool surface exposed by this MCP server is a direct projection of the ContextQ API (24 loaded by default, the rest via `CONTEXT_MCP_TOOL_PROFILE=full` or on-demand -- see "Client configuration" above). The tool count and signatures drift with the server. Pin compatible versions:
+
+| MCP package | ContextQ server API |
+|---|---|
+| `@contextq/mcp@2.x` | ContextQ v2.x (89 tools) |
+
+When upgrading your ContextQ server, check the [changelog](https://github.com/HENIART/contextq/releases) and bump the MCP package to the matching major version. A version mismatch may surface unknown tools or break call signatures.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,210 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { ListToolsRequestSchema, CallToolRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { getActiveTools, handleToolCall } from "./tools.js";
+// ---------------------------------------------------------------------------
+// MCP package version (read from package.json at runtime)
+// ---------------------------------------------------------------------------
+function readPackageVersion() {
+    try {
+        const __dirname = dirname(fileURLToPath(import.meta.url));
+        const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf8"));
+        return pkg.version ?? "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+const MCP_VERSION = readPackageVersion();
+// Minimum API version this MCP supports. Bump when the MCP depends on
+// API-side features that did not exist in older server releases.
+const MIN_API_VERSION = "0.1.0";
+function parseSemVer(v) {
+    const m = v.match(/^(\d+)\.(\d+)\.(\d+)/);
+    if (!m)
+        return null;
+    return { major: Number(m[1]), minor: Number(m[2]), patch: Number(m[3]) };
+}
+function semVerGte(a, b) {
+    if (a.major !== b.major)
+        return a.major > b.major;
+    if (a.minor !== b.minor)
+        return a.minor > b.minor;
+    return a.patch >= b.patch;
+}
+// ---------------------------------------------------------------------------
+// API version handshake
+//
+// On startup, probes the API's health endpoint to read its version and
+// compares it against MIN_API_VERSION.  Mismatches or unreachable APIs
+// produce a warning on stderr but never prevent startup — the tool surface
+// can drift, and connecting an outdated MCP to a newer API (or vice versa)
+// must still work from the MCP side.  The warning is the signal.
+// ---------------------------------------------------------------------------
+async function handshake(baseUrl) {
+    const base = baseUrl.replace(/\/+$/, "");
+    let reachable = false;
+    let apiVersion;
+    // Quick reachability probe via GET /health (always public, no DB hit).
+    try {
+        const resp = await fetch(`${base}/health`, { signal: AbortSignal.timeout(3000), redirect: 'manual' });
+        if (resp.ok) {
+            reachable = true;
+            // Some deployments may embed a version key on the simple endpoint.
+            const body = (await resp.json().catch(() => null));
+            if (body && typeof body.version === "string") {
+                apiVersion = body.version;
+            }
+        }
+    }
+    catch {
+        // /health unreachable — try /health/deep below.
+    }
+    // Deep health returns a `version` field (git SHA in the current server,
+    // may become a semver in future releases).
+    if (!apiVersion) {
+        try {
+            const resp = await fetch(`${base}/health/deep`, { signal: AbortSignal.timeout(3000), redirect: 'manual' });
+            if (resp.ok) {
+                reachable = true;
+                const body = (await resp.json().catch(() => null));
+                if (body && typeof body.version === "string") {
+                    apiVersion = body.version;
+                }
+            }
+        }
+        catch {
+            // Both endpoints unreachable or version-less.
+        }
+    }
+    if (!reachable) {
+        console.error(`[shared-context-mcp] WARNING: API at ${base} is unreachable. ` +
+            `The MCP server has started but tools will return errors until the API becomes reachable.`);
+        return;
+    }
+    if (apiVersion) {
+        const apiSemVer = parseSemVer(apiVersion);
+        const minSemVer = parseSemVer(MIN_API_VERSION);
+        if (apiSemVer && minSemVer) {
+            if (!semVerGte(apiSemVer, minSemVer)) {
+                console.error(`[shared-context-mcp] WARNING: API version ${apiVersion} is older ` +
+                    `than the minimum supported version ${MIN_API_VERSION}. ` +
+                    `The MCP server has started but some tools may behave differently.`);
+            }
+            else {
+                console.error(`[shared-context-mcp] API version ${apiVersion} satisfies min version ${MIN_API_VERSION}.`);
+            }
+        }
+        else {
+            // Version field exists but is not a semver (e.g. a git SHA).
+            // Skip the comparison — can't evaluate.
+            console.error(`[shared-context-mcp] API reports version identifier: ${apiVersion} ` +
+                `(not a semantic version — compatibility check skipped).`);
+        }
+    }
+    else {
+        console.error(`[shared-context-mcp] WARNING: API at ${base} does not report a version. ` +
+            `Compatibility with min ${MIN_API_VERSION} was not verified.`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Server setup
+// ---------------------------------------------------------------------------
+// T618: Claude Code (2.1.222+) defers a server's tools behind ToolSearch once
+// it exposes many of them -- the model sees tool NAMES only and must find
+// tools by keyword search against name + description. `instructions` is the
+// one channel guaranteed to render into the system prompt regardless of
+// deferral (observable under "MCP Server Instructions" in any CC session
+// connected to this server), so it carries the prefix map + the "load these
+// together" guidance that a per-tool description cannot. Kept short --
+// see docs/mcp-tools.md "Discoverability under ToolSearch deferral" for the
+// keyword heuristic behind individual tool descriptions.
+const SERVER_INSTRUCTIONS = "ContextQ: persistent memory + goal graph for agents. Prefixes: ctx_* = " +
+    "knowledge CRUD/search (save/search/get/list a context; use ctx_search to " +
+    "recall or check for existing knowledge before re-saving it), agent_* = " +
+    "agent session memory (boot/checkpoint/resume/lesson/handoff), goal_* = " +
+    "shared goal graph (add/advance/frontier -- durable cross-session tasks), " +
+    "relay_* = directed cross-role handoff (open/inbox/claim/advance). At the " +
+    "start of tracked work, load ctx_search, ctx_save, and agent_boot together " +
+    "in one ToolSearch select call rather than one at a time. T668: only a " +
+    "small default tool set is loaded on connection (~24 tools) -- if the " +
+    "tool you need isn't in your list, call ctx_tool_groups to see the rest " +
+    "(code graph, admin, relay, world-model, saved searches, knowledge graph, " +
+    "bulk ingest) and ctx_load_tool_group to load a group into this session.";
+const server = new Server({
+    name: "shared-context",
+    version: MCP_VERSION,
+}, {
+    capabilities: {
+        // T668: listChanged:true -- ctx_load_tool_group promotes a group into
+        // the active profile at runtime and we notify via
+        // notifications/tools/list_changed. Clients that ignore the
+        // notification (or never subscribed) still work: handleToolCall
+        // dispatches on tool name regardless of the last tools/list result.
+        tools: { listChanged: true },
+    },
+    instructions: SERVER_INSTRUCTIONS,
+});
+// ---------------------------------------------------------------------------
+// Request handlers
+// ---------------------------------------------------------------------------
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    // T668: default/extended tool-profile split -- see tools.ts's
+    // getActiveTools()/TOOL_GROUPS doc comment. Starts at the default (or
+    // full, via CONTEXT_MCP_TOOL_PROFILE=full) profile and grows as
+    // ctx_load_tool_group is called.
+    return { tools: getActiveTools() };
+});
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+    const { name, arguments: args, _meta } = req.params;
+    // T558: `_meta` already exists on every `tools/call` request in the
+    // current protocol -- forward it through so `handleToolCall` can pull out
+    // `traceparent`/`tracestate`/`baggage` when a client sends them. Absent
+    // on every request today; `handleToolCall`'s own extraction is the
+    // silent no-op path.
+    const result = await handleToolCall(name, (args ?? {}), _meta);
+    // T668: the active tool set just grew -- tell any client that negotiated
+    // capabilities.tools.listChanged so it re-fetches tools/list. Best-effort:
+    // a client that never subscribed, or a closed transport, must never fail
+    // the tool call it rides on.
+    if (name === "ctx_load_tool_group" && !result.isError) {
+        server.sendToolListChanged().catch(() => { });
+    }
+    return result;
+});
+// ---------------------------------------------------------------------------
+// Start
+// ---------------------------------------------------------------------------
+async function main() {
+    const apiUrl = process.env.CONTEXT_API_URL ?? "http://localhost:38200";
+    // Validate CONTEXT_API_URL before connecting. An invalid or non-HTTP URL
+    // would cause every tool call to throw a cryptic fetch error; fail fast here.
+    try {
+        const parsed = new URL(apiUrl);
+        if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+            console.error(`[shared-context-mcp] Fatal: CONTEXT_API_URL must use http: or https: protocol, ` +
+                `got "${parsed.protocol}". Set CONTEXT_API_URL to a valid API base URL.`);
+            process.exit(1);
+        }
+    }
+    catch {
+        console.error(`[shared-context-mcp] Fatal: CONTEXT_API_URL "${apiUrl}" is not a valid URL. ` +
+            `Set CONTEXT_API_URL to a valid API base URL (e.g. http://localhost:38200).`);
+        process.exit(1);
+    }
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    const apiKey = process.env.CONTEXT_API_KEY;
+    console.error(`[shared-context-mcp] Connected (v${MCP_VERSION}). API: ${apiUrl}, Auth: ${apiKey ? 'configured' : 'NONE'}`);
+    // Non-fatal: warns on stderr but never blocks startup.
+    await handshake(apiUrl);
+}
+main().catch((err) => {
+    console.error("[shared-context-mcp] Fatal:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5D,8EAA8E;AAC9E,0DAA0D;AAC1D,8EAA8E;AAE9E,SAAS,kBAAkB;IACzB,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QACpF,OAAQ,GAA4B,CAAC,OAAO,IAAI,OAAO,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,WAAW,GAAG,kBAAkB,EAAE,CAAC;AAEzC,sEAAsE;AACtE,iEAAiE;AACjE,MAAM,eAAe,GAAG,OAAO,CAAC;AAYhC,SAAS,WAAW,CAAC,CAAS;IAC5B,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3E,CAAC;AAED,SAAS,SAAS,CAAC,CAAS,EAAE,CAAS;IACrC,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;IAClD,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;IAClD,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC;AAC5B,CAAC;AAED,8EAA8E;AAC9E,wBAAwB;AACxB,EAAE;AACF,uEAAuE;AACvE,uEAAuE;AACvE,2EAA2E;AAC3E,2EAA2E;AAC3E,iEAAiE;AACjE,8EAA8E;AAE9E,KAAK,UAAU,SAAS,CAAC,OAAe;IACtC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACzC,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,UAA8B,CAAC;IAEnC,uEAAuE;IACvE,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,SAAS,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;QACtG,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,SAAS,GAAG,IAAI,CAAC;YACjB,mEAAmE;YACnE,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAmC,CAAC;YACrF,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC7C,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,gDAAgD;IAClD,CAAC;IAED,wEAAwE;IACxE,2CAA2C;IAC3C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,cAAc,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC3G,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;gBACZ,SAAS,GAAG,IAAI,CAAC;gBACjB,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAmC,CAAC;gBACrF,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;oBAC7C,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC;gBAC5B,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,8CAA8C;QAChD,CAAC;IACH,CAAC;IAED,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CACX,wCAAwC,IAAI,mBAAmB;YAC7D,0FAA0F,CAC7F,CAAC;QACF,OAAO;IACT,CAAC;IAED,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,SAAS,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;QAC1C,MAAM,SAAS,GAAG,WAAW,CAAC,eAAe,CAAC,CAAC;QAE/C,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC;YAC3B,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC;gBACrC,OAAO,CAAC,KAAK,CACX,6CAA6C,UAAU,YAAY;oBACjE,sCAAsC,eAAe,IAAI;oBACzD,mEAAmE,CACtE,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CACX,oCAAoC,UAAU,0BAA0B,eAAe,GAAG,CAC3F,CAAC;YACJ,CAAC;QACH,CAAC;aAAM,CAAC;YACN,6DAA6D;YAC7D,wCAAwC;YACxC,OAAO,CAAC,KAAK,CACX,wDAAwD,UAAU,GAAG;gBACnE,yDAAyD,CAC5D,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CACX,wCAAwC,IAAI,8BAA8B;YACxE,0BAA0B,eAAe,oBAAoB,CAChE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E,8EAA8E;AAC9E,0EAA0E;AAC1E,4EAA4E;AAC5E,wEAAwE;AACxE,yEAAyE;AACzE,4EAA4E;AAC5E,uEAAuE;AACvE,4EAA4E;AAC5E,yDAAyD;AACzD,MAAM,mBAAmB,GACvB,yEAAyE;IACzE,2EAA2E;IAC3E,yEAAyE;IACzE,yEAAyE;IACzE,2EAA2E;IAC3E,2EAA2E;IAC3E,4EAA4E;IAC5E,wEAAwE;IACxE,uEAAuE;IACvE,yEAAyE;IACzE,2EAA2E;IAC3E,yEAAyE,CAAC;AAE5E,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;IACE,IAAI,EAAE,gBAAgB;IACtB,OAAO,EAAE,WAAW;CACrB,EACD;IACE,YAAY,EAAE;QACZ,sEAAsE;QACtE,kDAAkD;QAClD,4DAA4D;QAC5D,gEAAgE;QAChE,oEAAoE;QACpE,KAAK,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE;KAC7B;IACD,YAAY,EAAE,mBAAmB;CAClC,CACF,CAAC;AAEF,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;IAC1D,8DAA8D;IAC9D,sEAAsE;IACtE,gEAAgE;IAChE,iCAAiC;IACjC,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,CAAC;AACrC,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;IAC5D,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC;IACpD,oEAAoE;IACpE,0EAA0E;IAC1E,wEAAwE;IACxE,mEAAmE;IACnE,qBAAqB;IACrB,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,CAA4B,EAAE,KAAK,CAAC,CAAC;IAE1F,yEAAyE;IACzE,2EAA2E;IAC3E,yEAAyE;IACzE,6BAA6B;IAC7B,IAAI,IAAI,KAAK,qBAAqB,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACtD,MAAM,CAAC,mBAAmB,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC,CAAC;AAEH,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,wBAAwB,CAAC;IAEvE,yEAAyE;IACzE,8EAA8E;IAC9E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAChE,OAAO,CAAC,KAAK,CACX,iFAAiF;gBAC/E,QAAQ,MAAM,CAAC,QAAQ,iDAAiD,CAC3E,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,KAAK,CACX,gDAAgD,MAAM,wBAAwB;YAC5E,4EAA4E,CAC/E,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC3C,OAAO,CAAC,KAAK,CAAC,oCAAoC,WAAW,WAAW,MAAM,WAAW,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IAE3H,uDAAuD;IACvD,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;AAC1B,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;IAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,23 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const tools: Tool[];
+export interface ToolGroup {
+    description: string;
+    tools: string[];
+}
+export declare const TOOL_GROUPS: Record<string, ToolGroup>;
+export declare const DEFAULT_PROFILE_TOOL_NAMES: Set<string>;
+export type ToolProfile = "default" | "full";
+export declare function getActiveTools(): Tool[];
+export declare function loadToolGroup(group: string): {
+    added: string[];
+    unknownGroup: boolean;
+};
+type ToolInput = Record<string, unknown>;
+export declare function handleToolCall(name: string, args: ToolInput, meta?: unknown): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export {};