@ductape/mcp 0.1.8 → 0.1.10

package/dist/index.js

@@ -636,7 +636,8 @@ ALL params are passed as a JSON array in positional order matching the SDK signa
     "graphs.create", "graphs.update", "vectors.create", "vectors.update",
     "sessions.create", "sessions.update", "healthchecks.create",
     "quotas.create", "quotas.update", "functions.create", "functions.update",
-    "agents.create", "agents.update", "models.create", "models.update"
+    "agents.create", "agents.update", "models.create", "models.update",
+    "storage.create", "storage.update"
 
   When to use this tool:
   - Before calling ductape_execute to create or update any asset — use this to discover required fields
@@ -1112,7 +1113,14 @@ async function main() {
             description: 'Returns the full field manifest for Ductape asset creation/update methods, ' +
                 'derived live from the SDK Joi validators. Includes field types, required flags, ' +
                 'enum values, nested structures, and all enum constants. ' +
-                'Pass module="app" or module="product" to scope the result.',
+                'Pass module="app" or module="product" to scope the result.\n\n' +
+                'ALWAYS call this before constructing a file for "resources <type> create" or any cloud ' +
+                'import/provision operation — field shapes are not guessable from context.\n\n' +
+                'Conditional fields: some fields are returned as oneOf (an array of variant shapes). ' +
+                'For example, storage.create envs[].config is oneOf [awsConfig, gcpConfig, azureConfig] — ' +
+                'pick the variant whose fields match the envs[].type value (aws/gcp/azure). ' +
+                'Fields inside oneOf variants are context-dependent and should all be treated as optional ' +
+                'unless the chosen variant explicitly marks them required.',
             inputSchema: schemaInputSchema,
         }, schemaHandler);
         server.registerTool('ductape_cli', {
@@ -1122,9 +1130,41 @@ async function main() {
                 '  - Creating or updating products (products create/update) and apps (apps create/update)\n' +
                 '  - Importing an app from a Postman v2.1 or OpenAPI 3.0 file: "apps import <file> -t postman|openapi"\n' +
                 '  - Managing resources via "resources <type> <verb>" (databases, storage, caches…)\n' +
+                '    ALWAYS call ductape_schema(module="product") first to get the exact field shape before\n' +
+                '    constructing a file. Storage envs[].config is conditional on envs[].type (aws/gcp/azure)\n' +
+                '    and returned as oneOf — pick the variant matching the type.\n' +
+                '  - Three distinct storage registration flows — choose the right one:\n' +
+                '    1. Manual credentials (bucket already exists, you supply keys directly):\n' +
+                '         resources storage create -f storage.json\n' +
+                '       File shape: { name, tag, envs: [{ slug, type: "aws"|"gcp"|"azure", config: { bucketName, ...creds } }] }\n' +
+                '       For cloud-linked envs set config.cloud to the connection tag and omit raw credentials.\n' +
+                '    2. Import an existing cloud bucket via a cloud connection (no provisioning):\n' +
+                '         cloud resources import-persist -f import.json --json\n' +
+                '       File requires: cloud (connection tag), service (e.g. "gcs","s3"), type ("storage"),\n' +
+                '       product, component (new tag), env, and the existing bucket identifier (e.g. bucketName).\n' +
+                '       Example: {"cloud":"gcp-conn","service":"gcs","type":"storage","product":"my-product",\n' +
+                '       "component":"assets","env":"snd","bucketName":"my-existing-bucket"}.\n' +
+                '       If import-persist fails, the error message now reports both the create failure and the\n' +
+                '       update fallback failure — read both to diagnose. Do not retry blindly.\n' +
+                '    3. Provision a brand-new bucket AND register it (see provision-persist docs below).\n' +
                 '  - Managing cloud connections and cloud-linked resources\n' +
-                '  - Provisioning cloud resources with a specific tier: "cloud resources provision -f file.json --tier <tier_name>"\n' +
-                '    (list available tiers first with "cloud tiers list --provider <aws|gcp|azure>")\n' +
+                '  - Discovering cloud tiers: "cloud tiers --provider <provider> --type <database|storage> [--db-type <type>] --json"\n' +
+                '    IMPORTANT: `cloud tiers` has no `list` verb. Use only a tier returned for the selected provider/type.\n' +
+                '  - Provisioning and persisting a cloud resource: "cloud resources provision-persist -f file.json --tier <tier_name> --json"\n' +
+                '    The JSON file requires: cloud (connection tag), service (provider service), type (Ductape component type),\n' +
+                '    product (product tag), component (new component tag), and env (existing environment slug).\n' +
+                '    Provider parameters such as region, location, bucketName, dbName, and waitForReady may be supplied in the file.\n' +
+                '    Example GCS Standard file: {"cloud":"gcp-tag","service":"gcs","type":"storage",' +
+                '"product":"product-tag","component":"assets","env":"snd","location":"us-central1"}.\n' +
+                '    Use `provision-persist` when the result must be registered as a Ductape asset; `provision` alone only returns\n' +
+                '    the provider resource and component draft. Tier discovery does not by itself prove that a connection supports\n' +
+                '    provisioning that service: if provisioning reports an unsupported provider/service pair, stop and report it.\n' +
+                '    Never infer an environment, provider service, region, tier, or cost. List/verify each before provisioning.\n' +
+                '  - Known provisioning limitations: MongoDB Atlas (M0 free tier) and Neo4j Aura cannot be provisioned via\n' +
+                '    Ductape — they are import-only. Only AWS, GCP, and Azure managed services support provision-persist.\n' +
+                '    Supported service/component pairs include: rds→database, aurora→database, gcs→storage, s3→storage,\n' +
+                '    azure-blob→storage, cloud-sql→database, neptune→graph, opensearch→vector. Attempting an unsupported pair\n' +
+                '    will return an error; do not retry with a different tier — report the limitation to the user.\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.8",
+  "version": "0.1.10",
   "description": "MCP server that exposes Ductape SDK operations via the backend proxy",
   "type": "module",
   "main": "dist/index.js",

package/src/index.ts

@@ -647,7 +647,8 @@ ALL params are passed as a JSON array in positional order matching the SDK signa
     "graphs.create", "graphs.update", "vectors.create", "vectors.update",
     "sessions.create", "sessions.update", "healthchecks.create",
     "quotas.create", "quotas.update", "functions.create", "functions.update",
-    "agents.create", "agents.update", "models.create", "models.update"
+    "agents.create", "agents.update", "models.create", "models.update",
+    "storage.create", "storage.update"
 
   When to use this tool:
   - Before calling ductape_execute to create or update any asset — use this to discover required fields
@@ -1201,7 +1202,14 @@ async function main() {
           'Returns the full field manifest for Ductape asset creation/update methods, ' +
           'derived live from the SDK Joi validators. Includes field types, required flags, ' +
           'enum values, nested structures, and all enum constants. ' +
-          'Pass module="app" or module="product" to scope the result.',
+          'Pass module="app" or module="product" to scope the result.\n\n' +
+          'ALWAYS call this before constructing a file for "resources <type> create" or any cloud ' +
+          'import/provision operation — field shapes are not guessable from context.\n\n' +
+          'Conditional fields: some fields are returned as oneOf (an array of variant shapes). ' +
+          'For example, storage.create envs[].config is oneOf [awsConfig, gcpConfig, azureConfig] — ' +
+          'pick the variant whose fields match the envs[].type value (aws/gcp/azure). ' +
+          'Fields inside oneOf variants are context-dependent and should all be treated as optional ' +
+          'unless the chosen variant explicitly marks them required.',
         inputSchema: schemaInputSchema,
       },
       schemaHandler,
@@ -1216,9 +1224,41 @@ async function main() {
           '  - Creating or updating products (products create/update) and apps (apps create/update)\n' +
           '  - Importing an app from a Postman v2.1 or OpenAPI 3.0 file: "apps import <file> -t postman|openapi"\n' +
           '  - Managing resources via "resources <type> <verb>" (databases, storage, caches…)\n' +
+          '    ALWAYS call ductape_schema(module="product") first to get the exact field shape before\n' +
+          '    constructing a file. Storage envs[].config is conditional on envs[].type (aws/gcp/azure)\n' +
+          '    and returned as oneOf — pick the variant matching the type.\n' +
+          '  - Three distinct storage registration flows — choose the right one:\n' +
+          '    1. Manual credentials (bucket already exists, you supply keys directly):\n' +
+          '         resources storage create -f storage.json\n' +
+          '       File shape: { name, tag, envs: [{ slug, type: "aws"|"gcp"|"azure", config: { bucketName, ...creds } }] }\n' +
+          '       For cloud-linked envs set config.cloud to the connection tag and omit raw credentials.\n' +
+          '    2. Import an existing cloud bucket via a cloud connection (no provisioning):\n' +
+          '         cloud resources import-persist -f import.json --json\n' +
+          '       File requires: cloud (connection tag), service (e.g. "gcs","s3"), type ("storage"),\n' +
+          '       product, component (new tag), env, and the existing bucket identifier (e.g. bucketName).\n' +
+          '       Example: {"cloud":"gcp-conn","service":"gcs","type":"storage","product":"my-product",\n' +
+          '       "component":"assets","env":"snd","bucketName":"my-existing-bucket"}.\n' +
+          '       If import-persist fails, the error message now reports both the create failure and the\n' +
+          '       update fallback failure — read both to diagnose. Do not retry blindly.\n' +
+          '    3. Provision a brand-new bucket AND register it (see provision-persist docs below).\n' +
           '  - Managing cloud connections and cloud-linked resources\n' +
-          '  - Provisioning cloud resources with a specific tier: "cloud resources provision -f file.json --tier <tier_name>"\n' +
-          '    (list available tiers first with "cloud tiers list --provider <aws|gcp|azure>")\n' +
+          '  - Discovering cloud tiers: "cloud tiers --provider <provider> --type <database|storage> [--db-type <type>] --json"\n' +
+          '    IMPORTANT: `cloud tiers` has no `list` verb. Use only a tier returned for the selected provider/type.\n' +
+          '  - Provisioning and persisting a cloud resource: "cloud resources provision-persist -f file.json --tier <tier_name> --json"\n' +
+          '    The JSON file requires: cloud (connection tag), service (provider service), type (Ductape component type),\n' +
+          '    product (product tag), component (new component tag), and env (existing environment slug).\n' +
+          '    Provider parameters such as region, location, bucketName, dbName, and waitForReady may be supplied in the file.\n' +
+          '    Example GCS Standard file: {"cloud":"gcp-tag","service":"gcs","type":"storage",' +
+          '"product":"product-tag","component":"assets","env":"snd","location":"us-central1"}.\n' +
+          '    Use `provision-persist` when the result must be registered as a Ductape asset; `provision` alone only returns\n' +
+          '    the provider resource and component draft. Tier discovery does not by itself prove that a connection supports\n' +
+          '    provisioning that service: if provisioning reports an unsupported provider/service pair, stop and report it.\n' +
+          '    Never infer an environment, provider service, region, tier, or cost. List/verify each before provisioning.\n' +
+          '  - Known provisioning limitations: MongoDB Atlas (M0 free tier) and Neo4j Aura cannot be provisioned via\n' +
+          '    Ductape — they are import-only. Only AWS, GCP, and Azure managed services support provision-persist.\n' +
+          '    Supported service/component pairs include: rds→database, aurora→database, gcs→storage, s3→storage,\n' +
+          '    azure-blob→storage, cloud-sql→database, neptune→graph, opensearch→vector. Attempting an unsupported pair\n' +
+          '    will return an error; do not retry with a different tier — report the limitation to the user.\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' +