deepline 0.1.200 → 0.1.202

package/dist/cli/index.js

@@ -623,10 +623,10 @@ var SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: "0.1.200",
+  version: "0.1.202",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.200",
+    latest: "0.1.202",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -1907,10 +1907,10 @@ var OBSERVER_LOG_PAGE_QUERY = "runObservers:getRunLogPageForObserver";
 function errorText(error) {
   return error instanceof Error ? error.message : String(error);
 }
-async function mintRunObserveGrant(http, runId) {
+async function mintRunObserveGrant(http2, runId) {
   let response;
   try {
-    response = await http.post(
+    response = await http2.post(
       `/api/v2/runs/${encodeURIComponent(runId)}/observe-grant`,
       {}
     );
@@ -1974,8 +1974,8 @@ async function backfillLogGap(input2) {
   return lines;
 }
 async function* observeRunEvents(options) {
-  const { http, runId } = options;
-  let grant = await mintRunObserveGrant(http, runId);
+  const { http: http2, runId } = options;
+  let grant = await mintRunObserveGrant(http2, runId);
   let convexBrowser;
   let convexServer;
   try {
@@ -2038,7 +2038,7 @@ async function* observeRunEvents(options) {
       lastForcedRefreshAt = now;
     }
     try {
-      grant = await mintRunObserveGrant(http, runId);
+      grant = await mintRunObserveGrant(http2, runId);
       return grant.token;
     } catch (error) {
       push({ kind: "error", error });
@@ -4457,11 +4457,6 @@ function enforceSdkCompatibilityResponse(response) {
   }
 }
 
-// src/cli/commands/auth.ts
-var import_node_fs5 = require("fs");
-var import_node_os6 = require("os");
-var import_node_path5 = require("path");
-
 // src/cli/utils.ts
 var import_node_crypto = require("crypto");
 var import_node_fs4 = require("fs");
@@ -5137,7 +5132,133 @@ function printCommandEnvelope(envelope, options = {}) {
   process.stdout.write(options.text ?? renderCommandEnvelopeText(envelope));
 }
 
+// src/cli/commands/admin.ts
+function normalizeEnvironment(value) {
+  const trimmed = value?.trim().toLowerCase();
+  if (!trimmed || trimmed === "production" || trimmed === "prod") {
+    return "production";
+  }
+  if (trimmed === "preview") return "preview";
+  throw new Error(
+    `Invalid --environment "${value}". Expected production or preview.`
+  );
+}
+function http() {
+  return new HttpClient(resolveConfig());
+}
+function laneLine(lane) {
+  const flag = lane.active ? "* " : "  ";
+  const depth = lane.queueDepth.empty ? "empty" : `${lane.queueDepth.queuedTasks} tasks / ${lane.queueDepth.nonTerminalRuns} runs`;
+  return `${flag}${lane.releaseId} [${lane.status}] queue=${lane.queue} depth=${depth}`;
+}
+async function handleLanesList(options) {
+  const environment = normalizeEnvironment(options.environment);
+  const payload = await http().get(
+    `/api/v2/admin/runtime/lanes?environment=${environment}`
+  );
+  printCommandEnvelope(
+    {
+      ...payload,
+      render: {
+        sections: [
+          {
+            title: `Absurd lanes (${environment}):`,
+            lines: payload.lanes.length > 0 ? payload.lanes.map(laneLine) : ["(no registered lanes)"]
+          }
+        ]
+      }
+    },
+    { json: options.json }
+  );
+}
+async function handleLanesShow(releaseId, options) {
+  const environment = normalizeEnvironment(options.environment);
+  const payload = await http().get(
+    `/api/v2/admin/runtime/lanes?environment=${environment}&release=${encodeURIComponent(releaseId)}`
+  );
+  printCommandEnvelope(
+    {
+      ...payload,
+      render: {
+        sections: [
+          {
+            title: `Lane ${releaseId} (${environment}):`,
+            lines: [
+              `registered: ${payload.registered}`,
+              payload.lane ? `status: ${payload.lane.status}${payload.lane.active ? " (active)" : ""}` : "status: (not in registry)",
+              `queue: ${payload.retireCheck.queue}`,
+              `queued tasks: ${payload.retireCheck.queuedTasks}`,
+              `non-terminal runs: ${payload.retireCheck.nonTerminalRuns}`,
+              `retirable: ${payload.retireCheck.retirable}`
+            ]
+          }
+        ]
+      }
+    },
+    { json: options.json }
+  );
+}
+async function handleLanesRetireCheck(releaseId, options) {
+  const environment = normalizeEnvironment(options.environment);
+  const payload = await http().get(
+    `/api/v2/admin/runtime/lanes?environment=${environment}&release=${encodeURIComponent(releaseId)}`
+  );
+  printCommandEnvelope(
+    {
+      ...payload,
+      render: {
+        sections: [
+          {
+            title: `Retire check ${releaseId} (${environment}):`,
+            lines: [
+              payload.retireCheck.retirable ? "retirable: yes (lane queue empty)" : `retirable: no (${payload.retireCheck.queuedTasks} tasks, ${payload.retireCheck.nonTerminalRuns} runs pending)`
+            ]
+          }
+        ]
+      }
+    },
+    { json: options.json }
+  );
+}
+async function handleReleasesActivate(releaseId, options) {
+  const environment = normalizeEnvironment(options.environment);
+  const payload = await http().post(
+    "/api/v2/admin/runtime/releases",
+    {
+      releaseId,
+      environment,
+      ...options.schedulerBackend ? { schedulerBackend: options.schedulerBackend } : {}
+    }
+  );
+  printCommandEnvelope(
+    {
+      ...payload,
+      render: {
+        sections: [
+          {
+            title: `Activated release ${releaseId} (${environment}).`,
+            lines: ["Runtime release pointer flipped to this lane."]
+          }
+        ]
+      }
+    },
+    { json: options.json }
+  );
+}
+function registerAdminCommands(program) {
+  const admin = program.command("admin").description("Platform-admin operations (runtime lanes, releases).");
+  const lanes = admin.command("lanes").description("Inspect Absurd runtime release lanes.");
+  lanes.command("list").description("List all registered Absurd lanes with queue depth.").option("--environment <env>", "production (default) or preview").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleLanesList);
+  lanes.command("show <releaseId>").description("Show one lane and its retire-gate depth.").option("--environment <env>", "production (default) or preview").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleLanesShow);
+  lanes.command("retire-check <releaseId>").description("Check whether a lane is safe to retire (queue empty).").option("--environment <env>", "production (default) or preview").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleLanesRetireCheck);
+  const releases = admin.command("releases").description("Manage the active runtime release pointer.");
+  releases.command("activate <releaseId>").description("Flip the active runtime release to a prior registered lane.").option("--environment <env>", "production (default) or preview").option("--scheduler-backend <backend>", "absurd or workers_edge").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleReleasesActivate);
+}
+
 // src/cli/commands/auth.ts
+var import_node_fs5 = require("fs");
+var import_node_os6 = require("os");
+var import_node_path5 = require("path");
 var EXIT_OK = 0;
 var EXIT_AUTH = 3;
 var EXIT_SERVER = 5;
@@ -6000,8 +6121,8 @@ function defaultLedgerExportPath() {
   );
 }
 async function handleBalance(options) {
-  const { http } = getAuthedHttpClient();
-  const payload = await http.get(
+  const { http: http2 } = getAuthedHttpClient();
+  const payload = await http2.get(
     "/api/v2/billing/balance"
   );
   const status = String(payload.balance_status || "");
@@ -6035,13 +6156,13 @@ async function handleBalance(options) {
   return;
 }
 async function handleUsage(options) {
-  const { http } = getAuthedHttpClient();
+  const { http: http2 } = getAuthedHttpClient();
   const params = new URLSearchParams();
   if (options.limit) params.set("recent_limit", options.limit);
   if (options.offset) params.set("recent_offset", options.offset);
   if (options.runId) params.set("run_id", options.runId);
   const suffix = Array.from(params).length > 0 ? `?${params.toString()}` : "";
-  const payload = await http.get(
+  const payload = await http2.get(
     `/api/v2/billing/usage${suffix}`
   );
   const usage = payload.usage ?? {};
@@ -6067,8 +6188,8 @@ async function handleUsage(options) {
   );
 }
 async function handleLimit(options) {
-  const { http } = getAuthedHttpClient();
-  const payload = await http.get(
+  const { http: http2 } = getAuthedHttpClient();
+  const payload = await http2.get(
     "/api/v2/billing/limit"
   );
   const lines = payload.enabled ? [
@@ -6084,8 +6205,8 @@ async function handleLimit(options) {
   );
 }
 async function handleSetLimit(credits, options) {
-  const { http } = getAuthedHttpClient();
-  const payload = await http.request("/api/v2/billing/limit", {
+  const { http: http2 } = getAuthedHttpClient();
+  const payload = await http2.request("/api/v2/billing/limit", {
     method: "PUT",
     body: { monthly_credits_limit: Number.parseInt(credits, 10) }
   });
@@ -6105,8 +6226,8 @@ async function handleSetLimit(credits, options) {
   );
 }
 async function handleLimitOff(options) {
-  const { http } = getAuthedHttpClient();
-  const payload = await http.request("/api/v2/billing/limit", {
+  const { http: http2 } = getAuthedHttpClient();
+  const payload = await http2.request("/api/v2/billing/limit", {
     method: "DELETE"
   });
   printCommandEnvelope(
@@ -6125,7 +6246,7 @@ async function handleLimitOff(options) {
   );
 }
 async function handleHistory(options) {
-  const { http } = getAuthedHttpClient();
+  const { http: http2 } = getAuthedHttpClient();
   const windows = {
     "1d": 86400,
     "1w": 604800,
@@ -6133,7 +6254,7 @@ async function handleHistory(options) {
     "1y": 31536e3
   };
   const sinceAt = Math.max(0, Math.floor(Date.now() / 1e3) - windows[options.time]) * 1e3;
-  const payload = await http.get(
+  const payload = await http2.get(
     `/api/v2/billing/ledger?since_at=${sinceAt}&limit=5000`
   );
   const entries = Array.isArray(payload.entries) ? payload.entries : [];
@@ -6164,7 +6285,7 @@ async function handleHistory(options) {
   );
 }
 async function handleLedgerExportAll(options) {
-  const { http } = getAuthedHttpClient();
+  const { http: http2 } = getAuthedHttpClient();
   const outputPath = options.output ? (0, import_node_path6.resolve)(String(options.output)) : defaultLedgerExportPath();
   let summary = { row_count: 0, net_delta_credits: 0 };
   let cursor = null;
@@ -6173,7 +6294,7 @@ async function handleLedgerExportAll(options) {
     const params = new URLSearchParams({ limit: "5000" });
     if (cursor !== null) params.set("cursor", cursor);
     if (options.runId) params.set("run_id", options.runId);
-    const payload = await http.get(
+    const payload = await http2.get(
       `/api/v2/billing/ledger?${params.toString()}`
     );
     const entries = Array.isArray(payload.entries) ? payload.entries : [];
@@ -6233,8 +6354,8 @@ function planRolloverText(rollover) {
   return `rollover ${mode}`;
 }
 async function handlePlans(options) {
-  const { http } = getAuthedHttpClient();
-  const payload = await http.get(
+  const { http: http2 } = getAuthedHttpClient();
+  const payload = await http2.get(
     "/api/v2/billing/catalog/current"
   );
   const activePlan = payload.active_plan ?? {};
@@ -6266,8 +6387,8 @@ async function handlePlans(options) {
   );
 }
 async function handleSubscribe(planVersionId, options) {
-  const { http } = getAuthedHttpClient();
-  const payload = await http.request(
+  const { http: http2 } = getAuthedHttpClient();
+  const payload = await http2.request(
     "/api/v2/billing/subscription/checkout",
     {
       method: "POST",
@@ -6486,8 +6607,8 @@ async function handleInvoices(options) {
   );
 }
 async function handleCheckout(options) {
-  const { http } = getAuthedHttpClient();
-  const payload = await http.post(
+  const { http: http2 } = getAuthedHttpClient();
+  const payload = await http2.post(
     "/api/v2/billing/checkout",
     {
       ...options.tier ? { tierId: options.tier } : {},
@@ -6606,8 +6727,8 @@ async function handleTopUp(creditsRaw, options) {
   });
 }
 async function handleRedeemCode(code, options) {
-  const { http } = getAuthedHttpClient();
-  const payload = await http.post(
+  const { http: http2 } = getAuthedHttpClient();
+  const payload = await http2.post(
     "/api/v2/billing/checkout",
     {
       discountCode: code
@@ -22112,8 +22233,8 @@ function registerEnrichCommand(program) {
 
 // src/cli/commands/feedback.ts
 async function handleFeedback(text, options) {
-  const { http } = getAuthedHttpClient();
-  const response = await http.post("/api/v2/cli/feedback", {
+  const { http: http2 } = getAuthedHttpClient();
+  const response = await http2.post("/api/v2/cli/feedback", {
     text,
     environment: collectLocalEnvInfo(),
     ...options.command ? { command: options.command } : {},
@@ -22517,8 +22638,8 @@ function buildSessionUploadContent(raw) {
   return { encodedContent: encoded, needsChunking: true };
 }
 async function uploadPayload(path, payload) {
-  const { http } = getAuthedHttpClient();
-  return await http.post(path, payload);
+  const { http: http2 } = getAuthedHttpClient();
+  return await http2.post(path, payload);
 }
 async function uploadChunkedSessions(sessions, options) {
   const uploadId = (0, import_node_crypto5.randomUUID)();
@@ -23278,8 +23399,8 @@ Preview the plan first with:
   );
 }
 async function handleMonitorsStatus(options) {
-  const http = buildHttpClient();
-  const payload = await http.request(
+  const http2 = buildHttpClient();
+  const payload = await http2.request(
     "/api/v2/monitors/access",
     { method: "GET" }
   );
@@ -23334,7 +23455,7 @@ async function handleMonitorsAvailable(toolId, options) {
     }
   }
   const tool = toolId ?? options.tool;
-  const http = buildHttpClient();
+  const http2 = buildHttpClient();
   const params = new URLSearchParams();
   if (options.provider) params.set("provider", options.provider);
   if (tool) params.set("tool", tool);
@@ -23343,7 +23464,7 @@ async function handleMonitorsAvailable(toolId, options) {
   const compactList = !tool && !options.full;
   if (compactList || options.compact) params.set("compact", "true");
   const query = params.toString();
-  const payload = await http.request(
+  const payload = await http2.request(
     `/api/v2/monitors/tools${query ? `?${query}` : ""}`,
     { method: "GET", ...FORBIDDEN_AS_API_ERROR }
   );
@@ -23383,13 +23504,13 @@ function renderDeployedListText(payload, requestedStatus) {
 `;
 }
 async function handleMonitorsList(options) {
-  const http = buildHttpClient();
+  const http2 = buildHttpClient();
   const params = new URLSearchParams();
   if (options.status) params.set("status", options.status);
   if (options.limit) params.set("limit", options.limit);
   if (options.compact) params.set("compact", "true");
   const query = params.toString();
-  const payload = await http.request(
+  const payload = await http2.request(
     `/api/v2/monitors/deployed${query ? `?${query}` : ""}`,
     { method: "GET", ...FORBIDDEN_AS_API_ERROR }
   );
@@ -23399,21 +23520,21 @@ async function handleMonitorsList(options) {
   });
 }
 async function handleMonitorsCheck(definition, options) {
-  const http = buildHttpClient();
+  const http2 = buildHttpClient();
   const body = resolveMonitorJsonBody({
     positional: definition,
     file: options.file,
     argLabel: "<definition>",
     command: "deepline monitors check"
   });
-  const payload = await http.request(
+  const payload = await http2.request(
     "/api/v2/monitors/check",
     { method: "POST", body, ...FORBIDDEN_AS_API_ERROR }
   );
   printCommandEnvelope(payload, { json: options.json });
 }
 async function handleMonitorsDeploy(definition, options) {
-  const http = buildHttpClient();
+  const http2 = buildHttpClient();
   const body = resolveMonitorJsonBody({
     positional: definition,
     file: options.file,
@@ -23421,7 +23542,7 @@ async function handleMonitorsDeploy(definition, options) {
     command: "deepline monitors deploy"
   });
   if (options.dryRun) {
-    const payload2 = await http.request(
+    const payload2 = await http2.request(
       "/api/v2/monitors/check",
       { method: "POST", body, ...FORBIDDEN_AS_API_ERROR }
     );
@@ -23435,7 +23556,7 @@ async function handleMonitorsDeploy(definition, options) {
     }
     return;
   }
-  const payload = await http.request(
+  const payload = await http2.request(
     "/api/v2/monitors/deploy",
     { method: "POST", body, ...FORBIDDEN_AS_API_ERROR }
   );
@@ -23445,8 +23566,8 @@ async function handleMonitorsDeploy(definition, options) {
   });
 }
 async function handleMonitorsGet(key, options) {
-  const http = buildHttpClient();
-  const payload = await http.request(
+  const http2 = buildHttpClient();
+  const payload = await http2.request(
     `/api/v2/monitors/deployed/${encodeKey(key)}`,
     { method: "GET", ...FORBIDDEN_AS_API_ERROR }
   );
@@ -23468,12 +23589,12 @@ async function confirmMonitorDelete(key, options) {
   }
 }
 async function handleMonitorsDelete(key, options) {
-  const http = buildHttpClient();
+  const http2 = buildHttpClient();
   const params = new URLSearchParams();
   if (options.localOnly) params.set("local_only", "true");
   if (options.dryRun) {
     params.set("dry_run", "true");
-    const payload2 = await http.request(
+    const payload2 = await http2.request(
       `/api/v2/monitors/deployed/${encodeKey(key)}?${params.toString()}`,
       { method: "DELETE", ...FORBIDDEN_AS_API_ERROR }
     );
@@ -23505,30 +23626,30 @@ async function handleMonitorsDelete(key, options) {
     }
   }
   const query = params.toString();
-  const payload = await http.request(
+  const payload = await http2.request(
     `/api/v2/monitors/deployed/${encodeKey(key)}${query ? `?${query}` : ""}`,
     { method: "DELETE", ...FORBIDDEN_AS_API_ERROR }
   );
   printCommandEnvelope(payload, { json: options.json });
 }
 async function handleMonitorsUpdate(key, patch, options) {
-  const http = buildHttpClient();
+  const http2 = buildHttpClient();
   const body = resolveMonitorJsonBody({
     positional: patch,
     file: options.file,
     argLabel: "<patch>",
     command: `deepline monitors update ${key}`
   });
-  const payload = await http.request(
+  const payload = await http2.request(
     `/api/v2/monitors/deployed/${encodeKey(key)}`,
     { method: "PATCH", body, ...FORBIDDEN_AS_API_ERROR }
   );
   printCommandEnvelope(payload, { json: options.json });
 }
 async function handleMonitorsReactivate(key, options) {
-  const http = buildHttpClient();
+  const http2 = buildHttpClient();
   if (options.dryRun) {
-    const payload2 = await http.request(
+    const payload2 = await http2.request(
       `/api/v2/monitors/deployed/${encodeKey(key)}/reactivate?dry_run=true`,
       { method: "POST", body: {}, ...FORBIDDEN_AS_API_ERROR }
     );
@@ -23542,7 +23663,7 @@ async function handleMonitorsReactivate(key, options) {
     });
     return;
   }
-  const payload = await http.request(
+  const payload = await http2.request(
     `/api/v2/monitors/deployed/${encodeKey(key)}/reactivate`,
     { method: "POST", body: {}, ...FORBIDDEN_AS_API_ERROR }
   );
@@ -23786,8 +23907,8 @@ Examples:
 }
 
 // src/cli/commands/org.ts
-async function fetchOrganizations(http, apiKey) {
-  return http.post("/api/v2/auth/cli/organizations", { api_key: apiKey });
+async function fetchOrganizations(http2, apiKey) {
+  return http2.post("/api/v2/auth/cli/organizations", { api_key: apiKey });
 }
 function normalizeAuthScope(value) {
   if (!value) return "auto";
@@ -23891,8 +24012,8 @@ function resolveOrgSwitchAuthTarget(scope, config) {
 }
 async function handleOrgList(options) {
   const config = resolveConfig();
-  const http = new HttpClient(config);
-  const payload = await fetchOrganizations(http, config.apiKey);
+  const http2 = new HttpClient(config);
+  const payload = await fetchOrganizations(http2, config.apiKey);
   printCommandEnvelope(
     {
       ...payload,
@@ -23910,8 +24031,8 @@ async function handleOrgList(options) {
 }
 async function handleOrgStatus(options) {
   const config = resolveConfig();
-  const http = new HttpClient(config);
-  const payload = await fetchOrganizations(http, config.apiKey);
+  const http2 = new HttpClient(config);
+  const payload = await fetchOrganizations(http2, config.apiKey);
   const current = payload.organizations.find((org) => org.is_current) ?? payload.organizations.find(
     (org) => org.org_id === payload.current_org_id
   ) ?? null;
@@ -23994,8 +24115,8 @@ async function handleOrgStatus(options) {
 async function handleOrgSwitch(selection, options) {
   const authScope = normalizeAuthScope(options.authScope);
   const config = resolveConfig();
-  const http = new HttpClient(config);
-  const payload = await fetchOrganizations(http, config.apiKey);
+  const http2 = new HttpClient(config);
+  const payload = await fetchOrganizations(http2, config.apiKey);
   if (!selection && !options.orgId) {
     printCommandEnvelope(
       {
@@ -24090,7 +24211,7 @@ async function handleOrgSwitch(selection, options) {
     );
     return;
   }
-  const switched = await http.post("/api/v2/auth/cli/switch", {
+  const switched = await http2.post("/api/v2/auth/cli/switch", {
     api_key: config.apiKey,
     org_id: target.org_id
   });
@@ -24158,8 +24279,8 @@ async function handleOrgSwitch(selection, options) {
 }
 async function handleOrgCreate(name, options) {
   const config = resolveConfig();
-  const http = new HttpClient(config);
-  const created = await http.post("/api/v2/auth/cli/org-create", {
+  const http2 = new HttpClient(config);
+  const created = await http2.post("/api/v2/auth/cli/org-create", {
     api_key: config.apiKey,
     name
   });
@@ -24751,8 +24872,8 @@ async function handleSet(nameInput, forbidden, options) {
     throw new Error("--play <name> is required when --scope play is used.");
   }
   const value = await readSecretValue();
-  const { http } = getAuthedHttpClient();
-  const response = await http.post(
+  const { http: http2 } = getAuthedHttpClient();
+  const response = await http2.post(
     "/api/v2/secrets",
     {
       name,
@@ -28878,7 +28999,7 @@ async function runPreflightCheck() {
     };
   }).catch(() => ({ status: "unreachable", version: null })).finally(() => clearTimeout(healthTimeout));
   const apiKey = resolveApiKeyForBaseUrl(baseUrl);
-  const http = apiKey ? new HttpClient(
+  const http2 = apiKey ? new HttpClient(
     resolveConfig({
       baseUrl,
       apiKey,
@@ -28886,8 +29007,8 @@ async function runPreflightCheck() {
       maxRetries: 0
     })
   ) : null;
-  const [auth, billing] = http ? await Promise.all([
-    http.post("/api/v2/auth/cli/status", {
+  const [auth, billing] = http2 ? await Promise.all([
+    http2.post("/api/v2/auth/cli/status", {
       api_key: apiKey,
       reveal: false
     }).catch((error) => ({
@@ -28895,7 +29016,7 @@ async function runPreflightCheck() {
       connected: false,
       error: preflightErrorMessage(error)
     })),
-    http.get("/api/v2/billing/balance").catch((error) => ({
+    http2.get("/api/v2/billing/balance").catch((error) => ({
       balance: null,
       balance_display: "unavailable",
       balance_status: "unknown",
@@ -29078,6 +29199,7 @@ Exit codes:
   registerBillingCommands(program);
   registerMonitorsCommands(program);
   registerOrgCommands(program);
+  registerAdminCommands(program);
   registerEnrichCommand(program);
   registerCsvCommands(program);
   registerDbCommands(program);