@sundaeswap/sprinkles 0.6.0 → 0.7.0

package/dist/cjs/Sprinkle/actions/mcp-adapter.js

@@ -0,0 +1,415 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.coerceMcpInput = coerceMcpInput;
+exports.createMcpServer = createMcpServer;
+exports.getMcpSdk = getMcpSdk;
+exports.runMcp = runMcp;
+exports.typeboxToJsonSchema = typeboxToJsonSchema;
+var _module = require("module");
+var _url = require("url");
+var _path = require("path");
+var _encryption = require("../encryption.js");
+var _typeGuards = require("../type-guards.js");
+var _runner = require("./runner.js");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); } /**
+ * MCP adapter for Sprinkles actions.
+ *
+ * Provides:
+ * - TypeBox to JSON Schema conversion (typeboxToJsonSchema)
+ * - BigInt string coercion for MCP input (coerceMcpInput)
+ * - Lazy MCP SDK import with graceful error (getMcpSdk)
+ * - MCP server creation from registered actions (createMcpServer)
+ * - MCP orchestrator that starts a stdio server (runMcp)
+ */
+// Re-import Sprinkle as a type only to avoid circular deps
+
+// Load package version for MCP server identification
+// Robustly find package.json - works from both src and dist directories
+function loadPackageVersion() {
+  const require = (0, _module.createRequire)(import.meta.url);
+  const __filename = (0, _url.fileURLToPath)(import.meta.url);
+  const __dirname = (0, _path.dirname)(__filename);
+
+  // Try multiple possible paths (handles src vs dist/esm vs dist/cjs)
+  const candidates = [(0, _path.resolve)(__dirname, "../../../package.json"),
+  // from src/Sprinkle/actions
+  (0, _path.resolve)(__dirname, "../../../../package.json") // from dist/*/Sprinkle/actions
+  ];
+  for (const candidate of candidates) {
+    try {
+      const pkg = require(candidate);
+      return pkg.version;
+    } catch {
+      // Try next candidate
+    }
+  }
+  return "0.0.0"; // Fallback if package.json not found
+}
+const PACKAGE_VERSION = loadPackageVersion();
+
+// ---------------------------------------------------------------------------
+// TypeBox to JSON Schema conversion
+// ---------------------------------------------------------------------------
+
+/**
+ * Convert a TypeBox schema to a plain JSON Schema object.
+ *
+ * Strips TypeBox-internal symbols and properties (Kind, OptionalKind, $id)
+ * and maps TypeBox-specific types to their JSON Schema equivalents:
+ * - BigInt -> { type: "string", pattern: "^-?[0-9]+$" } (JSON has no BigInt)
+ * - Sensitive string fields -> add writeOnly: true
+ * - Optional -> recurse on inner schema (Optional does not change Kind)
+ * - Union -> { anyOf: [...] }
+ * - Literal -> { type, const }
+ * - Null -> { type: "null" }
+ * - Unknown/unsupported -> {} (accepts anything)
+ */
+function typeboxToJsonSchema(schema) {
+  // Optional in TypeBox doesn't change the Kind, but marks the schema with
+  // OptionalKind. We can check for it and recurse transparently since all
+  // other guards still work correctly on optional-wrapped schemas.
+  //
+  // We intentionally do NOT strip optional here -- the containing Object
+  // converter decides whether to include a property in `required` based
+  // on the isOptional guard applied to the property schema.
+
+  if ((0, _typeGuards.isBigInt)(schema)) {
+    return {
+      type: "string",
+      pattern: "^-?[0-9]+$",
+      description: "BigInt value as string"
+    };
+  }
+  if ((0, _typeGuards.isString)(schema)) {
+    const result = {
+      type: "string"
+    };
+    if (schema.description !== undefined) result.description = schema.description;
+    if (schema.title !== undefined) result.title = schema.title;
+    if (schema.examples !== undefined) result.examples = schema.examples;
+    if (schema.pattern !== undefined) result.pattern = schema.pattern;
+    if (schema.minLength !== undefined) result.minLength = schema.minLength;
+    if (schema.maxLength !== undefined) result.maxLength = schema.maxLength;
+    if (schema.default !== undefined) result.default = schema.default;
+    // Sensitive fields are write-only (never returned in responses)
+    if ((0, _typeGuards.isSensitive)(schema)) result.writeOnly = true;
+    return result;
+  }
+  if ((0, _typeGuards.isNumber)(schema)) {
+    const result = {
+      type: "number"
+    };
+    if (schema.minimum !== undefined) result.minimum = schema.minimum;
+    if (schema.maximum !== undefined) result.maximum = schema.maximum;
+    if (schema.description !== undefined) result.description = schema.description;
+    if (schema.default !== undefined) result.default = schema.default;
+    return result;
+  }
+  if ((0, _typeGuards.isInteger)(schema)) {
+    const result = {
+      type: "integer"
+    };
+    if (schema.minimum !== undefined) result.minimum = schema.minimum;
+    if (schema.maximum !== undefined) result.maximum = schema.maximum;
+    if (schema.description !== undefined) result.description = schema.description;
+    if (schema.default !== undefined) result.default = schema.default;
+    return result;
+  }
+  if ((0, _typeGuards.isBoolean)(schema)) {
+    const result = {
+      type: "boolean"
+    };
+    if (schema.description !== undefined) result.description = schema.description;
+    if (schema.default !== undefined) result.default = schema.default;
+    return result;
+  }
+  if ((0, _typeGuards.isNull)(schema)) {
+    return {
+      type: "null"
+    };
+  }
+  if ((0, _typeGuards.isArray)(schema)) {
+    const result = {
+      type: "array"
+    };
+    const itemSchema = schema.items;
+    if (itemSchema) {
+      result.items = typeboxToJsonSchema(itemSchema);
+    }
+    if (schema.minItems !== undefined) result.minItems = schema.minItems;
+    if (schema.maxItems !== undefined) result.maxItems = schema.maxItems;
+    if (schema.description !== undefined) result.description = schema.description;
+    return result;
+  }
+  if ((0, _typeGuards.isObject)(schema)) {
+    const properties = schema.properties;
+    const required = schema.required ?? [];
+    const convertedProperties = {};
+    for (const [propName, propSchema] of Object.entries(properties)) {
+      convertedProperties[propName] = typeboxToJsonSchema(propSchema);
+    }
+    const result = {
+      type: "object",
+      properties: convertedProperties
+    };
+    if (required.length > 0) {
+      result.required = required;
+    }
+    if (schema.description !== undefined) result.description = schema.description;
+    return result;
+  }
+  if ((0, _typeGuards.isUnion)(schema)) {
+    return {
+      anyOf: schema.anyOf.map(member => typeboxToJsonSchema(member))
+    };
+  }
+  if ((0, _typeGuards.isLiteral)(schema)) {
+    const value = schema.const;
+    let type;
+    if (typeof value === "string") {
+      type = "string";
+    } else if (typeof value === "number") {
+      type = "number";
+    } else if (typeof value === "boolean") {
+      type = "boolean";
+    } else {
+      // Fallback for unexpected literal types
+      return {};
+    }
+    return {
+      type,
+      const: value
+    };
+  }
+
+  // Unknown / unsupported TypeBox type: emit empty schema (accepts anything)
+  // This is a safe fallback that allows the MCP tool to still receive input.
+  console.warn(`[mcp-adapter] Unsupported TypeBox kind: ${schema["[Kind]"] ?? "(unknown)"}. Emitting empty schema.`);
+  return {};
+}
+
+// ---------------------------------------------------------------------------
+// Input coercion: BigInt string -> BigInt
+// ---------------------------------------------------------------------------
+
+/**
+ * Coerce MCP JSON input values to the types expected by a TypeBox schema.
+ *
+ * MCP transmits all values as JSON, which has no BigInt type. When the schema
+ * expects a BigInt, the value arrives as a numeric string (e.g. "12345678").
+ * This function recursively walks the schema and input, converting BigInt
+ * string values to actual BigInt where needed.
+ *
+ * For all other types the value is passed through unchanged.
+ */
+function coerceMcpInput(input, schema) {
+  if (input === null || input === undefined) return input;
+  if ((0, _typeGuards.isBigInt)(schema)) {
+    if (typeof input === "bigint") return input;
+    if (typeof input === "string" && /^-?[0-9]+$/.test(input)) {
+      try {
+        return BigInt(input);
+      } catch {
+        return input;
+      }
+    }
+    if (typeof input === "number") {
+      try {
+        return BigInt(Math.trunc(input));
+      } catch {
+        return input;
+      }
+    }
+    return input;
+  }
+  if ((0, _typeGuards.isArray)(schema)) {
+    const itemSchema = schema.items;
+    if (Array.isArray(input) && itemSchema) {
+      return input.map(item => coerceMcpInput(item, itemSchema));
+    }
+    return input;
+  }
+  if ((0, _typeGuards.isObject)(schema)) {
+    if (typeof input !== "object" || Array.isArray(input)) return input;
+    const properties = schema.properties;
+    const result = {
+      ...input
+    };
+    for (const [propName, propSchema] of Object.entries(properties)) {
+      if (propName in result) {
+        result[propName] = coerceMcpInput(result[propName], propSchema);
+      }
+    }
+    return result;
+  }
+  if ((0, _typeGuards.isUnion)(schema)) {
+    // For unions, we try each member schema in order and return the first
+    // successful coercion. BigInt members take priority over string members
+    // since they have a narrower, unambiguous pattern.
+    for (const member of schema.anyOf) {
+      if ((0, _typeGuards.isBigInt)(member)) {
+        if (typeof input === "string" && /^-?[0-9]+$/.test(input)) {
+          return coerceMcpInput(input, member);
+        }
+      }
+    }
+    // No BigInt match; return as-is for other union members
+    return input;
+  }
+
+  // For all other types (String, Number, Integer, Boolean, Literal, Null):
+  // pass through unchanged -- MCP JSON already represents them correctly
+  return input;
+}
+
+// ---------------------------------------------------------------------------
+// Lazy MCP SDK import
+// ---------------------------------------------------------------------------
+
+/**
+ * MCP SDK module shape (the parts we use from @modelcontextprotocol/sdk).
+ * Typed loosely to avoid a hard dependency at compile time.
+ */
+
+/**
+ * Lazily import the MCP SDK server module.
+ *
+ * Throws a clear, actionable error if the SDK is not installed, rather than
+ * a cryptic "Cannot find module" Node error.
+ */
+async function getMcpSdk() {
+  try {
+    return await Promise.resolve().then(() => _interopRequireWildcard(require("@modelcontextprotocol/sdk/server/mcp.js")));
+  } catch {
+    throw new Error("MCP mode requires @modelcontextprotocol/sdk. Install it with: npm install @modelcontextprotocol/sdk");
+  }
+}
+
+/**
+ * Lazily import the MCP SDK stdio transport module.
+ */
+async function getMcpStdioTransport() {
+  try {
+    return await Promise.resolve().then(() => _interopRequireWildcard(require("@modelcontextprotocol/sdk/server/stdio.js")));
+  } catch {
+    throw new Error("MCP mode requires @modelcontextprotocol/sdk. Install it with: npm install @modelcontextprotocol/sdk");
+  }
+}
+
+// ---------------------------------------------------------------------------
+// MCP server creation
+// ---------------------------------------------------------------------------
+
+/**
+ * Create an MCP server and register all actions from a Sprinkle instance as
+ * MCP tools.
+ *
+ * Each action becomes a tool with:
+ * - name: action.name
+ * - description: action.description
+ * - input schema: typeboxToJsonSchema(action.inputSchema)
+ * - handler: coerces input, executes action, returns JSON result
+ *
+ * The Sprinkle instance must already be initialized with a profile before
+ * this function is called.
+ *
+ * @param sprinkle   - Fully-initialized Sprinkle instance
+ * @param serverName - Name to use for the MCP server
+ * @returns          The configured McpServer instance (not yet connected)
+ */
+async function createMcpServer(sprinkle, serverName
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+) {
+  const {
+    McpServer
+  } = await getMcpSdk();
+
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  const server = new McpServer({
+    name: serverName,
+    version: PACKAGE_VERSION
+  });
+  const actions = sprinkle.listActions();
+  for (const action of actions) {
+    const inputSchema = typeboxToJsonSchema(action.inputSchema);
+
+    // Register the action as an MCP tool.
+    // The high-level McpServer.tool() API accepts:
+    //   tool(name, description, schema, handler)
+    server.tool(action.name, action.description, inputSchema,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async input => {
+      const coercedInput = coerceMcpInput(input, action.inputSchema);
+      const context = {
+        sprinkle,
+        settings: sprinkle.settings
+      };
+
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      const result = await (0, _runner.executeAction)(action, coercedInput, context);
+      if (result.success) {
+        return {
+          content: [{
+            type: "text",
+            text: JSON.stringify(result.data, _encryption.bigIntReplacer)
+          }]
+        };
+      } else {
+        return {
+          content: [{
+            type: "text",
+            text: JSON.stringify({
+              error: {
+                code: result.error.code,
+                message: result.error.message,
+                details: result.error.details
+              }
+            }, _encryption.bigIntReplacer)
+          }],
+          isError: true
+        };
+      }
+    });
+  }
+  return server;
+}
+
+// ---------------------------------------------------------------------------
+// MCP orchestrator
+// ---------------------------------------------------------------------------
+
+/**
+ * Start an MCP server on stdio transport.
+ *
+ * This function:
+ * 1. Creates the MCP server and registers all actions as tools
+ * 2. Creates a StdioServerTransport
+ * 3. Connects the server to the transport
+ *
+ * IMPORTANT: All logging in this function goes to stderr. stdout is reserved
+ * for the MCP protocol messages.
+ *
+ * The Sprinkle instance must already be initialized with a profile. Profile
+ * initialization is the responsibility of the caller (Sprinkle.Run()).
+ *
+ * @param sprinkle   - Fully-initialized Sprinkle instance
+ * @param serverName - Name to use for the MCP server
+ */
+async function runMcp(sprinkle, serverName) {
+  const {
+    StdioServerTransport
+  } = await getMcpStdioTransport();
+  const server = await createMcpServer(sprinkle, serverName);
+  const transport = new StdioServerTransport();
+  try {
+    await server.connect(transport);
+  } catch (err) {
+    // Log errors to stderr only -- stdout is the MCP transport channel
+    process.stderr.write(`[sprinkle-mcp] Failed to start MCP server: ${err instanceof Error ? err.message : String(err)}\n`);
+    throw err;
+  }
+}
+//# sourceMappingURL=mcp-adapter.js.map

