@ductape/mcp 0.1.44 → 0.1.46

package/dist/index.js

@@ -15,7 +15,7 @@ import { z } from 'zod';
 import { executeViaProxy, generateExecutablePayload, getAssetSchemas, } from './proxy-client.js';
 const MODULES = [
     'product', 'app', 'databases', 'graph', 'webhooks', 'notifications',
-    'messageBrokers', 'storage', 'vector', 'caches', 'sessions', 'quotas',
+    'events', 'messageBrokers', 'storage', 'vector', 'caches', 'sessions', 'quotas',
     'actions', 'features', 'jobs', 'logs', 'resilience', 'health', 'fallback', 'secrets',
 ];
 // ─── Exhaustive SDK Method & Params Reference ────────────────────────────────
@@ -184,7 +184,7 @@ SETUP — register once in AppModule:
   ║  redisUrl IS REQUIRED TO USE ANY *.dispatch()                          ║
   ║                                                                          ║
   ║  Every dispatch() call (actions, features, events, databases, storage,  ║
-  ║  graph, notifications, messageBrokers, quotas, fallback) enqueues jobs  ║
+  ║  graph, notifications, quotas, fallback) enqueues jobs                  ║
   ║  via BullMQ over Redis. Without redisUrl the call throws at runtime:    ║
   ║  "Queues not configured. dispatch() requires a queue connection."        ║
   ║                                                                          ║
@@ -502,33 +502,33 @@ ALL params are passed as a JSON array in positional order matching the SDK signa
   notifications.dispatch   [{ product, env, notification, event, input, retries?, session?, cache?, schedule?: { cron?, every?, start_at? } }]  ← CALL ductape_generate_payload FIRST (operation_family="notification", method="dispatch") — requires redisUrl in ductape initialization
   notifications.getMessages [{ product_tag?, env?, notification_tag?, status?, type?, start_date?, end_date?, page?, limit? }]
 
-━━━ MODULE: messageBrokers ━━━
-  messageBrokers.create   [{ product: string, tag: string, name: string, description?: string, type: "kafka"|"rabbitmq"|"redis"|"sqs", envs: [{ slug: string, connection_url: string }] }]
-  messageBrokers.update   [product_tag, broker_tag, data: { name?: string, description?: string, type?: "kafka"|"rabbitmq"|"redis"|"sqs", envs?: [{ slug: string, connection_url: string }] }]
-  messageBrokers.fetch    [product_tag, broker_tag]
-  messageBrokers.list     [product_tag]
-  messageBrokers.delete   [product_tag, broker_tag]
-  messageBrokers.topics.create  ← FORBIDDEN with publishable key. Use ductape_cli instead:
+━━━ MODULE: events  (alias: messageBrokers — both accepted; events matches the TS SDK naming) ━━━
+  events.create   [{ product: string, tag: string, name: string, description?: string, type: "kafka"|"rabbitmq"|"redis"|"sqs", envs: [{ slug: string, connection_url: string }] }]
+  events.update   [product_tag, broker_tag, data: { name?: string, description?: string, type?: "kafka"|"rabbitmq"|"redis"|"sqs", envs?: [{ slug: string, connection_url: string }] }]
+  events.fetch    [product_tag, broker_tag]
+  events.list     [product_tag]
+  events.delete   [product_tag, broker_tag]
+  events.topics.create  ← FORBIDDEN with publishable key. Use ductape_cli instead:
     ductape_cli("events topics create -f topic.json")
     topic.json: { tag: "broker-tag:topic-tag", name, description?, sample?, idempotent?, queueUrls?: [{ env_slug, url }] }
   ← Always required before consuming. For SQS: must include queueUrls per env.
   ← For Pub/Sub, Kafka, RabbitMQ, Redis, NATS: the first produce call auto-registers the topic,
      but you should still create it explicitly so consumers can subscribe before any produce occurs.
-  messageBrokers.topics.update  ← FORBIDDEN with publishable key. Use ductape_cli:
+  events.topics.update  ← FORBIDDEN with publishable key. Use ductape_cli:
     ductape_cli("events topics update --tag broker:topic -f patch.json")
-  messageBrokers.topics.delete  ← FORBIDDEN with publishable key. Use ductape_cli:
+  events.topics.delete  ← FORBIDDEN with publishable key. Use ductape_cli:
     ductape_cli("events topics delete --tag broker:topic")
