@cloudgrid-io/mcp 0.20.20 → 0.20.22

package/src/corpus/templates/app-with-data/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: my-app
 #   # 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/appointment-booking/AGENTS.md

@@ -113,7 +113,7 @@ clients racing for the same slot cannot both win.
   non-secret `services.web.env` block (or as a build-time env), NOT the vault.
 - **AI (optional)** — if you add AI features (e.g. natural-language "book me next
   Tuesday afternoon"), 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/appointment-booking/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: appointment-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/approval-workflow/AGENTS.md

@@ -116,8 +116,8 @@ routes and the UI agree on what is legal.
   Do NOT hardcode keys and do NOT set `DATABASE_MONGODB_URL`/`MONGODB_URL`
   yourself — the grid injects the DB vars.
 - **AI (optional):** if you add AI (e.g. auto-summarize a request), declare
-  `needs: { ai: true }`; the grid injects **`AI_GATEWAY_URL`** and you call it
-  through `@cloudgrid-io/ai`.
+  `needs: { ai: true }`; the grid injects **`RUNTIME_GATEWAY_URL`** and you call it
+  through `@cloudgrid-io/runtime`.
 - **Non-secret config** → `grid env`. **Secrets** → `grid secrets set` (mapped by
   `vault:`).
 

package/src/corpus/templates/approval-workflow/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: approval-workflow
 #   # 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/billing-dashboard/AGENTS.md

@@ -114,8 +114,8 @@ total from the verified Stripe event.
   `vault:`; non-secret flags (log level, default currency) can be plain
   `services.web.env` entries or `grid env`.
 - **AI (only if you add it, e.g. an AI usage-forecast):** declare
-  `needs: { ai: true }` and the platform injects **`AI_GATEWAY_URL`**; call it via
-  `@cloudgrid-io/ai`. Not required for a billing dashboard.
+  `needs: { ai: true }` and the platform injects **`RUNTIME_GATEWAY_URL`**; call it via
+  `@cloudgrid-io/runtime`. Not required for a billing dashboard.
 
 ## 4. Wiring payments (Stripe) — and optional auth
 

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

@@ -96,7 +96,7 @@ name: billing-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
 
 
@@ -195,7 +195,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/blog-cms/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: blog-cms
 #   # 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/booking-system/AGENTS.md

@@ -100,8 +100,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`. Not required for a basic booking system.
+- **AI (`needs: { ai: true }`, if you add it)** → `RUNTIME_GATEWAY_URL`, used via
+  `@cloudgrid-io/runtime`. Not required for a basic booking system.
 
 Read every injected var lazily (inside getters), same rule as the DB.
 

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

@@ -96,7 +96,7 @@ name: booking-system
 #   # 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/booking-system/index.md

@@ -64,7 +64,7 @@ The heart of this blueprint. Read it before building. It covers:
 2. **Mongo collections + fields** — `services`, `availabilityRules`, `bookings`,
    plus the overlap-check + unique-index rule that prevents double-booking.
 3. **CloudGrid injection** — `DATABASE_MONGODB_URL` for Mongo, `vault:` → env
-   vars for secrets, `AI_GATEWAY_URL` for ai.
+   vars 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/calendar-scheduler/AGENTS.md

@@ -99,7 +99,7 @@ injected as env vars at `grid dev` (local) and at runtime (after `grid plug`):
 | Stripe secret (optional, paid booking) | `vault: { STRIPE_KEY: stripe-live-key }` | `STRIPE_KEY` | `lib/stripe.js` |
 | Stripe webhook secret (optional) | `vault: { STRIPE_WEBHOOK_SECRET: stripe-webhook-secret }` | `STRIPE_WEBHOOK_SECRET` | `api/webhooks/stripe/route.js` |
 | Email/SMS key (optional, reminders) | `vault: { SENDGRID_API_KEY: sendgrid-key }` | `SENDGRID_API_KEY` | reminder job / `lib/notify.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/calendar-scheduler/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
 
 
@@ -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/calendar-scheduler/index.md

@@ -77,7 +77,7 @@ on #1543), and the `write files → grid plug --no-deploy → secrets set → gr
   `STRIPE_WEBHOOK_SECRET`) and a signed webhook.
 - Pick a date library (luxon / date-fns-tz) for timezone + recurrence math; keep
   it in `lib/time.js`.
-- Add `needs: { ai: true }` (injects `AI_GATEWAY_URL`) only for AI features like
+- Add `needs: { ai: true }` (injects `RUNTIME_GATEWAY_URL`) only for AI features like
   natural-language event entry.
 - Reminders: leave the cron `reminders` service commented until #1543 ships; use
   the interim external-scheduler-hits-an-HTTP-route workaround (AGENTS.md §5) if

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

@@ -96,7 +96,7 @@ name: changelog
 #   # 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/company-website/cloudgrid.yaml

@@ -101,7 +101,7 @@ name: company-website
 #   # 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/course-platform/AGENTS.md

@@ -86,11 +86,11 @@ runtime (after `grid plug`).
   injects them as the named env vars. Read them lazily too (inside the Stripe/auth
   client getters), not at module top level.
 - **AI (only if you add tutoring/quiz-gen)** — `needs: { ai: true }` → injects
