@brainbase-labs/cli 0.10.1 → 0.11.1

package/dist/index.js

@@ -29449,7 +29449,7 @@ function padStart(s, n) {
 // package.json
 var package_default = {
   name: "@brainbase-labs/cli",
-  version: "0.10.1",
+  version: "0.11.1",
   description: "Pack, share, and install agent templates across harnesses (Claude Code, Codex, ...).",
   type: "module",
   bin: {
@@ -43741,6 +43741,33 @@ function removeInstalledRecord(name, scope, cwd2) {
 // src/core/registry-remote.ts
 import fs22 from "node:fs";
 
+// src/core/api-error-message.ts
+function apiErrorMessage(body, status) {
+  if (body && typeof body === "object") {
+    const obj = body;
+    for (const key2 of ["error", "message", "detail"]) {
+      const v2 = obj[key2];
+      if (typeof v2 === "string" && v2.trim())
+        return v2.trim();
+      if (Array.isArray(v2)) {
+        const msgs = v2.map((item) => {
+          if (typeof item === "string" && item.trim())
+            return item.trim();
+          if (item && typeof item === "object" && typeof item.msg === "string") {
+            return item.msg;
+          }
+          return null;
+        }).filter((m2) => !!m2);
+        if (msgs.length)
+          return msgs.join("; ");
+      }
+    }
+  } else if (typeof body === "string" && body.trim()) {
+    return body.trim();
+  }
+  return `HTTP ${status}`;
+}
+
 // src/core/api.ts
 var DEFAULT_API_BASE = "https://kafka-llm-service.onrender.com";
 
@@ -43800,8 +43827,7 @@ async function request(pathname, init = {}) {
     body = text2 ? JSON.parse(text2) : null;
   } catch {}
   if (!res.ok) {
-    const msg = (body && typeof body === "object" && "error" in body ? String(body.error) : null) ?? (body && typeof body === "object" && "message" in body ? String(body.message) : null) ?? `HTTP ${res.status}`;
-    throw new ApiError(msg, res.status, body);
+    throw new ApiError(apiErrorMessage(body, res.status), res.status, body);
   }
   return body;
 }
@@ -52792,6 +52818,14 @@ function diffSecrets(local, cloud) {
   };
 }
 
+// src/core/entrypoint-gate.ts
+function entrypointExecutionAllowed(opts) {
+  if (opts.flag)
+    return true;
+  const v3 = (opts.env.BRAINBASE_RUN_ENTRYPOINT ?? "").trim().toLowerCase();
+  return v3 === "1" || v3 === "true";
+}
+
 // src/cli/agent-pull.ts
 async function runAgentPull(cwd2, args) {
   banner("agent pull — bring cloud changes into this folder");
@@ -53007,7 +53041,7 @@ async function runAgentPull(cwd2, args) {
     };
     writeSyncState(cwd2, newState);
     await pullSecrets(cwd2, agentId);
-    await runEntrypointIfPresent(cwd2, yaml);
+    await runEntrypointIfPresent(cwd2, yaml, entrypointExecutionAllowed({ flag: args.runEntrypoint, env: process.env }));
     $e(`Pulled ${cloudAgent.name} at revision ${cloud.revision}.`);
   } finally {
     try {
@@ -53326,7 +53360,7 @@ function buildLinkFromAgent(agent, harness, prev) {
     tracking: prev?.tracking
   };
 }
-async function runEntrypointIfPresent(cwd2, manifest) {
+async function runEntrypointIfPresent(cwd2, manifest, execute) {
   if (!manifest.entrypoint)
     return;
   const body = resolveEntrypoint(cwd2, manifest);
@@ -53340,6 +53374,10 @@ async function runEntrypointIfPresent(cwd2, manifest) {
   try {
     fs45.chmodSync(scriptPath, 493);
   } catch {}
+  if (!execute) {
+    f2.info(`Agent has an entrypoint — written to ${import_picocolors25.default.dim(path48.relative(cwd2, scriptPath))}, not executed. ` + `Run it with ${import_picocolors25.default.cyan("brainbase run bash .brainbase/entrypoint.sh")} or re-pull with ${import_picocolors25.default.cyan("--run-entrypoint")}. Sandboxes run it automatically.`);
+    return;
+  }
   f2.info(`Running entrypoint ${import_picocolors25.default.dim(`(${path48.relative(cwd2, scriptPath)})`)}`);
   const secrets = readLocalSecrets(cwd2);
   const env3 = { ...process.env, ...secrets };
@@ -53477,42 +53515,6 @@ async function buildOutgoingComponents(cwd2, manifest, cloud, resolvedVersions)
       }
     });
   }
-  const seenPlaybookSlugs = new Set;
-  for (const entry of manifest.playbooks ?? []) {
-    if (entry.content.text !== undefined && entry.content.file !== undefined) {
-      f2.error(`Playbook ${import_picocolors26.default.bold(entry.title)} sets both ${import_picocolors26.default.cyan("text")} and ${import_picocolors26.default.cyan("file")} — pick one.`);
-      return null;
-    }
-    const body = resolvePlaybookContent(cwd2, entry);
-    if (body === null) {
-      if (entry.content.file) {
-        f2.error(`Playbook ${import_picocolors26.default.bold(entry.title)} content file ${import_picocolors26.default.bold(entry.content.file)} not found.`);
-      } else {
-        f2.error(`Playbook ${import_picocolors26.default.bold(entry.title)} content is empty.`);
-      }
-      return null;
-    }
-    const slug = slugifyPlaybookTitle(entry.title);
-    if (seenPlaybookSlugs.has(slug)) {
-      f2.error(`Two playbooks resolve to the same slug ${import_picocolors26.default.bold(slug)} (from title ${import_picocolors26.default.bold(entry.title)}). Pick distinct titles.`);
-      return null;
-    }
-    seenPlaybookSlugs.add(slug);
-    const wireBody = assemblePlaybookBody(entry, body);
-    const fileName = `${slug}.md`;
-    const fileHash2 = hashString(wireBody);
-    out.push({
-      type: "playbook",
-      slug,
-      description: entry.description,
-      hash: componentHashFromFileHashes([fileHash2]),
-      files: [{ path: fileName, content: wireBody, hash: fileHash2 }],
-      meta: {
-        title: entry.title,
-        ...entry.description ? { description: entry.description } : {}
-      }
-    });
-  }
   for (const entry of manifest.mcp ?? []) {
     if (!entry.url && !entry.command) {
       f2.error(`MCP ${import_picocolors26.default.bold(entry.name)} needs either ${import_picocolors26.default.cyan("url")} or ${import_picocolors26.default.cyan("command")}.`);
@@ -53540,23 +53542,6 @@ async function buildOutgoingComponents(cwd2, manifest, cloud, resolvedVersions)
   }
   return out;
 }
-function assemblePlaybookBody(entry, body) {
-  if (/^---\s*\n/.test(body))
-    return body;
-  const lines = ["---", `title: ${yamlScalar(entry.title)}`];
-  if (entry.description) {
-    lines.push(`description: ${yamlScalar(entry.description)}`);
-  }
-  lines.push("---", "");
-  return lines.join(`
-`) + body.replace(/^\n+/, "");
-}
-function yamlScalar(s3) {
-  if (!/[\n":#&*!|>'%@`{}[\]]/.test(s3) && s3.trim() === s3 && s3 !== "") {
-    return s3;
-  }
-  return JSON.stringify(s3);
-}
 
 // src/core/registry-skill-updates.ts
 function parseSemver2(v3) {
@@ -53652,29 +53637,56 @@ async function runAgentPush(cwd2, args) {
     lock: lock?.components ?? [],
     cloud: cloud.components
   });
-  const unpinned = new Map;
+  const registryRefs = new Map;
   for (const entry of manifest.skills) {
     try {
       const parsed = parseSkillSource2(entry.source);
-      if (parsed.kind === "registry" && !parsed.version && parsed.creator) {
-        unpinned.set(`${parsed.creator}/${parsed.slug}`, {
+      if (parsed.kind === "registry" && parsed.creator) {
+        registryRefs.set(`${parsed.creator}/${parsed.slug}`, {
           creator: parsed.creator,
-          slug: parsed.slug
+          slug: parsed.slug,
+          version: parsed.version
         });
       }
     } catch {}
   }
   const latestByName = new Map;
-  if (unpinned.size > 0) {
-    await Promise.all([...unpinned.entries()].map(async ([name, ref]) => {
+  const notInRegistry = new Set;
+  if (registryRefs.size > 0) {
+    await Promise.all([...registryRefs.entries()].map(async ([name, ref]) => {
       try {
         const pkg = await skillsApi.getPackage(ref.creator, ref.slug);
         if (pkg.latest_version?.version) {
           latestByName.set(name, pkg.latest_version.version);
         }
-      } catch {}
+      } catch (err) {
+        if (err instanceof ApiError && err.status === 404) {
+          notInRegistry.add(name);
+        }
+      }
     }));
   }
+  const unresolvable = [...notInRegistry].filter((name) => {
+    const ref = registryRefs.get(name);
+    const componentSlug = registrySkillComponentSlug({
+      kind: "registry",
+      creator: ref.creator,
+      slug: ref.slug
+    });
+    return !cloud.components.some((c2) => c2.type === "skill" && c2.slug === componentSlug);
+  });
+  if (unresolvable.length > 0) {
+    for (const name of unresolvable) {
+      f2.error(`Skill ${import_picocolors27.default.bold(name)} isn't in the registry (not published, or private to another owner).`);
+    }
+    const noun = unresolvable.length === 1 ? "it" : "each one";
+    f2.info(`Publish ${noun} first, then push again:`);
+    for (const name of unresolvable) {
+      const version = registryRefs.get(name)?.version ?? "0.1.0";
+      f2.info(`  ${import_picocolors27.default.cyan(`brainbase skill publish ./path/to/skill --name ${name} --skill-version ${version} --yes`)}`);
+    }
+    return;
+  }
   const skillUpdates = planRegistrySkillUpdates(manifest.skills, cloud.components, latestByName);
   const resolvedVersions = new Map(skillUpdates.map((u2) => [u2.componentSlug, u2.latest]));
   for (const u2 of skillUpdates) {
@@ -53711,7 +53723,7 @@ async function runAgentPush(cwd2, args) {
   const entrypointChanged = resolvedEntrypoint !== undefined && (resolvedEntrypoint ?? "").trim() !== (lock?.agentMeta?.entrypoint ?? "").trim();
   for (const r2 of rows) {
     if (r2.type !== "instruction" && r2.type !== "skill" && r2.type !== "mcp" && r2.type !== "playbook") {
-      f2.error(`Component ${fmtType(r2.type)} ${import_picocolors27.default.bold(r2.slug)} can't be pushed yet — the server accepts instructions, skills, mcps, and playbooks in this version.`);
+      f2.error(`Component ${fmtType(r2.type)} ${import_picocolors27.default.bold(r2.slug)} can't be pushed yet — the server accepts instructions, skills, and mcps in this version.`);
       return;
     }
   }
@@ -53730,7 +53742,13 @@ async function runAgentPush(cwd2, args) {
   const toSend = [];
   const conflicts = [];
   const upstreamOnly = [];
+  const unpushablePlaybooks = [];
   for (const r2 of rows) {
+    const localish = r2.status === "modified-local" || r2.status === "added-only-local" || r2.status === "removed-local" || r2.status === "modified-both";
+    if (r2.type === "playbook" && localish) {
+      unpushablePlaybooks.push(r2);
+      continue;
+    }
     switch (r2.status) {
       case "modified-local":
       case "added-only-local":
@@ -53747,6 +53765,9 @@ async function runAgentPush(cwd2, args) {
         break;
     }
   }
+  if (unpushablePlaybooks.length > 0) {
+    f2.warn(`Local playbook change${unpushablePlaybooks.length === 1 ? "" : "s"} can't be pushed yet (the server doesn't accept playbooks) — edit playbooks in the UI instead: ${unpushablePlaybooks.map((r2) => import_picocolors27.default.bold(r2.slug)).join(", ")}`);
+  }
   if (!meta.localChanged && !entrypointChanged && toSend.length === 0 && conflicts.length === 0) {
     f2.info("Nothing to push — local is in sync with the cloud.");
     return;
@@ -53861,6 +53882,8 @@ async function runAgentPush(cwd2, args) {
   }
   const localHashByKey = new Map;
   for (const lc of localComponents) {
+    if (lc.type === "playbook")
+      continue;
     if (lc.hash)
       localHashByKey.set(`${lc.type}/${lc.slug}`, lc.hash);
   }
@@ -54386,6 +54409,9 @@ async function runAgentCreate(cwd2, args) {
   writeLink(cwd2, link2);
   manifest = readManifest(cwd2);
   let updatedCloud = null;
+  if ((manifest.playbooks ?? []).length > 0) {
+    f2.info(`Playbooks aren't pushable yet — skipping ${manifest.playbooks.length}. Create playbooks in the UI instead.`);
+  }
   const hasContent = !!manifest.instructions || manifest.skills.length > 0 || (manifest.mcp ?? []).length > 0;
   if (hasContent) {
     const outgoing = await buildOutgoingComponents(cwd2, manifest, null);
@@ -54756,14 +54782,14 @@ function copyDirRecursive(src, dest) {
   }
 }
 function assembleFrontmatter(title, description) {
-  const lines = ["---", `title: ${yamlScalar2(title)}`];
+  const lines = ["---", `title: ${yamlScalar(title)}`];
   if (description)
-    lines.push(`description: ${yamlScalar2(description)}`);
+    lines.push(`description: ${yamlScalar(description)}`);
   lines.push("---", "");
   return lines.join(`
 `);
 }
-function yamlScalar2(s3) {
+function yamlScalar(s3) {
   if (!/[\n":#&*!|>'%@`{}[\]]/.test(s3) && s3.trim() === s3 && s3 !== "")
     return s3;
   return JSON.stringify(s3);
@@ -54811,7 +54837,8 @@ async function runAgent(cwd2, sub, args, opts) {
         yes: opts.yes,
         scope: opts.scope,
         agentIdArg: args[0],
-        force: opts.force
+        force: opts.force,
+        runEntrypoint: opts.runEntrypoint
       });
       return;
     case "push":
@@ -54849,7 +54876,7 @@ function printHelp() {
   out.push(`  ${import_picocolors32.default.bold("brainbase agent")} ${import_picocolors32.default.dim("<sub> [options]")}`);
   out.push("");
   out.push(`  ${import_picocolors32.default.cyan("create")}             ${import_picocolors32.default.dim("claim an unclaimed brainbase.agent.yaml and create the cloud agent")}`);
-  out.push(`  ${import_picocolors32.default.cyan("pull")} ${import_picocolors32.default.dim("[<id>]")}      ${import_picocolors32.default.dim("apply cloud changes into this folder — pass <id> to switch (--force to override)")}`);
+  out.push(`  ${import_picocolors32.default.cyan("pull")} ${import_picocolors32.default.dim("[<id>]")}      ${import_picocolors32.default.dim("apply cloud changes into this folder — pass <id> to switch (--force to override); --run-entrypoint to also execute the agent entrypoint")}`);
   out.push(`  ${import_picocolors32.default.cyan("push")}               ${import_picocolors32.default.dim("send local changes to the cloud")}`);
   out.push(`  ${import_picocolors32.default.cyan("unpack")}             ${import_picocolors32.default.dim("install the claimed agent into a harness layout (--harness to override)")}`);
   out.push(`  ${import_picocolors32.default.cyan("status")}             ${import_picocolors32.default.dim("show what would push and what would pull")}`);
@@ -56782,7 +56809,7 @@ function help() {
   out.push(divider("LINKED AGENT"));
   out.push("");
   out.push(`  ${import_picocolors41.default.cyan("agent create")}               ${import_picocolors41.default.dim("claim an unclaimed brainbase.agent.yaml and create the cloud agent")}`);
-  out.push(`  ${import_picocolors41.default.cyan("agent pull")} ${import_picocolors41.default.dim("[<id>]")}          ${import_picocolors41.default.dim("bring cloud changes into this folder (--force to override)")}`);
+  out.push(`  ${import_picocolors41.default.cyan("agent pull")} ${import_picocolors41.default.dim("[<id>]")}          ${import_picocolors41.default.dim("bring cloud changes into this folder (--force to override; --run-entrypoint to also execute the agent entrypoint)")}`);
   out.push(`  ${import_picocolors41.default.cyan("agent push")}                 ${import_picocolors41.default.dim("send local changes to the cloud")}`);
   out.push(`  ${import_picocolors41.default.cyan("agent unpack")}               ${import_picocolors41.default.dim("install the claimed agent into a harness layout")}`);
   out.push(`  ${import_picocolors41.default.cyan("link")}                       ${import_picocolors41.default.dim("attach this folder to an existing agent")}`);
@@ -56846,6 +56873,7 @@ function help() {
   out.push(`  ${import_picocolors41.default.dim("BRAINBASE_TOKEN")}        long-lived CLI PAT (overrides token.json)`);
   out.push(`  ${import_picocolors41.default.dim("BRAINBASE_SKIP_AUTH")}    bypass the auth gate for development`);
   out.push(`  ${import_picocolors41.default.dim("BRAINBASE_NON_INTERACTIVE")} force non-interactive mode — skip/auto-default prompts (CI & agents)`);
+  out.push(`  ${import_picocolors41.default.dim("BRAINBASE_RUN_ENTRYPOINT")} =1 → agent pull executes the agent entrypoint (sandbox boots; or pass --run-entrypoint)`);
   out.push("");
   out.push(divider("HARNESSES"));
   out.push("");
@@ -56950,6 +56978,7 @@ async function main() {
   const noTracking = hasFlag2(argv, "--no-tracking");
   const track = hasFlag2(argv, "--track");
   const forceFlag = hasFlag2(argv, "--force");
+  const runEntrypointFlag = hasFlag2(argv, "--run-entrypoint");
   const graphOnlyFlag = hasFlag2(argv, "--graph-only");
   const nameFlag = getFlag(argv, "--name");
   const skillVersionFlag = getFlag(argv, "--skill-version");
@@ -57041,7 +57070,8 @@ async function main() {
           teamId: teamIdFlag,
           noTracking,
           track,
-          force: forceFlag
+          force: forceFlag,
+          runEntrypoint: runEntrypointFlag
         });
         break;
       }

package/package.json

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