callman-mcp 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog
+
+## 0.1.0 — First release
+
+An MCP server (stdio) that lets Claude Code, Claude Desktop, Cursor, OpenAI Codex and
+Gemini CLI operate a Callman account through the REST API, with a personal token.
+
+- **44 tools** across workspaces & members, collections/folders, requests (incl. atomic
+  bulk create), imports (Postman, OpenAPI, Insomnia, Bruno, Callman export, cURL, .http,
+  scenario exports), environments, scenarios (create/update with version check, server-side
+  run with polling, compact reports) and system-design diagrams (typed components, edge
+  semantics, automatic ELK layout, incremental patch, sharing).
+- **Local execution** — `run_request` / `run_collection` fetch the pipeline bundle and run
+  through callman-core's runner on the user's machine; output never contains variable
+  values, and sensitive headers are masked. Disabled with `CALLMAN_ALLOW_RUN=0`.
+- **Reference rebinding** everywhere: id → unique name → unique substring → candidates.
+- **Guard rails**: `dryRun` previews, `confirm: true` on deletes, size-bounded outputs,
+  masked secrets, actionable error hints per backend error code, per-tool availability in
+  `whoami` from the token's scopes.
+- **Resources** (docs generated from callman-core, the diagram component catalog, live
+  workspace data by URI) and **prompts** (import endpoints from code, design a system
+  diagram, create a scenario from a flow, document a collection).
+- `callman-mcp doctor` — one-command connection check.
+- ESM + CommonJS library entry (`createCallmanMcpServer`) with injectable `fetch` and
+  logger, so the same tool layer can be hosted over another transport.
+
+Requires a Callman backend with personal tokens (`/api/personal-tokens`) and
+`callman-core` ≥ 1.28.0. Node.js ≥ 20.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Callman
+
+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

