@cloudgrid-io/mcp 0.20.19 → 0.20.21

package/src/corpus/templates/job-board/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: my-jobs
 #   # disk — persistent FS mount (PVC). Injects DISK_PATH. Pins to 1 replica.
 #   #   true | { size: 1Gi, mount: /var/data }  (forbidden: /proc /sys /dev)
 #   disk: true
-#   # ai — AI Gateway via @cloudgrid-io/ai. Injects AI_GATEWAY_URL. true | false.
+#   # ai — AI Gateway via @cloudgrid-io/runtime. Injects RUNTIME_GATEWAY_URL. true | false.
 #   ai: true
 
 
@@ -192,7 +192,7 @@ services:
     #   path: /api/health
     #   expected: "200"
     # Static runtime env vars (strings). Reserved: PORT, APP_NAME, SERVICE_NAME,
-    # NODE_ENV, MONGODB_URL, REDIS_URL, AI_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
+    # NODE_ENV, MONGODB_URL, REDIS_URL, RUNTIME_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
     # env:
     #   LOG_LEVEL: info
     # Sibling services/private resources that must be Ready first (no cron, no cycles).

package/src/corpus/templates/kanban/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: my-board
 #   # disk — persistent FS mount (PVC). Injects DISK_PATH. Pins to 1 replica.
 #   #   true | { size: 1Gi, mount: /var/data }  (forbidden: /proc /sys /dev)
 #   disk: true
-#   # ai — AI Gateway via @cloudgrid-io/ai. Injects AI_GATEWAY_URL. true | false.
+#   # ai — AI Gateway via @cloudgrid-io/runtime. Injects RUNTIME_GATEWAY_URL. true | false.
 #   ai: true
 
 
@@ -192,7 +192,7 @@ services:
     #   path: /api/health
     #   expected: "200"
     # Static runtime env vars (strings). Reserved: PORT, APP_NAME, SERVICE_NAME,
-    # NODE_ENV, MONGODB_URL, REDIS_URL, AI_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
+    # NODE_ENV, MONGODB_URL, REDIS_URL, RUNTIME_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
     # env:
     #   LOG_LEVEL: info
     # Sibling services/private resources that must be Ready first (no cron, no cycles).

package/src/corpus/templates/landing-page/cloudgrid.yaml

@@ -102,7 +102,7 @@ name: landing-page
 #   # disk — persistent FS mount (PVC). Injects DISK_PATH. Pins to 1 replica.
 #   #   true | { size: 1Gi, mount: /var/data }  (forbidden: /proc /sys /dev)
 #   disk: true
-#   # ai — AI Gateway via @cloudgrid-io/ai. Injects AI_GATEWAY_URL. true | false.
+#   # ai — AI Gateway via @cloudgrid-io/runtime. Injects RUNTIME_GATEWAY_URL. true | false.
 #   ai: true
 
 
@@ -198,7 +198,7 @@ services:
     #   path: /api/health
     #   expected: "200"
     # Static runtime env vars (strings). Reserved: PORT, APP_NAME, SERVICE_NAME,
-    # NODE_ENV, MONGODB_URL, REDIS_URL, AI_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
+    # NODE_ENV, MONGODB_URL, REDIS_URL, RUNTIME_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
     # env:
     #   LOG_LEVEL: info
     # Sibling services/private resources that must be Ready first (no cron, no cycles).

package/src/corpus/templates/lms/AGENTS.md

@@ -105,11 +105,11 @@ runtime (after `grid plug`).
   client getter in `lib/auth.js`), not at module top level. If you add paid
   courses, map `STRIPE_KEY`/`STRIPE_WEBHOOK_SECRET` the same way.
 - **AI (optional — auto-grading / quiz generation / a study tutor)** — add
-  `needs: { ai: true }` → the grid injects **`AI_GATEWAY_URL`**; call it via
-  `@cloudgrid-io/ai`. Not enabled in this blueprint; add the need if you want it.
+  `needs: { ai: true }` → the grid injects **`RUNTIME_GATEWAY_URL`**; call it via
+  `@cloudgrid-io/runtime`. Not enabled in this blueprint; add the need if you want it.
 
 Reserved env var names you must NOT set yourself: `PORT`, `NODE_ENV`,
-`DATABASE_MONGODB_URL`/`MONGODB_URL`, `AI_GATEWAY_URL`, `CLOUDGRID_*`.
+`DATABASE_MONGODB_URL`/`MONGODB_URL`, `RUNTIME_GATEWAY_URL`, `CLOUDGRID_*`.
 
 ---
 

