bamboo-agents 0.1.8-dev.93.c78005c → 0.1.8-dev.94.5536fd0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/VERSION CHANGED
@@ -1 +1 @@
1
- 0.1.8-dev.93.c78005c
1
+ 0.1.8-dev.94.5536fd0
package/dist/index.js CHANGED
@@ -3037,7 +3037,7 @@ var VERSION;
3037
3037
  var init_version = __esm({
3038
3038
  "src/version.ts"() {
3039
3039
  "use strict";
3040
- VERSION = "0.1.8-dev.93.c78005c";
3040
+ VERSION = "0.1.8-dev.94.5536fd0";
3041
3041
  }
3042
3042
  });
3043
3043
 
@@ -12709,7 +12709,8 @@ var init_inbox_revise = __esm({
12709
12709
  branch: external_exports.string().optional(),
12710
12710
  repo_owner: external_exports.string().optional(),
12711
12711
  repo_name: external_exports.string().optional(),
12712
- pr_number: external_exports.number().optional()
12712
+ pr_number: external_exports.number().optional(),
12713
+ replayed: external_exports.boolean().optional()
12713
12714
  });
12714
12715
  }
12715
12716
  });
@@ -12748,22 +12749,45 @@ var init_inbox_apply_revision = __esm({
12748
12749
  committed: external_exports.literal(true),
12749
12750
  /** The PR head branch the revision landed on. */
12750
12751
  branch: external_exports.string(),
12751
- pr_number: external_exports.number()
12752
+ pr_number: external_exports.number(),
12753
+ replayed: external_exports.boolean().optional()
12752
12754
  });
12753
12755
  }
12754
12756
  });
12755
12757
 
12756
12758
  // ../../src/lib/api-contracts/cli/inbox-management.ts
