@decocms/bindings 0.2.4-beta.2 → 0.2.4-beta.4

package/dist/index.d.ts

@@ -1,94 +1,3 @@
-import { ZodType } from 'zod';
-
-/**
- * Core Binder Types and Utilities
- *
- * This module provides the core types and utilities for the bindings system.
- * Bindings define standardized interfaces that integrations (MCPs) can implement.
- */
-
-/**
- * ToolBinder defines a single tool within a binding.
- * It specifies the tool name, input/output schemas, and whether it's optional.
- *
- * @template TName - The tool name (can be a string or RegExp for pattern matching)
- * @template TInput - The input type (inferred from inputSchema)
- * @template TReturn - The return type (inferred from outputSchema)
- */
-interface ToolBinder<TName extends string | RegExp = string, TInput = any, TReturn extends object | null | boolean = object, TStreamable extends boolean = boolean> {
-    /** The name of the tool (e.g., "DECO_CHAT_CHANNELS_JOIN") */
-    name: TName;
-    /** Zod schema for validating tool input */
-    inputSchema: ZodType<TInput>;
-    /** Optional Zod schema for validating tool output */
-    outputSchema?: TStreamable extends true ? never : ZodType<TReturn>;
-    /**
-     * Whether this tool is streamable.
-     */
-    streamable?: TStreamable;
-    /**
-     * Whether this tool is optional in the binding.
-     * If true, an implementation doesn't need to provide this tool.
-     */
-    opt?: true;
-}
-/**
- * Binder represents a collection of tool definitions that form a binding.
- * A binding is like a TypeScript interface - it defines what tools must be implemented.
- *
- * @template TDefinition - Array of ToolBinder definitions
- *
- * @example
- * ```ts
- * const MY_BINDING = [{
- *   name: "MY_TOOL" as const,
- *   inputSchema: z.object({ id: z.string() }),
- *   outputSchema: z.object({ success: z.boolean() }),
- * }] as const satisfies Binder;
- * ```
- */
-type Binder<TDefinition extends readonly ToolBinder[] = readonly ToolBinder[]> = TDefinition;
-/**
- * Tool with schemas for validation
- */
-interface ToolWithSchemas {
-    name: string;
-    inputSchema?: ZodType<any> | Record<string, unknown>;
-    outputSchema?: ZodType<any> | Record<string, unknown>;
-}
-/**
- * Binding checker interface
- */
-interface BindingChecker {
-    /**
-     * Check if a set of tools implements the binding with full schema validation.
-     *
-     * Validates:
-     * - Tool name matches (exact or regex)
-     * - Input schema: Tool accepts what binder requires (no removals from binder to tool)
-     * - Output schema: Tool provides what binder expects (no removals from tool to binder)
-     *
-     * @param tools - Array of tools with names and schemas
-     * @returns Promise<boolean> - true if all tools implement the binding correctly
-     */
-    isImplementedBy: (tools: ToolWithSchemas[]) => Promise<boolean>;
-}
-/**
- * Creates a binding checker with full schema validation using json-schema-diff.
- *
- * This performs strict compatibility checking:
- * - For input schemas: Validates that the tool can accept what the binder requires
- * - For output schemas: Validates that the tool provides what the binder expects
- *
- * @param binderTools - The binding definition to check against
- * @returns A binding checker with an async isImplementedBy method
- *
- * @example
- * ```ts
- * const checker = createBindingChecker(MY_BINDING);
- * const isCompatible = await checker.isImplementedBy(availableTools);
- * ```
- */
-declare function createBindingChecker<TDefinition extends readonly ToolBinder[]>(binderTools: TDefinition): BindingChecker;
-
-export { type Binder, type BindingChecker, type ToolBinder, type ToolWithSchemas, createBindingChecker };
+export { B as Binder, f as BindingChecker, a as ToolBinder, T as ToolWithSchemas, j as createBindingChecker } from './index-D0aUdNls.js';
+import 'zod/v3';
+import './core/connection.js';

package/dist/index.js

