@brainbase-labs/cli 0.29.1 → 0.31.0

package/README.md

@@ -83,7 +83,9 @@ prompt.
 Idempotency is explicit-only: requests omit the idempotency header unless
 `--idempotency-key` is supplied. Reuse a key only for an identical retry.
 Starting a run requires `--yes`; confirming the same plan ID is replay-safe.
-Interrupting `run watch` does not cancel the remote run.
+Interrupting `run watch` does not cancel the remote run. A run that MAS pauses
+for billing stops `run watch` with exit code 1; once billing is fixed, run
+`brainbase benchmark run resume <run-id> --yes` to put it back in the queue.
 
 Use `brainbase benchmark --help`, `brainbase benchmark run --help`, or
 `brainbase benchmark <command> --help` for local command help.

package/dist/index.js

@@ -36018,7 +36018,7 @@ function padStart(s, n) {
 // package.json
 var package_default = {
   name: "@brainbase-labs/cli",
-  version: "0.29.1",
+  version: "0.31.0",
   description: "Pack, share, and install agent templates across harnesses (Claude Code, Codex, ...).",
   type: "module",
   bin: {
@@ -62408,14 +62408,16 @@ var McpEntrySchema = exports_external.object({
   args: exports_external.array(exports_external.string()).optional(),
   env: exports_external.record(exports_external.string()).optional(),
   headers: exports_external.record(exports_external.string()).optional(),
-  is_enabled: exports_external.boolean().optional()
+  is_enabled: exports_external.boolean().optional(),
+  runtime_meta: exports_external.record(exports_external.unknown()).optional()
 });
 var CapabilitiesSchema = exports_external.object({
   memory: exports_external.boolean().optional(),
   browser: exports_external.boolean().optional(),
   slack: exports_external.boolean().optional(),
   meeting: exports_external.boolean().optional(),
-  github: exports_external.boolean().optional()
+  github: exports_external.boolean().optional(),
+  linear: exports_external.boolean().optional()
 });
 var EvalOutputShape = exports_external.enum(["binary", "rating", "classification"]);
 var EVAL_SLUG_RE = /^[a-z0-9][a-z0-9-]*$/;
@@ -63581,6 +63583,39 @@ function buildGithubMcpComponent(scope) {
   };
 }
 
+// src/core/linear-mcp.ts
+var DEFAULT_LINEAR_MCP_BASE = "https://brainbase-linear-mcp.onrender.com";
+var LINEAR_MCP_SLUG = "brainbase-linear";
+function linearMcpBaseUrl() {
+  const envOverride = process.env.BRAINBASE_LINEAR_MCP_URL;
+  if (envOverride)
+    return envOverride.replace(/\/+$/, "");
+  return DEFAULT_LINEAR_MCP_BASE;
+}
+function linearMcpUrl() {
+  return `${linearMcpBaseUrl()}/t/\${BRAINBASE_THREAD_ID}/mcp`;
+}
+function linearMcpPayload() {
+  return {
+    url: linearMcpUrl(),
+    headers: {
+      Authorization: "Bearer ${BRAINBASE_TOKEN}"
+    }
+  };
+}
+function buildLinearMcpComponent(scope) {
+  return {
+    type: "mcp",
+    slug: LINEAR_MCP_SLUG,
+    scope,
+    rootDir: "",
+    description: "This agent's Linear connector (read and update issues, comment, and " + "report progress on delegated work). Scoped to this agent only.",
+    meta: { mcp: linearMcpPayload() },
+    payload: linearMcpPayload(),
+    checksum: "builtin:brainbase-linear:v1"
+  };
+}
+
 // src/core/browser-mcp.ts
 var DEFAULT_BROWSER_MCP_BASE = "https://brainbase-browser-mcp.onrender.com";
 var BROWSER_MCP_SLUG = "brainbase-browser";
@@ -63621,7 +63656,8 @@ function capabilitiesFromAgent(agent) {
     browser: agent.browser_enabled !== false,
     slack: agent.slack_connected === true,
     meeting: agent.meeting_connected === true,
-    github: agent.github_connected === true
+    github: agent.github_connected === true,
+    linear: agent.linear_connected === true
   };
 }
 function capabilitiesFromManifest(manifest) {
@@ -63631,7 +63667,8 @@ function capabilitiesFromManifest(manifest) {
     browser: c2.browser !== false,
     slack: c2.slack === true,
     meeting: c2.meeting === true,
-    github: c2.github === true
+    github: c2.github === true,
+    linear: c2.linear === true
   };
 }
 function resolveBuiltinMcps(input) {
@@ -63642,7 +63679,8 @@ function resolveBuiltinMcps(input) {
     { slug: BROWSER_MCP_SLUG, enabled: caps.browser, build: buildBrowserMcpComponent },
     { slug: SLACK_MCP_SLUG, enabled: caps.slack, build: buildSlackMcpComponent },
     { slug: MEETING_MCP_SLUG, enabled: caps.meeting, build: buildMeetingMcpComponent },
-    { slug: GITHUB_MCP_SLUG, enabled: caps.github, build: buildGithubMcpComponent }
+    { slug: GITHUB_MCP_SLUG, enabled: caps.github, build: buildGithubMcpComponent },
+    { slug: LINEAR_MCP_SLUG, enabled: caps.linear, build: buildLinearMcpComponent }
   ];
   const install = [];
   const removeSlugs = [];
@@ -64408,7 +64446,7 @@ function diffAgentMeta(manifestMeta, lockMeta, cloudMeta) {
   };
 }
 var WRITABLE_CAPABILITIES = ["memory", "browser"];
-var MIRRORED_CAPABILITIES = ["slack", "meeting", "github"];
+var MIRRORED_CAPABILITIES = ["slack", "meeting", "github", "linear"];
 function manifestConfigState(manifest) {
   return {
     ...manifest.machine_kind !== undefined ? { machine_kind: manifest.machine_kind } : {},
@@ -64432,7 +64470,8 @@ function staleConnectionMirrors(manifest, cloud) {
   const actualByName = {
     slack: cloud.slack_connected,
     meeting: cloud.meeting_connected,
-    github: cloud.github_connected
+    github: cloud.github_connected,
+    linear: cloud.linear_connected
   };
   const stale = [];
   for (const name of MIRRORED_CAPABILITIES) {
@@ -64595,6 +64634,41 @@ function capabilityBaselineAfterPush(cloudAgent, previous, diff2) {
   return out;
 }
 
+// src/core/mcp-merge.ts
+var RUNTIME_META_PREFIX = "runtime_";
+function runtimeMetaFromComponent(component) {
+  const meta = component.meta ?? {};
+  const carried = {};
+  for (const [key2, value] of Object.entries(meta)) {
+    if (key2.startsWith(RUNTIME_META_PREFIX) && value !== undefined) {
+      carried[key2] = value;
+    }
+  }
+  return Object.keys(carried).length > 0 ? carried : undefined;
+}
+function mcpEntriesFromCloudComponents(components) {
+  return components.filter((c2) => c2.type === "mcp").map((c2) => {
+    const payload = (c2.meta ?? {}).mcp ?? {};
+    const entry = { name: c2.slug };
+    if (typeof payload.url === "string")
+      entry.url = payload.url;
+    if (typeof payload.command === "string")
+      entry.command = payload.command;
+    if (Array.isArray(payload.args))
+      entry.args = payload.args.map(String);
+    if (payload.env && typeof payload.env === "object")
+      entry.env = payload.env;
+    if (payload.headers && typeof payload.headers === "object")
+      entry.headers = payload.headers;
+    if (typeof payload.is_enabled === "boolean")
+      entry.is_enabled = payload.is_enabled;
+    const runtimeMeta = runtimeMetaFromComponent(c2);
+    if (runtimeMeta)
+      entry.runtime_meta = runtimeMeta;
+    return entry;
+  });
+}
+
 // src/core/secrets-env.ts
 import path78 from "node:path";
 import fs71 from "node:fs";
@@ -65445,23 +65519,7 @@ function mergeManifest(cwd2, prev, cloud, cloudAgent, harness, localOnly = {}, s
       content
     };
   });
-  const mcp = cloud.components.filter((c2) => c2.type === "mcp").map((c2) => {
-    const payload = (c2.meta ?? {}).mcp ?? {};
-    const entry = { name: c2.slug };
-    if (typeof payload.url === "string")
-      entry.url = payload.url;
-    if (typeof payload.command === "string")
-      entry.command = payload.command;
-    if (Array.isArray(payload.args))
-      entry.args = payload.args.map(String);
-    if (payload.env && typeof payload.env === "object")
-      entry.env = payload.env;
-    if (payload.headers && typeof payload.headers === "object")
-      entry.headers = payload.headers;
-    if (typeof payload.is_enabled === "boolean")
-      entry.is_enabled = payload.is_enabled;
-    return entry;
-  });
+  const mcp = mcpEntriesFromCloudComponents(cloud.components);
   const evals = evalsFromCloudComponents(cloud.components);
   const caps = capabilitiesFromAgent(cloudAgent);
   const machineKind = cloudAgent.machine_kind ?? prev?.machine_kind;
@@ -65496,7 +65554,8 @@ function mergeManifest(cwd2, prev, cloud, cloudAgent, harness, localOnly = {}, s
       browser: caps.browser,
       slack: caps.slack,
       meeting: caps.meeting,
-      github: caps.github
+      github: caps.github,
+      linear: caps.linear
     }
   };
 }
@@ -65881,7 +65940,7 @@ async function buildOutgoingComponents(cwd2, manifest, cloud, resolvedVersions)
       slug: entry.name,
       hash: "",
       files: [],
-      meta: { mcp: payload }
+      meta: { ...entry.runtime_meta ?? {}, mcp: payload }
     });
   }
   return out;