package/dist/cjs/Sprinkle/actions/mcp-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-adapter.js","names":["_module","require","_url","_path","_encryption","_typeGuards","_runner","_interopRequireWildcard","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","loadPackageVersion","createRequire","import","meta","url","__filename","fileURLToPath","__dirname","dirname","candidates","resolve","candidate","pkg","version","PACKAGE_VERSION","typeboxToJsonSchema","schema","isBigInt","type","pattern","description","isString","result","undefined","title","examples","minLength","maxLength","isSensitive","writeOnly","isNumber","minimum","maximum","isInteger","isBoolean","isNull","isArray","itemSchema","items","minItems","maxItems","isObject","properties","required","convertedProperties","propName","propSchema","entries","length","isUnion","anyOf","map","member","isLiteral","value","const","console","warn","coerceMcpInput","input","test","BigInt","Math","trunc","Array","item","getMcpSdk","Promise","then","Error","getMcpStdioTransport","createMcpServer","sprinkle","serverName","McpServer","server","name","actions","listActions","action","inputSchema","tool","coercedInput","context","settings","executeAction","success","content","text","JSON","stringify","data","bigIntReplacer","error","code","message","details","isError","runMcp","StdioServerTransport","transport","connect","err","process","stderr","write","String"],"sources":["../../../../src/Sprinkle/actions/mcp-adapter.ts"],"sourcesContent":["/**\n * MCP adapter for Sprinkles actions.\n *\n * Provides:\n * - TypeBox to JSON Schema conversion (typeboxToJsonSchema)\n * - BigInt string coercion for MCP input (coerceMcpInput)\n * - Lazy MCP SDK import with graceful error (getMcpSdk)\n * - MCP server creation from registered actions (createMcpServer)\n * - MCP orchestrator that starts a stdio server (runMcp)\n */\n\nimport { createRequire } from \"module\";\nimport { fileURLToPath } from \"url\";\nimport { dirname, resolve } from \"path\";\nimport type { TSchema } from \"@sinclair/typebox\";\nimport { bigIntReplacer } from \"../encryption.js\";\nimport {\n  isArray,\n  isBigInt,\n  isBoolean,\n  isInteger,\n  isLiteral,\n  isNull,\n  isNumber,\n  isObject,\n  isOptional,\n  isString,\n  isUnion,\n  isSensitive,\n} from \"../type-guards.js\";\nimport type { AnyAction } from \"./types.js\";\nimport { executeAction } from \"./runner.js\";\n\n// Re-import Sprinkle as a type only to avoid circular deps\nimport type { Sprinkle } from \"../index.js\";\n\n// Load package version for MCP server identification\n// Robustly find package.json - works from both src and dist directories\nfunction loadPackageVersion(): string {\n  const require = createRequire(import.meta.url);\n  const __filename = fileURLToPath(import.meta.url);\n  const __dirname = dirname(__filename);\n  \n  // Try multiple possible paths (handles src vs dist/esm vs dist/cjs)\n  const candidates = [\n    resolve(__dirname, \"../../../package.json\"),     // from src/Sprinkle/actions\n    resolve(__dirname, \"../../../../package.json\"),  // from dist/*/Sprinkle/actions\n  ];\n  \n  for (const candidate of candidates) {\n    try {\n      const pkg = require(candidate) as { version: string };\n      return pkg.version;\n    } catch {\n      // Try next candidate\n    }\n  }\n  \n  return \"0.0.0\"; // Fallback if package.json not found\n}\n\nconst PACKAGE_VERSION: string = loadPackageVersion();\n\n// ---------------------------------------------------------------------------\n// TypeBox to JSON Schema conversion\n// ---------------------------------------------------------------------------\n\n/**\n * Convert a TypeBox schema to a plain JSON Schema object.\n *\n * Strips TypeBox-internal symbols and properties (Kind, OptionalKind, $id)\n * and maps TypeBox-specific types to their JSON Schema equivalents:\n * - BigInt -> { type: \"string\", pattern: \"^-?[0-9]+$\" } (JSON has no BigInt)\n * - Sensitive string fields -> add writeOnly: true\n * - Optional -> recurse on inner schema (Optional does not change Kind)\n * - Union -> { anyOf: [...] }\n * - Literal -> { type, const }\n * - Null -> { type: \"null\" }\n * - Unknown/unsupported -> {} (accepts anything)\n */\nexport function typeboxToJsonSchema(schema: TSchema): Record<string, unknown> {\n  // Optional in TypeBox doesn't change the Kind, but marks the schema with\n  // OptionalKind. We can check for it and recurse transparently since all\n  // other guards still work correctly on optional-wrapped schemas.\n  //\n  // We intentionally do NOT strip optional here -- the containing Object\n  // converter decides whether to include a property in `required` based\n  // on the isOptional guard applied to the property schema.\n\n  if (isBigInt(schema)) {\n    return {\n      type: \"string\",\n      pattern: \"^-?[0-9]+$\",\n      description: \"BigInt value as string\",\n    };\n  }\n\n  if (isString(schema)) {\n    const result: Record<string, unknown> = { type: \"string\" };\n    if (schema.description !== undefined) result.description = schema.description;\n    if (schema.title !== undefined) result.title = schema.title;\n    if (schema.examples !== undefined) result.examples = schema.examples;\n    if (schema.pattern !== undefined) result.pattern = schema.pattern;\n    if (schema.minLength !== undefined) result.minLength = schema.minLength;\n    if (schema.maxLength !== undefined) result.maxLength = schema.maxLength;\n    if (schema.default !== undefined) result.default = schema.default;\n    // Sensitive fields are write-only (never returned in responses)\n    if (isSensitive(schema)) result.writeOnly = true;\n    return result;\n  }\n\n  if (isNumber(schema)) {\n    const result: Record<string, unknown> = { type: \"number\" };\n    if (schema.minimum !== undefined) result.minimum = schema.minimum;\n    if (schema.maximum !== undefined) result.maximum = schema.maximum;\n    if (schema.description !== undefined) result.description = schema.description;\n    if (schema.default !== undefined) result.default = schema.default;\n    return result;\n  }\n\n  if (isInteger(schema)) {\n    const result: Record<string, unknown> = { type: \"integer\" };\n    if (schema.minimum !== undefined) result.minimum = schema.minimum;\n    if (schema.maximum !== undefined) result.maximum = schema.maximum;\n    if (schema.description !== undefined) result.description = schema.description;\n    if (schema.default !== undefined) result.default = schema.default;\n    return result;\n  }\n\n  if (isBoolean(schema)) {\n    const result: Record<string, unknown> = { type: \"boolean\" };\n    if (schema.description !== undefined) result.description = schema.description;\n    if (schema.default !== undefined) result.default = schema.default;\n    return result;\n  }\n\n  if (isNull(schema)) {\n    return { type: \"null\" };\n  }\n\n  if (isArray(schema)) {\n    const result: Record<string, unknown> = { type: \"array\" };\n    const itemSchema = (schema as { items?: TSchema }).items;\n    if (itemSchema) {\n      result.items = typeboxToJsonSchema(itemSchema);\n    }\n    if (schema.minItems !== undefined) result.minItems = schema.minItems;\n    if (schema.maxItems !== undefined) result.maxItems = schema.maxItems;\n    if (schema.description !== undefined) result.description = schema.description;\n    return result;\n  }\n\n  if (isObject(schema)) {\n    const properties = schema.properties as Record<string, TSchema>;\n    const required: string[] = schema.required as string[] ?? [];\n    const convertedProperties: Record<string, unknown> = {};\n\n    for (const [propName, propSchema] of Object.entries(properties)) {\n      convertedProperties[propName] = typeboxToJsonSchema(propSchema);\n    }\n\n    const result: Record<string, unknown> = {\n      type: \"object\",\n      properties: convertedProperties,\n    };\n\n    if (required.length > 0) {\n      result.required = required;\n    }\n\n    if (schema.description !== undefined) result.description = schema.description;\n\n    return result;\n  }\n\n  if (isUnion(schema)) {\n    return {\n      anyOf: schema.anyOf.map((member: TSchema) => typeboxToJsonSchema(member)),\n    };\n  }\n\n  if (isLiteral(schema)) {\n    const value = schema.const;\n    let type: string;\n    if (typeof value === \"string\") {\n      type = \"string\";\n    } else if (typeof value === \"number\") {\n      type = \"number\";\n    } else if (typeof value === \"boolean\") {\n      type = \"boolean\";\n    } else {\n      // Fallback for unexpected literal types\n      return {};\n    }\n    return { type, const: value };\n  }\n\n  // Unknown / unsupported TypeBox type: emit empty schema (accepts anything)\n  // This is a safe fallback that allows the MCP tool to still receive input.\n  console.warn(\n    `[mcp-adapter] Unsupported TypeBox kind: ${(schema as Record<string, unknown>)[\"[Kind]\"] ?? \"(unknown)\"}. Emitting empty schema.`,\n  );\n  return {};\n}\n\n// ---------------------------------------------------------------------------\n// Input coercion: BigInt string -> BigInt\n// ---------------------------------------------------------------------------\n\n/**\n * Coerce MCP JSON input values to the types expected by a TypeBox schema.\n *\n * MCP transmits all values as JSON, which has no BigInt type. When the schema\n * expects a BigInt, the value arrives as a numeric string (e.g. \"12345678\").\n * This function recursively walks the schema and input, converting BigInt\n * string values to actual BigInt where needed.\n *\n * For all other types the value is passed through unchanged.\n */\nexport function coerceMcpInput(input: unknown, schema: TSchema): unknown {\n  if (input === null || input === undefined) return input;\n\n  if (isBigInt(schema)) {\n    if (typeof input === \"bigint\") return input;\n    if (typeof input === \"string\" && /^-?[0-9]+$/.test(input)) {\n      try {\n        return BigInt(input);\n      } catch {\n        return input;\n      }\n    }\n    if (typeof input === \"number\") {\n      try {\n        return BigInt(Math.trunc(input));\n      } catch {\n        return input;\n      }\n    }\n    return input;\n  }\n\n  if (isArray(schema)) {\n    const itemSchema = (schema as { items?: TSchema }).items;\n    if (Array.isArray(input) && itemSchema) {\n      return input.map((item) => coerceMcpInput(item, itemSchema));\n    }\n    return input;\n  }\n\n  if (isObject(schema)) {\n    if (typeof input !== \"object\" || Array.isArray(input)) return input;\n    const properties = schema.properties as Record<string, TSchema>;\n    const result: Record<string, unknown> = { ...(input as Record<string, unknown>) };\n    for (const [propName, propSchema] of Object.entries(properties)) {\n      if (propName in result) {\n        result[propName] = coerceMcpInput(result[propName], propSchema);\n      }\n    }\n    return result;\n  }\n\n  if (isUnion(schema)) {\n    // For unions, we try each member schema in order and return the first\n    // successful coercion. BigInt members take priority over string members\n    // since they have a narrower, unambiguous pattern.\n    for (const member of schema.anyOf) {\n      if (isBigInt(member)) {\n        if (typeof input === \"string\" && /^-?[0-9]+$/.test(input)) {\n          return coerceMcpInput(input, member);\n        }\n      }\n    }\n    // No BigInt match; return as-is for other union members\n    return input;\n  }\n\n  // For all other types (String, Number, Integer, Boolean, Literal, Null):\n  // pass through unchanged -- MCP JSON already represents them correctly\n  return input;\n}\n\n// ---------------------------------------------------------------------------\n// Lazy MCP SDK import\n// ---------------------------------------------------------------------------\n\n/**\n * MCP SDK module shape (the parts we use from @modelcontextprotocol/sdk).\n * Typed loosely to avoid a hard dependency at compile time.\n */\ninterface IMcpSdkModule {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  McpServer: new (opts: { name: string; version: string }) => any;\n}\n\ninterface IStdioTransportModule {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  StdioServerTransport: new () => any;\n}\n\n/**\n * Lazily import the MCP SDK server module.\n *\n * Throws a clear, actionable error if the SDK is not installed, rather than\n * a cryptic \"Cannot find module\" Node error.\n */\nexport async function getMcpSdk(): Promise<IMcpSdkModule> {\n  try {\n    return (await import(\n      \"@modelcontextprotocol/sdk/server/mcp.js\"\n    )) as IMcpSdkModule;\n  } catch {\n    throw new Error(\n      \"MCP mode requires @modelcontextprotocol/sdk. Install it with: npm install @modelcontextprotocol/sdk\",\n    );\n  }\n}\n\n/**\n * Lazily import the MCP SDK stdio transport module.\n */\nasync function getMcpStdioTransport(): Promise<IStdioTransportModule> {\n  try {\n    return (await import(\n      \"@modelcontextprotocol/sdk/server/stdio.js\"\n    )) as IStdioTransportModule;\n  } catch {\n    throw new Error(\n      \"MCP mode requires @modelcontextprotocol/sdk. Install it with: npm install @modelcontextprotocol/sdk\",\n    );\n  }\n}\n\n// ---------------------------------------------------------------------------\n// MCP server creation\n// ---------------------------------------------------------------------------\n\n/**\n * Create an MCP server and register all actions from a Sprinkle instance as\n * MCP tools.\n *\n * Each action becomes a tool with:\n * - name: action.name\n * - description: action.description\n * - input schema: typeboxToJsonSchema(action.inputSchema)\n * - handler: coerces input, executes action, returns JSON result\n *\n * The Sprinkle instance must already be initialized with a profile before\n * this function is called.\n *\n * @param sprinkle   - Fully-initialized Sprinkle instance\n * @param serverName - Name to use for the MCP server\n * @returns          The configured McpServer instance (not yet connected)\n */\nexport async function createMcpServer<S extends TSchema>(\n  sprinkle: Sprinkle<S>,\n  serverName: string,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): Promise<any> {\n  const { McpServer } = await getMcpSdk();\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const server = new McpServer({ name: serverName, version: PACKAGE_VERSION });\n\n  const actions = sprinkle.listActions() as AnyAction<S>[];\n\n  for (const action of actions) {\n    const inputSchema = typeboxToJsonSchema(action.inputSchema);\n\n    // Register the action as an MCP tool.\n    // The high-level McpServer.tool() API accepts:\n    //   tool(name, description, schema, handler)\n    server.tool(\n      action.name,\n      action.description,\n      inputSchema,\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      async (input: unknown): Promise<any> => {\n        const coercedInput = coerceMcpInput(input, action.inputSchema);\n\n        const context = {\n          sprinkle,\n          settings: sprinkle.settings,\n        };\n\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        const result = await executeAction(action as any, coercedInput, context as any);\n\n        if (result.success) {\n          return {\n            content: [\n              {\n                type: \"text\",\n                text: JSON.stringify(result.data, bigIntReplacer),\n              },\n            ],\n          };\n        } else {\n          return {\n            content: [\n              {\n                type: \"text\",\n                text: JSON.stringify(\n                  {\n                    error: {\n                      code: result.error.code,\n                      message: result.error.message,\n                      details: result.error.details,\n                    },\n                  },\n                  bigIntReplacer,\n                ),\n              },\n            ],\n            isError: true,\n          };\n        }\n      },\n    );\n  }\n\n  return server;\n}\n\n// ---------------------------------------------------------------------------\n// MCP orchestrator\n// ---------------------------------------------------------------------------\n\n/**\n * Start an MCP server on stdio transport.\n *\n * This function:\n * 1. Creates the MCP server and registers all actions as tools\n * 2. Creates a StdioServerTransport\n * 3. Connects the server to the transport\n *\n * IMPORTANT: All logging in this function goes to stderr. stdout is reserved\n * for the MCP protocol messages.\n *\n * The Sprinkle instance must already be initialized with a profile. Profile\n * initialization is the responsibility of the caller (Sprinkle.Run()).\n *\n * @param sprinkle   - Fully-initialized Sprinkle instance\n * @param serverName - Name to use for the MCP server\n */\nexport async function runMcp<S extends TSchema>(\n  sprinkle: Sprinkle<S>,\n  serverName: string,\n): Promise<void> {\n  const { StdioServerTransport } = await getMcpStdioTransport();\n\n  const server = await createMcpServer(sprinkle, serverName);\n  const transport = new StdioServerTransport();\n\n  try {\n    await server.connect(transport);\n  } catch (err) {\n    // Log errors to stderr only -- stdout is the MCP transport channel\n    process.stderr.write(\n      `[sprinkle-mcp] Failed to start MCP server: ${err instanceof Error ? err.message : String(err)}\\n`,\n    );\n    throw err;\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/cjs/Sprinkle/actions/registry.js