package/src/corpus/templates/lms/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: lms
 #   # disk — persistent FS mount (PVC). Injects DISK_PATH. Pins to 1 replica.
 #   #   true | { size: 1Gi, mount: /var/data }  (forbidden: /proc /sys /dev)
 #   disk: true
-#   # ai — AI Gateway via @cloudgrid-io/ai. Injects AI_GATEWAY_URL. true | false.
+#   # ai — AI Gateway via @cloudgrid-io/runtime. Injects RUNTIME_GATEWAY_URL. true | false.
 #   ai: true
 
 
@@ -197,7 +197,7 @@ services:
     #   path: /api/health
     #   expected: "200"
     # Static runtime env vars (strings). Reserved: PORT, APP_NAME, SERVICE_NAME,
-    # NODE_ENV, MONGODB_URL, REDIS_URL, AI_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
+    # NODE_ENV, MONGODB_URL, REDIS_URL, RUNTIME_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
     # env:
     #   LOG_LEVEL: info
     # Sibling services/private resources that must be Ready first (no cron, no cycles).

package/src/corpus/templates/marketplace/AGENTS.md

@@ -92,7 +92,7 @@ injected as env vars at `grid dev` (local) and at runtime (after `grid plug`):
 | Stripe secret key | `vault: { STRIPE_KEY: stripe-live-key }` | `STRIPE_KEY` | `lib/stripe.js` |
 | Stripe webhook secret | `vault: { STRIPE_WEBHOOK_SECRET: stripe-webhook-secret }` | `STRIPE_WEBHOOK_SECRET` | `api/webhooks/stripe/route.js` |
 | Auth provider server key | `vault: { AUTH_PROVIDER_KEY: auth-provider-key }` | `AUTH_PROVIDER_KEY` | `lib/auth.js` |