@@ -69044,23 +69103,7 @@ function buildManifestFromCloud(cloud, agent, localOnly = {}) {
     return { source: `registry:${c2.slug}` };
   });
   const hasInstructions = cloud.components.some((c2) => c2.type === "instruction" && c2.files[0]?.content?.trim());
-  const mcp = cloud.components.filter((c2) => c2.type === "mcp").map((c2) => {
-    const payload = (c2.meta ?? {}).mcp ?? {};
-    const entry = { name: c2.slug };
-    if (typeof payload.url === "string")
-      entry.url = payload.url;
-    if (typeof payload.command === "string")
-      entry.command = payload.command;
-    if (Array.isArray(payload.args))
-      entry.args = payload.args.map(String);
-    if (payload.env && typeof payload.env === "object")
-      entry.env = payload.env;
-    if (payload.headers && typeof payload.headers === "object")
-      entry.headers = payload.headers;
-    if (typeof payload.is_enabled === "boolean")
-      entry.is_enabled = payload.is_enabled;
-    return entry;
-  });
+  const mcp = mcpEntriesFromCloudComponents(cloud.components);
   const playbooks = cloud.components.filter((c2) => c2.type === "playbook").map((c2) => {
     const raw = c2.files[0]?.content ?? "";
     const { frontmatter } = stripPlaybookFrontmatter(raw);
@@ -69100,7 +69143,8 @@ function buildManifestFromCloud(cloud, agent, localOnly = {}) {
       browser: caps.browser,
       slack: caps.slack,
       meeting: caps.meeting,
-      github: caps.github
+      github: caps.github,
+      linear: caps.linear
     }
   };
 }
