@ductape/mcp 0.1.39 → 0.1.40

package/dist/index.js

@@ -464,18 +464,18 @@ ALL params are passed as a JSON array in positional order matching the SDK signa
   messageBrokers.fetch    [product_tag, broker_tag]
   messageBrokers.list     [product_tag]
   messageBrokers.delete   [product_tag, broker_tag]
-  messageBrokers.topics.create [product_tag, data: { tag: string, name: string, broker: string,
-    description?: string, sample?: object, idempotent?: boolean,
-    queueUrls?: [{ env_slug: string, url: string }]  // SQS only: per-env queue URL per topic
-  }]
-  ← OPTIONAL for most providers: creating a producer automatically creates the topic if it does not exist.
-  ← Only required explicitly for SQS (must supply queueUrls per env) or when you want to set sample/idempotent upfront.
-  ← For Pub/Sub, Kafka, RabbitMQ, Redis, NATS: skip this — let producer creation handle it.
-  ← A broker can have unlimited topics. Add one per logical event type.
-  messageBrokers.topics.update [product_tag, topic_tag, data: { name?: string, description?: string,
-    sample?: object, idempotent?: boolean, queueUrls?: [{ env_slug: string, url: string }] }]
-  messageBrokers.topics.fetch  [product_tag, topic_tag]
-  messageBrokers.topics.list   [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 }] }
+  ← 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:
+    ductape_cli("events topics update --tag broker:topic -f patch.json")
+  messageBrokers.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? } }]
@@ -2422,22 +2422,34 @@ 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.
 
-  ductape_execute("messageBrokers.topics.create", [product_tag, {
-    tag: "order-created",             // topic tag (just the topic part, NOT "broker:topic")
-    name: "Order Created",
-    broker: "order-events",           // broker component tag
-    description?: string,
-    sample: { orderId: "string", total: 0 },   // documents expected message shape
-    idempotent?: boolean,             // if true, Ductape deduplicates by idempotency_key
-    // AWS SQS only — must supply per-env queue URL:
-    queueUrls?: [
-      { env_slug: "snd", url: "https://sqs.us-east-1.amazonaws.com/123/queue-snd" },
-      { env_slug: "prd", url: "https://sqs.us-east-1.amazonaws.com/123/queue-prd" }
-    ]
-  }])
+  IMPORTANT: messageBrokers.topics.create requires an access key (admin operation).
+  Use ductape_cli — NOT ductape_execute — to create topics.
+
+  Write a topic.json file, then:
+    ductape_cli("events topics create -f topic.json")
+
+  topic.json schema:
+    {
+      "tag": "order-created",           // topic tag only — NOT "broker:topic"
+      "name": "Order Created",
+      "broker": "order-events",         // broker component tag
+      "description": "...",             // optional
+      "sample": { "orderId": "string", "total": 0 },  // expected message shape
+      "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" },
+        { "env_slug": "prd", "url": "https://sqs.us-east-1.amazonaws.com/123/queue-prd" }
+      ]
+    }
+
+  Other topic operations (all require access key via ductape_cli):
+    ductape_cli("events topics list --tag order-events")          → list topics for a broker
+    ductape_cli("events topics get --tag order-events:order-created")
+    ductape_cli("events topics update --tag order-events:order-created -f patch.json")
+    ductape_cli("events topics delete --tag order-events:order-created")
 
-  List / fetch topics:
-    ductape_execute("messageBrokers.topics.list", [product_tag, "broker-tag"])
+  Read-only fetches (safe with publishable key via ductape_execute):
     ductape_execute("messageBrokers.fetch", [product_tag, "broker-tag"])  → includes topics[]
 
 ━━━ STEP 3: PRODUCE — WRITTEN IN APPLICATION CODE ━━━
@@ -2465,13 +2477,13 @@ Import (register an EXISTING cloud resource):
     });
 
   NESTJS — method decorator:
