@decocms/bindings 0.2.0 → 0.2.1-beta.1

package/dist/node/language-model.js

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

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

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

package/package.json

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

package/dist/chunk-JMM4EZYL.js.map

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

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

@@ -1,127 +0,0 @@
-import { ToolBinder } from '../index.js';
-import { z } from 'zod';
-
-/**
- * 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
- */
-declare const ModelSchema: 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>;
-} & {
-    logo: z.ZodNullable<z.ZodString>;
-    description: z.ZodNullable<z.ZodString>;
-    capabilities: z.ZodArray<z.ZodString, "many">;
-    limits: z.ZodNullable<z.ZodObject<{
-        contextWindow: z.ZodNumber;
-        maxOutputTokens: z.ZodNumber;
-    }, "strip", z.ZodTypeAny, {
-        contextWindow: number;
-        maxOutputTokens: number;
-    }, {
-        contextWindow: number;
-        maxOutputTokens: number;
-    }>>;
-    costs: z.ZodNullable<z.ZodObject<{
-        input: z.ZodNumber;
-        output: z.ZodNumber;
-    }, "strip", z.ZodTypeAny, {
-        input: number;
-        output: number;
-    }, {
-        input: number;
-        output: number;
-    }>>;
-    provider: z.ZodNullable<z.ZodEnum<["openai", "anthropic", "google", "xai", "deepseek", "openai-compatible", "openrouter"]>>;
-    endpoint: z.ZodNullable<z.ZodObject<{
-        url: z.ZodString;
-        method: z.ZodDefault<z.ZodString>;
-        contentType: z.ZodDefault<z.ZodString>;
-        stream: z.ZodDefault<z.ZodBoolean>;
-    }, "strip", z.ZodTypeAny, {
-        url: string;
-        method: string;
-        contentType: string;
-        stream: boolean;
-    }, {
-        url: string;
-        method?: string | undefined;
-        contentType?: string | undefined;
-        stream?: boolean | undefined;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    id: string;
-    title: string;
-    created_at: string;
-    updated_at: string;
-    logo: string | null;
-    description: string | null;
-    capabilities: string[];
-    limits: {
-        contextWindow: number;
-        maxOutputTokens: number;
-    } | null;
-    costs: {
-        input: number;
-        output: number;
-    } | null;
-    provider: "openai" | "anthropic" | "google" | "xai" | "deepseek" | "openai-compatible" | "openrouter" | null;
-    endpoint: {
-        url: string;
-        method: string;
-        contentType: string;
-        stream: boolean;
-    } | null;
-    created_by?: string | undefined;
-    updated_by?: string | undefined;
-}, {
-    id: string;
-    title: string;
-    created_at: string;
-    updated_at: string;
-    logo: string | null;
-    description: string | null;
-    capabilities: string[];
-    limits: {
-        contextWindow: number;
-        maxOutputTokens: number;
-    } | null;
-    costs: {
-        input: number;
-        output: number;
-    } | null;
-    provider: "openai" | "anthropic" | "google" | "xai" | "deepseek" | "openai-compatible" | "openrouter" | null;
-    endpoint: {
-        url: string;
-        method?: string | undefined;
-        contentType?: string | undefined;
-        stream?: boolean | undefined;
-    } | null;
-    created_by?: string | undefined;
-    updated_by?: string | undefined;
-}>;
-/**
- * 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:
- * - COLLECTION_MODELS_LIST: List available AI models with their capabilities
- * - COLLECTION_MODELS_GET: Get a single model by ID (includes streaming endpoint info)
- */
-declare const MODELS_BINDING: readonly ToolBinder<string, any, object>[];
-
-export { MODELS_BINDING, MODELS_COLLECTION_BINDING, ModelSchema };

package/dist/well-known/models.js

@@ -1,46 +0,0 @@
-import { BaseCollectionEntitySchema, createCollectionBindings } from '../chunk-JMM4EZYL.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(),
-  // Provider information
-  provider: z.enum([
-    "openai",
-    "anthropic",
-    "google",
-    "xai",
-    "deepseek",
-    "openai-compatible",
-    "openrouter"
-  ]).nullable(),
-  // Streaming endpoint information
-  endpoint: z.object({
-    url: z.string().url(),
-    method: z.string().default("POST"),
-    contentType: z.string().default("application/json"),
-    stream: z.boolean().default(true)
-  }).nullable()
-});
-var MODELS_COLLECTION_BINDING = createCollectionBindings(
-  "models",
-  ModelSchema,
-  { readOnly: true }
-);
-var MODELS_BINDING = [
-  ...MODELS_COLLECTION_BINDING
-];
-
-export { MODELS_BINDING, MODELS_COLLECTION_BINDING, ModelSchema };
-//# sourceMappingURL=models.js.map
-//# sourceMappingURL=models.js.map

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

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/well-known/models.ts"],"names":[],"mappings":";;;AAsBO,IAAM,WAAA,GAAc,2BAA2B,MAAA,CAAO;AAAA;AAAA,EAE3D,IAAA,EAAM,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC1B,WAAA,EAAa,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EACjC,YAAA,EAAc,CAAA,CAAE,KAAA,CAAM,CAAA,CAAE,QAAQ,CAAA;AAAA,EAChC,MAAA,EAAQ,EACL,MAAA,CAAO;AAAA,IACN,aAAA,EAAe,EAAE,MAAA,EAAO;AAAA,IACxB,eAAA,EAAiB,EAAE,MAAA;AAAO,GAC3B,EACA,QAAA,EAAS;AAAA,EACZ,KAAA,EAAO,EACJ,MAAA,CAAO;AAAA,IACN,KAAA,EAAO,EAAE,MAAA,EAAO;AAAA,IAChB,MAAA,EAAQ,EAAE,MAAA;AAAO,GAClB,EACA,QAAA,EAAS;AAAA;AAAA,EAEZ,QAAA,EAAU,EACP,IAAA,CAAK;AAAA,IACJ,QAAA;AAAA,IACA,WAAA;AAAA,IACA,QAAA;AAAA,IACA,KAAA;AAAA,IACA,UAAA;AAAA,IACA,mBAAA;AAAA,IACA;AAAA,GACD,EACA,QAAA,EAAS;AAAA;AAAA,EAEZ,QAAA,EAAU,EACP,MAAA,CAAO;AAAA,IACN,GAAA,EAAK,CAAA,CAAE,MAAA,EAAO,CAAE,GAAA,EAAI;AAAA,IACpB,MAAA,EAAQ,CAAA,CAAE,MAAA,EAAO,CAAE,QAAQ,MAAM,CAAA;AAAA,IACjC,WAAA,EAAa,CAAA,CAAE,MAAA,EAAO,CAAE,QAAQ,kBAAkB,CAAA;AAAA,IAClD,MAAA,EAAQ,CAAA,CAAE,OAAA,EAAQ,CAAE,QAAQ,IAAI;AAAA,GACjC,EACA,QAAA;AACL,CAAC;AAQM,IAAM,yBAAA,GAA4B,wBAAA;AAAA,EACvC,QAAA;AAAA,EACA,WAAA;AAAA,EACA,EAAE,UAAU,IAAA;AACd;AAYO,IAAM,cAAA,GAAiB;AAAA,EAC5B,GAAG;AACL","file":"models.js","sourcesContent":["/**\n * Models Well-Known Binding\n *\n * Defines the interface for AI model providers.\n * Any MCP that implements this binding can provide AI models and streaming endpoints.\n *\n * This binding uses collection bindings for LIST and GET operations (read-only).\n * Streaming endpoint information is included directly in the model entity schema.\n */\n\nimport { z } from \"zod\";\nimport type { Binder } from \"../core/binder\";\nimport {\n  BaseCollectionEntitySchema,\n  createCollectionBindings,\n} from \"./collections\";\n\n/**\n * Model entity schema for AI models\n * Extends BaseCollectionEntitySchema with model-specific fields\n * Base schema already includes: id, title, created_at, updated_at, created_by, updated_by\n */\nexport const ModelSchema = BaseCollectionEntitySchema.extend({\n  // Model-specific fields\n  logo: z.string().nullable(),\n  description: z.string().nullable(),\n  capabilities: z.array(z.string()),\n  limits: z\n    .object({\n      contextWindow: z.number(),\n      maxOutputTokens: z.number(),\n    })\n    .nullable(),\n  costs: z\n    .object({\n      input: z.number(),\n      output: z.number(),\n    })\n    .nullable(),\n  // Provider information\n  provider: z\n    .enum([\n      \"openai\",\n      \"anthropic\",\n      \"google\",\n      \"xai\",\n      \"deepseek\",\n      \"openai-compatible\",\n      \"openrouter\",\n    ])\n    .nullable(),\n  // Streaming endpoint information\n  endpoint: z\n    .object({\n      url: z.string().url(),\n      method: z.string().default(\"POST\"),\n      contentType: z.string().default(\"application/json\"),\n      stream: z.boolean().default(true),\n    })\n    .nullable(),\n});\n\n/**\n * MODELS Collection Binding\n *\n * Collection bindings for models (read-only).\n * Provides LIST and GET operations for AI models.\n */\nexport const MODELS_COLLECTION_BINDING = createCollectionBindings(\n  \"models\",\n  ModelSchema,\n  { readOnly: true },\n);\n\n/**\n * MODELS Binding\n *\n * Defines the interface for AI model providers.\n * Any MCP that implements this binding can provide AI models and streaming endpoints.\n *\n * Required tools:\n * - COLLECTION_MODELS_LIST: List available AI models with their capabilities\n * - COLLECTION_MODELS_GET: Get a single model by ID (includes streaming endpoint info)\n */\nexport const MODELS_BINDING = [\n  ...MODELS_COLLECTION_BINDING,\n] as const satisfies Binder;\n"]}