@@ -0,0 +1,203 @@
+# callman-mcp
+
+MCP server for [Callman](https://callman.io) — lets **Claude Code, Claude Desktop, Cursor,
+OpenAI Codex and Gemini CLI** work inside your Callman account: build and organise
+collections, import the endpoints found in your code, run requests, create and run test
+scenarios, and draw system-design diagrams. Works with Callman cloud and on-prem.
+
+```
+AI tool ──stdio──▶ callman-mcp (this package, on your machine) ──HTTPS──▶ your Callman server
+```
+
+Everything the AI tool does goes through the same REST API the desktop app uses, as **you**,
+limited to the permissions of the token you created and your role in each workspace.
+
+## Quick start
+
+1. **Create a token** — Callman desktop app → profile menu → **AI tools** → *New token*.
+   Pick a preset (*Read only*, *Build collections*, *Full, no delete*, *Full*) or choose
+   permissions one by one. The token is shown once, together with a ready-to-paste config
+   for your tool.
+2. **Add the server to your AI tool** (needs Node.js 20+):
+
+   **Claude Code**
+   ```bash
+   claude mcp add callman --scope user -e CALLMAN_API_URL=https://api.callman.io -e CALLMAN_TOKEN=<PASTE_YOUR_TOKEN> -- npx -y callman-mcp
+   ```
+
+   **Claude Desktop** (`claude_desktop_config.json`), **Cursor** (`~/.cursor/mcp.json`),
+   **Gemini CLI** (`~/.gemini/settings.json`)
+   ```json
+   {
+     "mcpServers": {
+       "callman": {
+         "command": "npx",
+         "args": ["-y", "callman-mcp"],
+         "env": {
+           "CALLMAN_API_URL": "https://api.callman.io",
+           "CALLMAN_TOKEN": "<PASTE_YOUR_TOKEN>"
+         }
+       }
+     }
+   }
+   ```
+
+   **OpenAI Codex** (`~/.codex/config.toml`)
+   ```toml
+   [mcp_servers.callman]
+   command = "npx"
+   args = ["-y", "callman-mcp"]
+
+   [mcp_servers.callman.env]
+   CALLMAN_API_URL = "https://api.callman.io"
+   CALLMAN_TOKEN = "<PASTE_YOUR_TOKEN>"
+   ```
+3. **Check it** — `CALLMAN_API_URL=… CALLMAN_TOKEN=… npx -y callman-mcp doctor` prints the
+   server, your user, token scopes, workspaces and which tools the token can use. Then ask
+   your AI tool: *"list my Callman workspaces"*.
+
+Things to try: *"add the endpoints in src/routes/users.ts to a new collection Users API"*,
+*"run GET /users with the Staging environment"*, *"create a scenario that logs in, creates
+an order and checks it appears"*, *"draw the architecture of this repo and share it with
+the Team workspace"*.
+
+### Run a local build (before it is published, or while developing it)
+
+```bash
+git clone … callman-mcp && cd callman-mcp
+npm install --legacy-peer-deps && npm run build      # → dist/index.js
+```
+Point the AI tool at the file instead of `npx -y callman-mcp`:
+
+```bash
+claude mcp add callman --scope user -e CALLMAN_API_URL=http://localhost:8080 -e CALLMAN_TOKEN=<PASTE_YOUR_TOKEN> -- node /abs/path/to/callman-mcp/dist/index.js
+```
+(JSON configs: `"command": "node", "args": ["/abs/path/to/callman-mcp/dist/index.js"]`.)
+Rebuild after changing the source; AI tools start a fresh process per session.
+
+## Configuration
+
+| Variable | Default | Meaning |
+|---|---|---|
+| `CALLMAN_API_URL` | `https://api.callman.io` | Server **origin**. On-prem: the address the desktop app uses (any path prefix is kept; a trailing `/api` is accepted). |
+| `CALLMAN_TOKEN` | — | Personal token (`cm_pat_…`). Without it the server still starts; `whoami` explains how to set one. |
+| `CALLMAN_TOKEN_FILE` | — | Read the token from a file instead (Docker/Kubernetes secrets). |
+| `CALLMAN_WORKSPACE_ID` | — | Default workspace. Optional: with one workspace it is automatic; with several, tools take `workspace` (name or id). |
+| `CALLMAN_ALLOW_RUN` | `1` | `0` removes `run_request` / `run_collection` (no local execution). |
+| `CALLMAN_LOG_LEVEL` | `warn` | `silent`, `error`, `warn`, `info`, `debug` — to **stderr** (stdout is the protocol). |
+| `CALLMAN_TIMEOUT_MS` | `30000` | Per API call. |
+| `CALLMAN_RUN_TIMEOUT_MS` | `600000` | Budget for one local run. |
+| `CALLMAN_MAX_BODY_BYTES` | `16384` | Response-body preview cap in run output (max 262144). |
+
+## Tools (44) and the permission each needs
+
+| Area | Tools | Scope |
+|---|---|---|
+| Meta | `whoami` | — |
+| Workspaces | `list_workspaces`, `list_workspace_members` | `workspaces:read` (always on) |
+| | `add_workspace_member`, `remove_workspace_member` | `members:manage` (+ owner role) |
+| Collections | `list_collections`, `get_collection_tree`, `export_collection` | `collections:read` |
+| | `create_collection`, `update_collection`, `create_folder`, `update_folder` | `collections:write` |
+| | `delete_collection`, `delete_folder` | `collections:delete` |
+| Requests | `search_requests`, `get_request` | `requests:read` |
+| | `create_request`, `update_request`, `move_requests` | `requests:write` |
+| | `create_requests_bulk` | `requests:write` (existing collection) / `import:write` (new collection, atomic) |
+| | `delete_requests` | `requests:delete` |
+| | `run_request`, `run_collection` | `requests:run` |
+| Import | `import_content` (Postman, OpenAPI, Insomnia, Bruno, Callman export, cURL, .http) | `import:write` (`requests:write` for cURL/.http into an existing collection) |
+| | `import_scenario` | `import:write` |
+| Environments | `list_environments`, `get_environment` | `environments:read` (+ `environments:reveal` for values) |
+| | `create_environment`, `set_environment_variables` | `environments:write` |
+| | `delete_environment` | `environments:delete` |
+| Scenarios | `list_scenarios`, `get_scenario`, `get_scenario_report` | `scenarios:read` |
+| | `create_scenario`, `update_scenario` | `scenarios:write` |
+| | `run_scenario` | `scenarios:run` |
+| | `delete_scenario` | `scenarios:delete` |
+| Diagrams | `list_diagrams`, `get_diagram` | `diagrams:read` |
+| | `create_diagram`, `update_diagram`, `patch_diagram` | `diagrams:write` |
+| | `share_diagram` | `diagrams:share` |
+| | `delete_diagram` | `diagrams:delete` |
+
+Conventions: names work wherever an id does (ambiguous names return candidates); big writes
+take `dryRun: true`; deletions require `confirm: true`; every write reports what it resolved
+(`resolved: [{ input, matched, id }]`); outputs are size-bounded and say when they truncate.
+
+**Resources** — `callman://docs/overview`, `…/docs/request-schema`, `…/docs/scenario-nodes`,
+`…/docs/scripting/{pm-api,db-queries,templating,sandbox}`, `…/docs/diagram-schema`,
+`callman://diagram/components[/{category}]` (the component catalog, generated from
+callman-core), and live data: `callman://workspaces`, `callman://workspace/{workspace}/collections`,
+`…/environments`, `callman://collection/{collection}/tree`, `callman://request/{request}`,
+`callman://environment/{environment}`, `callman://scenario/{scenario}`, `callman://diagram/{diagram}`.
+
+**Prompts** — `import_endpoints_from_code`, `design_system_diagram`,
+`create_scenario_from_flow`, `document_collection`.
+
+## Security model
+
+- **Your identity, narrowed.** A personal token acts as you in every workspace you belong
+  to, with your role there (a viewer's token cannot write), limited to its scopes. The
+  server enforces scopes on every route; areas outside the AI-tool surface (mocks,
+  connections, history, UI tests, admin) are refused.
+- **Secrets stay masked.** Environment, global and scenario variable values come back as
+  `••••ab` unless the token holds `environments:reveal` **and** the call passes
+  `reveal: true`. Masked values can never be written back. Request auth secrets and
+  sensitive headers are masked by this server on the way to the model.
+- **Local runs keep values local.** `run_request` / `run_collection` fetch the collection
+  bundle, resolve variables and send requests **on your machine** (the same engine as the
+  desktop app and `callme-cli`). The model receives status, timing, bounded bodies, test
+  results and the *names* of variables scripts changed — never values.
+- **Deletes are opt-in twice**: a `*:delete` scope on the token and `confirm: true` on the call.
+- Tokens always expire, are rate-limited per token, attributed in the audit trail, revocable
+  at any time in the desktop app, and the whole feature is behind the `mcp` feature flag an
+  administrator controls.
+
+## On-prem
+
+Use the address the desktop app uses (`http(s)://<host>[:port][/prefix]`). The `/api` path
+must be reachable from the machine running the AI tool. Corporate TLS: add
+`NODE_EXTRA_CA_CERTS=/path/to/ca.pem` to the server's `env`. Air-gapped: `npm pack
+callman-mcp` on a connected machine, `npm i -g ./callman-mcp-<version>.tgz` on the target,
+and use `callman-mcp` as the command instead of `npx -y callman-mcp`. The administrator
+enables AI tools in the admin panel (feature flag **AI tools (MCP)**).
+
+## Troubleshooting
+
+| Symptom | Fix |
+|---|---|
+| `401` | Token missing, expired or revoked — create a new one and update the config. |
+| `403 PAT_SCOPE_MISSING` | The message names the scope; create a token that has it. |
+| `403 PAT_ROUTE_FORBIDDEN` | That area is not available to AI tools. |
+| `403 FEATURE_DISABLED` | An administrator switched AI tools off. |
+| `403` on a write | You are a viewer in that workspace. |
+| "pass `workspace`" | Several workspaces and no default — name one, or set `CALLMAN_WORKSPACE_ID`. |
+| Tool not listed in the client | Node 20+? Can `npx` reach the registry? Run `callman-mcp doctor`. |
+| Changes not visible in the app | Switch back to the app (it refreshes on focus) or press Refresh in the diagram library. |
+
+## Embedding
+
+```ts
+import { createCallmanMcpServer, resolveConfig } from "callman-mcp";
+
+const { server } = createCallmanMcpServer({
+  config: resolveConfig({ env: { CALLMAN_API_URL: "…", CALLMAN_TOKEN: "…", CALLMAN_ALLOW_RUN: "0" } }),
+  fetch, // injectable
+});
+await server.connect(transport); // any MCP transport
+```
+ESM and CommonJS builds are shipped. The tool layer never reads the environment, the file
+system or stdout — only the bin (`dist/index.js`) does.
+
+## Development
+
+```bash
+nvm use                                   # Node 22
+npm install --legacy-peer-deps            # npm 10's arborist trips over a dev-only peer set
+npm run lint && npm run build && npm test && npm run smoke
+```
+`tests/fixtures/fake-backend.ts` is an in-memory Callman backend (envelope, scopes, masking,
+pagination, CAS, runs); contract tests drive every tool through a real MCP client. `npm run
+smoke` starts the built server over stdio. Shared logic (cURL/.http parsers, the diagram
+document contract and component catalog, the request runner) comes from
+[`callman-core`](https://www.npmjs.com/package/callman-core).
+
+MIT

package/dist/client/api.d.ts

@@ -0,0 +1,109 @@
+import type { CallmanHttpClient } from "./http.js";
+import type { ApiRequest, Collection, Diagram, Environment, FeatureMap, Folder, FolderTree, GlobalVariable, ImportResult, Paginated, PersonalTokenMe, PipelineBundle, RequestTreeItem, Scenario, ScenarioFolder, ScenarioImportResult, ScenarioRunListItem, ScenarioRunReport, ScenarioRunTrigger, Workspace, WorkspaceMember } from "./types.js";
+export declare class CallmanApi {
+    readonly http: CallmanHttpClient;
+    constructor(http: CallmanHttpClient);
+    me(): Promise<PersonalTokenMe>;
+    features(): Promise<FeatureMap>;
+    listWorkspaces(): Promise<Workspace[]>;
+    listMembers(workspaceId: string): Promise<{
+        items: WorkspaceMember[];
+    }>;
+    addMember(workspaceId: string, body: {
+        email: string;
+        role: "owner" | "editor" | "viewer";
+    }): Promise<WorkspaceMember>;
+    removeMember(workspaceId: string, memberId: string): Promise<void>;
+    listCollections(ws: string, page?: number, limit?: number): Promise<Paginated<Collection>>;
+    listAllCollections(ws: string): Promise<Collection[]>;
+    getCollection(ws: string, id: string): Promise<Collection>;
+    createCollection(ws: string, body: {
+        name: string;
+        runnerSettings?: Record<string, boolean>;
+    }): Promise<Collection>;
+    updateCollection(ws: string, id: string, body: {
+        name?: string;
+        runnerSettings?: Record<string, boolean>;
+    }): Promise<Collection>;
+    deleteCollection(ws: string, id: string): Promise<unknown>;
+    folderTree(ws: string, collectionId: string): Promise<FolderTree>;
+    createFolder(ws: string, body: {
+        name: string;
+        collectionId: string;
+        parentId?: string | null;
+    }): Promise<Folder>;
+    updateFolder(ws: string, id: string, body: {
+        name?: string;
+        parentId?: string | null;
+        collectionId?: string;
+    }): Promise<Folder>;
+    deleteFolder(ws: string, id: string): Promise<unknown>;
+    exportCollection(ws: string, id: string, type: "internal" | "postman"): Promise<unknown>;
+    requestTree(ws: string, collectionId: string): Promise<RequestTreeItem[]>;
+    getRequest(ws: string, id: string): Promise<ApiRequest>;
+    createRequest(ws: string, body: Record<string, unknown>): Promise<ApiRequest>;
+    updateRequest(ws: string, id: string, body: Record<string, unknown>): Promise<ApiRequest>;
+    deleteRequest(ws: string, id: string): Promise<unknown>;
+    importJson(ws: string, body: {
+        format: string;
+        payload: unknown;
+        fallbackCollectionName?: string;
+        targetEnvironmentId?: string | null;
+    }): Promise<ImportResult>;
+    importScenario(ws: string, body: {
+        envelope: unknown;
+        name?: string;
+        folderId?: string | null;
+        connectionMap?: Record<string, unknown>;
+    }): Promise<ScenarioImportResult>;
+    listEnvironments(ws: string, reveal?: boolean): Promise<Paginated<Environment>>;
+    getEnvironment(ws: string, id: string, reveal?: boolean): Promise<Environment>;
+    createEnvironment(ws: string, body: {
+        name: string;
+        variables: Array<{
+            key: string;
+            value: string;
+            enabled?: boolean;
+        }>;
+    }): Promise<Environment>;
+    deleteEnvironment(ws: string, id: string): Promise<unknown>;
+    addEnvironmentVariable(ws: string, id: string, body: {
+        key: string;
+        value: string;
+    }): Promise<Environment>;
+    updateEnvironmentVariable(ws: string, id: string, key: string, body: {
+        value: string;
+    }): Promise<Environment>;
+    deleteEnvironmentVariable(ws: string, id: string, key: string): Promise<Environment>;
+    listGlobalVariables(ws: string, reveal?: boolean): Promise<GlobalVariable[]>;
+    listScenarios(ws: string | null): Promise<Scenario[]>;
+    listScenarioFolders(ws: string | null): Promise<ScenarioFolder[] | {
+        items: ScenarioFolder[];
+    }>;
+    getScenario(ws: string | null, id: string, reveal?: boolean): Promise<Scenario>;
+    createScenario(ws: string, body: Record<string, unknown>): Promise<Scenario>;
+    patchScenario(ws: string | null, id: string, body: Record<string, unknown>): Promise<Scenario>;
+    deleteScenario(ws: string | null, id: string): Promise<unknown>;
+    runScenario(ws: string | null, id: string, body: {
+        environmentId?: string;
+    }): Promise<ScenarioRunTrigger>;
+    listScenarioReports(ws: string | null, id: string, limit?: number): Promise<Paginated<ScenarioRunListItem>>;
+    getScenarioReport(ws: string | null, id: string, reportId: string): Promise<ScenarioRunReport>;
+    listDiagrams(): Promise<Diagram[]>;
+    getDiagram(id: string): Promise<Diagram>;
+    createDiagram(body: {
+        name: string;
+        document: unknown;
+    }): Promise<Diagram>;
+    updateDiagram(id: string, body: {
+        name?: string;
+        document?: unknown;
+    }): Promise<Diagram>;
+    deleteDiagram(id: string): Promise<unknown>;
+    shareDiagram(id: string, body: {
+        workspaceIds: string[];
+        editorIds: string[];
+    }): Promise<Diagram>;
+    pipelineBundle(ws: string, collectionId: string, environmentId: string | null): Promise<PipelineBundle>;
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/client/api.d.ts.map

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

package/dist/client/api.js

@@ -0,0 +1,180 @@
+// Typed endpoint functions — one per backend route the tools use. Thin on
+// purpose: no business rules here, only paths, headers and shapes. `ws` is
+// the workspace id for workspace-scoped routes.
+export class CallmanApi {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    // ── identity ────────────────────────────────────────────────────────
+    me() {
+        return this.http.request("GET", "/personal-tokens/me");
+    }
+    features() {
+        return this.http.request("GET", "/features");
+    }
+    // ── workspaces ──────────────────────────────────────────────────────
+    listWorkspaces() {
+        return this.http.request("GET", "/workspaces");
+    }
+    listMembers(workspaceId) {
+        return this.http.request("GET", `/workspaces/${workspaceId}/members`);
+    }
+    addMember(workspaceId, body) {
+        return this.http.request("POST", `/workspaces/${workspaceId}/members`, { body });
+    }
+    removeMember(workspaceId, memberId) {
+        return this.http.request("DELETE", `/workspaces/${workspaceId}/members/${memberId}`);
+    }
+    // ── collections / folders ───────────────────────────────────────────
+    listCollections(ws, page = 1, limit = 100) {
+        return this.http.request("GET", "/collections", { workspaceId: ws, query: { page, limit } });
+    }
+    async listAllCollections(ws) {
+        const out = [];
+        let page = 1;
+        for (;;) {
+            const result = await this.listCollections(ws, page, 100);
+            out.push(...result.items);
+            if (page >= result.pagination.totalPages || result.items.length === 0)
+                break;
+            page += 1;
+            if (page > 50)
+                break; // 5 000 collections — more than any workspace has
+        }
+        return out;
+    }
+    getCollection(ws, id) {
+        return this.http.request("GET", `/collections/${id}`, { workspaceId: ws });
+    }
+    createCollection(ws, body) {
+        return this.http.request("POST", "/collections", { workspaceId: ws, body });
+    }
+    updateCollection(ws, id, body) {
+        return this.http.request("PATCH", `/collections/${id}`, { workspaceId: ws, body });
+    }
+    deleteCollection(ws, id) {
+        return this.http.request("DELETE", `/collections/${id}`, { workspaceId: ws });
+    }
+    folderTree(ws, collectionId) {
+        return this.http.request("GET", `/folders/tree/${collectionId}`, { workspaceId: ws });
+    }
+    createFolder(ws, body) {
+        return this.http.request("POST", "/folders", { workspaceId: ws, body });
+    }
+    updateFolder(ws, id, body) {
+        return this.http.request("PATCH", `/folders/${id}`, { workspaceId: ws, body });
+    }
+    deleteFolder(ws, id) {
+        return this.http.request("DELETE", `/folders/${id}`, { workspaceId: ws });
+    }
+    exportCollection(ws, id, type) {
+        return this.http.request("GET", `/export/${id}`, { workspaceId: ws, query: { type } });
+    }
+    // ── requests ────────────────────────────────────────────────────────
+    requestTree(ws, collectionId) {
+        return this.http.request("GET", "/requests/tree", { workspaceId: ws, query: { collectionId } });
+    }
+    getRequest(ws, id) {
+        return this.http.request("GET", `/requests/${id}`, { workspaceId: ws });
+    }
+    createRequest(ws, body) {
+        return this.http.request("POST", "/requests", { workspaceId: ws, body });
+    }
+    updateRequest(ws, id, body) {
+        return this.http.request("PATCH", `/requests/${id}`, { workspaceId: ws, body });
+    }
+    deleteRequest(ws, id) {
+        return this.http.request("DELETE", `/requests/${id}`, { workspaceId: ws });
+    }
+    // ── import ──────────────────────────────────────────────────────────
+    importJson(ws, body) {
+        return this.http.request("POST", "/import/json", { workspaceId: ws, body, timeoutMs: 120_000 });
+    }
+    importScenario(ws, body) {
+        return this.http.request("POST", "/import/scenario", { workspaceId: ws, body, timeoutMs: 120_000 });
+    }
+    // ── environments / globals ──────────────────────────────────────────
+    listEnvironments(ws, reveal = false) {
+        return this.http.request("GET", "/environments", {
+            workspaceId: ws,
+            query: { page: 1, limit: 100, ...(reveal ? { reveal: "true" } : {}) },
+        });
+    }
+    getEnvironment(ws, id, reveal = false) {
+        return this.http.request("GET", `/environments/${id}`, { workspaceId: ws, query: reveal ? { reveal: "true" } : {} });
+    }
+    createEnvironment(ws, body) {
+        return this.http.request("POST", "/environments", { workspaceId: ws, body });
+    }
+    deleteEnvironment(ws, id) {
+        return this.http.request("DELETE", `/environments/${id}`, { workspaceId: ws });
+    }
+    addEnvironmentVariable(ws, id, body) {
+        return this.http.request("POST", `/environments/${id}/variables`, { workspaceId: ws, body });
+    }
+    updateEnvironmentVariable(ws, id, key, body) {
+        return this.http.request("PATCH", `/environments/${id}/variables/${encodeURIComponent(key)}`, { workspaceId: ws, body });
+    }
+    deleteEnvironmentVariable(ws, id, key) {
+        return this.http.request("DELETE", `/environments/${id}/variables/${encodeURIComponent(key)}`, { workspaceId: ws });
+    }
+    listGlobalVariables(ws, reveal = false) {
+        return this.http.request("GET", "/variables/global", { workspaceId: ws, query: reveal ? { reveal: "true" } : {} });
+    }
+    // ── scenarios ───────────────────────────────────────────────────────
+    listScenarios(ws) {
+        return this.http.request("GET", "/scenarios", { workspaceId: ws });
+    }
+    listScenarioFolders(ws) {
+        return this.http.request("GET", "/scenario-folders", { workspaceId: ws });
+    }
+    getScenario(ws, id, reveal = false) {
+        return this.http.request("GET", `/scenarios/${id}`, { workspaceId: ws, query: reveal ? { reveal: "true" } : {} });
+    }
+    createScenario(ws, body) {
+        return this.http.request("POST", "/scenarios", { workspaceId: ws, body });
+    }
+    patchScenario(ws, id, body) {
+        return this.http.request("PATCH", `/scenarios/${id}`, { workspaceId: ws, body });
+    }
+    deleteScenario(ws, id) {
+        return this.http.request("DELETE", `/scenarios/${id}`, { workspaceId: ws });
+    }
+    runScenario(ws, id, body) {
+        return this.http.request("POST", `/scenarios/${id}/run-server`, { workspaceId: ws, body });
+    }
+    listScenarioReports(ws, id, limit = 20) {
+        return this.http.request("GET", `/scenarios/${id}/reports`, { workspaceId: ws, query: { page: 1, limit } });
+    }
+    getScenarioReport(ws, id, reportId) {
+        return this.http.request("GET", `/scenarios/${id}/reports/${reportId}`, { workspaceId: ws });
+    }
+    // ── diagrams (user-owned, not workspace-scoped) ─────────────────────
+    listDiagrams() {
+        return this.http.request("GET", "/diagrams");
+    }
+    getDiagram(id) {
+        return this.http.request("GET", `/diagrams/${id}`);
+    }
+    createDiagram(body) {
+        return this.http.request("POST", "/diagrams", { body });
+    }
+    updateDiagram(id, body) {
+        return this.http.request("PUT", `/diagrams/${id}`, { body });
+    }
+    deleteDiagram(id) {
+        return this.http.request("DELETE", `/diagrams/${id}`);
+    }
+    shareDiagram(id, body) {
+        return this.http.request("POST", `/diagrams/${id}/share`, { body });
+    }
+    // ── local run bundle ────────────────────────────────────────────────
+    pipelineBundle(ws, collectionId, environmentId) {
+        return this.http.request("GET", "/pipeline/bundle", {
+            workspaceId: ws,
+            query: { collectionId, ...(environmentId ? { environmentId } : {}) },
+        });
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/client/api.js.map

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

package/dist/client/errors.d.ts

@@ -0,0 +1,27 @@
+export declare class CallmanApiError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly details: unknown;
+    readonly method: string;
+    readonly path: string;
+    constructor(input: {
+        status: number;
+        code: string;
+        message: string;
+        details?: unknown;
+        method: string;
+        path: string;
+    });
+}
+export declare class CallmanNetworkError extends Error {
+    readonly apiUrl: string;
+    readonly cause?: unknown;
+    constructor(apiUrl: string, message: string, cause?: unknown);
+}
+export declare class ToolInputError extends Error {
+    readonly code: string;
+    readonly data: Record<string, unknown> | undefined;
+    constructor(code: string, message: string, data?: Record<string, unknown>);
+}
+export declare const hintFor: (error: CallmanApiError) => string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/client/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/client/errors.ts"],"names":[],"mappings":"AAGA,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,KAAK,EAAE;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd;CASF;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEb,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAM7D;AAKD,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;gBAEvC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAM1E;AAKD,eAAO,MAAM,OAAO,GAAI,OAAO,eAAe,KAAG,MAsDhD,CAAC"}