-  messageBrokers.topics.fetch  [product_tag, topic_tag]   ← safe via ductape_execute
-  messageBrokers.topics.list   [product_tag, broker_tag]  ← safe via ductape_execute
-  messageBrokers.produce  [{ product, env, event: "broker_tag:topic_tag", message: { key: value }, session?, cache? }]
-  messageBrokers.consume  [{ product, env, event: "broker_tag:topic_tag", callback: "function_ref" }]
-  messageBrokers.dispatch [{ product, env, broker, event, input: { message }, retries?, session?, cache?, schedule?: { cron?, every?, start_at? } }]  — requires redisUrl in ductape initialization
-  messageBrokers.messages.query [{ product, env, brokerTag, topicTag?, producerTag?, consumerTag?, status?, startDate?, endDate?, page?, limit? }]
-  messageBrokers.messages.getProducers [{ product, env, brokerTag, topicTag?, page?, limit? }]
-  messageBrokers.messages.getConsumers [{ product, env, brokerTag, topicTag?, page?, limit? }]
-  messageBrokers.messages.getDeadLetters [{ product, env, brokerTag, topicTag?, consumerTag?, startDate?, endDate?, page?, limit? }]
-  messageBrokers.messages.getStats      [{ product, env, brokerTag }]
-  messageBrokers.messages.getDashboard  [{ product, env, brokerTag }]
+  events.topics.fetch  [product_tag, topic_tag]   ← safe via ductape_execute
+  events.topics.list   [product_tag, broker_tag]  ← safe via ductape_execute
+  events.produce  [{ product, env, event: "broker_tag:topic_tag", message: { key: value }, session?, cache? }]
+  events.consume  [{ product, env, event: "broker_tag:topic_tag", callback: "function_ref" }]
+  events.dispatch [{ product, env, event: "broker_tag:topic_tag", input: { message }, retries?, session?, cache?, schedule?: { cron?, every?, start_at? } }]  — event is always the fully-qualified "broker:topic" string; do NOT pass broker separately — requires redisUrl in ductape initialization
+  events.messages.query [{ product, env, brokerTag, topicTag?, producerTag?, consumerTag?, status?, startDate?, endDate?, page?, limit? }]
+  events.messages.getProducers [{ product, env, brokerTag, topicTag?, page?, limit? }]
+  events.messages.getConsumers [{ product, env, brokerTag, topicTag?, page?, limit? }]
+  events.messages.getDeadLetters [{ product, env, brokerTag, topicTag?, consumerTag?, startDate?, endDate?, page?, limit? }]
+  events.messages.getStats      [{ product, env, brokerTag }]
+  events.messages.getDashboard  [{ product, env, brokerTag }]
 
 ━━━ MODULE: storage ━━━
   storage.create   [{ product: string, tag: string, name: string, description?: string, envs: [{ slug: string, type: "aws"|"azure"|"gcp", config: { bucket?: string, region?: string, accessKeyId?: string, secretAccessKey?: string, containerName?: string, connectionString?: string, projectId?: string, keyFilename?: string } }] }]
