busa-sdk 0.9.13 → 0.9.14

package/dist/index.d.ts

@@ -739,7 +739,7 @@ declare const cloudContract: {
         createChangeRequest: _orpc_contract.ContractProcedure<z.ZodObject<{
             message: z.ZodDefault<z.ZodOptional<z.ZodString>>;
             submittedBy: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-            autoMerge: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            autoMerge: z.ZodOptional<z.ZodBoolean>;
             operations: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"create">;
                 ref: z.ZodOptional<z.ZodString>;
@@ -4458,7 +4458,7 @@ declare const cloudContract: {
                     targetBaseSlug: z.ZodOptional<z.ZodString>;
                 }, z.core.$strip>>>>;
             }, z.core.$strip>>>;
-            autoMerge: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            autoMerge: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>, z.ZodUnion<readonly [z.ZodObject<{
             id: z.ZodString;
             nodeId: z.ZodString;
@@ -4942,7 +4942,7 @@ declare const cloudContract: {
             message: z.ZodDefault<z.ZodOptional<z.ZodString>>;
             submittedBy: z.ZodDefault<z.ZodOptional<z.ZodString>>;
             idempotencyKey: z.ZodOptional<z.ZodString>;
-            autoMerge: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            autoMerge: z.ZodOptional<z.ZodBoolean>;
             baseId: z.ZodString;
         }, z.core.$strip>, z.ZodUnion<readonly [z.ZodObject<{
             id: z.ZodString;
@@ -9810,7 +9810,7 @@ declare const cloudContract: {
                 content: z.ZodDefault<z.ZodString>;
                 mimeType: z.ZodOptional<z.ZodString>;
             }, z.core.$strict>]>>>>;
-            autoMerge: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            autoMerge: z.ZodOptional<z.ZodBoolean>;
             mergeMode: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
                 replace: "replace";
                 merge: "merge";
@@ -10724,7 +10724,7 @@ declare const cloudContract: {
                 content: z.ZodDefault<z.ZodString>;
                 mimeType: z.ZodOptional<z.ZodString>;
             }, z.core.$strict>]>>>>;
-            autoMerge: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            autoMerge: z.ZodOptional<z.ZodBoolean>;
             mergeMode: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
                 replace: "replace";
                 merge: "merge";
@@ -11674,7 +11674,7 @@ declare const cloudContract: {
                 content: z.ZodDefault<z.ZodString>;
                 mimeType: z.ZodOptional<z.ZodString>;
             }, z.core.$strict>]>>>>;
-            autoMerge: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            autoMerge: z.ZodOptional<z.ZodBoolean>;
             mergeMode: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
                 replace: "replace";
                 merge: "merge";
@@ -12579,7 +12579,7 @@ declare const cloudContract: {
             name: z.ZodString;
             description: z.ZodDefault<z.ZodOptional<z.ZodString>>;
             assetId: z.ZodString;
-            autoMerge: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            autoMerge: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>, z.ZodUnion<readonly [z.ZodObject<{
             node: z.ZodType<NodeOutput, unknown, z.core.$ZodTypeInternals<NodeOutput, unknown>>;
             asset: z.ZodObject<{
@@ -13026,7 +13026,7 @@ declare const cloudContract: {
             name: z.ZodString;
             description: z.ZodDefault<z.ZodOptional<z.ZodString>>;
             body: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-            autoMerge: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            autoMerge: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>, z.ZodUnion<readonly [z.ZodObject<{
             node: z.ZodType<NodeOutput, unknown, z.core.$ZodTypeInternals<NodeOutput, unknown>>;
             storagePrefix: z.ZodString;

package/dist/index.js

@@ -128,11 +128,11 @@ var createBaseInputSchema = z.object({
       options: fieldOptionsSchema.optional().default({})
     })
   ).default([]),
-  // Review-first by default: without `autoMerge: true`, this proposes the Base
-  // as a pending ChangeRequest (status "in_review") instead of creating it
-  // immediately. Pass `autoMerge: true` only for callers that don't need human
-  // review (seed/migration scripts, an explicit no-review agent task).
-  autoMerge: z.boolean().optional().default(false)
+  // Permission-aware default: omitted merges immediately if the actor has
+  // write access on the parent node, otherwise falls back to a pending
+  // ChangeRequest (status "in_review"). Pass explicit `autoMerge: false` to
+  // force review even with write access.
+  autoMerge: z.boolean().optional()
 });
 var createBaseFieldInputSchema = z.object({
   name: fieldNameSchema,
@@ -762,8 +762,8 @@ var createNodeChangeRequestInputSchema = z.object({
     'Explanation shown to the human reviewer. Write a conventional-commit style subject \u2014 imperative verb + what + why, e.g. "Reorganize marketing docs under a Campaigns folder".'
   ),
   submittedBy: z.string().optional().default("local-producer"),
-  autoMerge: z.boolean().optional().default(false).describe(
-    "Whether to approve and merge this structural node change immediately. Defaults to false so node Change Request creation is review-first unless explicitly requested."
+  autoMerge: z.boolean().optional().describe(
+    "Whether to approve and merge this structural node change immediately. Omitted defaults to merging immediately if the actor has write access on every target node, otherwise falling back to a pending Change Request; pass explicit false to force review even with write access."
   ),
   operations: z.array(nodeOperationInputSchema).min(1)
 });
@@ -936,11 +936,11 @@ var createFileTreeInputSchema = z.object({
   visibility: z.enum(["private", "workspace", "public"]).optional().default("private"),
   version: z.string().optional().default("0.1.0"),
   files: z.array(z.union([assetFileInputSchema, textFileInputSchema])).optional().default([]),
-  // Review-first by default: without `autoMerge: true`, this proposes the node
-  // as a pending ChangeRequest (status "in_review") instead of creating it
-  // immediately. Pass `autoMerge: true` only for callers that don't need human
-  // review (seed/migration scripts, an explicit no-review agent task).
-  autoMerge: z.boolean().optional().default(false),
+  // Permission-aware default: omitted merges immediately if the actor has
+  // write access on the parent node, otherwise falls back to a pending
+  // ChangeRequest (status "in_review"). Pass explicit `autoMerge: false` to
+  // force review even with write access.
+  autoMerge: z.boolean().optional(),
   // "merge" (default): `files` is layered on top of the config's default seed
   // files by path — a caller supplying just a couple of extra files (e.g. a
   // Skill's own reference doc) still gets the default scaffold (SKILL.md,
@@ -1540,12 +1540,14 @@ var createChangeRequestInputSchema = z.object({
   idempotencyKey: z.string().optional().describe(
     "Optional client-supplied key that dedupes retries. Scoped per base + submitter: calling this endpoint again with the SAME idempotencyKey (e.g. after a timeout or a 5xx where you couldn't tell if the first call succeeded) returns the change request created by the first call instead of creating a duplicate. Omit for normal one-shot calls; only set it when you might retry."
   ),
-  // Review-first by default: without `autoMerge: true`, this proposes the record
-  // as a pending ChangeRequest (status "in_review") instead of creating it
-  // immediately. Pass `autoMerge: true` only for callers that don't need human
-  // review — approves and merges the change request right away, returning the
-  // materialized record instead of the pending ChangeRequest.
-  autoMerge: z.boolean().optional().default(false)
+  // Permission-aware default: omitted merges immediately if the actor has
+  // write access on the Base's node, otherwise falls back to a pending
+  // ChangeRequest (status "in_review"). Pass explicit `autoMerge: false` to
+  // force review even with write access; `autoMerge: true` approves and
+  // merges right away, returning the materialized record instead of the
+  // pending ChangeRequest (gracefully falls back to a pending CR if the
+  // actor doesn't actually have write access).
+  autoMerge: z.boolean().optional()
 });
 var createBulkChangeRequestInputSchema = z.object({
   records: z.array(z.record(z.string(), z.unknown())).min(1).max(1e3).describe(
@@ -1863,11 +1865,11 @@ var createDocInputSchema = z.object({
   name: z.string().min(1),
   description: z.string().optional().default(""),
   body: z.string().optional().default(""),
-  // Review-first by default: without `autoMerge: true`, this proposes the Doc
-  // as a pending ChangeRequest (status "in_review") instead of creating it
-  // immediately. Pass `autoMerge: true` only for callers that don't need human
-  // review (seed/migration scripts, an explicit no-review agent task).
-  autoMerge: z.boolean().optional().default(false)
+  // Permission-aware default: omitted merges immediately if the actor has
+  // write access on the parent node, otherwise falls back to a pending
+  // ChangeRequest (status "in_review"). Pass explicit `autoMerge: false` to
+  // force review even with write access.
+  autoMerge: z.boolean().optional()
 });
 var updateDocInputSchema = z.object({
   body: z.string()
@@ -2073,11 +2075,11 @@ var createFileNodeInputSchema = z.object({
   name: z.string().min(1),
   description: z.string().optional().default(""),
   assetId: z.string().min(1),
-  // Review-first by default: without `autoMerge: true`, this proposes the File
-  // node as a pending ChangeRequest (status "in_review") instead of creating it
-  // immediately. Pass `autoMerge: true` only for callers that don't need human
-  // review (seed/migration scripts, an explicit no-review agent task).
-  autoMerge: z.boolean().optional().default(false)
+  // Permission-aware default: omitted merges immediately if the actor has
+  // write access on the parent node, otherwise falls back to a pending
+  // ChangeRequest (status "in_review"). Pass explicit `autoMerge: false` to
+  // force review even with write access.
+  autoMerge: z.boolean().optional()
 });
 var fileContract = {
   list: oc.route({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "busa-sdk",
-  "version": "0.9.13",
+  "version": "0.9.14",
   "description": "Typed TypeScript/JavaScript SDK for the Busabase OpenAPI REST API. Talks to a local or remote `busabase server` (or Busabase Cloud). Short-name alias for busabase-sdk.",
   "license": "MIT",
   "homepage": "https://github.com/busabase/busabase/tree/main/apps/busabase-sdk",