@decocms/bindings 1.0.1-alpha.26 → 1.0.1-alpha.27

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decocms/bindings",
-  "version": "1.0.1-alpha.26",
+  "version": "1.0.1-alpha.27",
   "type": "module",
   "scripts": {
     "check": "tsc --noEmit",
@@ -19,6 +19,7 @@
     "./client": "./src/core/client/index.ts",
     "./mcp": "./src/well-known/mcp.ts",
     "./assistant": "./src/well-known/assistant.ts",
+    "./prompt": "./src/well-known/prompt.ts",
     "./workflow": "./src/well-known/workflow.ts"
   },
   "engines": {

package/src/well-known/assistant.ts

@@ -5,7 +5,7 @@
  * Any MCP that implements this binding can provide configurable AI assistants
  * with a system prompt and runtime configuration (gateway + model).
  *
- * This binding uses collection bindings for LIST and GET operations.
+ * This binding uses collection bindings for full CRUD operations.
  */
 
 import { z } from "zod";
@@ -25,7 +25,9 @@ export const AssistantSchema = BaseCollectionEntitySchema.extend({
    * Assistant avatar.
    * Can be a regular URL or a data URI.
    */
-  avatar: z.string().describe("URL or data URI to the assistant's avatar image"),
+  avatar: z
+    .string()
+    .describe("URL or data URI to the assistant's avatar image"),
 
   /**
    * System prompt that defines the assistant's behavior.
@@ -57,8 +59,8 @@ export const AssistantSchema = BaseCollectionEntitySchema.extend({
 /**
  * ASSISTANT Collection Binding
  *
- * Collection bindings for assistants (read-only).
- * Provides LIST and GET operations for AI assistants.
+ * Collection bindings for assistants.
+ * Provides full CRUD operations (LIST, GET, CREATE, UPDATE, DELETE) for AI assistants.
  */
 export const ASSISTANTS_COLLECTION_BINDING = createCollectionBindings(
   "assistant",
@@ -74,8 +76,12 @@ export const ASSISTANTS_COLLECTION_BINDING = createCollectionBindings(
  * Required tools:
  * - COLLECTION_ASSISTANT_LIST: List available AI assistants with their configurations
  * - COLLECTION_ASSISTANT_GET: Get a single assistant by ID (includes system_prompt, gateway_id, model)
+ *
+ * Optional tools:
+ * - COLLECTION_ASSISTANT_CREATE: Create a new assistant
+ * - COLLECTION_ASSISTANT_UPDATE: Update an existing assistant
+ * - COLLECTION_ASSISTANT_DELETE: Delete an assistant
  */
 export const ASSISTANTS_BINDING = [
   ...ASSISTANTS_COLLECTION_BINDING,
 ] as const satisfies Binder;
-

package/src/well-known/prompt.ts

@@ -0,0 +1,104 @@
+/**
+ * Prompts Well-Known Binding
+ *
+ * Defines the interface for prompt providers.
+ * Any MCP that implements this binding can expose prompts as a collection.
+ *
+ * This binding uses collection bindings for full CRUD operations.
+ */
+
+import { z } from "zod";
+import type { Binder } from "../core/binder";
+import { BaseCollectionEntitySchema, createCollectionBindings } from "./collections";
+
+/**
+ * Schema for prompt arguments that can be passed when getting a prompt
+ */
+export const PromptArgumentSchema = z.object({
+  name: z.string().describe("Argument name"),
+  description: z.string().optional().describe("Argument description"),
+  required: z.boolean().optional().describe("Whether argument is required"),
+});
+export type PromptArgument = z.infer<typeof PromptArgumentSchema>;
+
+/**
+ * Schema for prompt icons for display in user interfaces
+ */
+export const PromptIconSchema = z.object({
+  src: z.string().url().describe("Icon URL"),
+  mimeType: z.string().optional().describe("Icon MIME type"),
+  sizes: z.array(z.string()).optional().describe("Icon sizes"),
+});
+export type PromptIcon = z.infer<typeof PromptIconSchema>;
+
+/**
+ * Schema for content within a prompt message
+ */
+export const PromptMessageContentSchema = z.object({
+  type: z.enum(["text", "image", "audio", "resource"]).describe("Content type"),
+  text: z.string().optional().describe("Text content"),
+  data: z.string().optional().describe("Base64-encoded data for image/audio"),
+  mimeType: z.string().optional().describe("MIME type for image/audio/resource"),
+  resource: z
+    .object({
+      uri: z.string().describe("Resource URI"),
+      mimeType: z.string().optional().describe("Resource MIME type"),
+      text: z.string().optional().describe("Resource text content"),
+      blob: z.string().optional().describe("Base64-encoded resource blob"),
+    })
+    .optional()
+    .describe("Embedded resource"),
+});
+export type PromptMessageContent = z.infer<typeof PromptMessageContentSchema>;
+
+/**
+ * Schema for a message in a prompt
+ */
+export const PromptMessageSchema = z.object({
+  role: z.enum(["user", "assistant"]).describe("Message role"),
+  content: PromptMessageContentSchema.describe("Message content"),
+});
+export type PromptMessage = z.infer<typeof PromptMessageSchema>;
+
+/**
+ * Full prompt entity schema extending base collection fields
+ */
+export const PromptSchema = BaseCollectionEntitySchema.extend({
+  arguments: z
+    .array(PromptArgumentSchema)
+    .optional()
+    .describe("Arguments that can be passed when getting this prompt"),
+  icons: z
+    .array(PromptIconSchema)
+    .optional()
+    .describe("Icons for display in user interfaces"),
+  messages: z.array(PromptMessageSchema).describe("Prompt messages template"),
+});
+export type Prompt = z.infer<typeof PromptSchema>;
+
+/**
+ * PROMPT Collection Binding
+ *
+ * Collection bindings for prompts.
+ * Provides full CRUD operations (LIST, GET, CREATE, UPDATE, DELETE) for prompts.
+ */
+export const PROMPTS_COLLECTION_BINDING = createCollectionBindings(
+  "prompt",
+  PromptSchema,
+);
+
+/**
+ * PROMPTS Binding
+ *
+ * Required tools:
+ * - COLLECTION_PROMPT_LIST
+ * - COLLECTION_PROMPT_GET
+ *
+ * Optional tools:
+ * - COLLECTION_PROMPT_CREATE
+ * - COLLECTION_PROMPT_UPDATE
+ * - COLLECTION_PROMPT_DELETE
+ */
+export const PROMPTS_BINDING = [...PROMPTS_COLLECTION_BINDING] as const satisfies Binder;
+
+