@ductape/mcp 0.1.43 → 0.1.45

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 ────────────────────────────────
@@ -180,29 +180,33 @@ global interceptors, decorators, and type-safe resource handles.
 
 SETUP — register once in AppModule:
 
+  ╔══════════════════════════════════════════════════════════════════════════╗
+  ║  redisUrl IS REQUIRED TO USE ANY *.dispatch()                          ║
+  ║                                                                          ║
+  ║  Every dispatch() call (actions, features, events, databases, storage,  ║
+  ║  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."        ║
+  ║                                                                          ║
+  ║  *.run(), events.produce(), and @Events.Consumer do NOT need Redis.     ║
+  ║  Only dispatch() does — and it is non-negotiable.                       ║
+  ╚══════════════════════════════════════════════════════════════════════════╝
+
   import { DuctapeModule } from '@ductape/nestjs';
 
   @Module({
     imports: [
       DuctapeModule.forIntegration({
         accessKey: process.env.DUCTAPE_ACCESS_KEY,
-        product: 'my-product',   // optional default — overridable per controller
+        product: 'my-product',
         env: process.env.NODE_ENV === 'production' ? 'prd' : 'snd',
-        redisUrl: process.env.REDIS_URL,  // REQUIRED when using events.dispatch() or @Events.Dispatch
+        redisUrl: process.env.DUCTAPE_REDIS_URL,  // required — no dispatch() works without this
       }),
     ],
   })
   export class AppModule {}
 
-  IMPORTANT — redisUrl:
-    ALL *.dispatch() calls (actions.dispatch, features.dispatch, events.dispatch, databases.dispatch,
-    storage.dispatch, graph.dispatch, notifications.dispatch, messageBrokers.dispatch, quotas.dispatch,
-    fallback.dispatch, etc.) enqueue jobs via BullMQ, which requires a Redis connection.
-    Without redisUrl ANY dispatch() call throws "Queues not configured. dispatch() requires a queue connection."
-    Set REDIS_URL (e.g. redis://localhost:6379 or a managed Redis connection string) and pass it as redisUrl.
-    *.run(), events.produce(), and @Events.Consumer do NOT require Redis — only dispatch() does.
-
-  // Async (e.g. pulling key from ConfigService):
+  // Async (e.g. pulling from ConfigService):
   DuctapeModule.forRootAsync({
     imports: [ConfigModule],
     inject: [ConfigService],
@@ -210,10 +214,14 @@ SETUP — register once in AppModule:
       accessKey: cfg.get('DUCTAPE_ACCESS_KEY'),
       product: cfg.get('DUCTAPE_PRODUCT'),
       env: cfg.get('DUCTAPE_ENV'),
-      redisUrl: cfg.get('REDIS_URL'),  // required for dispatch
+      redisUrl: cfg.get('DUCTAPE_REDIS_URL'),  // required — no dispatch() works without this
     }),
   })
 
+  Environment variable (add to .env and deployment secrets):
+    DUCTAPE_REDIS_URL=redis://localhost:6379          # local dev
+    DUCTAPE_REDIS_URL=rediss://:<password>@host:6380  # managed Redis (TLS)
+
 INJECTING IN SERVICES AND CONTROLLERS — use @InjectContext():
 
   import { InjectContext, DuctapeContext } from '@ductape/nestjs';
@@ -268,7 +276,7 @@ FOR MESSAGING (events.produce / events.consume / events.dispatch):
     @Events.Produce({ event: 'broker-tag:topic-tag' })
     emitOrderCreated(payload: { orderId: string }) { return payload; }
 
-  Dispatch (scheduled or immediate) — REQUIRES redisUrl in DuctapeModule.forIntegration:
+  Dispatch (scheduled or immediate) — dispatch() CANNOT be used without redisUrl in forIntegration:
     @Events.Dispatch({ broker: 'order-events', event: 'order-events:order-created', schedule: { every: 60000 } })
     dispatchHeartbeat(payload: { message: { ping: boolean } }) { return payload; }
 
@@ -343,7 +351,7 @@ ALL params are passed as a JSON array in positional order matching the SDK signa
   actions.fetch   [app_tag, action_tag]
   actions.list    [app_tag]
   actions.run     [{ product, env, app, action, input: { "body:fieldName": value, ... } }]  ← CALL ductape_generate_payload FIRST (operation_family="action", method="run", targets={app, action})
