icode-mcp-adapter 1.0.11 → 1.0.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "icode-mcp-adapter",
-  "version": "1.0.11",
+  "version": "1.0.13",
   "description": "Dynamic MCP server adapter — auto-generates CRUD tools from schema configs. Plugs into icode-server via Fastify or runs standalone.",
   "type": "module",
   "main": "src/engine/McpEngine.js",

package/src/engine/SchemaAdapter.js

@@ -45,6 +45,13 @@ const META_FIELDS = new Set([
   '_by',           // who last modified
   '_deleted',      // soft delete flag
   'pk',            // auto-increment secondary key
+  '_tenantId',     // tenant marker (stamped by the host writer)
+  '_tzo',          // timezone offset
+  '_vno',          // version number
+  '_tag',          // internal tagging
+  'org',           // org partition
+  'settings',      // per-row system settings json
+  'entitytype',    // entity type marker (system-set)
 ]);
 
 // ── Schema cache ─────────────────────────────────────────────────────────────
@@ -147,6 +154,7 @@ export async function resolveSchemas(db, tableConfigs, opts = {}) {
       ownerColumn,
       columns,
       ...(config.customDescriptions && { customDescriptions: config.customDescriptions }),
+      ...(config.customTools && { customTools: config.customTools }),
     });
   }
 

package/src/engine/ToolBuilder.js

@@ -97,6 +97,10 @@ export function registerTableTools(server, db, table, identity, newGuid, writer)
       case 'delete': regDelete(server, db, table, display, owner, writer); break;
     }
   }
+
+  for (const [name, tool] of Object.entries(table.customTools || {})) {
+    regCustom(server, db, table, name, tool, owner, writer);
+  }
 }
 
 // ── LIST ──────────────────────────────────────────────────────────────────────
@@ -391,3 +395,40 @@ function regDelete(server, db, table, display, owner, writer) {
     }
   });
 }
+
+// ── CUSTOM TOOLS ──────────────────────────────────────────────────────────────
+
+/**
+ * Register a hand-written tool from config: { title, description, inputs, handler }.
+ * `inputs` are ColumnDef-shaped descriptors ({ type, description, required, ... }).
+ * handler(args, ctx) gets { db, table, owner, writer, pkWhere, q } and may return
+ * a row object (JSON + structuredContent), a string (plain text), or a full MCP result.
+ */
+function regCustom(server, db, table, name, tool, owner, writer) {
+  const inputSchema = {};
+  for (const [arg, def] of Object.entries(tool.inputs || {})) {
+    inputSchema[arg] = zodFor({ name: arg, ...def });
+  }
+
+  server.registerTool(name, {
+    title: tool.title || name,
+    description: tool.description || '',
+    inputSchema,
+  }, async (args) => {
+    try {
+      const result = await tool.handler(args, {
+        db, table, owner, writer,
+        pkWhere: (pkVal) => pkWhere(table, pkVal, owner),
+        q,
+      });
+      if (typeof result === 'string') return { content: [{ type: 'text', text: result }] };
+      if (result?.content) return result;
+      return {
+        content: [{ type: 'text', text: JSON.stringify(result) }],
+        structuredContent: result,
+      };
+    } catch (error) {
+      return { content: [{ type: 'text', text: `Error: ${error.message}` }], isError: true };
+    }
+  });
+}

package/src/engine/types.js

@@ -25,6 +25,14 @@
  * @property {string} [listOrderBy]  - Default ORDER BY clause (use backticks for reserved words)
  * @property {string|null} [ownerColumn] - Row-level owner column; every query is scoped to the caller on it
  * @property {Object} [customDescriptions] - Override tool descriptions per operation
+ * @property {Record<string, CustomTool>} [customTools] - Extra hand-written tools registered alongside the generated CRUD
+ *
+ * @typedef {Object} CustomTool
+ * @property {string} [title]
+ * @property {string} [description]
+ * @property {Record<string, ColumnDef>} [inputs] - Tool arguments as ColumnDef-shaped descriptors
+ * @property {(args: Object, ctx: { db, table, owner, writer, pkWhere: Function, q: Function }) => Promise<any>} handler
+ *           - May return a row object (JSON + structuredContent), a string (plain text), or a full MCP result
  *
  * @typedef {Object} DbConfig
  * @property {string} host