@ductape/mcp 0.1.42 → 0.1.44

package/dist/index.js

@@ -180,20 +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, messageBrokers, 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.DUCTAPE_REDIS_URL,  // required — no dispatch() works without this
       }),
     ],
   })
   export class AppModule {}
 
-  // Async (e.g. pulling key from ConfigService):
+  // Async (e.g. pulling from ConfigService):
   DuctapeModule.forRootAsync({
     imports: [ConfigModule],
     inject: [ConfigService],
@@ -201,9 +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('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';
@@ -258,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) — static schedule in decorator:
+  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; }
 
@@ -273,6 +291,7 @@ FOR MESSAGING (events.produce / events.consume / events.dispatch):
     }
     // method return takes precedence over decorator schedule; use sdk.events.dispatch() directly
     // when even the broker/event must vary at call time.
+    // ALL *.dispatch() calls require redisUrl — BullMQ over Redis. Without it dispatch throws.
 
   Consume (method decorator — method is called for each incoming message):
     @Events.Consumer({ event: 'order-events:order-created' })
@@ -332,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 }]
@@ -410,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: {
@@ -453,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 }] } }]
@@ -480,7 +499,7 @@ 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 ━━━
@@ -491,7 +510,7 @@ ALL params are passed as a JSON array in positional order matching the SDK signa
   messageBrokers.delete   [product_tag, broker_tag]
   messageBrokers.topics.create  ← FORBIDDEN with publishable key. Use ductape_cli instead:
     ductape_cli("events topics create -f topic.json")
-    topic.json: { tag, name, broker, description?, sample?, idempotent?, queueUrls?: [{ env_slug, url }] }
+    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.
@@ -503,7 +522,7 @@ ALL params are passed as a JSON array in positional order matching the SDK signa
   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.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? }]
@@ -529,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",
@@ -597,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()
@@ -660,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?}] }]
@@ -780,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,
@@ -2456,12 +2475,11 @@ Import (register an EXISTING cloud resource):
 
   topic.json schema:
     {
-      "tag": "order-created",           // topic tag only — NOT "broker:topic"
+      "tag": "order-events:order-created",  // ALWAYS "broker-tag:topic-tag" — full event string
       "name": "Order Created",
-      "broker": "order-events",         // broker component tag
-      "description": "...",             // optional
+      "description": "...",                // optional
       "sample": { "orderId": "string", "total": 0 },  // expected message shape
-      "idempotent": false,              // optional — deduplicates by idempotency_key when true
+      "idempotent": false,                 // optional — deduplicates by idempotency_key when true
       // AWS SQS only — per-env queue URL:
       "queueUrls": [
         { "env_slug": "snd", "url": "https://sqs.us-east-1.amazonaws.com/123/queue-snd" },
@@ -3258,6 +3276,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];

package/package.json

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

package/src/index.ts

@@ -191,20 +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, messageBrokers, 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.DUCTAPE_REDIS_URL,  // required — no dispatch() works without this
       }),
     ],
   })
   export class AppModule {}
 
-  // Async (e.g. pulling key from ConfigService):
+  // Async (e.g. pulling from ConfigService):
   DuctapeModule.forRootAsync({
     imports: [ConfigModule],
     inject: [ConfigService],
@@ -212,9 +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('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';
@@ -269,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) — static schedule in decorator:
+  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; }
 
@@ -284,6 +302,7 @@ FOR MESSAGING (events.produce / events.consume / events.dispatch):
     }
     // method return takes precedence over decorator schedule; use sdk.events.dispatch() directly
     // when even the broker/event must vary at call time.
+    // ALL *.dispatch() calls require redisUrl — BullMQ over Redis. Without it dispatch throws.
 
   Consume (method decorator — method is called for each incoming message):
     @Events.Consumer({ event: 'order-events:order-created' })
@@ -343,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 }]
@@ -421,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: {
@@ -464,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 }] } }]
@@ -491,7 +510,7 @@ 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 ━━━
@@ -502,7 +521,7 @@ ALL params are passed as a JSON array in positional order matching the SDK signa
   messageBrokers.delete   [product_tag, broker_tag]
   messageBrokers.topics.create  ← FORBIDDEN with publishable key. Use ductape_cli instead:
     ductape_cli("events topics create -f topic.json")
-    topic.json: { tag, name, broker, description?, sample?, idempotent?, queueUrls?: [{ env_slug, url }] }
+    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.
@@ -514,7 +533,7 @@ ALL params are passed as a JSON array in positional order matching the SDK signa
   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.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? }]
@@ -540,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",
@@ -608,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()
@@ -671,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?}] }]
@@ -791,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,
@@ -2529,12 +2548,11 @@ Import (register an EXISTING cloud resource):
 
   topic.json schema:
     {
-      "tag": "order-created",           // topic tag only — NOT "broker:topic"
+      "tag": "order-events:order-created",  // ALWAYS "broker-tag:topic-tag" — full event string
       "name": "Order Created",
-      "broker": "order-events",         // broker component tag
-      "description": "...",             // optional
+      "description": "...",                // optional
       "sample": { "orderId": "string", "total": 0 },  // expected message shape
-      "idempotent": false,              // optional — deduplicates by idempotency_key when true
+      "idempotent": false,                 // optional — deduplicates by idempotency_key when true
       // AWS SQS only — per-env queue URL:
       "queueUrls": [
         { "env_slug": "snd", "url": "https://sqs.us-east-1.amazonaws.com/123/queue-snd" },
@@ -3345,6 +3363,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 {

package/tsconfig.json

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