runpane 2.4.129 → 2.4.131

package/dist/mcpSdk.js.LEGAL.txt

@@ -0,0 +1,8 @@
+Bundled license information:
+
+@modelcontextprotocol/server/dist/src-CX2iR2pK.mjs:
+  /*!
+  * content-type
+  * Copyright(c) 2015 Douglas Christopher Wilson
+  * MIT Licensed
+  */

package/dist/mcpTools.d.ts

@@ -0,0 +1,78 @@
+import { type JsonObject } from './boundaryDecoder';
+/**
+ * The slice of the runpane contract that MCP tools are generated from. Every
+ * command with result `jsonSchemas` becomes a tool; its inputs are the union of
+ * the flags in its `usage` lines and its `agentContext` arguments, plus
+ * `--pane-dir` for daemon commands. Its output schema is the command's `*Result` schema.
+ */
+export interface McpToolContract {
+    commands: readonly {
+        name: string;
+        summary: string;
+        usage: readonly string[];
+        mutates?: boolean;
+        additive?: boolean;
+        idempotent?: boolean;
+        openWorld?: boolean;
+        toolsets?: readonly string[];
+        jsonSchemas?: readonly string[];
+    }[];
+    /** Named JSON Schemas; `#/jsonSchemas/...` refs inside them resolve against the contract root. */
+    jsonSchemas: unknown;
+    flags: Readonly<Record<string, readonly {
+        name: string;
+        value?: string;
+        description?: string;
+    }[]>>;
+    agentContext: {
+        commands: Readonly<Record<string, {
+            details?: string;
+            requiresPaneDaemon?: boolean;
+            notes?: readonly string[];
+            arguments: readonly {
+                name: string;
+                value?: string;
+                required?: boolean;
+                description?: string;
+            }[];
+        }>>;
+    };
+}
+interface McpToolParameter {
+    flag: string;
+    property: string;
+    takesValue: boolean;
+}
+export interface McpTool {
+    name: string;
+    title: string;
+    command: string;
+    /** Contract toolsets that serve this tool (`runpane mcp --toolsets`). */
+    toolsets: readonly string[];
+    description: string;
+    parameters: McpToolParameter[];
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, {
+            type: 'string' | 'boolean';
+            description: string;
+        }>;
+        required?: string[];
+        additionalProperties: false;
+    };
+    outputSchema: JsonObject;
+    /** MCP tool annotations; see the `additive`, `idempotent`, and `openWorld` contract fields. */
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+}
+export declare const CONFIRM_FLAG = "--yes";
+export declare function buildMcpTools(contract?: McpToolContract): McpTool[];
+/** Builds the argv for one tool call; the result is `runpane <argv>` with `--json`. */
+export declare function buildToolArgv(tool: McpTool, input?: JsonObject): string[];
+export {};
+//# sourceMappingURL=mcpTools.d.ts.map

package/dist/mcpTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpTools.d.ts","sourceRoot":"","sources":["../src/mcpTools.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,UAAU,EAAkB,MAAM,mBAAmB,CAAC;AAG9F;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,SAAS;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;QACzB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAC7B,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;KACjC,EAAE,CAAC;IACJ,kGAAkG;IAClG,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAC,CAAC;IACnG,YAAY,EAAE;QACZ,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;YAChC,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,kBAAkB,CAAC,EAAE,OAAO,CAAC;YAC7B,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;YAC1B,SAAS,EAAE,SAAS;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,KAAK,CAAC,EAAE,MAAM,CAAC;gBAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;gBAAC,WAAW,CAAC,EAAE,MAAM,CAAA;aAAE,EAAE,CAAC;SAClG,CAAC,CAAC,CAAC;KACL,CAAC;CACH;AAED,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAChF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,oBAAoB,EAAE,KAAK,CAAC;KAC7B,CAAC;IACF,YAAY,EAAE,UAAU,CAAC;IACzB,+FAA+F;IAC/F,WAAW,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,OAAO,CAAC;QACtB,eAAe,EAAE,OAAO,CAAC;QACzB,cAAc,EAAE,OAAO,CAAC;QACxB,aAAa,EAAE,OAAO,CAAC;KACxB,CAAC;CACH;AAOD,eAAO,MAAM,YAAY,UAAU,CAAC;AAKpC,wBAAgB,aAAa,CAAC,QAAQ,GAAE,eAAkC,GAAG,OAAO,EAAE,CAMrF;AAqID,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,GAAE,UAAe,GAAG,MAAM,EAAE,CAoB7E"}

package/dist/mcpTools.js

