@decocms/bindings 0.1.6 → 0.2.0

package/README.md

@@ -272,11 +272,11 @@ const todoChecker = createBindingChecker(TODO_COLLECTION_BINDING);
 
 // Check if available tools implement the binding
 const availableTools = [
-  { name: "DECO_COLLECTION_TODOS_LIST" },
-  { name: "DECO_COLLECTION_TODOS_GET" },
-  { name: "DECO_COLLECTION_TODOS_INSERT" },
-  { name: "DECO_COLLECTION_TODOS_UPDATE" },
-  { name: "DECO_COLLECTION_TODOS_DELETE" },
+  { name: "COLLECTION_TODOS_LIST" },
+  { name: "COLLECTION_TODOS_GET" },
+  { name: "COLLECTION_TODOS_CREATE" },
+  { name: "COLLECTION_TODOS_UPDATE" },
+  { name: "COLLECTION_TODOS_DELETE" },
 ];
 
 const isImplemented = await todoChecker.isImplementedBy(availableTools);
@@ -289,29 +289,29 @@ The `createCollectionBindings` function generates tool bindings based on the `re
 
 **Required operations (always included):**
 
-1. **LIST** - `DECO_COLLECTION_{NAME}_LIST`
+1. **LIST** - `COLLECTION_{NAME}_LIST`
    - Query/search entities with filtering, sorting, and pagination
    - Input: `where?`, `orderBy?`, `limit?`, `offset?`
    - Output: `items[]`, `totalCount?`, `hasMore?`
 
-2. **GET** - `DECO_COLLECTION_{NAME}_GET`
+2. **GET** - `COLLECTION_{NAME}_GET`
    - Get a single entity by ID
    - Input: `id` (string)
    - Output: `item | null`
 
 **Optional operations (excluded if `readOnly: true`):**
 
-3. **INSERT** - `DECO_COLLECTION_{NAME}_INSERT`
+3. **CREATE** - `COLLECTION_{NAME}_CREATE`
    - Create a new entity
    - Input: `data` (id may be auto-generated by the server)
    - Output: `item` (with generated id)
 
-4. **UPDATE** - `DECO_COLLECTION_{NAME}_UPDATE`
+4. **UPDATE** - `COLLECTION_{NAME}_UPDATE`
    - Update an existing entity
    - Input: `id` (string), `data` (partial)
    - Output: `item`
 
-5. **DELETE** - `DECO_COLLECTION_{NAME}_DELETE`
+5. **DELETE** - `COLLECTION_{NAME}_DELETE`
    - Delete an entity
    - Input: `id` (string)
    - Output: `success` (boolean), `id` (string)
@@ -346,8 +346,8 @@ const modelsChecker = createBindingChecker(MODELS_BINDING);
 
 // Check if available tools implement the binding
 const availableTools = [
-  { name: "DECO_COLLECTION_MODELS_LIST" },
-  { name: "DECO_COLLECTION_MODELS_GET" },
+  { name: "COLLECTION_MODELS_LIST" },
+  { name: "COLLECTION_MODELS_GET" },
 ];
 
 const isImplemented = await modelsChecker.isImplementedBy(availableTools);
@@ -358,13 +358,13 @@ console.log(isImplemented); // true if all required tools are present
 
 The `MODELS_BINDING` includes:
 
-1. **DECO_COLLECTION_MODELS_LIST** (required)
+1. **COLLECTION_MODELS_LIST** (required)
    - List available AI models with their capabilities and streaming endpoints
    - Uses collection binding LIST operation
    - Input: `where?`, `orderBy?`, `limit?`, `offset?`
    - Output: `items[]` (array of model entities with endpoint info)
 
-2. **DECO_COLLECTION_MODELS_GET** (required)
+2. **COLLECTION_MODELS_GET** (required)
    - Get a single model by ID
    - Uses collection binding GET operation
    - Input: `id` (string)
@@ -576,14 +576,14 @@ import type {
   CollectionListInput,
   CollectionGetInput,
   CollectionDeleteInput,
-} from "@decocms/bindings/well-known/collections";
+} from "@decocms/bindings/collections";
 
 // Extract the binding type
 type TodoBinding = typeof TODO_COLLECTION_BINDING;
 
 // Extract tool names
 type TodoTools = CollectionTools<typeof TodoSchema>;
-// "DECO_COLLECTION_TODOS_LIST" | "DECO_COLLECTION_TODOS_GET" | ...
+// "COLLECTION_TODOS_LIST" | "COLLECTION_TODOS_GET" | ...
 
 // Get input types
 type ListInput = CollectionListInput;

package/dist/{chunk-L7E6ONLJ.js → chunk-JMM4EZYL.js}

@@ -11,16 +11,7 @@ var BaseCollectionEntitySchema = z.object({
 });
 var ComparisonExpressionSchema = z.object({
   field: z.array(z.string()),
-  operator: z.enum([
-    "eq",
-    "gt",
-    "gte",
-    "lt",
-    "lte",
-    "in",
-    "like",
-    "contains"
-  ]),
+  operator: z.enum(["eq", "gt", "gte", "lt", "lte", "in", "like", "contains"]),
   value: z.unknown()
 });
 var WhereExpressionSchema = z.union([
@@ -58,7 +49,9 @@ function createCollectionGetOutputSchema(entitySchema) {
 }
 function createCollectionInsertInputSchema(entitySchema) {
   return z.object({
-    data: entitySchema.describe("Data for the new entity (id may be auto-generated)")
+    data: entitySchema.describe(
+      "Data for the new entity (id may be auto-generated)"
+    )
   });
 }
 function createCollectionInsertOutputSchema(entitySchema) {
@@ -80,21 +73,22 @@ function createCollectionUpdateOutputSchema(entitySchema) {
 var CollectionDeleteInputSchema = z.object({
   id: z.string().describe("ID of the entity to delete")
 });
-var CollectionDeleteOutputSchema = z.object({
-  success: z.boolean().describe("Whether the deletion was successful"),
-  id: z.string().describe("ID of the deleted entity")
-});
+function createCollectionDeleteOutputSchema(entitySchema) {
+  return z.object({
+    item: entitySchema.describe("The deleted entity")
+  });
+}
 function createCollectionBindings(collectionName, entitySchema, options) {
   const upperName = collectionName.toUpperCase();
   const readOnly = options?.readOnly ?? false;
   const bindings = [
     {
-      name: `DECO_COLLECTION_${upperName}_LIST`,
+      name: `COLLECTION_${upperName}_LIST`,
       inputSchema: CollectionListInputSchema,
       outputSchema: createCollectionListOutputSchema(entitySchema)
     },
     {
-      name: `DECO_COLLECTION_${upperName}_GET`,
+      name: `COLLECTION_${upperName}_GET`,
       inputSchema: CollectionGetInputSchema,
       outputSchema: createCollectionGetOutputSchema(entitySchema)
     }
@@ -102,21 +96,21 @@ function createCollectionBindings(collectionName, entitySchema, options) {
   if (!readOnly) {
     bindings.push(
       {
-        name: `DECO_COLLECTION_${upperName}_INSERT`,
+        name: `COLLECTION_${upperName}_CREATE`,
         inputSchema: createCollectionInsertInputSchema(entitySchema),
         outputSchema: createCollectionInsertOutputSchema(entitySchema),
         opt: true
       },
       {
-        name: `DECO_COLLECTION_${upperName}_UPDATE`,
+        name: `COLLECTION_${upperName}_UPDATE`,
         inputSchema: createCollectionUpdateInputSchema(entitySchema),
         outputSchema: createCollectionUpdateOutputSchema(entitySchema),
         opt: true
       },
       {
-        name: `DECO_COLLECTION_${upperName}_DELETE`,
+        name: `COLLECTION_${upperName}_DELETE`,
         inputSchema: CollectionDeleteInputSchema,
-        outputSchema: CollectionDeleteOutputSchema,
+        outputSchema: createCollectionDeleteOutputSchema(entitySchema),
         opt: true
       }
     );
@@ -124,6 +118,6 @@ function createCollectionBindings(collectionName, entitySchema, options) {
   return bindings;
 }
 
-export { BaseCollectionEntitySchema, CollectionDeleteInputSchema, CollectionDeleteOutputSchema, CollectionGetInputSchema, CollectionListInputSchema, OrderByExpressionSchema, WhereExpressionSchema, createCollectionBindings, createCollectionGetOutputSchema, createCollectionInsertInputSchema, createCollectionInsertOutputSchema, createCollectionListOutputSchema, createCollectionUpdateInputSchema, createCollectionUpdateOutputSchema };
-//# sourceMappingURL=chunk-L7E6ONLJ.js.map
-//# sourceMappingURL=chunk-L7E6ONLJ.js.map
+export { BaseCollectionEntitySchema, CollectionDeleteInputSchema, CollectionGetInputSchema, CollectionListInputSchema, OrderByExpressionSchema, WhereExpressionSchema, createCollectionBindings, createCollectionDeleteOutputSchema, createCollectionGetOutputSchema, createCollectionInsertInputSchema, createCollectionInsertOutputSchema, createCollectionListOutputSchema, createCollectionUpdateInputSchema, createCollectionUpdateOutputSchema };
+//# sourceMappingURL=chunk-JMM4EZYL.js.map
+//# sourceMappingURL=chunk-JMM4EZYL.js.map

package/dist/chunk-JMM4EZYL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/well-known/collections.ts"],"names":[],"mappings":"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","file":"chunk-JMM4EZYL.js","sourcesContent":["import { z } from \"zod\";\nimport type { ToolBinder } from \"../core/binder\";\n\n/**\n * Collection Bindings\n *\n * This module provides standardized tool bindings for Collections, representing\n * SQL table-like structures with CRUD + Search operations compatible with TanStack DB.\n *\n * Key Features:\n * - Generic collection bindings that work with any entity type\n * - Standardized tool naming: `COLLECTION_{COLLECTION}_*`\n * - Compatible with TanStack DB query-collection\n * - Full TypeScript support with proper type constraints\n * - Support for filtering, sorting, and pagination\n * - Simple id and title fields for human-readable identification\n */\n\n/**\n * Base schema for collection entities\n * All collection entities must have an id, title, and audit trail fields\n */\nexport const BaseCollectionEntitySchema = z.object({\n  id: z.string().describe(\"Unique identifier for the entity\"),\n  title: z.string().describe(\"Human-readable title for the entity\"),\n  created_at: z.string().datetime(),\n  updated_at: z.string().datetime(),\n  created_by: z.string().optional(),\n  updated_by: z.string().optional(),\n});\n\n/**\n * Type helper for BaseCollectionEntitySchema\n */\nexport type BaseCollectionEntitySchemaType = typeof BaseCollectionEntitySchema;\n\n/**\n * Comparison expression schema for filtering\n */\nconst ComparisonExpressionSchema = z.object({\n  field: z.array(z.string()),\n  operator: z.enum([\"eq\", \"gt\", \"gte\", \"lt\", \"lte\", \"in\", \"like\", \"contains\"]),\n  value: z.unknown(),\n});\n\n/**\n * Where expression schema for filtering\n * Supports TanStack DB predicate push-down patterns\n */\nexport const WhereExpressionSchema = z.union([\n  ComparisonExpressionSchema,\n  z.object({\n    operator: z.enum([\"and\", \"or\", \"not\"]),\n    conditions: z.array(ComparisonExpressionSchema),\n  }),\n]);\n\n/**\n * Where expression type for filtering\n * Derived from WhereExpressionSchema\n */\nexport type WhereExpression = z.infer<typeof WhereExpressionSchema>;\n\n/**\n * Order by expression for sorting\n */\nexport const OrderByExpressionSchema = z.object({\n  field: z.array(z.string()),\n  direction: z.enum([\"asc\", \"desc\"]),\n  nulls: z.enum([\"first\", \"last\"]).optional(),\n});\n\n/**\n * List/Query input schema for collections\n * Compatible with TanStack DB LoadSubsetOptions\n */\nexport const CollectionListInputSchema = z.object({\n  where: WhereExpressionSchema.optional().describe(\"Filter expression\"),\n  orderBy: z\n    .array(OrderByExpressionSchema)\n    .optional()\n    .describe(\"Sort expressions\"),\n  limit: z\n    .number()\n    .int()\n    .min(1)\n    .max(1000)\n    .optional()\n    .describe(\"Maximum number of items to return\"),\n  offset: z\n    .number()\n    .int()\n    .min(0)\n    .optional()\n    .describe(\"Number of items to skip\"),\n});\n\n/**\n * Factory function to create list output schema for a specific collection type\n */\nexport function createCollectionListOutputSchema<T extends z.ZodTypeAny>(\n  entitySchema: T,\n) {\n  return z.object({\n    items: z.array(entitySchema).describe(\"Array of collection items\"),\n    totalCount: z\n      .number()\n      .int()\n      .min(0)\n      .optional()\n      .describe(\"Total number of matching items (if available)\"),\n    hasMore: z\n      .boolean()\n      .optional()\n      .describe(\"Whether there are more items available\"),\n  });\n}\n\n/**\n * Get by ID input schema\n */\nexport const CollectionGetInputSchema = z.object({\n  id: z.string().describe(\"ID of the entity to retrieve\"),\n});\n\n/**\n * Factory function to create get output schema\n */\nexport function createCollectionGetOutputSchema<T extends z.ZodTypeAny>(\n  entitySchema: T,\n) {\n  return z.object({\n    item: entitySchema\n      .nullable()\n      .describe(\"The retrieved item, or null if not found\"),\n  });\n}\n\n/**\n * Factory function to create insert input schema\n */\nexport function createCollectionInsertInputSchema<T extends z.ZodTypeAny>(\n  entitySchema: T,\n) {\n  // Remove id field since it may be auto-generated by the server\n  return z.object({\n    data: entitySchema.describe(\n      \"Data for the new entity (id may be auto-generated)\",\n    ),\n  });\n}\n\n/**\n * Factory function to create insert output schema\n */\nexport function createCollectionInsertOutputSchema<T extends z.ZodTypeAny>(\n  entitySchema: T,\n) {\n  return z.object({\n    item: entitySchema.describe(\"The created entity with generated id\"),\n  });\n}\n\n/**\n * Factory function to create update input schema\n */\nexport function createCollectionUpdateInputSchema<T extends z.ZodTypeAny>(\n  entitySchema: T,\n) {\n  return z.object({\n    id: z.string().describe(\"ID of the entity to update\"),\n    data: (entitySchema as unknown as z.AnyZodObject)\n      .partial()\n      .describe(\"Partial entity data to update\"),\n  });\n}\n\n/**\n * Factory function to create update output schema\n */\nexport function createCollectionUpdateOutputSchema<T extends z.ZodTypeAny>(\n  entitySchema: T,\n) {\n  return z.object({\n    item: entitySchema.describe(\"The updated entity\"),\n  });\n}\n\n/**\n * Delete input schema\n */\nexport const CollectionDeleteInputSchema = z.object({\n  id: z.string().describe(\"ID of the entity to delete\"),\n});\n\n/**\n * Factory function to create delete output schema\n */\nexport function createCollectionDeleteOutputSchema<T extends z.ZodTypeAny>(\n  entitySchema: T,\n) {\n  return z.object({\n    item: entitySchema.describe(\"The deleted entity\"),\n  });\n}\n\n/**\n * Options for creating collection bindings\n */\nexport interface CollectionBindingOptions {\n  /**\n   * If true, only LIST and GET operations will be included (read-only collection)\n   * @default false\n   */\n  readOnly?: boolean;\n}\n\n/**\n * Creates generic collection bindings for a specific entity type\n *\n * This function generates standardized tool bindings that work with any collection/table\n * by accepting a custom entity schema and collection name. The bindings provide:\n * - COLLECTION_{NAME}_LIST - Query/search entities with filtering and sorting (required)\n * - COLLECTION_{NAME}_GET - Get a single entity by ID (required)\n * - COLLECTION_{NAME}_CREATE - Create a new entity (optional, excluded if readOnly=true)\n * - COLLECTION_{NAME}_UPDATE - Update an existing entity (optional, excluded if readOnly=true)\n * - COLLECTION_{NAME}_DELETE - Delete an entity (optional, excluded if readOnly=true)\n *\n * @param collectionName - The name of the collection/table (e.g., \"users\", \"products\", \"orders\")\n * @param entitySchema - The Zod schema for the entity type (must extend BaseCollectionEntitySchema)\n * @param options - Optional configuration for the collection bindings\n * @returns Array of tool bindings for Collection CRUD + Query operations\n *\n * @example\n * ```typescript\n * const UserSchema = z.object({\n *   id: z.string(),\n *   title: z.string(),\n *   created_at: z.string().datetime(),\n *   updated_at: z.string().datetime(),\n *   created_by: z.string().optional(),\n *   updated_by: z.string().optional(),\n *   email: z.string().email(),\n * });\n *\n * // Full CRUD collection\n * const USER_COLLECTION_BINDING = createCollectionBindings(\"users\", UserSchema);\n *\n * // Read-only collection (only LIST and GET)\n * const READONLY_COLLECTION_BINDING = createCollectionBindings(\"products\", ProductSchema, { readOnly: true });\n * ```\n */\nexport function createCollectionBindings<\n  TEntitySchema extends BaseCollectionEntitySchemaType,\n>(\n  collectionName: string,\n  entitySchema: TEntitySchema,\n  options?: CollectionBindingOptions,\n) {\n  const upperName = collectionName.toUpperCase();\n  const readOnly = options?.readOnly ?? false;\n\n  const bindings: ToolBinder[] = [\n    {\n      name: `COLLECTION_${upperName}_LIST` as const,\n      inputSchema: CollectionListInputSchema,\n      outputSchema: createCollectionListOutputSchema(entitySchema),\n    },\n    {\n      name: `COLLECTION_${upperName}_GET` as const,\n      inputSchema: CollectionGetInputSchema,\n      outputSchema: createCollectionGetOutputSchema(entitySchema),\n    },\n  ];\n\n  // Only include mutation operations if not read-only\n  if (!readOnly) {\n    bindings.push(\n      {\n        name: `COLLECTION_${upperName}_CREATE` as const,\n        inputSchema: createCollectionInsertInputSchema(entitySchema),\n        outputSchema: createCollectionInsertOutputSchema(entitySchema),\n        opt: true,\n      },\n      {\n        name: `COLLECTION_${upperName}_UPDATE` as const,\n        inputSchema: createCollectionUpdateInputSchema(entitySchema),\n        outputSchema: createCollectionUpdateOutputSchema(entitySchema),\n        opt: true,\n      },\n      {\n        name: `COLLECTION_${upperName}_DELETE` as const,\n        inputSchema: CollectionDeleteInputSchema,\n        outputSchema: createCollectionDeleteOutputSchema(entitySchema),\n        opt: true,\n      },\n    );\n  }\n\n  return bindings satisfies readonly ToolBinder[];\n}\n\n/**\n * Type helper to extract the collection binding type\n */\nexport type CollectionBinding<\n  TEntitySchema extends BaseCollectionEntitySchemaType,\n> = ReturnType<typeof createCollectionBindings<TEntitySchema>>;\n\n/**\n * Type helper to extract tool names from a collection binding\n */\nexport type CollectionTools<\n  TEntitySchema extends BaseCollectionEntitySchemaType,\n> = CollectionBinding<TEntitySchema>[number][\"name\"];\n\n// Export types for TypeScript usage\nexport type CollectionListInput = z.infer<typeof CollectionListInputSchema>;\nexport type CollectionGetInput = z.infer<typeof CollectionGetInputSchema>;\nexport type CollectionDeleteInput = z.infer<typeof CollectionDeleteInputSchema>;\nexport type OrderByExpression = z.infer<typeof OrderByExpressionSchema>;\n\n/**\n * Type helper for list output with generic item type\n */\nexport type CollectionListOutput<T> = {\n  items: T[];\n  totalCount?: number;\n  hasMore?: boolean;\n};\n\n/**\n * Type helper for get output with generic item type\n */\nexport type CollectionGetOutput<T> = {\n  item: T | null;\n};\n\n/**\n * Type helper for insert output with generic item type\n */\nexport type CollectionInsertOutput<T> = {\n  item: T;\n};\n\n/**\n * Type helper for update output with generic item type\n */\nexport type CollectionUpdateOutput<T> = {\n  item: T;\n};\n\n/**\n * Type helper for delete output with generic item type\n */\nexport type CollectionDeleteOutput<T> = {\n  item: T;\n};\n\n/**\n * Base collection entity type - inferred from BaseCollectionEntitySchema\n */\nexport type BaseCollectionEntity = z.infer<typeof BaseCollectionEntitySchema>;\n"]}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/binder.ts"],"names":["jsonSchema"],"mappings":"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","file":"index.js","sourcesContent":["/**\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 type { ZodType } from \"zod\";\nimport { zodToJsonSchema } from \"zod-to-json-schema\";\nimport { diffSchemas } from \"json-schema-diff\";\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  TInput = any,\n  TReturn extends object | null | boolean = object,\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?: ZodType<TReturn>;\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  inputSchema?: ZodType<any> | Record<string, unknown>;\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 */\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\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 = 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/core/binder.ts"],"names":["jsonSchema"],"mappings":"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","file":"index.js","sourcesContent":["/**\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 type { ZodType } from \"zod\";\nimport { zodToJsonSchema } from \"zod-to-json-schema\";\nimport { diffSchemas } from \"json-schema-diff\";\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> {\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?: ZodType<TReturn>;\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\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"]}

