@decocms/bindings 0.1.0 → 0.1.2

package/README.md

@@ -186,8 +186,8 @@ const isValid = checker.isImplementedBy(availableTools);
 
 The package includes pre-defined bindings for common use cases. Well-known bindings are organized in the `well-known` folder and must be imported directly:
 
-- **Collections**: `@decocms/bindings/well-known/collections` - Collection bindings for SQL table-like structures
-- **Models**: `@decocms/bindings/well-known/models` - AI model providers interface
+- **Collections**: `@decocms/bindings/collections` - Collection bindings for SQL table-like structures
+- **Models**: `@decocms/bindings/models` - AI model providers interface
 
 See the [Collection Bindings](#collection-bindings) and [Models Bindings](#models-bindings) sections below for detailed usage examples.
 
@@ -216,12 +216,12 @@ const workflowBinding = createResourceBinding("workflow");
 
 ## Collection Bindings
 
-Collection bindings provide standardized CRUD + Search operations for SQL table-like collections, compatible with TanStack DB query-collection. They are designed for database tables where each entity has a unique URI and audit trail fields.
+Collection bindings provide standardized CRUD + Search operations for SQL table-like collections, compatible with TanStack DB query-collection. They are designed for database tables where each entity has a unique ID and human-readable title.
 
 ### Key Features
 
 - **SQL Table-like Structure**: Represents database tables with standardized operations
-- **URI-based Identification**: Uses collection URIs in format `rsc://{connectionid}/{collection_name}/{item_id}`
+- **Simple Identification**: Uses human-readable `id` and `title` fields
 - **Audit Trail**: All entities must include `created_at`, `updated_at`, `created_by`, and `updated_by` fields
 - **TanStack DB Compatible**: Works seamlessly with TanStack DB's query-collection LoadSubsetOptions
 - **Type-Safe**: Full TypeScript support with Zod validation
@@ -230,7 +230,8 @@ Collection bindings provide standardized CRUD + Search operations for SQL table-
 
 All collection entity schemas must extend `BaseCollectionEntitySchema`, which requires:
 
-- `uri`: Collection URI in format `rsc://{connectionid}/{collection_name}/{item_id}`
+- `id`: Unique identifier for the entity (string)
+- `title`: Human-readable title for the entity (string)
 - `created_at`: Creation timestamp (datetime string)
 - `updated_at`: Last update timestamp (datetime string)
 - `created_by`: User who created the entity (optional string)
@@ -242,18 +243,18 @@ Collection bindings are a well-known binding pattern for SQL table-like structur
 
 ```typescript
 import { z } from "zod";
-import { createCollectionBindings } from "@decocms/bindings/well-known/collections";
+import { createCollectionBindings } from "@decocms/bindings/collections";
 import { createBindingChecker } from "@decocms/bindings";
 
 // Define your entity schema extending the base schema
 const TodoSchema = z.object({
-  uri: z.string(), // Collection URI: rsc://{connectionid}/todos/{item_id}
+  id: z.string(), // Unique identifier
+  title: z.string(), // Human-readable title (from base schema)
   created_at: z.string().datetime(),
   updated_at: z.string().datetime(),
   created_by: z.string().optional(),
   updated_by: z.string().optional(),
   // Your custom fields
-  title: z.string(),
   completed: z.boolean(),
   userId: z.number(),
 });
@@ -294,26 +295,26 @@ The `createCollectionBindings` function generates tool bindings based on the `re
    - Output: `items[]`, `totalCount?`, `hasMore?`
 
 2. **GET** - `DECO_COLLECTION_{NAME}_GET`
-   - Get a single entity by URI
-   - Input: `uri`
+   - Get a single entity by ID
+   - Input: `id` (string)
    - Output: `item | null`
 
 **Optional operations (excluded if `readOnly: true`):**
 
 3. **INSERT** - `DECO_COLLECTION_{NAME}_INSERT`
    - Create a new entity
-   - Input: `data` (without uri, which is auto-generated)
-   - Output: `item` (with generated URI)
+   - Input: `data` (id may be auto-generated by the server)
+   - Output: `item` (with generated id)
 
 4. **UPDATE** - `DECO_COLLECTION_{NAME}_UPDATE`
    - Update an existing entity
-   - Input: `uri`, `data` (partial)
+   - Input: `id` (string), `data` (partial)
    - Output: `item`
 
 5. **DELETE** - `DECO_COLLECTION_{NAME}_DELETE`
    - Delete an entity
-   - Input: `uri`
-   - Output: `success`, `uri`
+   - Input: `id` (string)
+   - Output: `success` (boolean), `id` (string)
 
 ### Read-Only Collections
 
@@ -332,12 +333,12 @@ This is useful for collections that are managed externally or should not be modi
 
 ## Models Bindings
 
-Models bindings provide a well-known interface for AI model providers. They use collection bindings under the hood for LIST and GET operations, and add a streaming endpoint tool.
+Models bindings provide a well-known interface for AI model providers. They use collection bindings under the hood for LIST and GET operations, with streaming endpoint information included directly in each model entity.
 
 ### Using Models Bindings
 
 ```typescript
-import { MODELS_BINDING, MODELS_COLLECTION_BINDING } from "@decocms/bindings/well-known/models";
+import { MODELS_BINDING, MODELS_COLLECTION_BINDING } from "@decocms/bindings/models";
 import { createBindingChecker } from "@decocms/bindings";
 
 // Use the pre-defined MODELS_BINDING
@@ -347,7 +348,6 @@ const modelsChecker = createBindingChecker(MODELS_BINDING);
 const availableTools = [
   { name: "DECO_COLLECTION_MODELS_LIST" },
   { name: "DECO_COLLECTION_MODELS_GET" },
-  { name: "GET_STREAM_ENDPOINT" },
 ];
 
 const isImplemented = await modelsChecker.isImplementedBy(availableTools);
@@ -359,21 +359,16 @@ console.log(isImplemented); // true if all required tools are present
 The `MODELS_BINDING` includes:
 
 1. **DECO_COLLECTION_MODELS_LIST** (required)
-   - List available AI models with their capabilities
+   - 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)
+   - Output: `items[]` (array of model entities with endpoint info)
 
 2. **DECO_COLLECTION_MODELS_GET** (required)
-   - Get a single model by URI
+   - Get a single model by ID
    - Uses collection binding GET operation
-   - Input: `uri`
-   - Output: `item | null`
-
-3. **GET_STREAM_ENDPOINT** (required)
-   - Get the streaming endpoint URL for chat completions
-   - Input: `{}` (empty object, passthrough)
-   - Output: `{ url?: string }` (optional URL)
+   - Input: `id` (string)
+   - Output: `item | null` (model entity with endpoint info)
 
 ### Model Entity Schema
 
@@ -381,21 +376,29 @@ Models follow the collection entity schema with additional model-specific fields
 
 ```typescript
 {
-  uri: string;                    // Collection URI
-  created_at: string;            // Creation timestamp
-  updated_at: string;             // Last update timestamp
-  created_by?: string;           // User who created
-  updated_by?: string;           // User who last updated
-  id: string;                    // Model ID
-  model: string;                 // Model identifier
-  name: string;                  // Display name
-  logo: string | null;           // Logo URL
-  capabilities: string[];         // Array of capabilities
-  contextWindow: number | null;   // Context window size
-  inputCost: number | null;      // Input cost per token
-  outputCost: number | null;     // Output cost per token
-  outputLimit: number | null;    // Output limit
-  description: string | null;    // Model description
+  id: string;                      // Unique identifier (from base schema)
+  title: string;                   // Display name (from base schema)
+  created_at: string;              // Creation timestamp
+  updated_at: string;              // Last update timestamp
+  created_by?: string;             // User who created
+  updated_by?: string;             // User who last updated
+  logo: string | null;             // Logo URL
+  description: string | null;      // Model description
+  capabilities: string[];          // Array of capabilities
+  limits: {                        // Model limits
+    contextWindow: number;         // Maximum context window size
+    maxOutputTokens: number;       // Maximum output tokens
+  } | null;
+  costs: {                         // Model costs
+    input: number;                 // Cost per input token
+    output: number;                // Cost per output token
+  } | null;
+  endpoint: {                      // Streaming endpoint information
+    url: string;                   // Endpoint URL
+    method: string;                // HTTP method (default: "POST")
+    contentType: string;           // Content type (default: "application/json")
+    stream: boolean;               // Supports streaming (default: true)
+  } | null;
 }
 ```
 
@@ -404,8 +407,7 @@ Models follow the collection entity schema with additional model-specific fields
 Here's how you would implement the models binding in an MCP server:
 
 ```typescript
-import { MODELS_BINDING } from "@decocms/bindings/well-known/models";
-import { parseCollectionUri } from "@decocms/bindings/well-known/collections";
+import { MODELS_BINDING } from "@decocms/bindings/models";
 import { impl } from "@decocms/sdk/mcp/bindings/binder";
 
 const modelTools = impl(MODELS_BINDING, [
@@ -420,26 +422,19 @@ const modelTools = impl(MODELS_BINDING, [
         skip: offset,
       });
       
+      // Include endpoint info in each model
       return { items, hasMore: items.length === limit };
     },
   },
   {
-    description: "Get a model by URI",
-    handler: async ({ uri }) => {
-      const parsed = parseCollectionUri(uri);
+    description: "Get a model by ID",
+    handler: async ({ id }) => {
       const item = await db.models.findUnique({
-        where: { id: parsed.itemId },
+        where: { id },
       });
       return { item };
     },
   },
-  {
-    description: "Get streaming endpoint",
-    handler: async () => {
-      // Return your streaming endpoint URL
-      return { url: "https://api.example.com/v1/chat/completions" };
-    },
-  },
 ]);
 ```
 
@@ -487,30 +482,6 @@ The `orderBy` parameter supports multi-field sorting:
 ]
 ```
 
