@decocms/bindings 1.2.1 → 1.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decocms/bindings",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "type": "module",
   "scripts": {
     "check": "tsc --noEmit",

package/src/core/plugins.ts

@@ -58,13 +58,17 @@ export interface PluginRenderHeaderProps {
  * Client plugins are separate from server plugins to avoid bundling
  * server code into the client bundle.
  */
-export interface ClientPlugin<TBinding extends Binder> {
+export interface ClientPlugin<TBinding extends Binder = Binder> {
   id: string;
   /**
    * Short description of the plugin shown in the settings UI.
    */
   description?: string;
-  binding: TBinding;
+  /**
+   * Binding schema used to filter compatible connections.
+   * Omit for plugins that manage their own connection (e.g. self MCP).
+   */
+  binding?: TBinding;
   setup?: PluginSetup;
   /**
    * Optional custom layout component for this plugin.

package/src/core/server-plugin.ts

@@ -16,15 +16,45 @@ import type { Hono } from "hono";
 import type { Kysely } from "kysely";
 
 /**
- * Tool definition compatible with MCP tools.
- * This is a simplified type - the actual implementation uses the full ToolDefinition from mesh.
+ * Subset of MeshContext exposed to server plugin tool handlers.
+ *
+ * Plugins receive the full MeshContext at runtime but should only depend on
+ * these properties. This keeps the plugin contract stable and avoids coupling
+ * plugins to Mesh internals (db, vault, tracer, etc.).
+ */
+export interface ServerPluginToolContext {
+  organization: { id: string } | null;
+  access: { check: () => Promise<void> };
+  auth: {
+    user?: { id: string; email?: string; name?: string };
+  };
+  /** Kysely database instance for direct queries. */
+  db: Kysely<unknown>;
+  createMCPProxy: (connectionId: string) => Promise<{
+    callTool: (args: {
+      name: string;
+      arguments?: Record<string, unknown>;
+    }) => Promise<{
+      isError?: boolean;
+      content?: Array<{ type?: string; text?: string }>;
+      structuredContent?: unknown;
+    }>;
+    listTools: () => Promise<{
+      tools: Array<{ name: string; description?: string }>;
+    }>;
+    close?: () => Promise<void>;
+  }>;
+}
+
+/**
+ * Tool definition for server plugins.
  */
 export interface ServerPluginToolDefinition {
   name: string;
   description?: string;
   inputSchema: unknown;
   outputSchema?: unknown;
-  handler: (input: unknown, ctx: unknown) => Promise<unknown>;
+  handler: (input: unknown, ctx: ServerPluginToolContext) => Promise<unknown>;
 }
 
 /**