@decocms/mesh-sdk 1.2.1 → 1.2.2

package/src/types/index.ts

@@ -23,5 +23,34 @@ export {
   type VirtualMCPCreateData,
   type VirtualMCPUpdateData,
   type VirtualMCPConnection,
-  type ToolSelectionMode,
 } from "./virtual-mcp";
+
+export {
+  PROVIDER_IDS,
+  MODEL_CAPABILITIES,
+  type ProviderId,
+  type ModelCapability,
+  type AiProviderModel,
+  type AiProviderModelLimits,
+  type AiProviderModelCosts,
+  type AiProviderKey,
+  type AiProviderInfo,
+} from "./ai-providers";
+
+export {
+  THREAD_STATUSES,
+  THREAD_DISPLAY_STATUSES,
+  DECOPILOT_EVENTS,
+  ALL_DECOPILOT_EVENT_TYPES,
+  createDecopilotStepEvent,
+  createDecopilotFinishEvent,
+  createDecopilotThreadStatusEvent,
+  type ThreadStatus,
+  type ThreadDisplayStatus,
+  type DecopilotEventType,
+  type DecopilotStepEvent,
+  type DecopilotFinishEvent,
+  type DecopilotThreadStatusEvent,
+  type DecopilotSSEEvent,
+  type DecopilotEventMap,
+} from "./decopilot-events";

package/src/types/virtual-mcp.ts