12757
- var InboxOperationSchema, InboxManageOperationSchema, InboxOperationBindingSchema, common, INBOX_MANAGEMENT_BINDINGS, INBOX_EXISTING_COMMAND_BINDINGS, InboxManagementCatalogResponseSchema, InboxManagementCallSchema, InboxWorkItemSchema, InboxListReceiptSchema, InboxGetReceiptSchema, InboxEnvelopeBaseSchema, InboxOperationEnvelopeSchema;
12759
+ var InboxOperationSchema, InboxManageOperationSchema, InboxOperationBindingSchema, common, INBOX_MANAGEMENT_BINDINGS, INBOX_EXISTING_COMMAND_BINDINGS, changeCommon, CHANGE_MANAGEMENT_BINDINGS, InboxManagementCatalogResponseSchema, InboxManagementCallSchema, InboxWorkItemSchema, InboxListReceiptSchema, InboxGetReceiptSchema, InboxEnvelopeBaseSchema, UnknownMutationReceiptSchema, ChangeReadBackSchema, InboxOperationEnvelopeSchema;
12758
12760
  var init_inbox_management = __esm({
12759
12761
  "../../src/lib/api-contracts/cli/inbox-management.ts"() {
12760
12762
  init_zod();
12761
- InboxOperationSchema = external_exports.enum(["inbox.list", "inbox.get", "inbox.revise", "inbox.apply_revision"]);
12762
- InboxManageOperationSchema = external_exports.enum(["inbox.list", "inbox.get"]);
12763
+ InboxOperationSchema = external_exports.enum([
12764
+ "inbox.list",
12765
+ "inbox.get",
12766
+ "inbox.revise",
12767
+ "inbox.apply_revision",
12768
+ "change.get",
12769
+ "change.diff",
12770
+ "change.head",
12771
+ "change.approve",
12772
+ "change.decline",
12773
+ "change.revise",
12774
+ "change.apply_revision"
12775
+ ]);
12776
+ InboxManageOperationSchema = external_exports.enum([
12777
+ "inbox.list",
12778
+ "inbox.get",
12779
+ "change.get",
12780
+ "change.diff",
12781
+ "change.head",
12782
+ "change.approve",
12783
+ "change.decline",
12784
+ "change.revise",
12785
+ "change.apply_revision"
12786
+ ]);
12763
12787
  InboxOperationBindingSchema = external_exports.object({
12764
12788
  operation: InboxOperationSchema,
12765
12789
  description: external_exports.string(),
12766
- work_item_family: external_exports.literal("inbox"),
12790
+ work_item_family: external_exports.enum(["inbox", "workspace_change"]),
12767
12791
  method: external_exports.literal("POST"),
12768
12792
  path: external_exports.string().startsWith("/api/v1/"),
12769
12793
  cli_command: external_exports.string().startsWith("bamboo-agents inbox "),
@@ -12777,7 +12801,19 @@ var init_inbox_management = __esm({
12777
12801
  approval_required: external_exports.boolean(),
12778
12802
  side_effect: external_exports.string(),
12779
12803
  receipt: external_exports.string(),
12780
- receipt_type: external_exports.enum(["inbox_list_receipt_v1", "inbox_get_receipt_v1", "inbox_revise_receipt_v1", "inbox_apply_revision_receipt_v1"]),
12804
+ receipt_type: external_exports.enum([
12805
+ "inbox_list_receipt_v1",
12806
+ "inbox_get_receipt_v1",
12807
+ "inbox_revise_receipt_v1",
12808
+ "inbox_apply_revision_receipt_v1",
12809
+ "change_get_receipt_v1",
12810
+ "change_diff_receipt_v1",
12811
+ "change_head_receipt_v1",
12812
+ "change_approve_receipt_v1",
12813
+ "change_decline_receipt_v1",
12814
+ "change_revise_receipt_v1",
12815
+ "change_apply_revision_receipt_v1"
12816
+ ]),
12781
12817
  error_codes: external_exports.array(external_exports.enum([
12782
12818
  "authentication_required",
12783
12819
  "organization_scope_required",
@@ -12799,7 +12835,17 @@ var init_inbox_management = __esm({
12799
12835
  "stale_review_task",
12800
12836
  "branch_mismatch",
12801
12837
  "pr_branch_moved",
12802
- "commit_failed"
12838
+ "commit_failed",
12839
+ "merge_conflict",
12840
+ "merge_blocked",
12841
+ "github_error",
12842
+ "idempotency_conflict",
12843
+ "already_merged",
12844
+ "unknown_outcome",
12845
+ "approval_required",
12846
+ "policy_blocked",
12847
+ "decline_forbidden",
12848
+ "decline_cross_scope"
12803
12849
  ])),
12804
12850
  minimum_cli_version: external_exports.string()
12805
12851
  });
@@ -12875,6 +12921,22 @@ var init_inbox_management = __esm({
12875
12921
  error_codes: ["authentication_required", "invalid_request", "github_not_connected", "no_workspace_repo", "request_changes_forbidden", "request_changes_cross_scope", "pr_not_found", "pr_already_merged", "stale_review_task", "branch_mismatch", "pr_branch_moved", "commit_failed"]
12876
12922
  }
12877
12923
  ];
12924
+ changeCommon = {
12925
+ ...common,
12926
+ work_item_family: "workspace_change",
12927
+ description: "",
12928
+ inputs: { required: ["pr_number"], optional: ["brand_id"], server_injected: {} },
12929
+ error_codes: ["authentication_required", "organization_scope_required", "organization_scope_mismatch", "invalid_input", "pr_not_found", "github_not_connected", "no_workspace_repo", "github_error", "malformed_response"]
12930
+ };
12931
+ CHANGE_MANAGEMENT_BINDINGS = [
12932
+ { ...changeCommon, operation: "change.get", description: "Inspect one current workspace change and optionally reconcile a command", inputs: { required: ["pr_number"], optional: ["brand_id", "command_id", "command_operation"], server_injected: {} }, receipt: "current normalized change item with optional command reconciliation", receipt_type: "change_get_receipt_v1" },
12933
+ { ...changeCommon, operation: "change.diff", description: "Read the exact file diff and reviewed head SHA", receipt: "file changes with head and base SHAs", receipt_type: "change_diff_receipt_v1" },
12934
+ { ...changeCommon, operation: "change.head", description: "Re-read the current PR head SHA", receipt: "current PR head SHA", receipt_type: "change_head_receipt_v1" },
12935
+ { ...changeCommon, operation: "change.approve", description: "Approve and merge the reviewed workspace change", inputs: { required: ["pr_number", "subject_revision", "command_id", "approved", "approved_effect", "approved_reversible"], optional: ["brand_id"], server_injected: {} }, approval_required: true, side_effect: "merges the workspace pull request", receipt: "merged SHA and replay status", receipt_type: "change_approve_receipt_v1", error_codes: [...changeCommon.error_codes, "approval_required", "policy_blocked", "policy_input_failed", "merge_conflict", "merge_blocked", "stale_review_task", "idempotency_conflict", "unknown_outcome"] },
12936
+ { ...changeCommon, operation: "change.decline", description: "Decline the reviewed workspace change", inputs: { required: ["pr_number", "subject_revision", "command_id", "approved", "approved_effect", "approved_reversible"], optional: ["brand_id"], server_injected: {} }, approval_required: true, side_effect: "closes the workspace pull request", receipt: "declined and replay status", receipt_type: "change_decline_receipt_v1", error_codes: [...changeCommon.error_codes, "approval_required", "decline_forbidden", "decline_cross_scope", "policy_input_failed", "already_merged", "stale_review_task", "idempotency_conflict", "unknown_outcome"] },
12937
+ { ...changeCommon, operation: "change.revise", description: "Request a revision against the reviewed head", inputs: { required: ["pr_number", "subject_revision", "command_id", "approved", "approved_effect", "approved_reversible", "feedback", "file"], optional: ["brand_id", "agent_id", "selected_lines"], server_injected: {} }, approval_required: true, side_effect: "dispatches or prepares a pull-request revision", receipt: "revision dispatch or editable head content", receipt_type: "change_revise_receipt_v1", error_codes: [...changeCommon.error_codes, "approval_required", "request_changes_forbidden", "request_changes_cross_scope", "policy_input_failed", "pr_already_merged", "stale_review_task", "idempotency_conflict", "unknown_outcome"] },
12938
+ { ...changeCommon, operation: "change.apply_revision", description: "Apply prepared content to the reviewed pull-request head", inputs: { required: ["pr_number", "subject_revision", "command_id", "approved", "approved_effect", "approved_reversible", "file", "new_content", "commit_message", "file_sha"], optional: ["brand_id", "branch"], server_injected: {} }, approval_required: true, side_effect: "commits to the workspace pull-request branch", receipt: "committed branch and PR number", receipt_type: "change_apply_revision_receipt_v1", error_codes: [...changeCommon.error_codes, "approval_required", "request_changes_forbidden", "request_changes_cross_scope", "policy_input_failed", "pr_already_merged", "stale_review_task", "idempotency_conflict", "branch_mismatch", "pr_branch_moved", "commit_failed", "unknown_outcome"] }
12939
+ ];
12878
12940
  InboxManagementCatalogResponseSchema = external_exports.object({
12879
12941
  contract_version: external_exports.literal(1),
12880
12942
  bindings: external_exports.array(InboxOperationBindingSchema),
@@ -12892,7 +12954,39 @@ var init_inbox_management = __esm({
12892
12954
  external_exports.object({
12893
12955
  operation: external_exports.literal("inbox.get"),
12894
12956
  input: external_exports.object({ id: external_exports.string().min(1), brand_id: external_exports.string().uuid().optional() })
12895
- })
12957
+ }),
12958
+ external_exports.object({ operation: external_exports.literal("change.get"), input: external_exports.object({ pr_number: external_exports.number().int().positive(), brand_id: external_exports.string().uuid().optional(), command_id: external_exports.string().min(1).max(200).optional(), command_operation: external_exports.enum(["approve", "decline", "request_revision", "apply_revision"]).optional() }).refine((value) => Boolean(value.command_id) === Boolean(value.command_operation), { message: "command_id and command_operation must be supplied together" }) }),
12959
+ external_exports.object({ operation: external_exports.literal("change.diff"), input: external_exports.object({ pr_number: external_exports.number().int().positive(), brand_id: external_exports.string().uuid().optional() }) }),
12960
+ external_exports.object({ operation: external_exports.literal("change.head"), input: external_exports.object({ pr_number: external_exports.number().int().positive(), brand_id: external_exports.string().uuid().optional() }) }),
12961
+ external_exports.object({ operation: external_exports.literal("change.approve"), input: external_exports.object({ pr_number: external_exports.number().int().positive(), subject_revision: external_exports.string().min(1), command_id: external_exports.string().min(1).max(200), approved: external_exports.literal(true), approved_effect: external_exports.literal("merge_workspace_change"), approved_reversible: external_exports.literal(false), brand_id: external_exports.string().uuid().optional() }) }),
12962
+ external_exports.object({ operation: external_exports.literal("change.decline"), input: external_exports.object({ pr_number: external_exports.number().int().positive(), subject_revision: external_exports.string().min(1), command_id: external_exports.string().min(1).max(200), approved: external_exports.literal(true), approved_effect: external_exports.literal("close_workspace_change_without_merge"), approved_reversible: external_exports.literal(true), brand_id: external_exports.string().uuid().optional() }) }),
12963
+ external_exports.object({ operation: external_exports.literal("change.revise"), input: external_exports.object({
12964
+ pr_number: external_exports.number().int().positive(),
12965
+ subject_revision: external_exports.string().min(1),
12966
+ command_id: external_exports.string().min(1).max(200),
12967
+ approved: external_exports.literal(true),
12968
+ approved_effect: external_exports.literal("request_workspace_change_revision"),
12969
+ approved_reversible: external_exports.literal(true),
12970
+ feedback: external_exports.string().min(1).max(4e3),
12971
+ file: external_exports.string().min(1).max(512),
12972
+ agent_id: external_exports.string().nullable().optional(),
12973
+ selected_lines: external_exports.array(external_exports.object({ kind: external_exports.enum(["add", "del", "context"]), old_line: external_exports.number().nullable(), new_line: external_exports.number().nullable(), content: external_exports.string() })).optional(),
12974
+ brand_id: external_exports.string().uuid().optional()
12975
+ }) }),
12976
+ external_exports.object({ operation: external_exports.literal("change.apply_revision"), input: external_exports.object({
12977
+ pr_number: external_exports.number().int().positive(),
12978
+ subject_revision: external_exports.string().min(1),
12979
+ command_id: external_exports.string().min(1).max(200),
12980
+ approved: external_exports.literal(true),
12981
+ approved_effect: external_exports.literal("commit_workspace_change_revision"),
12982
+ approved_reversible: external_exports.literal(true),
12983
+ file: external_exports.string().min(1).max(512),
12984
+ new_content: external_exports.string().min(1).max(1e6),
12985
+ commit_message: external_exports.string().min(1).max(200),
12986
+ file_sha: external_exports.string().min(1).max(64),
12987
+ branch: external_exports.string().optional(),
12988
+ brand_id: external_exports.string().uuid().optional()
12989
+ }) })
12896
12990
  ]);
12897
12991
  InboxWorkItemSchema = external_exports.object({
12898
12992
  id: external_exports.string(),
@@ -12926,9 +13020,20 @@ var init_inbox_management = __esm({
12926
13020
  brand_name: external_exports.string().nullable()
12927
13021
  }),
12928
13022
  actor: external_exports.object({ user_id: external_exports.string(), role: external_exports.string() }),
12929
- command_id: external_exports.null(),
13023
+ command_id: external_exports.string().nullable(),
12930
13024
  outcome: external_exports.enum(["succeeded", "no_change", "pending", "unknown"])
12931
13025
  });
13026
+ UnknownMutationReceiptSchema = external_exports.object({
13027
+ state: external_exports.literal("unknown"),
13028
+ command_id: external_exports.string(),
13029
+ instruction: external_exports.literal("inspect_source_before_retry"),
13030
+ reason: external_exports.enum(["response_unproven", "read_back_unavailable", "postcondition_not_observed"]).default("response_unproven"),
13031
+ read_back: external_exports.object({ head_sha: external_exports.string(), pr_state: external_exports.string(), merged: external_exports.boolean() }).optional()
13032
+ });
13033
+ ChangeReadBackSchema = external_exports.discriminatedUnion("state", [
13034
+ external_exports.object({ state: external_exports.literal("verified"), head_sha: external_exports.string(), pr_state: external_exports.string(), merged: external_exports.boolean() }),
13035
+ external_exports.object({ state: external_exports.literal("unavailable"), instruction: external_exports.literal("inspect_source_before_retry") })
13036
+ ]);
12932
13037
  InboxOperationEnvelopeSchema = external_exports.discriminatedUnion("operation", [
12933
13038
  InboxEnvelopeBaseSchema.extend({
12934
13039
  operation: external_exports.literal("inbox.list"),
@@ -12939,7 +13044,37 @@ var init_inbox_management = __esm({
12939
13044
  operation: external_exports.literal("inbox.get"),
12940
13045
  source_version: external_exports.string().nullable(),
12941
13046
  receipt: InboxGetReceiptSchema
12942
- })
13047
+ }),
13048
+ InboxEnvelopeBaseSchema.extend({ operation: external_exports.literal("change.get"), source_version: external_exports.string(), receipt: external_exports.object({ state: external_exports.literal("complete"), item: InboxWorkItemSchema, command: external_exports.union([external_exports.object({ state: external_exports.literal("recorded"), operation: external_exports.string(), response: external_exports.unknown() }), external_exports.object({ state: external_exports.literal("not_recorded") })]).optional() }) }),
13049
+ InboxEnvelopeBaseSchema.extend({ operation: external_exports.literal("change.diff"), source_version: external_exports.string(), receipt: external_exports.object({
13050
+ pr_number: external_exports.number(),
13051
+ head_sha: external_exports.string(),
13052
+ base_sha: external_exports.string(),
13053
+ files: external_exports.array(external_exports.object({
13054
+ filename: external_exports.string(),
13055
+ status: external_exports.string(),
13056
+ additions: external_exports.number(),
13057
+ deletions: external_exports.number(),
13058
+ changes: external_exports.number(),
13059
+ previous_filename: external_exports.string().optional(),
13060
+ patch: external_exports.string().optional(),
13061
+ too_large: external_exports.boolean(),
13062
+ is_binary: external_exports.boolean(),
13063
+ intent: external_exports.string().nullable().optional(),
13064
+ change: external_exports.string().nullable().optional(),
13065
+ agentLabel: external_exports.string().nullable().optional()
13066
+ })),
13067
+ state: external_exports.string().optional(),
13068
+ merged: external_exports.boolean().optional(),
13069
+ merged_at: external_exports.string().nullable().optional(),
13070
+ created_at: external_exports.string().optional(),
13071
+ updated_at: external_exports.string().optional()
13072
+ }) }),
13073
+ InboxEnvelopeBaseSchema.extend({ operation: external_exports.literal("change.head"), source_version: external_exports.string(), receipt: external_exports.object({ pr_number: external_exports.number(), head_sha: external_exports.string() }) }),
13074
+ InboxEnvelopeBaseSchema.extend({ operation: external_exports.literal("change.approve"), source_version: external_exports.string(), receipt: external_exports.union([external_exports.object({ merged: external_exports.literal(true), sha: external_exports.string(), self_approved: external_exports.boolean(), already_resolved: external_exports.boolean(), resolved_by: external_exports.string().nullable(), replayed: external_exports.boolean(), read_back: ChangeReadBackSchema }), UnknownMutationReceiptSchema]) }),
13075
+ InboxEnvelopeBaseSchema.extend({ operation: external_exports.literal("change.decline"), source_version: external_exports.string(), receipt: external_exports.union([external_exports.object({ declined: external_exports.literal(true), already_resolved: external_exports.boolean(), resolved_by: external_exports.string().nullable().optional(), replayed: external_exports.boolean(), read_back: ChangeReadBackSchema }), UnknownMutationReceiptSchema]) }),
13076
+ InboxEnvelopeBaseSchema.extend({ operation: external_exports.literal("change.revise"), source_version: external_exports.string(), receipt: external_exports.union([external_exports.object({ dispatched: external_exports.boolean(), runtime: external_exports.enum(["anthropic_managed", "boo"]), replayed: external_exports.boolean().optional(), read_back: ChangeReadBackSchema }).passthrough(), UnknownMutationReceiptSchema]) }),
13077
+ InboxEnvelopeBaseSchema.extend({ operation: external_exports.literal("change.apply_revision"), source_version: external_exports.string(), receipt: external_exports.union([external_exports.object({ committed: external_exports.literal(true), branch: external_exports.string(), pr_number: external_exports.number(), replayed: external_exports.boolean().optional(), read_back: ChangeReadBackSchema }), UnknownMutationReceiptSchema]) })
12943
13078
  ]);
12944
13079
  }
12945
13080
  });
@@ -13643,7 +13778,11 @@ async function getInboxManagementOperations(session) {
13643
13778
  });
13644
13779
  if (!res.ok) throw await parseError(res);
13645
13780
  const json = await res.json();
13646
- return InboxManagementCatalogResponseSchema.parse(json.data);
13781
+ try {
13782
+ return InboxManagementCatalogResponseSchema.parse(json.data);
13783
+ } catch {
13784
+ throw new ApiError("The Inbox operation catalog response was malformed.", 502, "malformed_response");
13785
+ }
13647
13786
  }
13648
13787
  async function callInboxManagement(session, orgId, call) {
13649
13788
  const res = await cliApiFetch(`${apiBase()}/api/v1/inbox/manage`, {
@@ -13653,7 +13792,11 @@ async function callInboxManagement(session, orgId, call) {
13653
13792
  });
13654
13793
  if (!res.ok) throw await parseError(res);
13655
13794
  const json = await res.json();
13656
- return InboxOperationEnvelopeSchema.parse(json.data);
13795
+ try {
13796
+ return InboxOperationEnvelopeSchema.parse(json.data);
13797
+ } catch {
13798
+ throw new ApiError("The Inbox operation response was malformed.", 502, "malformed_response");
13799
+ }
13657
13800
  }
13658
13801
  function defaultApiBase(version) {
13659
13802
  return version.includes("-dev.") ? DEV_DEFAULT_BASE : PROD_DEFAULT_BASE;
@@ -18720,8 +18863,9 @@ async function inputObject(value) {
18720
18863
  function fail(error, output) {
18721
18864
  const value = error;
18722
18865
  const invalidInput = error instanceof SyntaxError || error instanceof ZodError;
18866
+ const unknownOutcome = error.name === "AbortError";
18723
18867
  emitError({
18724
- code: value.code ?? (invalidInput ? "invalid_input" : "inbox_operation_failed"),
18868
+ code: value.code ?? value.errorCode ?? (unknownOutcome ? "unknown_outcome" : invalidInput ? "invalid_input" : "inbox_operation_failed"),
18725
18869
  message: value.message ?? "Inbox operation failed."
18726
18870
  }, output, 1);
18727
18871
  throw new Error("unreachable");
@@ -18744,7 +18888,24 @@ async function runInboxManage(options) {
18744
18888
  if (!InboxManageOperationSchema.safeParse(options.operation).success) {
18745
18889
  throw Object.assign(new Error(`Unsupported Inbox operation: ${options.operation}`), { code: "unsupported_operation" });
18746
18890
  }
18747
- const call = InboxManagementCallSchema.parse({ operation: options.operation, input: await inputObject(options.input) });
18891
+ const input = await inputObject(options.input);
18892
+ const isMutation = options.operation.startsWith("change.") && !["change.get", "change.diff", "change.head"].includes(options.operation);
18893
+ if (isMutation) {
18894
+ const prNumber = input.pr_number;
18895
+ const subjectRevision = input.subject_revision;
18896
+ if (typeof prNumber !== "number" || typeof subjectRevision !== "string") {
18897
+ throw Object.assign(new Error("Workspace-change mutations require pr_number and subject_revision."), { code: "invalid_input" });
18898
+ }
18899
+ const preview = await callInboxManagement(session, options.org, InboxManagementCallSchema.parse({ operation: "change.get", input: { pr_number: prNumber, ...typeof input.brand_id === "string" ? { brand_id: input.brand_id } : {} } }));
18900
+ if (preview.scope.org_id !== options.org) throw Object.assign(new Error(`Requested organization ${options.org} but server resolved ${preview.scope.org_id}.`), { code: "organization_scope_mismatch" });
18901
+ if (preview.source_version !== subjectRevision) throw Object.assign(new Error(`The reviewed source revision ${subjectRevision} is stale; current revision is ${preview.source_version}.`), { code: "stale_review_task" });
18902
+ human(`Approval preview \u2014 organization: ${preview.scope.org_name} (${preview.scope.org_id}); brand: ${preview.scope.brand_name ?? "all brands"}; source: ${preview.source_version}; effect: ${String(input.approved_effect ?? "unspecified")}; reversible: ${String(input.approved_reversible ?? "unspecified")}`, options);
18903
+ if (!options.approve) {
18904
+ throw Object.assign(new Error("This operation changes customer state. Review the preview, obtain approval for its exact scope, source version, effect, and reversibility, then re-run with --approve."), { code: "approval_required" });
18905
+ }
18906
+ }
18907
+ if (options.approve) input.approved = true;
18908
+ const call = InboxManagementCallSchema.parse({ operation: options.operation, input });
18748
18909
  const result = await callInboxManagement(session, options.org, call);
18749
18910
  if (result.scope.org_id !== options.org) throw Object.assign(new Error(`Requested organization ${options.org} but server resolved ${result.scope.org_id}.`), { code: "organization_scope_mismatch" });
18750
18911
  human(`Resolved organization: ${result.scope.org_name} (${result.scope.org_id})`, options);
@@ -20928,7 +21089,7 @@ inbox.command("operations").description("List the supported customer Inbox opera
20928
21089
  const { runInboxOperations: runInboxOperations2 } = await Promise.resolve().then(() => (init_inbox_management2(), inbox_management_exports));
20929
21090
  await runInboxOperations2(options);
20930
21091
  });
20931
- inbox.command("manage").description("Call one exact read operation (`inbox.list` or `inbox.get`)").argument("<operation>", "Exact operation name").requiredOption("--input <json-or-@file>", "JSON object, inline or loaded from @path").requiredOption("--org <uuid>", "Explicit customer organization UUID").option("--json", "Emit a JSON envelope for agent consumption").option("--fields <list>", "Project only these dotted field paths from data (comma-separated)").option("--quiet", "Suppress human chatter (data/errors only)").action(async (operation, options) => {
21092
+ inbox.command("manage").description("Call one exact read operation (`inbox.list` or `inbox.get`)").argument("<operation>", "Exact operation name").requiredOption("--input <json-or-@file>", "JSON object, inline or loaded from @path").requiredOption("--org <uuid>", "Explicit customer organization UUID").option("--approve", "Confirm the exact displayed mutation after user approval").option("--json", "Emit a JSON envelope for agent consumption").option("--fields <list>", "Project only these dotted field paths from data (comma-separated)").option("--quiet", "Suppress human chatter (data/errors only)").action(async (operation, options) => {
20932
21093
  const { runInboxManage: runInboxManage2 } = await Promise.resolve().then(() => (init_inbox_management2(), inbox_management_exports));
20933
21094
  await runInboxManage2({ operation, ...options });
20934
21095
  });