@@ -0,0 +1,195 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIRM_FLAG = void 0;
+exports.buildMcpTools = buildMcpTools;
+exports.buildToolArgv = buildToolArgv;
+const boundaryDecoder_1 = require("./boundaryDecoder");
+const contract_1 = require("./generated/contract");
+// --json is always passed; --follow streams forever, which a single tool call cannot return.
+const OMITTED_FLAGS = new Set(['--json', '--follow', '--help']);
+const FLAG_PATTERN = /--[a-z][a-z0-9-]*/g;
+// Clients sometimes send numeric flags such as timeoutMs as JSON numbers.
+const flagValueSchema = boundaryDecoder_1.boundary.union(boundaryDecoder_1.boundary.string, boundaryDecoder_1.boundary.number);
+exports.CONFIRM_FLAG = '--yes';
+const CONFIRM_DESCRIPTION = 'Confirm this change (the CLI\'s --yes). Pane refuses mutating calls without it.';
+function buildMcpTools(contract = contract_1.RUNPANE_CONTRACT) {
+    const globalFlags = new Map(Object.values(contract.flags).flat().map((flag) => [flag.name, flag]));
+    const schemas = (0, boundaryDecoder_1.decodeBoundary)(JSON.parse(JSON.stringify(contract.jsonSchemas)), boundaryDecoder_1.boundary.jsonObject);
+    return contract.commands
+        .filter((command) => command.jsonSchemas && command.jsonSchemas.length > 0)
+        .map((command) => buildTool(contract, command, globalFlags, schemas));
+}
+function buildTool(contract, command, globalFlags, schemas) {
+    const context = contract.agentContext.commands[command.name];
+    const contextArgs = new Map((context?.arguments ?? []).map((arg) => [arg.name, arg]));
+    const usage = command.usage.join(' ');
+    const flagNames = new Set();
+    for (const flag of usage.match(FLAG_PATTERN) ?? [])
+        flagNames.add(flag);
+    for (const arg of context?.arguments ?? []) {
+        if (arg.name.startsWith('--'))
+            flagNames.add(arg.name);
+    }
+    // Every daemon command accepts --pane-dir, even where its usage line omits it.
+    if (context?.requiresPaneDaemon)
+        flagNames.add('--pane-dir');
+    const parameters = [];
+    const properties = {};
+    const required = [];
+    for (const flag of flagNames) {
+        if (OMITTED_FLAGS.has(flag))
+            continue;
+        const contextArg = contextArgs.get(flag);
+        const globalFlag = globalFlags.get(flag);
+        const placeholder = contextArg?.value ?? globalFlag?.value ?? usagePlaceholder(usage, flag);
+        const isConfirm = flag === exports.CONFIRM_FLAG;
+        const baseDescription = isConfirm
+            ? CONFIRM_DESCRIPTION
+            : contextArg?.description ?? globalFlag?.description ?? '';
+        const parameter = { flag, property: toProperty(flag), takesValue: placeholder !== undefined };
+        parameters.push(parameter);
+        properties[parameter.property] = {
+            type: parameter.takesValue ? 'string' : 'boolean',
+            description: placeholder ? `${baseDescription} Expects ${placeholder}.`.trim() : baseDescription,
+        };
+        const isRequired = !isConfirm
+            && command.usage.every((line) => requiredFlagsIn(line).has(flag))
+            && (contextArg === undefined || contextArg.required === true);
+        if (isRequired)
+            required.push(parameter.property);
+    }
+    const inputSchema = { type: 'object', properties, additionalProperties: false };
+    if (required.length > 0)
+        inputSchema.required = required;
+    const mutates = command.mutates === true;
+    const title = `runpane ${command.name}`;
+    return {
+        name: toToolName(command.name),
+        title,
+        command: command.name,
+        toolsets: command.toolsets ?? [],
+        description: [
+            command.summary,
+            context?.details,
+            ...(context?.notes ?? []),
+            `Returns the JSON of \`runpane ${command.name} --json\`.`,
+        ].filter(Boolean).join('\n'),
+        parameters,
+        inputSchema,
+        outputSchema: buildOutputSchema(command.jsonSchemas ?? [], schemas),
+        annotations: {
+            title,
+            readOnlyHint: !mutates,
+            // The MCP default for a tool that changes state is destructive; the contract marks the additive ones.
+            destructiveHint: mutates && command.additive !== true,
+            idempotentHint: command.idempotent === true,
+            openWorldHint: command.openWorld === true,
+        },
+    };
+}
+/**
+ * An object schema accepting any of the command's `*Result` schemas, with contract-root refs
+ * (`#/jsonSchemas/...`) inlined so the schema stands alone. Refs local to a result schema
+ * (`#/$defs/...`) keep working because its `$defs` move to the root with it.
+ */
+function buildOutputSchema(names, schemas) {
+    const results = names.filter((name) => name.endsWith('Result')).map((name) => inlineContractRefs(schemas[name], schemas));
+    const defs = {};
+    const variants = results.map((result) => {
+        const variant = (0, boundaryDecoder_1.decodeBoundary)(result, boundaryDecoder_1.boundary.jsonObject);
+        const { $defs, ...rest } = variant;
+        Object.assign(defs, (0, boundaryDecoder_1.decodeBoundary)($defs ?? {}, boundaryDecoder_1.boundary.jsonObject));
+        return rest;
+    });
+    const outputSchema = variants.length === 1 ? { ...variants[0], type: 'object' } : { type: 'object', oneOf: variants };
+    if (Object.keys(defs).length > 0)
+        outputSchema.$defs = defs;
+    return outputSchema;
+}
+const CONTRACT_REF_PREFIX = '#/jsonSchemas/';
+const refSchema = boundaryDecoder_1.boundary.object({ $ref: boundaryDecoder_1.boundary.string });
+function inlineContractRefs(node, schemas, depth = 0) {
+    if (depth > 32)
+        throw new Error('runpane contract schema refs nest too deeply');
+    if (node === undefined)
+        throw new Error('runpane contract names a JSON schema that does not exist');
+    if (Array.isArray(node))
+        return node.map((item) => inlineContractRefs(item, schemas, depth + 1));
+    const object = asObject(node);
+    if (!object)
+        return node;
+    const ref = asRef(object);
+    if (ref?.startsWith(CONTRACT_REF_PREFIX)) {
+        const target = ref.slice(CONTRACT_REF_PREFIX.length).split('/')
+            .reduce((current, segment) => (Array.isArray(current) ? current[Number(segment)] : asObject(current)?.[segment]), schemas);
+        return inlineContractRefs(target, schemas, depth + 1);
+    }
+    const inlined = Object.fromEntries(Object.entries(object).map(([key, value]) => [key, inlineContractRefs(value, schemas, depth + 1)]));
+    // Several MCP clients read `type` as one string, so `type: ["string", "null"]` becomes an equivalent `anyOf`.
+    const { type, ...rest } = inlined;
+    if (!Array.isArray(type) || rest.anyOf !== undefined)
+        return inlined;
+    return { ...rest, anyOf: type.map((member) => ({ type: member })) };
+}
+function asObject(value) {
+    if (value === undefined || value === null || Array.isArray(value))
+        return undefined;
+    try {
+        return (0, boundaryDecoder_1.decodeBoundary)(value, boundaryDecoder_1.boundary.jsonObject);
+    }
+    catch {
+        return undefined;
+    }
+}
+function asRef(value) {
+    try {
+        return (0, boundaryDecoder_1.decodeBoundary)(value, refSchema).$ref;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Builds the argv for one tool call; the result is `runpane <argv>` with `--json`. */
+function buildToolArgv(tool, input = {}) {
+    const argv = tool.command.split(' ');
+    const known = new Set(tool.parameters.map((parameter) => parameter.property));
+    const unknown = Object.keys(input).filter((key) => !known.has(key));
+    if (unknown.length > 0) {
+        throw new Error(`Unknown argument(s) for ${tool.name}: ${unknown.join(', ')}`);
+    }
+    for (const parameter of tool.parameters) {
+        const value = input[parameter.property];
+        if (value === undefined || value === null || value === false)
+            continue;
+        if (!parameter.takesValue) {
+            if (value !== true)
+                throw new Error(`${parameter.property} must be a boolean.`);
+            argv.push(parameter.flag);
+            continue;
+        }
+        // `--flag=value` keeps values that start with "-" (like "- [ ] item") from reading as flags.
+        argv.push(`${parameter.flag}=${String((0, boundaryDecoder_1.decodeBoundary)(value, flagValueSchema))}`);
+    }
+    argv.push('--json');
+    return argv;
+}
+function requiredFlagsIn(usageLine) {
+    let line = usageLine;
+    let previous;
+    do {
+        previous = line;
+        line = line.replace(/\[[^[\]]*\]|\([^()]*\)/g, '');
+    } while (line !== previous);
+    return new Set(line.match(FLAG_PATTERN) ?? []);
+}
+function usagePlaceholder(usage, flag) {
+    const match = new RegExp(`${flag} (<[^>]+>|[a-z]+(?:\\|[a-z]+)+)`).exec(usage);
+    return match?.[1];
+}
+function toProperty(flag) {
+    return flag.slice(2).replace(/-([a-z0-9])/g, (_, letter) => letter.toUpperCase());
+}
+function toToolName(command) {
+    return command.replace(/[\s-]+/g, '_');
+}
+//# sourceMappingURL=mcpTools.js.map

package/dist/mcpTools.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runpane",
-  "version": "2.4.129",
+  "version": "2.4.131",
   "description": "Thin npm installer and remote setup CLI for Pane",
   "license": "AGPL-3.0",
   "homepage": "https://runpane.com",
@@ -22,7 +22,7 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsc && node scripts/mark-executable.js",
+    "build": "tsc && node scripts/bundle-mcp-sdk.js && node scripts/build-docs-index.js && node scripts/mark-executable.js",
     "lint": "pnpm --dir ../.. run lint:ox:runpane && pnpm run lint:eslint",
     "lint:eslint": "eslint src --ext .ts",
     "typecheck": "tsc --noEmit",
@@ -36,7 +36,10 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.17.0",
+    "@modelcontextprotocol/sdk": "1.16.0",
+    "@modelcontextprotocol/server": "2.0.0",
     "@types/node": "^22.10.2",
+    "esbuild": "0.25.7",
     "eslint": "^9.17.0",
     "typescript": "^5.7.2",
     "typescript-eslint": "^8.19.0"