@decocms/bindings 0.2.0 → 0.2.2

package/dist/node/language-model.js

@@ -0,0 +1,203 @@
+import { bindingClient } from './chunk-QP7AQCEP.js';
+import { BaseCollectionEntitySchema, createCollectionBindings } from './chunk-T2DG7334.js';
+import './chunk-BLCFITZG.js';
+import { init_esm_shims } from './chunk-QMQMPK7Q.js';
+import { z } from 'zod';
+
+// src/well-known/language-model.ts
+init_esm_shims();
+var LanguageModelCallOptionsSchema = z.object({
+  // Core parameters
+  prompt: z.any().describe(
+    "A language mode prompt is a standardized prompt type (messages, system, etc.)"
+  ),
+  // Generation parameters
+  maxOutputTokens: z.number().optional().describe("Maximum number of tokens to generate"),
+  temperature: z.number().optional().describe(
+    "Temperature setting. The range depends on the provider and model"
+  ),
+  topP: z.number().optional().describe("Nucleus sampling parameter"),
+  topK: z.number().optional().describe(
+    "Only sample from the top K options for each subsequent token. Used to remove long tail low probability responses"
+  ),
+  presencePenalty: z.number().optional().describe(
+    "Presence penalty setting. It affects the likelihood of the model to repeat information that is already in the prompt"
+  ),
+  frequencyPenalty: z.number().optional().describe(
+    "Frequency penalty setting. It affects the likelihood of the model to repeatedly use the same words or phrases"
+  ),
+  seed: z.number().optional().describe(
+    "The seed (integer) to use for random sampling. If set and supported by the model, calls will generate deterministic results"
+  ),
+  // Stop sequences
+  stopSequences: z.array(z.string()).optional().describe(
+    "Stop sequences. If set, the model will stop generating text when one of the stop sequences is generated"
+  ),
+  // Response format
+  responseFormat: z.union([
+    z.object({ type: z.literal("text") }),
+    z.object({
+      type: z.literal("json"),
+      schema: z.any().optional().describe("JSON schema that the generated output should conform to"),
+      name: z.string().optional().describe("Name of output that should be generated"),
+      description: z.string().optional().describe("Description of the output that should be generated")
+    })
+  ]).optional().describe(
+    "Response format. The output can either be text or JSON. Default is text"
+  ),
+  // Tools
+  tools: z.array(z.any()).optional().describe("The tools that are available for the model"),
+  toolChoice: z.any().optional().describe("Specifies how the tool should be selected. Defaults to 'auto'"),
+  // Stream options
+  includeRawChunks: z.boolean().optional().describe(
+    "Include raw chunks in the stream. Only applicable for streaming calls"
+  ),
+  // Abort signal
+  abortSignal: z.any().optional().describe("Abort signal for cancelling the operation"),
+  // Additional options
+  headers: z.record(z.string(), z.union([z.string(), z.undefined()])).optional().describe("Additional HTTP headers to be sent with the request"),
+  providerOptions: z.any().optional().describe("Additional provider-specific options")
+});
+var LanguageModelGenerateOutputSchema = z.object({
+  // Ordered content that the model has generated
+  content: z.array(z.any()).describe(
+    "Ordered content that the model has generated (text, tool-calls, reasoning, files, sources)"
+  ),
+  // Finish reason (required)
+  finishReason: z.enum([
+    "stop",
+    "length",
+    "content-filter",
+    "tool-calls",
+    "error",
+    "other",
+    "unknown"
+  ]).describe("Reason why generation stopped"),
+  // Usage information (required)
+  usage: z.object({
+    inputTokens: z.number().optional(),
+    outputTokens: z.number().optional(),
+    totalTokens: z.number().optional(),
+    reasoningTokens: z.number().optional()
+  }).passthrough().transform((val) => ({
+    inputTokens: val.inputTokens,
+    outputTokens: val.outputTokens,
+    totalTokens: val.totalTokens,
+    reasoningTokens: val.reasoningTokens,
+    ...val
+  })).describe("Usage information for the language model call"),
+  // Provider metadata
+  providerMetadata: z.any().optional().describe("Additional provider-specific metadata"),
+  // Request information for telemetry and debugging
+  request: z.object({
+    body: z.any().optional().describe("Request HTTP body sent to the provider API")
+  }).optional().describe("Optional request information for telemetry and debugging"),
+  // Response information for telemetry and debugging
+  response: z.object({
+    id: z.string().optional().describe("ID for the generated response"),
+    timestamp: z.date().optional().describe("Timestamp for the start of the generated response"),
+    modelId: z.string().optional().describe("The ID of the response model that was used"),
+    headers: z.record(z.string(), z.string()).optional().describe("Response headers"),
+    body: z.any().optional().describe("Response HTTP body")
+  }).optional().describe("Optional response information for telemetry and debugging"),
+  // Warnings for the call (required)
+  warnings: z.array(z.any()).describe("Warnings for the call, e.g. unsupported settings")
+});
+var LanguageModelStreamOutputSchema = z.object({
+  // Stream of language model output parts
+  stream: z.any().describe("ReadableStream of LanguageModelV2StreamPart"),
+  // Request information for telemetry and debugging
+  request: z.object({
+    body: z.any().optional().describe("Request HTTP body sent to the provider API")
+  }).optional().describe("Optional request information for telemetry and debugging"),
+  // Response information
+  response: z.object({
+    headers: z.record(z.string(), z.string()).optional().describe("Response headers")
+  }).optional().describe("Optional response data")
+});
+var LanguageModelMetadataSchema = z.object({
+  supportedUrls: z.record(z.string(), z.array(z.string())).describe("Supported URL patterns by media type for the provider")
+});
+var ModelSchema = z.object({
+  modelId: z.string().describe("The ID of the model"),
+  // Model-specific fields
+  logo: z.string().nullable(),
+  description: z.string().nullable(),
+  capabilities: z.array(z.string()),
+  limits: z.object({
+    contextWindow: z.number(),
+    maxOutputTokens: z.number()
+  }).nullable(),
+  costs: z.object({
+    input: z.number(),
+    output: z.number()
+  }).nullable(),
+  // Provider information
+  provider: z.enum([
+    "openai",
+    "anthropic",
+    "google",
+    "xai",
+    "deepseek",
+    "openai-compatible",
+    "openrouter"
+  ]).nullable()
+});
+var LanguageModelInputSchema = z.object({
+  modelId: z.string().describe("The ID of the model"),
+  callOptions: LanguageModelCallOptionsSchema
+});
+var ModelCollectionEntitySchema = BaseCollectionEntitySchema.extend({
+  // Model-specific fields
+  logo: z.string().nullable(),
+  description: z.string().nullable(),
+  capabilities: z.array(z.string()),
+  limits: z.object({
+    contextWindow: z.number(),
+    maxOutputTokens: z.number()
+  }).nullable(),
+  costs: z.object({
+    input: z.number(),
+    output: z.number()
+  }).nullable(),
+  // Provider information
+  provider: z.enum([
+    "openai",
+    "anthropic",
+    "google",
+    "xai",
+    "deepseek",
+    "openai-compatible",
+    "openrouter"
+  ]).nullable()
+});
+var LLM_COLLECTION_BINDING = createCollectionBindings(
+  "llm",
+  ModelCollectionEntitySchema,
+  { readOnly: true }
+);
+var LANGUAGE_MODEL_BINDING = [
+  {
+    name: "LLM_METADATA",
+    inputSchema: z.object({
+      modelId: z.string().describe("The ID of the model")
+    }),
+    outputSchema: LanguageModelMetadataSchema
+  },
+  {
+    name: "LLM_DO_STREAM",
+    inputSchema: LanguageModelInputSchema,
+    streamable: true
+  },
+  {
+    name: "LLM_DO_GENERATE",
+    inputSchema: LanguageModelInputSchema,
+    outputSchema: LanguageModelGenerateOutputSchema
+  },
+  ...LLM_COLLECTION_BINDING
+];
+var LanguageModelBinding = bindingClient(LANGUAGE_MODEL_BINDING);
+
+export { LANGUAGE_MODEL_BINDING, LanguageModelBinding, LanguageModelCallOptionsSchema, LanguageModelGenerateOutputSchema, LanguageModelInputSchema, LanguageModelMetadataSchema, LanguageModelStreamOutputSchema, ModelCollectionEntitySchema, ModelSchema };
+//# sourceMappingURL=language-model.js.map
+//# sourceMappingURL=language-model.js.map

