@brainbase-labs/cli 0.62.0 → 0.63.0

package/dist/index.js

@@ -36091,7 +36091,7 @@ function padStart(s, n) {
 // package.json
 var package_default = {
   name: "@brainbase-labs/cli",
-  version: "0.62.0",
+  version: "0.63.0",
   description: "Pack, share, and install agent templates across harnesses (Claude Code, Codex, ...).",
   type: "module",
   bin: {
@@ -56387,6 +56387,13 @@ async function linkRequest(pathname, init, unsupported) {
     throw err;
   }
 }
+function parseAgentSecretsBody(body) {
+  const secrets = body && typeof body === "object" ? body.secrets : undefined;
+  if (!secrets || typeof secrets !== "object" || Array.isArray(secrets) || !Object.values(secrets).every((value) => typeof value === "string")) {
+    throw new ApiError("The control plane returned an unreadable secrets response", undefined);
+  }
+  return { secrets };
+}
 var api = {
   listOrgs() {
     return request("/orgs");
@@ -56503,11 +56510,7 @@ var api = {
   },
   async getAgentSecrets(agentId) {
     const body = await request(`/agents/${encodeURIComponent(agentId)}/secrets`);
-    const secrets = body && typeof body === "object" ? body.secrets : undefined;
-    if (!secrets || typeof secrets !== "object" || Array.isArray(secrets) || !Object.values(secrets).every((value) => typeof value === "string")) {
-      throw new ApiError("The control plane returned an unreadable secrets response", undefined);
-    }
-    return { secrets };
+    return parseAgentSecretsBody(body);
   },
   putAgentSecrets(agentId, secrets, options) {
     const { idempotent = false, ...transport } = options ?? {};
@@ -67919,6 +67922,61 @@ async function pickHarness(current) {
   });
 }
 
+// src/core/pull-bundle.ts
+import { gunzipSync } from "node:zlib";
+var PULL_BUNDLE_ENV = "BRAINBASE_PULL_BUNDLE";
+var PULL_BUNDLE_VERSION = 1;
+var PULL_BUNDLE_MAX_AGE_S = 120;
+var PULL_BUNDLE_MAX_SKEW_S = 60;
+function isObject2(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function isUsableComponent(component) {
+  return isObject2(component) && typeof component.type === "string" && typeof component.slug === "string" && Array.isArray(component.files) && component.files.every((file) => isObject2(file) && typeof file.path === "string" && typeof file.content === "string");
+}
+function takePullBundle(agentId) {
+  const raw = process.env[PULL_BUNDLE_ENV];
+  delete process.env[PULL_BUNDLE_ENV];
+  if (!raw)
+    return { status: "absent" };
+  let parsed;
+  try {
+    parsed = JSON.parse(gunzipSync(Buffer.from(raw, "base64")).toString("utf8"));
+  } catch {
+    return { status: "unusable", reason: "undecodable" };
+  }
+  if (!isObject2(parsed) || parsed.v !== PULL_BUNDLE_VERSION) {
+    return { status: "unusable", reason: "version" };
+  }
+  if (parsed.agent_id !== agentId)
+    return { status: "unusable", reason: "agent" };
+  const nowS = Date.now() / 1000;
+  if (typeof parsed.issued_at !== "number" || nowS - parsed.issued_at > PULL_BUNDLE_MAX_AGE_S || parsed.issued_at - nowS > PULL_BUNDLE_MAX_SKEW_S) {
+    return { status: "unusable", reason: "stale" };
+  }
+  const { agent, manifest } = parsed;
+  if (!isObject2(agent) || agent.id !== agentId) {
+    return { status: "unusable", reason: "agent body" };
+  }
+  if (!isObject2(manifest) || manifest.agent_id !== agentId || typeof manifest.revision !== "number" || !Array.isArray(manifest.components) || !manifest.components.every(isUsableComponent)) {
+    return { status: "unusable", reason: "manifest body" };
+  }
+  let secrets;
+  try {
+    secrets = parseAgentSecretsBody(parsed.secrets);
+  } catch {
+    return { status: "unusable", reason: "secrets body" };
+  }
+  return {
+    status: "ok",
+    bundle: {
+      agent: withCloudRuntimeMode(agent),
+      manifest,
+      secrets
+    }
+  };
+}
+
 // src/cli/agent-pull.ts
 async function runAgentPull(cwd2, args) {
   banner("agent pull — bring cloud changes into this folder");
@@ -67927,11 +67985,16 @@ async function runAgentPull(cwd2, args) {
     return;
   const { agentId, override } = resolution;
   let { existingManifest, lock, localComponents } = readLocalPullState(cwd2, override);
+  const handed = takePullBundle(agentId);
+  if (handed.status === "unusable") {
+    f2.info(`Pull bundle not used (${handed.reason}); fetching from the cloud.`);
+  }
+  const bundle = handed.status === "ok" ? handed.bundle : undefined;
   const sp = spinner();
-  sp.start("Fetching agent…");
-  const agentRequest = inFlight(api.getAgent(agentId));
-  const manifestRequest = inFlight(api.getAgentManifest(agentId));
-  const secretsRequest = pullReachesSecrets(args, existingManifest, lock, localComponents) ? inFlight(api.getAgentSecrets(agentId)) : undefined;
+  sp.start(bundle ? "Reading agent from the boot bundle…" : "Fetching agent…");
+  const agentRequest = inFlight(bundle ? Promise.resolve(bundle.agent) : api.getAgent(agentId));
+  const manifestRequest = inFlight(bundle ? Promise.resolve(bundle.manifest) : api.getAgentManifest(agentId));
+  const secretsRequest = bundle ? Promise.resolve(bundle.secrets) : pullReachesSecrets(args, existingManifest, lock, localComponents) ? inFlight(api.getAgentSecrets(agentId)) : undefined;
   let cloudAgent;
   let cloud;
   try {
@@ -73494,7 +73557,7 @@ __export(exports_util, {
   joinValues: () => joinValues,
   issue: () => issue,
   isPlainObject: () => isPlainObject2,
-  isObject: () => isObject2,
+  isObject: () => isObject3,
   getSizableOrigin: () => getSizableOrigin,
   getParsedType: () => getParsedType2,
   getLengthableOrigin: () => getLengthableOrigin,
@@ -73632,7 +73695,7 @@ function esc(str2) {
   return JSON.stringify(str2);
 }
 var captureStackTrace = Error.captureStackTrace ? Error.captureStackTrace : (..._args) => {};
-function isObject2(data) {
+function isObject3(data) {
   return typeof data === "object" && data !== null && !Array.isArray(data);
 }
 var allowsEval = cached(() => {
@@ -73648,13 +73711,13 @@ var allowsEval = cached(() => {
   }
 });
 function isPlainObject2(o2) {
-  if (isObject2(o2) === false)
+  if (isObject3(o2) === false)
     return false;
   const ctor = o2.constructor;
   if (ctor === undefined)
     return true;
   const prot = ctor.prototype;
-  if (isObject2(prot) === false)
+  if (isObject3(prot) === false)
     return false;
   if (Object.prototype.hasOwnProperty.call(prot, "isPrototypeOf") === false) {
     return false;
@@ -75255,7 +75318,7 @@ var $ZodObject = /* @__PURE__ */ $constructor("$ZodObject", (inst, def) => {
     return (payload, ctx) => fn(shape, payload, ctx);
   };
   let fastpass;
-  const isObject3 = isObject2;
+  const isObject4 = isObject3;
   const jit = !globalConfig.jitless;
   const allowsEval2 = allowsEval;
   const fastEnabled = jit && allowsEval2.value;
@@ -75264,7 +75327,7 @@ var $ZodObject = /* @__PURE__ */ $constructor("$ZodObject", (inst, def) => {
   inst._zod.parse = (payload, ctx) => {
     value ?? (value = _normalized.value);
     const input = payload.value;
-    if (!isObject3(input)) {
+    if (!isObject4(input)) {
       payload.issues.push({
         expected: "object",
         code: "invalid_type",
@@ -75423,7 +75486,7 @@ var $ZodDiscriminatedUnion = /* @__PURE__ */ $constructor("$ZodDiscriminatedUnio
   });
   inst._zod.parse = (payload, ctx) => {
     const input = payload.value;
-    if (!isObject2(input)) {
+    if (!isObject3(input)) {
       payload.issues.push({
         code: "invalid_type",
         expected: "object",

package/package.json

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