package/dist/well-known/collections.d.ts

@@ -9,7 +9,7 @@ import { ToolBinder } from '../index.js';
  *
  * Key Features:
  * - Generic collection bindings that work with any entity type
- * - Standardized tool naming: `DECO_COLLECTION_{COLLECTION}_*`
+ * - Standardized tool naming: `COLLECTION_{COLLECTION}_*`
  * - Compatible with TanStack DB query-collection
  * - Full TypeScript support with proper type constraints
  * - Support for filtering, sorting, and pagination
@@ -315,18 +315,15 @@ declare const CollectionDeleteInputSchema: z.ZodObject<{
     id: string;
 }>;
 /**
- * Delete output schema
+ * Factory function to create delete output schema
  */
-declare const CollectionDeleteOutputSchema: z.ZodObject<{
-    success: z.ZodBoolean;
-    id: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    id: string;
-    success: boolean;
-}, {
-    id: string;
-    success: boolean;
-}>;
+declare function createCollectionDeleteOutputSchema<T extends z.ZodTypeAny>(entitySchema: T): z.ZodObject<{
+    item: T;
+}, "strip", z.ZodTypeAny, z.objectUtil.addQuestionMarks<z.baseObjectOutputType<{
+    item: T;
+}>, any> extends infer T_1 ? { [k in keyof T_1]: T_1[k]; } : never, z.baseObjectInputType<{
+    item: T;
+}> extends infer T_2 ? { [k_1 in keyof T_2]: T_2[k_1]; } : never>;
 /**
  * Options for creating collection bindings
  */