@@ -0,0 +1,92 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ActionRegistry = void 0;
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+/**
+ * Action registry for storing and retrieving registered actions.
+ */
+
+/** Regex for valid kebab-case action names */
+const KEBAB_CASE_REGEX = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
+
+/**
+ * Registry for managing actions registered on a Sprinkle app.
+ * Enforces name uniqueness and schema validation at registration time.
+ */
+class ActionRegistry {
+  constructor() {
+    _defineProperty(this, "actions", new Map());
+  }
+  /**
+   * Register an action with the registry.
+   *
+   * Validates:
+   * - Name is kebab-case (lowercase letters, digits, hyphens)
+   * - Name is unique within this registry
+   * - inputSchema and outputSchema are present
+   *
+   * @throws Error if validation fails
+   */
+  register(action) {
+    if (!KEBAB_CASE_REGEX.test(action.name)) {
+      throw new Error(`Invalid action name "${action.name}": must be kebab-case (e.g. "my-action", "get-balance")`);
+    }
+    if (this.actions.has(action.name)) {
+      throw new Error(`Action "${action.name}" is already registered. Action names must be unique.`);
+    }
+    if (!action.inputSchema) {
+      throw new Error(`Action "${action.name}" is missing inputSchema. All actions must define an inputSchema.`);
+    }
+    if (!action.outputSchema) {
+      throw new Error(`Action "${action.name}" is missing outputSchema. All actions must define an outputSchema.`);
+    }
+    this.actions.set(action.name, action);
+  }
+
+  /**
+   * Retrieve an action by name.
+   * @returns The action, or undefined if not registered
+   */
+  get(name) {
+    return this.actions.get(name);
+  }
+
+  /**
+   * Check if an action with the given name is registered.
+   */
+  has(name) {
+    return this.actions.has(name);
+  }
+
+  /**
+   * List all registered actions.
+   */
+  list() {
+    return Array.from(this.actions.values());
+  }
+
+  /**
+   * Group all registered actions by their category.
+   * Actions without a category are placed under "default".
+   */
+  listByCategory() {
+    const result = new Map();
+    for (const action of this.actions.values()) {
+      const category = action.category ?? "default";
+      const bucket = result.get(category);
+      if (bucket) {
+        bucket.push(action);
+      } else {
+        result.set(category, [action]);
+      }
+    }
+    return result;
+  }
+}
+exports.ActionRegistry = ActionRegistry;
+//# sourceMappingURL=registry.js.map

