@konstantdotcloud/boombox 0.1.0 → 0.1.2

package/README.md

@@ -57,7 +57,7 @@ For MCP clients, add `boombox serve --mcp` after `boombox login` succeeds.
 [konstant]
 tenant_id = "example"
 api_key = "kn_example_***"
-gateway_url = "https://boombox.konstant.cloud/v2"
+gateway_url = "https://boombox-example.exe.xyz"
 
 [runtime]
 default_kind = "vm"

package/dist/boombox.js

@@ -36148,7 +36148,7 @@ var init_ask_gary = __esm({
       thread_id: external_exports2.string().optional().describe("Concrete thread_id to use instead of resolving a named alias. Useful when continuing an artifact discussion thread."),
       artifact_ref: external_exports2.string().optional().describe("Artifact id to pin as Gary context. Gary loads the artifact body and tags the resulting thread with artifact_ref."),
       fresh: external_exports2.boolean().optional().describe("If true, rotate the thread alias to a brand-new conversation, discarding prior history under that alias."),
-      model_tier: external_exports2.enum(["auto", "fast", "nano", "mini", "reason", "mid", "explore", "premium", "opus"]).optional().describe("Model tier override. Default 'explore' (Sonnet 4.6). Use 'premium' for GPT-5.5, 'opus' for Claude Opus 4.7."),
+      model_tier: external_exports2.enum(["auto", "fast", "nano", "mini", "reason", "mid", "explore", "premium", "opus"]).optional().describe("Model tier override. Default 'explore' (Sonnet 4.6). Use 'premium' for Opus 4.8 at max thinking, 'opus' for Opus 4.8 standard."),
       thinking_level: external_exports2.enum(["off", "minimal", "low", "medium", "high", "xhigh"]).optional().describe("Reasoning effort override. Default 'medium'."),
       intent: external_exports2.enum(["cassette_author"]).optional().describe("Set to cassette_author to load Gary cassette-authoring mode prompt/doctrine.")
     };
@@ -37480,7 +37480,10 @@ function normalizeProfile(value) {
 }
 function guessPathPrefix(baseUrl) {
   if (!baseUrl) return "/api";
-  if (/\.fly\.dev/i.test(baseUrl)) return "";
+  if (/\.exe\.(xyz|dev)/i.test(baseUrl)) {
+    return /\/v2\/?$/.test(baseUrl) ? "/api" : "/v2/api";
+  }
+  if (/\.fly\.dev/i.test(baseUrl)) return "/api";
   if (/\.konstant\.cloud/i.test(baseUrl)) return "/api";
   if (/\.vercel\.app/i.test(baseUrl)) return "/api";
   return "";
@@ -37606,7 +37609,7 @@ var {
 init_esm_shims();
 
 // package.json
-var version = "0.1.0";
+var version = "0.1.2";
 
 // src/lib/version.ts
 var BOOMBOX_VERSION = version;
@@ -42547,6 +42550,12 @@ init_esm_shims();
 
 // src/lib/resolve-gateway.ts
 init_esm_shims();
+var GatewayResolutionError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "GatewayResolutionError";
+  }
+};
 function resolveGateway(config2) {
   return resolveGatewayTarget(config2).url;
 }
@@ -42559,6 +42568,11 @@ function resolveGatewayTarget(config2) {
       label: "Mode 2: per-tenant VM"
     };
   }