@@ -84701,7 +84745,7 @@ class BenchmarkApiClient {
         try {
           responseBody = text3 ? JSON.parse(text3) : null;
         } catch {}
-        throw new BenchmarkApiError(redactSensitiveText(apiErrorMessage(responseBody, response.status)), response.status, responseBody, safeCode(responseBody), response.headers.get("x-request-id") ?? response.headers.get("x-correlation-id") ?? undefined);
+        throw new BenchmarkApiError(redactSensitiveText(masApiErrorMessage(responseBody, response.status)), response.status, responseBody, safeCode(responseBody), response.headers.get("x-request-id") ?? response.headers.get("x-correlation-id") ?? undefined);
       }
       if (options.mode === "binary") {
         return {
@@ -84916,6 +84960,11 @@ class BenchmarkApiClient {
       method: "POST"
     });
   }
+  resumeRun(runId) {
+    return this.request(`/runs/${encodeURIComponent(runId)}/resume`, {
+      method: "POST"
+    });
+  }
   listDiagnoses(runId, query = {}) {
     return this.request(`/runs/${encodeURIComponent(runId)}/diagnoses`, {
       query: {
@@ -87301,6 +87350,12 @@ class BenchmarkControlOutput {
 `);
     }
   }
+  hint(text2) {
+    if (this.mode.json || this.mode.jsonl)
+      return;
+    this.writer.stdout(`${text2}
+`);
+  }
   page(page, all = false) {
     if (this.mode.jsonl) {
       for (const item of page.items)
@@ -87332,6 +87387,7 @@ class BenchmarkControlOutput {
 
 // src/cli/benchmark-control.ts
 var TERMINAL_RUN_STATUSES = new Set(["cancelled", "failed", "succeeded"]);
+var PAUSED_RUN_STATUS = "paused";
 var MAX_MANIFEST_IMPORT_BYTES = 2 * 1024 * 1024;
 var MAX_CSV_IMPORT_BYTES = 10 * 1024 * 1024;
 var MAX_PAGINATION_PAGES = 1e4;
@@ -87508,7 +87564,7 @@ function commandHelp() {
     "",
     `  ${import_picocolors60.default.cyan("init | list | show | create | validate | pull | push")}`,
     `  ${import_picocolors60.default.cyan("publish | revisions | import | export | archive | restore")}`,
-    `  ${import_picocolors60.default.cyan("run plan|start|watch|list|show|cancel")}`,
+    `  ${import_picocolors60.default.cyan("run plan|start|watch|list|show|cancel|resume")}`,
     `  ${import_picocolors60.default.cyan("results | diagnoses | attempt | artifacts | export-results")}`,
     `  ${import_picocolors60.default.cyan("history | baseline show|set|clear")}`,
     "",
@@ -87908,7 +87964,7 @@ function runPlanInput(options, revisionId) {
     revision_id: revisionId,
     variants: variants.length > 0 ? variants.map(parseVariant) : [{ key: "default" }],
     repetitions: integerOption(options.parsed, "repetitions", { min: 1, max: 10 }) ?? 1,
-    concurrency: integerOption(options.parsed, "concurrency", { min: 1, max: 10 }) ?? 5
+    concurrency: integerOption(options.parsed, "concurrency", { min: 1, max: 50 }) ?? 5
   };
   if (cases.length > 0)
     input.case_keys = cases;
@@ -87954,7 +88010,15 @@ async function runStart(cwd2, argv, deps) {
   const { client, output } = context(cwd2, "benchmark run start", options, deps);
   output.result(json(await client.confirmRunPlan(planId)));
 }
-async function watchRun(client, output, runId, interval, deps) {
+function pausedRunHint(runId, run, agentId) {
+  const reason = run.paused_reason;
+  const message = reason && typeof reason === "object" && !Array.isArray(reason) ? reason.message : undefined;
+  const first = typeof message === "string" && message.trim() ? `Run paused: ${message.trim()}` : "Run paused.";
+  const agent = agentId ? ` --agent ${agentId}` : "";
+  return `${first}
+Resume with: brainbase benchmark run resume ${runId} --yes${agent}`;
+}
+async function watchRun(client, output, runId, interval, agentId, deps) {
   let interrupted = false;
   const controller = new AbortController;
   const onInterrupt = () => {
@@ -87976,9 +88040,16 @@ async function watchRun(client, output, runId, interval, deps) {
       const digest2 = output.digest(latest);
       if (digest2 !== previous) {
         const status = typeof latest.status === "string" ? latest.status : "unknown";
-        output.event(TERMINAL_RUN_STATUSES.has(status) ? "run.completed" : "run.updated", latest, typeof latest.updated_at === "string" ? latest.updated_at : undefined);
+        const terminal = TERMINAL_RUN_STATUSES.has(status);
+        const paused = status === PAUSED_RUN_STATUS;
+        output.event(terminal ? "run.completed" : paused ? "run.paused" : "run.updated", latest, typeof latest.updated_at === "string" ? latest.updated_at : undefined);
         previous = digest2;
-        if (TERMINAL_RUN_STATUSES.has(status)) {
+        if (paused) {
+          output.hint(pausedRunHint(runId, latest, agentId));
+          deps.setExitCode(1);
+          return { run: latest, interrupted: false };
+        }
+        if (terminal) {
           if (status !== "succeeded")
             deps.setExitCode(1);
           return { run: latest, interrupted: false };
@@ -88000,7 +88071,7 @@ async function runWatch(cwd2, argv, deps) {
   const watched = await watchRun(client, output, options.positionals[0], integerOption(options.parsed, "interval", {
     min: 100,
     max: 60000
-  }) ?? 2000, deps);
+  }) ?? 2000, options.agent, deps);
   if (options.json) {
     output.result({
       run: watched.run,
@@ -88040,6 +88111,15 @@ async function runCancel(cwd2, argv, deps) {
   const { client, output } = context(cwd2, "benchmark run cancel", options, deps);
   output.result(json(await client.cancelRun(options.positionals[0])));
 }
+async function runResume(cwd2, argv, deps) {
+  const options = parseControlOptions(argv, ["yes"]);
+  expectPositionals(options.positionals, 1, 1, "brainbase benchmark run resume <run-id>");
+  if (!bool(options.parsed, "yes")) {
+    throw usageError("--yes is required to resume a benchmark run");
+  }
+  const { client, output } = context(cwd2, "benchmark run resume", options, deps);
+  output.result(json(await client.resumeRun(options.positionals[0])));
+}
 async function runOneShot(cwd2, argv, deps) {
   const options = parseControlOptions(argv, [
     ...RUN_PLAN_OPTIONS,
@@ -88079,7 +88159,7 @@ async function runOneShot(cwd2, argv, deps) {
   const watched = await watchRun(client, output, runId, integerOption(options.parsed, "interval", {
     min: 100,
     max: 60000
-  }) ?? 2000, deps);
+  }) ?? 2000, options.agent, deps);
   if (options.json) {
     output.result({
       plan,
@@ -88105,6 +88185,8 @@ async function runRunRouter(cwd2, argv, deps) {
     case "cancel":
     case "stop":
       return await runCancel(cwd2, rest2, deps);
+    case "resume":
+      return await runResume(cwd2, rest2, deps);
     case undefined:
     case "help":
     case "--help":
@@ -88378,10 +88460,10 @@ function commandLevelHelp(sub, argv) {
       if (action === "show") {
         return usage("brainbase benchmark run show <run-id>");
       }
-      if (action === "cancel" || action === "stop") {
+      if (action === "cancel" || action === "stop" || action === "resume") {
         return usage(`brainbase benchmark run ${action} <run-id> --yes`);
       }
-      return usage("brainbase benchmark run <benchmark-id> --yes [--revision <revision-id>] [--watch] [--idempotency-key <key>]", "brainbase benchmark run plan <benchmark-id> --revision <revision-id>", "brainbase benchmark run start <plan-id> --yes", "brainbase benchmark run watch <run-id> [--interval-ms <n>]", "brainbase benchmark run list [benchmark-id] [--status <status>] [--limit <n>] [--cursor <cursor>] [--all]", "brainbase benchmark run show <run-id>", "brainbase benchmark run cancel <run-id> --yes");
+      return usage("brainbase benchmark run <benchmark-id> --yes [--revision <revision-id>] [--watch] [--idempotency-key <key>]", "brainbase benchmark run plan <benchmark-id> --revision <revision-id>", "brainbase benchmark run start <plan-id> --yes", "brainbase benchmark run watch <run-id> [--interval-ms <n>]", "brainbase benchmark run list [benchmark-id] [--status <status>] [--limit <n>] [--cursor <cursor>] [--all]", "brainbase benchmark run show <run-id>", "brainbase benchmark run cancel <run-id> --yes", "brainbase benchmark run resume <run-id> --yes");
     case "results":
       return usage("brainbase benchmark results <run-id> [--baseline-target <target-id>]");
     case "diagnoses":
@@ -88414,7 +88496,7 @@ function automationCommand(sub, argv) {
     const action = argv[0];
     if (action === "stop")
       return "benchmark run cancel";
-    if (action && ["plan", "start", "watch", "list", "show", "cancel"].includes(action)) {
+    if (action && ["plan", "start", "watch", "list", "show", "cancel", "resume"].includes(action)) {
       return `benchmark run ${action}`;
     }
     return "benchmark run";
@@ -89048,6 +89130,7 @@ function help() {
   out.push(`  ${import_picocolors61.default.dim("BRAINBASE_SLACK_MCP_URL")}         override the built-in Slack MCP host`);
   out.push(`  ${import_picocolors61.default.dim("BRAINBASE_MEETING_MCP_URL")}       override the built-in meeting MCP host`);
   out.push(`  ${import_picocolors61.default.dim("BRAINBASE_GITHUB_MCP_URL")}        override the built-in GitHub MCP host`);
+  out.push(`  ${import_picocolors61.default.dim("BRAINBASE_LINEAR_MCP_URL")}        override the built-in Linear MCP host`);
   out.push(`  ${import_picocolors61.default.dim("BRAINBASE_ORCHESTRATION_MCP_URL")} override the built-in orchestration MCP host`);
   out.push("");
   out.push(divider("HARNESSES"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brainbase-labs/cli",
-  "version": "0.29.1",
+  "version": "0.31.0",
   "description": "Pack, share, and install agent templates across harnesses (Claude Code, Codex, ...).",
   "type": "module",
   "bin": {