package/dist/cjs/Sprinkle/actions/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","names":["KEBAB_CASE_REGEX","ActionRegistry","constructor","_defineProperty","Map","register","action","test","name","Error","actions","has","inputSchema","outputSchema","set","get","list","Array","from","values","listByCategory","result","category","bucket","push","exports"],"sources":["../../../../src/Sprinkle/actions/registry.ts"],"sourcesContent":["/**\n * Action registry for storing and retrieving registered actions.\n */\n\nimport type { TSchema } from \"@sinclair/typebox\";\nimport type { AnyAction } from \"./types.js\";\n\n/** Regex for valid kebab-case action names */\nconst KEBAB_CASE_REGEX = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;\n\n/**\n * Registry for managing actions registered on a Sprinkle app.\n * Enforces name uniqueness and schema validation at registration time.\n */\nexport class ActionRegistry<S extends TSchema> {\n  private actions: Map<string, AnyAction<S>> = new Map();\n\n  /**\n   * Register an action with the registry.\n   *\n   * Validates:\n   * - Name is kebab-case (lowercase letters, digits, hyphens)\n   * - Name is unique within this registry\n   * - inputSchema and outputSchema are present\n   *\n   * @throws Error if validation fails\n   */\n  register(action: AnyAction<S>): void {\n    if (!KEBAB_CASE_REGEX.test(action.name)) {\n      throw new Error(\n        `Invalid action name \"${action.name}\": must be kebab-case (e.g. \"my-action\", \"get-balance\")`,\n      );\n    }\n\n    if (this.actions.has(action.name)) {\n      throw new Error(\n        `Action \"${action.name}\" is already registered. Action names must be unique.`,\n      );\n    }\n\n    if (!action.inputSchema) {\n      throw new Error(\n        `Action \"${action.name}\" is missing inputSchema. All actions must define an inputSchema.`,\n      );\n    }\n\n    if (!action.outputSchema) {\n      throw new Error(\n        `Action \"${action.name}\" is missing outputSchema. All actions must define an outputSchema.`,\n      );\n    }\n\n    this.actions.set(action.name, action);\n  }\n\n  /**\n   * Retrieve an action by name.\n   * @returns The action, or undefined if not registered\n   */\n  get(name: string): AnyAction<S> | undefined {\n    return this.actions.get(name);\n  }\n\n  /**\n   * Check if an action with the given name is registered.\n   */\n  has(name: string): boolean {\n    return this.actions.has(name);\n  }\n\n  /**\n   * List all registered actions.\n   */\n  list(): AnyAction<S>[] {\n    return Array.from(this.actions.values());\n  }\n\n  /**\n   * Group all registered actions by their category.\n   * Actions without a category are placed under \"default\".\n   */\n  listByCategory(): Map<string, AnyAction<S>[]> {\n    const result = new Map<string, AnyAction<S>[]>();\n\n    for (const action of this.actions.values()) {\n      const category = action.category ?? \"default\";\n      const bucket = result.get(category);\n      if (bucket) {\n        bucket.push(action);\n      } else {\n        result.set(category, [action]);\n      }\n    }\n\n    return result;\n  }\n}\n"],"mappings":";;;;;;;;;AAAA;AACA;AACA;;AAKA;AACA,MAAMA,gBAAgB,GAAG,+BAA+B;;AAExD;AACA;AACA;AACA;AACO,MAAMC,cAAc,CAAoB;EAAAC,YAAA;IAAAC,eAAA,kBACA,IAAIC,GAAG,CAAC,CAAC;EAAA;EAEtD;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEC,QAAQA,CAACC,MAAoB,EAAQ;IACnC,IAAI,CAACN,gBAAgB,CAACO,IAAI,CAACD,MAAM,CAACE,IAAI,CAAC,EAAE;MACvC,MAAM,IAAIC,KAAK,CACb,wBAAwBH,MAAM,CAACE,IAAI,yDACrC,CAAC;IACH;IAEA,IAAI,IAAI,CAACE,OAAO,CAACC,GAAG,CAACL,MAAM,CAACE,IAAI,CAAC,EAAE;MACjC,MAAM,IAAIC,KAAK,CACb,WAAWH,MAAM,CAACE,IAAI,uDACxB,CAAC;IACH;IAEA,IAAI,CAACF,MAAM,CAACM,WAAW,EAAE;MACvB,MAAM,IAAIH,KAAK,CACb,WAAWH,MAAM,CAACE,IAAI,mEACxB,CAAC;IACH;IAEA,IAAI,CAACF,MAAM,CAACO,YAAY,EAAE;MACxB,MAAM,IAAIJ,KAAK,CACb,WAAWH,MAAM,CAACE,IAAI,qEACxB,CAAC;IACH;IAEA,IAAI,CAACE,OAAO,CAACI,GAAG,CAACR,MAAM,CAACE,IAAI,EAAEF,MAAM,CAAC;EACvC;;EAEA;AACF;AACA;AACA;EACES,GAAGA,CAACP,IAAY,EAA4B;IAC1C,OAAO,IAAI,CAACE,OAAO,CAACK,GAAG,CAACP,IAAI,CAAC;EAC/B;;EAEA;AACF;AACA;EACEG,GAAGA,CAACH,IAAY,EAAW;IACzB,OAAO,IAAI,CAACE,OAAO,CAACC,GAAG,CAACH,IAAI,CAAC;EAC/B;;EAEA;AACF;AACA;EACEQ,IAAIA,CAAA,EAAmB;IACrB,OAAOC,KAAK,CAACC,IAAI,CAAC,IAAI,CAACR,OAAO,CAACS,MAAM,CAAC,CAAC,CAAC;EAC1C;;EAEA;AACF;AACA;AACA;EACEC,cAAcA,CAAA,EAAgC;IAC5C,MAAMC,MAAM,GAAG,IAAIjB,GAAG,CAAyB,CAAC;IAEhD,KAAK,MAAME,MAAM,IAAI,IAAI,CAACI,OAAO,CAACS,MAAM,CAAC,CAAC,EAAE;MAC1C,MAAMG,QAAQ,GAAGhB,MAAM,CAACgB,QAAQ,IAAI,SAAS;MAC7C,MAAMC,MAAM,GAAGF,MAAM,CAACN,GAAG,CAACO,QAAQ,CAAC;MACnC,IAAIC,MAAM,EAAE;QACVA,MAAM,CAACC,IAAI,CAAClB,MAAM,CAAC;MACrB,CAAC,MAAM;QACLe,MAAM,CAACP,GAAG,CAACQ,QAAQ,EAAE,CAAChB,MAAM,CAAC,CAAC;MAChC;IACF;IAEA,OAAOe,MAAM;EACf;AACF;AAACI,OAAA,CAAAxB,cAAA,GAAAA,cAAA","ignoreList":[]}