@decocms/bindings 1.0.1-alpha.12 → 1.0.1-alpha.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decocms/bindings",
-  "version": "1.0.1-alpha.12",
+  "version": "1.0.1-alpha.14",
   "type": "module",
   "scripts": {
     "test": "vitest run",

package/src/core/client/mcp-client.ts

@@ -83,7 +83,12 @@ export const createServerClient = async (
         headers.set(key, value);
       }
 
-      return fetch(mcpServer.connection.url + `/call-tool/${tool}`, {
+      const url = new URL(mcpServer.connection.url);
+      // Trim trailing slashes from pathname, ensuring it starts with '/'
+      const trimmedPath = url.pathname.replace(/\/+$/, "") || "/";
+      url.pathname = `${trimmedPath}/call-tool/${encodeURIComponent(tool)}`;
+
+      return fetch(url.href, {
         method: "POST",
         redirect: "manual",
         body: JSON.stringify(args),

package/src/index.ts

@@ -13,3 +13,10 @@ export {
   type ToolBinder,
   type ToolWithSchemas,
 } from "./core/binder";
+
+// Re-export registry binding types
+export {
+  MCPRegistryServerSchema,
+  type RegistryAppCollectionEntity,
+  REGISTRY_APP_BINDING,
+} from "./well-known/registry";

package/src/well-known/language-model.ts

@@ -17,17 +17,229 @@ import {
   createCollectionBindings,
 } from "./collections";
 
+/**
+ * JSON Value Schema
+ * Represents any valid JSON value: null, string, number, boolean, object, or array
+ */
+const JSONValueSchema: z.ZodType<unknown> = z.lazy(() =>
+  z.union([
+    z.null(),
+    z.string(),
+    z.number(),
+    z.boolean(),
+    z.record(z.string(), JSONValueSchema),
+    z.array(JSONValueSchema),
+  ]),
+);
+
+/**
+ * Provider Options Schema
+ * Additional provider-specific options passed through to the provider
+ */
+const ProviderOptionsSchema = z
+  .record(z.string(), z.record(z.string(), JSONValueSchema))
+  .optional()
+  .describe(
+    "Additional provider-specific options. Outer record keyed by provider name, inner by option key",
+  );
+
+/**
+ * Text Part Schema
+ * Text content part of a prompt
+ */
+const TextPartSchema = z.object({
+  type: z.literal("text"),
+  text: z.string().describe("The text content"),
+  providerOptions: ProviderOptionsSchema,
+});
+
+/**
+ * Data Content Schema
+ * File data can be Uint8Array (as base64 string), base64 encoded string, or URL string
+ */
+const DataContentSchema = z
+  .union([z.string(), z.instanceof(Uint8Array)])
+  .describe("File data as base64 encoded string, URL string, or Uint8Array");
+
+/**
+ * File Part Schema
+ * File content part of a prompt
+ */
+const FilePartSchema = z.object({
+  type: z.literal("file"),
+  filename: z.string().optional().describe("Optional filename of the file"),
+  data: DataContentSchema,
+  mediaType: z
+    .string()
+    .describe("IANA media type of the file (e.g., image/png, audio/mp3)"),
+  providerOptions: ProviderOptionsSchema,
+});
+
+/**
+ * Reasoning Part Schema
+ * Reasoning content part of a prompt
+ */
+const ReasoningPartSchema = z.object({
+  type: z.literal("reasoning"),
+  text: z.string().describe("The reasoning text"),
+  providerOptions: ProviderOptionsSchema,
+});
+
+/**
+ * Tool Call Part Schema
+ * Tool call content part of a prompt (usually generated by the AI model)
+ */
+const ToolCallPartSchema = z.object({
+  type: z.literal("tool-call"),
+  toolCallId: z
+    .string()
+    .describe("ID of the tool call, used to match with tool result"),
+  toolName: z.string().describe("Name of the tool being called"),
+  input: z
+    .unknown()
+    .describe(
+      "Arguments of the tool call (JSON-serializable object matching tool input schema)",
+    ),
+  providerExecuted: z
+    .boolean()
+    .optional()
+    .describe("Whether the tool call will be executed by the provider"),
+  providerOptions: ProviderOptionsSchema,
+});
+
+/**
+ * Tool Result Output Schema
+ * The output of a tool result
+ */
+const ToolResultOutputSchema = z.union([
+  z.object({
+    type: z.literal("text"),
+    value: z.string(),
+  }),
+  z.object({
+    type: z.literal("json"),
+    value: JSONValueSchema,
+  }),
+  z.object({
+    type: z.literal("error-text"),
+    value: z.string(),
+  }),
+  z.object({
+    type: z.literal("error-json"),
+    value: JSONValueSchema,
+  }),
+  z.object({
+    type: z.literal("content"),
+    value: z.array(
+      z.union([
+        z.object({
+          type: z.literal("text"),
+          text: z.string().describe("Text content"),
+        }),
+        z.object({
+          type: z.literal("media"),
+          data: z.string().describe("Base-64 encoded media data"),
+          mediaType: z.string().describe("IANA media type"),
+        }),
+      ]),
+    ),
+  }),
+]);
+
+/**
+ * Tool Result Part Schema
+ * Tool result content part of a prompt
+ */
+const ToolResultPartSchema = z.object({
+  type: z.literal("tool-result"),
+  toolCallId: z
+    .string()
+    .describe("ID of the tool call that this result is associated with"),
+  toolName: z.string().describe("Name of the tool that generated this result"),
+  output: ToolResultOutputSchema.describe("Result of the tool call"),
+  providerOptions: ProviderOptionsSchema,
+});
+
+/**
+ * System Message Schema
+ */
+const SystemMessageSchema = z.object({
+  role: z.literal("system"),
+  content: z.string().describe("System message content"),
+  providerOptions: ProviderOptionsSchema,
+});
+
+/**
+ * User Message Schema
+ */
+const UserMessageSchema = z.object({
+  role: z.literal("user"),
+  content: z
+    .array(z.union([TextPartSchema, FilePartSchema]))
+    .describe("User message content parts (text or file)"),
+  providerOptions: ProviderOptionsSchema,
+});
+
+/**
+ * Assistant Message Schema
+ */
+const AssistantMessageSchema = z.object({
+  role: z.literal("assistant"),
+  content: z
+    .array(
+      z.union([
+        TextPartSchema,
+        FilePartSchema,
+        ReasoningPartSchema,
+        ToolCallPartSchema,
+        ToolResultPartSchema,
+      ]),
+    )
+    .describe(
+      "Assistant message content parts (text, file, reasoning, tool-call, or tool-result)",
+    ),
+  providerOptions: ProviderOptionsSchema,
+});
+
+/**
+ * Tool Message Schema
+ */
+const ToolMessageSchema = z.object({
+  role: z.literal("tool"),
+  content: z
+    .array(ToolResultPartSchema)
+    .describe("Tool message content (tool results)"),
+  providerOptions: ProviderOptionsSchema,
+});
+
+/**
+ * Language Model Message Schema
+ * A message in a language model prompt
+ */
+export const LanguageModelMessageSchema = z.union([
+  SystemMessageSchema,
+  UserMessageSchema,
+  AssistantMessageSchema,
+  ToolMessageSchema,
+]);
+
+/**
+ * Language Model Prompt Schema
+ * A prompt is a list of messages based on LanguageModelV2Prompt from @ai-sdk/provider
+ */
+export const LanguageModelPromptSchema = z
+  .array(LanguageModelMessageSchema)
+  .describe("A list of messages forming the prompt");
+
 /**
  * Language Model Call Options Schema
  * Based on LanguageModelV2CallOptions from @ai-sdk/provider
  */
 export const LanguageModelCallOptionsSchema = z.object({
   // Core parameters
-  prompt: z
-    .any()
-    .describe(
-      "A language mode prompt is a standardized prompt type (messages, system, etc.)",
-    ),
+  prompt: LanguageModelPromptSchema.describe(
+    "A language model prompt is a standardized prompt type (array of messages with roles: system, user, assistant, tool)",
+  ),
 
   // Generation parameters
   maxOutputTokens: z

package/src/well-known/mcp.ts

@@ -4,7 +4,7 @@
  * Defines the interface for retrieving MCP configuration.
  */
 
-import { z } from "zod/v3";
+import { z } from "zod";
 import type { Binder } from "../core/binder";
 
 /**

package/src/well-known/registry.ts

@@ -0,0 +1,128 @@
+/**
+ * Registry App Well-Known Binding
+ *
+ * Defines the interface for accessing public registry apps.
+ * Any MCP that implements this binding can provide a list of available apps
+ * with their configurations and tools.
+ *
+ * This binding includes:
+ * - Collection bindings for LIST and GET operations (read-only)
+ * - Only exposes public apps (unlisted: false)
+ * - Removes sensitive fields (connection details, workspace info)
+ */
+
+import { z } from "zod";
+import {
+  BaseCollectionEntitySchema,
+  createCollectionBindings,
+} from "./collections";
+
+/**
+ * Tool definition schema from registry
+ */
+const RegistryToolSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  description: z.string().optional(),
+  inputSchema: z.record(z.unknown()),
+  outputSchema: z.record(z.unknown()).optional(),
+});
+
+/**
+ * MCP Registry Server schema extending Collection Entity base
+ * Combines BaseCollectionEntitySchema with MCP Registry Spec format
+ * https://spec.modelcontextprotocol.io/specification/2025-03-26/registry/
+ */
+export const MCPRegistryServerSchema = BaseCollectionEntitySchema.extend({
+  // MCP Registry Spec structure
+  _meta: z
+    .object({
+      "io.decocms": z
+        .object({
+          id: z.string(),
+          verified: z.boolean(),
+          scopeName: z.string(),
+          appName: z.string(),
+          friendlyName: z.string().nullable().optional(),
+          metadata: z.record(z.unknown()).nullable().optional(),
+          publishedAt: z.string().datetime().optional(),
+          updatedAt: z.string().datetime().optional(),
+          tools: z
+            .array(RegistryToolSchema)
+            .nullable()
+            .optional()
+            .describe("Available tools exposed by this app"),
+        })
+        .optional(),
+    })
+    .optional(),
+  server: z.object({
+    $schema: z.string().optional(),
+    _meta: z.record(z.unknown()).optional(),
+    name: z.string().describe("The server name (scope/app)"),
+    title: z.string().optional().describe("User-friendly title"),
+    description: z.string().optional().describe("Server description"),
+    icons: z
+      .array(
+        z.object({
+          src: z.string(),
+          mimeType: z.string().optional(),
+          sizes: z.array(z.string()).optional(),
+          theme: z.enum(["light", "dark"]).optional(),
+        }),
+      )
+      .optional(),
+    remotes: z
+      .array(
+        z.object({
+          type: z.enum(["http", "stdio", "sse"]),
+          url: z.string().optional(),
+          headers: z.array(z.unknown()).optional(),
+        }),
+      )
+      .optional(),
+    packages: z.array(z.unknown()).optional(),
+    repository: z
+      .object({
+        url: z.string(),
+        source: z.string().optional(),
+        subfolder: z.string().optional(),
+      })
+      .optional(),
+    version: z.string().optional(),
+    websiteUrl: z.string().optional(),
+  }),
+});
+
+export type RegistryAppCollectionEntity = z.infer<
+  typeof MCPRegistryServerSchema
+>;
+
+/**
+ * Registry App Collection Binding (read-only)
+ *
+ * Collection bindings for registry apps (read-only).
+ * Provides LIST and GET operations for public apps.
+ * Only includes public apps (unlisted: false).
+ *
+ * Returns servers in MCP Registry Spec format with:
+ * - _meta: DecoCMS-specific metadata (id, verified, tools, etc.)
+ * - server: MCP Registry Spec compliant server definition
+ */
+const REGISTRY_APP_COLLECTION_BINDING = createCollectionBindings(
+  "registry_app",
+  MCPRegistryServerSchema,
+  { readOnly: true },
+);
+
+/**
+ * Registry App Binding
+ *
+ * Defines the interface for accessing public registry apps.
+ * Any MCP that implements this binding can provide a searchable list of apps.
+ *
+ * Required tools:
+ * - COLLECTION_REGISTRY_APP_LIST: List available apps with filtering and pagination
+ * - COLLECTION_REGISTRY_APP_GET: Get a single app by ID
+ */
+export const REGISTRY_APP_BINDING = REGISTRY_APP_COLLECTION_BINDING;