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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decocms/bindings",
-  "version": "1.0.1-alpha.24",
+  "version": "1.0.1-alpha.26",
   "type": "module",
   "scripts": {
     "check": "tsc --noEmit",
@@ -18,7 +18,7 @@
     "./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",
     "./workflow": "./src/well-known/workflow.ts"
   },
   "engines": {

package/src/well-known/assistant.ts

@@ -0,0 +1,81 @@
+/**
+ * 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 LIST and GET 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 (read-only).
+ * Provides LIST and GET operations 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)
+ */
+export const ASSISTANTS_BINDING = [
+  ...ASSISTANTS_COLLECTION_BINDING,
+] as const satisfies Binder;
+

package/src/well-known/agent.ts

@@ -1,60 +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 custom instructions and tool access controls.
- *
- * This binding uses collection bindings for LIST and GET operations (read-only).
- */
-
-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-specific fields
-  description: z.string().describe("Brief description of the agent's purpose"),
-  instructions: z
-    .string()
-    .describe("System instructions that define the agent's behavior"),
-  tool_set: z
-    .record(z.string(), z.array(z.string()))
-    .describe(
-      "Map of connection IDs to arrays of allowed tool names for this agent",
-    ),
-  avatar: z.string().url().describe("URL to the agent's avatar image"),
-});
-
-/**
- * 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 instructions and tool_set)
- */
-export const AGENTS_BINDING = [
-  ...AGENTS_COLLECTION_BINDING,
-] as const satisfies Binder;