-### Collection URI Helpers
-
-The package provides utility functions for working with collection URIs:
-
-```typescript
-import {
-  validateCollectionUri,
-  parseCollectionUri,
-  constructCollectionUri,
-} from "@decocms/bindings/well-known/collections";
-
-// Validate a URI
-const isValid = validateCollectionUri("rsc://conn-123/users/user-456");
-// true
-
-// Parse a URI into components
-const parsed = parseCollectionUri("rsc://conn-123/users/user-456");
-// { connectionId: "conn-123", collectionName: "users", itemId: "user-456" }
-
-// Construct a URI from components
-const uri = constructCollectionUri("conn-123", "users", "user-456");
-// "rsc://conn-123/users/user-456"
-```
-
 ### TanStack DB Integration
 
 Collection bindings are designed to work with TanStack DB's query-collection. The `where` and `orderBy` expressions are compatible with TanStack DB's `LoadSubsetOptions`, allowing for efficient predicate push-down to your backend.
@@ -521,17 +492,16 @@ Here's how you would implement a collection binding in an MCP server:
 
 ```typescript
 import { z } from "zod";
-import { createCollectionBindings } from "@decocms/bindings/well-known/collections";
-import { parseCollectionUri, constructCollectionUri } from "@decocms/bindings/well-known/collections";
+import { createCollectionBindings } from "@decocms/bindings/collections";
 import { impl } from "@decocms/sdk/mcp/bindings/binder";
 
 const TodoSchema = z.object({
-  uri: z.string(),
+  id: z.string(),
+  title: z.string(), // From base schema
   created_at: z.string().datetime(),
   updated_at: z.string().datetime(),
   created_by: z.string().optional(),
   updated_by: z.string().optional(),
-  title: z.string(),
   completed: z.boolean(),
   userId: z.number(),
 });
@@ -555,11 +525,10 @@ const todoTools = impl(TODO_COLLECTION_BINDING, [
     },
   },
   {
-    description: "Get a todo by URI",
-    handler: async ({ uri }) => {
-      const parsed = parseCollectionUri(uri);
+    description: "Get a todo by ID",
+    handler: async ({ id }) => {
       const item = await db.todos.findUnique({
-        where: { id: parsed.itemId },
+        where: { id },
       });
       return { item };
     },
@@ -567,21 +536,20 @@ const todoTools = impl(TODO_COLLECTION_BINDING, [
   {
     description: "Create a new todo",
     handler: async ({ data }) => {
-      const item = await db.todos.create({ data });
-      const uri = constructCollectionUri(
-        connectionId,
-        "todos",
-        item.id
-      );
-      return { item: { ...item, uri } };
+      const item = await db.todos.create({ 
+        data: {
+          ...data,
+          id: data.id || generateId(), // Use provided ID or generate one
+        }
+      });
+      return { item };
     },
   },
   {
     description: "Update a todo",
-    handler: async ({ uri, data }) => {
-      const parsed = parseCollectionUri(uri);
+    handler: async ({ id, data }) => {
       const item = await db.todos.update({
-        where: { id: parsed.itemId },
+        where: { id },
         data,
       });
       return { item };
@@ -589,10 +557,9 @@ const todoTools = impl(TODO_COLLECTION_BINDING, [
   },
   {
     description: "Delete a todo",
-    handler: async ({ uri }) => {
-      const parsed = parseCollectionUri(uri);
-      await db.todos.delete({ where: { id: parsed.itemId } });
-      return { success: true, uri };
+    handler: async ({ id }) => {
+      await db.todos.delete({ where: { id } });
+      return { success: true, id };
     },
   },
 ]);

package/dist/chunk-IBOJHI67.js

@@ -0,0 +1,132 @@
+import { z } from 'zod';
+
+// src/well-known/collections.ts
+var BaseCollectionEntitySchema = z.object({
+  id: z.string().describe("Unique identifier for the entity"),
+  title: z.string().describe("Human-readable title for the entity"),
+  created_at: z.string().datetime(),
+  updated_at: z.string().datetime(),
+  created_by: z.string().optional(),
+  updated_by: z.string().optional()
+});
+var WhereExpressionSchema = z.lazy(
+  () => z.union([
+    // Simple comparison
+    z.object({
+      field: z.array(z.string()),
+      operator: z.enum([
+        "eq",
+        "gt",
+        "gte",
+        "lt",
+        "lte",
+        "in",
+        "like",
+        "contains"
+      ]),
+      value: z.unknown()
+    }),
+    // Logical operators
+    z.object({
+      operator: z.enum(["and", "or", "not"]),
+      conditions: z.array(WhereExpressionSchema)
+    })
+  ])
+);
+var OrderByExpressionSchema = z.object({
+  field: z.array(z.string()),
+  direction: z.enum(["asc", "desc"]),
+  nulls: z.enum(["first", "last"]).optional()
+});
+var CollectionListInputSchema = z.object({
+  where: WhereExpressionSchema.optional().describe("Filter expression"),
+  orderBy: z.array(OrderByExpressionSchema).optional().describe("Sort expressions"),
+  limit: z.number().int().min(1).max(1e3).optional().describe("Maximum number of items to return"),
+  offset: z.number().int().min(0).optional().describe("Number of items to skip")
+});
+function createCollectionListOutputSchema(entitySchema) {
+  return z.object({
+    items: z.array(entitySchema).describe("Array of collection items"),
+    totalCount: z.number().int().min(0).optional().describe("Total number of matching items (if available)"),
+    hasMore: z.boolean().optional().describe("Whether there are more items available")
+  });
+}
+var CollectionGetInputSchema = z.object({
+  id: z.string().describe("ID of the entity to retrieve")
+});
+function createCollectionGetOutputSchema(entitySchema) {
+  return z.object({
+    item: entitySchema.nullable().describe("The retrieved item, or null if not found")
+  });
+}
+function createCollectionInsertInputSchema(entitySchema) {
+  return z.object({
+    data: entitySchema.describe("Data for the new entity (id may be auto-generated)")
+  });
+}
+function createCollectionInsertOutputSchema(entitySchema) {
+  return z.object({
+    item: entitySchema.describe("The created entity with generated id")
+  });
+}
+function createCollectionUpdateInputSchema(entitySchema) {
+  return z.object({
+    id: z.string().describe("ID of the entity to update"),
+    data: entitySchema.partial().describe("Partial entity data to update")
+  });
+}
+function createCollectionUpdateOutputSchema(entitySchema) {
+  return z.object({
+    item: entitySchema.describe("The updated entity")
+  });
+}
+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 createCollectionBindings(collectionName, entitySchema, options) {
+  const upperName = collectionName.toUpperCase();
+  const readOnly = options?.readOnly ?? false;
+  const bindings = [
+    {
+      name: `DECO_COLLECTION_${upperName}_LIST`,
+      inputSchema: CollectionListInputSchema,
+      outputSchema: createCollectionListOutputSchema(entitySchema)
+    },
+    {
+      name: `DECO_COLLECTION_${upperName}_GET`,
+      inputSchema: CollectionGetInputSchema,
+      outputSchema: createCollectionGetOutputSchema(entitySchema)
+    }
+  ];
+  if (!readOnly) {
+    bindings.push(
+      {
+        name: `DECO_COLLECTION_${upperName}_INSERT`,
+        inputSchema: createCollectionInsertInputSchema(entitySchema),
+        outputSchema: createCollectionInsertOutputSchema(entitySchema),
+        opt: true
+      },
+      {
+        name: `DECO_COLLECTION_${upperName}_UPDATE`,
+        inputSchema: createCollectionUpdateInputSchema(entitySchema),
+        outputSchema: createCollectionUpdateOutputSchema(entitySchema),
+        opt: true
+      },
+      {
+        name: `DECO_COLLECTION_${upperName}_DELETE`,
+        inputSchema: CollectionDeleteInputSchema,
+        outputSchema: CollectionDeleteOutputSchema,
+        opt: true
+      }
+    );
+  }
+  return bindings;
+}
+
+export { BaseCollectionEntitySchema, CollectionDeleteInputSchema, CollectionDeleteOutputSchema, CollectionGetInputSchema, CollectionListInputSchema, OrderByExpressionSchema, WhereExpressionSchema, createCollectionBindings, createCollectionGetOutputSchema, createCollectionInsertInputSchema, createCollectionInsertOutputSchema, createCollectionListOutputSchema, createCollectionUpdateInputSchema, createCollectionUpdateOutputSchema };
+//# sourceMappingURL=chunk-IBOJHI67.js.map
+//# sourceMappingURL=chunk-IBOJHI67.js.map

package/dist/chunk-IBOJHI67.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/well-known/collections.ts"],"names":[],"mappings":"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","file":"chunk-IBOJHI67.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 * Where expression type for filtering\n * Supports TanStack DB predicate push-down patterns\n */\nexport type WhereExpression =\n  | {\n    field: string[];\n    operator: \"eq\" | \"gt\" | \"gte\" | \"lt\" | \"lte\" | \"in\" | \"like\" | \"contains\";\n    value: unknown;\n  }\n  | {\n    operator: \"and\" | \"or\" | \"not\";\n    conditions: WhereExpression[];\n  };\n\n/**\n * Where expression schema for filtering\n * Supports TanStack DB predicate push-down patterns\n */\nexport const WhereExpressionSchema = z.lazy(() =>\n  z.union([\n    // Simple comparison\n    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    // Logical operators\n    z.object({\n      operator: z.enum([\"and\", \"or\", \"not\"]),\n      conditions: z.array(WhereExpressionSchema),\n    }),\n  ])\n) as z.ZodType<WhereExpression>;\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"]}

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

@@ -0,0 +1,293 @@
+import { z } from 'zod';
+import { ToolBinder } from '../index.js';
+
+/**
+ * Collection Bindings
+ *
+ * This module provides standardized tool bindings for Collections, representing
+ * SQL table-like structures with CRUD + Search operations compatible with TanStack DB.
+ *
+ * Key Features:
+ * - Generic collection bindings that work with any entity type
+ * - Standardized tool naming: `DECO_COLLECTION_{COLLECTION}_*`
+ * - Compatible with TanStack DB query-collection
+ * - Full TypeScript support with proper type constraints
+ * - Support for filtering, sorting, and pagination
+ * - Simple id and title fields for human-readable identification
+ */
+/**
+ * Base schema for collection entities
+ * All collection entities must have an id, title, and audit trail fields
+ */
+declare const BaseCollectionEntitySchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+    created_by: z.ZodOptional<z.ZodString>;
+    updated_by: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    title: string;
+    created_at: string;
+    updated_at: string;
+    created_by?: string | undefined;
+    updated_by?: string | undefined;
+}, {
+    id: string;
+    title: string;
+    created_at: string;
+    updated_at: string;
+    created_by?: string | undefined;
+    updated_by?: string | undefined;
+}>;
+/**
+ * Type helper for BaseCollectionEntitySchema
+ */
+type BaseCollectionEntitySchemaType = typeof BaseCollectionEntitySchema;
+/**
+ * Where expression type for filtering
+ * Supports TanStack DB predicate push-down patterns
+ */
+type WhereExpression = {
+    field: string[];
+    operator: "eq" | "gt" | "gte" | "lt" | "lte" | "in" | "like" | "contains";
+    value: unknown;
+} | {
+    operator: "and" | "or" | "not";
+    conditions: WhereExpression[];
+};
+/**
+ * Where expression schema for filtering
+ * Supports TanStack DB predicate push-down patterns
+ */
+declare const WhereExpressionSchema: z.ZodType<WhereExpression>;
+/**
+ * Order by expression for sorting
+ */
+declare const OrderByExpressionSchema: z.ZodObject<{
+    field: z.ZodArray<z.ZodString, "many">;
+    direction: z.ZodEnum<["asc", "desc"]>;
+    nulls: z.ZodOptional<z.ZodEnum<["first", "last"]>>;
+}, "strip", z.ZodTypeAny, {
+    field: string[];
+    direction: "asc" | "desc";
+    nulls?: "first" | "last" | undefined;
+}, {
+    field: string[];
+    direction: "asc" | "desc";
+    nulls?: "first" | "last" | undefined;
+}>;
+/**
+ * List/Query input schema for collections
+ * Compatible with TanStack DB LoadSubsetOptions
+ */
+declare const CollectionListInputSchema: z.ZodObject<{
+    where: z.ZodOptional<z.ZodType<WhereExpression, z.ZodTypeDef, WhereExpression>>;
+    orderBy: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        field: z.ZodArray<z.ZodString, "many">;
+        direction: z.ZodEnum<["asc", "desc"]>;
+        nulls: z.ZodOptional<z.ZodEnum<["first", "last"]>>;
+    }, "strip", z.ZodTypeAny, {
+        field: string[];
+        direction: "asc" | "desc";
+        nulls?: "first" | "last" | undefined;
+    }, {
+        field: string[];
+        direction: "asc" | "desc";
+        nulls?: "first" | "last" | undefined;
+    }>, "many">>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    where?: WhereExpression | undefined;
+    orderBy?: {
+        field: string[];
+        direction: "asc" | "desc";
+        nulls?: "first" | "last" | undefined;
+    }[] | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}, {
+    where?: WhereExpression | undefined;
+    orderBy?: {
+        field: string[];
+        direction: "asc" | "desc";
+        nulls?: "first" | "last" | undefined;
+    }[] | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+/**
+ * Factory function to create list output schema for a specific collection type
+ */
+declare function createCollectionListOutputSchema<T extends z.ZodTypeAny>(entitySchema: T): z.ZodObject<{
+    items: z.ZodArray<T, "many">;
+    totalCount: z.ZodOptional<z.ZodNumber>;
+    hasMore: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    items: T["_output"][];
+    totalCount?: number | undefined;
+    hasMore?: boolean | undefined;
+}, {
+    items: T["_input"][];
+    totalCount?: number | undefined;
+    hasMore?: boolean | undefined;
+}>;
+/**
+ * Get by ID input schema
+ */
+declare const CollectionGetInputSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+/**
+ * Factory function to create get output schema
+ */
+declare function createCollectionGetOutputSchema<T extends z.ZodTypeAny>(entitySchema: T): z.ZodObject<{
+    item: z.ZodNullable<T>;
+}, "strip", z.ZodTypeAny, z.objectUtil.addQuestionMarks<z.baseObjectOutputType<{
+    item: z.ZodNullable<T>;
+}>, any> extends infer T_1 ? { [k in keyof T_1]: T_1[k]; } : never, z.baseObjectInputType<{
+    item: z.ZodNullable<T>;
+}> extends infer T_2 ? { [k_1 in keyof T_2]: T_2[k_1]; } : never>;
+/**
+ * Factory function to create insert input schema
+ */
+declare function createCollectionInsertInputSchema<T extends z.ZodTypeAny>(entitySchema: T): z.ZodObject<{
+    data: T;
+}, "strip", z.ZodTypeAny, z.objectUtil.addQuestionMarks<z.baseObjectOutputType<{
+    data: T;
+}>, any> extends infer T_1 ? { [k in keyof T_1]: T_1[k]; } : never, z.baseObjectInputType<{
+    data: T;
+}> extends infer T_2 ? { [k_1 in keyof T_2]: T_2[k_1]; } : never>;
+/**
+ * Factory function to create insert output schema
+ */
+declare function createCollectionInsertOutputSchema<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>;
+/**
+ * Factory function to create update input schema
+ */
+declare function createCollectionUpdateInputSchema<T extends z.ZodTypeAny>(entitySchema: T): z.ZodObject<{
+    id: z.ZodString;
+    data: z.ZodObject<{
+        [x: string]: z.ZodOptional<any>;
+    }, any, any, {
+        [x: string]: any;
+    }, {
+        [x: string]: any;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    data: {
+        [x: string]: any;
+    };
+}, {
+    id: string;
+    data: {
+        [x: string]: any;
+    };
+}>;
+/**
+ * Factory function to create update output schema
+ */
+declare function createCollectionUpdateOutputSchema<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>;
+/**
+ * Delete input schema
+ */
+declare const CollectionDeleteInputSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+/**
+ * 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;
+}>;
+/**
+ * Options for creating collection bindings
+ */
+interface CollectionBindingOptions {
+    /**
+     * If true, only LIST and GET operations will be included (read-only collection)
+     * @default false
+     */
+    readOnly?: boolean;
+}
+/**
+ * Creates generic collection bindings for a specific entity type
+ *
+ * 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)
+ *
+ * @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)
+ * @param options - Optional configuration for the collection bindings
+ * @returns Array of tool bindings for Collection CRUD + Query operations
+ *
+ * @example
+ * ```typescript
+ * const UserSchema = z.object({
+ *   id: z.string(),
+ *   title: z.string(),
+ *   created_at: z.string().datetime(),
+ *   updated_at: z.string().datetime(),
+ *   created_by: z.string().optional(),
+ *   updated_by: z.string().optional(),
+ *   email: z.string().email(),
+ * });
+ *
+ * // Full CRUD collection
+ * const USER_COLLECTION_BINDING = createCollectionBindings("users", UserSchema);
+ *
+ * // Read-only collection (only LIST and GET)
+ * const READONLY_COLLECTION_BINDING = createCollectionBindings("products", ProductSchema, { readOnly: true });
+ * ```
+ */
+declare function createCollectionBindings<TEntitySchema extends BaseCollectionEntitySchemaType>(collectionName: string, entitySchema: TEntitySchema, options?: CollectionBindingOptions): ToolBinder<string, any, object>[];
+/**
+ * Type helper to extract the collection binding type
+ */
+type CollectionBinding<TEntitySchema extends BaseCollectionEntitySchemaType> = ReturnType<typeof createCollectionBindings<TEntitySchema>>;
+/**
+ * Type helper to extract tool names from a collection binding
+ */
+type CollectionTools<TEntitySchema extends BaseCollectionEntitySchemaType> = CollectionBinding<TEntitySchema>[number]["name"];
+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>;
+
+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 };

package/dist/well-known/collections.js

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

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

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"collections.js"}

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

@@ -0,0 +1,32 @@
+import { ToolBinder } from '../index.js';
+import 'zod';
+
+/**
+ * Models Well-Known Binding
+ *
+ * Defines the interface for AI model providers.
+ * Any MCP that implements this binding can provide AI models and streaming endpoints.
+ *
+ * This binding uses collection bindings for LIST and GET operations (read-only).
+ * Streaming endpoint information is included directly in the model entity schema.
+ */
+/**
+ * MODELS Collection Binding
+ *
+ * Collection bindings for models (read-only).
+ * Provides LIST and GET operations for AI models.
+ */
+declare const MODELS_COLLECTION_BINDING: ToolBinder<string, any, object>[];
+/**
+ * MODELS Binding
+ *
+ * Defines the interface for AI model providers.
+ * 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)
+ */
+declare const MODELS_BINDING: readonly ToolBinder<string, any, object>[];
+
+export { MODELS_BINDING, MODELS_COLLECTION_BINDING };

package/dist/well-known/models.js

@@ -0,0 +1,36 @@
+import { BaseCollectionEntitySchema, createCollectionBindings } from '../chunk-IBOJHI67.js';
+import { z } from 'zod';
+
+var ModelSchema = 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(),
+  // 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()
+});
+var MODELS_COLLECTION_BINDING = createCollectionBindings(
+  "models",
+  ModelSchema,
+  { readOnly: true }
+);
+var MODELS_BINDING = [
+  ...MODELS_COLLECTION_BINDING
+];
+
+export { MODELS_BINDING, MODELS_COLLECTION_BINDING };
+//# sourceMappingURL=models.js.map
+//# sourceMappingURL=models.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/well-known/models.ts"],"names":[],"mappings":";;;AAsBA,IAAM,WAAA,GAAc,2BAA2B,MAAA,CAAO;AAAA;AAAA,EAEpD,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,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,CAAA;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 */\nconst 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  // 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"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decocms/bindings",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "scripts": {
     "build": "tsup",
@@ -24,6 +24,16 @@
       "source": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./models": {
+      "source": "./src/well-known/models.ts",
+      "types": "./dist/well-known/models.d.ts",
+      "default": "./dist/well-known/models.js"
+    },
+    "./collections": {
+      "source": "./src/well-known/collections.ts",
+      "types": "./dist/well-known/collections.d.ts",
+      "default": "./dist/well-known/collections.js"
     }
   },
   "devDependencies": {

package/src/well-known/collections.ts

@@ -13,82 +13,16 @@ import type { ToolBinder } from "../core/binder";
  * - Compatible with TanStack DB query-collection
  * - Full TypeScript support with proper type constraints
  * - Support for filtering, sorting, and pagination
- * - Collection URI format: rsc://{connectionid}/{collection_name}/{item_id}
+ * - Simple id and title fields for human-readable identification
  */
 
-/**
- * Collection URI format validation
- * Format: rsc://{connectionid}/{collection_name}/{item_id}
- */
-export const CollectionUriSchema = z
-  .string()
-  .regex(
-    /^rsc:\/\/[^/]+\/[^/]+\/.+$/,
-    "Invalid collection URI format. Expected format: rsc://{connectionid}/{collection_name}/{item_id}",
-  );
-
-/**
- * Utility function to validate a collection URI format
- *
- * @param uri - The URI to validate
- * @returns True if the URI is valid, false otherwise
- */
-export function validateCollectionUri(uri: string): boolean {
-  return CollectionUriSchema.safeParse(uri).success;
-}
-
-/**
- * Utility function to parse a collection URI into its components
- *
- * @param uri - The URI to parse
- * @returns Object containing the parsed components or null if invalid
- */
-export function parseCollectionUri(uri: string): {
-  connectionId: string;
-  collectionName: string;
-  itemId: string;
-} | null {
-  const result = CollectionUriSchema.safeParse(uri);
-  if (!result.success) {
-    return null;
-  }
-
-  const match = result.data.match(/^rsc:\/\/([^/]+)\/([^/]+)\/(.+)$/);
-  if (!match) {
-    return null;
-  }
-
-  return {
-    connectionId: decodeURIComponent(match[1]),
-    collectionName: decodeURIComponent(match[2]),
-    itemId: decodeURIComponent(match[3]),
-  };
-}
-
-/**
- * Utility function to construct a collection URI from components
- *
- * @param connectionId - The connection identifier
- * @param collectionName - The collection name
- * @param itemId - The item identifier
- * @returns The constructed collection URI
- */
-export function constructCollectionUri(
-  connectionId: string,
-  collectionName: string,
-  itemId: string,
-): string {
-  return `rsc://${encodeURIComponent(connectionId)}/${
-    encodeURIComponent(collectionName)
-  }/${encodeURIComponent(itemId)}`;
-}
-
 /**
  * Base schema for collection entities
- * All collection entities must have a uri field and audit trail fields
+ * All collection entities must have an id, title, and audit trail fields
  */
 export const BaseCollectionEntitySchema = z.object({
-  uri: z.string(),
+  id: z.string().describe("Unique identifier for the entity"),
+  title: z.string().describe("Human-readable title for the entity"),
   created_at: z.string().datetime(),
   updated_at: z.string().datetime(),
   created_by: z.string().optional(),
@@ -200,10 +134,10 @@ export function createCollectionListOutputSchema<T extends z.ZodTypeAny>(
 }
 
 /**
- * Get by URI input schema
+ * Get by ID input schema
  */
 export const CollectionGetInputSchema = z.object({
-  uri: CollectionUriSchema.describe("URI of the entity to retrieve"),
+  id: z.string().describe("ID of the entity to retrieve"),
 });
 
 /**
@@ -225,9 +159,9 @@ export function createCollectionGetOutputSchema<T extends z.ZodTypeAny>(
 export function createCollectionInsertInputSchema<T extends z.ZodTypeAny>(
   entitySchema: T,
 ) {
-  // Remove uri field since it's auto-generated from connectionId/collectionName/itemId
+  // Remove id field since it may be auto-generated by the server
   return z.object({
-    data: entitySchema.describe("Data for the new entity (without uri)"),
+    data: entitySchema.describe("Data for the new entity (id may be auto-generated)"),
   });
 }
 
@@ -238,7 +172,7 @@ export function createCollectionInsertOutputSchema<T extends z.ZodTypeAny>(
   entitySchema: T,
 ) {
   return z.object({
-    item: entitySchema.describe("The created entity with generated URI"),
+    item: entitySchema.describe("The created entity with generated id"),
   });
 }
 
@@ -249,7 +183,7 @@ export function createCollectionUpdateInputSchema<T extends z.ZodTypeAny>(
   entitySchema: T,
 ) {
   return z.object({
-    uri: CollectionUriSchema.describe("URI of the entity to update"),
+    id: z.string().describe("ID of the entity to update"),
     data: (entitySchema as unknown as z.AnyZodObject)
       .partial()
       .describe("Partial entity data to update"),
@@ -271,7 +205,7 @@ export function createCollectionUpdateOutputSchema<T extends z.ZodTypeAny>(
  * Delete input schema
  */
 export const CollectionDeleteInputSchema = z.object({
-  uri: CollectionUriSchema.describe("URI of the entity to delete"),
+  id: z.string().describe("ID of the entity to delete"),
 });
 
 /**
@@ -279,7 +213,7 @@ export const CollectionDeleteInputSchema = z.object({
  */
 export const CollectionDeleteOutputSchema = z.object({
   success: z.boolean().describe("Whether the deletion was successful"),
-  uri: CollectionUriSchema.describe("URI of the deleted entity"),
+  id: z.string().describe("ID of the deleted entity"),
 });
 
 /**
@@ -299,7 +233,7 @@ 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 URI (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)
@@ -312,12 +246,12 @@ export interface CollectionBindingOptions {
  * @example
  * ```typescript
  * const UserSchema = z.object({
- *   uri: z.string(),
+ *   id: z.string(),
+ *   title: z.string(),
  *   created_at: z.string().datetime(),
  *   updated_at: z.string().datetime(),
  *   created_by: z.string().optional(),
  *   updated_by: z.string().optional(),
- *   name: z.string(),
  *   email: z.string().email(),
  * });
  *