-  actions.dispatch [{ product, env, app, action, input, retries?, session?, cache?, schedule?: { start_at?, cron?, every?, limit?, tz? } }]  ← CALL ductape_generate_payload FIRST (operation_family="action", method="dispatch")
+  actions.dispatch [{ product, env, app, action, input, retries?, session?, cache?, schedule?: { start_at?, cron?, every?, limit?, tz? } }]  ← CALL ductape_generate_payload FIRST (operation_family="action", method="dispatch") — requires redisUrl in ductape initialization
 
 ━━━ MODULE: auths ━━━
   auths.create  [app_tag, data: { tag: string, name: string, setup_type: "header"|"bearer"|"basic"|"oauth2"|"apikey", expiry: number, period: "seconds"|"minutes"|"hours"|"days", description: string, action_tag?: string }]
@@ -421,7 +429,7 @@ ALL params are passed as a JSON array in positional order matching the SDK signa
   quotas.list     [product_tag]
   quotas.delete   [product_tag, quota_tag]
   quotas.run      [{ product: string, env: string, tag: string, input: { fieldName: value }, session?: string, cache?: string }]  ← CALL ductape_generate_payload FIRST (operation_family="quota", method="run", targets={tag})
-  quotas.dispatch [{ product: string, env: string, tag: string, input: object, session?: string, cache?: string, schedule?: { cron?: string, delay?: number, at?: string } }]  ← CALL ductape_generate_payload FIRST (operation_family="quota", method="dispatch")
+  quotas.dispatch [{ product: string, env: string, tag: string, input: object, session?: string, cache?: string, schedule?: { cron?: string, delay?: number, at?: string } }]  ← CALL ductape_generate_payload FIRST (operation_family="quota", method="dispatch") — requires redisUrl in ductape initialization
 
 ━━━ MODULE: fallback ━━━
   fallback.create   [product_tag, data: {
@@ -464,7 +472,7 @@ ALL params are passed as a JSON array in positional order matching the SDK signa
   fallback.list     [product_tag]
   fallback.delete   [product_tag, fallback_tag]
   fallback.run      [{ product: string, env: string, tag: string, input: { fieldName: value }, session?: string, cache?: string }]  ← CALL ductape_generate_payload FIRST (operation_family="fallback", method="run", targets={tag})
-  fallback.dispatch [{ product: string, env: string, tag: string, input: object, session?: string, cache?: string, schedule?: { cron?: string, delay?: number, at?: string } }]  ← CALL ductape_generate_payload FIRST (operation_family="fallback", method="dispatch")
+  fallback.dispatch [{ product: string, env: string, tag: string, input: object, session?: string, cache?: string, schedule?: { cron?: string, delay?: number, at?: string } }]  ← CALL ductape_generate_payload FIRST (operation_family="fallback", method="dispatch") — requires redisUrl in ductape initialization
 
 ━━━ MODULE: health ━━━
   health.create   [product_tag, data: { tag: string, name: string, description?: string, app?: string, event?: string, probe?: { type: "app"|"database"|"feature", app?: string, event?: string, input?: object }, interval: number, retries: number, envs: [{ slug: string, input?: object }], onFailure?: { notifications?: [{ notification: string, message: string, channels: { email?: { recipients: string[] }, push?: { recipients?: string[] }, sms?: { recipients: string[] } } }], webhooks?: [{ url: string, method?: "GET"|"POST", headers?: object, body?: object }] } }]
@@ -491,36 +499,36 @@ ALL params are passed as a JSON array in positional order matching the SDK signa
   notifications.push.send   [{ product, env, notification, input: { ... }, session?, cache? }]  ← CALL ductape_generate_payload FIRST (operation_family="notification", method="push.send")
   notifications.sms.send    [{ product, env, notification, input: { ... }, session?, cache? }]  ← CALL ductape_generate_payload FIRST (operation_family="notification", method="sms.send")
   notifications.callback.send [{ product, env, notification, input: { ... }, session?, cache? }]  ← CALL ductape_generate_payload FIRST (operation_family="notification", method="callback.send")
-  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")
+  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? } }]
-  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, broker, event, input: { message }, retries?, session?, cache?, schedule?: { cron?, every?, start_at? } }]  — 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 } }] }]
@@ -540,7 +548,7 @@ ALL params are passed as a JSON array in positional order matching the SDK signa
   storage.files.delete   [{ product, env, storage, fileName }]
   storage.files.list     [{ product, env, storage, prefix?, limit?, continuationToken? }]
   storage.files.getSignedUrl [{ product, env, storage, fileName, expiresIn?, action? }]