-    import { Messaging } from '@ductape/nestjs';
+    import { Events } from '@ductape/nestjs';
     @Injectable() export class OrdersService {
-      @Messaging.Produce({ event: 'order-events:order-created' })
+      @Events.Produce({ event: 'order-events:order-created' })
       emitOrderCreated(payload: { orderId: string; total: number }) { return payload; }
 
       // Scheduled dispatch — fire-and-forget with optional schedule:
-      @Messaging.Dispatch({ broker: 'order-events', event: 'order-events:order-created',
+      @Events.Dispatch({ broker: 'order-events', event: 'order-events:order-created',
                             schedule?: { start_at?, cron?, every?, limit?, tz? } })
       scheduleOrderNotification(payload: Record<string, unknown>) { return payload; }
     }
@@ -2546,7 +2558,7 @@ Import (register an EXISTING cloud resource):
       consumer?: { tag: "order-processor", name: "Order Processor" },
     });
 
-  NESTJS — use SDK in onModuleInit (no @Messaging.Consume decorator exists yet):
+  NESTJS — use SDK in onModuleInit (no @Events.Consume decorator exists yet):
     @Injectable()
     export class OrderConsumerService implements OnModuleInit {
       constructor(private readonly ductape: Ductape) {}
@@ -3523,7 +3535,7 @@ async function main() {
                 '    GCP Pub/Sub service identifier is "pubsub". AWS SQS is "sqs". Azure Service Bus is "servicebus".\n' +
                 '    Message brokers are import-only (no provision-persist). Import flow is the same as storage.\n' +
                 '    type field = "messageBrokers" (not "messagebrokers" or "events").\n' +
-                '    After importing, create producers — topics are auto-created with the producer (except SQS, which needs explicit topics.create with queueUrls first).\n' +
+                '    After importing, create topics first with ductape_cli("events topics create -f topic.json") — SQS requires explicit topic creation with queueUrls. For other providers, topics auto-register on first produce but should still be created explicitly before any consumer subscribes.\n' +
                 '  - Listing workspaces, products, secrets\n' +
                 '  - Linking a project folder: "link --product <tag> --env <slug>"\n' +
                 '  - Syncing sessions/notifications/events: "apply" or "apply sessions" etc.\n' +

package/package.json

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

package/src/index.ts

@@ -475,18 +475,18 @@ ALL params are passed as a JSON array in positional order matching the SDK signa
   messageBrokers.fetch    [product_tag, broker_tag]
   messageBrokers.list     [product_tag]
   messageBrokers.delete   [product_tag, broker_tag]
-  messageBrokers.topics.create [product_tag, data: { tag: string, name: string, broker: string,
-    description?: string, sample?: object, idempotent?: boolean,
-    queueUrls?: [{ env_slug: string, url: string }]  // SQS only: per-env queue URL per topic
-  }]
-  ← OPTIONAL for most providers: creating a producer automatically creates the topic if it does not exist.
-  ← Only required explicitly for SQS (must supply queueUrls per env) or when you want to set sample/idempotent upfront.
-  ← For Pub/Sub, Kafka, RabbitMQ, Redis, NATS: skip this — let producer creation handle it.
-  ← A broker can have unlimited topics. Add one per logical event type.
-  messageBrokers.topics.update [product_tag, topic_tag, data: { name?: string, description?: string,
-    sample?: object, idempotent?: boolean, queueUrls?: [{ env_slug: string, url: string }] }]
-  messageBrokers.topics.fetch  [product_tag, topic_tag]
-  messageBrokers.topics.list   [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 }] }
+  ← 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:
+    ductape_cli("events topics update --tag broker:topic -f patch.json")
+  messageBrokers.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? } }]
@@ -2495,22 +2495,34 @@ 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.
 