@@ -393,7 +327,6 @@ export type CollectionTools<
 > = CollectionBinding<TEntitySchema>[number]["name"];
 
 // Export types for TypeScript usage
-export type CollectionUri = z.infer<typeof CollectionUriSchema>;
 export type CollectionListInput = z.infer<typeof CollectionListInputSchema>;
 export type CollectionGetInput = z.infer<typeof CollectionGetInputSchema>;
 export type CollectionDeleteInput = z.infer<typeof CollectionDeleteInputSchema>;

package/src/well-known/models.ts

@@ -4,8 +4,8 @@
  * Defines the interface for AI model providers.
  * Any MCP that implements this binding can provide AI models and streaming endpoints.
  *
- * This binding uses collection bindings for LIST and GET operations (read-only),
- * and adds a GET_STREAM_ENDPOINT tool for streaming functionality.
+ * This binding uses collection bindings for LIST and GET operations (read-only).
+ * Streaming endpoint information is included directly in the model entity schema.
  */
 
 import { z } from "zod";
@@ -18,19 +18,28 @@ import {
 /**
  * Model entity schema for AI models
  * Extends BaseCollectionEntitySchema with model-specific fields
+ * Base schema already includes: id, title, created_at, updated_at, created_by, updated_by
  */
 const ModelSchema = BaseCollectionEntitySchema.extend({
   // Model-specific fields
-  id: z.string(),
-  model: z.string(),
-  name: z.string(),
   logo: z.string().nullable(),
-  capabilities: z.array(z.string()),
-  contextWindow: z.number().nullable(),
-  inputCost: z.number().nullable(),
-  outputCost: z.number().nullable(),
-  outputLimit: z.number().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(),
+  // 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(),
 });
 
 /**
@@ -53,17 +62,8 @@ export const MODELS_COLLECTION_BINDING = createCollectionBindings(
  *
  * Required tools:
  * - DECO_COLLECTION_MODELS_LIST: List available AI models with their capabilities
- * - DECO_COLLECTION_MODELS_GET: Get a single model by URI
- * - GET_STREAM_ENDPOINT: Get the streaming endpoint URL for chat completions
+ * - DECO_COLLECTION_MODELS_GET: Get a single model by ID (includes streaming endpoint info)
  */
 export const MODELS_BINDING = [
   ...MODELS_COLLECTION_BINDING,
-  {
-    name: "GET_STREAM_ENDPOINT" as const,
-    inputSchema: z.object({}).passthrough(),
-    outputSchema: z.object({
-      url: z.string().url(),
-    }).partial(),
-  },
 ] as const satisfies Binder;
-