@@ -342,11 +339,11 @@ interface CollectionBindingOptions {
  *
  * This function generates standardized tool bindings that work with any collection/table
  * by accepting a custom entity schema and collection name. The bindings provide:
- * - DECO_COLLECTION_{NAME}_LIST - Query/search entities with filtering and sorting (required)
- * - DECO_COLLECTION_{NAME}_GET - Get a single entity by ID (required)
- * - DECO_COLLECTION_{NAME}_INSERT - Create a new entity (optional, excluded if readOnly=true)
- * - DECO_COLLECTION_{NAME}_UPDATE - Update an existing entity (optional, excluded if readOnly=true)
- * - DECO_COLLECTION_{NAME}_DELETE - Delete an entity (optional, excluded if readOnly=true)
+ * - COLLECTION_{NAME}_LIST - Query/search entities with filtering and sorting (required)
+ * - COLLECTION_{NAME}_GET - Get a single entity by ID (required)
+ * - COLLECTION_{NAME}_CREATE - Create a new entity (optional, excluded if readOnly=true)
+ * - COLLECTION_{NAME}_UPDATE - Update an existing entity (optional, excluded if readOnly=true)
+ * - COLLECTION_{NAME}_DELETE - Delete an entity (optional, excluded if readOnly=true)
  *
  * @param collectionName - The name of the collection/table (e.g., "users", "products", "orders")
  * @param entitySchema - The Zod schema for the entity type (must extend BaseCollectionEntitySchema)
@@ -384,7 +381,42 @@ type CollectionTools<TEntitySchema extends BaseCollectionEntitySchemaType> = Col
 type CollectionListInput = z.infer<typeof CollectionListInputSchema>;
 type CollectionGetInput = z.infer<typeof CollectionGetInputSchema>;
 type CollectionDeleteInput = z.infer<typeof CollectionDeleteInputSchema>;
-type CollectionDeleteOutput = z.infer<typeof CollectionDeleteOutputSchema>;
 type OrderByExpression = z.infer<typeof OrderByExpressionSchema>;
+/**
+ * Type helper for list output with generic item type
+ */
+type CollectionListOutput<T> = {
+    items: T[];
+    totalCount?: number;
+    hasMore?: boolean;
+};
+/**
+ * Type helper for get output with generic item type
+ */
+type CollectionGetOutput<T> = {
+    item: T | null;
+};
+/**
+ * Type helper for insert output with generic item type
+ */
+type CollectionInsertOutput<T> = {
+    item: T;
+};
+/**
+ * Type helper for update output with generic item type
+ */
+type CollectionUpdateOutput<T> = {
+    item: T;
+};
+/**
+ * Type helper for delete output with generic item type
+ */
+type CollectionDeleteOutput<T> = {
+    item: T;
+};
+/**
+ * Base collection entity type - inferred from BaseCollectionEntitySchema
+ */
+type BaseCollectionEntity = z.infer<typeof BaseCollectionEntitySchema>;
 
-export { BaseCollectionEntitySchema, type BaseCollectionEntitySchemaType, type CollectionBinding, type CollectionBindingOptions, type CollectionDeleteInput, CollectionDeleteInputSchema, type CollectionDeleteOutput, CollectionDeleteOutputSchema, type CollectionGetInput, CollectionGetInputSchema, type CollectionListInput, CollectionListInputSchema, type CollectionTools, type OrderByExpression, OrderByExpressionSchema, type WhereExpression, WhereExpressionSchema, createCollectionBindings, createCollectionGetOutputSchema, createCollectionInsertInputSchema, createCollectionInsertOutputSchema, createCollectionListOutputSchema, createCollectionUpdateInputSchema, createCollectionUpdateOutputSchema };
+export { type BaseCollectionEntity, BaseCollectionEntitySchema, type BaseCollectionEntitySchemaType, type CollectionBinding, type CollectionBindingOptions, type CollectionDeleteInput, CollectionDeleteInputSchema, type CollectionDeleteOutput, type CollectionGetInput, CollectionGetInputSchema, type CollectionGetOutput, type CollectionInsertOutput, type CollectionListInput, CollectionListInputSchema, type CollectionListOutput, type CollectionTools, type CollectionUpdateOutput, type OrderByExpression, OrderByExpressionSchema, type WhereExpression, WhereExpressionSchema, createCollectionBindings, createCollectionDeleteOutputSchema, createCollectionGetOutputSchema, createCollectionInsertInputSchema, createCollectionInsertOutputSchema, createCollectionListOutputSchema, createCollectionUpdateInputSchema, createCollectionUpdateOutputSchema };

package/dist/well-known/collections.js

@@ -1,3 +1,3 @@
-export { BaseCollectionEntitySchema, CollectionDeleteInputSchema, CollectionDeleteOutputSchema, CollectionGetInputSchema, CollectionListInputSchema, OrderByExpressionSchema, WhereExpressionSchema, createCollectionBindings, createCollectionGetOutputSchema, createCollectionInsertInputSchema, createCollectionInsertOutputSchema, createCollectionListOutputSchema, createCollectionUpdateInputSchema, createCollectionUpdateOutputSchema } from '../chunk-L7E6ONLJ.js';
+export { BaseCollectionEntitySchema, CollectionDeleteInputSchema, CollectionGetInputSchema, CollectionListInputSchema, OrderByExpressionSchema, WhereExpressionSchema, createCollectionBindings, createCollectionDeleteOutputSchema, createCollectionGetOutputSchema, createCollectionInsertInputSchema, createCollectionInsertOutputSchema, createCollectionListOutputSchema, createCollectionUpdateInputSchema, createCollectionUpdateOutputSchema } from '../chunk-JMM4EZYL.js';
 //# sourceMappingURL=collections.js.map
 //# sourceMappingURL=collections.js.map

package/dist/well-known/models.d.ts

@@ -119,8 +119,8 @@ declare const MODELS_COLLECTION_BINDING: ToolBinder<string, any, object>[];
  * Any MCP that implements this binding can provide AI models and streaming endpoints.
  *
  * Required tools:
- * - DECO_COLLECTION_MODELS_LIST: List available AI models with their capabilities
- * - DECO_COLLECTION_MODELS_GET: Get a single model by ID (includes streaming endpoint info)
+ * - COLLECTION_MODELS_LIST: List available AI models with their capabilities
+ * - COLLECTION_MODELS_GET: Get a single model by ID (includes streaming endpoint info)
  */
 declare const MODELS_BINDING: readonly ToolBinder<string, any, object>[];
 

package/dist/well-known/models.js

@@ -1,4 +1,4 @@
-import { BaseCollectionEntitySchema, createCollectionBindings } from '../chunk-L7E6ONLJ.js';
+import { BaseCollectionEntitySchema, createCollectionBindings } from '../chunk-JMM4EZYL.js';
 import { z } from 'zod';
 
 var ModelSchema = BaseCollectionEntitySchema.extend({

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

@@ -1 +1 @@
-{"version":3,"sources":["../../src/well-known/models.ts"],"names":[],"mappings":";;;AAsBO,IAAM,WAAA,GAAc,2BAA2B,MAAA,CAAO;AAAA;AAAA,EAE3D,IAAA,EAAM,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC1B,WAAA,EAAa,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EACjC,YAAA,EAAc,CAAA,CAAE,KAAA,CAAM,CAAA,CAAE,QAAQ,CAAA;AAAA,EAChC,MAAA,EAAQ,EAAE,MAAA,CAAO;AAAA,IACf,aAAA,EAAe,EAAE,MAAA,EAAO;AAAA,IACxB,eAAA,EAAiB,EAAE,MAAA;AAAO,GAC3B,EAAE,QAAA,EAAS;AAAA,EACZ,KAAA,EAAO,EAAE,MAAA,CAAO;AAAA,IACd,KAAA,EAAO,EAAE,MAAA,EAAO;AAAA,IAChB,MAAA,EAAQ,EAAE,MAAA;AAAO,GAClB,EAAE,QAAA,EAAS;AAAA;AAAA,EAEZ,QAAA,EAAU,EAAE,IAAA,CAAK;AAAA,IACf,QAAA;AAAA,IACA,WAAA;AAAA,IACA,QAAA;AAAA,IACA,KAAA;AAAA,IACA,UAAA;AAAA,IACA,mBAAA;AAAA,IACA;AAAA,GACD,EAAE,QAAA,EAAS;AAAA;AAAA,EAEZ,QAAA,EAAU,EAAE,MAAA,CAAO;AAAA,IACjB,GAAA,EAAK,CAAA,CAAE,MAAA,EAAO,CAAE,GAAA,EAAI;AAAA,IACpB,MAAA,EAAQ,CAAA,CAAE,MAAA,EAAO,CAAE,QAAQ,MAAM,CAAA;AAAA,IACjC,WAAA,EAAa,CAAA,CAAE,MAAA,EAAO,CAAE,QAAQ,kBAAkB,CAAA;AAAA,IAClD,MAAA,EAAQ,CAAA,CAAE,OAAA,EAAQ,CAAE,QAAQ,IAAI;AAAA,GACjC,EAAE,QAAA;AACL,CAAC;AAQM,IAAM,yBAAA,GAA4B,wBAAA;AAAA,EACvC,QAAA;AAAA,EACA,WAAA;AAAA,EACA,EAAE,UAAU,IAAA;AACd;AAYO,IAAM,cAAA,GAAiB;AAAA,EAC5B,GAAG;AACL","file":"models.js","sourcesContent":["/**\n * Models 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 uses 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 type { Binder } from \"../core/binder\";\nimport {\n  BaseCollectionEntitySchema,\n  createCollectionBindings,\n} from \"./collections\";\n\n/**\n * Model entity schema for AI models\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 ModelSchema = 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.object({\n    contextWindow: z.number(),\n    maxOutputTokens: z.number(),\n  }).nullable(),\n  costs: z.object({\n    input: z.number(),\n    output: z.number(),\n  }).nullable(),\n  // Provider information\n  provider: z.enum([\n    \"openai\",\n    \"anthropic\",\n    \"google\",\n    \"xai\",\n    \"deepseek\",\n    \"openai-compatible\",\n    \"openrouter\",\n  ]).nullable(),\n  // Streaming endpoint information\n  endpoint: z.object({\n    url: z.string().url(),\n    method: z.string().default(\"POST\"),\n    contentType: z.string().default(\"application/json\"),\n    stream: z.boolean().default(true),\n  }).nullable(),\n});\n\n/**\n * MODELS Collection Binding\n *\n * Collection bindings for models (read-only).\n * Provides LIST and GET operations for AI models.\n */\nexport const MODELS_COLLECTION_BINDING = createCollectionBindings(\n  \"models\",\n  ModelSchema,\n  { readOnly: true },\n);\n\n/**\n * MODELS 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 * Required tools:\n * - DECO_COLLECTION_MODELS_LIST: List available AI models with their capabilities\n * - DECO_COLLECTION_MODELS_GET: Get a single model by ID (includes streaming endpoint info)\n */\nexport const MODELS_BINDING = [\n  ...MODELS_COLLECTION_BINDING,\n] as const satisfies Binder;\n"]}
+{"version":3,"sources":["../../src/well-known/models.ts"],"names":[],"mappings":";;;AAsBO,IAAM,WAAA,GAAc,2BAA2B,MAAA,CAAO;AAAA;AAAA,EAE3D,IAAA,EAAM,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC1B,WAAA,EAAa,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EACjC,YAAA,EAAc,CAAA,CAAE,KAAA,CAAM,CAAA,CAAE,QAAQ,CAAA;AAAA,EAChC,MAAA,EAAQ,EACL,MAAA,CAAO;AAAA,IACN,aAAA,EAAe,EAAE,MAAA,EAAO;AAAA,IACxB,eAAA,EAAiB,EAAE,MAAA;AAAO,GAC3B,EACA,QAAA,EAAS;AAAA,EACZ,KAAA,EAAO,EACJ,MAAA,CAAO;AAAA,IACN,KAAA,EAAO,EAAE,MAAA,EAAO;AAAA,IAChB,MAAA,EAAQ,EAAE,MAAA;AAAO,GAClB,EACA,QAAA,EAAS;AAAA;AAAA,EAEZ,QAAA,EAAU,EACP,IAAA,CAAK;AAAA,IACJ,QAAA;AAAA,IACA,WAAA;AAAA,IACA,QAAA;AAAA,IACA,KAAA;AAAA,IACA,UAAA;AAAA,IACA,mBAAA;AAAA,IACA;AAAA,GACD,EACA,QAAA,EAAS;AAAA;AAAA,EAEZ,QAAA,EAAU,EACP,MAAA,CAAO;AAAA,IACN,GAAA,EAAK,CAAA,CAAE,MAAA,EAAO,CAAE,GAAA,EAAI;AAAA,IACpB,MAAA,EAAQ,CAAA,CAAE,MAAA,EAAO,CAAE,QAAQ,MAAM,CAAA;AAAA,IACjC,WAAA,EAAa,CAAA,CAAE,MAAA,EAAO,CAAE,QAAQ,kBAAkB,CAAA;AAAA,IAClD,MAAA,EAAQ,CAAA,CAAE,OAAA,EAAQ,CAAE,QAAQ,IAAI;AAAA,GACjC,EACA,QAAA;AACL,CAAC;AAQM,IAAM,yBAAA,GAA4B,wBAAA;AAAA,EACvC,QAAA;AAAA,EACA,WAAA;AAAA,EACA,EAAE,UAAU,IAAA;AACd;AAYO,IAAM,cAAA,GAAiB;AAAA,EAC5B,GAAG;AACL","file":"models.js","sourcesContent":["/**\n * Models 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 uses 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 type { Binder } from \"../core/binder\";\nimport {\n  BaseCollectionEntitySchema,\n  createCollectionBindings,\n} from \"./collections\";\n\n/**\n * Model entity schema for AI models\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 ModelSchema = 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  // Streaming endpoint information\n  endpoint: z\n    .object({\n      url: z.string().url(),\n      method: z.string().default(\"POST\"),\n      contentType: z.string().default(\"application/json\"),\n      stream: z.boolean().default(true),\n    })\n    .nullable(),\n});\n\n/**\n * MODELS Collection Binding\n *\n * Collection bindings for models (read-only).\n * Provides LIST and GET operations for AI models.\n */\nexport const MODELS_COLLECTION_BINDING = createCollectionBindings(\n  \"models\",\n  ModelSchema,\n  { readOnly: true },\n);\n\n/**\n * MODELS 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 * Required tools:\n * - COLLECTION_MODELS_LIST: List available AI models with their capabilities\n * - COLLECTION_MODELS_GET: Get a single model by ID (includes streaming endpoint info)\n */\nexport const MODELS_BINDING = [\n  ...MODELS_COLLECTION_BINDING,\n] as const satisfies Binder;\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decocms/bindings",
-  "version": "0.1.6",
+  "version": "0.2.0",
   "type": "module",
   "scripts": {
     "build": "tsup",
@@ -14,7 +14,7 @@
     "zod-to-json-schema": "^3.24.4"
   },
   "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "types": "./src/index.ts",
   "files": [
     "dist/**/*",
     "src/**/*"
@@ -22,17 +22,17 @@
   "exports": {
     ".": {
       "source": "./src/index.ts",
-      "types": "./dist/index.d.ts",
+      "types": "./src/index.ts",
       "default": "./dist/index.js"
     },
     "./models": {
       "source": "./src/well-known/models.ts",
-      "types": "./dist/well-known/models.d.ts",
+      "types": "./src/well-known/models.ts",
       "default": "./dist/well-known/models.js"
     },
     "./collections": {
       "source": "./src/well-known/collections.ts",
-      "types": "./dist/well-known/collections.d.ts",
+      "types": "./src/well-known/collections.ts",
       "default": "./dist/well-known/collections.js"
     }
   },
@@ -48,4 +48,3 @@
     "access": "public"
   }
 }
-

package/src/core/binder.ts

@@ -20,6 +20,7 @@ import { diffSchemas } from "json-schema-diff";
 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,
 > {
@@ -63,13 +64,16 @@ export type Binder<
  */
 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;
 
@@ -142,9 +146,10 @@ export function createBindingChecker<TDefinition extends readonly ToolBinder[]>(
     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 pattern =
+          typeof binderTool.name === "string"
+            ? new RegExp(`^${binderTool.name}$`)
+            : binderTool.name;
 
         const matchedTool = tools.find((t) => pattern.test(t.name));
 

package/src/index.ts

@@ -13,4 +13,3 @@ export {
   type BindingChecker,
   createBindingChecker,
 } from "./core/binder";
-

package/src/well-known/collections.ts

@@ -9,7 +9,7 @@ import type { ToolBinder } from "../core/binder";
  *
  * Key Features:
  * - Generic collection bindings that work with any entity type
- * - Standardized tool naming: `DECO_COLLECTION_{COLLECTION}_*`
+ * - Standardized tool naming: `COLLECTION_{COLLECTION}_*`
  * - Compatible with TanStack DB query-collection
  * - Full TypeScript support with proper type constraints
  * - Support for filtering, sorting, and pagination
@@ -39,16 +39,7 @@ export type BaseCollectionEntitySchemaType = typeof BaseCollectionEntitySchema;
  */
 const ComparisonExpressionSchema = z.object({
   field: z.array(z.string()),
-  operator: z.enum([
-    "eq",
-    "gt",
-    "gte",
-    "lt",
-    "lte",
-    "in",
-    "like",
-    "contains",
-  ]),
+  operator: z.enum(["eq", "gt", "gte", "lt", "lte", "in", "like", "contains"]),
   value: z.unknown(),
 });
 
@@ -153,7 +144,9 @@ export function createCollectionInsertInputSchema<T extends z.ZodTypeAny>(
 ) {
   // Remove id field since it may be auto-generated by the server
   return z.object({
-    data: entitySchema.describe("Data for the new entity (id may be auto-generated)"),
+    data: entitySchema.describe(
+      "Data for the new entity (id may be auto-generated)",
+    ),
   });
 }
 
@@ -201,12 +194,15 @@ export const CollectionDeleteInputSchema = z.object({
 });
 
 /**
- * Delete output schema
+ * Factory function to create delete output schema
  */
-export const CollectionDeleteOutputSchema = z.object({
-  success: z.boolean().describe("Whether the deletion was successful"),
-  id: z.string().describe("ID of the deleted entity"),
-});
+export function createCollectionDeleteOutputSchema<T extends z.ZodTypeAny>(
+  entitySchema: T,
+) {
+  return z.object({
+    item: entitySchema.describe("The deleted entity"),
+  });
+}
 
 /**
  * Options for creating collection bindings
@@ -224,11 +220,11 @@ export interface CollectionBindingOptions {
  *
  * This function generates standardized tool bindings that work with any collection/table
  * by accepting a custom entity schema and collection name. The bindings provide:
- * - DECO_COLLECTION_{NAME}_LIST - Query/search entities with filtering and sorting (required)
- * - DECO_COLLECTION_{NAME}_GET - Get a single entity by ID (required)
- * - DECO_COLLECTION_{NAME}_INSERT - Create a new entity (optional, excluded if readOnly=true)
- * - DECO_COLLECTION_{NAME}_UPDATE - Update an existing entity (optional, excluded if readOnly=true)
- * - DECO_COLLECTION_{NAME}_DELETE - Delete an entity (optional, excluded if readOnly=true)
+ * - COLLECTION_{NAME}_LIST - Query/search entities with filtering and sorting (required)
+ * - COLLECTION_{NAME}_GET - Get a single entity by ID (required)
+ * - COLLECTION_{NAME}_CREATE - Create a new entity (optional, excluded if readOnly=true)
+ * - COLLECTION_{NAME}_UPDATE - Update an existing entity (optional, excluded if readOnly=true)
+ * - COLLECTION_{NAME}_DELETE - Delete an entity (optional, excluded if readOnly=true)
  *
  * @param collectionName - The name of the collection/table (e.g., "users", "products", "orders")
  * @param entitySchema - The Zod schema for the entity type (must extend BaseCollectionEntitySchema)
@@ -266,12 +262,12 @@ export function createCollectionBindings<
 
   const bindings: ToolBinder[] = [
     {
-      name: `DECO_COLLECTION_${upperName}_LIST` as const,
+      name: `COLLECTION_${upperName}_LIST` as const,
       inputSchema: CollectionListInputSchema,
       outputSchema: createCollectionListOutputSchema(entitySchema),
     },
     {
-      name: `DECO_COLLECTION_${upperName}_GET` as const,
+      name: `COLLECTION_${upperName}_GET` as const,
       inputSchema: CollectionGetInputSchema,
       outputSchema: createCollectionGetOutputSchema(entitySchema),
     },
@@ -281,21 +277,21 @@ export function createCollectionBindings<
   if (!readOnly) {
     bindings.push(
       {
-        name: `DECO_COLLECTION_${upperName}_INSERT` as const,
+        name: `COLLECTION_${upperName}_CREATE` as const,
         inputSchema: createCollectionInsertInputSchema(entitySchema),
         outputSchema: createCollectionInsertOutputSchema(entitySchema),
         opt: true,
       },
       {
-        name: `DECO_COLLECTION_${upperName}_UPDATE` as const,
+        name: `COLLECTION_${upperName}_UPDATE` as const,
         inputSchema: createCollectionUpdateInputSchema(entitySchema),
         outputSchema: createCollectionUpdateOutputSchema(entitySchema),
         opt: true,
       },
       {
-        name: `DECO_COLLECTION_${upperName}_DELETE` as const,
+        name: `COLLECTION_${upperName}_DELETE` as const,
         inputSchema: CollectionDeleteInputSchema,
-        outputSchema: CollectionDeleteOutputSchema,
+        outputSchema: createCollectionDeleteOutputSchema(entitySchema),
         opt: true,
       },
     );
@@ -322,7 +318,46 @@ export type CollectionTools<
 export type CollectionListInput = z.infer<typeof CollectionListInputSchema>;
 export type CollectionGetInput = z.infer<typeof CollectionGetInputSchema>;
 export type CollectionDeleteInput = z.infer<typeof CollectionDeleteInputSchema>;
-export type CollectionDeleteOutput = z.infer<
-  typeof CollectionDeleteOutputSchema
->;
 export type OrderByExpression = z.infer<typeof OrderByExpressionSchema>;
+
+/**
+ * Type helper for list output with generic item type
+ */
+export type CollectionListOutput<T> = {
+  items: T[];
+  totalCount?: number;
+  hasMore?: boolean;
+};
+
+/**
+ * Type helper for get output with generic item type
+ */
+export type CollectionGetOutput<T> = {
+  item: T | null;
+};
+
+/**
+ * Type helper for insert output with generic item type
+ */
+export type CollectionInsertOutput<T> = {
+  item: T;
+};
+
+/**
+ * Type helper for update output with generic item type
+ */
+export type CollectionUpdateOutput<T> = {
+  item: T;
+};
+
+/**
+ * Type helper for delete output with generic item type
+ */
+export type CollectionDeleteOutput<T> = {
+  item: T;
+};
+
+/**
+ * Base collection entity type - inferred from BaseCollectionEntitySchema
+ */
+export type BaseCollectionEntity = z.infer<typeof BaseCollectionEntitySchema>;

package/src/well-known/models.ts

@@ -25,31 +25,39 @@ export const ModelSchema = BaseCollectionEntitySchema.extend({
   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(),
+  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(),
+  provider: z
+    .enum([
+      "openai",
+      "anthropic",
+      "google",
+      "xai",
+      "deepseek",
+      "openai-compatible",
+      "openrouter",
+    ])
+    .nullable(),
   // Streaming endpoint information
-  endpoint: z.object({
-    url: z.string().url(),
-    method: z.string().default("POST"),
-    contentType: z.string().default("application/json"),
-    stream: z.boolean().default(true),
-  }).nullable(),
+  endpoint: z
+    .object({
+      url: z.string().url(),
+      method: z.string().default("POST"),
+      contentType: z.string().default("application/json"),
+      stream: z.boolean().default(true),
+    })
+    .nullable(),
 });
 
 /**
@@ -71,8 +79,8 @@ export const MODELS_COLLECTION_BINDING = createCollectionBindings(
  * Any MCP that implements this binding can provide AI models and streaming endpoints.
  *
  * Required tools:
- * - DECO_COLLECTION_MODELS_LIST: List available AI models with their capabilities
- * - DECO_COLLECTION_MODELS_GET: Get a single model by ID (includes streaming endpoint info)
+ * - COLLECTION_MODELS_LIST: List available AI models with their capabilities
+ * - COLLECTION_MODELS_GET: Get a single model by ID (includes streaming endpoint info)
  */
 export const MODELS_BINDING = [
   ...MODELS_COLLECTION_BINDING,

package/dist/chunk-L7E6ONLJ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/well-known/collections.ts"],"names":[],"mappings":"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","file":"chunk-L7E6ONLJ.js","sourcesContent":["import { z } from \"zod\";\nimport type { ToolBinder } from \"../core/binder\";\n\n/**\n * Collection Bindings\n *\n * This module provides standardized tool bindings for Collections, representing\n * SQL table-like structures with CRUD + Search operations compatible with TanStack DB.\n *\n * Key Features:\n * - Generic collection bindings that work with any entity type\n * - Standardized tool naming: `DECO_COLLECTION_{COLLECTION}_*`\n * - Compatible with TanStack DB query-collection\n * - Full TypeScript support with proper type constraints\n * - Support for filtering, sorting, and pagination\n * - Simple id and title fields for human-readable identification\n */\n\n/**\n * Base schema for collection entities\n * All collection entities must have an id, title, and audit trail fields\n */\nexport const BaseCollectionEntitySchema = z.object({\n  id: z.string().describe(\"Unique identifier for the entity\"),\n  title: z.string().describe(\"Human-readable title for the entity\"),\n  created_at: z.string().datetime(),\n  updated_at: z.string().datetime(),\n  created_by: z.string().optional(),\n  updated_by: z.string().optional(),\n});\n\n/**\n * Type helper for BaseCollectionEntitySchema\n */\nexport type BaseCollectionEntitySchemaType = typeof BaseCollectionEntitySchema;\n\n/**\n * Comparison expression schema for filtering\n */\nconst ComparisonExpressionSchema = z.object({\n  field: z.array(z.string()),\n  operator: z.enum([\n    \"eq\",\n    \"gt\",\n    \"gte\",\n    \"lt\",\n    \"lte\",\n    \"in\",\n    \"like\",\n    \"contains\",\n  ]),\n  value: z.unknown(),\n});\n\n/**\n * Where expression schema for filtering\n * Supports TanStack DB predicate push-down patterns\n */\nexport const WhereExpressionSchema = z.union([\n  ComparisonExpressionSchema,\n  z.object({\n    operator: z.enum([\"and\", \"or\", \"not\"]),\n    conditions: z.array(ComparisonExpressionSchema),\n  }),\n]);\n\n/**\n * Where expression type for filtering\n * Derived from WhereExpressionSchema\n */\nexport type WhereExpression = z.infer<typeof WhereExpressionSchema>;\n\n/**\n * Order by expression for sorting\n */\nexport const OrderByExpressionSchema = z.object({\n  field: z.array(z.string()),\n  direction: z.enum([\"asc\", \"desc\"]),\n  nulls: z.enum([\"first\", \"last\"]).optional(),\n});\n\n/**\n * List/Query input schema for collections\n * Compatible with TanStack DB LoadSubsetOptions\n */\nexport const CollectionListInputSchema = z.object({\n  where: WhereExpressionSchema.optional().describe(\"Filter expression\"),\n  orderBy: z\n    .array(OrderByExpressionSchema)\n    .optional()\n    .describe(\"Sort expressions\"),\n  limit: z\n    .number()\n    .int()\n    .min(1)\n    .max(1000)\n    .optional()\n    .describe(\"Maximum number of items to return\"),\n  offset: z\n    .number()\n    .int()\n    .min(0)\n    .optional()\n    .describe(\"Number of items to skip\"),\n});\n\n/**\n * Factory function to create list output schema for a specific collection type\n */\nexport function createCollectionListOutputSchema<T extends z.ZodTypeAny>(\n  entitySchema: T,\n) {\n  return z.object({\n    items: z.array(entitySchema).describe(\"Array of collection items\"),\n    totalCount: z\n      .number()\n      .int()\n      .min(0)\n      .optional()\n      .describe(\"Total number of matching items (if available)\"),\n    hasMore: z\n      .boolean()\n      .optional()\n      .describe(\"Whether there are more items available\"),\n  });\n}\n\n/**\n * Get by ID input schema\n */\nexport const CollectionGetInputSchema = z.object({\n  id: z.string().describe(\"ID of the entity to retrieve\"),\n});\n\n/**\n * Factory function to create get output schema\n */\nexport function createCollectionGetOutputSchema<T extends z.ZodTypeAny>(\n  entitySchema: T,\n) {\n  return z.object({\n    item: entitySchema\n      .nullable()\n      .describe(\"The retrieved item, or null if not found\"),\n  });\n}\n\n/**\n * Factory function to create insert input schema\n */\nexport function createCollectionInsertInputSchema<T extends z.ZodTypeAny>(\n  entitySchema: T,\n) {\n  // Remove id field since it may be auto-generated by the server\n  return z.object({\n    data: entitySchema.describe(\"Data for the new entity (id may be auto-generated)\"),\n  });\n}\n\n/**\n * Factory function to create insert output schema\n */\nexport function createCollectionInsertOutputSchema<T extends z.ZodTypeAny>(\n  entitySchema: T,\n) {\n  return z.object({\n    item: entitySchema.describe(\"The created entity with generated id\"),\n  });\n}\n\n/**\n * Factory function to create update input schema\n */\nexport function createCollectionUpdateInputSchema<T extends z.ZodTypeAny>(\n  entitySchema: T,\n) {\n  return z.object({\n    id: z.string().describe(\"ID of the entity to update\"),\n    data: (entitySchema as unknown as z.AnyZodObject)\n      .partial()\n      .describe(\"Partial entity data to update\"),\n  });\n}\n\n/**\n * Factory function to create update output schema\n */\nexport function createCollectionUpdateOutputSchema<T extends z.ZodTypeAny>(\n  entitySchema: T,\n) {\n  return z.object({\n    item: entitySchema.describe(\"The updated entity\"),\n  });\n}\n\n/**\n * Delete input schema\n */\nexport const CollectionDeleteInputSchema = z.object({\n  id: z.string().describe(\"ID of the entity to delete\"),\n});\n\n/**\n * Delete output schema\n */\nexport const CollectionDeleteOutputSchema = z.object({\n  success: z.boolean().describe(\"Whether the deletion was successful\"),\n  id: z.string().describe(\"ID of the deleted entity\"),\n});\n\n/**\n * Options for creating collection bindings\n */\nexport interface CollectionBindingOptions {\n  /**\n   * If true, only LIST and GET operations will be included (read-only collection)\n   * @default false\n   */\n  readOnly?: boolean;\n}\n\n/**\n * Creates generic collection bindings for a specific entity type\n *\n * This function generates standardized tool bindings that work with any collection/table\n * by accepting a custom entity schema and collection name. The bindings provide:\n * - DECO_COLLECTION_{NAME}_LIST - Query/search entities with filtering and sorting (required)\n * - DECO_COLLECTION_{NAME}_GET - Get a single entity by ID (required)\n * - DECO_COLLECTION_{NAME}_INSERT - Create a new entity (optional, excluded if readOnly=true)\n * - DECO_COLLECTION_{NAME}_UPDATE - Update an existing entity (optional, excluded if readOnly=true)\n * - DECO_COLLECTION_{NAME}_DELETE - Delete an entity (optional, excluded if readOnly=true)\n *\n * @param collectionName - The name of the collection/table (e.g., \"users\", \"products\", \"orders\")\n * @param entitySchema - The Zod schema for the entity type (must extend BaseCollectionEntitySchema)\n * @param options - Optional configuration for the collection bindings\n * @returns Array of tool bindings for Collection CRUD + Query operations\n *\n * @example\n * ```typescript\n * const UserSchema = z.object({\n *   id: z.string(),\n *   title: z.string(),\n *   created_at: z.string().datetime(),\n *   updated_at: z.string().datetime(),\n *   created_by: z.string().optional(),\n *   updated_by: z.string().optional(),\n *   email: z.string().email(),\n * });\n *\n * // Full CRUD collection\n * const USER_COLLECTION_BINDING = createCollectionBindings(\"users\", UserSchema);\n *\n * // Read-only collection (only LIST and GET)\n * const READONLY_COLLECTION_BINDING = createCollectionBindings(\"products\", ProductSchema, { readOnly: true });\n * ```\n */\nexport function createCollectionBindings<\n  TEntitySchema extends BaseCollectionEntitySchemaType,\n>(\n  collectionName: string,\n  entitySchema: TEntitySchema,\n  options?: CollectionBindingOptions,\n) {\n  const upperName = collectionName.toUpperCase();\n  const readOnly = options?.readOnly ?? false;\n\n  const bindings: ToolBinder[] = [\n    {\n      name: `DECO_COLLECTION_${upperName}_LIST` as const,\n      inputSchema: CollectionListInputSchema,\n      outputSchema: createCollectionListOutputSchema(entitySchema),\n    },\n    {\n      name: `DECO_COLLECTION_${upperName}_GET` as const,\n      inputSchema: CollectionGetInputSchema,\n      outputSchema: createCollectionGetOutputSchema(entitySchema),\n    },\n  ];\n\n  // Only include mutation operations if not read-only\n  if (!readOnly) {\n    bindings.push(\n      {\n        name: `DECO_COLLECTION_${upperName}_INSERT` as const,\n        inputSchema: createCollectionInsertInputSchema(entitySchema),\n        outputSchema: createCollectionInsertOutputSchema(entitySchema),\n        opt: true,\n      },\n      {\n        name: `DECO_COLLECTION_${upperName}_UPDATE` as const,\n        inputSchema: createCollectionUpdateInputSchema(entitySchema),\n        outputSchema: createCollectionUpdateOutputSchema(entitySchema),\n        opt: true,\n      },\n      {\n        name: `DECO_COLLECTION_${upperName}_DELETE` as const,\n        inputSchema: CollectionDeleteInputSchema,\n        outputSchema: CollectionDeleteOutputSchema,\n        opt: true,\n      },\n    );\n  }\n\n  return bindings satisfies readonly ToolBinder[];\n}\n\n/**\n * Type helper to extract the collection binding type\n */\nexport type CollectionBinding<\n  TEntitySchema extends BaseCollectionEntitySchemaType,\n> = ReturnType<typeof createCollectionBindings<TEntitySchema>>;\n\n/**\n * Type helper to extract tool names from a collection binding\n */\nexport type CollectionTools<\n  TEntitySchema extends BaseCollectionEntitySchemaType,\n> = CollectionBinding<TEntitySchema>[number][\"name\"];\n\n// Export types for TypeScript usage\nexport type CollectionListInput = z.infer<typeof CollectionListInputSchema>;\nexport type CollectionGetInput = z.infer<typeof CollectionGetInputSchema>;\nexport type CollectionDeleteInput = z.infer<typeof CollectionDeleteInputSchema>;\nexport type CollectionDeleteOutput = z.infer<\n  typeof CollectionDeleteOutputSchema\n>;\nexport type OrderByExpression = z.infer<typeof OrderByExpressionSchema>;\n"]}