-| AI (optional) | `needs: { ai: true }` | `AI_GATEWAY_URL` | via `@cloudgrid-io/ai` |
+| AI (optional) | `needs: { ai: true }` | `RUNTIME_GATEWAY_URL` | via `@cloudgrid-io/runtime` |
 
 The `vault:` block only **maps** an org vault item key → an env var name. You must
 store the real value once with `grid secrets set <vault-item-key> <value>` (e.g.

package/src/corpus/templates/marketplace/cloudgrid.yaml

@@ -96,7 +96,7 @@ needs:
 #   # disk — persistent FS mount (PVC). Injects DISK_PATH. Pins to 1 replica.
 #   #   true | { size: 1Gi, mount: /var/data }  (forbidden: /proc /sys /dev)
 #   disk: true
-#   # ai — AI Gateway via @cloudgrid-io/ai. Injects AI_GATEWAY_URL. true | false.
+#   # ai — AI Gateway via @cloudgrid-io/runtime. Injects RUNTIME_GATEWAY_URL. true | false.
 #   ai: true
 
 
@@ -197,7 +197,7 @@ services:
     #   path: /api/health
     #   expected: "200"
     # Static runtime env vars (strings). Reserved: PORT, APP_NAME, SERVICE_NAME,
-    # NODE_ENV, MONGODB_URL, REDIS_URL, AI_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
+    # NODE_ENV, MONGODB_URL, REDIS_URL, RUNTIME_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
     # env:
     #   LOG_LEVEL: info
     # Sibling services/private resources that must be Ready first (no cron, no cycles).

package/src/corpus/templates/marketplace/index.md

@@ -71,7 +71,7 @@ webhook), and the `write files → grid plug --no-deploy → secrets set → gri
 
 - Choose your auth provider SDK (Clerk or Auth0) and set the `role` claim.
 - Set your commission take-rate in `lib/commission.js`.
-- Add `needs: { ai: true }` (injects `AI_GATEWAY_URL`) only if you add AI features
+- Add `needs: { ai: true }` (injects `RUNTIME_GATEWAY_URL`) only if you add AI features
   like listing generation or search.
 - Build under `services/web/`, then `grid dev` (local) / `grid plug` (async — poll
   to a live URL). Point the Stripe webhook at `<live-url>/api/webhooks/stripe`.

package/src/corpus/templates/membership-site/AGENTS.md

@@ -88,7 +88,7 @@ A user is a member when a `memberships` doc for their `authId` has
   non-secret `services.web.env` block (or as a build-time env) rather than the
   vault.
 - **AI (optional)** — if you add AI features, declare `needs: { ai: true }` and
-  call the gateway at `process.env.AI_GATEWAY_URL` via `@cloudgrid-io/ai`. Not
+  call the gateway at `process.env.RUNTIME_GATEWAY_URL` via `@cloudgrid-io/runtime`. Not
   required for this blueprint.
 
 ## 4. Wiring auth + payments

package/src/corpus/templates/membership-site/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: membership-site
 #   # disk — persistent FS mount (PVC). Injects DISK_PATH. Pins to 1 replica.
 #   #   true | { size: 1Gi, mount: /var/data }  (forbidden: /proc /sys /dev)
 #   disk: true
-#   # ai — AI Gateway via @cloudgrid-io/ai. Injects AI_GATEWAY_URL. true | false.
+#   # ai — AI Gateway via @cloudgrid-io/runtime. Injects RUNTIME_GATEWAY_URL. true | false.
 #   ai: true
 
 
@@ -196,7 +196,7 @@ services:
     #   path: /api/health
     #   expected: "200"
     # Static runtime env vars (strings). Reserved: PORT, APP_NAME, SERVICE_NAME,
-    # NODE_ENV, MONGODB_URL, REDIS_URL, AI_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
+    # NODE_ENV, MONGODB_URL, REDIS_URL, RUNTIME_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
     # env:
     #   LOG_LEVEL: info
     # Sibling services/private resources that must be Ready first (no cron, no cycles).

package/src/corpus/templates/monitoring-dashboard/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: monitoring-dashboard
 #   # disk — persistent FS mount (PVC). Injects DISK_PATH. Pins to 1 replica.
 #   #   true | { size: 1Gi, mount: /var/data }  (forbidden: /proc /sys /dev)
 #   disk: true
-#   # ai — AI Gateway via @cloudgrid-io/ai. Injects AI_GATEWAY_URL. true | false.
+#   # ai — AI Gateway via @cloudgrid-io/runtime. Injects RUNTIME_GATEWAY_URL. true | false.
 #   ai: true
 
 
@@ -192,7 +192,7 @@ services:
     #   path: /api/health
     #   expected: "200"
     # Static runtime env vars (strings). Reserved: PORT, APP_NAME, SERVICE_NAME,
-    # NODE_ENV, MONGODB_URL, REDIS_URL, AI_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
+    # NODE_ENV, MONGODB_URL, REDIS_URL, RUNTIME_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
     # env:
     #   LOG_LEVEL: info
     # Sibling services/private resources that must be Ready first (no cron, no cycles).

package/src/corpus/templates/online-store/AGENTS.md

@@ -82,7 +82,7 @@ verified Stripe event.
   Derive them from the incoming request (`new URL(request.url).origin`) rather than
   hardcoding the live host, so it works in `grid dev` and after `grid plug`.
 - **AI (only if you add it):** declare `needs: { ai: true }` and the platform
-  injects `AI_GATEWAY_URL`; call it via `@cloudgrid-io/ai`. Not required for a store.
+  injects `RUNTIME_GATEWAY_URL`; call it via `@cloudgrid-io/runtime`. Not required for a store.
 
 ## 4. Wiring payments (Stripe) — and optional auth
 

package/src/corpus/templates/online-store/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: online-store
 #   # disk — persistent FS mount (PVC). Injects DISK_PATH. Pins to 1 replica.
 #   #   true | { size: 1Gi, mount: /var/data }  (forbidden: /proc /sys /dev)
 #   disk: true
-#   # ai — AI Gateway via @cloudgrid-io/ai. Injects AI_GATEWAY_URL. true | false.
+#   # ai — AI Gateway via @cloudgrid-io/runtime. Injects RUNTIME_GATEWAY_URL. true | false.
 #   ai: true
 
 
@@ -194,7 +194,7 @@ services:
     #   path: /api/health
     #   expected: "200"
     # Static runtime env vars (strings). Reserved: PORT, APP_NAME, SERVICE_NAME,
-    # NODE_ENV, MONGODB_URL, REDIS_URL, AI_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
+    # NODE_ENV, MONGODB_URL, REDIS_URL, RUNTIME_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
     # env:
     #   LOG_LEVEL: info
     # Sibling services/private resources that must be Ready first (no cron, no cycles).

package/src/corpus/templates/portfolio/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: portfolio
 #   # disk — persistent FS mount (PVC). Injects DISK_PATH. Pins to 1 replica.
 #   #   true | { size: 1Gi, mount: /var/data }  (forbidden: /proc /sys /dev)
 #   disk: true
-#   # ai — AI Gateway via @cloudgrid-io/ai. Injects AI_GATEWAY_URL. true | false.
+#   # ai — AI Gateway via @cloudgrid-io/runtime. Injects RUNTIME_GATEWAY_URL. true | false.
 #   ai: true
 
 
@@ -192,7 +192,7 @@ services:
     #   path: /api/health
     #   expected: "200"
     # Static runtime env vars (strings). Reserved: PORT, APP_NAME, SERVICE_NAME,
-    # NODE_ENV, MONGODB_URL, REDIS_URL, AI_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
+    # NODE_ENV, MONGODB_URL, REDIS_URL, RUNTIME_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
     # env:
     #   LOG_LEVEL: info
     # Sibling services/private resources that must be Ready first (no cron, no cycles).

package/src/corpus/templates/product-catalog/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: product-catalog
 #   # disk — persistent FS mount (PVC). Injects DISK_PATH. Pins to 1 replica.
 #   #   true | { size: 1Gi, mount: /var/data }  (forbidden: /proc /sys /dev)
 #   disk: true
-#   # ai — AI Gateway via @cloudgrid-io/ai. Injects AI_GATEWAY_URL. true | false.
+#   # ai — AI Gateway via @cloudgrid-io/runtime. Injects RUNTIME_GATEWAY_URL. true | false.
 #   ai: true
 
 
@@ -192,7 +192,7 @@ services:
     #   path: /api/health
     #   expected: "200"
     # Static runtime env vars (strings). Reserved: PORT, APP_NAME, SERVICE_NAME,
-    # NODE_ENV, MONGODB_URL, REDIS_URL, AI_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
+    # NODE_ENV, MONGODB_URL, REDIS_URL, RUNTIME_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
     # env:
     #   LOG_LEVEL: info
     # Sibling services/private resources that must be Ready first (no cron, no cycles).

package/src/corpus/templates/product-launch/cloudgrid.yaml

@@ -102,7 +102,7 @@ name: product-launch
 #   # disk — persistent FS mount (PVC). Injects DISK_PATH. Pins to 1 replica.
 #   #   true | { size: 1Gi, mount: /var/data }  (forbidden: /proc /sys /dev)
 #   disk: true
-#   # ai — AI Gateway via @cloudgrid-io/ai. Injects AI_GATEWAY_URL. true | false.
+#   # ai — AI Gateway via @cloudgrid-io/runtime. Injects RUNTIME_GATEWAY_URL. true | false.
 #   ai: true
 
 
@@ -198,7 +198,7 @@ services:
     #   path: /api/health
     #   expected: "200"
     # Static runtime env vars (strings). Reserved: PORT, APP_NAME, SERVICE_NAME,
-    # NODE_ENV, MONGODB_URL, REDIS_URL, AI_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
+    # NODE_ENV, MONGODB_URL, REDIS_URL, RUNTIME_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
     # env:
     #   LOG_LEVEL: info
     # Sibling services/private resources that must be Ready first (no cron, no cycles).

package/src/corpus/templates/project-management/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: my-project-board
 #   # disk — persistent FS mount (PVC). Injects DISK_PATH. Pins to 1 replica.
 #   #   true | { size: 1Gi, mount: /var/data }  (forbidden: /proc /sys /dev)
 #   disk: true
-#   # ai — AI Gateway via @cloudgrid-io/ai. Injects AI_GATEWAY_URL. true | false.
+#   # ai — AI Gateway via @cloudgrid-io/runtime. Injects RUNTIME_GATEWAY_URL. true | false.
 #   ai: true
 
 
@@ -192,7 +192,7 @@ services:
     #   path: /api/health
     #   expected: "200"
     # Static runtime env vars (strings). Reserved: PORT, APP_NAME, SERVICE_NAME,
-    # NODE_ENV, MONGODB_URL, REDIS_URL, AI_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
+    # NODE_ENV, MONGODB_URL, REDIS_URL, RUNTIME_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
     # env:
     #   LOG_LEVEL: info
     # Sibling services/private resources that must be Ready first (no cron, no cycles).

package/src/corpus/templates/property-listings/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: property-listings
 #   # disk — persistent FS mount (PVC). Injects DISK_PATH. Pins to 1 replica.
 #   #   true | { size: 1Gi, mount: /var/data }  (forbidden: /proc /sys /dev)
 #   disk: true
-#   # ai — AI Gateway via @cloudgrid-io/ai. Injects AI_GATEWAY_URL. true | false.
+#   # ai — AI Gateway via @cloudgrid-io/runtime. Injects RUNTIME_GATEWAY_URL. true | false.
 #   ai: true
 
 
@@ -192,7 +192,7 @@ services:
     #   path: /api/health
     #   expected: "200"
     # Static runtime env vars (strings). Reserved: PORT, APP_NAME, SERVICE_NAME,
-    # NODE_ENV, MONGODB_URL, REDIS_URL, AI_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
+    # NODE_ENV, MONGODB_URL, REDIS_URL, RUNTIME_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
     # env:
     #   LOG_LEVEL: info
     # Sibling services/private resources that must be Ready first (no cron, no cycles).

package/src/corpus/templates/quiz-platform/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: quiz-platform
 #   # disk — persistent FS mount (PVC). Injects DISK_PATH. Pins to 1 replica.
 #   #   true | { size: 1Gi, mount: /var/data }  (forbidden: /proc /sys /dev)
 #   disk: true
-#   # ai — AI Gateway via @cloudgrid-io/ai. Injects AI_GATEWAY_URL. true | false.
+#   # ai — AI Gateway via @cloudgrid-io/runtime. Injects RUNTIME_GATEWAY_URL. true | false.
 #   ai: true
 
 
@@ -192,7 +192,7 @@ services:
     #   path: /api/health
     #   expected: "200"
     # Static runtime env vars (strings). Reserved: PORT, APP_NAME, SERVICE_NAME,
-    # NODE_ENV, MONGODB_URL, REDIS_URL, AI_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
+    # NODE_ENV, MONGODB_URL, REDIS_URL, RUNTIME_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
     # env:
     #   LOG_LEVEL: info
     # Sibling services/private resources that must be Ready first (no cron, no cycles).

package/src/corpus/templates/report/cloudgrid.yaml

@@ -102,7 +102,7 @@ name: report
 #   # disk — persistent FS mount (PVC). Injects DISK_PATH. Pins to 1 replica.
 #   #   true | { size: 1Gi, mount: /var/data }  (forbidden: /proc /sys /dev)
 #   disk: true
-#   # ai — AI Gateway via @cloudgrid-io/ai. Injects AI_GATEWAY_URL. true | false.
+#   # ai — AI Gateway via @cloudgrid-io/runtime. Injects RUNTIME_GATEWAY_URL. true | false.
 #   ai: true
 
 
@@ -198,7 +198,7 @@ services:
     #   path: /api/health
     #   expected: "200"
     # Static runtime env vars (strings). Reserved: PORT, APP_NAME, SERVICE_NAME,
-    # NODE_ENV, MONGODB_URL, REDIS_URL, AI_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
+    # NODE_ENV, MONGODB_URL, REDIS_URL, RUNTIME_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
     # env:
     #   LOG_LEVEL: info
     # Sibling services/private resources that must be Ready first (no cron, no cycles).

package/src/corpus/templates/restaurant-reservations/AGENTS.md

@@ -122,11 +122,11 @@ You never provision infra or set connection strings by hand. Declare intent in
 
 - **AI (optional).** If you add AI (e.g. menu-copy generation, natural-language
   booking parsing), declare `needs: { ai: true }` → the grid injects
-  **`AI_GATEWAY_URL`**; call it via `@cloudgrid-io/ai`. Not required for the base
+  **`RUNTIME_GATEWAY_URL`**; call it via `@cloudgrid-io/runtime`. Not required for the base
   blueprint.
 
 Reserved env var names you must NOT set: `PORT`, `APP_NAME`, `SERVICE_NAME`,
-`NODE_ENV`, `MONGODB_URL`, `REDIS_URL`, `AI_GATEWAY_URL`, `CLOUDGRID_*`.
+`NODE_ENV`, `MONGODB_URL`, `REDIS_URL`, `RUNTIME_GATEWAY_URL`, `CLOUDGRID_*`.
 
 ---
 

package/src/corpus/templates/restaurant-reservations/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: restaurant-reservations
 #   # disk — persistent FS mount (PVC). Injects DISK_PATH. Pins to 1 replica.
 #   #   true | { size: 1Gi, mount: /var/data }  (forbidden: /proc /sys /dev)
 #   disk: true
-#   # ai — AI Gateway via @cloudgrid-io/ai. Injects AI_GATEWAY_URL. true | false.
+#   # ai — AI Gateway via @cloudgrid-io/runtime. Injects RUNTIME_GATEWAY_URL. true | false.
 #   ai: true
 
 
@@ -204,7 +204,7 @@ services:
     #   path: /api/health
     #   expected: "200"
     # Static runtime env vars (strings). Reserved: PORT, APP_NAME, SERVICE_NAME,
-    # NODE_ENV, MONGODB_URL, REDIS_URL, AI_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
+    # NODE_ENV, MONGODB_URL, REDIS_URL, RUNTIME_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
     # env:
     #   LOG_LEVEL: info
     # Sibling services/private resources that must be Ready first (no cron, no cycles).

package/src/corpus/templates/revenue-dashboard/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: revenue-dashboard
 #   # disk — persistent FS mount (PVC). Injects DISK_PATH. Pins to 1 replica.
 #   #   true | { size: 1Gi, mount: /var/data }  (forbidden: /proc /sys /dev)
 #   disk: true
-#   # ai — AI Gateway via @cloudgrid-io/ai. Injects AI_GATEWAY_URL. true | false.
+#   # ai — AI Gateway via @cloudgrid-io/runtime. Injects RUNTIME_GATEWAY_URL. true | false.
 #   ai: true
 
 
@@ -192,7 +192,7 @@ services:
     #   path: /api/health
     #   expected: "200"
     # Static runtime env vars (strings). Reserved: PORT, APP_NAME, SERVICE_NAME,
-    # NODE_ENV, MONGODB_URL, REDIS_URL, AI_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
+    # NODE_ENV, MONGODB_URL, REDIS_URL, RUNTIME_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
     # env:
     #   LOG_LEVEL: info
     # Sibling services/private resources that must be Ready first (no cron, no cycles).

package/src/corpus/templates/saas-marketing/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: saas-marketing
 #   # disk — persistent FS mount (PVC). Injects DISK_PATH. Pins to 1 replica.
 #   #   true | { size: 1Gi, mount: /var/data }  (forbidden: /proc /sys /dev)
 #   disk: true
-#   # ai — AI Gateway via @cloudgrid-io/ai. Injects AI_GATEWAY_URL. true | false.
+#   # ai — AI Gateway via @cloudgrid-io/runtime. Injects RUNTIME_GATEWAY_URL. true | false.
 #   ai: true
 
 
@@ -192,7 +192,7 @@ services:
     #   path: /api/health
     #   expected: "200"
     # Static runtime env vars (strings). Reserved: PORT, APP_NAME, SERVICE_NAME,
-    # NODE_ENV, MONGODB_URL, REDIS_URL, AI_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
+    # NODE_ENV, MONGODB_URL, REDIS_URL, RUNTIME_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
     # env:
     #   LOG_LEVEL: info
     # Sibling services/private resources that must be Ready first (no cron, no cycles).

package/src/corpus/templates/semantic-search/cloudgrid.yaml

@@ -100,7 +100,7 @@ name: semantic-search
 #   #   true | { size: 1Gi, mount: /var/data }  (forbidden: /proc /sys /dev)
 #   #   Use with SOURCE_TYPE=local to read documents from the mount.
 #   disk: true
-#   # ai — AI Gateway via @cloudgrid-io/ai. Injects AI_GATEWAY_URL. true | false.
+#   # ai — AI Gateway via @cloudgrid-io/runtime. Injects RUNTIME_GATEWAY_URL. true | false.
 #   ai: true
 
 

package/src/corpus/templates/simple-semantic-search/cloudgrid.yaml

@@ -98,7 +98,7 @@ icon: "🔎"
 #   # disk — persistent FS mount (PVC). Injects DISK_PATH. Pins to 1 replica.
 #   #   true | { size: 1Gi, mount: /var/data }  (forbidden: /proc /sys /dev)
 #   disk: true
-#   # ai — AI Gateway via @cloudgrid-io/ai. Injects AI_GATEWAY_URL. true | false.
+#   # ai — AI Gateway via @cloudgrid-io/runtime. Injects RUNTIME_GATEWAY_URL. true | false.
 #   ai: true
 
 
@@ -193,7 +193,7 @@ services:
     # Returns 503 until the startup seed finishes, so traffic waits for a ready index.
     health: /health
     # Static runtime env vars (strings). Reserved: PORT, APP_NAME, SERVICE_NAME,
-    # NODE_ENV, MONGODB_URL, REDIS_URL, AI_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
+    # NODE_ENV, MONGODB_URL, REDIS_URL, RUNTIME_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
     # env:
     #   LOG_LEVEL: info
     # Sibling services/private resources that must be Ready first (no cron, no cycles).
@@ -223,7 +223,7 @@ services:
 
 needs:
   vector: pgvector    # pgvector on Postgres. Injects VECTOR_PGVECTOR_URL (+legacy PGVECTOR_URL).
-  ai: true            # AI Gateway for embeddings via @cloudgrid-io/runtime. Injects AI_GATEWAY_URL.
+  ai: true            # AI Gateway for embeddings via @cloudgrid-io/runtime. Injects RUNTIME_GATEWAY_URL.
 
 
 # ============================================================================

package/src/corpus/templates/status-page/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: status-page
 #   # disk — persistent FS mount (PVC). Injects DISK_PATH. Pins to 1 replica.
 #   #   true | { size: 1Gi, mount: /var/data }  (forbidden: /proc /sys /dev)
 #   disk: true
-#   # ai — AI Gateway via @cloudgrid-io/ai. Injects AI_GATEWAY_URL. true | false.
+#   # ai — AI Gateway via @cloudgrid-io/runtime. Injects RUNTIME_GATEWAY_URL. true | false.
 #   ai: true
 
 
@@ -192,7 +192,7 @@ services:
     #   path: /api/health
     #   expected: "200"
     # Static runtime env vars (strings). Reserved: PORT, APP_NAME, SERVICE_NAME,
-    # NODE_ENV, MONGODB_URL, REDIS_URL, AI_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
+    # NODE_ENV, MONGODB_URL, REDIS_URL, RUNTIME_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
     # env:
     #   LOG_LEVEL: info
     # Sibling services/private resources that must be Ready first (no cron, no cycles).

package/src/corpus/templates/subscription-management/AGENTS.md

@@ -101,7 +101,7 @@ client for plan/status — read this (kept current by the webhook).
   vault. An auth SDK's publishable key goes here too.
 - **AI (optional)** — if you add AI features (e.g. churn-reason summaries),
   declare `needs: { ai: true }` and call the gateway at
-  `process.env.AI_GATEWAY_URL` via `@cloudgrid-io/ai`. Not required for this
+  `process.env.RUNTIME_GATEWAY_URL` via `@cloudgrid-io/runtime`. Not required for this
   blueprint.
 
 ## 4. Wiring auth + payments

package/src/corpus/templates/subscription-management/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: subscription-management
 #   # disk — persistent FS mount (PVC). Injects DISK_PATH. Pins to 1 replica.
 #   #   true | { size: 1Gi, mount: /var/data }  (forbidden: /proc /sys /dev)
 #   disk: true
-#   # ai — AI Gateway via @cloudgrid-io/ai. Injects AI_GATEWAY_URL. true | false.
+#   # ai — AI Gateway via @cloudgrid-io/runtime. Injects RUNTIME_GATEWAY_URL. true | false.
 #   ai: true
 
 
@@ -196,7 +196,7 @@ services:
     #   path: /api/health
     #   expected: "200"
     # Static runtime env vars (strings). Reserved: PORT, APP_NAME, SERVICE_NAME,
-    # NODE_ENV, MONGODB_URL, REDIS_URL, AI_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
+    # NODE_ENV, MONGODB_URL, REDIS_URL, RUNTIME_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
     # env:
     #   LOG_LEVEL: info
     # Sibling services/private resources that must be Ready first (no cron, no cycles).

package/src/corpus/templates/task-manager/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: my-tasks
 #   # disk — persistent FS mount (PVC). Injects DISK_PATH. Pins to 1 replica.
 #   #   true | { size: 1Gi, mount: /var/data }  (forbidden: /proc /sys /dev)
 #   disk: true
-#   # ai — AI Gateway via @cloudgrid-io/ai. Injects AI_GATEWAY_URL. true | false.
+#   # ai — AI Gateway via @cloudgrid-io/runtime. Injects RUNTIME_GATEWAY_URL. true | false.
 #   ai: true
 
 
@@ -192,7 +192,7 @@ services:
     #   path: /api/health
     #   expected: "200"
     # Static runtime env vars (strings). Reserved: PORT, APP_NAME, SERVICE_NAME,
-    # NODE_ENV, MONGODB_URL, REDIS_URL, AI_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
+    # NODE_ENV, MONGODB_URL, REDIS_URL, RUNTIME_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
     # env:
     #   LOG_LEVEL: info
     # Sibling services/private resources that must be Ready first (no cron, no cycles).

package/src/corpus/templates/ticket-system/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: my-tickets
 #   # disk — persistent FS mount (PVC). Injects DISK_PATH. Pins to 1 replica.
 #   #   true | { size: 1Gi, mount: /var/data }  (forbidden: /proc /sys /dev)
 #   disk: true
-#   # ai — AI Gateway via @cloudgrid-io/ai. Injects AI_GATEWAY_URL. true | false.
+#   # ai — AI Gateway via @cloudgrid-io/runtime. Injects RUNTIME_GATEWAY_URL. true | false.
 #   ai: true
 
 
@@ -192,7 +192,7 @@ services:
     #   path: /api/health
     #   expected: "200"
     # Static runtime env vars (strings). Reserved: PORT, APP_NAME, SERVICE_NAME,
-    # NODE_ENV, MONGODB_URL, REDIS_URL, AI_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
+    # NODE_ENV, MONGODB_URL, REDIS_URL, RUNTIME_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
     # env:
     #   LOG_LEVEL: info
     # Sibling services/private resources that must be Ready first (no cron, no cycles).

package/src/corpus/templates/time-tracking/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: time-tracking
 #   # disk — persistent FS mount (PVC). Injects DISK_PATH. Pins to 1 replica.
 #   #   true | { size: 1Gi, mount: /var/data }  (forbidden: /proc /sys /dev)
 #   disk: true
-#   # ai — AI Gateway via @cloudgrid-io/ai. Injects AI_GATEWAY_URL. true | false.
+#   # ai — AI Gateway via @cloudgrid-io/runtime. Injects RUNTIME_GATEWAY_URL. true | false.
 #   ai: true
 
 
@@ -192,7 +192,7 @@ services:
     #   path: /api/health
     #   expected: "200"
     # Static runtime env vars (strings). Reserved: PORT, APP_NAME, SERVICE_NAME,
-    # NODE_ENV, MONGODB_URL, REDIS_URL, AI_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
+    # NODE_ENV, MONGODB_URL, REDIS_URL, RUNTIME_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
     # env:
     #   LOG_LEVEL: info
     # Sibling services/private resources that must be Ready first (no cron, no cycles).

package/src/corpus/templates/travel-booking/AGENTS.md

@@ -115,8 +115,8 @@ You do NOT provision infra or set connection strings/secrets by hand. Declared i
   `STRIPE_KEY`, `STRIPE_WEBHOOK_SECRET`, `AUTH_PROVIDER_KEY`. Add the underlying
   vault items with `grid secrets set <item> <value>` (or the vault UI) BEFORE
   plug, so resolution succeeds. Never hardcode a key; never commit `.env`.
-- **AI (`needs: { ai: true }`, if you add it)** → `AI_GATEWAY_URL`, used via
-  `@cloudgrid-io/ai`. Optional — e.g. a natural-language "plan my trip" search
+- **AI (`needs: { ai: true }`, if you add it)** → `RUNTIME_GATEWAY_URL`, used via
+  `@cloudgrid-io/runtime`. Optional — e.g. a natural-language "plan my trip" search
   assistant. Not required for a basic portal.
 
 Read every injected var lazily (inside getters), same rule as the DB.

package/src/corpus/templates/travel-booking/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: travel-booking
 #   # disk — persistent FS mount (PVC). Injects DISK_PATH. Pins to 1 replica.
 #   #   true | { size: 1Gi, mount: /var/data }  (forbidden: /proc /sys /dev)
 #   disk: true
-#   # ai — AI Gateway via @cloudgrid-io/ai. Injects AI_GATEWAY_URL. true | false.
+#   # ai — AI Gateway via @cloudgrid-io/runtime. Injects RUNTIME_GATEWAY_URL. true | false.
 #   ai: true
 
 
@@ -197,7 +197,7 @@ services:
     #   path: /api/health
     #   expected: "200"
     # Static runtime env vars (strings). Reserved: PORT, APP_NAME, SERVICE_NAME,
-    # NODE_ENV, MONGODB_URL, REDIS_URL, AI_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
+    # NODE_ENV, MONGODB_URL, REDIS_URL, RUNTIME_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
     # env:
     #   LOG_LEVEL: info
     # Sibling services/private resources that must be Ready first (no cron, no cycles).

package/src/corpus/templates/travel-booking/index.md

@@ -66,7 +66,7 @@ The heart of this blueprint. Read it before building. It covers:
 2. **Mongo collections + fields** — `flights`, `hotels`, `bookings`, `trips`,
    plus the guarded-`$inc` overbooking rule that prevents overselling seats/rooms.
 3. **CloudGrid injection** — `DATABASE_MONGODB_URL` for Mongo, `vault:` → env vars
-   for secrets, `AI_GATEWAY_URL` for ai.
+   for secrets, `RUNTIME_GATEWAY_URL` for ai.
 4. **Auth + payments wiring** — provider SDK from `AUTH_PROVIDER_KEY`; Stripe
    checkout + signature-verified webhook from `STRIPE_KEY` /
    `STRIPE_WEBHOOK_SECRET`.

package/src/corpus/templates/waitlist/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: waitlist
 #   # disk — persistent FS mount (PVC). Injects DISK_PATH. Pins to 1 replica.
 #   #   true | { size: 1Gi, mount: /var/data }  (forbidden: /proc /sys /dev)
 #   disk: true
-#   # ai — AI Gateway via @cloudgrid-io/ai. Injects AI_GATEWAY_URL. true | false.
+#   # ai — AI Gateway via @cloudgrid-io/runtime. Injects RUNTIME_GATEWAY_URL. true | false.
 #   ai: true
 
 
@@ -192,7 +192,7 @@ services:
     #   path: /api/health
     #   expected: "200"
     # Static runtime env vars (strings). Reserved: PORT, APP_NAME, SERVICE_NAME,
-    # NODE_ENV, MONGODB_URL, REDIS_URL, AI_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
+    # NODE_ENV, MONGODB_URL, REDIS_URL, RUNTIME_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
     # env:
     #   LOG_LEVEL: info
     # Sibling services/private resources that must be Ready first (no cron, no cycles).