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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decocms/bindings",
-  "version": "1.0.1-alpha.24",
+  "version": "1.0.1-alpha.25",
   "type": "module",
   "scripts": {
     "check": "tsc --noEmit",

package/src/well-known/agent.ts

@@ -3,9 +3,9 @@
  *
  * 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.
+ * with a system prompt and runtime configuration (gateway + model).
  *
- * This binding uses collection bindings for LIST and GET operations (read-only).
+ * This binding uses collection bindings for LIST and GET operations.
  */
 
 import { z } from "zod";
@@ -21,17 +21,35 @@ import {
  * 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
+  /**
+   * 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 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"),
+    .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"),
 });
 
 /**
@@ -53,7 +71,7 @@ export const AGENTS_COLLECTION_BINDING = createCollectionBindings(
  *
  * 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)
+ * - COLLECTION_AGENT_GET: Get a single agent by ID (includes system_prompt, gateway_id, model)
  */
 export const AGENTS_BINDING = [
   ...AGENTS_COLLECTION_BINDING,