@ductape/mcp 0.1.41 → 0.1.43

package/dist/index.js

@@ -188,11 +188,20 @@ SETUP — register once in AppModule:
         accessKey: process.env.DUCTAPE_ACCESS_KEY,
         product: 'my-product',   // optional default — overridable per controller
         env: process.env.NODE_ENV === 'production' ? 'prd' : 'snd',
+        redisUrl: process.env.REDIS_URL,  // REQUIRED when using events.dispatch() or @Events.Dispatch
       }),
     ],
   })
   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):
   DuctapeModule.forRootAsync({
     imports: [ConfigModule],
@@ -201,6 +210,7 @@ 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
     }),
   })
 
@@ -258,7 +268,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) — REQUIRES redisUrl in DuctapeModule.forIntegration:
     @Events.Dispatch({ broker: 'order-events', event: 'order-events:order-created', schedule: { every: 60000 } })
     dispatchHeartbeat(payload: { message: { ping: boolean } }) { return payload; }
 
@@ -273,6 +283,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' })
@@ -491,7 +502,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.
@@ -1097,6 +1108,7 @@ const ADMIN_SUBCOMMANDS = [
     'link', 'unlink', 'init',
     'products', 'apps',
     'resources',
+    'events',
     'cloud',
     'secrets',
     'generate',
@@ -2455,12 +2467,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" },
@@ -3223,9 +3234,10 @@ const cliInputSchema = z.object({
     command: z.string().describe('The ductape CLI command to run, without the leading "ductape" word. ' +
         'Examples: "products list", "products create --name \\"My Product\\" --tag my-product", ' +
         '"apps list", "apps create -f app.json", "resources storage list", ' +
+        '"events topics create -f topic.json", "events topics list --tag broker-tag", ' +
         '"cloud connections list", "link --product my-product --env dev".\n\n' +
         'Use this tool for administrative operations: creating or updating products, apps, ' +
-        'resources (databases, storage, caches…), cloud connections, secrets, ' +
+        'resources (databases, storage, caches…), event broker topics, cloud connections, secrets, ' +
         'and for apply/migrate workflows.\n\n' +
         'Note: environments, app actions, features, quotas, fallbacks, and jobs are configured ' +
         'in the Workbench UI — there are no CLI commands for them.\n\n' +

package/package.json

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

package/src/index.ts

@@ -199,11 +199,20 @@ SETUP — register once in AppModule:
         accessKey: process.env.DUCTAPE_ACCESS_KEY,
         product: 'my-product',   // optional default — overridable per controller
         env: process.env.NODE_ENV === 'production' ? 'prd' : 'snd',
+        redisUrl: process.env.REDIS_URL,  // REQUIRED when using events.dispatch() or @Events.Dispatch
       }),
     ],
   })
   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):
   DuctapeModule.forRootAsync({
     imports: [ConfigModule],
@@ -212,6 +221,7 @@ 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
     }),
   })
 
@@ -269,7 +279,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) — REQUIRES redisUrl in DuctapeModule.forIntegration:
     @Events.Dispatch({ broker: 'order-events', event: 'order-events:order-created', schedule: { every: 60000 } })
     dispatchHeartbeat(payload: { message: { ping: boolean } }) { return payload; }
 
@@ -284,6 +294,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' })
@@ -502,7 +513,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.
@@ -1146,6 +1157,7 @@ const ADMIN_SUBCOMMANDS = [
   'link', 'unlink', 'init',
   'products', 'apps',
   'resources',
+  'events',
   'cloud',
   'secrets',
   'generate',
@@ -2528,12 +2540,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" },
@@ -3303,9 +3314,10 @@ const cliInputSchema = z.object({
     'The ductape CLI command to run, without the leading "ductape" word. ' +
     'Examples: "products list", "products create --name \\"My Product\\" --tag my-product", ' +
     '"apps list", "apps create -f app.json", "resources storage list", ' +
+    '"events topics create -f topic.json", "events topics list --tag broker-tag", ' +
     '"cloud connections list", "link --product my-product --env dev".\n\n' +
     'Use this tool for administrative operations: creating or updating products, apps, ' +
-    'resources (databases, storage, caches…), cloud connections, secrets, ' +
+    'resources (databases, storage, caches…), event broker topics, cloud connections, secrets, ' +
     'and for apply/migrate workflows.\n\n' +
     'Note: environments, app actions, features, quotas, fallbacks, and jobs are configured ' +
     'in the Workbench UI — there are no CLI commands for them.\n\n' +