@decocms/bindings 1.3.3 → 1.3.4

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@decocms/bindings",
-  "version": "1.3.3",
+  "version": "1.3.4",
   "type": "module",
   "scripts": {
     "check": "tsc --noEmit",
     "test": "bun test"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "1.26.0",
+    "@modelcontextprotocol/sdk": "1.27.1",
     "@tanstack/react-router": "1.139.7",
     "react": "^19.2.0",
     "zod": "^4.0.0",
@@ -15,7 +15,7 @@
   },
   "devDependencies": {
     "hono": "^4.7.10",
-    "kysely": "^0.27.5"
+    "kysely": "^0.28.12"
   },
   "exports": {
     ".": "./src/index.ts",
@@ -31,14 +31,15 @@
     "./plugins": "./src/core/plugins.ts",
     "./plugin-router": "./src/core/plugin-router.tsx",
     "./ai-gateway": "./src/well-known/ai-gateway.ts",
-    "./server-plugin": "./src/core/server-plugin.ts"
+    "./server-plugin": "./src/core/server-plugin.ts",
+    "./trigger": "./src/well-known/trigger.ts"
   },
   "engines": {
     "node": ">=24.0.0"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/decocms/mesh.git",
+    "url": "git+https://github.com/decocms/studio.git",
     "directory": "packages/bindings"
   },
   "publishConfig": {

package/src/core/plugin-router.tsx

@@ -17,20 +17,20 @@ import {
 import type { PluginSetupContext } from "./plugins";
 
 /**
- * Prepends the plugin base path (/$org/$project/$pluginId) to a route path.
+ * Prepends the plugin base path (/$org/projects/$virtualMcpId/$pluginId) to a route path.
  * Handles both absolute plugin paths (starting with /) and relative paths.
  */
 function prependBasePath(
   to: string | undefined,
   org: string,
-  project: string,
+  virtualMcpId: string,
   pluginId: string,
 ): string {
-  if (!to) return `/${org}/${project}/${pluginId}`;
+  if (!to) return `/${org}/projects/${virtualMcpId}/${pluginId}`;
 
   // If path starts with /, it's relative to the plugin root
   if (to.startsWith("/")) {
-    return `/${org}/${project}/${pluginId}${to}`;
+    return `/${org}/projects/${virtualMcpId}/${pluginId}${to}`;
   }
 
   // Otherwise, it's already a full path or relative
@@ -123,9 +123,9 @@ export function createPluginRouter<TRoutes extends AnyRoute | AnyRoute[]>(
      */
     useNavigate: () => {
       const navigate = useNavigate();
-      const { org, project, pluginId } = useParams({ strict: false }) as {
+      const { org, virtualMcpId, pluginId } = useParams({ strict: false }) as {
         org: string;
-        project: string;
+        virtualMcpId: string;
         pluginId: string;
       };
 
@@ -136,14 +136,14 @@ export function createPluginRouter<TRoutes extends AnyRoute | AnyRoute[]>(
           search?: TRouteById<TTo>["types"]["fullSearchSchema"];
         },
       ) => {
-        const to = prependBasePath(options.to, org, project, pluginId);
+        const to = prependBasePath(options.to, org, virtualMcpId, pluginId);
 
         return navigate({
           ...options,
           to,
           params: {
             org,
-            project,
+            virtualMcpId,
             pluginId,
             ...(options.params as Record<string, string>),
           },
@@ -171,13 +171,18 @@ export function createPluginRouter<TRoutes extends AnyRoute | AnyRoute[]>(
         children?: ReactNode;
       },
     ) {
-      const { org, project, pluginId } = useParams({ strict: false }) as {
+      const { org, virtualMcpId, pluginId } = useParams({ strict: false }) as {
         org: string;
-        project: string;
+        virtualMcpId: string;
         pluginId: string;
       };
 
-      const to = prependBasePath(props.to as string, org, project, pluginId);
+      const to = prependBasePath(
+        props.to as string,
+        org,
+        virtualMcpId,
+        pluginId,
+      );
 
       return (
         <TanStackLink
@@ -185,7 +190,7 @@ export function createPluginRouter<TRoutes extends AnyRoute | AnyRoute[]>(
           to={to}
           params={{
             org,
-            project,
+            virtualMcpId,
             pluginId,
             ...props.params,
           }}

package/src/index.ts

@@ -84,6 +84,25 @@ export {
   type EventBusBindingClient,
 } from "./well-known/event-bus";
 
+// Re-export trigger binding types (for connections that can emit triggers)
+export {
+  TriggerParamSchema,
+  type TriggerParam,
+  TriggerDefinitionSchema,
+  type TriggerDefinition,
+  TriggerListInputSchema,
+  type TriggerListInput,
+  TriggerListOutputSchema,
+  type TriggerListOutput,
+  TriggerConfigureInputSchema,
+  type TriggerConfigureInput,
+  TriggerConfigureOutputSchema,
+  type TriggerConfigureOutput,
+  TRIGGER_BINDING,
+  TriggerBinding,
+  type TriggerBindingClient,
+} from "./well-known/trigger";
+
 // Re-export object storage binding types
 export {
   OBJECT_STORAGE_BINDING,
@@ -104,31 +123,3 @@ export {
 
 // Re-export workflow binding types
 export { WORKFLOWS_COLLECTION_BINDING } from "./well-known/workflow";
-
-// Re-export reports binding types
-export {
-  REPORTS_BINDING,
-  type ReportsBinding,
-  type ReportStatus,
-  type ReportLifecycleStatus,
-  type CriterionItem,
-  type MetricItem,
-  type RankedListRow,
-  type ReportSection,
-  type ReportSummary,
-  type Report,
-  type ReportsListInput,
-  type ReportsListOutput,
-  type ReportsGetInput,
-  type ReportsGetOutput,
-  type ReportsUpdateStatusInput,
-  type ReportsUpdateStatusOutput,
-  ReportStatusSchema,
-  ReportLifecycleStatusSchema,
-  MetricItemSchema,
-  ReportSectionSchema,
-  ReportSummarySchema,
-  ReportSchema,
-  type SectionGroup,
-  groupSections,
-} from "./well-known/reports";

package/src/well-known/language-model.ts

@@ -640,11 +640,6 @@ export const LanguageModelInputSchema = z.object({
   callOptions: LanguageModelCallOptionsSchema,
 });
 
-/**
- * Model entity schema for AI models (Collection Entity)
- * Extends BaseCollectionEntitySchema with model-specific fields
- * Base schema already includes: id, title, created_at, updated_at, created_by, updated_by
- */
 export const ModelCollectionEntitySchema = BaseCollectionEntitySchema.extend({
   // Model-specific fields
   logo: z.string().nullable(),

package/src/well-known/trigger.ts

@@ -0,0 +1,143 @@
+/**
+ * Trigger Well-Known Binding
+ *
+ * Defines the interface for connections that can emit triggers.
+ * Any MCP that implements this binding can list available triggers
+ * and configure them for automations.
+ *
+ * This binding includes:
+ * - TRIGGER_LIST: List available trigger definitions
+ * - TRIGGER_CONFIGURE: Configure a trigger with parameters
+ */
+
+import { z } from "zod";
+import { bindingClient, type ToolBinder } from "../core/binder";
+
+// ============================================================================
+// Trigger List Schemas
+// ============================================================================
+
+/**
+ * Schema for a trigger parameter definition
+ */
+export const TriggerParamSchema = z.object({
+  type: z.literal("string"),
+  enum: z.array(z.string()).optional(),
+  description: z.string().optional(),
+});
+
+export type TriggerParam = z.infer<typeof TriggerParamSchema>;
+
+/**
+ * Schema for a trigger definition
+ */
+export const TriggerDefinitionSchema = z.object({
+  type: z.string(),
+  description: z.string(),
+  paramsSchema: z.record(z.string(), TriggerParamSchema),
+});
+
+export type TriggerDefinition = z.infer<typeof TriggerDefinitionSchema>;
+
+/**
+ * TRIGGER_LIST Input Schema
+ */
+export const TriggerListInputSchema = z.object({});
+
+export type TriggerListInput = z.infer<typeof TriggerListInputSchema>;
+
+/**
+ * TRIGGER_LIST Output Schema
+ */
+export const TriggerListOutputSchema = z.object({
+  triggers: z.array(TriggerDefinitionSchema),
+});
+
+export type TriggerListOutput = z.infer<typeof TriggerListOutputSchema>;
+
+// ============================================================================
+// Trigger Configure Schemas
+// ============================================================================
+
+/**
+ * TRIGGER_CONFIGURE Input Schema
+ *
+ * Input for configuring a trigger with parameters.
+ */
+export const TriggerConfigureInputSchema = z.object({
+  type: z.string(),
+  params: z.record(z.string(), z.string()),
+  enabled: z.boolean(),
+});
+
+export type TriggerConfigureInput = z.infer<typeof TriggerConfigureInputSchema>;
+
+/**
+ * TRIGGER_CONFIGURE Output Schema
+ */
+export const TriggerConfigureOutputSchema = z.object({
+  success: z.boolean(),
+});
+
+export type TriggerConfigureOutput = z.infer<
+  typeof TriggerConfigureOutputSchema
+>;
+
+// ============================================================================
+// Trigger Binding
+// ============================================================================
+
+/**
+ * Trigger Binding
+ *
+ * Defines the interface for connections that can emit triggers.
+ * Implementations must provide TRIGGER_LIST and TRIGGER_CONFIGURE tools.
+ *
+ * Required tools:
+ * - TRIGGER_LIST: List available trigger definitions with their parameter schemas
+ * - TRIGGER_CONFIGURE: Configure a trigger with specific parameters
+ */
+export const TRIGGER_BINDING = [
+  {
+    name: "TRIGGER_LIST" as const,
+    inputSchema: TriggerListInputSchema,
+    outputSchema: TriggerListOutputSchema,
+  },
+  {
+    name: "TRIGGER_CONFIGURE" as const,
+    inputSchema: TriggerConfigureInputSchema,
+    outputSchema: TriggerConfigureOutputSchema,
+  },
+] satisfies ToolBinder[];
+
+/**
+ * Trigger Binding Client
+ *
+ * Use this to create a client for interacting with triggers.
+ *
+ * @example
+ * ```typescript
+ * import { TriggerBinding } from "@decocms/bindings/trigger";
+ *
+ * // For a connection
+ * const client = TriggerBinding.forConnection(connection);
+ *
+ * // List available triggers
+ * const { triggers } = await client.TRIGGER_LIST({});
+ *
+ * // Configure a trigger
+ * await client.TRIGGER_CONFIGURE({
+ *   type: "cron",
+ *   params: { schedule: "0 9 * * 1" },
+ *   enabled: true,
+ * });
+ * ```
+ */
+export const TriggerBinding = bindingClient(TRIGGER_BINDING);
+
+/**
+ * Type helper for the Trigger binding client
+ */
+export type TriggerBindingClient = ReturnType<
+  typeof TriggerBinding.forConnection
+>;

package/src/well-known/reports.ts

@@ -1,333 +0,0 @@
-/**
- * Reports Well-Known Binding
- *
- * Defines the interface for viewing automated reports.
- * Any MCP that implements this binding can provide reports to the Reports plugin
- * (e.g. performance audits, security scans, accessibility checks).
- *
- * This binding includes:
- * - REPORTS_LIST: List all available reports with metadata
- * - REPORTS_GET: Get a specific report with full content
- */
-
-import { z } from "zod";
-import type { Binder, ToolBinder } from "../core/binder";
-
-// ============================================================================
-// Shared Schemas
-// ============================================================================
-
-/**
- * Report status indicates the overall health/outcome of the report.
- */
-export const ReportStatusSchema = z.enum([
-  "passing",
-  "warning",
-  "failing",
-  "info",
-]);
-export type ReportStatus = z.infer<typeof ReportStatusSchema>;
-
-/**
- * A single metric item within a metrics section.
- */
-export const MetricItemSchema = z.object({
-  label: z.string().describe("Metric label (e.g. 'LCP', 'Performance')"),
-  value: z.union([z.number(), z.string()]).describe("Current metric value"),
-  unit: z
-    .string()
-    .optional()
-    .describe("Unit of measurement (e.g. 's', 'ms', 'score')"),
-  previousValue: z
-    .union([z.number(), z.string()])
-    .optional()
-    .describe("Previous value for delta comparison"),
-  status: ReportStatusSchema.optional().describe(
-    "Status of this individual metric",
-  ),
-});
-export type MetricItem = z.infer<typeof MetricItemSchema>;
-
-/**
- * A single criterion item within a criteria section.
- */
-export const CriterionItemSchema = z.object({
-  label: z.string().describe("Short name of the criterion"),
-  description: z.string().optional().describe("Longer explanation"),
-  status: ReportStatusSchema.optional().describe(
-    "Status of this individual criterion (passing/warning/failing/info)",
-  ),
-});
-export type CriterionItem = z.infer<typeof CriterionItemSchema>;
-
-/**
- * A single row within a ranked-list section.
- */
-export const RankedListRowSchema = z.object({
-  position: z.number().describe("Current rank position"),
-  reference_position: z
-    .number()
-    .optional()
-    .describe(
-      "Previous rank position before reordering. Used to compute delta automatically (delta = reference_position - position).",
-    ),
-  delta: z
-    .number()
-    .optional()
-    .describe(
-      "Explicit change in position. Ignored when reference_position is provided.",
-    ),
-  label: z.string().describe("Item name"),
-  image: z.string().describe("URL of the item image"),
-  values: z
-    .array(z.union([z.string(), z.number()]))
-    .describe("Values matching columns"),
-  note: z
-    .union([
-      z.string(),
-      z.record(z.string(), z.union([z.string(), z.number()])),
-    ])
-    .optional()
-    .describe("Inline annotation or structured key-value metrics"),
-});
-export type RankedListRow = z.infer<typeof RankedListRowSchema>;
-
-/**
- * Report sections -- polymorphic by type.
- * Sections represent the main content blocks of a report.
- */
-export const ReportSectionSchema = z.discriminatedUnion("type", [
-  z.object({
-    type: z.literal("markdown"),
-    content: z.string().describe("Markdown content"),
-  }),
-  z.object({
-    type: z.literal("metrics"),
-    title: z.string().optional().describe("Section title"),
-    items: z.array(MetricItemSchema).describe("Metric items"),
-  }),
-  z.object({
-    type: z.literal("table"),
-    title: z.string().optional().describe("Section title"),
-    columns: z.array(z.string()).describe("Column headers"),
-    rows: z
-      .array(z.array(z.union([z.string(), z.number(), z.null()])))
-      .describe("Table rows"),
-  }),
-  z.object({
-    type: z.literal("criteria"),
-    title: z.string().optional().describe("Section title"),
-    items: z.array(CriterionItemSchema).describe("List of criteria items"),
-  }),
-  z.object({
-    type: z.literal("note"),
-    content: z.string().describe("The note text"),
-  }),
-  z.object({
-    type: z.literal("ranked-list"),
-    title: z.string().optional().describe("Section title"),
-    rows: z.array(RankedListRowSchema).describe("Ranked items"),
-  }),
-]);
-export type ReportSection = z.infer<typeof ReportSectionSchema>;
-
-/**
- * Lifecycle status of a report within the inbox workflow.
- */
-export const ReportLifecycleStatusSchema = z.enum([
-  "unread",
-  "read",
-  "dismissed",
-]);
-export type ReportLifecycleStatus = z.infer<typeof ReportLifecycleStatusSchema>;
-
-/**
- * Summary of a report returned by REPORTS_LIST.
- */
-export const ReportSummarySchema = z.object({
-  id: z.string().describe("Unique report identifier"),
-  collectionId: z
-    .string()
-    .describe("Collection identifier used to scope reports"),
-  title: z.string().describe("Report title"),
-  category: z
-    .string()
-    .describe(
-      "Report category (e.g. 'performance', 'security', 'accessibility')",
-    ),
-  status: ReportStatusSchema.describe("Overall report status"),
-  summary: z.string().describe("One-line summary of findings"),
-  updatedAt: z.string().describe("ISO 8601 timestamp of last update"),
-  source: z
-    .string()
-    .optional()
-    .describe(
-      "Agent or service that generated the report (e.g. 'security-auditor', 'performance-monitor')",
-    ),
-  tags: z
-    .array(z.string())
-    .optional()
-    .describe("Free-form tags for filtering (e.g. 'homepage', 'api', 'ci')"),
-  lifecycleStatus: ReportLifecycleStatusSchema.optional().describe(
-    "Inbox lifecycle status of the report (default: unread)",
-  ),
-});
-export type ReportSummary = z.infer<typeof ReportSummarySchema>;
-
-/**
- * Full report returned by REPORTS_GET.
- */
-export const ReportSchema = ReportSummarySchema.extend({
-  sections: z.array(ReportSectionSchema).describe("Ordered content sections"),
-});
-export type Report = z.infer<typeof ReportSchema>;
-
-// ============================================================================
-// UI Helpers
-// ============================================================================
-
-/**
- * Groups adjacent criteria+metrics sections into side-by-side pairs for display.
- * In a pair, criteria always goes left and metrics always goes right,
- * regardless of their original order.
- */
-
-type SingleGroup = { type: "single"; section: ReportSection; idx: number };
-type SideBySideGroup = {
-  type: "side-by-side";
-  left: Extract<ReportSection, { type: "criteria" }>;
-  right: Extract<ReportSection, { type: "metrics" }>;
-  leftIdx: number;
-  rightIdx: number;
-};
-export type SectionGroup = SingleGroup | SideBySideGroup;
-
-export function groupSections(sections: ReportSection[]): SectionGroup[] {
-  const groups: SectionGroup[] = [];
-  let i = 0;
-  while (i < sections.length) {
-    const current = sections[i]!;
-    const next = sections[i + 1];
-    const isPair =
-      (current.type === "criteria" && next?.type === "metrics") ||
-      (current.type === "metrics" && next?.type === "criteria");
-
-    if (isPair) {
-      const isCriteriaFirst = current.type === "criteria";
-      const criteria = isCriteriaFirst ? current : next!;
-      const metrics = isCriteriaFirst ? next! : current;
-      const criteriaIdx = isCriteriaFirst ? i : i + 1;
-      const metricsIdx = isCriteriaFirst ? i + 1 : i;
-      groups.push({
-        type: "side-by-side",
-        left: criteria as Extract<ReportSection, { type: "criteria" }>,
-        right: metrics as Extract<ReportSection, { type: "metrics" }>,
-        leftIdx: criteriaIdx,
-        rightIdx: metricsIdx,
-      });
-      i += 2;
-    } else {
-      groups.push({ type: "single", section: current, idx: i });
-      i += 1;
-    }
-  }
-  return groups;
-}
-
-// ============================================================================
-// Tool Schemas
-// ============================================================================
-
-/**
- * REPORTS_LIST - List all available reports with optional filters
- */
-const ReportsListInputSchema = z.object({
-  category: z
-    .string()
-    .optional()
-    .describe("Filter by category (e.g. 'performance', 'security')"),
-  status: ReportStatusSchema.optional().describe("Filter by report status"),
-});
-
-const ReportsListOutputSchema = z.object({
-  reports: z.array(ReportSummarySchema).describe("List of report summaries"),
-});
-
-export type ReportsListInput = z.infer<typeof ReportsListInputSchema>;
-export type ReportsListOutput = z.infer<typeof ReportsListOutputSchema>;
-
-/**
- * REPORTS_GET - Get a specific report with full content
- */
-const ReportsGetInputSchema = z.object({
-  id: z.string().describe("Report identifier"),
-});
-
-const ReportsGetOutputSchema = ReportSchema;
-
-export type ReportsGetInput = z.infer<typeof ReportsGetInputSchema>;
-export type ReportsGetOutput = z.infer<typeof ReportsGetOutputSchema>;
-
-/**
- * REPORTS_UPDATE_STATUS - Update the lifecycle status of a report (optional tool)
- */
-const ReportsUpdateStatusInputSchema = z.object({
-  reportId: z.string().describe("Report identifier"),
-  lifecycleStatus: ReportLifecycleStatusSchema.describe(
-    "New lifecycle status for the report",
-  ),
-});
-
-const ReportsUpdateStatusOutputSchema = z.object({
-  success: z.boolean().describe("Whether the operation succeeded"),
-  message: z.string().optional().describe("Human-readable result message"),
-});
-
-export type ReportsUpdateStatusInput = z.infer<
-  typeof ReportsUpdateStatusInputSchema
->;
-export type ReportsUpdateStatusOutput = z.infer<
-  typeof ReportsUpdateStatusOutputSchema
->;
-
-// ============================================================================
-// Binding Definition
-// ============================================================================
-
-/**
- * Reports Binding
- *
- * Defines the interface for viewing automated reports.
- * Any MCP that implements this binding can be used with the Reports plugin.
- *
- * Required tools:
- * - REPORTS_LIST: List available reports with optional filtering
- * - REPORTS_GET: Get a single report with full content
- *
- * Optional tools:
- * - REPORTS_UPDATE_STATUS: Update the lifecycle status of a report (unread → read → dismissed)
- */
-export const REPORTS_BINDING = [
-  {
-    name: "REPORTS_LIST" as const,
-    inputSchema: ReportsListInputSchema,
-    outputSchema: ReportsListOutputSchema,
-  } satisfies ToolBinder<"REPORTS_LIST", ReportsListInput, ReportsListOutput>,
-  {
-    name: "REPORTS_GET" as const,
-    inputSchema: ReportsGetInputSchema,
-    outputSchema: ReportsGetOutputSchema,
-  } satisfies ToolBinder<"REPORTS_GET", ReportsGetInput, ReportsGetOutput>,
-  {
-    name: "REPORTS_UPDATE_STATUS" as const,
-    inputSchema: ReportsUpdateStatusInputSchema,
-    outputSchema: ReportsUpdateStatusOutputSchema,
-    opt: true,
-  } satisfies ToolBinder<
-    "REPORTS_UPDATE_STATUS",
-    ReportsUpdateStatusInput,
-    ReportsUpdateStatusOutput
-  >,
-] as const satisfies Binder;
-
-export type ReportsBinding = typeof REPORTS_BINDING;