-  ductape_execute("messageBrokers.topics.create", [product_tag, {
-    tag: "order-created",             // topic tag (just the topic part, NOT "broker:topic")
-    name: "Order Created",
-    broker: "order-events",           // broker component tag
-    description?: string,
-    sample: { orderId: "string", total: 0 },   // documents expected message shape
-    idempotent?: boolean,             // if true, Ductape deduplicates by idempotency_key
-    // AWS SQS only — must supply per-env queue URL:
-    queueUrls?: [
-      { env_slug: "snd", url: "https://sqs.us-east-1.amazonaws.com/123/queue-snd" },
-      { env_slug: "prd", url: "https://sqs.us-east-1.amazonaws.com/123/queue-prd" }
-    ]
-  }])
+  IMPORTANT: messageBrokers.topics.create requires an access key (admin operation).
+  Use ductape_cli — NOT ductape_execute — to create topics.
+
+  Write a topic.json file, then:
+    ductape_cli("events topics create -f topic.json")
+
+  topic.json schema:
+    {
+      "tag": "order-created",           // topic tag only — NOT "broker:topic"
+      "name": "Order Created",
+      "broker": "order-events",         // broker component tag
+      "description": "...",             // optional
+      "sample": { "orderId": "string", "total": 0 },  // expected message shape
+      "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" },
+        { "env_slug": "prd", "url": "https://sqs.us-east-1.amazonaws.com/123/queue-prd" }
+      ]
+    }
+
+  Other topic operations (all require access key via ductape_cli):
+    ductape_cli("events topics list --tag order-events")          → list topics for a broker
+    ductape_cli("events topics get --tag order-events:order-created")
+    ductape_cli("events topics update --tag order-events:order-created -f patch.json")
+    ductape_cli("events topics delete --tag order-events:order-created")
 
-  List / fetch topics:
-    ductape_execute("messageBrokers.topics.list", [product_tag, "broker-tag"])
+  Read-only fetches (safe with publishable key via ductape_execute):
     ductape_execute("messageBrokers.fetch", [product_tag, "broker-tag"])  → includes topics[]
 
 ━━━ STEP 3: PRODUCE — WRITTEN IN APPLICATION CODE ━━━
@@ -2538,13 +2550,13 @@ Import (register an EXISTING cloud resource):
     });
 
   NESTJS — method decorator:
-    import { Messaging } from '@ductape/nestjs';
+    import { Events } from '@ductape/nestjs';
     @Injectable() export class OrdersService {
-      @Messaging.Produce({ event: 'order-events:order-created' })
+      @Events.Produce({ event: 'order-events:order-created' })
       emitOrderCreated(payload: { orderId: string; total: number }) { return payload; }
 
       // Scheduled dispatch — fire-and-forget with optional schedule:
-      @Messaging.Dispatch({ broker: 'order-events', event: 'order-events:order-created',
+      @Events.Dispatch({ broker: 'order-events', event: 'order-events:order-created',
                             schedule?: { start_at?, cron?, every?, limit?, tz? } })
       scheduleOrderNotification(payload: Record<string, unknown>) { return payload; }
     }
@@ -2619,7 +2631,7 @@ Import (register an EXISTING cloud resource):
       consumer?: { tag: "order-processor", name: "Order Processor" },
     });
 
-  NESTJS — use SDK in onModuleInit (no @Messaging.Consume decorator exists yet):
+  NESTJS — use SDK in onModuleInit (no @Events.Consume decorator exists yet):
     @Injectable()
     export class OrderConsumerService implements OnModuleInit {
       constructor(private readonly ductape: Ductape) {}
@@ -3659,7 +3671,7 @@ async function main() {
           '    GCP Pub/Sub service identifier is "pubsub". AWS SQS is "sqs". Azure Service Bus is "servicebus".\n' +
           '    Message brokers are import-only (no provision-persist). Import flow is the same as storage.\n' +
           '    type field = "messageBrokers" (not "messagebrokers" or "events").\n' +
-          '    After importing, create producers — topics are auto-created with the producer (except SQS, which needs explicit topics.create with queueUrls first).\n' +
+          '    After importing, create topics first with ductape_cli("events topics create -f topic.json") — SQS requires explicit topic creation with queueUrls. For other providers, topics auto-register on first produce but should still be created explicitly before any consumer subscribes.\n' +
           '  - Listing workspaces, products, secrets\n' +
           '  - Linking a project folder: "link --product <tag> --env <slug>"\n' +
           '  - Syncing sessions/notifications/events: "apply" or "apply sessions" etc.\n' +