@decocms/bindings 0.1.6 → 0.2.1-beta.1

package/dist/{chunk-L7E6ONLJ.js → collections.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=collections.js.map
+//# sourceMappingURL=collections.js.map

package/dist/collections.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/well-known/collections.ts"],"names":[],"mappings":";;;AAsBO,IAAM,0BAAA,GAA6B,EAAE,MAAA,CAAO;AAAA,EACjD,EAAA,EAAI,CAAA,CAAE,MAAA,EAAO,CAAE,SAAS,kCAAkC,CAAA;AAAA,EAC1D,KAAA,EAAO,CAAA,CAAE,MAAA,EAAO,CAAE,SAAS,qCAAqC,CAAA;AAAA,EAChE,UAAA,EAAY,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAChC,UAAA,EAAY,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAChC,UAAA,EAAY,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAChC,UAAA,EAAY,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AACzB,CAAC;AAUD,IAAM,0BAAA,GAA6B,EAAE,MAAA,CAAO;AAAA,EAC1C,KAAA,EAAO,CAAA,CAAE,KAAA,CAAM,CAAA,CAAE,QAAQ,CAAA;AAAA,EACzB,QAAA,EAAU,CAAA,CAAE,IAAA,CAAK,CAAC,IAAA,EAAM,IAAA,EAAM,KAAA,EAAO,IAAA,EAAM,KAAA,EAAO,IAAA,EAAM,MAAA,EAAQ,UAAU,CAAC,CAAA;AAAA,EAC3E,KAAA,EAAO,EAAE,OAAA;AACX,CAAC,CAAA;AAMM,IAAM,qBAAA,GAAwB,EAAE,KAAA,CAAM;AAAA,EAC3C,0BAAA;AAAA,EACA,EAAE,MAAA,CAAO;AAAA,IACP,UAAU,CAAA,CAAE,IAAA,CAAK,CAAC,KAAA,EAAO,IAAA,EAAM,KAAK,CAAC,CAAA;AAAA,IACrC,UAAA,EAAY,CAAA,CAAE,KAAA,CAAM,0BAA0B;AAAA,GAC/C;AACH,CAAC;AAWM,IAAM,uBAAA,GAA0B,EAAE,MAAA,CAAO;AAAA,EAC9C,KAAA,EAAO,CAAA,CAAE,KAAA,CAAM,CAAA,CAAE,QAAQ,CAAA;AAAA,EACzB,WAAW,CAAA,CAAE,IAAA,CAAK,CAAC,KAAA,EAAO,MAAM,CAAC,CAAA;AAAA,EACjC,KAAA,EAAO,EAAE,IAAA,CAAK,CAAC,SAAS,MAAM,CAAC,EAAE,QAAA;AACnC,CAAC;AAMM,IAAM,yBAAA,GAA4B,EAAE,MAAA,CAAO;AAAA,EAChD,KAAA,EAAO,qBAAA,CAAsB,QAAA,EAAS,CAAE,SAAS,mBAAmB,CAAA;AAAA,EACpE,OAAA,EAAS,EACN,KAAA,CAAM,uBAAuB,EAC7B,QAAA,EAAS,CACT,SAAS,kBAAkB,CAAA;AAAA,EAC9B,KAAA,EAAO,CAAA,CACJ,MAAA,EAAO,CACP,KAAI,CACJ,GAAA,CAAI,CAAC,CAAA,CACL,IAAI,GAAI,CAAA,CACR,QAAA,EAAS,CACT,SAAS,mCAAmC,CAAA;AAAA,EAC/C,MAAA,EAAQ,CAAA,CACL,MAAA,EAAO,CACP,GAAA,EAAI,CACJ,GAAA,CAAI,CAAC,CAAA,CACL,QAAA,EAAS,CACT,QAAA,CAAS,yBAAyB;AACvC,CAAC;AAKM,SAAS,iCACd,YAAA,EACA;AACA,EAAA,OAAO,EAAE,MAAA,CAAO;AAAA,IACd,OAAO,CAAA,CAAE,KAAA,CAAM,YAAY,CAAA,CAAE,SAAS,2BAA2B,CAAA;AAAA,IACjE,UAAA,EAAY,CAAA,CACT,MAAA,EAAO,CACP,GAAA,EAAI,CACJ,GAAA,CAAI,CAAC,CAAA,CACL,QAAA,EAAS,CACT,QAAA,CAAS,+CAA+C,CAAA;AAAA,IAC3D,SAAS,CAAA,CACN,OAAA,GACA,QAAA,EAAS,CACT,SAAS,wCAAwC;AAAA,GACrD,CAAA;AACH;AAKO,IAAM,wBAAA,GAA2B,EAAE,MAAA,CAAO;AAAA,EAC/C,EAAA,EAAI,CAAA,CAAE,MAAA,EAAO,CAAE,SAAS,8BAA8B;AACxD,CAAC;AAKM,SAAS,gCACd,YAAA,EACA;AACA,EAAA,OAAO,EAAE,MAAA,CAAO;AAAA,IACd,IAAA,EAAM,YAAA,CACH,QAAA,EAAS,CACT,SAAS,0CAA0C;AAAA,GACvD,CAAA;AACH;AAKO,SAAS,kCACd,YAAA,EACA;AAEA,EAAA,OAAO,EAAE,MAAA,CAAO;AAAA,IACd,MAAM,YAAA,CAAa,QAAA;AAAA,MACjB;AAAA;AACF,GACD,CAAA;AACH;AAKO,SAAS,mCACd,YAAA,EACA;AACA,EAAA,OAAO,EAAE,MAAA,CAAO;AAAA,IACd,IAAA,EAAM,YAAA,CAAa,QAAA,CAAS,sCAAsC;AAAA,GACnE,CAAA;AACH;AAKO,SAAS,kCACd,YAAA,EACA;AACA,EAAA,OAAO,EAAE,MAAA,CAAO;AAAA,IACd,EAAA,EAAI,CAAA,CAAE,MAAA,EAAO,CAAE,SAAS,4BAA4B,CAAA;AAAA,IACpD,IAAA,EAAO,YAAA,CACJ,OAAA,EAAQ,CACR,SAAS,+BAA+B;AAAA,GAC5C,CAAA;AACH;AAKO,SAAS,mCACd,YAAA,EACA;AACA,EAAA,OAAO,EAAE,MAAA,CAAO;AAAA,IACd,IAAA,EAAM,YAAA,CAAa,QAAA,CAAS,oBAAoB;AAAA,GACjD,CAAA;AACH;AAKO,IAAM,2BAAA,GAA8B,EAAE,MAAA,CAAO;AAAA,EAClD,EAAA,EAAI,CAAA,CAAE,MAAA,EAAO,CAAE,SAAS,4BAA4B;AACtD,CAAC;AAKM,SAAS,mCACd,YAAA,EACA;AACA,EAAA,OAAO,EAAE,MAAA,CAAO;AAAA,IACd,IAAA,EAAM,YAAA,CAAa,QAAA,CAAS,oBAAoB;AAAA,GACjD,CAAA;AACH;AAgDO,SAAS,wBAAA,CAId,cAAA,EACA,YAAA,EACA,OAAA,EACA;AACA,EAAA,MAAM,SAAA,GAAY,eAAe,WAAA,EAAY;AAC7C,EAAA,MAAM,QAAA,GAAW,SAAS,QAAA,IAAY,KAAA;AAEtC,EAAA,MAAM,QAAA,GACJ;AAAA,IACE;AAAA,MACE,IAAA,EAAM,cAAc,SAAS,CAAA,KAAA,CAAA;AAAA,MAC7B,WAAA,EAAa,yBAAA;AAAA,MACb,YAAA,EAAc,iCAAiC,YAAY;AAAA,KAC7D;AAAA,IACA;AAAA,MACE,IAAA,EAAM,cAAc,SAAS,CAAA,IAAA,CAAA;AAAA,MAC7B,WAAA,EAAa,wBAAA;AAAA,MACb,YAAA,EAAc,gCAAgC,YAAY;AAAA;AAC5D,GACF;AAGF,EAAA,IAAI,CAAC,QAAA,EAAU;AACb,IAAA,QAAA,CAAS,IAAA;AAAA,MACP;AAAA,QACE,IAAA,EAAM,cAAc,SAAS,CAAA,OAAA,CAAA;AAAA,QAC7B,WAAA,EAAa,kCAAkC,YAAY,CAAA;AAAA,QAC3D,YAAA,EAAc,mCAAmC,YAAY,CAAA;AAAA,QAC7D,GAAA,EAAK;AAAA,OACP;AAAA,MACA;AAAA,QACE,IAAA,EAAM,cAAc,SAAS,CAAA,OAAA,CAAA;AAAA,QAC7B,WAAA,EAAa,kCAAkC,YAAY,CAAA;AAAA,QAC3D,YAAA,EAAc,mCAAmC,YAAY,CAAA;AAAA,QAC7D,GAAA,EAAK;AAAA,OACP;AAAA,MACA;AAAA,QACE,IAAA,EAAM,cAAc,SAAS,CAAA,OAAA,CAAA;AAAA,QAC7B,WAAA,EAAa,2BAAA;AAAA,QACb,YAAA,EAAc,mCAAmC,YAAY,CAAA;AAAA,QAC7D,GAAA,EAAK;AAAA;AACP,KACF;AAAA,EACF;AAEA,EAAA,OAAO,QAAA;AACT","file":"collections.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  TName extends string,\n>(\n  collectionName: TName,\n  entitySchema: TEntitySchema,\n  options?: CollectionBindingOptions,\n) {\n  const upperName = collectionName.toUpperCase() as Uppercase<TName>;\n  const readOnly = options?.readOnly ?? false;\n\n  const bindings: CollectionBinding<TEntitySchema, Uppercase<TName>>[number][] =\n    [\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\nexport type ReadOnlyCollectionBinding<\n  TEntitySchema extends BaseCollectionEntitySchemaType,\n  TUpperName extends Uppercase<string> = Uppercase<string>,\n> = [\n  {\n    name: `COLLECTION_${TUpperName}_LIST`;\n    inputSchema: typeof CollectionListInputSchema;\n    outputSchema: ReturnType<\n      typeof createCollectionListOutputSchema<TEntitySchema>\n    >;\n  },\n  {\n    name: `COLLECTION_${TUpperName}_GET`;\n    inputSchema: typeof CollectionGetInputSchema;\n    outputSchema: ReturnType<\n      typeof createCollectionGetOutputSchema<TEntitySchema>\n    >;\n  },\n];\n/**\n * Type helper to extract the collection binding type\n */\nexport type CollectionBinding<\n  TEntitySchema extends BaseCollectionEntitySchemaType,\n  TUpperName extends Uppercase<string> = Uppercase<string>,\n> = [\n  ...ReadOnlyCollectionBinding<TEntitySchema, TUpperName>,\n  {\n    name: `COLLECTION_${TUpperName}_CREATE`;\n    inputSchema: ReturnType<\n      typeof createCollectionInsertInputSchema<TEntitySchema>\n    >;\n    outputSchema: ReturnType<\n      typeof createCollectionInsertOutputSchema<TEntitySchema>\n    >;\n    opt: true;\n  },\n  {\n    name: `COLLECTION_${TUpperName}_UPDATE`;\n    inputSchema: ReturnType<\n      typeof createCollectionUpdateInputSchema<TEntitySchema>\n    >;\n    outputSchema: ReturnType<\n      typeof createCollectionUpdateOutputSchema<TEntitySchema>\n    >;\n    opt: true;\n  },\n  {\n    name: `COLLECTION_${TUpperName}_DELETE`;\n    inputSchema: typeof CollectionDeleteInputSchema;\n    outputSchema: ReturnType<\n      typeof createCollectionDeleteOutputSchema<TEntitySchema>\n    >;\n    opt: true;\n  },\n];\n\n/**\n * Type helper to extract tool names from a collection binding\n */\nexport type CollectionTools<\n  TEntitySchema extends BaseCollectionEntitySchemaType,\n  TUpperName extends Uppercase<string> = Uppercase<string>,\n> = CollectionBinding<TEntitySchema, TUpperName>[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/connection.d.ts

@@ -0,0 +1,30 @@
+type SSEConnection = {
+    type: "SSE";
+    url: string;
+    token?: string;
+    headers?: Record<string, string>;
+};
+type WebsocketConnection = {
+    type: "Websocket";
+    url: string;
+    token?: string;
+};
+type DecoConnection = {
+    type: "Deco";
+    tenant: string;
+    token?: string;
+};
+type InnateConnection = {
+    type: "INNATE";
+    name: string;
+    workspace?: string;
+};
+type HTTPConnection = {
+    type: "HTTP";
+    url: string;
+    headers?: Record<string, string>;
+    token?: string;
+};
+type MCPConnection = SSEConnection | WebsocketConnection | InnateConnection | DecoConnection | HTTPConnection;
+
+export type { DecoConnection, HTTPConnection, InnateConnection, MCPConnection, SSEConnection, WebsocketConnection };

package/dist/connection.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=connection.js.map
+//# sourceMappingURL=connection.js.map

package/dist/connection.js.map

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

package/dist/index.d.ts

@@ -15,13 +15,17 @@ import { ZodType } from 'zod';
  * @template TInput - The input type (inferred from inputSchema)
  * @template TReturn - The return type (inferred from outputSchema)
  */
-interface ToolBinder<TName extends string | RegExp = string, TInput = any, TReturn extends object | null | boolean = object> {
+interface ToolBinder<TName extends string | RegExp = string, TInput = any, TReturn extends object | null | boolean = object, TStreamable extends boolean = boolean> {
     /** The name of the tool (e.g., "DECO_CHAT_CHANNELS_JOIN") */
     name: TName;
     /** Zod schema for validating tool input */
     inputSchema: ZodType<TInput>;
     /** Optional Zod schema for validating tool output */
-    outputSchema?: ZodType<TReturn>;
+    outputSchema?: TStreamable extends true ? never : ZodType<TReturn>;
+    /**
+     * Whether this tool is streamable.
+     */
+    streamable?: TStreamable;
     /**
      * Whether this tool is optional in the binding.
      * If true, an implementation doesn't need to provide this tool.

package/dist/index.js

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

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