@brainbase-labs/cli 0.52.0 → 0.53.0

package/dist/index.js

@@ -36091,7 +36091,7 @@ function padStart(s, n) {
 // package.json
 var package_default = {
   name: "@brainbase-labs/cli",
-  version: "0.52.0",
+  version: "0.53.0",
   description: "Pack, share, and install agent templates across harnesses (Claude Code, Codex, ...).",
   type: "module",
   bin: {
@@ -67885,9 +67885,6 @@ function automationErrorEnvelope(command, error) {
   };
 }
 
-// src/core/interfaces-api.ts
-import { randomUUID as randomUUID2 } from "node:crypto";
-
 // src/core/fastapi-detail.ts
 function record(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : null;
@@ -67900,6 +67897,9 @@ function rejectsBodyField(body, field) {
   return fastApiDetails(body).some((entry) => entry.type === "extra_forbidden" && Array.isArray(entry.loc) && entry.loc[0] === "body" && entry.loc[1] === field);
 }
 
+// src/core/interfaces-api.ts
+import { randomUUID as randomUUID2 } from "node:crypto";
+
 // src/ui/terminal-safe.ts
 function sanitizeLabel(s3) {
   return s3.replace(/\u001b\][\s\S]*?(?:\u0007|\u001b\\|$)/g, "").replace(/\u001b\[[\u0030-\u003f]*[\u0020-\u002f]*[\u0040-\u007e]?/g, "").replace(/\u001b[\s\S]?/g, "").replace(/[\u0000-\u001f\u007f-\u009f\u2028\u2029]/g, "");
@@ -68450,6 +68450,7 @@ var REASONS = {
   "versioning is paused": "versioning_paused",
   "restore already in progress": "restore_in_progress"
 };
+var PIN_CONFLICTS = new Set(["pin_changed", "not_pinned"]);
 function sentence(value) {
   const trimmed = value.trim();
   const capital = trimmed.charAt(0).toUpperCase() + trimmed.slice(1);
@@ -68474,7 +68475,9 @@ function toVersionsError(error, agentId) {
   const detail = record2(body?.detail);
   const serverText = text2(body?.detail) ?? text2(detail?.message) ?? text2(body?.error);
   const said = clean(serverText ?? error.message);
-  const reason = serverText ? REASONS[serverText.toLowerCase()] ?? null : null;
+  const detailCode = text2(detail?.code);
+  const pinReason = status === 409 && detailCode && PIN_CONFLICTS.has(detailCode) ? detailCode : null;
+  const reason = pinReason ?? (serverText ? REASONS[serverText.toLowerCase()] ?? null : null);
   const details = {
     status,
     retry_after: retrySeconds(error.retryAfter),
@@ -68510,7 +68513,7 @@ function toVersionsError(error, agentId) {
       break;
     case 409:
       code = "conflict";
-      message = reason === "versioning_paused" ? "Versioning is paused on Brainbase, so nothing was changed. Try again later." : reason === "restore_in_progress" ? "A restore of this agent is already running. Wait for it to finish, then check `brainbase agent versions list`." : sentence(said);
+      message = reason === "versioning_paused" ? "Versioning is paused on Brainbase, so nothing was changed. Try again later." : reason === "restore_in_progress" ? "A restore of this agent is already running. Wait for it to finish, then check `brainbase agent versions list`." : reason === "pin_changed" ? `Someone changed this agent's pin after it was read, so nothing was changed. Run \`brainbase agent versions list --agent ${sanitizeLabel(agentId)}\` to see the pin now, then try again.` : reason === "not_pinned" ? "The agent is not pinned, so there was nothing to unpin." : sentence(said);
       break;
     case 502:
       if (details.sections?.some((section) => section.error !== null)) {
@@ -68638,11 +68641,21 @@ var agentVersionsApi = {
       throw new AgentVersionsError("No answer came back from the restore in time, so whether it happened is unknown. " + `Run \`brainbase agent versions list --agent ${sanitizeLabel(agentId)}\` and look for a new rollback version before trying again.`, "outcome_unknown", null, NO_DETAILS);
     }
   },
-  pin(agentId, versionId) {
-    return write2(agentId, pinPath(agentId), "PUT", { version_id: versionId });
+  async pin(agentId, versionId, currentPinId) {
+    try {
+      return await write2(agentId, pinPath(agentId), "PUT", {
+        version_id: versionId,
+        expected_version_id: currentPinId
+      });
+    } catch (error) {
+      if (!(error instanceof ApiError && error.status === 422 && rejectsBodyField(error.body, "expected_version_id"))) {
+        throw error;
+      }
+      return write2(agentId, pinPath(agentId), "PUT", { version_id: versionId });
+    }
   },
-  unpin(agentId) {
-    return write2(agentId, pinPath(agentId), "DELETE");
+  unpin(agentId, pinnedVersionId) {
+    return write2(agentId, `${pinPath(agentId)}${masListQuery({ expected_version_id: pinnedVersionId })}`, "DELETE");
   }
 };
 
@@ -81814,6 +81827,7 @@ function renderLines(lines, indent) {
 var import_picocolors46 = __toESM(require_picocolors(), 1);
 var PIN_NOTE = "New tasks will run this version's instructions, entrypoint, installed skills, tools, playbooks, harness and default model. " + "Secrets, credentials, machine settings, permission rules, connections and skill contents always stay current. " + "Tasks already running keep the version they started with.";
 var UNPIN_NOTE = "New tasks will run the agent's current configuration again. Tasks already running keep the version they started with.";
+var NOT_PINNED_NOTE = "This agent is not pinned, so nothing changed.";
 var PULL_NOTE = "This folder is now behind the cloud. Run `brainbase agent pull` to bring it up to date.";
 function pinnedNote(pin) {
   return `This agent is pinned to ${pinName(pin)}, so new tasks keep running that version, not the restored configuration, until you run \`brainbase agent versions unpin\`.`;
@@ -81995,18 +82009,18 @@ async function pin(ctx) {
     const agentId = resolveAgentId(ctx.cwd, parsed);
     const action = `Pinning agent ${sanitizeLabel(agentId)} to ${sanitizeLabel(ref)}`;
     requireConsentPossible(yes, json3, action, ctx.deps);
-    const { version: version2, capturePending } = await agentVersionsApi.resolve(agentId, ref);
+    const { version: version2, pin: current, capturePending } = await agentVersionsApi.resolve(agentId, ref);
     const accepted = await confirmChange({
       yes,
       json: json3,
       action,
-      consequence: PIN_NOTE,
+      consequence: current ? `${PIN_NOTE} It is pinned to ${pinName(current)} now.` : PIN_NOTE,
       question: `Pin the agent to ${versionName(version2)}?`,
       deps: ctx.deps
     });
     if (!accepted)
       return;
-    const result2 = await agentVersionsApi.pin(agentId, version2.id);
+    const result2 = await agentVersionsApi.pin(agentId, version2.id, current?.version_id ?? null);
     const notes = [...pendingNotes(capturePending), PIN_NOTE];
     if (json3) {
       printJson({ ...result2, notes });
@@ -82018,6 +82032,24 @@ async function pin(ctx) {
     printNotes(notes);
   });
 }
+function printNotPinned(json3) {
+  if (json3) {
+    printJson({ pinned_version_id: null, pinned_at: null, pinned_by: null, changed: false, notes: [NOT_PINNED_NOTE] });
+    return;
+  }
+  console.log(`
+  ${NOT_PINNED_NOTE}
+`);
+}
+async function unpinIfStill(agentId, versionId) {
+  try {
+    return await agentVersionsApi.unpin(agentId, versionId);
+  } catch (error2) {
+    if (error2 instanceof AgentVersionsError && error2.reason === "not_pinned")
+      return null;
+    throw error2;
+  }
+}
 async function unpin(ctx) {
   let json3 = wantsJson(ctx.args);
   await runReportingErrors(() => json3, async () => {
@@ -82028,24 +82060,33 @@ async function unpin(ctx) {
     const agentId = resolveAgentId(ctx.cwd, parsed);
     const action = `Unpinning agent ${sanitizeLabel(agentId)}`;
     requireConsentPossible(yes, json3, action, ctx.deps);
+    const { pin: current } = await agentVersionsApi.latest(agentId);
+    if (!current) {
+      printNotPinned(json3);
+      return;
+    }
     const accepted = await confirmChange({
       yes,
       json: json3,
       action,
       consequence: UNPIN_NOTE,
-      question: "Unpin the agent?",
+      question: `Unpin the agent from ${pinName(current)}?`,
       deps: ctx.deps
     });
     if (!accepted)
       return;
-    const result2 = await agentVersionsApi.unpin(agentId);
+    const result2 = await unpinIfStill(agentId, current.version_id);
+    if (!result2) {
+      printNotPinned(json3);
+      return;
+    }
     const notes = [UNPIN_NOTE];
     if (json3) {
-      printJson({ ...result2, notes });
+      printJson({ ...result2, changed: true, notes });
       return;
     }
     console.log(`
-  ${import_picocolors46.default.green("✓")} Unpinned
+  ${import_picocolors46.default.green("✓")} Unpinned from ${pinName(current)}
 `);
     printNotes(notes);
   });

package/package.json

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