@brainbase-labs/cli 0.11.0 → 0.13.0

package/dist/index.js

@@ -29449,7 +29449,7 @@ function padStart(s, n) {
 // package.json
 var package_default = {
   name: "@brainbase-labs/cli",
-  version: "0.11.0",
+  version: "0.13.0",
   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;
 }
@@ -51126,8 +51152,10 @@ var PlaybookContentSchema = exports_external.object({
   message: "playbook content must set either `file` or `text`"
 });
 var PlaybookSchema = exports_external.object({
+  id: exports_external.string().optional(),
   title: exports_external.string().min(1),
   description: exports_external.string().optional(),
+  icon: exports_external.string().optional(),
   content: PlaybookContentSchema
 });
 var SkillEntrySchema = exports_external.object({
@@ -51145,7 +51173,8 @@ var McpEntrySchema = exports_external.object({
 var CapabilitiesSchema = exports_external.object({
   memory: exports_external.boolean().optional(),
   browser: exports_external.boolean().optional(),
-  slack: exports_external.boolean().optional()
+  slack: exports_external.boolean().optional(),
+  meeting: exports_external.boolean().optional()
 });
 var AgentManifestSchema = exports_external.object({
   schema: exports_external.literal(1),
@@ -51252,7 +51281,38 @@ function resolvePlaybookContent(cwd2, entry) {
   return null;
 }
 function slugifyPlaybookTitle(title) {
-  return title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 60) || "playbook";
+  return title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 60).replace(/^-+|-+$/g, "") || "playbook";
+}
+function playbookYamlScalar(value) {
+  const safe = value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"").replace(/\n/g, " ").trim();
+  return `"${safe}"`;
+}
+function assemblePlaybookWireBody(entry, body) {
+  const lines = ["---", `title: ${playbookYamlScalar(entry.title)}`];
+  if (entry.description) {
+    lines.push(`description: ${playbookYamlScalar(entry.description)}`);
+  }
+  if (entry.icon) {
+    lines.push(`icon: ${playbookYamlScalar(entry.icon)}`);
+  }
+  lines.push("---", "", "");
+  return lines.join(`
+`) + body.replace(/^\n+/, "").trimEnd() + `
+`;
+}
+function assignPlaybookSlugs(titles) {
+  const used = new Set;
+  return titles.map((t) => {
+    const base2 = slugifyPlaybookTitle(t);
+    let slug = base2;
+    let n = 1;
+    while (used.has(slug)) {
+      n += 1;
+      slug = `${base2}-${n}`;
+    }
+    used.add(slug);
+    return slug;
+  });
 }
 
 // src/core/link.ts
@@ -51301,7 +51361,7 @@ var SyncedComponentSchema = exports_external.object({
 });
 var AgentMetaSnapshotSchema = exports_external.object({
   name: exports_external.string(),
-  tagline: exports_external.string().optional(),
+  tagline: exports_external.string().nullish().transform((v3) => v3 ?? undefined),
   entrypoint: exports_external.string().optional()
 });
 var SyncStateSchema = exports_external.object({
@@ -52043,6 +52103,39 @@ function buildSlackMcpComponent(scope) {
   };
 }
 
+// src/core/meeting-mcp.ts
+var DEFAULT_MEETING_MCP_BASE = "https://meeting.mcp.brainbaselabs.com";
+var MEETING_MCP_SLUG = "brainbase-meeting";
+function meetingMcpBaseUrl() {
+  const envOverride = process.env.BRAINBASE_MEETING_MCP_URL;
+  if (envOverride)
+    return envOverride.replace(/\/+$/, "");
+  return DEFAULT_MEETING_MCP_BASE;
+}
+function meetingMcpUrl() {
+  return `${meetingMcpBaseUrl()}/t/\${BRAINBASE_THREAD_ID}/mcp`;
+}
+function meetingMcpPayload() {
+  return {
+    url: meetingMcpUrl(),
+    headers: {
+      Authorization: "Bearer ${BRAINBASE_TOKEN}"
+    }
+  };
+}
+function buildMeetingMcpComponent(scope) {
+  return {
+    type: "mcp",
+    slug: MEETING_MCP_SLUG,
+    scope,
+    rootDir: "",
+    description: "This agent's Meeting connector (join calls, read transcripts, manage " + "recordings and notes). Scoped to this agent only.",
+    meta: { mcp: meetingMcpPayload() },
+    payload: meetingMcpPayload(),
+    checksum: "builtin:brainbase-meeting:v1"
+  };
+}
+
 // src/core/browser-mcp.ts
 var DEFAULT_BROWSER_MCP_BASE = "https://brainbase-browser-mcp.onrender.com";
 var BROWSER_MCP_SLUG = "brainbase-browser";
@@ -52081,7 +52174,8 @@ function capabilitiesFromAgent(agent) {
   return {
     memory: agent.memory_enabled !== false,
     browser: agent.browser_enabled !== false,
-    slack: agent.slack_connected === true
+    slack: agent.slack_connected === true,
+    meeting: agent.meeting_connected === true
   };
 }
 function capabilitiesFromManifest(manifest) {
@@ -52089,7 +52183,8 @@ function capabilitiesFromManifest(manifest) {
   return {
     memory: c2.memory !== false,
     browser: c2.browser !== false,
-    slack: c2.slack === true
+    slack: c2.slack === true,
+    meeting: c2.meeting === true
   };
 }
 function resolveBuiltinMcps(input) {
@@ -52098,7 +52193,8 @@ function resolveBuiltinMcps(input) {
     { slug: ORCHESTRATION_MCP_SLUG, enabled: true, build: buildOrchestrationMcpComponent },
     { slug: MEMORY_MCP_SLUG, enabled: caps.memory, build: buildMemoryMcpComponent },
     { slug: BROWSER_MCP_SLUG, enabled: caps.browser, build: buildBrowserMcpComponent },
-    { slug: SLACK_MCP_SLUG, enabled: caps.slack, build: buildSlackMcpComponent }
+    { slug: SLACK_MCP_SLUG, enabled: caps.slack, build: buildSlackMcpComponent },
+    { slug: MEETING_MCP_SLUG, enabled: caps.meeting, build: buildMeetingMcpComponent }
   ];
   const install = [];
   const removeSlugs = [];
@@ -52578,34 +52674,25 @@ function readLocalComponents(cwd2, manifest) {
       hash: hashMcpEntry(entry)
     });
   }
-  for (const entry of manifest.playbooks ?? []) {
+  const pbEntries = manifest.playbooks ?? [];
+  const pbSlugs = assignPlaybookSlugs(pbEntries.map((e2) => e2.title));
+  for (let i = 0;i < pbEntries.length; i++) {
+    const entry = pbEntries[i];
+    const slug = pbSlugs[i];
     const body = resolvePlaybookContent(cwd2, entry);
     if (body === null) {
-      out.push({
-        type: "playbook",
-        slug: slugifyPlaybookTitle(entry.title),
-        hash: null
-      });
+      out.push({ type: "playbook", slug, hash: null });
       continue;
     }
-    const wireBody = /^---\s*\n/.test(body) ? body : `---
-title: ${jsonOrPlain(entry.title)}` + (entry.description ? `
-description: ${jsonOrPlain(entry.description)}` : "") + `
----
-${body.replace(/^\n+/, "")}`;
+    const wireBody = assemblePlaybookWireBody(entry, body);
     out.push({
       type: "playbook",
-      slug: slugifyPlaybookTitle(entry.title),
+      slug,
       hash: componentHashFromFileHashes([hashString(wireBody)])
     });
   }
   return out;
 }
-function jsonOrPlain(s3) {
-  if (!/[\n":#&*!|>'%@`{}[\]]/.test(s3) && s3.trim() === s3 && s3 !== "")
-    return s3;
-  return JSON.stringify(s3);
-}
 function threeWayDiff(input) {
   const lockMap = new Map;
   for (const c2 of input.lock)
@@ -53128,7 +53215,7 @@ function materializePlaybooks(cwd2, cloud, toInstall, keepLocal, existingManifes
     if (!raw.trim())
       continue;
     const { body } = stripFrontmatter(raw);
-    const existing = existingManifest?.playbooks?.find((p2) => slugifyForCompare(p2.title) === c2.slug);
+    const existing = existingManifest?.playbooks?.find((p2) => slugifyPlaybookTitle(p2.title) === c2.slug);
     if (existing?.content?.text !== undefined)
       continue;
     const targetRel = existing?.content?.file ?? path48.join(DEFAULT_PLAYBOOKS_DIR, `${c2.slug}.md`);
@@ -53137,9 +53224,6 @@ function materializePlaybooks(cwd2, cloud, toInstall, keepLocal, existingManifes
     fs45.writeFileSync(target, body, "utf8");
   }
 }
-function slugifyForCompare(s3) {
-  return s3.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 60) || "playbook";
-}
 function stripFrontmatter(raw) {
   const m3 = /^---\s*\n([\s\S]*?)\n---\s*\n?/.exec(raw);
   if (!m3)
@@ -53192,15 +53276,18 @@ function mergeManifest(cwd2, prev, cloud, cloudAgent, harness) {
   const playbooks = cloud.components.filter((c2) => c2.type === "playbook").map((c2) => {
     const raw = c2.files[0]?.content ?? "";
     const { frontmatter } = stripFrontmatter(raw);
-    const local = prev?.playbooks?.find((pb) => slugifyForCompare(pb.title) === c2.slug);
+    const local = prev?.playbooks?.find((pb) => slugifyPlaybookTitle(pb.title) === c2.slug);
     const title = local?.title ?? (typeof frontmatter.title === "string" && frontmatter.title || c2.slug);
     const description = local?.description ?? (typeof frontmatter.description === "string" ? frontmatter.description : undefined);
     const content = local?.content?.text !== undefined ? { text: local.content.text } : {
       file: local?.content?.file ?? path48.join(DEFAULT_PLAYBOOKS_DIR, `${c2.slug}.md`)
     };
+    const pbMeta = c2.meta ?? {};
     return {
+      ...typeof pbMeta.playbook_id === "string" && pbMeta.playbook_id ? { id: pbMeta.playbook_id } : {},
       title,
       ...description ? { description } : {},
+      ...typeof pbMeta.icon === "string" && pbMeta.icon ? { icon: pbMeta.icon } : {},
       content
     };
   });
@@ -53235,7 +53322,12 @@ function mergeManifest(cwd2, prev, cloud, cloudAgent, harness) {
     playbooks,
     skills,
     mcp,
-    capabilities: { memory: caps.memory, browser: caps.browser, slack: caps.slack }
+    capabilities: {
+      memory: caps.memory,
+      browser: caps.browser,
+      slack: caps.slack,
+      meeting: caps.meeting
+    }
   };
 }
 function materializeEntrypoint(cwd2, cloudEntrypoint, prev) {
@@ -53489,8 +53581,11 @@ async function buildOutgoingComponents(cwd2, manifest, cloud, resolvedVersions)
       }
     });
   }
-  const seenPlaybookSlugs = new Set;
-  for (const entry of manifest.playbooks ?? []) {
+  const playbookEntries = manifest.playbooks ?? [];
+  const playbookSlugs = assignPlaybookSlugs(playbookEntries.map((e2) => e2.title));
+  for (let i = 0;i < playbookEntries.length; i++) {
+    const entry = playbookEntries[i];
+    const slug = playbookSlugs[i];
     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;
@@ -53504,24 +53599,25 @@ async function buildOutgoingComponents(cwd2, manifest, cloud, resolvedVersions)
       }
       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 wireBody = assemblePlaybookWireBody(entry, body);
     const fileName = `${slug}.md`;
     const fileHash2 = hashString(wireBody);
+    const file = {
+      path: fileName,
+      content: wireBody,
+      hash: fileHash2
+    };
     out.push({
       type: "playbook",
       slug,
       description: entry.description,
       hash: componentHashFromFileHashes([fileHash2]),
-      files: [{ path: fileName, content: wireBody, hash: fileHash2 }],
+      files: [file],
       meta: {
         title: entry.title,
-        ...entry.description ? { description: entry.description } : {}
+        ...entry.description ? { description: entry.description } : {},
+        ...entry.icon ? { icon: entry.icon } : {},
+        ...entry.id ? { playbook_id: entry.id } : {}
       }
     });
   }
@@ -53552,23 +53648,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) {
@@ -53664,29 +53743,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) {
@@ -53723,7 +53829,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;
     }
   }
@@ -53739,6 +53845,17 @@ async function runAgentPush(cwd2, args) {
       return;
     }
   }
+  const localPlaybooks = manifest.playbooks ?? [];
+  const localPlaybookSlugs = assignPlaybookSlugs(localPlaybooks.map((entry) => entry.title));
+  const idlessLocalSlugs = new Set(localPlaybooks.flatMap((entry, i) => entry.id ? [] : [localPlaybookSlugs[i]]));
+  const preIdSchemaSlugs = cloud.components.filter((c2) => c2.type === "playbook").filter((c2) => {
+    const id = c2.meta?.playbook_id;
+    return typeof id === "string" && id && !localPlaybooks.some((p2) => p2.id === id) && idlessLocalSlugs.has(c2.slug);
+  }).map((c2) => c2.slug);
+  if (preIdSchemaSlugs.length > 0) {
+    f2.error(`Playbook ${preIdSchemaSlugs.length === 1 ? "entry" : "entries"} ${preIdSchemaSlugs.map((s3) => import_picocolors27.default.bold(s3)).join(", ")} in ${import_picocolors27.default.bold("brainbase.agent.yaml")} ${preIdSchemaSlugs.length === 1 ? "is" : "are"} missing ${import_picocolors27.default.cyan("id:")}. Run ${import_picocolors27.default.bold("brainbase agent pull")} first to sync playbook ids, then push.`);
+    return;
+  }
   const toSend = [];
   const conflicts = [];
   const upstreamOnly = [];
@@ -53851,7 +53968,8 @@ async function runAgentPush(cwd2, args) {
   try {
     updatedCloud = await api.pushAgentManifest(agentId, {
       components: outgoing,
-      base_revision: cloud.revision
+      base_revision: cloud.revision,
+      reconcile_playbooks: true
     });
     pushSpinner.stop(`Pushed. New revision ${updatedCloud.revision}.`);
   } catch (err) {
@@ -54398,7 +54516,7 @@ async function runAgentCreate(cwd2, args) {
   writeLink(cwd2, link2);
   manifest = readManifest(cwd2);
   let updatedCloud = null;
-  const hasContent = !!manifest.instructions || manifest.skills.length > 0 || (manifest.mcp ?? []).length > 0;
+  const hasContent = !!manifest.instructions || manifest.skills.length > 0 || (manifest.mcp ?? []).length > 0 || (manifest.playbooks ?? []).length > 0;
   if (hasContent) {
     const outgoing = await buildOutgoingComponents(cwd2, manifest, null);
     if (outgoing === null) {
@@ -54409,7 +54527,8 @@ async function runAgentCreate(cwd2, args) {
       try {
         updatedCloud = await api.pushAgentManifest(agent.id, {
           components: outgoing,
-          base_revision: 0
+          base_revision: 0,
+          reconcile_playbooks: true
         });
         pushSpinner.stop(`Pushed at revision ${updatedCloud.revision}.`);
       } catch (err) {
@@ -54768,14 +54887,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);
@@ -54863,7 +54982,7 @@ function printHelp() {
   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); --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("push")}               ${import_picocolors32.default.dim("send local changes to the cloud — instructions, playbooks, skills, MCPs, entrypoint")}`);
   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")}`);
   out.push(`  ${import_picocolors32.default.cyan("env")}                ${import_picocolors32.default.dim('print export statements — use with `eval "$(brainbase agent env)"`')}`);
@@ -55239,7 +55358,12 @@ function buildManifestFromCloud(cloud, agent) {
     playbooks: [],
     skills,
     mcp,
-    capabilities: { memory: caps.memory, browser: caps.browser, slack: caps.slack }
+    capabilities: {
+      memory: caps.memory,
+      browser: caps.browser,
+      slack: caps.slack,
+      meeting: caps.meeting
+    }
   };
 }
 async function pullAgentSecrets(cwd2, agentId) {
@@ -56796,7 +56920,7 @@ function help() {
   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; --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 push")}                 ${import_picocolors41.default.dim("send local changes to the cloud — instructions, playbooks, skills, MCPs, entrypoint")}`);
   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")}`);
   out.push(`  ${import_picocolors41.default.cyan("agent status")}               ${import_picocolors41.default.dim("show what would pull and what would push")}`);

package/package.json

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