capix-mcp 2.1.0

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+/**
+ * Capix MCP Server — CLI entry point.
+ *
+ * Commands:
+ *   capix-mcp                     Start the MCP server on stdio (default).
+ *   capix-mcp server              Start on stdio; use --http <port> for HTTP.
+ *   capix-mcp doctor              Diagnose auth, base URL, and tool inventory.
+ *   capix-mcp login               Authenticate via OAuth (PKCE browser flow).
+ *   capix-mcp logout              Revoke tokens and clear stored credentials.
+ *   capix-mcp --version           Print version and exit.
+ *
+ * Config via env:
+ *   CAPIX_BASE_URL          Capix network URL (default: https://capix.network)
+ *   CAPIX_API_KEY           Session token / API key (fallback when no OAuth)
+ *   CAPIX_PROJECT_ID        Default project id for unscoped reads
+ *   CAPIX_OAUTH_CLIENT_ID   OAuth client id (default: capix-mcp)
+ *   CAPIX_MCP_HTTP_PORT     Port for the streamable HTTP transport
+ *   CAPIX_MCP_HTTP_TOKEN    Bearer service token guarding the HTTP transport
+ *
+ * Auth strategy: the shared @capix/auth-broker is used for OAuth when it is
+ * importable AND a stored refresh token exists; otherwise the server falls
+ * back to the CAPIX_API_KEY env var. Run `capix-mcp login` to populate the
+ * broker's credential store.
+ *
+ * License: Apache-2.0
+ * Repo: https://github.com/CapIX-Protocol/CapIX-MCP
+ */
+import { createCapixMcpServer } from "./server.js";
+import { TOOL_NAMES } from "./tools.js";
+export { createCapixMcpServer, TOOL_NAMES };
+export declare const CAPIX_VERSION = "2.0.0";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAQH,OAAO,EACL,oBAAoB,EAIrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAc,UAAU,EAAE,MAAM,YAAY,CAAC;AA8TpD,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,CAAC;AAC5C,eAAO,MAAM,aAAa,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,307 @@
+#!/usr/bin/env node
+/**
+ * Capix MCP Server — CLI entry point.
+ *
+ * Commands:
+ *   capix-mcp                     Start the MCP server on stdio (default).
+ *   capix-mcp server              Start on stdio; use --http <port> for HTTP.
+ *   capix-mcp doctor              Diagnose auth, base URL, and tool inventory.
+ *   capix-mcp login               Authenticate via OAuth (PKCE browser flow).
+ *   capix-mcp logout              Revoke tokens and clear stored credentials.
+ *   capix-mcp --version           Print version and exit.
+ *
+ * Config via env:
+ *   CAPIX_BASE_URL          Capix network URL (default: https://capix.network)
+ *   CAPIX_API_KEY           Session token / API key (fallback when no OAuth)
+ *   CAPIX_PROJECT_ID        Default project id for unscoped reads
+ *   CAPIX_OAUTH_CLIENT_ID   OAuth client id (default: capix-mcp)
+ *   CAPIX_MCP_HTTP_PORT     Port for the streamable HTTP transport
+ *   CAPIX_MCP_HTTP_TOKEN    Bearer service token guarding the HTTP transport
+ *
+ * Auth strategy: the shared @capix/auth-broker is used for OAuth when it is
+ * importable AND a stored refresh token exists; otherwise the server falls
+ * back to the CAPIX_API_KEY env var. Run `capix-mcp login` to populate the
+ * broker's credential store.
+ *
+ * License: Apache-2.0
+ * Repo: https://github.com/CapIX-Protocol/CapIX-MCP
+ */
+import { createClient, tryCreateBrokerAuthProvider } from "./client.js";
+import { DEFAULT_CAPIX_BASE_URL, DEFAULT_OAUTH_CLIENT_ID, DEFAULT_OAUTH_SCOPE, } from "./types.js";
+import { createCapixMcpServer, startStdioServer, startHttpServer, getToolSummary, } from "./server.js";
+import { TOOL_COUNT, TOOL_NAMES } from "./tools.js";
+import { CAPIX_RESOURCES } from "./resources.js";
+import { CAPIX_PROMPTS } from "./prompts.js";
+const VERSION = "2.0.0";
+function parseArgs(argv) {
+    const args = argv.slice(2);
+    let command = "server";
+    let httpPort;
+    let httpToken;
+    let help = false;
+    let versionFlag = false;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "--help" || arg === "-h") {
+            help = true;
+        }
+        else if (arg === "--version" || arg === "-v") {
+            versionFlag = true;
+        }
+        else if (arg === "--http") {
+            httpPort = Number(args[++i]) || undefined;
+        }
+        else if (arg === "--http-port") {
+            httpPort = Number(args[++i]) || undefined;
+        }
+        else if (arg === "--token") {
+            httpToken = args[++i];
+        }
+        else if (arg?.startsWith("--http=")) {
+            httpPort = Number(arg.slice("--http=".length)) || undefined;
+        }
+        else if (arg?.startsWith("--token=")) {
+            httpToken = arg.slice("--token=".length);
+        }
+        else if (arg && !arg.startsWith("-")) {
+            command = arg;
+        }
+    }
+    if (!httpPort && process.env.CAPIX_MCP_HTTP_PORT) {
+        httpPort = Number(process.env.CAPIX_MCP_HTTP_PORT) || undefined;
+    }
+    if (!httpToken)
+        httpToken = process.env.CAPIX_MCP_HTTP_TOKEN;
+    return { command, httpPort, httpToken, help, version: versionFlag };
+}
+const HELP = `Capix MCP Server v${VERSION}
+
+Usage:
+  capix-mcp [server] [--http <port> [--token <token>]]
+  capix-mcp doctor
+  capix-mcp login [--device]
+  capix-mcp logout
+  capix-mcp --version
+
+Commands:
+  (default) / server   Run the MCP server. Defaults to stdio transport.
+                       With --http <port>, also starts a streamable HTTP transport.
+  doctor               Diagnose auth, base URL, and list the tool inventory.
+  login                Authenticate via OAuth PKCE (browser flow).
+  logout               Revoke tokens and clear stored credentials.
+
+Options:
+  --http <port>        Start the streamable HTTP transport on the given port.
+  --token <token>      Bearer service token guarding the HTTP transport.
+  --device             Use the device-code flow instead of the browser flow.
+  -h, --help           Show this help.
+  -v, --version        Print version and exit.
+
+Environment:
+  CAPIX_BASE_URL         Capix network URL (default: ${DEFAULT_CAPIX_BASE_URL})
+  CAPIX_API_KEY          Session token / API key (fallback when no OAuth)
+  CAPIX_PROJECT_ID       Default project id for unscoped reads
+  CAPIX_OAUTH_CLIENT_ID  OAuth client id (default: ${DEFAULT_OAUTH_CLIENT_ID})
+`;
+async function main() {
+    const cli = parseArgs(process.argv);
+    if (cli.help) {
+        process.stdout.write(HELP);
+        return;
+    }
+    if (cli.version) {
+        process.stdout.write(`@capix/mcp v${VERSION}\n`);
+        return;
+    }
+    switch (cli.command) {
+        case "doctor":
+            await runDoctor();
+            return;
+        case "login":
+            await runLogin(process.argv.includes("--device"));
+            return;
+        case "logout":
+            await runLogout();
+            return;
+        case "server":
+        default:
+            await runServer(cli);
+            return;
+    }
+}
+// ===========================================================================
+// doctor
+// ===========================================================================
+async function runDoctor() {
+    const baseUrl = process.env.CAPIX_BASE_URL ?? DEFAULT_CAPIX_BASE_URL;
+    const apiKey = process.env.CAPIX_API_KEY ?? "";
+    const projectId = process.env.CAPIX_PROJECT_ID;
+    const out = (msg) => process.stdout.write(msg + "\n");
+    out(`Capix MCP Server — doctor`);
+    out(`  version        : ${VERSION}`);
+    out(`  base URL       : ${baseUrl}`);
+    out(`  project id     : ${projectId ?? "(none — set CAPIX_PROJECT_ID)"}`);
+    // Auth probe.
+    const broker = await tryCreateBrokerAuthProvider({ baseUrl });
+    let authStatus;
+    if (broker && broker.isAuthenticated()) {
+        const acct = broker.getAccount();
+        authStatus = `OAuth (@capix/auth-broker) — account ${acct?.accountId ?? "unknown"}`;
+    }
+    else if (apiKey) {
+        authStatus = `API key (CAPIX_API_KEY) — ${apiKey.slice(0, 6)}…${apiKey.slice(-2)}`;
+    }
+    else {
+        authStatus = "NOT AUTHENTICATED — run `capix-mcp login` or set CAPIX_API_KEY";
+    }
+    out(`  auth           : ${authStatus}`);
+    // Tool inventory.
+    out(`  tools          : ${TOOL_COUNT}`);
+    const byScope = new Map();
+    for (const t of getToolSummary()) {
+        byScope.set(t.scope, (byScope.get(t.scope) ?? 0) + 1);
+    }
+    for (const [scope, count] of byScope) {
+        out(`    ${scope.padEnd(12)} : ${count}`);
+    }
+    const billable = getToolSummary().filter((t) => t.billable).length;
+    out(`  billable       : ${billable}`);
+    out(`  resources      : ${CAPIX_RESOURCES.length}`);
+    out(`  prompts        : ${CAPIX_PROMPTS.length}`);
+    out(`  transports     : stdio, streamable-http`);
+}
+// ===========================================================================
+// login / logout
+// ===========================================================================
+async function loadBroker() {
+    let mod = null;
+    try {
+        mod = await import("@capix/auth-broker");
+    }
+    catch {
+        return null;
+    }
+    if (!mod)
+        return null;
+    const baseUrl = process.env.CAPIX_BASE_URL ?? DEFAULT_CAPIX_BASE_URL;
+    const clientId = process.env.CAPIX_OAUTH_CLIENT_ID ?? DEFAULT_OAUTH_CLIENT_ID;
+    const scope = DEFAULT_OAUTH_SCOPE;
+    const store = new mod.FileCredentialStore(`${process.env.HOME}/.capix/credentials.json`);
+    const broker = new mod.AuthBroker({ baseUrl, clientId, scope }, store);
+    return { broker, mod };
+}
+async function runLogin(useDevice) {
+    const loaded = await loadBroker();
+    if (!loaded) {
+        process.stderr.write("Login requires the @capix/auth-broker package, which is not installed.\n" +
+            "Alternatively, set the CAPIX_API_KEY environment variable with a session\n" +
+            "token from capix.network → sign in → DevTools → Cookies → capix_session.\n");
+        process.exit(1);
+    }
+    const { broker } = loaded;
+    try {
+        if (useDevice) {
+            const challenge = await broker.startDeviceCodeLogin();
+            process.stdout.write(`Open ${challenge.url} and enter code: ${challenge.userCode}\n` +
+                `Waiting for authorisation (expires in ${challenge.expiresIn}s)…\n`);
+            const account = await broker.completeDeviceCodeLogin(challenge);
+            process.stdout.write(`✓ Authenticated as ${account.accountId}.\n`);
+            return;
+        }
+        const { authorizeUrl } = await broker.startLogin();
+        process.stdout.write(`Open this URL in a browser to sign in:\n  ${authorizeUrl}\n\n`);
+        tryOpenBrowser(authorizeUrl);
+        process.stdout.write("Waiting for browser callback…\n");
+        // Poll the broker's captured authorization code (set by its loopback server).
+        const captured = await pollCapturedCode(broker);
+        if (!captured) {
+            process.stderr.write("Login timed out — no callback received.\n");
+            process.exit(1);
+        }
+        const account = await broker.completeLogin(captured.code, captured.state);
+        process.stdout.write(`✓ Authenticated as ${account.accountId}.\n`);
+    }
+    catch (err) {
+        process.stderr.write(`Login failed: ${err.message}\n`);
+        process.exit(1);
+    }
+}
+async function pollCapturedCode(broker, timeoutMs = 120_000) {
+    const deadline = Date.now() + timeoutMs;
+    const b = broker;
+    while (Date.now() < deadline) {
+        if (b.capturedCode)
+            return b.capturedCode;
+        await new Promise((r) => setTimeout(r, 500));
+    }
+    return null;
+}
+function tryOpenBrowser(url) {
+    const platform = process.platform;
+    const cmd = platform === "darwin"
+        ? "open"
+        : platform === "win32"
+            ? "start"
+            : "xdg-open";
+    try {
+        // best-effort; ignore failures.
+        const { exec } = require("node:child_process");
+        exec(`${cmd} "${url}"`);
+    }
+    catch {
+        /* no-op */
+    }
+}
+async function runLogout() {
+    const loaded = await loadBroker();
+    if (!loaded) {
+        process.stdout.write("@capix/auth-broker not installed — nothing to revoke. " +
+            "Remove CAPIX_API_KEY from your environment to clear the API-key fallback.\n");
+        return;
+    }
+    const { broker } = loaded;
+    await broker.logout();
+    process.stdout.write("✓ Logged out. Stored credentials cleared.\n");
+}
+// ===========================================================================
+// server
+// ===========================================================================
+async function runServer(cli) {
+    const baseUrl = process.env.CAPIX_BASE_URL ?? DEFAULT_CAPIX_BASE_URL;
+    const log = (msg) => process.stderr.write(`${msg}\n`);
+    const client = await createClient({
+        baseUrl,
+        apiKey: process.env.CAPIX_API_KEY,
+        projectId: process.env.CAPIX_PROJECT_ID,
+        log,
+    });
+    if (!client.isAuthenticated()) {
+        log("Warning: not authenticated. Run `capix-mcp login` or set CAPIX_API_KEY.");
+        log("Get a session token from capix.network → sign in → DevTools → Cookies → capix_session.");
+    }
+    // HTTP transport (optional, alongside or instead of stdio).
+    if (cli.httpPort) {
+        if (!cli.httpToken) {
+            log("Error: --http requires --token <service-token> (or CAPIX_MCP_HTTP_TOKEN) to guard the endpoint.");
+            process.exit(1);
+        }
+        log(`Capix MCP Server (v${VERSION}) — streamable HTTP on :${cli.httpPort}`);
+        await startHttpServer(client, {
+            version: VERSION,
+            httpPort: cli.httpPort,
+            httpServiceToken: cli.httpToken,
+        });
+        return;
+    }
+    // Default: stdio transport.
+    log(`Capix MCP Server (v${VERSION}) — stdio transport · ${TOOL_COUNT} tools`);
+    await startStdioServer(client, { version: VERSION });
+}
+main().catch((error) => {
+    process.stderr.write(`Fatal: ${error instanceof Error ? error.message : String(error)}\n`);
+    process.exit(1);
+});
+// Re-export the assembled-server factory + tool names for programmatic use.
+export { createCapixMcpServer, TOOL_NAMES };
+export const CAPIX_VERSION = VERSION;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,YAAY,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,OAAO,GAAG,OAAO,CAAC;AAcxB,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3B,IAAI,OAAO,GAAG,QAAQ,CAAC;IACvB,IAAI,QAA4B,CAAC;IACjC,IAAI,SAA6B,CAAC;IAClC,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,WAAW,GAAG,KAAK,CAAC;IAExB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACrC,IAAI,GAAG,IAAI,CAAC;QACd,CAAC;aAAM,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YAC/C,WAAW,GAAG,IAAI,CAAC;QACrB,CAAC;aAAM,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;QAC5C,CAAC;aAAM,IAAI,GAAG,KAAK,aAAa,EAAE,CAAC;YACjC,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;QAC5C,CAAC;aAAM,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YAC7B,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACxB,CAAC;aAAM,IAAI,GAAG,EAAE,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACtC,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,SAAS,CAAC;QAC9D,CAAC;aAAM,IAAI,GAAG,EAAE,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YACvC,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC3C,CAAC;aAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACvC,OAAO,GAAG,GAAG,CAAC;QAChB,CAAC;IACH,CAAC;IAED,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,CAAC;QACjD,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,SAAS,CAAC;IAClE,CAAC;IACD,IAAI,CAAC,SAAS;QAAE,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAE7D,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AACtE,CAAC;AAED,MAAM,IAAI,GAAG,qBAAqB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;uDAwBc,sBAAsB;;;qDAGxB,uBAAuB;CAC3E,CAAC;AAEF,KAAK,UAAU,IAAI;IACjB,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO;IACT,CAAC;IACD,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,OAAO,IAAI,CAAC,CAAC;QACjD,OAAO;IACT,CAAC;IAED,QAAQ,GAAG,CAAC,OAAO,EAAE,CAAC;QACpB,KAAK,QAAQ;YACX,MAAM,SAAS,EAAE,CAAC;YAClB,OAAO;QACT,KAAK,OAAO;YACV,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;YAClD,OAAO;QACT,KAAK,QAAQ;YACX,MAAM,SAAS,EAAE,CAAC;YAClB,OAAO;QACT,KAAK,QAAQ,CAAC;QACd;YACE,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;YACrB,OAAO;IACX,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E,KAAK,UAAU,SAAS;IACtB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,sBAAsB,CAAC;IACrE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC;IAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAE/C,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;IAE9D,GAAG,CAAC,2BAA2B,CAAC,CAAC;IACjC,GAAG,CAAC,sBAAsB,OAAO,EAAE,CAAC,CAAC;IACrC,GAAG,CAAC,sBAAsB,OAAO,EAAE,CAAC,CAAC;IACrC,GAAG,CAAC,sBAAsB,SAAS,IAAI,+BAA+B,EAAE,CAAC,CAAC;IAE1E,cAAc;IACd,MAAM,MAAM,GAAG,MAAM,2BAA2B,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IAC9D,IAAI,UAAkB,CAAC;IACvB,IAAI,MAAM,IAAI,MAAM,CAAC,eAAe,EAAE,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;QACjC,UAAU,GAAG,wCAAwC,IAAI,EAAE,SAAS,IAAI,SAAS,EAAE,CAAC;IACtF,CAAC;SAAM,IAAI,MAAM,EAAE,CAAC;QAClB,UAAU,GAAG,6BAA6B,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACrF,CAAC;SAAM,CAAC;QACN,UAAU,GAAG,gEAAgE,CAAC;IAChF,CAAC;IACD,GAAG,CAAC,sBAAsB,UAAU,EAAE,CAAC,CAAC;IAExC,kBAAkB;IAClB,GAAG,CAAC,sBAAsB,UAAU,EAAE,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,KAAK,MAAM,CAAC,IAAI,cAAc,EAAE,EAAE,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACxD,CAAC;IACD,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;QACrC,GAAG,CAAC,OAAO,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC;IACnE,GAAG,CAAC,sBAAsB,QAAQ,EAAE,CAAC,CAAC;IACtC,GAAG,CAAC,sBAAsB,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC;IACpD,GAAG,CAAC,sBAAsB,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;IAClD,GAAG,CAAC,2CAA2C,CAAC,CAAC;AACnD,CAAC;AAED,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E,KAAK,UAAU,UAAU;IACvB,IAAI,GAAG,GAA+C,IAAI,CAAC;IAC3D,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,sBAAsB,CAAC;IACrE,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,uBAAuB,CAAC;IAC9E,MAAM,KAAK,GAAG,mBAAmB,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,mBAAmB,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,0BAA0B,CAAC,CAAC;IACzF,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC;IACvE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;AACzB,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,SAAkB;IACxC,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;IAClC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,0EAA0E;YACxE,4EAA4E;YAC5E,4EAA4E,CAC/E,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAE1B,IAAI,CAAC;QACH,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,oBAAoB,EAAE,CAAC;YACtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,QAAQ,SAAS,CAAC,GAAG,oBAAoB,SAAS,CAAC,QAAQ,IAAI;gBAC7D,yCAAyC,SAAS,CAAC,SAAS,OAAO,CACtE,CAAC;YACF,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;YAChE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,OAAO,CAAC,SAAS,KAAK,CAAC,CAAC;YACnE,OAAO;QACT,CAAC;QAED,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;QACnD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,6CAA6C,YAAY,MAAM,CAAC,CAAC;QACtF,cAAc,CAAC,YAAY,CAAC,CAAC;QAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;QAExD,8EAA8E;QAC9E,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;YAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC1E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,OAAO,CAAC,SAAS,KAAK,CAAC,CAAC;IACrE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAkB,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC;QAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAMD,KAAK,UAAU,gBAAgB,CAC7B,MAAe,EACf,SAAS,GAAG,OAAO;IAEnB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IACxC,MAAM,CAAC,GAAG,MAA2B,CAAC;IACtC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC,CAAC,YAAY;YAAE,OAAO,CAAC,CAAC,YAAY,CAAC;QAC1C,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,cAAc,CAAC,GAAW;IACjC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,MAAM,GAAG,GACP,QAAQ,KAAK,QAAQ;QACnB,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,QAAQ,KAAK,OAAO;YACpB,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,UAAU,CAAC;IACnB,IAAI,CAAC;QACH,gCAAgC;QAChC,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;QAC/C,IAAI,CAAC,GAAG,GAAG,KAAK,GAAG,GAAG,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,WAAW;IACb,CAAC;AACH,CAAC;AAED,KAAK,UAAU,SAAS;IACtB,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;IAClC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,wDAAwD;YACtD,6EAA6E,CAChF,CAAC;QACF,OAAO;IACT,CAAC;IACD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAC1B,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;AACtE,CAAC;AAED,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E,KAAK,UAAU,SAAS,CAAC,GAAY;IACnC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,sBAAsB,CAAC;IACrE,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;IAE9D,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC;QAChC,OAAO;QACP,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa;QACjC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB;QACvC,GAAG;KACJ,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,EAAE,CAAC;QAC9B,GAAG,CAAC,yEAAyE,CAAC,CAAC;QAC/E,GAAG,CAAC,wFAAwF,CAAC,CAAC;IAChG,CAAC;IAED,4DAA4D;IAC5D,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;QACjB,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;YACnB,GAAG,CACD,iGAAiG,CAClG,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,GAAG,CAAC,sBAAsB,OAAO,2BAA2B,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC5E,MAAM,eAAe,CAAC,MAAM,EAAE;YAC5B,OAAO,EAAE,OAAO;YAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,gBAAgB,EAAE,GAAG,CAAC,SAAS;SAChC,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,4BAA4B;IAC5B,GAAG,CAAC,sBAAsB,OAAO,yBAAyB,UAAU,QAAQ,CAAC,CAAC;IAC9E,MAAM,gBAAgB,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AACvD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,4EAA4E;AAC5E,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,CAAC;AAC5C,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC"}