@@ -8,20 +8,7 @@
 import { z } from "zod";
 
 /**
- * Tool selection mode schema
- * - "inclusion": Include selected tools/connections (default behavior)
- * - "exclusion": Exclude selected tools/connections (inverse filter)
- */
-const ToolSelectionModeSchema = z
-  .enum(["inclusion", "exclusion"])
-  .describe(
-    "Tool selection mode: 'inclusion' = include selected (default), 'exclusion' = exclude selected",
-  );
-
-export type ToolSelectionMode = z.infer<typeof ToolSelectionModeSchema>;
-
-/**
- * Virtual MCP connection schema - defines which connection and tools/resources/prompts are included/excluded
+ * Virtual MCP connection schema - defines which connection and tools/resources/prompts are included
  */
 const VirtualMCPConnectionSchema = z.object({
   connection_id: z.string().describe("Connection ID"),
@@ -29,68 +16,108 @@ const VirtualMCPConnectionSchema = z.object({
     .array(z.string())
     .nullable()
     .describe(
-      "Selected tool names. With 'inclusion' mode: null = all tools included. With 'exclusion' mode: null = entire connection excluded",
+      "Selected tool names. null = all tools included, array = only these tools included",
     ),
   selected_resources: z
     .array(z.string())
     .nullable()
     .describe(
-      "Selected resource URIs or patterns. Supports * and ** wildcards for pattern matching. With 'inclusion' mode: null = all resources included.",
+      "Selected resource URIs or patterns. Supports * and ** wildcards for pattern matching. null = all resources included, array = only these resources included",
     ),
   selected_prompts: z
     .array(z.string())
     .nullable()
     .describe(
-      "Selected prompt names. With 'inclusion' mode: null = all prompts included. With 'exclusion' mode: null = entire connection excluded.",
+      "Selected prompt names. null = all prompts included, array = only these prompts included",
     ),
 });
 
 export type VirtualMCPConnection = z.infer<typeof VirtualMCPConnectionSchema>;
 
+/**
+ * Virtual MCP connection schema for input (Create/Update) - fields can be optional
+ */
+const VirtualMCPConnectionInputSchema = VirtualMCPConnectionSchema.extend({
+  selected_tools: VirtualMCPConnectionSchema.shape.selected_tools.optional(),
+  selected_resources:
+    VirtualMCPConnectionSchema.shape.selected_resources.optional(),
+  selected_prompts:
+    VirtualMCPConnectionSchema.shape.selected_prompts.optional(),
+});
+
+/**
+ * Pinned view schema - a tool view pinned to a virtual MCP
+ */
+const VirtualMcpPinnedViewSchema = z.object({
+  connectionId: z.string(),
+  toolName: z.string(),
+  label: z.string(),
+  icon: z.string().nullable().optional(),
+});
+
+export type VirtualMcpPinnedView = z.infer<typeof VirtualMcpPinnedViewSchema>;
+
+/**
+ * Virtual MCP UI customization schema
+ */
+const VirtualMcpUISchema = z.object({
+  banner: z.string().nullable().optional(),
+  bannerColor: z.string().nullable().optional(),
+  icon: z.string().nullable().optional(),
+  themeColor: z.string().nullable().optional(),
+  pinnedViews: z.array(VirtualMcpPinnedViewSchema).nullable().optional(),
+});
+
+export type VirtualMcpUI = z.infer<typeof VirtualMcpUISchema>;
+
 /**
  * Virtual MCP entity schema - single source of truth
  * Compliant with collections binding pattern
  */
 export const VirtualMCPEntitySchema = z.object({
   // Base collection entity fields
-  id: z.string().describe("Unique identifier for the virtual MCP"),
-  title: z.string().describe("Human-readable name for the virtual MCP"),
-  description: z.string().nullable().describe("Description of the virtual MCP"),
-  icon: z
-    .string()
-    .nullable()
-    .optional()
-    .describe("Icon URL for the virtual MCP"),
-  created_at: z.string().describe("When the virtual MCP was created"),
-  updated_at: z.string().describe("When the virtual MCP was last updated"),
-  created_by: z.string().describe("User ID who created the virtual MCP"),
+  id: z.string().describe("Unique identifier"),
+  title: z.string().describe("Human-readable name"),
+  description: z.string().nullable().describe("Description"),
+  icon: z.string().nullable().describe("Icon URL"),
+  created_at: z.string().describe("Creation timestamp"),
+  updated_at: z.string().describe("Last update timestamp"),
+  created_by: z.string().describe("User ID who created this item"),
   updated_by: z
     .string()
     .optional()
-    .describe("User ID who last updated the virtual MCP"),
+    .describe("User ID who last updated this item"),
 
-  // Virtual MCP-specific fields
-  organization_id: z
-    .string()
-    .describe("Organization ID this virtual MCP belongs to"),
-  tool_selection_mode: ToolSelectionModeSchema.describe(
-    "Tool selection mode: 'inclusion' = include selected, 'exclusion' = exclude selected",
-  ),
+  // Entity-specific fields
+  organization_id: z.string().describe("Organization ID this item belongs to"),
   status: z.enum(["active", "inactive"]).describe("Current status"),
+  subtype: z
+    .enum(["agent", "project"])
+    .nullable()
+    .describe("Virtual MCP subtype for UI presentation"),
   // Metadata (stored in connections.metadata)
+  // Normalize null/undefined to { instructions: null } for consistent form tracking
   metadata: z
     .object({
-      instructions: z.string().optional().describe("MCP server instructions"),
+      instructions: z
+        .string()
+        .nullable()
+        .describe("Instructions also used as system prompt"),
+      enabled_plugins: z
+        .array(z.string())
+        .nullable()
+        .optional()
+        .describe("List of enabled plugin IDs"),
+      ui: VirtualMcpUISchema.nullable()
+        .optional()
+        .describe("UI customization settings"),
     })
-    .nullable()
-    .optional()
-    .describe("Additional metadata including MCP server instructions"),
+    .loose()
+    .describe("Metadata"),
   // Nested connections
   connections: z
     .array(VirtualMCPConnectionSchema)
-    .describe(
-      "Connections with their selected tools (behavior depends on tool_selection_mode)",
-    ),
+    .describe("Connections with their selected tools, resources, and prompts"),
 });
 
 /**
@@ -108,49 +135,38 @@ export const VirtualMCPCreateDataSchema = z.object({
     .nullable()
     .optional()
     .describe("Optional description"),
-  tool_selection_mode: ToolSelectionModeSchema.optional()
-    .default("inclusion")
-    .describe("Tool selection mode (defaults to 'inclusion')"),
-  icon: z.string().nullable().optional().describe("Optional icon URL"),
+  icon: z.string().nullish().describe("Optional icon URL"),
   status: z
     .enum(["active", "inactive"])
     .optional()
     .default("active")
     .describe("Initial status"),
+  subtype: z
+    .enum(["agent", "project"])
+    .optional()
+    .describe("Virtual MCP subtype"),
   metadata: z
     .object({
-      instructions: z.string().optional().describe("MCP server instructions"),
+      instructions: z
+        .string()
+        .nullable()
+        .optional()
+        .describe("MCP server instructions"),
+      enabled_plugins: z
+        .array(z.string())
+        .nullable()
+        .optional()
+        .describe("List of enabled plugin IDs"),
+      ui: VirtualMcpUISchema.nullable()
+        .optional()
+        .describe("UI customization settings"),
     })
+    .loose()
     .nullable()
     .optional()
     .describe("Additional metadata including MCP server instructions"),
   connections: z
-    .array(
-      z.object({
-        connection_id: z.string().describe("Connection ID"),
-        selected_tools: z
-          .array(z.string())
-          .nullable()
-          .optional()
-          .describe(
-            "Selected tool names (null/undefined = all tools or full exclusion)",
-          ),
-        selected_resources: z
-          .array(z.string())
-          .nullable()
-          .optional()
-          .describe(
-            "Selected resource URIs or patterns with * and ** wildcards (null/undefined = all resources)",
-          ),
-        selected_prompts: z
-          .array(z.string())
-          .nullable()
-          .optional()
-          .describe(
-            "Selected prompt names (null/undefined = all prompts or full exclusion)",
-          ),
-      }),
-    )
+    .array(VirtualMCPConnectionInputSchema)
     .describe(
       "Connections to include/exclude (can be empty for exclusion mode)",
     ),
@@ -168,49 +184,31 @@ export const VirtualMCPUpdateDataSchema = z.object({
     .nullable()
     .optional()
     .describe("New description (null to clear)"),
-  tool_selection_mode: ToolSelectionModeSchema.optional().describe(
-    "New tool selection mode",
-  ),
-  icon: z
-    .string()
-    .nullable()
-    .optional()
-    .describe("New icon URL (null to clear)"),
+  icon: z.string().nullish().describe("New icon URL"),
   status: z.enum(["active", "inactive"]).optional().describe("New status"),
+  subtype: z.enum(["agent", "project"]).optional().describe("New subtype"),
   metadata: z
     .object({
-      instructions: z.string().optional().describe("MCP server instructions"),
+      instructions: z
+        .string()
+        .nullable()
+        .optional()
+        .describe("MCP server instructions"),
+      enabled_plugins: z
+        .array(z.string())
+        .nullable()
+        .optional()
+        .describe("List of enabled plugin IDs"),
+      ui: VirtualMcpUISchema.nullable()
+        .optional()
+        .describe("UI customization settings"),
     })
+    .loose()
     .nullable()
     .optional()
     .describe("Additional metadata including MCP server instructions"),
   connections: z
-    .array(
-      z.object({
-        connection_id: z.string().describe("Connection ID"),
-        selected_tools: z
-          .array(z.string())
-          .nullable()
-          .optional()
-          .describe(
-            "Selected tool names (null/undefined = all tools or full exclusion)",
-          ),
-        selected_resources: z
-          .array(z.string())
-          .nullable()
-          .optional()
-          .describe(
-            "Selected resource URIs or patterns with * and ** wildcards (null/undefined = all resources)",
-          ),
-        selected_prompts: z
-          .array(z.string())
-          .nullable()
-          .optional()
-          .describe(
-            "Selected prompt names (null/undefined = all prompts or full exclusion)",
-          ),
-      }),
-    )
+    .array(VirtualMCPConnectionInputSchema)
     .optional()
     .describe("New connections (replaces existing)"),
 });