@moda-ai/cli 1.13.8 → 1.13.9

package/dist/init/tenant.d.ts

@@ -4,6 +4,13 @@ interface BootstrapResult {
     tenantName: string;
     tenantSlug: string;
 }
+/**
+ * Classify a failed /api/cli/context (or bootstrap) response so moda init
+ * distinguishes retryable infra outages (Postgres pool exhaustion → 503
+ * `database_unavailable`) from auth failures. Auth itself can succeed from
+ * a cached moda_ct_ token even when this hydrate call 500s (MODA-742).
+ */
+export declare function formatControlPlaneFetchError(action: string, status: number, body: string): string;
 export interface TenantKeyResult extends BootstrapResult {
     /**
      * True when a previously stored key for the selected tenant passed the

package/dist/init/tenant.js

@@ -8,6 +8,37 @@ import { authFetch, getCachedLoginContext } from '../auth.js';
 import { loadCliConfig, resolveIngestUrl, resolveModaBaseUrl, saveCliConfig, } from '../config.js';
 import { getModaDir, resolveApiKeyFromActiveProfile, resolveTenantIdFromActiveProfile, writeSecretJsonFile, } from '../profiles.js';
 import { CliAccessError, CliInputError, CliInputRequiredError } from '../errors.js';
+/**
+ * Classify a failed /api/cli/context (or bootstrap) response so moda init
+ * distinguishes retryable infra outages (Postgres pool exhaustion → 503
+ * `database_unavailable`) from auth failures. Auth itself can succeed from
+ * a cached moda_ct_ token even when this hydrate call 500s (MODA-742).
+ */
+export function formatControlPlaneFetchError(action, status, body) {
+    let parsed;
+    try {
+        parsed = JSON.parse(body);
+    }
+    catch {
+        // Non-JSON body — fall through to generic formatting.
+    }
+    const isDbUnavailable = status === 503 &&
+        (parsed?.error === 'database_unavailable' ||
+            parsed?.retryable === true ||
+            /database_unavailable|too many database connections|rds_reserved|connection pool/i.test(body));
+    if (isDbUnavailable) {
+        return (`Failed to ${action} (${status}): Moda control-plane database is temporarily unavailable ` +
+            `(connection pool exhausted). This is not an authentication failure — your session token ` +
+            `is fine. Retry in a few seconds.` +
+            (parsed?.message ? ` (${parsed.message})` : ''));
+    }
+    if (status >= 500 &&
+        /too many database connections|rds_reserved|remaining connection slots/i.test(body)) {
+        return (`Failed to ${action} (${status}): Moda control-plane database ran out of connections. ` +
+            `This is a retryable infra outage, not an auth failure. Retry in a few seconds. Body: ${body}`);
+    }
+    return `Failed to ${action} (${status}): ${body}`;
+}
 // Mirrors the backend's checkAdminAccess: only the viewer role is denied.
 const ADMIN_ACCESS_MESSAGE = 'You need admin or owner access to create API keys.';
 const ADMIN_ACCESS_GUIDANCE = 'Ask your organization owner to upgrade your role.';
@@ -250,7 +281,7 @@ export async function selectTenantAndCreateKey(options = {}) {
         const contextRes = await authFetch('/api/cli/context', {}, authOptions);
         if (!contextRes.ok) {
             const body = await contextRes.text();
-            throw new Error(`Failed to fetch context (${contextRes.status}): ${body}`);
+            throw new Error(formatControlPlaneFetchError('fetch context', contextRes.status, body));
         }
         ctx = (await contextRes.json());
     }
@@ -368,7 +399,7 @@ export async function selectTenantAndCreateKey(options = {}) {
         }
         if (!bootstrapRes.ok) {
             const body = await bootstrapRes.text();
-            throw new Error(`Failed to create API key (${bootstrapRes.status}): ${body}`);
+            throw new Error(formatControlPlaneFetchError('create API key', bootstrapRes.status, body));
         }
         result = (await bootstrapRes.json());
         clearBootstrapIdempotencyKey(selected.id, authOptions);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moda-ai/cli",
-  "version": "1.13.8",
+  "version": "1.13.9",
   "description": "CLI for Moda - AI agent analytics and observability",
   "type": "module",
   "bin": {

package/skills/integration/index.json

@@ -1,7 +1,7 @@
 {
   "schema_version": "moda.skill_index.v1",
-  "bundled_at": "2026-07-08T03:25:26.235Z",
-  "cli_version": "1.13.8",
+  "bundled_at": "2026-07-08T05:27:07.614Z",
+  "cli_version": "1.13.9",
   "skills": [
     {
       "id": "integration-node-anthropic",