-  **`AI_GATEWAY_URL`**; call it via `@cloudgrid-io/ai`. Not enabled in this
+  **`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/course-platform/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: course-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
 
 
@@ -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/crm/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: my-crm
 #   # 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/dashboard/cloudgrid.yaml

@@ -102,7 +102,7 @@ name: 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
 
 
@@ -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/deck/cloudgrid.yaml

@@ -102,7 +102,7 @@ name: deck
 #   # 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/directory/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: my-directory
 #   # 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/docs-site/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: docs-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
 
 
@@ -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/erp/AGENTS.md

@@ -67,8 +67,8 @@ Add indexes as the data grows (e.g. `items.sku` unique, `orders.status`).
   yaml only names the mapping. (One-off non-vault secrets can also go via
   `grid secrets set`; non-secret config via `grid env`.) Never commit a key.
 - **AI (optional):** if a module uses AI (e.g. demand forecasting), add
-  `ai: true` under `needs:` — the grid injects `AI_GATEWAY_URL`, called via
-  `@cloudgrid-io/ai`. Not enabled by default in this blueprint.
+  `ai: true` under `needs:` — the grid injects `RUNTIME_GATEWAY_URL`, called via
+  `@cloudgrid-io/runtime`. Not enabled by default in this blueprint.
 
 ## 4. Wiring auth + RBAC and payments
 

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

@@ -96,7 +96,7 @@ name: my-erp
 #   # 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
 
 
@@ -195,7 +195,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/erp/index.md

@@ -62,7 +62,7 @@ needs:
 
 > **Capability:** this template needs `database: true` (Mongo → `DATABASE_MONGODB_URL`
 > + legacy `MONGODB_URL`) and a `vault:` block for auth + Stripe secrets. Optional
-> `ai: true` adds `AI_GATEWAY_URL` for forecasting. `requires:` is the deprecated v1
+> `ai: true` adds `RUNTIME_GATEWAY_URL` for forecasting. `requires:` is the deprecated v1
 > alias — don't mix it with `needs:`. See the capability-map for the full injection
 > table.
 

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

@@ -96,7 +96,7 @@ name: event-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/expense-tracker/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: expense-tracker
 #   # 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/feature-request-board/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: feature-request-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/financial-dashboard/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: financial-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/forum/AGENTS.md

@@ -106,10 +106,10 @@ dev` and runtime.
   keys to whatever the provider SDK expects (see §4) and set the vault items with
   `grid_set_secret` / the org vault — do not commit keys.
 - **AI (optional)** — if you add `needs: { ai: true }` (e.g. auto-moderation or
-  summarize-thread), the grid injects **`AI_GATEWAY_URL`**; call it via
-  `@cloudgrid-io/ai`. Not required for the base forum.
+  summarize-thread), the grid injects **`RUNTIME_GATEWAY_URL`**; call it via
+  `@cloudgrid-io/runtime`. Not required for the base forum.
 - **Reserved vars** you must NOT set yourself: `PORT`, `NODE_ENV`,
-  `DATABASE_MONGODB_URL`, `MONGODB_URL`, `REDIS_URL`, `AI_GATEWAY_URL`,
+  `DATABASE_MONGODB_URL`, `MONGODB_URL`, `REDIS_URL`, `RUNTIME_GATEWAY_URL`,
   `CLOUDGRID_*`.
 
 `lib/db.js` — copy the lazy-getter pattern from `app-with-data`:

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

@@ -96,7 +96,7 @@ name: forum
 #   # 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/hr-portal/AGENTS.md

@@ -106,7 +106,7 @@ dev-time (`grid dev`) and runtime (after `grid plug`).
   `NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY`, or `AUTH0_SECRET` / `AUTH0_CLIENT_ID` /
   `AUTH0_CLIENT_SECRET`) — just keep the `vault:` map keys and the code in sync.
 - **AI (optional):** if you later add `needs: { ai: true }`, the grid injects
-  **`AI_GATEWAY_URL`** for use with `@cloudgrid-io/ai` (e.g. drafting policy text
+  **`RUNTIME_GATEWAY_URL`** for use with `@cloudgrid-io/runtime` (e.g. drafting policy text
   or summarizing requests). Not required for the core portal.
 
 Non-secret config (log level, default PTO allotment) → `services.web.env` in the

package/src/corpus/templates/hr-portal/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: hr-portal
 #   # 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/internal-tools-portal/AGENTS.md

@@ -128,8 +128,8 @@ dev-time (`grid dev`) and runtime (after `grid plug`).
   A tool that talks to a third-party API (Stripe, SendGrid, an internal service
   token) adds one more `vault:` line per secret, e.g. `STRIPE_KEY: stripe-live-key`.
 - **AI (optional):** if a tool needs an LLM (draft copy, summarize a record), add
-  `needs: { ai: true }` and the grid injects **`AI_GATEWAY_URL`** for use with
-  `@cloudgrid-io/ai`. Not required for the core portal.
+  `needs: { ai: true }` and the grid injects **`RUNTIME_GATEWAY_URL`** for use with
+  `@cloudgrid-io/runtime`. Not required for the core portal.
 
 Non-secret config (log level, feature toggles) → `services.web.env` in the yaml,
 or `grid env`. Actual secrets → the vault (never `env:`, never committed).

package/src/corpus/templates/internal-tools-portal/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: internal-tools-portal
 #   # 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/inventory/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: my-inventory
 #   # 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/invoice/cloudgrid.yaml

@@ -96,7 +96,7 @@ name: my-invoices
 #   # 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).