busa-cli 0.95.1 → 0.96.0

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { i as checkForUpdate, n as pkgVersion, r as runCli } from "./run-fBARIIox.js";
+import { i as checkForUpdate, n as pkgVersion, r as runCli } from "./run-B3hHU9aE.js";
 //#region src/flush-stdio.ts
 /**
 * Wait for stdout/stderr to reach the other side before the process is torn down.

package/dist/index.js

@@ -1,3 +1,3 @@
-import { a as render, i as checkForUpdate, n as pkgVersion, r as runCli, t as HELP } from "./run-fBARIIox.js";
+import { a as render, i as checkForUpdate, n as pkgVersion, r as runCli, t as HELP } from "./run-B3hHU9aE.js";
 import { DEFAULT_BASE_URL, createBusabaseClient, normalizeBaseUrl } from "busabase-sdk";
 export { DEFAULT_BASE_URL, HELP, checkForUpdate, createBusabaseClient, normalizeBaseUrl, pkgVersion, render, runCli };

package/dist/{run-fBARIIox.js → run-B3hHU9aE.js}

@@ -635,6 +635,7 @@ const baseFieldChangeTask = {
 	examples: [
 		"busabase-cli bases field-change-request --base-id bas_1 --operation add --slug status --name Status --field-type select",
 		"busabase-cli bases field-change-request --base-id bas_1 --operation update --field-id fld_1 --patch-json '{\"required\":true}'",
+		"busabase-cli bases field-change-request --base-id bas_1 --operation update --field-id fld_1 --patch-json '{\"help\":{\"description\":\"Actual customer acceptance date\",\"example\":\"2026-10-14\"}}'",
 		"busabase-cli bases field-change-request --base-id bas_1 --operation reorder --field-ids fld_2 --field-ids fld_1"
 	],
 	execute: async (client, input) => {
@@ -2195,7 +2196,7 @@ const nodeCreateTask = {
 				"workspace",
 				"public"
 			],
-			description: "Skill/Drive/AirApp only. Defaults to private."
+			description: "Skill/Drive/AirApp only. Omit to follow the space default and parent folder, like any other node."
 		},
 		{
 			name: "version",
@@ -6445,7 +6446,13 @@ const lookupRollupSchema = z.enum([
 	"max",
 	"concatenate"
 ]).default("values");
+/** Public, plain-text guidance. Examples are hints, never default record values. */
+const fieldHelpSchema = z.object({
+	description: z.string().max(1e3).optional(),
+	example: z.string().max(200).optional()
+});
 const fieldOptionsSchema = z.object({
+	help: fieldHelpSchema.optional(),
 	ai: z.object({
 		model: z.string().optional(),
 		prompt: z.string().optional(),
@@ -6476,7 +6483,18 @@ const fieldOptionsSchema = z.object({
 		height: z.number().int().positive().max(1200).optional(),
 		providers: z.array(z.string()).optional()
 	}).optional(),
-	formula: z.object({ expression: z.string().min(1) }).optional(),
+	formula: z.object({
+		expression: z.string().min(1),
+		format: z.enum([
+			"auto",
+			"number",
+			"currency",
+			"percent",
+			"date"
+		]).optional(),
+		precision: z.number().int().min(0).max(10).optional(),
+		currency: z.string().regex(/^[A-Z]{3}$/).optional()
+	}).optional(),
 	inverseFieldId: z.string().optional(),
 	lookup: z.object({
 		relationFieldSlug: z.string().min(1).describe("Slug of a `relation` field on THIS Base — the hop to follow."),
@@ -6566,7 +6584,9 @@ const updateFieldChangeRequestInputSchema = z.object({
 	patch: z.object({
 		name: fieldNameSchema.optional(),
 		required: z.boolean().optional(),
-		options: fieldOptionsSchema.optional(),
+		options: fieldOptionsSchema.removeDefault().optional(),
+		/** Applied against current options at merge time; null removes all guidance. */
+		help: fieldHelpSchema.nullable().optional(),
 		/**
 		* Not a patch key — rejected on purpose, and the only key here that is.
 		*
@@ -7102,7 +7122,7 @@ const changeRequestSchema = z.object({
 	sourceAttribution: sourceAttributionSchema.nullable().optional(),
 	sourceMeta: z.record(z.string(), z.unknown()),
 	reviewPolicySnapshot: z.record(z.string(), z.unknown()),
-	mergeSummary: z.record(z.string(), z.unknown()),
+	mergeSummary: z.record(z.string(), z.unknown()).describe("Filled in when the change request merges. `slugChanges` (present only when non-empty) lists items a restore brought back under a new slug because another item took the old one while they were in the Trash: `{ nodeId, nodeType, name, fromSlug, toSlug }`. Read the new slug from here instead of assuming the old one."),
 	rejectedReason: z.string().nullable(),
 	reviewedAt: z.string().nullable(),
 	mergedAt: z.string().nullable(),
@@ -7872,6 +7892,7 @@ const PackageDocFrontmatterSchema = z.object({
 * so choice ids survive and record values referencing them need no remap.
 */
 const PackageFieldOptionsSchema = z.object({
+	help: fieldHelpSchema.optional(),
 	ai: z.object({
 		model: z.string().optional(),
 		prompt: z.string().optional(),
@@ -9647,7 +9668,7 @@ const applyAgentPrompts = async (client, nodeId, node, state) => {
 	const agentPrompts = node.agentPrompts;
 	if (!agentPrompts?.length) return;
 	if (!nodeId) {
-		state.warnings.push(`"${node.slug}" installs as a change request, so its ${agentPrompts.length} agent prompt(s) were not applied. After merging it, run \`busabase-cli nodes set-agent-prompts\` for that node, or re-install with --auto-merge.`);
+		state.warnings.push(`"${node.slug}" installs as a change request, so its ${agentPrompts.length} agent prompt(s) were not applied. After merging it, run \`busabase-cli nodes set-agent-prompts\` for that node, or re-install without asking for review (drop --require-review, or leave "Send the content for review first" off).`);
 		return;
 	}
 	try {
@@ -10971,7 +10992,7 @@ const findPlanBlockers = (plan, autoMerge) => {
 		const list = plan.collisions.filter((collision) => !collision.renamedTo).map((collision) => `  • ${collision.kind} "${collision.slug}" (${collision.path})`).join("\n");
 		blockers.push(`Install would collide with content that already exists:\n${list}\n\nNothing was created. Re-run with --rename to install the colliding items under suffixed slugs (e.g. "-2"), or pick a different --into-folder.`);
 	}
-	if (plan.requiresAutoMerge && !autoMerge) blockers.push("This package's records carry relation values, and a relation stores the ids of the records it points at — which only exist once the records are merged. Installing review-first would leave every relation empty.\n\nRe-run with --auto-merge to install it (this trusts the package author: records are created immediately instead of landing as change requests you review first).");
+	if (plan.requiresAutoMerge && !autoMerge) blockers.push("This package's records carry relation values, and a relation stores the ids of the records it points at — which only exist once the records are merged. Installing review-first would leave every relation empty.\n\nInstall it without asking for review: drop --require-review, or leave \"Send the content for review first\" off in the dashboard. Records are then created immediately. A credential that can only propose changes cannot install this package; use one with write access to the space.");
 	const unsatisfiable = findUnsatisfiableRequiredFields(plan);
 	if (unsatisfiable.length > 0) blockers.push(`This package cannot satisfy its own required fields:\n${unsatisfiable.join("\n")}\n\nThe server rejects these while writing records, partway through the install. Re-export the package (export relaxes fields it cannot fill), or edit the Base definitions in the package to make them optional.`);
 	return blockers;
@@ -12243,6 +12264,11 @@ const PROCEDURE_PERMISSION_POLICY = {
 	"agents.connections.list": workspace("manage"),
 	"agents.disconnect": workspace("manage"),
 	"agents.deleteHistory": workspace("manage"),
+	"agents.routerEnrollment.grants": workspace("manage"),
+	"agents.routerEnrollment.mint": workspace("manage"),
+	"agents.routerEnrollment.status": workspace("manage"),
+	"agents.routerEnrollment.complete": workspace("manage"),
+	"agents.routerEnrollment.cancel": workspace("manage"),
 	"agents.sessions.list": workspace("manage"),
 	"agents.sessions.listPaged": workspace("manage"),
 	"agents.sessions.create": workspace("manage"),
@@ -12256,6 +12282,7 @@ const PROCEDURE_PERMISSION_POLICY = {
 	"changeRequests.listPage": node("read"),
 	"changeRequests.inboxSnapshot": node("read"),
 	"changeRequests.counts": node("read"),
+	"changeRequests.reviewCount": node("read"),
 	"changeRequests.get": node("read"),
 	"changeRequests.createPreviewLink": node("changeRequest"),
 	"records.list": node("read"),
@@ -15878,7 +15905,8 @@ manual lands as a Skill node, its nodes are stamped as belonging to that app, it
 Base slugs are prefixed with the target folder so two templates cannot collide on
 a name like "settings", and its sample rows are merged so the app is not empty
 when you open it (--no-sample-records opts out). Its AirApp code and its Skill
-still wait for your review.
+follow the same rule as other content: live if you can write, held for review
+with --require-review.
 
 If the URL is a repository that holds several packages rather than being one,
 install lists them and you pick with --skill <name>.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "busa-cli",
-  "version": "0.95.1",
+  "version": "0.96.0",
   "description": "Command-line client for the Busabase OpenAPI REST API. Talks to a local or remote `busabase server`. Short-name alias for busabase-cli.",
   "license": "MIT",
   "homepage": "https://github.com/busabase/busabase/tree/main/apps/busabase-cli",
@@ -33,7 +33,7 @@
   "dependencies": {
     "@zip.js/zip.js": "^2.8.20",
     "busabase-package": "workspace:*",
-    "busabase-sdk": "0.95.1",
+    "busabase-sdk": "0.96.0",
     "commander": "^14.0.0",
     "qrcode": "^1.5.4",
     "tar-stream": "^3.1.7",