package/dist/node/language-model.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/well-known/language-model.ts"],"names":[],"mappings":"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","file":"language-model.js","sourcesContent":["/**\n * Language Model Well-Known Binding\n *\n * Defines the interface for AI model providers.\n * Any MCP that implements this binding can provide AI models and streaming endpoints.\n *\n * This binding includes:\n * - LLM operations (metadata, stream, generate)\n * - Collection bindings for LIST and GET operations (read-only)\n * - Streaming endpoint information is included directly in the model entity schema.\n */\n\nimport { z } from \"zod\";\nimport { bindingClient, type ToolBinder } from \"../core/binder\";\nimport {\n  BaseCollectionEntitySchema,\n  createCollectionBindings,\n} from \"./collections\";\n\n/**\n * Language Model Call Options Schema\n * Based on LanguageModelV2CallOptions from @ai-sdk/provider\n */\nexport const LanguageModelCallOptionsSchema = z.object({\n  // Core parameters\n  prompt: z\n    .any()\n    .describe(\n      \"A language mode prompt is a standardized prompt type (messages, system, etc.)\",\n    ),\n\n  // Generation parameters\n  maxOutputTokens: z\n    .number()\n    .optional()\n    .describe(\"Maximum number of tokens to generate\"),\n  temperature: z\n    .number()\n    .optional()\n    .describe(\n      \"Temperature setting. The range depends on the provider and model\",\n    ),\n  topP: z.number().optional().describe(\"Nucleus sampling parameter\"),\n  topK: z\n    .number()\n    .optional()\n    .describe(\n      \"Only sample from the top K options for each subsequent token. Used to remove long tail low probability responses\",\n    ),\n  presencePenalty: z\n    .number()\n    .optional()\n    .describe(\n      \"Presence penalty setting. It affects the likelihood of the model to repeat information that is already in the prompt\",\n    ),\n  frequencyPenalty: z\n    .number()\n    .optional()\n    .describe(\n      \"Frequency penalty setting. It affects the likelihood of the model to repeatedly use the same words or phrases\",\n    ),\n  seed: z\n    .number()\n    .optional()\n    .describe(\n      \"The seed (integer) to use for random sampling. If set and supported by the model, calls will generate deterministic results\",\n    ),\n\n  // Stop sequences\n  stopSequences: z\n    .array(z.string())\n    .optional()\n    .describe(\n      \"Stop sequences. If set, the model will stop generating text when one of the stop sequences is generated\",\n    ),\n\n  // Response format\n  responseFormat: z\n    .union([\n      z.object({ type: z.literal(\"text\") }),\n      z.object({\n        type: z.literal(\"json\"),\n        schema: z\n          .any()\n          .optional()\n          .describe(\"JSON schema that the generated output should conform to\"),\n        name: z\n          .string()\n          .optional()\n          .describe(\"Name of output that should be generated\"),\n        description: z\n          .string()\n          .optional()\n          .describe(\"Description of the output that should be generated\"),\n      }),\n    ])\n    .optional()\n    .describe(\n      \"Response format. The output can either be text or JSON. Default is text\",\n    ),\n\n  // Tools\n  tools: z\n    .array(z.any())\n    .optional()\n    .describe(\"The tools that are available for the model\"),\n  toolChoice: z\n    .any()\n    .optional()\n    .describe(\"Specifies how the tool should be selected. Defaults to 'auto'\"),\n\n  // Stream options\n  includeRawChunks: z\n    .boolean()\n    .optional()\n    .describe(\n      \"Include raw chunks in the stream. Only applicable for streaming calls\",\n    ),\n\n  // Abort signal\n  abortSignal: z\n    .any()\n    .optional()\n    .describe(\"Abort signal for cancelling the operation\"),\n\n  // Additional options\n  headers: z\n    .record(z.string(), z.union([z.string(), z.undefined()]))\n    .optional()\n    .describe(\"Additional HTTP headers to be sent with the request\"),\n  providerOptions: z\n    .any()\n    .optional()\n    .describe(\"Additional provider-specific options\"),\n});\n\n/**\n * Language Model Generate Output Schema\n * Based on the return type of LanguageModelV2.doGenerate from @ai-sdk/provider\n */\nexport const LanguageModelGenerateOutputSchema = z.object({\n  // Ordered content that the model has generated\n  content: z\n    .array(z.any())\n    .describe(\n      \"Ordered content that the model has generated (text, tool-calls, reasoning, files, sources)\",\n    ),\n\n  // Finish reason (required)\n  finishReason: z\n    .enum([\n      \"stop\",\n      \"length\",\n      \"content-filter\",\n      \"tool-calls\",\n      \"error\",\n      \"other\",\n      \"unknown\",\n    ])\n    .describe(\"Reason why generation stopped\"),\n\n  // Usage information (required)\n  usage: z\n    .object({\n      inputTokens: z.number().optional(),\n      outputTokens: z.number().optional(),\n      totalTokens: z.number().optional(),\n      reasoningTokens: z.number().optional(),\n    })\n    .passthrough()\n    .transform((val) => ({\n      inputTokens: val.inputTokens,\n      outputTokens: val.outputTokens,\n      totalTokens: val.totalTokens,\n      reasoningTokens: val.reasoningTokens,\n      ...val,\n    }))\n    .describe(\"Usage information for the language model call\"),\n\n  // Provider metadata\n  providerMetadata: z\n    .any()\n    .optional()\n    .describe(\"Additional provider-specific metadata\"),\n\n  // Request information for telemetry and debugging\n  request: z\n    .object({\n      body: z\n        .any()\n        .optional()\n        .describe(\"Request HTTP body sent to the provider API\"),\n    })\n    .optional()\n    .describe(\"Optional request information for telemetry and debugging\"),\n\n  // Response information for telemetry and debugging\n  response: z\n    .object({\n      id: z.string().optional().describe(\"ID for the generated response\"),\n      timestamp: z\n        .date()\n        .optional()\n        .describe(\"Timestamp for the start of the generated response\"),\n      modelId: z\n        .string()\n        .optional()\n        .describe(\"The ID of the response model that was used\"),\n      headers: z\n        .record(z.string(), z.string())\n        .optional()\n        .describe(\"Response headers\"),\n      body: z.any().optional().describe(\"Response HTTP body\"),\n    })\n    .optional()\n    .describe(\"Optional response information for telemetry and debugging\"),\n\n  // Warnings for the call (required)\n  warnings: z\n    .array(z.any())\n    .describe(\"Warnings for the call, e.g. unsupported settings\"),\n});\n\n/**\n * Language Model Stream Output Schema\n * Based on the return type of LanguageModelV2.doStream from @ai-sdk/provider\n */\nexport const LanguageModelStreamOutputSchema = z.object({\n  // Stream of language model output parts\n  stream: z.any().describe(\"ReadableStream of LanguageModelV2StreamPart\"),\n\n  // Request information for telemetry and debugging\n  request: z\n    .object({\n      body: z\n        .any()\n        .optional()\n        .describe(\"Request HTTP body sent to the provider API\"),\n    })\n    .optional()\n    .describe(\"Optional request information for telemetry and debugging\"),\n\n  // Response information\n  response: z\n    .object({\n      headers: z\n        .record(z.string(), z.string())\n        .optional()\n        .describe(\"Response headers\"),\n    })\n    .optional()\n    .describe(\"Optional response data\"),\n});\n\nexport const LanguageModelMetadataSchema = z.object({\n  supportedUrls: z\n    .record(z.string(), z.array(z.string()))\n    .describe(\"Supported URL patterns by media type for the provider\"),\n});\n\n/**\n * Simple Model schema for LLM operations\n */\nexport const ModelSchema = z.object({\n  modelId: z.string().describe(\"The ID of the model\"),\n  // Model-specific fields\n  logo: z.string().nullable(),\n  description: z.string().nullable(),\n  capabilities: z.array(z.string()),\n  limits: z\n    .object({\n      contextWindow: z.number(),\n      maxOutputTokens: z.number(),\n    })\n    .nullable(),\n  costs: z\n    .object({\n      input: z.number(),\n      output: z.number(),\n    })\n    .nullable(),\n  // Provider information\n  provider: z\n    .enum([\n      \"openai\",\n      \"anthropic\",\n      \"google\",\n      \"xai\",\n      \"deepseek\",\n      \"openai-compatible\",\n      \"openrouter\",\n    ])\n    .nullable(),\n});\n\nexport const LanguageModelInputSchema = z.object({\n  modelId: z.string().describe(\"The ID of the model\"),\n  callOptions: LanguageModelCallOptionsSchema,\n});\n\n/**\n * Model entity schema for AI models (Collection Entity)\n * Extends BaseCollectionEntitySchema with model-specific fields\n * Base schema already includes: id, title, created_at, updated_at, created_by, updated_by\n */\nexport const ModelCollectionEntitySchema = BaseCollectionEntitySchema.extend({\n  // Model-specific fields\n  logo: z.string().nullable(),\n  description: z.string().nullable(),\n  capabilities: z.array(z.string()),\n  limits: z\n    .object({\n      contextWindow: z.number(),\n      maxOutputTokens: z.number(),\n    })\n    .nullable(),\n  costs: z\n    .object({\n      input: z.number(),\n      output: z.number(),\n    })\n    .nullable(),\n  // Provider information\n  provider: z\n    .enum([\n      \"openai\",\n      \"anthropic\",\n      \"google\",\n      \"xai\",\n      \"deepseek\",\n      \"openai-compatible\",\n      \"openrouter\",\n    ])\n    .nullable(),\n});\n\n/**\n * LLM Collection Binding (internal)\n *\n * Collection bindings for language models (read-only).\n * Provides LIST and GET operations for AI models.\n */\nconst LLM_COLLECTION_BINDING = createCollectionBindings(\n  \"llm\",\n  ModelCollectionEntitySchema,\n  { readOnly: true },\n);\n\n/**\n * Language Model Binding\n *\n * Defines the interface for AI model providers.\n * Any MCP that implements this binding can provide AI models.\n *\n * Required tools:\n * - LLM_METADATA: Get metadata for a specific model\n * - LLM_DO_STREAM: Stream a language model response\n * - LLM_DO_GENERATE: Generate a language model response\n * - COLLECTION_LLM_LIST: List available AI models with their capabilities\n * - COLLECTION_LLM_GET: Get a single model by ID\n */\nexport const LANGUAGE_MODEL_BINDING = [\n  {\n    name: \"LLM_METADATA\" as const,\n    inputSchema: z.object({\n      modelId: z.string().describe(\"The ID of the model\"),\n    }),\n    outputSchema: LanguageModelMetadataSchema,\n  },\n  {\n    name: \"LLM_DO_STREAM\" as const,\n    inputSchema: LanguageModelInputSchema,\n    streamable: true,\n  },\n  {\n    name: \"LLM_DO_GENERATE\" as const,\n    inputSchema: LanguageModelInputSchema,\n    outputSchema: LanguageModelGenerateOutputSchema,\n  },\n  ...LLM_COLLECTION_BINDING,\n] satisfies ToolBinder[];\n\nexport const LanguageModelBinding = bindingClient(LANGUAGE_MODEL_BINDING);\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decocms/bindings",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "type": "module",
   "scripts": {
     "build": "tsup",
@@ -11,32 +11,61 @@
   "dependencies": {
     "json-schema-diff": "^1.0.0",
     "zod": "^3.25.76",
-    "zod-to-json-schema": "^3.24.4"
+    "zod-to-json-schema": "^3.24.4",
+    "zod-from-json-schema": "^0.0.5",
+    "@modelcontextprotocol/sdk": "^1.20.2"
   },
-  "main": "./dist/index.js",
-  "types": "./src/index.ts",
+  "main": "./dist/node/index.js",
+  "types": "./dist/node/index.d.ts",
   "files": [
-    "dist/**/*",
-    "src/**/*"
+    "dist/**/*"
   ],
   "exports": {
     ".": {
-      "source": "./src/index.ts",
-      "types": "./src/index.ts",
-      "default": "./dist/index.js"
+      "types": "./dist/node/index.d.ts",
+      "browser": "./dist/browser/index.js",
+      "bun": "./dist/node/index.js",
+      "node": "./dist/node/index.js",
+      "default": "./dist/node/index.js"
     },
-    "./models": {
-      "source": "./src/well-known/models.ts",
-      "types": "./src/well-known/models.ts",
-      "default": "./dist/well-known/models.js"
+    "./client": {
+      "types": "./dist/node/index.d.ts",
+      "browser": "./dist/browser/index.js",
+      "bun": "./dist/node/index.js",
+      "node": "./dist/node/index.js",
+      "default": "./dist/node/index.js"
+    },
+    "./llm": {
+      "types": "./dist/node/language-model.d.ts",
+      "browser": "./dist/browser/language-model.js",
+      "bun": "./dist/node/language-model.js",
+      "node": "./dist/node/language-model.js",
+      "default": "./dist/node/language-model.js"
+    },
+    "./connection": {
+      "types": "./dist/node/connection.d.ts",
+      "browser": "./dist/browser/connection.js",
+      "bun": "./dist/node/connection.js",
+      "node": "./dist/node/connection.js",
+      "default": "./dist/node/connection.js"
     },
     "./collections": {
-      "source": "./src/well-known/collections.ts",
-      "types": "./src/well-known/collections.ts",
-      "default": "./dist/well-known/collections.js"
+      "types": "./dist/node/collections.d.ts",
+      "browser": "./dist/browser/collections.js",
+      "bun": "./dist/node/collections.js",
+      "node": "./dist/node/collections.js",
+      "default": "./dist/node/collections.js"
+    },
+    "./agents": {
+      "types": "./dist/node/agents.d.ts",
+      "browser": "./dist/browser/agents.js",
+      "bun": "./dist/node/agents.js",
+      "node": "./dist/node/agents.js",
+      "default": "./dist/node/agents.js"
     }
   },
   "devDependencies": {
+    "esbuild-plugin-polyfill-node": "^0.3.0",
     "tsup": "^8.5.0",
     "typescript": "^5.9.3",
     "vitest": "3.2.4"

package/src/core/binder.ts

@@ -1,226 +0,0 @@
-/**
- * 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.
- */
-
-import type { ZodType } from "zod";
-import { zodToJsonSchema } from "zod-to-json-schema";
-import { diffSchemas } from "json-schema-diff";
-
-/**
- * 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)
- */
-export interface ToolBinder<
-  TName extends string | RegExp = string,
-  // biome-ignore lint/suspicious/noExplicitAny: Generic type parameter
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  TInput = any,
-  TReturn extends object | null | boolean = object,
-> {
-  /** 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?: ZodType<TReturn>;
-
-  /**
-   * 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;
- * ```
- */
-export type Binder<
-  TDefinition extends readonly ToolBinder[] = readonly ToolBinder[],
-> = TDefinition;
-
-/**
- * Tool with schemas for validation
- */
-export interface ToolWithSchemas {
-  name: string;
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  inputSchema?: ZodType<any> | Record<string, unknown>;
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  outputSchema?: ZodType<any> | Record<string, unknown>;
-}
-
-/**
- * Converts a schema to JSON Schema format if it's a Zod schema
- */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-function normalizeSchema(schema: any): Record<string, unknown> | undefined {
-  if (!schema) return undefined;
-
-  // If it's a Zod schema (has _def property), convert it
-  if (schema._def) {
-    const jsonSchema = zodToJsonSchema(schema, {
-      // Don't add additionalProperties: false to allow structural compatibility
-      $refStrategy: "none",
-    }) as Record<string, unknown>;
-
-    // Remove additionalProperties constraint to allow subtyping
-    if (jsonSchema.type === "object") {
-      delete jsonSchema.additionalProperties;
-    }
-
-    return jsonSchema;
-  }
-
-  // Otherwise assume it's already a JSON Schema
-  const jsonSchema = schema as Record<string, unknown>;
-
-  // Remove additionalProperties constraint if present
-  if (jsonSchema.type === "object" && "additionalProperties" in jsonSchema) {
-    const copy = { ...jsonSchema };
-    delete copy.additionalProperties;
-    return copy;
-  }
-
-  return jsonSchema;
-}
-
-/**
- * Binding checker interface
- */
-export 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);
- * ```
- */
-export function createBindingChecker<TDefinition extends readonly ToolBinder[]>(
-  binderTools: TDefinition,
-): BindingChecker {
-  return {
-    isImplementedBy: async (tools: ToolWithSchemas[]) => {
-      for (const binderTool of binderTools) {
-        // Find matching tool by name (exact or regex)
-        const pattern =
-          typeof binderTool.name === "string"
-            ? new RegExp(`^${binderTool.name}$`)
-            : binderTool.name;
-
-        const matchedTool = tools.find((t) => pattern.test(t.name));
-
-        // Skip optional tools that aren't present
-        if (!matchedTool && binderTool.opt) {
-          continue;
-        }
-
-        // Required tool not found
-        if (!matchedTool) {
-          return false;
-        }
-
-        // === INPUT SCHEMA VALIDATION ===
-        // Tool must accept what binder requires
-        // Check: binder (source) -> tool (destination)
-        // If removals found, tool doesn't accept something binder requires
-        const binderInputSchema = normalizeSchema(binderTool.inputSchema);
-        const toolInputSchema = normalizeSchema(matchedTool.inputSchema);
-
-        if (binderInputSchema && toolInputSchema) {
-          try {
-            const inputDiff = await diffSchemas({
-              sourceSchema: binderInputSchema,
-              destinationSchema: toolInputSchema,
-            });
-
-            // If something was removed from binder to tool, tool can't accept it
-            if (inputDiff.removalsFound) {
-              return false;
-            }
-          } catch (error) {
-            console.error("Schema diff failed", error);
-            // Schema diff failed - consider incompatible
-            return false;
-          }
-        } else if (binderInputSchema && !toolInputSchema) {
-          // Binder requires input schema but tool doesn't have one
-          return false;
-        }
-
-        // === OUTPUT SCHEMA VALIDATION ===
-        // Tool must provide what binder expects (but can provide more)
-        // Check: binder (source) -> tool (destination)
-        // If removals found, tool doesn't provide something binder expects
-        const binderOutputSchema = normalizeSchema(binderTool.outputSchema);
-        const toolOutputSchema = normalizeSchema(matchedTool.outputSchema);
-
-        if (binderOutputSchema && toolOutputSchema) {
-          try {
-            const outputDiff = await diffSchemas({
-              sourceSchema: binderOutputSchema,
-              destinationSchema: toolOutputSchema,
-            });
-
-            // If something was removed from binder to tool, tool doesn't provide it
-            if (outputDiff.removalsFound) {
-              return false;
-            }
-          } catch (error) {
-            console.error("Schema diff failed", error);
-            // Schema diff failed - consider incompatible
-            return false;
-          }
-        } else if (binderOutputSchema && !toolOutputSchema) {
-          // Binder expects output schema but tool doesn't have one
-          return false;
-        }
-      }
-
-      return true;
-    },
-  };
-}

package/src/index.ts

@@ -1,15 +0,0 @@
-/**
- * @decocms/bindings
- *
- * Core type definitions for the bindings system.
- * Bindings define standardized interfaces that integrations (MCPs) can implement.
- */
-
-// Re-export core binder types and utilities
-export {
-  type ToolBinder,
-  type Binder,
-  type ToolWithSchemas,
-  type BindingChecker,
-  createBindingChecker,
-} from "./core/binder";