-  storage.dispatch [{ product, env, storage, operation, input, retries?, session?, cache?, schedule? }]  ← CALL ductape_generate_payload FIRST (operation_family="storage", method="dispatch", targets={storage})
+  storage.dispatch [{ product, env, storage, operation, input, retries?, session?, cache?, schedule? }]  ← CALL ductape_generate_payload FIRST (operation_family="storage", method="dispatch", targets={storage}) — requires redisUrl in ductape initialization
 
 ━━━ MODULE: databases ━━━
   databases.create  [{ product, tag, name, description?, type: "mongodb"|"postgresql"|"mysql"|"sqlite",
@@ -608,8 +616,8 @@ ALL params are passed as a JSON array in positional order matching the SDK signa
   databases.action.fetch  [action_tag]
   databases.action.list   [database_tag]
   databases.action.delete [action_tag]
-  databases.action.dispatch [{ product, env, database, action, input, schedule? }]  ← CALL ductape_generate_payload FIRST (operation_family="database", method="dispatch", targets={database: "db_tag", table: "table_name"})
-  databases.dispatch [{ product, env, database, action, input, schedule? }]  ← CALL ductape_generate_payload FIRST (operation_family="database", method="dispatch", targets={database: "db_tag", table: "table_name"})
+  databases.action.dispatch [{ product, env, database, action, input, schedule? }]  ← CALL ductape_generate_payload FIRST (operation_family="database", method="dispatch", targets={database: "db_tag", table: "table_name"}) — requires redisUrl in ductape initialization
+  databases.dispatch [{ product, env, database, action, input, schedule? }]  ← CALL ductape_generate_payload FIRST (operation_family="database", method="dispatch", targets={database: "db_tag", table: "table_name"}) — requires redisUrl in ductape initialization
   databases.beginTransaction [{ product, env, database, isolationLevel?: "READ_COMMITTED"|"REPEATABLE_READ"|"SERIALIZABLE" }]
     → returns a transaction object; pass it to insert/update/delete/upsert/query calls as the last argument.
     Commit with: transaction.commit()   Rollback with: transaction.rollback()
@@ -671,7 +679,7 @@ ALL params are passed as a JSON array in positional order matching the SDK signa
   graph.beginTransaction [options?]
   graph.commitTransaction [transaction]
   graph.rollbackTransaction [transaction]
-  graph.dispatch [data]  ← CALL ductape_generate_payload FIRST (operation_family="graph", method="dispatch", targets={graph})
+  graph.dispatch [data]  ← CALL ductape_generate_payload FIRST (operation_family="graph", method="dispatch", targets={graph}) — requires redisUrl in ductape initialization
 
 ━━━ MODULE: vector ━━━
   vector.create  [{ product, tag, name, description?, provider: "pinecone"|"qdrant"|"weaviate", dimensions: number, metric?: "cosine"|"euclidean"|"dotproduct", envs: [{slug, api_key, environment?}] }]
@@ -791,7 +799,7 @@ ALL params are passed as a JSON array in positional order matching the SDK signa
     timeout?: number
   }]
 