@@ -1,342 +1,7 @@
-import { diffSchemas } from 'json-schema-diff';
-import { zodToJsonSchema } from 'zod-to-json-schema';
-import { convertJsonSchemaToZod } from 'zod-from-json-schema';
-import { Client as Client$1 } from '@modelcontextprotocol/sdk/client/index.js';
-import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';
-import { WebSocketClientTransport } from '@modelcontextprotocol/sdk/client/websocket.js';
-import { ListToolsResultSchema } from '@modelcontextprotocol/sdk/types.js';
-import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
-
-// src/core/binder.ts
-var HTTPClientTransport = class extends StreamableHTTPClientTransport {
-  constructor(url, opts) {
-    super(url, opts);
-  }
-  send(message, options) {
-    const mockAction = getMockActionFor(message);
-    if (mockAction?.type === "emit") {
-      this.onmessage?.(mockAction.message);
-      return Promise.resolve();
-    }
-    if (mockAction?.type === "suppress") {
-      return Promise.resolve();
-    }
-    return super.send(message, options);
-  }
+import {
+  createBindingChecker
+} from "./core/binder";
+export {
+  createBindingChecker
 };
-function getMockActionFor(message) {
-  const m = message;
-  if (!m || typeof m !== "object" || !("method" in m)) return null;
-  switch (m.method) {
-    case "initialize": {
-      const protocolVersion = m?.params?.protocolVersion;
-      if (!protocolVersion) return null;
-      return {
-        type: "emit",
-        message: {
-          result: {
-            protocolVersion,
-            capabilities: { tools: {} },
-            serverInfo: { name: "deco-chat-server", version: "1.0.0" }
-          },
-          jsonrpc: m.jsonrpc ?? "2.0",
-          // @ts-expect-error - id is not typed
-          id: m.id
-        }
-      };
-    }
-    case "notifications/roots/list_changed":
-    case "notifications/initialized":
-    case "notifications/cancelled":
-    case "notifications/progress": {
-      return { type: "suppress" };
-    }
-    default:
-      return null;
-  }
-}
-
-// src/core/client/mcp-client.ts
-var Client = class extends Client$1 {
-  constructor(_clientInfo, options) {
-    super(_clientInfo, options);
-  }
-  async listTools(params, options) {
-    const result = await this.request(
-      { method: "tools/list", params },
-      ListToolsResultSchema,
-      options
-    );
-    return result;
-  }
-};
-var createServerClient = async (mcpServer, signal, extraHeaders) => {
-  const transport = createTransport(mcpServer.connection, signal, extraHeaders);
-  if (!transport) {
-    throw new Error("Unknown MCP connection type");
-  }
-  const client = new Client({
-    name: mcpServer?.name ?? "MCP Client",
-    version: "1.0.0"
-  });
-  await client.connect(transport);
-  return {
-    client,
-    callStreamableTool: (tool, args) => {
-      if (mcpServer.connection.type !== "HTTP") {
-        throw new Error("HTTP connection required");
-      }
-      return fetch(mcpServer.connection.url + `/call-tool/${tool}`, {
-        method: "POST",
-        redirect: "manual",
-        body: JSON.stringify(args),
-        headers: {
-          ...extraHeaders,
-          Authorization: `Bearer ${mcpServer.connection.token}`
-        }
-      });
-    }
-  };
-};
-var createTransport = (connection, signal, extraHeaders) => {
-  if (connection.type === "Websocket") {
-    return new WebSocketClientTransport(new URL(connection.url));
-  }
-  if (connection.type !== "SSE" && connection.type !== "HTTP") {
-    return null;
-  }
-  const authHeaders = connection.token ? { authorization: `Bearer ${connection.token}` } : {};
-  const headers = {
-    ...authHeaders,
-    ...extraHeaders ?? {},
-    ..."headers" in connection ? connection.headers || {} : {}
-  };
-  if (connection.type === "SSE") {
-    const config = {
-      requestInit: { headers, signal }
-    };
-    if (connection.token) {
-      config.eventSourceInit = {
-        fetch: (req, init) => {
-          return fetch(req, {
-            ...init,
-            headers: {
-              ...headers,
-              Accept: "text/event-stream"
-            },
-            signal
-          });
-        }
-      };
-    }
-    return new SSEClientTransport(new URL(connection.url), config);
-  }
-  return new HTTPClientTransport(new URL(connection.url), {
-    requestInit: {
-      headers,
-      signal,
-      // @ts-ignore - this is a valid option for fetch
-      credentials: "include"
-    }
-  });
-};
-
-// src/core/client/proxy.ts
-var safeParse = (content) => {
-  try {
-    return JSON.parse(content);
-  } catch {
-    return content;
-  }
-};
-var toolsMap = /* @__PURE__ */ new Map();
-function createMCPClientProxy(options) {
-  return new Proxy({}, {
-    get(_, name) {
-      if (name === "toJSON") {
-        return null;
-      }
-      if (typeof name !== "string") {
-        throw new Error("Name must be a string");
-      }
-      async function callToolFn(args) {
-        const debugId = options?.debugId?.();
-        const extraHeaders = debugId ? { "x-trace-debug-id": debugId } : void 0;
-        const { client, callStreamableTool } = await createServerClient(
-          { connection: options.connection },
-          void 0,
-          extraHeaders
-        );
-        if (options?.streamable?.[String(name)]) {
-          return callStreamableTool(String(name), args);
-        }
-        const { structuredContent, isError, content } = await client.callTool(
-          {
-            name: String(name),
-            arguments: args
-          },
-          void 0,
-          {
-            timeout: 3e6
-          }
-        );
-        if (isError) {
-          const maybeErrorMessage = content?.[0]?.text;
-          const error = typeof maybeErrorMessage === "string" ? safeParse(maybeErrorMessage) : null;
-          const throwableError = error?.code && typeof options?.getErrorByStatusCode === "function" ? options.getErrorByStatusCode(
-            error.code,
-            error.message,
-            error.traceId
-          ) : null;
-          if (throwableError) {
-            throw throwableError;
-          }
-          throw new Error(
-            `Tool ${String(name)} returned an error: ${JSON.stringify(
-              structuredContent ?? content
-            )}`
-          );
-        }
-        return structuredContent;
-      }
-      const listToolsFn = async () => {
-        const { client } = await createServerClient({
-          connection: options.connection
-        });
-        const { tools } = await client.listTools();
-        return tools;
-      };
-      async function listToolsOnce() {
-        const conn = options.connection;
-        const key = JSON.stringify(conn);
-        try {
-          if (!toolsMap.has(key)) {
-            toolsMap.set(key, listToolsFn());
-          }
-          return await toolsMap.get(key);
-        } catch (error) {
-          console.error("Failed to list tools", error);
-          toolsMap.delete(key);
-          return;
-        }
-      }
-      callToolFn.asTool = async () => {
-        const tools = await listToolsOnce() ?? [];
-        const tool = tools.find((t) => t.name === name);
-        if (!tool) {
-          throw new Error(`Tool ${name} not found`);
-        }
-        return {
-          ...tool,
-          id: tool.name,
-          inputSchema: tool.inputSchema ? convertJsonSchemaToZod(tool.inputSchema) : void 0,
-          outputSchema: tool.outputSchema ? convertJsonSchemaToZod(tool.outputSchema) : void 0,
-          execute: (input) => {
-            return callToolFn(input.context);
-          }
-        };
-      };
-      return callToolFn;
-    }
-  });
-}
-
-// src/core/client/mcp.ts
-new Proxy(
-  {},
-  {
-    get(_, name) {
-      if (name === "toJSON") {
-        return null;
-      }
-      if (name === "forConnection") {
-        return (connection) => createMCPFetchStub({
-          connection
-        });
-      }
-      return global[name];
-    }
-  }
-);
-function createMCPFetchStub(options) {
-  return createMCPClientProxy(options);
-}
-
-// src/core/binder.ts
-function normalizeSchema(schema) {
-  if (!schema) return void 0;
-  if (schema._def) {
-    const jsonSchema2 = zodToJsonSchema(schema, {
-      // Don't add additionalProperties: false to allow structural compatibility
-      $refStrategy: "none"
-    });
-    if (jsonSchema2.type === "object") {
-      delete jsonSchema2.additionalProperties;
-    }
-    return jsonSchema2;
-  }
-  const jsonSchema = schema;
-  if (jsonSchema.type === "object" && "additionalProperties" in jsonSchema) {
-    const copy = { ...jsonSchema };
-    delete copy.additionalProperties;
-    return copy;
-  }
-  return jsonSchema;
-}
-function createBindingChecker(binderTools) {
-  return {
-    isImplementedBy: async (tools) => {
-      for (const binderTool of binderTools) {
-        const pattern = typeof binderTool.name === "string" ? new RegExp(`^${binderTool.name}$`) : binderTool.name;
-        const matchedTool = tools.find((t) => pattern.test(t.name));
-        if (!matchedTool && binderTool.opt) {
-          continue;
-        }
-        if (!matchedTool) {
-          return false;
-        }
-        const binderInputSchema = normalizeSchema(binderTool.inputSchema);
-        const toolInputSchema = normalizeSchema(matchedTool.inputSchema);
-        if (binderInputSchema && toolInputSchema) {
-          try {
-            const inputDiff = await diffSchemas({
-              sourceSchema: binderInputSchema,
-              destinationSchema: toolInputSchema
-            });
-            if (inputDiff.removalsFound) {
-              return false;
-            }
-          } catch (error) {
-            console.error("Schema diff failed", error);
-            return false;
-          }
-        } else if (binderInputSchema && !toolInputSchema) {
-          return false;
-        }
-        const binderOutputSchema = normalizeSchema(binderTool.outputSchema);
-        const toolOutputSchema = normalizeSchema(matchedTool.outputSchema);
-        if (binderOutputSchema && toolOutputSchema) {
-          try {
-            const outputDiff = await diffSchemas({
-              sourceSchema: binderOutputSchema,
-              destinationSchema: toolOutputSchema
-            });
-            if (outputDiff.removalsFound) {
-              return false;
-            }
-          } catch (error) {
-            console.error("Schema diff failed", error);
-            return false;
-          }
-        } else if (binderOutputSchema && !toolOutputSchema) {
-          return false;
-        }
-      }
-      return true;
-    }
-  };
-}
-
-export { createBindingChecker };
-//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/client/http-client-transport.ts","../src/core/client/mcp-client.ts","../src/core/client/proxy.ts","../src/core/client/mcp.ts","../src/core/binder.ts"],"names":["BaseClient","jsonSchema"],"mappings":"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","file":"index.js","sourcesContent":["import type { JSONRPCMessage } from \"@modelcontextprotocol/sdk/types.js\";\nimport {\n  StreamableHTTPClientTransport,\n  type StreamableHTTPClientTransportOptions,\n} from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\n\nexport class HTTPClientTransport extends StreamableHTTPClientTransport {\n  constructor(url: URL, opts?: StreamableHTTPClientTransportOptions) {\n    super(url, opts);\n  }\n\n  override send(\n    message: JSONRPCMessage,\n    options?: {\n      resumptionToken?: string;\n      onresumptiontoken?: (token: string) => void;\n    },\n  ): Promise<void> {\n    const mockAction = getMockActionFor(message);\n    if (mockAction?.type === \"emit\") {\n      this.onmessage?.(mockAction.message);\n      return Promise.resolve();\n    }\n    if (mockAction?.type === \"suppress\") {\n      return Promise.resolve();\n    }\n    return super.send(message, options);\n  }\n}\n\ntype MockAction =\n  | { type: \"emit\"; message: JSONRPCMessage }\n  | { type: \"suppress\" };\n\nfunction getMockActionFor(message: JSONRPCMessage): MockAction | null {\n  const m = message;\n  if (!m || typeof m !== \"object\" || !(\"method\" in m)) return null;\n\n  switch (m.method) {\n    case \"initialize\": {\n      const protocolVersion = m?.params?.protocolVersion;\n      if (!protocolVersion) return null;\n      return {\n        type: \"emit\",\n        message: {\n          result: {\n            protocolVersion,\n            capabilities: { tools: {} },\n            serverInfo: { name: \"deco-chat-server\", version: \"1.0.0\" },\n          },\n          jsonrpc: m.jsonrpc ?? \"2.0\",\n          // @ts-expect-error - id is not typed\n          id: m.id,\n        } as JSONRPCMessage,\n      };\n    }\n    case \"notifications/roots/list_changed\":\n    case \"notifications/initialized\":\n    case \"notifications/cancelled\":\n    case \"notifications/progress\": {\n      return { type: \"suppress\" };\n    }\n    default:\n      return null;\n  }\n}\n","import {\n  Client as BaseClient,\n  ClientOptions,\n} from \"@modelcontextprotocol/sdk/client/index.js\";\nimport {\n  SSEClientTransport,\n  SSEClientTransportOptions,\n} from \"@modelcontextprotocol/sdk/client/sse.js\";\nimport { WebSocketClientTransport } from \"@modelcontextprotocol/sdk/client/websocket.js\";\nimport { RequestOptions } from \"@modelcontextprotocol/sdk/shared/protocol.js\";\nimport {\n  Implementation,\n  ListToolsRequest,\n  ListToolsResultSchema,\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport { MCPConnection } from \"../connection\";\nimport { HTTPClientTransport } from \"./http-client-transport\";\n\n/**\n * WARNNING: This is a hack to prevent schema compilation errors.\n * More info at: https://github.com/modelcontextprotocol/typescript-sdk/issues/923\n *\n * Make sure to keep this updated with the right version of the SDK.\n * https://github.com/modelcontextprotocol/typescript-sdk/blob/bf817939917277a4c59f2e19e7b44b8dd7ff140c/src/client/index.ts#L480\n */\nclass Client extends BaseClient {\n  constructor(_clientInfo: Implementation, options?: ClientOptions) {\n    super(_clientInfo, options);\n  }\n\n  override async listTools(\n    params?: ListToolsRequest[\"params\"],\n    options?: RequestOptions,\n  ) {\n    const result = await this.request(\n      { method: \"tools/list\", params },\n      ListToolsResultSchema,\n      options,\n    );\n\n    return result;\n  }\n}\n\nexport interface ServerClient {\n  client: Client;\n  callStreamableTool: (tool: string, args: unknown) => Promise<Response>;\n}\nexport const createServerClient = async (\n  mcpServer: { connection: MCPConnection; name?: string },\n  signal?: AbortSignal,\n  extraHeaders?: Record<string, string>,\n): Promise<ServerClient> => {\n  const transport = createTransport(mcpServer.connection, signal, extraHeaders);\n\n  if (!transport) {\n    throw new Error(\"Unknown MCP connection type\");\n  }\n\n  const client = new Client({\n    name: mcpServer?.name ?? \"MCP Client\",\n    version: \"1.0.0\",\n  });\n\n  await client.connect(transport);\n\n  return {\n    client,\n    callStreamableTool: (tool, args) => {\n      if (mcpServer.connection.type !== \"HTTP\") {\n        throw new Error(\"HTTP connection required\");\n      }\n      return fetch(mcpServer.connection.url + `/call-tool/${tool}`, {\n        method: \"POST\",\n        redirect: \"manual\",\n        body: JSON.stringify(args),\n        headers: {\n          ...extraHeaders,\n          Authorization: `Bearer ${mcpServer.connection.token}`,\n        },\n      });\n    },\n  };\n};\n\nexport const createTransport = (\n  connection: MCPConnection,\n  signal?: AbortSignal,\n  extraHeaders?: Record<string, string>,\n) => {\n  if (connection.type === \"Websocket\") {\n    return new WebSocketClientTransport(new URL(connection.url));\n  }\n\n  if (connection.type !== \"SSE\" && connection.type !== \"HTTP\") {\n    return null;\n  }\n\n  const authHeaders: Record<string, string> = connection.token\n    ? { authorization: `Bearer ${connection.token}` }\n    : {};\n\n  const headers: Record<string, string> = {\n    ...authHeaders,\n    ...(extraHeaders ?? {}),\n    ...(\"headers\" in connection ? connection.headers || {} : {}),\n  };\n\n  if (connection.type === \"SSE\") {\n    const config: SSEClientTransportOptions = {\n      requestInit: { headers, signal },\n    };\n\n    if (connection.token) {\n      config.eventSourceInit = {\n        fetch: (req, init) => {\n          return fetch(req, {\n            ...init,\n            headers: {\n              ...headers,\n              Accept: \"text/event-stream\",\n            },\n            signal,\n          });\n        },\n      };\n    }\n\n    return new SSEClientTransport(new URL(connection.url), config);\n  }\n  return new HTTPClientTransport(new URL(connection.url), {\n    requestInit: {\n      headers,\n      signal,\n      // @ts-ignore - this is a valid option for fetch\n      credentials: \"include\",\n    },\n  });\n};\n","/* oxlint-disable no-explicit-any */\nimport { convertJsonSchemaToZod } from \"zod-from-json-schema\";\nimport type { CreateStubAPIOptions } from \"./mcp\";\nimport { createServerClient } from \"./mcp-client\";\n\nconst safeParse = (content: string) => {\n  try {\n    return JSON.parse(content as string);\n  } catch {\n    return content;\n  }\n};\n\nconst toolsMap = new Map<\n  string,\n  Promise<\n    Array<{\n      name: string;\n      inputSchema: any;\n      outputSchema?: any;\n      description: string;\n    }>\n  >\n>();\n\n/**\n * The base fetcher used to fetch the MCP from API.\n */\nexport function createMCPClientProxy<T extends Record<string, unknown>>(\n  options: CreateStubAPIOptions,\n): T {\n  return new Proxy<T>({} as T, {\n    get(_, name) {\n      if (name === \"toJSON\") {\n        return null;\n      }\n      if (typeof name !== \"string\") {\n        throw new Error(\"Name must be a string\");\n      }\n      async function callToolFn(args: unknown) {\n        const debugId = options?.debugId?.();\n        const extraHeaders = debugId\n          ? { \"x-trace-debug-id\": debugId }\n          : undefined;\n\n        const { client, callStreamableTool } = await createServerClient(\n          { connection: options.connection },\n          undefined,\n          extraHeaders,\n        );\n\n        if (options?.streamable?.[String(name)]) {\n          return callStreamableTool(String(name), args);\n        }\n\n        const { structuredContent, isError, content } = await client.callTool(\n          {\n            name: String(name),\n            arguments: args as Record<string, unknown>,\n          },\n          undefined,\n          {\n            timeout: 3000000,\n          },\n        );\n\n        if (isError) {\n          const maybeErrorMessage = (content as { text: string }[])?.[0]?.text;\n          const error =\n            typeof maybeErrorMessage === \"string\"\n              ? safeParse(maybeErrorMessage)\n              : null;\n\n          const throwableError =\n            error?.code && typeof options?.getErrorByStatusCode === \"function\"\n              ? options.getErrorByStatusCode(\n                  error.code,\n                  error.message,\n                  error.traceId,\n                )\n              : null;\n\n          if (throwableError) {\n            throw throwableError;\n          }\n\n          throw new Error(\n            `Tool ${String(name)} returned an error: ${JSON.stringify(\n              structuredContent ?? content,\n            )}`,\n          );\n        }\n        return structuredContent;\n      }\n\n      const listToolsFn = async () => {\n        const { client } = await createServerClient({\n          connection: options.connection,\n        });\n        const { tools } = await client.listTools();\n\n        return tools as {\n          name: string;\n          inputSchema: any;\n          outputSchema?: any;\n          description: string;\n        }[];\n      };\n\n      async function listToolsOnce() {\n        const conn = options.connection;\n        const key = JSON.stringify(conn);\n\n        try {\n          if (!toolsMap.has(key)) {\n            toolsMap.set(key, listToolsFn());\n          }\n\n          return await toolsMap.get(key)!;\n        } catch (error) {\n          console.error(\"Failed to list tools\", error);\n\n          toolsMap.delete(key);\n          return;\n        }\n      }\n      callToolFn.asTool = async () => {\n        const tools = (await listToolsOnce()) ?? [];\n        const tool = tools.find((t) => t.name === name);\n        if (!tool) {\n          throw new Error(`Tool ${name} not found`);\n        }\n\n        return {\n          ...tool,\n          id: tool.name,\n          inputSchema: tool.inputSchema\n            ? convertJsonSchemaToZod(tool.inputSchema)\n            : undefined,\n          outputSchema: tool.outputSchema\n            ? convertJsonSchemaToZod(tool.outputSchema)\n            : undefined,\n          execute: (input: any) => {\n            return callToolFn(input.context);\n          },\n        };\n      };\n      return callToolFn;\n    },\n  });\n}\n","/* oxlint-disable no-explicit-any */\nimport { z } from \"zod\";\nimport type { MCPConnection } from \"../connection\";\nimport { createMCPClientProxy } from \"./proxy\";\n\nexport interface FetchOptions extends RequestInit {\n  path?: string;\n  segments?: string[];\n}\n\n// Default fetcher instance with API_SERVER_URL and API_HEADERS\nexport const MCPClient = new Proxy(\n  {} as {\n    forConnection: <TDefinition extends readonly ToolBinder[]>(\n      connection: MCPConnection,\n    ) => MCPClientFetchStub<TDefinition>;\n  },\n  {\n    get(_, name) {\n      if (name === \"toJSON\") {\n        return null;\n      }\n\n      if (name === \"forConnection\") {\n        return <TDefinition extends readonly ToolBinder[]>(\n          connection: MCPConnection,\n        ) =>\n          createMCPFetchStub<TDefinition>({\n            connection,\n          });\n      }\n      return global[name as keyof typeof global];\n    },\n  },\n);\n\nimport type { ToolBinder } from \"../binder\";\nexport type { ToolBinder };\n\nexport const isStreamableToolBinder = (\n  toolBinder: ToolBinder,\n): toolBinder is ToolBinder<string, any, any, true> => {\n  return toolBinder.streamable === true;\n};\nexport type MCPClientStub<TDefinition extends readonly ToolBinder[]> = {\n  [K in TDefinition[number] as K[\"name\"]]: K extends ToolBinder<\n    string,\n    infer TInput,\n    infer TReturn\n  >\n    ? (params: TInput, init?: RequestInit) => Promise<TReturn>\n    : never;\n};\n\nexport type MCPClientFetchStub<TDefinition extends readonly ToolBinder[]> = {\n  [K in TDefinition[number] as K[\"name\"]]: K[\"streamable\"] extends true\n    ? K extends ToolBinder<string, infer TInput, any, true>\n      ? (params: TInput, init?: RequestInit) => Promise<Response>\n      : never\n    : K extends ToolBinder<string, infer TInput, infer TReturn, any>\n      ? (params: TInput, init?: RequestInit) => Promise<Awaited<TReturn>>\n      : never;\n};\n\nexport interface MCPClientRaw {\n  callTool: (tool: string, args: unknown) => Promise<unknown>;\n  listTools: () => Promise<\n    {\n      name: string;\n      inputSchema: any;\n      outputSchema?: any;\n      description: string;\n    }[]\n  >;\n}\nexport type JSONSchemaToZodConverter = (jsonSchema: any) => z.ZodTypeAny;\nexport interface CreateStubAPIOptions {\n  connection: MCPConnection;\n  streamable?: Record<string, boolean>;\n  debugId?: () => string;\n  getErrorByStatusCode?: (\n    statusCode: number,\n    message?: string,\n    traceId?: string,\n    errorObject?: unknown,\n  ) => Error;\n}\n\nexport function createMCPFetchStub<TDefinition extends readonly ToolBinder[]>(\n  options: CreateStubAPIOptions,\n): MCPClientFetchStub<TDefinition> {\n  return createMCPClientProxy<MCPClientFetchStub<TDefinition>>(options);\n}\n","/**\n * Core Binder Types and Utilities\n *\n * This module provides the core types and utilities for the bindings system.\n * Bindings define standardized interfaces that integrations (MCPs) can implement.\n */\n\nimport { diffSchemas } from \"json-schema-diff\";\nimport type { ZodType } from \"zod\";\nimport { zodToJsonSchema } from \"zod-to-json-schema\";\nimport { createMCPFetchStub, MCPClientFetchStub } from \"./client/mcp\";\nimport { MCPConnection } from \"./connection\";\n\n/**\n * ToolBinder defines a single tool within a binding.\n * It specifies the tool name, input/output schemas, and whether it's optional.\n *\n * @template TName - The tool name (can be a string or RegExp for pattern matching)\n * @template TInput - The input type (inferred from inputSchema)\n * @template TReturn - The return type (inferred from outputSchema)\n */\nexport interface ToolBinder<\n  TName extends string | RegExp = string,\n  // biome-ignore lint/suspicious/noExplicitAny: Generic type parameter\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  TInput = any,\n  TReturn extends object | null | boolean = object,\n  TStreamable extends boolean = boolean,\n> {\n  /** The name of the tool (e.g., \"DECO_CHAT_CHANNELS_JOIN\") */\n  name: TName;\n\n  /** Zod schema for validating tool input */\n  inputSchema: ZodType<TInput>;\n\n  /** Optional Zod schema for validating tool output */\n  outputSchema?: TStreamable extends true ? never : ZodType<TReturn>;\n\n  /**\n   * Whether this tool is streamable.\n   */\n  streamable?: TStreamable;\n\n  /**\n   * Whether this tool is optional in the binding.\n   * If true, an implementation doesn't need to provide this tool.\n   */\n  opt?: true;\n}\n\n/**\n * Binder represents a collection of tool definitions that form a binding.\n * A binding is like a TypeScript interface - it defines what tools must be implemented.\n *\n * @template TDefinition - Array of ToolBinder definitions\n *\n * @example\n * ```ts\n * const MY_BINDING = [{\n *   name: \"MY_TOOL\" as const,\n *   inputSchema: z.object({ id: z.string() }),\n *   outputSchema: z.object({ success: z.boolean() }),\n * }] as const satisfies Binder;\n * ```\n */\nexport type Binder<\n  TDefinition extends readonly ToolBinder[] = readonly ToolBinder[],\n> = TDefinition;\n\n/**\n * Tool with schemas for validation\n */\nexport interface ToolWithSchemas {\n  name: string;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  inputSchema?: ZodType<any> | Record<string, unknown>;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  outputSchema?: ZodType<any> | Record<string, unknown>;\n}\n\n/**\n * Converts a schema to JSON Schema format if it's a Zod schema\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction normalizeSchema(schema: any): Record<string, unknown> | undefined {\n  if (!schema) return undefined;\n\n  // If it's a Zod schema (has _def property), convert it\n  if (schema._def) {\n    const jsonSchema = zodToJsonSchema(schema, {\n      // Don't add additionalProperties: false to allow structural compatibility\n      $refStrategy: \"none\",\n    }) as Record<string, unknown>;\n\n    // Remove additionalProperties constraint to allow subtyping\n    if (jsonSchema.type === \"object\") {\n      delete jsonSchema.additionalProperties;\n    }\n\n    return jsonSchema;\n  }\n\n  // Otherwise assume it's already a JSON Schema\n  const jsonSchema = schema as Record<string, unknown>;\n\n  // Remove additionalProperties constraint if present\n  if (jsonSchema.type === \"object\" && \"additionalProperties\" in jsonSchema) {\n    const copy = { ...jsonSchema };\n    delete copy.additionalProperties;\n    return copy;\n  }\n\n  return jsonSchema;\n}\n\n/**\n * Binding checker interface\n */\nexport interface BindingChecker {\n  /**\n   * Check if a set of tools implements the binding with full schema validation.\n   *\n   * Validates:\n   * - Tool name matches (exact or regex)\n   * - Input schema: Tool accepts what binder requires (no removals from binder to tool)\n   * - Output schema: Tool provides what binder expects (no removals from tool to binder)\n   *\n   * @param tools - Array of tools with names and schemas\n   * @returns Promise<boolean> - true if all tools implement the binding correctly\n   */\n  isImplementedBy: (tools: ToolWithSchemas[]) => Promise<boolean>;\n}\n\nexport const bindingClient = <TDefinition extends readonly ToolBinder[]>(\n  binder: TDefinition,\n) => {\n  return {\n    ...createBindingChecker(binder),\n    forConnection: (\n      mcpConnection: MCPConnection,\n    ): MCPClientFetchStub<TDefinition> => {\n      return createMCPFetchStub<TDefinition>({\n        connection: mcpConnection,\n        streamable: binder.reduce(\n          (acc, tool) => {\n            acc[tool.name] = tool.streamable === true;\n            return acc;\n          },\n          {} as Record<string, boolean>,\n        ),\n      });\n    },\n  };\n};\n\nexport type MCPBindingClient<T extends ReturnType<typeof bindingClient>> =\n  ReturnType<T[\"forConnection\"]>;\n\n/**\n * Creates a binding checker with full schema validation using json-schema-diff.\n *\n * This performs strict compatibility checking:\n * - For input schemas: Validates that the tool can accept what the binder requires\n * - For output schemas: Validates that the tool provides what the binder expects\n *\n * @param binderTools - The binding definition to check against\n * @returns A binding checker with an async isImplementedBy method\n *\n * @example\n * ```ts\n * const checker = createBindingChecker(MY_BINDING);\n * const isCompatible = await checker.isImplementedBy(availableTools);\n * ```\n */\nexport function createBindingChecker<TDefinition extends readonly ToolBinder[]>(\n  binderTools: TDefinition,\n): BindingChecker {\n  return {\n    isImplementedBy: async (tools: ToolWithSchemas[]) => {\n      for (const binderTool of binderTools) {\n        // Find matching tool by name (exact or regex)\n        const pattern =\n          typeof binderTool.name === \"string\"\n            ? new RegExp(`^${binderTool.name}$`)\n            : binderTool.name;\n\n        const matchedTool = tools.find((t) => pattern.test(t.name));\n\n        // Skip optional tools that aren't present\n        if (!matchedTool && binderTool.opt) {\n          continue;\n        }\n\n        // Required tool not found\n        if (!matchedTool) {\n          return false;\n        }\n\n        // === INPUT SCHEMA VALIDATION ===\n        // Tool must accept what binder requires\n        // Check: binder (source) -> tool (destination)\n        // If removals found, tool doesn't accept something binder requires\n        const binderInputSchema = normalizeSchema(binderTool.inputSchema);\n        const toolInputSchema = normalizeSchema(matchedTool.inputSchema);\n\n        if (binderInputSchema && toolInputSchema) {\n          try {\n            const inputDiff = await diffSchemas({\n              sourceSchema: binderInputSchema,\n              destinationSchema: toolInputSchema,\n            });\n\n            // If something was removed from binder to tool, tool can't accept it\n            if (inputDiff.removalsFound) {\n              return false;\n            }\n          } catch (error) {\n            console.error(\"Schema diff failed\", error);\n            // Schema diff failed - consider incompatible\n            return false;\n          }\n        } else if (binderInputSchema && !toolInputSchema) {\n          // Binder requires input schema but tool doesn't have one\n          return false;\n        }\n\n        // === OUTPUT SCHEMA VALIDATION ===\n        // Tool must provide what binder expects (but can provide more)\n        // Check: binder (source) -> tool (destination)\n        // If removals found, tool doesn't provide something binder expects\n        const binderOutputSchema = normalizeSchema(binderTool.outputSchema);\n        const toolOutputSchema = normalizeSchema(matchedTool.outputSchema);\n\n        if (binderOutputSchema && toolOutputSchema) {\n          try {\n            const outputDiff = await diffSchemas({\n              sourceSchema: binderOutputSchema,\n              destinationSchema: toolOutputSchema,\n            });\n\n            // If something was removed from binder to tool, tool doesn't provide it\n            if (outputDiff.removalsFound) {\n              return false;\n            }\n          } catch (error) {\n            console.error(\"Schema diff failed\", error);\n            // Schema diff failed - consider incompatible\n            return false;\n          }\n        } else if (binderOutputSchema && !toolOutputSchema) {\n          // Binder expects output schema but tool doesn't have one\n          return false;\n        }\n      }\n\n      return true;\n    },\n  };\n}\n"]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @decocms/bindings\n *\n * Core type definitions for the bindings system.\n * Bindings define standardized interfaces that integrations (MCPs) can implement.\n */\n\n// Re-export core binder types and utilities\nexport {\n  createBindingChecker,\n  type Binder,\n  type BindingChecker,\n  type ToolBinder,\n  type ToolWithSchemas,\n} from \"./core/binder\";\n"],"mappings":"AAQA;AAAA,EACE;AAAA,OAKK;","names":[]}

package/dist/{node/agents.d.ts → well-known/agent.d.ts}

@@ -1,5 +1,5 @@
 import { CollectionListInputSchema, CollectionGetInputSchema, CollectionDeleteInputSchema } from './collections.js';
-import { z } from 'zod';
+import { z } from 'zod/v3';
 
 /**
  * Agent entity schema for AI agents
@@ -42,13 +42,13 @@ declare const AgentSchema: z.ZodObject<{
     updated_by?: string | undefined;
 }>;
 /**
- * AGENTS Collection Binding
+ * AGENT Collection Binding
  *
  * Collection bindings for agents (read-only).
  * Provides LIST and GET operations for AI agents.
  */
 declare const AGENTS_COLLECTION_BINDING: ({
-    name: "COLLECTION_AGENTS_LIST";
+    name: "COLLECTION_AGENT_LIST";
     inputSchema: typeof CollectionListInputSchema;
     outputSchema: z.ZodObject<{
         items: z.ZodArray<z.ZodObject<{
@@ -120,7 +120,7 @@ declare const AGENTS_COLLECTION_BINDING: ({
         hasMore?: boolean | undefined;
     }>;
 } | {
-    name: "COLLECTION_AGENTS_GET";
+    name: "COLLECTION_AGENT_GET";
     inputSchema: typeof CollectionGetInputSchema;
     outputSchema: z.ZodObject<{
         item: z.ZodNullable<z.ZodObject<{
@@ -186,7 +186,7 @@ declare const AGENTS_COLLECTION_BINDING: ({
         } | null;
     }>;
 } | {
-    name: "COLLECTION_AGENTS_CREATE";
+    name: "COLLECTION_AGENT_CREATE";
     inputSchema: z.ZodObject<{
         data: z.ZodObject<{
             id: z.ZodString;
@@ -315,7 +315,7 @@ declare const AGENTS_COLLECTION_BINDING: ({
     }>;
     opt: true;
 } | {
-    name: "COLLECTION_AGENTS_UPDATE";
+    name: "COLLECTION_AGENT_UPDATE";
     inputSchema: z.ZodObject<{
         id: z.ZodString;
         data: z.ZodObject<{
@@ -401,7 +401,7 @@ declare const AGENTS_COLLECTION_BINDING: ({
     }>;
     opt: true;
 } | {
-    name: "COLLECTION_AGENTS_DELETE";
+    name: "COLLECTION_AGENT_DELETE";
     inputSchema: typeof CollectionDeleteInputSchema;
     outputSchema: z.ZodObject<{
         item: z.ZodObject<{
@@ -475,11 +475,11 @@ declare const AGENTS_COLLECTION_BINDING: ({
  * Any MCP that implements this binding can provide configurable AI agents.
  *
  * Required tools:
- * - COLLECTION_AGENTS_LIST: List available AI agents with their configurations
- * - COLLECTION_AGENTS_GET: Get a single agent by ID (includes instructions and tool_set)
+ * - COLLECTION_AGENT_LIST: List available AI agents with their configurations
+ * - COLLECTION_AGENT_GET: Get a single agent by ID (includes instructions and tool_set)
  */
 declare const AGENTS_BINDING: readonly ({
-    name: "COLLECTION_AGENTS_LIST";
+    name: "COLLECTION_AGENT_LIST";
     inputSchema: typeof CollectionListInputSchema;
     outputSchema: z.ZodObject<{
         items: z.ZodArray<z.ZodObject<{
@@ -551,7 +551,7 @@ declare const AGENTS_BINDING: readonly ({
         hasMore?: boolean | undefined;
     }>;
 } | {
-    name: "COLLECTION_AGENTS_GET";
+    name: "COLLECTION_AGENT_GET";
     inputSchema: typeof CollectionGetInputSchema;
     outputSchema: z.ZodObject<{
         item: z.ZodNullable<z.ZodObject<{
@@ -617,7 +617,7 @@ declare const AGENTS_BINDING: readonly ({
         } | null;
     }>;
 } | {
-    name: "COLLECTION_AGENTS_CREATE";
+    name: "COLLECTION_AGENT_CREATE";
     inputSchema: z.ZodObject<{
         data: z.ZodObject<{
             id: z.ZodString;
@@ -746,7 +746,7 @@ declare const AGENTS_BINDING: readonly ({
     }>;
     opt: true;
 } | {
-    name: "COLLECTION_AGENTS_UPDATE";
+    name: "COLLECTION_AGENT_UPDATE";
     inputSchema: z.ZodObject<{
         id: z.ZodString;
         data: z.ZodObject<{
@@ -832,7 +832,7 @@ declare const AGENTS_BINDING: readonly ({
     }>;
     opt: true;
 } | {
-    name: "COLLECTION_AGENTS_DELETE";
+    name: "COLLECTION_AGENT_DELETE";
     inputSchema: typeof CollectionDeleteInputSchema;
     outputSchema: z.ZodObject<{
         item: z.ZodObject<{

package/dist/well-known/agent.js

@@ -0,0 +1,27 @@
+import { z } from "zod/v3";
+import {
+  BaseCollectionEntitySchema,
+  createCollectionBindings
+} from "./collections";
+const AgentSchema = BaseCollectionEntitySchema.extend({
+  // Agent-specific fields
+  description: z.string().describe("Brief description of the agent's purpose"),
+  instructions: z.string().describe("System instructions that define the agent's behavior"),
+  tool_set: z.record(z.string(), z.array(z.string())).describe(
+    "Map of connection IDs to arrays of allowed tool names for this agent"
+  ),
+  avatar: z.string().url().describe("URL to the agent's avatar image")
+});
+const AGENTS_COLLECTION_BINDING = createCollectionBindings(
+  "agent",
+  AgentSchema
+);
+const AGENTS_BINDING = [
+  ...AGENTS_COLLECTION_BINDING
+];
+export {
+  AGENTS_BINDING,
+  AGENTS_COLLECTION_BINDING,
+  AgentSchema
+};
+//# sourceMappingURL=agent.js.map

package/dist/well-known/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/well-known/agent.ts"],"sourcesContent":["/**\n * Agents Well-Known Binding\n *\n * Defines the interface for AI agent providers.\n * Any MCP that implements this binding can provide configurable AI agents\n * with custom instructions and tool access controls.\n *\n * This binding uses collection bindings for LIST and GET operations (read-only).\n */\n\nimport { z } from \"zod/v3\";\nimport type { Binder } from \"../core/binder\";\nimport {\n  BaseCollectionEntitySchema,\n  createCollectionBindings,\n} from \"./collections\";\n\n/**\n * Agent entity schema for AI agents\n * Extends BaseCollectionEntitySchema with agent-specific fields\n * Base schema already includes: id, title, created_at, updated_at, created_by, updated_by\n */\nexport const AgentSchema = BaseCollectionEntitySchema.extend({\n  // Agent-specific fields\n  description: z.string().describe(\"Brief description of the agent's purpose\"),\n  instructions: z\n    .string()\n    .describe(\"System instructions that define the agent's behavior\"),\n  tool_set: z\n    .record(z.string(), z.array(z.string()))\n    .describe(\n      \"Map of connection IDs to arrays of allowed tool names for this agent\",\n    ),\n  avatar: z.string().url().describe(\"URL to the agent's avatar image\"),\n});\n\n/**\n * AGENT Collection Binding\n *\n * Collection bindings for agents (read-only).\n * Provides LIST and GET operations for AI agents.\n */\nexport const AGENTS_COLLECTION_BINDING = createCollectionBindings(\n  \"agent\",\n  AgentSchema,\n);\n\n/**\n * AGENTS Binding\n *\n * Defines the interface for AI agent providers.\n * Any MCP that implements this binding can provide configurable AI agents.\n *\n * Required tools:\n * - COLLECTION_AGENT_LIST: List available AI agents with their configurations\n * - COLLECTION_AGENT_GET: Get a single agent by ID (includes instructions and tool_set)\n */\nexport const AGENTS_BINDING = [\n  ...AGENTS_COLLECTION_BINDING,\n] as const satisfies Binder;\n"],"mappings":"AAUA,SAAS,SAAS;AAElB;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAOA,MAAM,cAAc,2BAA2B,OAAO;AAAA;AAAA,EAE3D,aAAa,EAAE,OAAO,EAAE,SAAS,0CAA0C;AAAA,EAC3E,cAAc,EACX,OAAO,EACP,SAAS,sDAAsD;AAAA,EAClE,UAAU,EACP,OAAO,EAAE,OAAO,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,EACtC;AAAA,IACC;AAAA,EACF;AAAA,EACF,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,iCAAiC;AACrE,CAAC;AAQM,MAAM,4BAA4B;AAAA,EACvC;AAAA,EACA;AACF;AAYO,MAAM,iBAAiB;AAAA,EAC5B,GAAG;AACL;","names":[]}

package/dist/{node → well-known}/collections.d.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import { z } from 'zod/v3';
 
 /**
  * Collection Bindings