+  if (config2.runtime.default_kind === "vm") {
+    throw new GatewayResolutionError(
+      'runtime.default_kind is "vm" but runtime.vm_url is unset \u2014 refusing to fall back to the shared cloud gateway (that would run HomeBase off-VM). Run `boombox login` or `boombox enroll` to repoint at your VM, or set runtime.default_kind = "cloud" to use Mode 1 deliberately.'
+    );
+  }
   return {
     url: normalizeUrl(config2.konstant.gateway_url),
     mode: "mode-1-shared-cloud",
@@ -42568,10 +42582,21 @@ function resolveGatewayTarget(config2) {
 function normalizeUrl(url) {
   return url.replace(/\/+$/, "");
 }
+function gatewayApiPrefix(baseUrl) {
+  if (!baseUrl) return "/api";
+  if (/\.exe\.(xyz|dev)/i.test(baseUrl)) {
+    return /\/v2\/?$/.test(baseUrl) ? "/api" : "/v2/api";
+  }
+  return "/api";
+}
+function resolveGatewayApiBase(config2) {
+  const origin = resolveGatewayTarget(config2).url;
+  return `${origin}${gatewayApiPrefix(origin)}`;
+}
 
 // src/cli/_verify.ts
 async function verifyAuth(config2, fetchImpl = fetch) {
-  const url = `${resolveGateway(config2)}/api/gateway/rack/list`;
+  const url = `${resolveGatewayApiBase(config2)}/gateway/rack/list`;
   let res;
   try {
     res = await fetchImpl(url, {
@@ -42623,7 +42648,7 @@ async function runInit(options = {}) {
   const preset = {
     tenant_id: options.tenantId ?? enrollPayload?.tenant_id ?? existing?.konstant.tenant_id ?? "",
     api_key: options.tenantApiKey ?? options.apiKey ?? enrollPayload?.tenant_api_key ?? enrollPayload?.api_key ?? existing?.konstant.api_key ?? "",
-    gateway_url: options.gatewayUrl ?? enrollPayload?.gateway_url ?? existing?.konstant.gateway_url ?? "https://boombox.konstant.cloud/v2",
+    gateway_url: options.gatewayUrl ?? enrollPayload?.gateway_url ?? existing?.konstant.gateway_url ?? options.vmUrl ?? enrollPayload?.vm_url ?? existing?.runtime.vm_url ?? "",
     vm_url: options.vmUrl ?? enrollPayload?.vm_url ?? existing?.runtime.vm_url ?? ""
   };
   log("Welcome to Konstant Boombox.");
@@ -43288,7 +43313,6 @@ var open_default = open;
 
 // src/cli/enroll.ts
 var DEFAULT_AUTH_BASE = "https://boombox.konstant.cloud";
-var DEFAULT_GATEWAY_BASE = "https://boombox.konstant.cloud/v2";
 var DEFAULT_TIMEOUT_MS = 10 * 60 * 1e3;
 async function runEnroll(options = {}) {
   const log = options.log ?? ((m) => console.log(m));
@@ -43314,8 +43338,13 @@ async function runEnroll(options = {}) {
     log,
     openBrowser: options.openBrowser
   });
-  const gatewayUrl = (options.gatewayUrl ?? payload.gateway_url ?? DEFAULT_GATEWAY_BASE).replace(/\/+$/, "");
   const vmUrl = (options.vmUrl ?? payload.vm_url)?.replace(/\/+$/, "");
+  const gatewayUrl = (options.gatewayUrl ?? payload.gateway_url ?? vmUrl ?? "").replace(/\/+$/, "");
+  if (!gatewayUrl) {
+    throw new Error(
+      "Enrollment returned no gateway: neither gateway_url nor vm_url present. Provision a tenant VM (Mode 2) \u2014 the shared cloud gateway (Mode 1) is retired."
+    );
+  }
   const apiKey = payload.tenant_api_key ?? payload.api_key;
   const httpPort = existing?.boombox.http_port ?? DEFAULT_HTTP_PORT;
   const config2 = BoomboxConfigSchema.parse({
@@ -47064,17 +47093,31 @@ async function runServe(options = {}) {
   const configPath = options.configPath ?? getConfigPath();
   const store = new ConfigStore({ path: configPath, log });
   const config2 = store.getCurrent();
-  store.onChange((next, prev) => {
-    if (next.konstant.api_key !== prev.konstant.api_key) {
-      log("config: api_key rotated; new requests will use the updated key.");
-    }
-    if (resolveGateway(next) !== resolveGateway(prev)) {
-      log(`config: target changed (${resolveGateway(prev)} \u2192 ${resolveGateway(next)}).`);
+  try {
+    resolveGatewayTarget(config2);
+  } catch (err) {
+    if (err instanceof GatewayResolutionError) {
+      log(`error: ${err.message}`);
+      process.exitCode = 1;
+      return;
     }
-    if (next.konstant.tenant_id !== prev.konstant.tenant_id) {
-      log(
-        `config: tenant_id changed (${prev.konstant.tenant_id} \u2192 ${next.konstant.tenant_id}).`
-      );
+    throw err;
+  }
+  store.onChange((next, prev) => {
+    try {
+      if (next.konstant.api_key !== prev.konstant.api_key) {
+        log("config: api_key rotated; new requests will use the updated key.");
+      }
+      if (resolveGateway(next) !== resolveGateway(prev)) {
+        log(`config: target changed (${resolveGateway(prev)} \u2192 ${resolveGateway(next)}).`);
+      }
+      if (next.konstant.tenant_id !== prev.konstant.tenant_id) {
+        log(
+          `config: tenant_id changed (${prev.konstant.tenant_id} \u2192 ${next.konstant.tenant_id}).`
+        );
+      }
+    } catch (err) {
+      log(`config: ${err instanceof Error ? err.message : String(err)}`);
     }
   });
   store.watch();
@@ -47256,17 +47299,25 @@ async function runDoctor(options = {}) {
     }
   }
   if (config2) {
-    const target = resolveGatewayTarget(config2);
-    checks.push({ name: "mode", ok: true, detail: `${target.label}, target=${target.url}` });
-    const reach = await reachable(target.url, options.fetchImpl);
-    checks.push(reach);
-    const auth = await verifyAuth(config2, options.fetchImpl);
-    checks.push({
-      name: "auth",
-      ok: auth.ok,
-      detail: auth.ok ? `whoami ok (status ${auth.status})` : `whoami failed (status ${auth.status}): ${auth.message}`
-    });
-    checks.push(await mcpHandshake(config2));
+    let target = null;
+    try {
+      target = resolveGatewayTarget(config2);
+      checks.push({ name: "mode", ok: true, detail: `${target.label}, target=${target.url}` });
+    } catch (err) {
+      if (!(err instanceof GatewayResolutionError)) throw err;
+      checks.push({ name: "mode", ok: false, detail: err.message });
+    }
+    if (target) {
+      const reach = await reachable(target.url, options.fetchImpl);
+      checks.push(reach);
+      const auth = await verifyAuth(config2, options.fetchImpl);
+      checks.push({
+        name: "auth",
+        ok: auth.ok,
+        detail: auth.ok ? `whoami ok (status ${auth.status})` : `whoami failed (status ${auth.status}): ${auth.message}`
+      });
+      checks.push(await mcpHandshake(config2));
+    }
   }
   const ok = checks.every((c) => c.ok);
   for (const c of checks) {
@@ -48213,6 +48264,7 @@ function createOpsContext(options = {}) {
   return {
     config: config2,
     gateway: resolveGateway(config2),
+    gatewayApi: resolveGatewayApiBase(config2),
     apiKey: config2.konstant.api_key,
     tenant_id: config2.konstant.tenant_id,
     fetchImpl: options.fetchImpl ?? fetch,
@@ -48232,7 +48284,8 @@ function joinUrl(base, path4) {
   return `${cleanBase}${cleanPath}`;
 }
 async function fetchText(ctx, path4, options = {}) {
-  const url = joinUrl(ctx.gateway, path4);
+  const base = path4.startsWith("/gateway") ? ctx.gatewayApi : ctx.gateway;
+  const url = joinUrl(base, path4);
   const headers = {
     ...options.auth === false ? {} : authHeaders(ctx, options.accept ?? "application/json"),
     ...options.headers ?? {}

package/dist/index.js

@@ -28219,7 +28219,7 @@ var init_ask_gary = __esm({
       thread_id: external_exports2.string().optional().describe("Concrete thread_id to use instead of resolving a named alias. Useful when continuing an artifact discussion thread."),
       artifact_ref: external_exports2.string().optional().describe("Artifact id to pin as Gary context. Gary loads the artifact body and tags the resulting thread with artifact_ref."),
       fresh: external_exports2.boolean().optional().describe("If true, rotate the thread alias to a brand-new conversation, discarding prior history under that alias."),
-      model_tier: external_exports2.enum(["auto", "fast", "nano", "mini", "reason", "mid", "explore", "premium", "opus"]).optional().describe("Model tier override. Default 'explore' (Sonnet 4.6). Use 'premium' for GPT-5.5, 'opus' for Claude Opus 4.7."),
+      model_tier: external_exports2.enum(["auto", "fast", "nano", "mini", "reason", "mid", "explore", "premium", "opus"]).optional().describe("Model tier override. Default 'explore' (Sonnet 4.6). Use 'premium' for Opus 4.8 at max thinking, 'opus' for Opus 4.8 standard."),
       thinking_level: external_exports2.enum(["off", "minimal", "low", "medium", "high", "xhigh"]).optional().describe("Reasoning effort override. Default 'medium'."),
       intent: external_exports2.enum(["cassette_author"]).optional().describe("Set to cassette_author to load Gary cassette-authoring mode prompt/doctrine.")
     };
@@ -29551,7 +29551,10 @@ function normalizeProfile(value) {
 }
 function guessPathPrefix(baseUrl) {
   if (!baseUrl) return "/api";
-  if (/\.fly\.dev/i.test(baseUrl)) return "";
+  if (/\.exe\.(xyz|dev)/i.test(baseUrl)) {
+    return /\/v2\/?$/.test(baseUrl) ? "/api" : "/v2/api";
+  }
+  if (/\.fly\.dev/i.test(baseUrl)) return "/api";
   if (/\.konstant\.cloud/i.test(baseUrl)) return "/api";
   if (/\.vercel\.app/i.test(baseUrl)) return "/api";
   return "";
@@ -34581,7 +34584,7 @@ init_esm_shims();
 init_esm_shims();
 
 // package.json
-var version = "0.1.0";
+var version = "0.1.2";
 
 // src/lib/version.ts
 var BOOMBOX_VERSION = version;
@@ -42576,6 +42579,12 @@ var serveStatic = (options = { root: "" }) => {
 
 // src/lib/resolve-gateway.ts
 init_esm_shims();
+var GatewayResolutionError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "GatewayResolutionError";
+  }
+};
 function resolveGateway(config2) {
   return resolveGatewayTarget(config2).url;
 }
@@ -42588,6 +42597,11 @@ function resolveGatewayTarget(config2) {
       label: "Mode 2: per-tenant VM"
     };
   }
+  if (config2.runtime.default_kind === "vm") {
+    throw new GatewayResolutionError(
+      'runtime.default_kind is "vm" but runtime.vm_url is unset \u2014 refusing to fall back to the shared cloud gateway (that would run HomeBase off-VM). Run `boombox login` or `boombox enroll` to repoint at your VM, or set runtime.default_kind = "cloud" to use Mode 1 deliberately.'
+    );
+  }
   return {
     url: normalizeUrl(config2.konstant.gateway_url),
     mode: "mode-1-shared-cloud",
@@ -42597,6 +42611,17 @@ function resolveGatewayTarget(config2) {
 function normalizeUrl(url) {
   return url.replace(/\/+$/, "");
 }
+function gatewayApiPrefix(baseUrl) {
+  if (!baseUrl) return "/api";
+  if (/\.exe\.(xyz|dev)/i.test(baseUrl)) {
+    return /\/v2\/?$/.test(baseUrl) ? "/api" : "/v2/api";
+  }
+  return "/api";
+}
+function resolveGatewayApiBase(config2) {
+  const origin = resolveGatewayTarget(config2).url;
+  return `${origin}${gatewayApiPrefix(origin)}`;
+}
 
 // src/server/proxy.ts
 init_esm_shims();
@@ -42914,7 +42939,7 @@ import { readFileSync as readFileSync3 } from "fs";
 // src/cli/_verify.ts
 init_esm_shims();
 async function verifyAuth(config2, fetchImpl = fetch) {
-  const url = `${resolveGateway(config2)}/api/gateway/rack/list`;
+  const url = `${resolveGatewayApiBase(config2)}/gateway/rack/list`;
   let res;
   try {
     res = await fetchImpl(url, {
@@ -42966,7 +42991,7 @@ async function runInit(options = {}) {
   const preset = {
     tenant_id: options.tenantId ?? enrollPayload?.tenant_id ?? existing?.konstant.tenant_id ?? "",
     api_key: options.tenantApiKey ?? options.apiKey ?? enrollPayload?.tenant_api_key ?? enrollPayload?.api_key ?? existing?.konstant.api_key ?? "",
-    gateway_url: options.gatewayUrl ?? enrollPayload?.gateway_url ?? existing?.konstant.gateway_url ?? "https://boombox.konstant.cloud/v2",
+    gateway_url: options.gatewayUrl ?? enrollPayload?.gateway_url ?? existing?.konstant.gateway_url ?? options.vmUrl ?? enrollPayload?.vm_url ?? existing?.runtime.vm_url ?? "",
     vm_url: options.vmUrl ?? enrollPayload?.vm_url ?? existing?.runtime.vm_url ?? ""
   };
   log("Welcome to Konstant Boombox.");
@@ -43291,17 +43316,31 @@ async function runServe(options = {}) {
   const configPath = options.configPath ?? getConfigPath();
   const store = new ConfigStore({ path: configPath, log });
   const config2 = store.getCurrent();
-  store.onChange((next, prev) => {
-    if (next.konstant.api_key !== prev.konstant.api_key) {
-      log("config: api_key rotated; new requests will use the updated key.");
-    }
-    if (resolveGateway(next) !== resolveGateway(prev)) {
-      log(`config: target changed (${resolveGateway(prev)} \u2192 ${resolveGateway(next)}).`);
+  try {
+    resolveGatewayTarget(config2);
+  } catch (err) {
+    if (err instanceof GatewayResolutionError) {
+      log(`error: ${err.message}`);
+      process.exitCode = 1;
+      return;
     }
-    if (next.konstant.tenant_id !== prev.konstant.tenant_id) {
-      log(
-        `config: tenant_id changed (${prev.konstant.tenant_id} \u2192 ${next.konstant.tenant_id}).`
-      );
+    throw err;
+  }
+  store.onChange((next, prev) => {
+    try {
+      if (next.konstant.api_key !== prev.konstant.api_key) {
+        log("config: api_key rotated; new requests will use the updated key.");
+      }
+      if (resolveGateway(next) !== resolveGateway(prev)) {
+        log(`config: target changed (${resolveGateway(prev)} \u2192 ${resolveGateway(next)}).`);
+      }
+      if (next.konstant.tenant_id !== prev.konstant.tenant_id) {
+        log(
+          `config: tenant_id changed (${prev.konstant.tenant_id} \u2192 ${next.konstant.tenant_id}).`
+        );
+      }
+    } catch (err) {
+      log(`config: ${err instanceof Error ? err.message : String(err)}`);
     }
   });
   store.watch();
@@ -43419,17 +43458,25 @@ async function runDoctor(options = {}) {
     }
   }
   if (config2) {
-    const target = resolveGatewayTarget(config2);
-    checks.push({ name: "mode", ok: true, detail: `${target.label}, target=${target.url}` });
-    const reach = await reachable(target.url, options.fetchImpl);
-    checks.push(reach);
-    const auth = await verifyAuth(config2, options.fetchImpl);
-    checks.push({
-      name: "auth",
-      ok: auth.ok,
-      detail: auth.ok ? `whoami ok (status ${auth.status})` : `whoami failed (status ${auth.status}): ${auth.message}`
-    });
-    checks.push(await mcpHandshake(config2));
+    let target = null;
+    try {
+      target = resolveGatewayTarget(config2);
+      checks.push({ name: "mode", ok: true, detail: `${target.label}, target=${target.url}` });
+    } catch (err) {
+      if (!(err instanceof GatewayResolutionError)) throw err;
+      checks.push({ name: "mode", ok: false, detail: err.message });
+    }
+    if (target) {
+      const reach = await reachable(target.url, options.fetchImpl);
+      checks.push(reach);
+      const auth = await verifyAuth(config2, options.fetchImpl);
+      checks.push({
+        name: "auth",
+        ok: auth.ok,
+        detail: auth.ok ? `whoami ok (status ${auth.status})` : `whoami failed (status ${auth.status}): ${auth.message}`
+      });
+      checks.push(await mcpHandshake(config2));
+    }
   }
   const ok = checks.every((c) => c.ok);
   for (const c of checks) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@konstantdotcloud/boombox",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Local Boombox runtime for Konstant cassettes — CLI, stdio MCP server, and local Hono proxy.",
   "license": "UNLICENSED",
   "type": "module",