-  features.dispatch [{   ← CALL ductape_generate_payload FIRST (operation_family="features", method="dispatch", targets={feature})
+  features.dispatch [{   ← CALL ductape_generate_payload FIRST (operation_family="features", method="dispatch", targets={feature}) — requires redisUrl in ductape initialization
     product: string,
     env: string,
     feature: string,
@@ -1019,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}`;
@@ -2459,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:
@@ -2486,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 ━━━
 
@@ -2497,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",
@@ -2512,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; }
@@ -2552,7 +2577,7 @@ 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"
@@ -2623,24 +2648,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
@@ -3268,6 +3293,7 @@ async function loadMcpSdk() {
     console.error('Failed to load MCP SDK. Install: npm install @modelcontextprotocol/sdk zod\n' +
         'Or v2 alpha: npm install @modelcontextprotocol/server zod @cfworker/json-schema');
     process.exit(1);
+    throw new Error('MCP SDK not available');
 }
 function handleCliFlags() {
     const arg = process.argv[2];
@@ -3368,7 +3394,9 @@ 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;
+            const result = await executeViaProxy(key, proxyModule, args.method, args.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.43",
+  "version": "0.1.45",
   "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',
 ];
 
@@ -191,29 +191,33 @@ global interceptors, decorators, and type-safe resource handles.
 
 SETUP — register once in AppModule:
 
+  ╔══════════════════════════════════════════════════════════════════════════╗
+  ║  redisUrl IS REQUIRED TO USE ANY *.dispatch()                          ║
+  ║                                                                          ║
+  ║  Every dispatch() call (actions, features, events, databases, storage,  ║
+  ║  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."        ║
+  ║                                                                          ║
+  ║  *.run(), events.produce(), and @Events.Consumer do NOT need Redis.     ║
+  ║  Only dispatch() does — and it is non-negotiable.                       ║
+  ╚══════════════════════════════════════════════════════════════════════════╝
+
   import { DuctapeModule } from '@ductape/nestjs';
 
   @Module({
     imports: [
       DuctapeModule.forIntegration({
         accessKey: process.env.DUCTAPE_ACCESS_KEY,
-        product: 'my-product',   // optional default — overridable per controller
+        product: 'my-product',
         env: process.env.NODE_ENV === 'production' ? 'prd' : 'snd',
-        redisUrl: process.env.REDIS_URL,  // REQUIRED when using events.dispatch() or @Events.Dispatch
+        redisUrl: process.env.DUCTAPE_REDIS_URL,  // required — no dispatch() works without this
       }),
     ],
   })
   export class AppModule {}
 
-  IMPORTANT — redisUrl:
-    ALL *.dispatch() calls (actions.dispatch, features.dispatch, events.dispatch, databases.dispatch,
-    storage.dispatch, graph.dispatch, notifications.dispatch, messageBrokers.dispatch, quotas.dispatch,
-    fallback.dispatch, etc.) enqueue jobs via BullMQ, which requires a Redis connection.
-    Without redisUrl ANY dispatch() call throws "Queues not configured. dispatch() requires a queue connection."
-    Set REDIS_URL (e.g. redis://localhost:6379 or a managed Redis connection string) and pass it as redisUrl.
-    *.run(), events.produce(), and @Events.Consumer do NOT require Redis — only dispatch() does.
-
-  // Async (e.g. pulling key from ConfigService):
+  // Async (e.g. pulling from ConfigService):
   DuctapeModule.forRootAsync({
     imports: [ConfigModule],
     inject: [ConfigService],
@@ -221,10 +225,14 @@ SETUP — register once in AppModule:
       accessKey: cfg.get('DUCTAPE_ACCESS_KEY'),
       product: cfg.get('DUCTAPE_PRODUCT'),
       env: cfg.get('DUCTAPE_ENV'),
-      redisUrl: cfg.get('REDIS_URL'),  // required for dispatch
+      redisUrl: cfg.get('DUCTAPE_REDIS_URL'),  // required — no dispatch() works without this
     }),
   })
 
+  Environment variable (add to .env and deployment secrets):
+    DUCTAPE_REDIS_URL=redis://localhost:6379          # local dev
+    DUCTAPE_REDIS_URL=rediss://:<password>@host:6380  # managed Redis (TLS)
+
 INJECTING IN SERVICES AND CONTROLLERS — use @InjectContext():
 
   import { InjectContext, DuctapeContext } from '@ductape/nestjs';
@@ -279,7 +287,7 @@ FOR MESSAGING (events.produce / events.consume / events.dispatch):
     @Events.Produce({ event: 'broker-tag:topic-tag' })
     emitOrderCreated(payload: { orderId: string }) { return payload; }
 
-  Dispatch (scheduled or immediate) — REQUIRES redisUrl in DuctapeModule.forIntegration:
+  Dispatch (scheduled or immediate) — dispatch() CANNOT be used without redisUrl in forIntegration:
     @Events.Dispatch({ broker: 'order-events', event: 'order-events:order-created', schedule: { every: 60000 } })
     dispatchHeartbeat(payload: { message: { ping: boolean } }) { return payload; }
 
@@ -354,7 +362,7 @@ ALL params are passed as a JSON array in positional order matching the SDK signa
   actions.fetch   [app_tag, action_tag]
   actions.list    [app_tag]
   actions.run     [{ product, env, app, action, input: { "body:fieldName": value, ... } }]  ← CALL ductape_generate_payload FIRST (operation_family="action", method="run", targets={app, action})
-  actions.dispatch [{ product, env, app, action, input, retries?, session?, cache?, schedule?: { start_at?, cron?, every?, limit?, tz? } }]  ← CALL ductape_generate_payload FIRST (operation_family="action", method="dispatch")
+  actions.dispatch [{ product, env, app, action, input, retries?, session?, cache?, schedule?: { start_at?, cron?, every?, limit?, tz? } }]  ← CALL ductape_generate_payload FIRST (operation_family="action", method="dispatch") — requires redisUrl in ductape initialization
 
 ━━━ MODULE: auths ━━━
   auths.create  [app_tag, data: { tag: string, name: string, setup_type: "header"|"bearer"|"basic"|"oauth2"|"apikey", expiry: number, period: "seconds"|"minutes"|"hours"|"days", description: string, action_tag?: string }]
@@ -432,7 +440,7 @@ ALL params are passed as a JSON array in positional order matching the SDK signa
   quotas.list     [product_tag]
   quotas.delete   [product_tag, quota_tag]
   quotas.run      [{ product: string, env: string, tag: string, input: { fieldName: value }, session?: string, cache?: string }]  ← CALL ductape_generate_payload FIRST (operation_family="quota", method="run", targets={tag})
-  quotas.dispatch [{ product: string, env: string, tag: string, input: object, session?: string, cache?: string, schedule?: { cron?: string, delay?: number, at?: string } }]  ← CALL ductape_generate_payload FIRST (operation_family="quota", method="dispatch")
+  quotas.dispatch [{ product: string, env: string, tag: string, input: object, session?: string, cache?: string, schedule?: { cron?: string, delay?: number, at?: string } }]  ← CALL ductape_generate_payload FIRST (operation_family="quota", method="dispatch") — requires redisUrl in ductape initialization
 
 ━━━ MODULE: fallback ━━━
   fallback.create   [product_tag, data: {
@@ -475,7 +483,7 @@ ALL params are passed as a JSON array in positional order matching the SDK signa
   fallback.list     [product_tag]
   fallback.delete   [product_tag, fallback_tag]
   fallback.run      [{ product: string, env: string, tag: string, input: { fieldName: value }, session?: string, cache?: string }]  ← CALL ductape_generate_payload FIRST (operation_family="fallback", method="run", targets={tag})
-  fallback.dispatch [{ product: string, env: string, tag: string, input: object, session?: string, cache?: string, schedule?: { cron?: string, delay?: number, at?: string } }]  ← CALL ductape_generate_payload FIRST (operation_family="fallback", method="dispatch")
+  fallback.dispatch [{ product: string, env: string, tag: string, input: object, session?: string, cache?: string, schedule?: { cron?: string, delay?: number, at?: string } }]  ← CALL ductape_generate_payload FIRST (operation_family="fallback", method="dispatch") — requires redisUrl in ductape initialization
 
 ━━━ MODULE: health ━━━
   health.create   [product_tag, data: { tag: string, name: string, description?: string, app?: string, event?: string, probe?: { type: "app"|"database"|"feature", app?: string, event?: string, input?: object }, interval: number, retries: number, envs: [{ slug: string, input?: object }], onFailure?: { notifications?: [{ notification: string, message: string, channels: { email?: { recipients: string[] }, push?: { recipients?: string[] }, sms?: { recipients: string[] } } }], webhooks?: [{ url: string, method?: "GET"|"POST", headers?: object, body?: object }] } }]
@@ -502,36 +510,36 @@ ALL params are passed as a JSON array in positional order matching the SDK signa
   notifications.push.send   [{ product, env, notification, input: { ... }, session?, cache? }]  ← CALL ductape_generate_payload FIRST (operation_family="notification", method="push.send")
   notifications.sms.send    [{ product, env, notification, input: { ... }, session?, cache? }]  ← CALL ductape_generate_payload FIRST (operation_family="notification", method="sms.send")
   notifications.callback.send [{ product, env, notification, input: { ... }, session?, cache? }]  ← CALL ductape_generate_payload FIRST (operation_family="notification", method="callback.send")
-  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")
+  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? } }]
-  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, broker, event, input: { message }, retries?, session?, cache?, schedule?: { cron?, every?, start_at? } }]  — 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 } }] }]
@@ -551,7 +559,7 @@ ALL params are passed as a JSON array in positional order matching the SDK signa
   storage.files.delete   [{ product, env, storage, fileName }]
   storage.files.list     [{ product, env, storage, prefix?, limit?, continuationToken? }]
   storage.files.getSignedUrl [{ product, env, storage, fileName, expiresIn?, action? }]
-  storage.dispatch [{ product, env, storage, operation, input, retries?, session?, cache?, schedule? }]  ← CALL ductape_generate_payload FIRST (operation_family="storage", method="dispatch", targets={storage})
+  storage.dispatch [{ product, env, storage, operation, input, retries?, session?, cache?, schedule? }]  ← CALL ductape_generate_payload FIRST (operation_family="storage", method="dispatch", targets={storage}) — requires redisUrl in ductape initialization
 
 ━━━ MODULE: databases ━━━
   databases.create  [{ product, tag, name, description?, type: "mongodb"|"postgresql"|"mysql"|"sqlite",
@@ -619,8 +627,8 @@ ALL params are passed as a JSON array in positional order matching the SDK signa
   databases.action.fetch  [action_tag]
   databases.action.list   [database_tag]
   databases.action.delete [action_tag]
-  databases.action.dispatch [{ product, env, database, action, input, schedule? }]  ← CALL ductape_generate_payload FIRST (operation_family="database", method="dispatch", targets={database: "db_tag", table: "table_name"})
-  databases.dispatch [{ product, env, database, action, input, schedule? }]  ← CALL ductape_generate_payload FIRST (operation_family="database", method="dispatch", targets={database: "db_tag", table: "table_name"})
+  databases.action.dispatch [{ product, env, database, action, input, schedule? }]  ← CALL ductape_generate_payload FIRST (operation_family="database", method="dispatch", targets={database: "db_tag", table: "table_name"}) — requires redisUrl in ductape initialization
+  databases.dispatch [{ product, env, database, action, input, schedule? }]  ← CALL ductape_generate_payload FIRST (operation_family="database", method="dispatch", targets={database: "db_tag", table: "table_name"}) — requires redisUrl in ductape initialization
   databases.beginTransaction [{ product, env, database, isolationLevel?: "READ_COMMITTED"|"REPEATABLE_READ"|"SERIALIZABLE" }]
     → returns a transaction object; pass it to insert/update/delete/upsert/query calls as the last argument.
     Commit with: transaction.commit()   Rollback with: transaction.rollback()
@@ -682,7 +690,7 @@ ALL params are passed as a JSON array in positional order matching the SDK signa
   graph.beginTransaction [options?]
   graph.commitTransaction [transaction]
   graph.rollbackTransaction [transaction]
-  graph.dispatch [data]  ← CALL ductape_generate_payload FIRST (operation_family="graph", method="dispatch", targets={graph})
+  graph.dispatch [data]  ← CALL ductape_generate_payload FIRST (operation_family="graph", method="dispatch", targets={graph}) — requires redisUrl in ductape initialization
 
 ━━━ MODULE: vector ━━━
   vector.create  [{ product, tag, name, description?, provider: "pinecone"|"qdrant"|"weaviate", dimensions: number, metric?: "cosine"|"euclidean"|"dotproduct", envs: [{slug, api_key, environment?}] }]
@@ -802,7 +810,7 @@ ALL params are passed as a JSON array in positional order matching the SDK signa
     timeout?: number
   }]
 
-  features.dispatch [{   ← CALL ductape_generate_payload FIRST (operation_family="features", method="dispatch", targets={feature})
+  features.dispatch [{   ← CALL ductape_generate_payload FIRST (operation_family="features", method="dispatch", targets={feature}) — requires redisUrl in ductape initialization
     product: string,
     env: string,
     feature: string,
@@ -1054,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}`;
@@ -2532,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:
@@ -2559,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 ━━━
 
@@ -2570,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",
@@ -2585,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; }
@@ -2625,7 +2650,7 @@ 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"
@@ -2696,24 +2721,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: `
@@ -3355,6 +3380,7 @@ async function loadMcpSdk(): Promise<{
       'Or v2 alpha: npm install @modelcontextprotocol/server zod @cfworker/json-schema',
   );
   process.exit(1);
+  throw new Error('MCP SDK not available');
 }
 
 function handleCliFlags(): boolean {
@@ -3466,7 +3492,9 @@ 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;
+      const result = await executeViaProxy(key, proxyModule, args.method, args.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'

package/tsconfig.json

@@ -9,7 +9,8 @@
     "esModuleInterop": true,
     "skipLibCheck": true,
     "declaration": true,
-    "declarationMap": true
+    "declarationMap": true,
+    "types": ["node"]
   },
   "include": ["src/**/*"],
   "exclude": ["node_modules"]