package/dist/prompts.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Capix MCP Server — prompts.
+ *
+ * Prompts are parameterised, server-side message templates the MCP client can
+ * list and instantiate. Each prompt returns a short multi-message transcript
+ * that guides an agent through a common Capix workflow (deploy, diagnose,
+ * preview, plan, cleanup) — always ending with an assistant reminder that
+ * billable tools require a bound approval token before they will execute.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/** Static prompt descriptor surfaced via prompts/list. */
+export interface CapixPrompt {
+    name: string;
+    description: string;
+    arguments: Array<{
+        name: string;
+        description: string;
+        required?: boolean;
+    }>;
+}
+export declare const CAPIX_PROMPTS: CapixPrompt[];
+/**
+ * Register all Capix prompts with the given McpServer. Prompt callbacks are
+ * pure (no API calls) — they render a guided transcript the agent then drives
+ * by calling the referenced tools.
+ */
+export declare function registerPrompts(server: McpServer): void;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC7E;AAED,eAAO,MAAM,aAAa,EAAE,WAAW,EA6CtC,CAAC;AAKF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwKvD"}

package/dist/prompts.js

@@ -0,0 +1,203 @@
+/**
+ * Capix MCP Server — prompts.
+ *
+ * Prompts are parameterised, server-side message templates the MCP client can
+ * list and instantiate. Each prompt returns a short multi-message transcript
+ * that guides an agent through a common Capix workflow (deploy, diagnose,
+ * preview, plan, cleanup) — always ending with an assistant reminder that
+ * billable tools require a bound approval token before they will execute.
+ */
+import { z } from "zod";
+export const CAPIX_PROMPTS = [
+    {
+        name: "deploy_repository",
+        description: "Plan, quote, and deploy a repository as a Capix workload (compute or website).",
+        arguments: [
+            { name: "repoUrl", description: "Git repository URL.", required: true },
+            { name: "branch", description: "Branch to deploy (default: main)." },
+            { name: "region", description: "Preferred region." },
+            { name: "workloadType", description: "Workload type, e.g. replicated_service.v1." },
+        ],
+    },
+    {
+        name: "diagnose_deployment",
+        description: "Diagnose a failing deployment: pull logs, metrics, and health checks.",
+        arguments: [
+            { name: "deploymentId", description: "Deployment to diagnose.", required: true },
+        ],
+    },
+    {
+        name: "create_preview",
+        description: "Create a preview deployment of a website from a branch.",
+        arguments: [
+            { name: "siteId", description: "Website project id.", required: true },
+            { name: "branch", description: "Branch to preview.", required: true },
+        ],
+    },
+    {
+        name: "plan_stack",
+        description: "Validate and plan a multi-service stack from a manifest URL or inline spec.",
+        arguments: [
+            { name: "manifestUrl", description: "Stack manifest URL or inline spec.", required: true },
+        ],
+    },
+    {
+        name: "cleanup_task",
+        description: "Destroy all resources scoped to a completed task (§18 cleanup gate).",
+        arguments: [
+            { name: "taskId", description: "Task-scoped resource id.", required: true },
+        ],
+    },
+];
+const APPROVAL_REMINDER = "Plan validated. Awaiting your approval token before any billable Capix tool runs.";
+/**
+ * Register all Capix prompts with the given McpServer. Prompt callbacks are
+ * pure (no API calls) — they render a guided transcript the agent then drives
+ * by calling the referenced tools.
+ */
+export function registerPrompts(server) {
+    // deploy_repository
+    server.registerPrompt("deploy_repository", {
+        description: CAPIX_PROMPTS[0].description,
+        argsSchema: {
+            repoUrl: z.string().describe("Git repository URL."),
+            branch: z.string().optional().describe("Branch to deploy (default: main)."),
+            region: z.string().optional().describe("Preferred region."),
+            workloadType: z.string().optional().describe("Workload type, e.g. replicated_service.v1."),
+        },
+    }, async (args) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        `Deploy the repository ${args.repoUrl} (branch ${args.branch ?? "main"}) as a Capix workload.`,
+                        args.region ? `Target region: ${args.region}.` : "Region: auto-select cheapest feasible.",
+                        args.workloadType ? `Workload type: ${args.workloadType}.` : "",
+                        "Steps:",
+                        "1. capix_compute_plan — plan the deployment shape.",
+                        "2. capix_compute_quote — obtain a canonical quote.",
+                        "3. capix_deploy — provision against the quote (requires approvalToken).",
+                        "4. capix_run_health_checks — verify readiness.",
+                    ].filter(Boolean).join("\n"),
+                },
+            },
+            {
+                role: "assistant",
+                content: { type: "text", text: APPROVAL_REMINDER },
+            },
+        ],
+    }));
+    // diagnose_deployment
+    server.registerPrompt("diagnose_deployment", {
+        description: CAPIX_PROMPTS[1].description,
+        argsSchema: {
+            deploymentId: z.string().describe("Deployment to diagnose."),
+        },
+    }, async (args) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        `Diagnose deployment ${args.deploymentId}:`,
+                        "1. capix_inspect_logs — recent log lines.",
+                        "2. capix_inspect_metrics — resource metrics.",
+                        "3. capix_run_health_checks — probe results.",
+                        "Summarise the failure mode and propose remediation (restart vs redeploy vs rollback).",
+                    ].join("\n"),
+                },
+            },
+            {
+                role: "assistant",
+                content: {
+                    type: "text",
+                    text: "Diagnosis plan ready. All inspection tools are read-only and may auto-run; no approval token required.",
+                },
+            },
+        ],
+    }));
+    // create_preview
+    server.registerPrompt("create_preview", {
+        description: CAPIX_PROMPTS[2].description,
+        argsSchema: {
+            siteId: z.string().describe("Website project id."),
+            branch: z.string().describe("Branch to preview."),
+        },
+    }, async (args) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        `Create a preview deployment for website ${args.siteId}, branch ${args.branch}.`,
+                        "1. capix_website_preview — build a preview (requires approvalToken).",
+                        "2. Return the preview URL.",
+                    ].join("\n"),
+                },
+            },
+            {
+                role: "assistant",
+                content: { type: "text", text: APPROVAL_REMINDER },
+            },
+        ],
+    }));
+    // plan_stack
+    server.registerPrompt("plan_stack", {
+        description: CAPIX_PROMPTS[3].description,
+        argsSchema: {
+            manifestUrl: z.string().describe("Stack manifest URL or inline spec."),
+        },
+    }, async (args) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        `Validate and plan the stack manifest at ${args.manifestUrl}.`,
+                        "1. capix_stack_validate — check the manifest.",
+                        "2. capix_stack_plan — produce a service plan graph + aggregate quote.",
+                        "Report feasibility and per-service cost.",
+                    ].join("\n"),
+                },
+            },
+            {
+                role: "assistant",
+                content: {
+                    type: "text",
+                    text: "Stack planning tools are read-only and may auto-run; no approval token required.",
+                },
+            },
+        ],
+    }));
+    // cleanup_task
+    server.registerPrompt("cleanup_task", {
+        description: CAPIX_PROMPTS[4].description,
+        argsSchema: {
+            taskId: z.string().describe("Task-scoped resource id."),
+        },
+    }, async (args) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        `Destroy all task-scoped resources for ${args.taskId} (§18 cleanup gate).`,
+                        "1. capix_destroy_task_resources — release allocations (requires approvalToken).",
+                        "2. capix_receipts — confirm final settlement.",
+                    ].join("\n"),
+                },
+            },
+            {
+                role: "assistant",
+                content: { type: "text", text: APPROVAL_REMINDER },
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

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

package/dist/resources.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Capix MCP Server — resources (capix:// URIs).
+ *
+ * Resources are read-only views the MCP client can list and read by URI. They
+ * mirror the discovery + website sub-ports: account, balance, projects,
+ * catalogs, deployments, receipts, attestations, websites, and memory/skills
+ * intelligence surfaces.
+ *
+ * `registerResources(server, client)` wires each `capix://…` URI to a
+ * `readResource` callback that delegates to the canonical Capix API client.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { CapixClient } from "./client.js";
+/** Static resource descriptor surfaced via resources/list. */
+export interface CapixResource {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: "application/json";
+}
+export declare const CAPIX_RESOURCES: CapixResource[];
+/**
+ * Register all capix:// resources with the given McpServer. Each resource's
+ * read callback delegates to the canonical Capix API client and returns the
+ * raw JSON object as a text content block.
+ */
+export declare function registerResources(server: McpServer, client: CapixClient): void;
+//# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,8DAA8D;AAC9D,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,kBAAkB,CAAC;CAC9B;AAED,eAAO,MAAM,eAAe,EAAE,aAAa,EAiD1C,CAAC;AAgBF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAuB9E"}