@glows777/vela-mcp 0.0.0-stage → 0.5.0

package/dist/config.js

@@ -0,0 +1,226 @@
+/**
+ * MCP server configuration (like pi's `extensions/mcp/config.ts`): the `mcpServers` format of
+ * Claude Desktop / Claude Code, read from `~/.vela/mcp.json` and the trusted project's
+ * `.vela/mcp.json`. Invalid entries are reported and skipped; they don't stop other servers.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+const isPlainObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const EXPOSURES = ['direct', 'deferred', 'hidden'];
+/** Server names: letters, digits, `_` and `-` (like pi). */
+const SERVER_NAME = /^[A-Za-z0-9_-]+$/;
+const stringRecord = (value) => isPlainObject(value) &&
+    Object.values(value).every((item) => typeof item === 'string');
+/** Validates one `mcpServers` entry; throws a message naming the problem. */
+function parseServerConfig(name, raw) {
+    const fail = (message) => {
+        throw new Error(`MCP server "${name}": ${message}`);
+    };
+    if (!SERVER_NAME.test(name))
+        fail('names may contain only letters, digits, "_" and "-"');
+    if (!isPlainObject(raw))
+        return fail('must be an object');
+    const { type } = raw;
+    if (type === 'sse' || (type === undefined && raw.transport === 'sse'))
+        fail('the legacy SSE transport is not supported; use the streamable HTTP endpoint (often /mcp instead of /sse)');
+    if (type !== undefined &&
+        type !== 'stdio' &&
+        type !== 'http' &&
+        type !== 'streamable-http')
+        fail(`type must be "stdio", "http" or "streamable-http"`);
+    if (raw.timeout !== undefined) {
+        if (typeof raw.timeout !== 'number' || !(raw.timeout > 0))
+            fail('timeout must be a positive number of seconds');
+    }
+    if (raw.enabled !== undefined && typeof raw.enabled !== 'boolean')
+        fail('enabled must be true or false');
+    if (raw.description !== undefined && typeof raw.description !== 'string')
+        fail('description must be a string');
+    const exposure = (value, where) => {
+        if (value === 'codemode' || value === 'codemode-deferred')
+            fail(`${where} "${value}" is not available: Vela has no codemode yet. Use "deferred" (tool_search loads the tools) or "direct"`);
+        if (!EXPOSURES.includes(value))
+            fail(`${where} must be one of ${EXPOSURES.join(', ')}`);
+    };
+    if (raw.exposure !== undefined)
+        exposure(raw.exposure, 'exposure');
+    if (raw.toolExposure !== undefined) {
+        if (!isPlainObject(raw.toolExposure))
+            fail('toolExposure must be an object of tool name → exposure');
+        for (const [tool, value] of Object.entries(raw.toolExposure))
+            exposure(value, `toolExposure["${tool}"]`);
+    }
+    const isHttp = type === 'http' ||
+        type === 'streamable-http' ||
+        (type === undefined && raw.url !== undefined);
+    if (isHttp) {
+        if (typeof raw.url !== 'string' || !URL.canParse(raw.url))
+            fail('url must be a valid URL');
+        if (raw.headers !== undefined && !stringRecord(raw.headers))
+            fail('headers must be an object of strings');
+        if (raw.command !== undefined)
+            fail('set either command (stdio) or url (HTTP), not both');
+    }
+    else {
+        if (typeof raw.command !== 'string' || raw.command.trim() === '')
+            fail('needs a command (stdio) or a url (HTTP)');
+        if (raw.args !== undefined &&
+            !(Array.isArray(raw.args) &&
+                raw.args.every((arg) => typeof arg === 'string')))
+            fail('args must be an array of strings');
+        if (raw.env !== undefined && !stringRecord(raw.env))
+            fail('env must be an object of strings');
+        if (raw.cwd !== undefined && typeof raw.cwd !== 'string')
+            fail('cwd must be a string');
+    }
+    return raw;
+}
+/**
+ * Validates `mcpServers`. Server names that differ only in `-` and `_` count as the same server
+ * (their tool names would be the same); the second one is an error.
+ */
+export function parseServers(servers, sources = {}) {
+    const entries = [];
+    const errors = [];
+    const keys = new Map();
+    for (const [name, raw] of Object.entries(servers)) {
+        try {
+            const config = parseServerConfig(name, raw);
+            const key = name.replaceAll('-', '_');
+            const clash = keys.get(key);
+            if (clash)
+                throw new Error(`MCP server "${name}": clashes with "${clash}" (names differing only in "-" and "_" are the same server)`);
+            keys.set(key, name);
+            entries.push({ name, config, source: sources[name] ?? 'options' });
+        }
+        catch (error) {
+            errors.push(error instanceof Error ? error.message : String(error));
+        }
+    }
+    return { entries, errors };
+}
+/** The exposure of one of the server's tools: exact `toolExposure` names, then the first matching pattern, then the server's. */
+export function toolExposureOf(config, tool) {
+    const overrides = config.toolExposure ?? {};
+    const exact = overrides[tool];
+    if (exact)
+        return exact;
+    for (const [pattern, exposure] of Object.entries(overrides)) {
+        if (!pattern.includes('*'))
+            continue;
+        const regex = new RegExp(`^${pattern
+            .split('*')
+            .map((part) => part.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'))
+            .join('.*')}$`);
+        if (regex.test(tool))
+            return exposure;
+    }
+    return config.exposure ?? 'deferred';
+}
+/** Keys a project entry without `command`, `url` or `type` overrides on the user entry of the same name (like pi). */
+const OVERRIDE_KEYS = ['enabled', 'exposure', 'toolExposure'];
+/** `${NAME}` / `$NAME` in env and header values; unlike settings.json, an unset variable is an error (the server would fail anyway). */
+function interpolateStrict(value, env, where) {
+    return value.replace(/\$\$|\$\{([A-Za-z_][A-Za-z0-9_]*)\}|\$([A-Za-z_][A-Za-z0-9_]*)/g, (match, braced, bare) => {
+        if (match === '$$')
+            return '$';
+        const name = (braced ?? bare);
+        const resolved = env[name];
+        if (resolved === undefined)
+            throw new Error(`${where} uses \${${name}}, which is not set`);
+        return resolved;
+    });
+}
+function interpolateServer(name, raw, env) {
+    if (!isPlainObject(raw))
+        return raw;
+    const result = { ...raw };
+    for (const key of ['env', 'headers']) {
+        const values = raw[key];
+        if (!stringRecord(values))
+            continue;
+        result[key] = Object.fromEntries(Object.entries(values).map(([k, v]) => [
+            k,
+            interpolateStrict(v, env, `MCP server "${name}" ${key} "${k}"`),
+        ]));
+    }
+    for (const key of ['url', 'command', 'cwd'])
+        if (typeof raw[key] === 'string')
+            result[key] = interpolateStrict(raw[key], env, `MCP server "${name}" ${key}`);
+    if (Array.isArray(raw.args))
+        result.args = raw.args.map((arg) => typeof arg === 'string'
+            ? interpolateStrict(arg, env, `MCP server "${name}" args`)
+            : arg);
+    return result;
+}
+/**
+ * Reads `<agentDir>/mcp.json`, then `<cwd>/.vela/mcp.json` when the project is trusted (like pi). A
+ * project entry replaces the user entry of the same name; one without `command`, `url` or `type`
+ * only overrides its `enabled`, `exposure` and `toolExposure`. Variables are resolved from `env`.
+ */
+export function loadMcpServers(options) {
+    const result = { servers: {}, sources: {}, errors: [] };
+    const files = [join(options.agentDir, 'mcp.json')];
+    if (options.trusted)
+        files.push(join(options.projectDir, 'mcp.json'));
+    for (const file of files) {
+        if (!existsSync(file))
+            continue;
+        let servers;
+        try {
+            servers = JSON.parse(readFileSync(file, 'utf-8')).mcpServers;
+            if (servers === undefined)
+                continue;
+            if (!isPlainObject(servers))
+                throw new Error('mcpServers must be an object');
+        }
+        catch (error) {
+            result.errors.push(`${file}: ${error instanceof Error ? error.message : String(error)}`);
+            continue;
+        }
+        for (const [name, raw] of Object.entries(servers)) {
+            const existing = result.servers[name];
+            let entry = raw;
+            if (isPlainObject(raw) &&
+                isPlainObject(existing) &&
+                raw.command === undefined &&
+                raw.url === undefined &&
+                raw.type === undefined) {
+                const extra = Object.keys(raw).filter((key) => !OVERRIDE_KEYS.includes(key));
+                if (extra.length > 0) {
+                    result.errors.push(`${file}: MCP server "${name}": an override can only set ${OVERRIDE_KEYS.join(', ')} (found ${extra.join(', ')})`);
+                    continue;
+                }
+                const overrides = Object.fromEntries(OVERRIDE_KEYS.filter((key) => key in raw).map((key) => [
+                    key,
+                    raw[key],
+                ]));
+                entry = { ...existing, ...overrides };
+            }
+            try {
+                result.servers[name] = interpolateServer(name, entry, options.env);
+                result.sources[name] = file;
+            }
+            catch (error) {
+                delete result.servers[name];
+                result.errors.push(error instanceof Error ? error.message : String(error));
+            }
+        }
+    }
+    return result;
+}
+export const mcpConfig = {
+    name: 'mcp',
+    projectResources: ['mcp.json'],
+    resolve(section, context) {
+        const files = loadMcpServers(context);
+        const settings = isPlainObject(section.mcpServers) ? section.mcpServers : {};
+        return {
+            ...section,
+            mcpServers: { ...settings, ...files.servers },
+            sources: files.sources,
+            errors: files.errors,
+        };
+    },
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/connection.d.ts

@@ -0,0 +1,61 @@
+/**
+ * One MCP server connection on the official MCP SDK (pi uses its own pi-mcp client; the behavior
+ * follows pi's `extensions/mcp/runtime.ts`). The SDK is imported only when a server connects, so
+ * Vela without MCP servers never loads it.
+ */
+import type { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
+import type { CallToolResult, Tool as McpTool } from '@modelcontextprotocol/sdk/types.js';
+import type { McpServerEntry } from './config.ts';
+import type { McpToolCaller } from './tools.ts';
+/**
+ * `disconnected`: the connection dropped (e.g. the stdio server exited); the next call reconnects.
+ * `failed`: the last connect failed; the next call tries again.
+ */
+export type McpServerState = 'idle' | 'connecting' | 'connected' | 'disconnected' | 'failed' | 'closed';
+export interface McpConnectionOptions {
+    entry: McpServerEntry;
+    /** The Vela's cwd: stdio servers' relative `cwd` resolves against it */
+    cwd: string;
+    /** Called when the tool list or instructions change (after connect, or on `tools/list_changed`) */
+    onTools: (connection: McpConnection) => void;
+    /** Called when `state` or `error` change */
+    onChange?: (connection: McpConnection) => void;
+    /** Creates the transport; tests pass an in-memory one */
+    createTransport?: (entry: McpServerEntry, cwd: string) => Promise<Transport>;
+}
+/** One configured server, shared by all sessions of a Vela. Connects lazily and reconnects after a drop. */
+export declare class McpConnection implements McpToolCaller {
+    private readonly options;
+    readonly entry: McpServerEntry;
+    state: McpServerState;
+    error: string | undefined;
+    tools: McpTool[];
+    /** Server instructions from `initialize`, describing its tools as a group */
+    instructions: string | undefined;
+    private client;
+    private opening;
+    /** The transport of a connect in progress, closed by close() so a starting server doesn't outlive the Vela */
+    private connecting;
+    /** Aborted by close(): cancels a connect in progress, including the wait between retries */
+    private readonly shutdown;
+    private stderrTail;
+    constructor(options: McpConnectionOptions);
+    get name(): string;
+    private get timeoutMs();
+    private setState;
+    /** Connects if not connected; concurrent callers share one attempt. */
+    connect(): Promise<Client>;
+    private open;
+    private describeConnectError;
+    private openOnce;
+    private createTransport;
+    private listTools;
+    private refreshTools;
+    callTool(name: string, args: Record<string, unknown>, options: Parameters<McpToolCaller['callTool']>[2]): Promise<CallToolResult>;
+    /** Closes the connection (stdio: close stdin, then SIGTERM, then SIGKILL, as the SDK does). */
+    close(): Promise<void>;
+    /** Drops the connection and connects again (`/mcp reconnect`). */
+    reconnect(): Promise<void>;
+}
+//# sourceMappingURL=connection.d.ts.map

package/dist/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAA;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAA;AAC9E,OAAO,KAAK,EACV,cAAc,EACd,IAAI,IAAI,OAAO,EAChB,MAAM,oCAAoC,CAAA;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAO/C;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,YAAY,GACZ,WAAW,GACX,cAAc,GACd,QAAQ,GACR,QAAQ,CAAA;AA2CZ,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,cAAc,CAAA;IACrB,wEAAwE;IACxE,GAAG,EAAE,MAAM,CAAA;IACX,mGAAmG;IACnG,OAAO,EAAE,CAAC,UAAU,EAAE,aAAa,KAAK,IAAI,CAAA;IAC5C,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,aAAa,KAAK,IAAI,CAAA;IAC9C,yDAAyD;IACzD,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAA;CAC7E;AAED,4GAA4G;AAC5G,qBAAa,aAAc,YAAW,aAAa;IAerC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAdpC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;IAC9B,KAAK,EAAE,cAAc,CAAS;IAC9B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,KAAK,EAAE,OAAO,EAAE,CAAK;IACrB,6EAA6E;IAC7E,YAAY,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,OAAO,CAA6B;IAC5C,8GAA8G;IAC9G,OAAO,CAAC,UAAU,CAAuB;IACzC,4FAA4F;IAC5F,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwB;IACjD,OAAO,CAAC,UAAU,CAAK;gBAEM,OAAO,EAAE,oBAAoB;IAI1D,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,OAAO,KAAK,SAAS,GAEpB;IAED,OAAO,CAAC,QAAQ;IAMhB,uEAAuE;IACvE,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;YAYZ,IAAI;IAkClB,OAAO,CAAC,oBAAoB;YAYd,QAAQ;YA2DR,eAAe;YA2Bf,SAAS;YAaT,YAAY;IAOpB,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,GAChD,OAAO,CAAC,cAAc,CAAC;IAW1B,+FAA+F;IACzF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B,kEAAkE;IAC5D,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CAMjC"}

package/dist/connection.js

@@ -0,0 +1,248 @@
+/**
+ * One MCP server connection on the official MCP SDK (pi uses its own pi-mcp client; the behavior
+ * follows pi's `extensions/mcp/runtime.ts`). The SDK is imported only when a server connects, so
+ * Vela without MCP servers never loads it.
+ */
+import { readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { setTimeout as sleep } from 'node:timers/promises';
+const DEFAULT_TIMEOUT_SECONDS = 60;
+const STDERR_TAIL_CHARS = 2_000;
+/** Delays between attempts to connect to an HTTP server that failed with a transient error (like pi). */
+const CONNECT_RETRY_DELAYS_MS = [250, 1_000];
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/** HTTP status of an SDK transport error, when it has one. */
+function httpStatus(error) {
+    const code = error?.code;
+    return typeof code === 'number' && code >= 100 && code < 600
+        ? code
+        : undefined;
+}
+/** Network failures and overloaded or restarting servers, worth another attempt (like pi). */
+function isTransient(error) {
+    const status = httpStatus(error);
+    if (status !== undefined)
+        return status === 408 || status === 429 || (status >= 500 && status !== 501);
+    return error instanceof TypeError;
+}
+/** `~` and `~/…` name the home directory, like in a shell. */
+function expandHome(value) {
+    if (value === '~')
+        return homedir();
+    if (value.startsWith('~/') || value.startsWith('~\\'))
+        return join(homedir(), value.slice(2));
+    return value;
+}
+/** Vela's version for `initialize`, from package.json (three levels up from src/ and dist/). */
+function velaVersion() {
+    try {
+        return JSON.parse(readFileSync(new URL('../../../package.json', import.meta.url), 'utf8')).version;
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+/** One configured server, shared by all sessions of a Vela. Connects lazily and reconnects after a drop. */
+export class McpConnection {
+    options;
+    entry;
+    state = 'idle';
+    error;
+    tools = [];
+    /** Server instructions from `initialize`, describing its tools as a group */
+    instructions;
+    client;
+    opening;
+    /** The transport of a connect in progress, closed by close() so a starting server doesn't outlive the Vela */
+    connecting;
+    /** Aborted by close(): cancels a connect in progress, including the wait between retries */
+    shutdown = new AbortController();
+    stderrTail = '';
+    constructor(options) {
+        this.options = options;
+        this.entry = options.entry;
+    }
+    get name() {
+        return this.entry.name;
+    }
+    get timeoutMs() {
+        return (this.entry.config.timeout ?? DEFAULT_TIMEOUT_SECONDS) * 1000;
+    }
+    setState(state, error) {
+        this.state = state;
+        this.error = error;
+        this.options.onChange?.(this);
+    }
+    /** Connects if not connected; concurrent callers share one attempt. */
+    connect() {
+        if (this.client)
+            return Promise.resolve(this.client);
+        if (this.state === 'closed')
+            return Promise.reject(new Error(`MCP server "${this.name}" has been shut down`));
+        this.opening ??= this.open().finally(() => {
+            this.opening = undefined;
+        });
+        return this.opening;
+    }
+    async open() {
+        this.setState('connecting');
+        const isHttp = 'url' in this.entry.config;
+        for (let attempt = 0;; attempt++) {
+            try {
+                const client = await this.openOnce();
+                if (this.shutdown.signal.aborted) {
+                    await client.close().catch(() => { });
+                    throw new Error('shut down');
+                }
+                this.client = client;
+                this.setState('connected');
+                this.options.onTools(this);
+                return client;
+            }
+            catch (error) {
+                const delay = CONNECT_RETRY_DELAYS_MS[attempt];
+                if (isHttp &&
+                    delay !== undefined &&
+                    isTransient(error) &&
+                    !this.shutdown.signal.aborted) {
+                    await sleep(delay, undefined, { signal: this.shutdown.signal }).catch(() => { });
+                    if (!this.shutdown.signal.aborted)
+                        continue;
+                }
+                const message = this.describeConnectError(error);
+                if (this.state !== 'closed')
+                    this.setState('failed', message);
+                throw new Error(message);
+            }
+        }
+    }
+    describeConnectError(error) {
+        if (this.shutdown.signal.aborted)
+            return `MCP server "${this.name}" has been shut down`;
+        const status = httpStatus(error);
+        let message = `MCP server "${this.name}" failed to connect: ${errorMessage(error)}`;
+        if (status === 401 || status === 403)
+            message += `. It requires sign-in, and Vela does not support MCP OAuth yet; set an Authorization header in its config instead`;
+        const tail = this.stderrTail.trim();
+        if (tail)
+            message += `\nServer stderr:\n${tail}`;
+        return message;
+    }
+    async openOnce() {
+        const [{ Client }, { ToolListChangedNotificationSchema }, { CfWorkerJsonSchemaValidator },] = await Promise.all([
+            import('@modelcontextprotocol/sdk/client/index.js'),
+            import('@modelcontextprotocol/sdk/types.js'),
+            import('@modelcontextprotocol/sdk/validation/cfworker'),
+        ]);
+        this.stderrTail = '';
+        const transport = await (this.options.createTransport ?? this.createTransport)(this.entry, this.options.cwd);
+        if (this.shutdown.signal.aborted) {
+            await transport.close().catch(() => { });
+            throw new Error('shut down');
+        }
+        this.connecting = transport;
+        const stderr = transport
+            .stderr;
+        stderr?.on('data', (chunk) => {
+            this.stderrTail = (this.stderrTail + chunk.toString()).slice(-STDERR_TAIL_CHARS);
+        });
+        const client = new Client({ name: 'vela', version: velaVersion() }, {
+            capabilities: {},
+            // Vela already depends on @cfworker/json-schema; ajv would compile schemas with new Function
+            jsonSchemaValidator: new CfWorkerJsonSchemaValidator(),
+        });
+        client.onclose = () => {
+            if (this.client !== client)
+                return;
+            this.client = undefined;
+            if (this.state !== 'closed')
+                this.setState('disconnected', `MCP server "${this.name}" disconnected${this.stderrTail.trim() ? `\nServer stderr:\n${this.stderrTail.trim()}` : ''}`);
+        };
+        client.setNotificationHandler(ToolListChangedNotificationSchema, () => {
+            void this.refreshTools(client).catch(() => { });
+        });
+        try {
+            await client.connect(transport, { timeout: this.timeoutMs });
+            this.instructions = client.getInstructions()?.trim() || undefined;
+            this.tools = await this.listTools(client);
+        }
+        catch (error) {
+            await client.close().catch(() => { });
+            throw error;
+        }
+        finally {
+            this.connecting = undefined;
+        }
+        return client;
+    }
+    async createTransport(entry, cwd) {
+        const { config } = entry;
+        if ('url' in config) {
+            const { StreamableHTTPClientTransport } = await import('@modelcontextprotocol/sdk/client/streamableHttp.js');
+            return new StreamableHTTPClientTransport(new URL(config.url), {
+                requestInit: { headers: config.headers ?? {} },
+            });
+        }
+        const { StdioClientTransport } = await import('@modelcontextprotocol/sdk/client/stdio.js');
+        return new StdioClientTransport({
+            command: expandHome(config.command),
+            args: config.args?.map(expandHome),
+            // Like pi: the server inherits the environment, as bash does (the SDK's default passes only a few variables)
+            // vela-boundary: allow
+            env: { ...process.env, ...config.env },
+            cwd: resolve(cwd, expandHome(config.cwd ?? '.')),
+            stderr: 'pipe',
+        });
+    }
+    async listTools(client) {
+        const tools = [];
+        let cursor;
+        do {
+            const page = await client.listTools(cursor ? { cursor } : undefined, {
+                timeout: this.timeoutMs,
+            });
+            tools.push(...page.tools);
+            cursor = page.nextCursor;
+        } while (cursor);
+        return tools;
+    }
+    async refreshTools(client) {
+        const tools = await this.listTools(client);
+        if (this.client !== client)
+            return;
+        this.tools = tools;
+        this.options.onTools(this);
+    }
+    async callTool(name, args, options) {
+        const client = await this.connect();
+        // Tool calls are not retried: the server may already have performed them (like pi)
+        return (await client.callTool({ name, arguments: args }, undefined, {
+            signal: options.signal,
+            timeout: this.timeoutMs,
+            resetTimeoutOnProgress: true,
+            ...(options.onProgress ? { onprogress: options.onProgress } : {}),
+        }));
+    }
+    /** Closes the connection (stdio: close stdin, then SIGTERM, then SIGKILL, as the SDK does). */
+    async close() {
+        this.shutdown.abort();
+        this.setState('closed');
+        const client = this.client;
+        this.client = undefined;
+        await Promise.all([
+            client?.close().catch(() => { }),
+            this.connecting?.close().catch(() => { }),
+        ]);
+    }
+    /** Drops the connection and connects again (`/mcp reconnect`). */
+    async reconnect() {
+        const client = this.client;
+        this.client = undefined;
+        await client?.close().catch(() => { });
+        await this.connect();
+    }
+}
+//# sourceMappingURL=connection.js.map

package/dist/connection.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The built-in MCP extension (like pi's `extensions/mcp`): connects to MCP servers over stdio or
+ * streamable HTTP and registers their tools as `mcp__<server>__<tool>`, deferred by default so
+ * tool_search loads them on demand.
+ *
+ * Unlike pi, one set of connections serves all sessions of a Vela (a Lark bot has many concurrent
+ * sessions); they start with the first session and close when the Vela is disposed.
+ */
+import type { VelaExtension } from '@glows777/vela-core/extension-api';
+import type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
+import { type McpServerConfig, type McpServerEntry } from './config.ts';
+export type { McpExposure, McpHttpServerConfig, McpServerConfig, McpServersFile, McpStdioServerConfig, } from './config.ts';
+export interface McpOptions {
+    /**
+     * Servers in the `mcpServers` format of Claude Desktop / Claude Code (`{ name: { command, args } }`
+     * or `{ name: { url, headers } }`). Default: `mcpServers` in this extension's config, which the
+     * CLI fills from `~/.vela/mcp.json` and the trusted project's `.vela/mcp.json`.
+     */
+    servers?: Record<string, McpServerConfig>;
+    /** @internal Creates transports (tests use in-memory servers) */
+    createTransport?: (entry: McpServerEntry, cwd: string) => Promise<Transport>;
+}
+/** The built-in MCP extension. Its tools are `mcp__<server>__<tool>`. */
+export declare function mcp(options?: McpOptions): VelaExtension;
+export { mcpConfig } from './config.ts';
+//# 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":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAEV,aAAa,EACd,MAAM,mCAAmC,CAAA;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAA;AAC9E,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,cAAc,EAGpB,MAAM,aAAa,CAAA;AAIpB,YAAY,EACV,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,oBAAoB,GACrB,MAAM,aAAa,CAAA;AAKpB,MAAM,WAAW,UAAU;IACzB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;IACzC,iEAAiE;IACjE,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAA;CAC7E;AAKD,yEAAyE;AACzE,wBAAgB,GAAG,CAAC,OAAO,GAAE,UAAe,GAAG,aAAa,CA2L3D;AA2CD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA"}