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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decocms/bindings",
-  "version": "1.0.1-alpha.25",
+  "version": "1.0.1-alpha.27",
   "type": "module",
   "scripts": {
     "check": "tsc --noEmit",
@@ -18,7 +18,8 @@
     "./connection": "./src/core/connection.ts",
     "./client": "./src/core/client/index.ts",
     "./mcp": "./src/well-known/mcp.ts",
-    "./agent": "./src/well-known/agent.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

@@ -0,0 +1,87 @@
+/**
+ * Assistants Well-Known Binding
+ *
+ * Defines the interface for AI assistant providers.
+ * 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 full CRUD operations.
+ */
+
+import { z } from "zod";
+import type { Binder } from "../core/binder";
+import {
+  BaseCollectionEntitySchema,
+  createCollectionBindings,
+} from "./collections";
+
+/**
+ * Assistant entity schema for AI assistants
+ * Extends BaseCollectionEntitySchema with assistant-specific fields
+ * Base schema already includes: id, title, created_at, updated_at, created_by, updated_by
+ */
+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"),
+
+  /**
+   * System prompt that defines the assistant's behavior.
+   */
+  system_prompt: z
+    .string()
+    .describe("System prompt that defines the assistant's behavior"),
+
+  /**
+   * Selected gateway for this assistant (single gateway).
+   * This gateway determines which MCP tools are exposed to chat.
+   */
+  gateway_id: z.string().describe("Gateway ID to use for this assistant"),
+
+  /**
+   * Selected model for this assistant (model id + the connection where it lives).
+   * This allows the UI/runtime to call the correct model provider connection.
+   */
+  model: z
+    .object({
+      id: z.string().describe("Model ID"),
+      connectionId: z
+        .string()
+        .describe("Connection ID that provides the model"),
+    })
+    .describe("Selected model reference for this assistant"),
+});
+
+/**
+ * ASSISTANT Collection Binding
+ *
+ * Collection bindings for assistants.
+ * Provides full CRUD operations (LIST, GET, CREATE, UPDATE, DELETE) for AI assistants.
+ */
+export const ASSISTANTS_COLLECTION_BINDING = createCollectionBindings(
+  "assistant",
+  AssistantSchema,
+);
+
+/**
+ * ASSISTANTS Binding
+ *
+ * Defines the interface for AI assistant providers.
+ * Any MCP that implements this binding can provide configurable AI assistants.
+ *
+ * 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;
+
+

package/src/well-known/agent.ts

@@ -1,78 +0,0 @@
-/**
- * Agents Well-Known Binding
- *
- * Defines the interface for AI agent providers.
- * Any MCP that implements this binding can provide configurable AI agents
- * with a system prompt and runtime configuration (gateway + model).
- *
- * This binding uses collection bindings for LIST and GET operations.
- */
-
-import { z } from "zod";
-import type { Binder } from "../core/binder";
-import {
-  BaseCollectionEntitySchema,
-  createCollectionBindings,
-} from "./collections";
-
-/**
- * Agent entity schema for AI agents
- * Extends BaseCollectionEntitySchema with agent-specific fields
- * Base schema already includes: id, title, created_at, updated_at, created_by, updated_by
- */
-export const AgentSchema = BaseCollectionEntitySchema.extend({
-  /**
-   * Agent avatar.
-   * Can be a regular URL or a data URI.
-   */
-  avatar: z.string().describe("URL or data URI to the agent's avatar image"),
-
-  /**
-   * System prompt that defines the agent's behavior.
-   */
-  system_prompt: z
-    .string()
-    .describe("System prompt that defines the agent's behavior"),
-
-  /**
-   * Selected gateway for this agent (single gateway).
-   * This gateway determines which MCP tools are exposed to chat.
-   */
-  gateway_id: z.string().describe("Gateway ID to use for this agent"),
-
-  /**
-   * Selected model for this agent (model id + the connection where it lives).
-   * This allows the UI/runtime to call the correct model provider connection.
-   */
-  model: z
-    .object({
-      id: z.string().describe("Model ID"),
-      connectionId: z.string().describe("Connection ID that provides the model"),
-    })
-    .describe("Selected model reference for this agent"),
-});
-
-/**
- * AGENT Collection Binding
- *
- * Collection bindings for agents (read-only).
- * Provides LIST and GET operations for AI agents.
- */
-export const AGENTS_COLLECTION_BINDING = createCollectionBindings(
-  "agent",
-  AgentSchema,
-);
-
-/**
- * AGENTS Binding
- *
- * Defines the interface for AI agent providers.
- * Any MCP that implements this binding can provide configurable AI agents.
- *
- * Required tools:
- * - COLLECTION_AGENT_LIST: List available AI agents with their configurations
- * - COLLECTION_AGENT_GET: Get a single agent by ID (includes system_prompt, gateway_id, model)
- */
-export const AGENTS_BINDING = [
-  ...AGENTS_COLLECTION_BINDING,
-] as const satisfies Binder;