@@ -1027,12 +1027,12 @@ function resolveSdkCallPath(operationFamily, method) {
         return m === 'dispatch' ? 'storage.dispatch' : `storage.${m}`;
     if (family === 'notification')
         return m === 'dispatch' ? 'notifications.dispatch' : `notifications.${m}`;
-    if (family === 'messaging' || family === 'broker') {
+    if (family === 'messaging' || family === 'broker' || family === 'events' || family === 'event') {
         if (m === 'dispatch')
-            return 'messageBrokers.dispatch';
+            return 'events.dispatch';
         if (m === 'send' || m === 'publish' || m === 'produce')
-            return 'messageBrokers.produce';
-        return `messageBrokers.${m}`;
+            return 'events.produce';
+        return `events.${m}`;
     }
     if (family === 'quota')
         return `quotas.${m}`;
@@ -2467,7 +2467,7 @@ Import (register an EXISTING cloud resource):
   Producing to a topic also calls ensureTopicRegistered in the background — but DO NOT rely on
   auto-registration for consume paths. Always create topics explicitly.
 
-  IMPORTANT: messageBrokers.topics.create requires an access key (admin operation).
+  IMPORTANT: events.topics.create requires an access key (admin operation).
   Use ductape_cli — NOT ductape_execute — to create topics.
 
   Write a topic.json file, then:
@@ -2494,7 +2494,7 @@ Import (register an EXISTING cloud resource):
     ductape_cli("events topics delete --tag order-events:order-created")
 
   Read-only fetches (safe with publishable key via ductape_execute):
-    ductape_execute("messageBrokers.fetch", [product_tag, "broker-tag"])  → includes topics[]
+    ductape_execute("events.fetch", [product_tag, "broker-tag"])  → includes topics[]
 
 ━━━ STEP 3: PRODUCE — WRITTEN IN APPLICATION CODE ━━━
 
@@ -2505,7 +2505,12 @@ Import (register an EXISTING cloud resource):
 
   GENERAL BACKEND (TypeScript/Node.js — not NestJS):
     import Ductape from '@ductape/sdk';
-    const ductape = new Ductape({ accessKey: 'your-access-key' });
+    // produce() does not need redis_url.
+    // dispatch() requires redis_url in the Ductape initialization options — it throws at runtime without it.
+    const ductape = new Ductape({
+      accessKey: process.env.DUCTAPE_ACCESS_KEY,
+      redis_url: process.env.DUCTAPE_REDIS_URL,  // required for any dispatch(); omit only if never dispatching
+    });
     await ductape.events.produce({
       product: "my-product",
       env: "prd",
@@ -2520,14 +2525,26 @@ Import (register an EXISTING cloud resource):
       idempotencyTtl?: 86400,             // seconds; default 86400 (24h)
     });
 
-  NESTJS — method decorators:
+  NESTJS — initialization + method decorators:
+    // AppModule — redisUrl is required whenever any *.dispatch() is used:
+    DuctapeModule.forRootAsync({
+      useFactory: () => ({
+        accessKey: process.env.DUCTAPE_ACCESS_KEY,
+        product: 'my-product',
+        env: process.env.NODE_ENV === 'production' ? 'prd' : 'snd',
+        redisUrl: process.env.DUCTAPE_REDIS_URL,  // required — dispatch() throws without this
+      }),
+    });
+    // Environment: DUCTAPE_REDIS_URL=redis://localhost:6379 (local) or rediss://:<pw>@host:6380 (managed)
+    // produce() and @Events.Consumer do NOT need DUCTAPE_REDIS_URL — only dispatch() does.
+
     import { Events } from '@ductape/nestjs';
     @Injectable() export class OrdersService {
       // Immediate produce — method returns the message payload:
       @Events.Produce({ event: 'order-events:order-created' })
       emitOrderCreated(payload: { orderId: string; total: number }) { return payload; }
 
-      // Dispatch with static schedule (known at deploy time):
+      // Dispatch with static schedule — requires redisUrl in DuctapeModule initialization:
       @Events.Dispatch({ broker: 'order-events', event: 'order-events:reminder-due',
                          schedule: { every: 86400000 } })
       scheduleReminder(payload: { message: { orderId: string } }) { return payload; }
@@ -2560,10 +2577,9 @@ Import (register an EXISTING cloud resource):
     });
 
   SCHEDULED DISPATCH (background job):
-    ductape_execute("messageBrokers.dispatch", [{
+    ductape_execute("events.dispatch", [{
       product, env,
-      broker: "order-events",                // broker tag
-      event: "order-events:reminder-due",    // "broker:topic"
+      event: "order-events:reminder-due",    // fully-qualified "broker-tag:topic-tag" — no separate broker field
       input: { message: { orderId: "123" } },
       retries?: 3,
       session?: "session-tag:jwt",
@@ -2631,24 +2647,24 @@ Import (register an EXISTING cloud resource):
 
   DEAD-LETTER QUEUE (DLQ):
     Messages whose callbacks consistently throw are automatically moved to the DLQ.
-    Query:     ductape_execute("messageBrokers.messages.getDeadLetters",
+    Query:     ductape_execute("events.messages.getDeadLetters",
                  [{ product, env, brokerTag, topicTag?, consumerTag?, limit? }])
-    Reprocess: ductape_execute("messageBrokers.reprocessDLQ",
+    Reprocess: ductape_execute("events.reprocessDLQ",
                  [{ product, env, brokerTag, topicTag?, messageIds?, limit? }])
-    Replay:    ductape_execute("messageBrokers.replayEvent",
+    Replay:    ductape_execute("events.replayEvent",
                  [{ product, env, eventId, force? }])
 
 ━━━ OBSERVABILITY ━━━
 
-  messageBrokers.messages.query        [{ product, env, brokerTag, topicTag?, status?, page?, limit? }]
-  messageBrokers.messages.getStats     [{ product, env, brokerTag }]
-  messageBrokers.messages.getDashboard [{ product, env, brokerTag }]
-  messageBrokers.messages.getDeadLetters [{ product, env, brokerTag, topicTag?, consumerTag?, limit? }]
-  messageBrokers.messages.getProducers [{ product, env, brokerTag, topicTag?, page?, limit? }]
-  messageBrokers.messages.getConsumers [{ product, env, brokerTag, topicTag?, page?, limit? }]
-  messageBrokers.replayEvent           [{ product, env, eventId, force? }]
-  messageBrokers.reprocessDLQ         [{ product, env, brokerTag, topicTag?, messageIds?, limit? }]
-  messageBrokers.checkIdempotency      [{ product, env, brokerTag, idempotency_key }]
+  events.messages.query        [{ product, env, brokerTag, topicTag?, status?, page?, limit? }]
+  events.messages.getStats     [{ product, env, brokerTag }]
+  events.messages.getDashboard [{ product, env, brokerTag }]
+  events.messages.getDeadLetters [{ product, env, brokerTag, topicTag?, consumerTag?, limit? }]
+  events.messages.getProducers [{ product, env, brokerTag, topicTag?, page?, limit? }]
+  events.messages.getConsumers [{ product, env, brokerTag, topicTag?, page?, limit? }]
+  events.replayEvent           [{ product, env, eventId, force? }]
+  events.reprocessDLQ         [{ product, env, brokerTag, topicTag?, messageIds?, limit? }]
+  events.checkIdempotency      [{ product, env, brokerTag, idempotency_key }]
 `.trim(),
     logs: `
 DUCTAPE LOGS
@@ -3377,7 +3393,28 @@ async function main() {
             if (!key) {
                 throw new Error('Not authenticated. Set DUCTAPE_PUBLISHABLE_KEY in your MCP server env config, or pass publishable_key on every tool call.');
             }
-            const result = await executeViaProxy(key, args.module, args.method, args.params);
+            // The TS SDK uses ductape.events.* for broker operations; the backend proxy uses messageBrokers.
+            const proxyModule = args.module === 'events' ? 'messageBrokers' : args.module;
+            // Normalize events.dispatch params: event must be fully-qualified "broker:topic".
+            // If an agent passes both broker and event="broker:topic", strip broker and de-duplicate.
+            let params = args.params;
+            if ((args.module === 'events' || args.module === 'messageBrokers') && args.method === 'dispatch') {
+                params = params.map((p) => {
+                    if (p && typeof p === 'object' && !Array.isArray(p)) {
+                        const obj = p;
+                        const broker = typeof obj['broker'] === 'string' ? obj['broker'] : '';
+                        const event = typeof obj['event'] === 'string' ? obj['event'] : '';
+                        if (broker && event) {
+                            // Strip broker prefix if event is already "broker:..." to avoid "broker:broker:topic"
+                            const normalized = event.startsWith(broker + ':') ? event : `${broker}:${event}`;
+                            const { broker: _removed, ...rest } = obj;
+                            return { ...rest, event: normalized };
+                        }
+                    }
+                    return p;
+                });
+            }
+            const result = await executeViaProxy(key, proxyModule, args.method, params);
             return { content: [{ type: 'text', text: JSON.stringify(result ?? null, null, 2) }] };
         }
         catch (err) {

package/dist/proxy-client.d.ts

@@ -2,7 +2,7 @@
  * Client for the Ductape backend SDK proxy using Publishable Key.
  */
 export declare const API_BASE_URL = "https://api.ductape.app";
-export type SDKModule = 'product' | 'app' | 'databases' | 'graph' | 'webhooks' | 'notifications' | 'messageBrokers' | 'storage' | 'vector' | 'caches' | 'sessions' | 'quotas' | 'actions' | 'features' | 'jobs' | 'logs' | 'resilience' | 'health' | 'fallback' | 'secrets';
+export type SDKModule = 'product' | 'app' | 'databases' | 'graph' | 'webhooks' | 'notifications' | 'messageBrokers' | 'events' | 'storage' | 'vector' | 'caches' | 'sessions' | 'quotas' | 'actions' | 'features' | 'jobs' | 'logs' | 'resilience' | 'health' | 'fallback' | 'secrets';
 /**
  * Execute an SDK operation via the backend proxy using a Publishable Key.
  */

package/dist/proxy-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proxy-client.d.ts","sourceRoot":"","sources":["../src/proxy-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,YAAY,4BAA4B,CAAC;AAEtD,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,KAAK,GACL,WAAW,GACX,OAAO,GACP,UAAU,GACV,eAAe,GACf,gBAAgB,GAChB,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,SAAS,GACT,UAAU,GACV,MAAM,GACN,MAAM,GACN,YAAY,GACZ,QAAQ,GACR,UAAU,GACV,SAAS,CAAC;AAUd;;GAEG;AACH,wBAAsB,eAAe,CAAC,CAAC,GAAG,OAAO,EAC/C,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,OAAO,EAAO,GACrB,OAAO,CAAC,CAAC,CAAC,CAuBZ;AAED,MAAM,WAAW,iCAAiC;IAChD,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,kCAAkC;IACjD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AASD,wBAAsB,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAYvE;AA4BD,wBAAsB,yBAAyB,CAAC,CAAC,GAAG,kCAAkC,EACpF,OAAO,EAAE,iCAAiC,GACzC,OAAO,CAAC,CAAC,CAAC,CAwBZ"}
+{"version":3,"file":"proxy-client.d.ts","sourceRoot":"","sources":["../src/proxy-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,YAAY,4BAA4B,CAAC;AAEtD,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,KAAK,GACL,WAAW,GACX,OAAO,GACP,UAAU,GACV,eAAe,GACf,gBAAgB,GAChB,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,SAAS,GACT,UAAU,GACV,MAAM,GACN,MAAM,GACN,YAAY,GACZ,QAAQ,GACR,UAAU,GACV,SAAS,CAAC;AAUd;;GAEG;AACH,wBAAsB,eAAe,CAAC,CAAC,GAAG,OAAO,EAC/C,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,OAAO,EAAO,GACrB,OAAO,CAAC,CAAC,CAAC,CAuBZ;AAED,MAAM,WAAW,iCAAiC;IAChD,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,kCAAkC;IACjD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AASD,wBAAsB,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAYvE;AA4BD,wBAAsB,yBAAyB,CAAC,CAAC,GAAG,kCAAkC,EACpF,OAAO,EAAE,iCAAiC,GACzC,OAAO,CAAC,CAAC,CAAC,CAwBZ"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ductape/mcp",
-  "version": "0.1.44",
+  "version": "0.1.46",
   "description": "MCP server that exposes Ductape SDK operations via the backend proxy",
   "type": "module",
   "main": "dist/index.js",

package/src/index.ts

@@ -22,7 +22,7 @@ import {
 
 const MODULES: SDKModule[] = [
   'product', 'app', 'databases', 'graph', 'webhooks', 'notifications',
-  'messageBrokers', 'storage', 'vector', 'caches', 'sessions', 'quotas',
+  'events', 'messageBrokers', 'storage', 'vector', 'caches', 'sessions', 'quotas',
   'actions', 'features', 'jobs', 'logs', 'resilience', 'health', 'fallback', 'secrets',
 ];
 
@@ -195,7 +195,7 @@ SETUP — register once in AppModule:
   ║  redisUrl IS REQUIRED TO USE ANY *.dispatch()                          ║
   ║                                                                          ║
   ║  Every dispatch() call (actions, features, events, databases, storage,  ║
-  ║  graph, notifications, messageBrokers, quotas, fallback) enqueues jobs  ║
+  ║  graph, notifications, quotas, fallback) enqueues jobs                  ║
   ║  via BullMQ over Redis. Without redisUrl the call throws at runtime:    ║
   ║  "Queues not configured. dispatch() requires a queue connection."        ║
   ║                                                                          ║
@@ -513,33 +513,33 @@ ALL params are passed as a JSON array in positional order matching the SDK signa
   notifications.dispatch   [{ product, env, notification, event, input, retries?, session?, cache?, schedule?: { cron?, every?, start_at? } }]  ← CALL ductape_generate_payload FIRST (operation_family="notification", method="dispatch") — requires redisUrl in ductape initialization
   notifications.getMessages [{ product_tag?, env?, notification_tag?, status?, type?, start_date?, end_date?, page?, limit? }]
 
-━━━ MODULE: messageBrokers ━━━
-  messageBrokers.create   [{ product: string, tag: string, name: string, description?: string, type: "kafka"|"rabbitmq"|"redis"|"sqs", envs: [{ slug: string, connection_url: string }] }]
-  messageBrokers.update   [product_tag, broker_tag, data: { name?: string, description?: string, type?: "kafka"|"rabbitmq"|"redis"|"sqs", envs?: [{ slug: string, connection_url: string }] }]
-  messageBrokers.fetch    [product_tag, broker_tag]
-  messageBrokers.list     [product_tag]
-  messageBrokers.delete   [product_tag, broker_tag]
-  messageBrokers.topics.create  ← FORBIDDEN with publishable key. Use ductape_cli instead:
+━━━ MODULE: events  (alias: messageBrokers — both accepted; events matches the TS SDK naming) ━━━
+  events.create   [{ product: string, tag: string, name: string, description?: string, type: "kafka"|"rabbitmq"|"redis"|"sqs", envs: [{ slug: string, connection_url: string }] }]
+  events.update   [product_tag, broker_tag, data: { name?: string, description?: string, type?: "kafka"|"rabbitmq"|"redis"|"sqs", envs?: [{ slug: string, connection_url: string }] }]
+  events.fetch    [product_tag, broker_tag]
+  events.list     [product_tag]
+  events.delete   [product_tag, broker_tag]
+  events.topics.create  ← FORBIDDEN with publishable key. Use ductape_cli instead:
     ductape_cli("events topics create -f topic.json")
     topic.json: { tag: "broker-tag:topic-tag", name, description?, sample?, idempotent?, queueUrls?: [{ env_slug, url }] }
   ← Always required before consuming. For SQS: must include queueUrls per env.
   ← For Pub/Sub, Kafka, RabbitMQ, Redis, NATS: the first produce call auto-registers the topic,
      but you should still create it explicitly so consumers can subscribe before any produce occurs.
-  messageBrokers.topics.update  ← FORBIDDEN with publishable key. Use ductape_cli:
+  events.topics.update  ← FORBIDDEN with publishable key. Use ductape_cli:
     ductape_cli("events topics update --tag broker:topic -f patch.json")
-  messageBrokers.topics.delete  ← FORBIDDEN with publishable key. Use ductape_cli:
+  events.topics.delete  ← FORBIDDEN with publishable key. Use ductape_cli:
     ductape_cli("events topics delete --tag broker:topic")
-  messageBrokers.topics.fetch  [product_tag, topic_tag]   ← safe via ductape_execute
-  messageBrokers.topics.list   [product_tag, broker_tag]  ← safe via ductape_execute
-  messageBrokers.produce  [{ product, env, event: "broker_tag:topic_tag", message: { key: value }, session?, cache? }]
-  messageBrokers.consume  [{ product, env, event: "broker_tag:topic_tag", callback: "function_ref" }]
-  messageBrokers.dispatch [{ product, env, broker, event, input: { message }, retries?, session?, cache?, schedule?: { cron?, every?, start_at? } }]  — requires redisUrl in ductape initialization
-  messageBrokers.messages.query [{ product, env, brokerTag, topicTag?, producerTag?, consumerTag?, status?, startDate?, endDate?, page?, limit? }]
-  messageBrokers.messages.getProducers [{ product, env, brokerTag, topicTag?, page?, limit? }]
-  messageBrokers.messages.getConsumers [{ product, env, brokerTag, topicTag?, page?, limit? }]
-  messageBrokers.messages.getDeadLetters [{ product, env, brokerTag, topicTag?, consumerTag?, startDate?, endDate?, page?, limit? }]
-  messageBrokers.messages.getStats      [{ product, env, brokerTag }]
-  messageBrokers.messages.getDashboard  [{ product, env, brokerTag }]
+  events.topics.fetch  [product_tag, topic_tag]   ← safe via ductape_execute
+  events.topics.list   [product_tag, broker_tag]  ← safe via ductape_execute
+  events.produce  [{ product, env, event: "broker_tag:topic_tag", message: { key: value }, session?, cache? }]
+  events.consume  [{ product, env, event: "broker_tag:topic_tag", callback: "function_ref" }]
+  events.dispatch [{ product, env, event: "broker_tag:topic_tag", input: { message }, retries?, session?, cache?, schedule?: { cron?, every?, start_at? } }]  — event is always the fully-qualified "broker:topic" string; do NOT pass broker separately — requires redisUrl in ductape initialization
+  events.messages.query [{ product, env, brokerTag, topicTag?, producerTag?, consumerTag?, status?, startDate?, endDate?, page?, limit? }]
+  events.messages.getProducers [{ product, env, brokerTag, topicTag?, page?, limit? }]
+  events.messages.getConsumers [{ product, env, brokerTag, topicTag?, page?, limit? }]
+  events.messages.getDeadLetters [{ product, env, brokerTag, topicTag?, consumerTag?, startDate?, endDate?, page?, limit? }]
+  events.messages.getStats      [{ product, env, brokerTag }]
+  events.messages.getDashboard  [{ product, env, brokerTag }]
 
 ━━━ MODULE: storage ━━━
   storage.create   [{ product: string, tag: string, name: string, description?: string, envs: [{ slug: string, type: "aws"|"azure"|"gcp", config: { bucket?: string, region?: string, accessKeyId?: string, secretAccessKey?: string, containerName?: string, connectionString?: string, projectId?: string, keyFilename?: string } }] }]
@@ -1062,10 +1062,10 @@ function resolveSdkCallPath(operationFamily: string, method: string): string {
   if (family === 'vector') return `vector.${m}`;
   if (family === 'storage') return m === 'dispatch' ? 'storage.dispatch' : `storage.${m}`;
   if (family === 'notification') return m === 'dispatch' ? 'notifications.dispatch' : `notifications.${m}`;
-  if (family === 'messaging' || family === 'broker') {
-    if (m === 'dispatch') return 'messageBrokers.dispatch';
-    if (m === 'send' || m === 'publish' || m === 'produce') return 'messageBrokers.produce';
-    return `messageBrokers.${m}`;
+  if (family === 'messaging' || family === 'broker' || family === 'events' || family === 'event') {
+    if (m === 'dispatch') return 'events.dispatch';
+    if (m === 'send' || m === 'publish' || m === 'produce') return 'events.produce';
+    return `events.${m}`;
   }
   if (family === 'quota') return `quotas.${m}`;
   if (family === 'fallback') return `fallback.${m}`;
@@ -2540,7 +2540,7 @@ Import (register an EXISTING cloud resource):
   Producing to a topic also calls ensureTopicRegistered in the background — but DO NOT rely on
   auto-registration for consume paths. Always create topics explicitly.
 
-  IMPORTANT: messageBrokers.topics.create requires an access key (admin operation).
+  IMPORTANT: events.topics.create requires an access key (admin operation).
   Use ductape_cli — NOT ductape_execute — to create topics.
 
   Write a topic.json file, then:
@@ -2567,7 +2567,7 @@ Import (register an EXISTING cloud resource):
     ductape_cli("events topics delete --tag order-events:order-created")
 
   Read-only fetches (safe with publishable key via ductape_execute):
-    ductape_execute("messageBrokers.fetch", [product_tag, "broker-tag"])  → includes topics[]
+    ductape_execute("events.fetch", [product_tag, "broker-tag"])  → includes topics[]
 
 ━━━ STEP 3: PRODUCE — WRITTEN IN APPLICATION CODE ━━━
 
@@ -2578,7 +2578,12 @@ Import (register an EXISTING cloud resource):
 
   GENERAL BACKEND (TypeScript/Node.js — not NestJS):
     import Ductape from '@ductape/sdk';
-    const ductape = new Ductape({ accessKey: 'your-access-key' });
+    // produce() does not need redis_url.
+    // dispatch() requires redis_url in the Ductape initialization options — it throws at runtime without it.
+    const ductape = new Ductape({
+      accessKey: process.env.DUCTAPE_ACCESS_KEY,
+      redis_url: process.env.DUCTAPE_REDIS_URL,  // required for any dispatch(); omit only if never dispatching
+    });
     await ductape.events.produce({
       product: "my-product",
       env: "prd",
@@ -2593,14 +2598,26 @@ Import (register an EXISTING cloud resource):
       idempotencyTtl?: 86400,             // seconds; default 86400 (24h)
     });
 
-  NESTJS — method decorators:
+  NESTJS — initialization + method decorators:
+    // AppModule — redisUrl is required whenever any *.dispatch() is used:
+    DuctapeModule.forRootAsync({
+      useFactory: () => ({
+        accessKey: process.env.DUCTAPE_ACCESS_KEY,
+        product: 'my-product',
+        env: process.env.NODE_ENV === 'production' ? 'prd' : 'snd',
+        redisUrl: process.env.DUCTAPE_REDIS_URL,  // required — dispatch() throws without this
+      }),
+    });
+    // Environment: DUCTAPE_REDIS_URL=redis://localhost:6379 (local) or rediss://:<pw>@host:6380 (managed)
+    // produce() and @Events.Consumer do NOT need DUCTAPE_REDIS_URL — only dispatch() does.
+
     import { Events } from '@ductape/nestjs';
     @Injectable() export class OrdersService {
       // Immediate produce — method returns the message payload:
       @Events.Produce({ event: 'order-events:order-created' })
       emitOrderCreated(payload: { orderId: string; total: number }) { return payload; }
 
-      // Dispatch with static schedule (known at deploy time):
+      // Dispatch with static schedule — requires redisUrl in DuctapeModule initialization:
       @Events.Dispatch({ broker: 'order-events', event: 'order-events:reminder-due',
                          schedule: { every: 86400000 } })
       scheduleReminder(payload: { message: { orderId: string } }) { return payload; }
@@ -2633,10 +2650,9 @@ Import (register an EXISTING cloud resource):
     });
 
   SCHEDULED DISPATCH (background job):
-    ductape_execute("messageBrokers.dispatch", [{
+    ductape_execute("events.dispatch", [{
       product, env,
-      broker: "order-events",                // broker tag
-      event: "order-events:reminder-due",    // "broker:topic"
+      event: "order-events:reminder-due",    // fully-qualified "broker-tag:topic-tag" — no separate broker field
       input: { message: { orderId: "123" } },
       retries?: 3,
       session?: "session-tag:jwt",
@@ -2704,24 +2720,24 @@ Import (register an EXISTING cloud resource):
 
   DEAD-LETTER QUEUE (DLQ):
     Messages whose callbacks consistently throw are automatically moved to the DLQ.
-    Query:     ductape_execute("messageBrokers.messages.getDeadLetters",
+    Query:     ductape_execute("events.messages.getDeadLetters",
                  [{ product, env, brokerTag, topicTag?, consumerTag?, limit? }])
-    Reprocess: ductape_execute("messageBrokers.reprocessDLQ",
+    Reprocess: ductape_execute("events.reprocessDLQ",
                  [{ product, env, brokerTag, topicTag?, messageIds?, limit? }])
-    Replay:    ductape_execute("messageBrokers.replayEvent",
+    Replay:    ductape_execute("events.replayEvent",
                  [{ product, env, eventId, force? }])
 
 ━━━ OBSERVABILITY ━━━
 
-  messageBrokers.messages.query        [{ product, env, brokerTag, topicTag?, status?, page?, limit? }]
-  messageBrokers.messages.getStats     [{ product, env, brokerTag }]
-  messageBrokers.messages.getDashboard [{ product, env, brokerTag }]
-  messageBrokers.messages.getDeadLetters [{ product, env, brokerTag, topicTag?, consumerTag?, limit? }]
-  messageBrokers.messages.getProducers [{ product, env, brokerTag, topicTag?, page?, limit? }]
-  messageBrokers.messages.getConsumers [{ product, env, brokerTag, topicTag?, page?, limit? }]
-  messageBrokers.replayEvent           [{ product, env, eventId, force? }]
-  messageBrokers.reprocessDLQ         [{ product, env, brokerTag, topicTag?, messageIds?, limit? }]
-  messageBrokers.checkIdempotency      [{ product, env, brokerTag, idempotency_key }]
+  events.messages.query        [{ product, env, brokerTag, topicTag?, status?, page?, limit? }]
+  events.messages.getStats     [{ product, env, brokerTag }]
+  events.messages.getDashboard [{ product, env, brokerTag }]
+  events.messages.getDeadLetters [{ product, env, brokerTag, topicTag?, consumerTag?, limit? }]
+  events.messages.getProducers [{ product, env, brokerTag, topicTag?, page?, limit? }]
+  events.messages.getConsumers [{ product, env, brokerTag, topicTag?, page?, limit? }]
+  events.replayEvent           [{ product, env, eventId, force? }]
+  events.reprocessDLQ         [{ product, env, brokerTag, topicTag?, messageIds?, limit? }]
+  events.checkIdempotency      [{ product, env, brokerTag, idempotency_key }]
 `.trim(),
 
   logs: `
@@ -3475,7 +3491,30 @@ async function main() {
       if (!key) {
         throw new Error('Not authenticated. Set DUCTAPE_PUBLISHABLE_KEY in your MCP server env config, or pass publishable_key on every tool call.');
       }
-      const result = await executeViaProxy(key, args.module, args.method, args.params);
+      // The TS SDK uses ductape.events.* for broker operations; the backend proxy uses messageBrokers.
+      const proxyModule: SDKModule = args.module === 'events' ? 'messageBrokers' : args.module;
+
+      // Normalize events.dispatch params: event must be fully-qualified "broker:topic".
+      // If an agent passes both broker and event="broker:topic", strip broker and de-duplicate.
+      let params = args.params;
+      if ((args.module === 'events' || args.module === 'messageBrokers') && args.method === 'dispatch') {
+        params = params.map((p) => {
+          if (p && typeof p === 'object' && !Array.isArray(p)) {
+            const obj = p as Record<string, unknown>;
+            const broker = typeof obj['broker'] === 'string' ? obj['broker'] : '';
+            const event = typeof obj['event'] === 'string' ? obj['event'] : '';
+            if (broker && event) {
+              // Strip broker prefix if event is already "broker:..." to avoid "broker:broker:topic"
+              const normalized = event.startsWith(broker + ':') ? event : `${broker}:${event}`;
+              const { broker: _removed, ...rest } = obj;
+              return { ...rest, event: normalized };
+            }
+          }
+          return p;
+        });
+      }
+
+      const result = await executeViaProxy(key, proxyModule, args.method, params);
       return { content: [{ type: 'text', text: JSON.stringify(result ?? null, null, 2) }] };
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);

package/src/proxy-client.ts

@@ -12,6 +12,7 @@ export type SDKModule =
   | 'webhooks'
   | 'notifications'
   | 'messageBrokers'
+  | 'events'
   | 'storage'
   | 'vector'
   | 'caches'