bamboo-agents 0.1.8-dev.93.c78005c → 0.1.8-dev.95.4c57ace

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.95.4c57ace
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.95.4c57ace";
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,59 @@ 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, opportunityCommon, OPPORTUNITY_MANAGEMENT_BINDINGS, InboxManagementCatalogResponseSchema, OpportunityDecisionInputBaseSchema, InboxManagementCallSchema, InboxWorkItemSchema, InboxListReceiptSchema, InboxGetReceiptSchema, InboxEnvelopeBaseSchema, UnknownMutationReceiptSchema, ChangeReadBackSchema, OpportunitySnapshotSchema, OpportunityUnknownReceiptSchema, OpportunityCommandSchema, 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
+ "opportunity.get",
12776
+ "opportunity.propose",
12777
+ "opportunity.assign_and_send",
12778
+ "opportunity.reject",
12779
+ "opportunity.defer",
12780
+ "opportunity.annotate",
12781
+ "opportunity.block"
12782
+ ]);
12783
+ InboxManageOperationSchema = external_exports.enum([
12784
+ "inbox.list",
12785
+ "inbox.get",
12786
+ "change.get",
12787
+ "change.diff",
12788
+ "change.head",
12789
+ "change.approve",
12790
+ "change.decline",
12791
+ "change.revise",
12792
+ "change.apply_revision",
12793
+ "opportunity.get",
12794
+ "opportunity.propose",
12795
+ "opportunity.assign_and_send",
12796
+ "opportunity.reject",
12797
+ "opportunity.defer",
12798
+ "opportunity.annotate",
12799
+ "opportunity.block"
12800
+ ]);
12763
12801
  InboxOperationBindingSchema = external_exports.object({
12764
12802
  operation: InboxOperationSchema,
12765
12803
  description: external_exports.string(),
12766
- work_item_family: external_exports.literal("inbox"),
12804
+ work_item_family: external_exports.enum(["inbox", "workspace_change", "brain_opportunity"]),
12767
12805
  method: external_exports.literal("POST"),
12768
12806
  path: external_exports.string().startsWith("/api/v1/"),
12769
12807
  cli_command: external_exports.string().startsWith("bamboo-agents inbox "),
@@ -12777,7 +12815,26 @@ var init_inbox_management = __esm({
12777
12815
  approval_required: external_exports.boolean(),
12778
12816
  side_effect: external_exports.string(),
12779
12817
  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"]),
12818
+ receipt_type: external_exports.enum([
12819
+ "inbox_list_receipt_v1",
12820
+ "inbox_get_receipt_v1",
12821
+ "inbox_revise_receipt_v1",
12822
+ "inbox_apply_revision_receipt_v1",
12823
+ "change_get_receipt_v1",
12824
+ "change_diff_receipt_v1",
12825
+ "change_head_receipt_v1",
12826
+ "change_approve_receipt_v1",
12827
+ "change_decline_receipt_v1",
12828
+ "change_revise_receipt_v1",
12829
+ "change_apply_revision_receipt_v1",
12830
+ "opportunity_get_receipt_v1",
12831
+ "opportunity_propose_receipt_v1",
12832
+ "opportunity_send_receipt_v1",
12833
+ "opportunity_reject_receipt_v1",
12834
+ "opportunity_defer_receipt_v1",
12835
+ "opportunity_annotate_receipt_v1",
12836
+ "opportunity_block_receipt_v1"
12837
+ ]),
12781
12838
  error_codes: external_exports.array(external_exports.enum([
12782
12839
  "authentication_required",
12783
12840
  "organization_scope_required",
@@ -12799,7 +12856,24 @@ var init_inbox_management = __esm({
12799
12856
  "stale_review_task",
12800
12857
  "branch_mismatch",
12801
12858
  "pr_branch_moved",
12802
- "commit_failed"
12859
+ "commit_failed",
12860
+ "merge_conflict",
12861
+ "merge_blocked",
12862
+ "github_error",
12863
+ "idempotency_conflict",
12864
+ "already_merged",
12865
+ "unknown_outcome",
12866
+ "approval_required",
12867
+ "policy_blocked",
12868
+ "decline_forbidden",
12869
+ "decline_cross_scope",
12870
+ "brain_opportunity_stale",
12871
+ "brain_opportunity_assignment_target_invalid",
12872
+ "missing_assignment",
12873
+ "wording_mismatch",
12874
+ "recipient_mismatch",
12875
+ "proposal_failed",
12876
+ "graph_decision_conflict"
12803
12877
  ])),
12804
12878
  minimum_cli_version: external_exports.string()
12805
12879
  });
@@ -12875,11 +12949,49 @@ var init_inbox_management = __esm({
12875
12949
  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
12950
  }
12877
12951
  ];
12952
+ changeCommon = {
12953
+ ...common,
12954
+ work_item_family: "workspace_change",
12955
+ description: "",
12956
+ inputs: { required: ["pr_number"], optional: ["brand_id"], server_injected: {} },
12957
+ 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"]
12958
+ };
12959
+ CHANGE_MANAGEMENT_BINDINGS = [
12960
+ { ...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" },
12961
+ { ...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" },
12962
+ { ...changeCommon, operation: "change.head", description: "Re-read the current PR head SHA", receipt: "current PR head SHA", receipt_type: "change_head_receipt_v1" },
12963
+ { ...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"] },
12964
+ { ...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"] },
12965
+ { ...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"] },
12966
+ { ...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"] }
12967
+ ];
12968
+ opportunityCommon = {
12969
+ ...common,
12970
+ work_item_family: "brain_opportunity",
12971
+ description: "",
12972
+ inputs: { required: ["opportunity_id"], optional: ["brand_id"], server_injected: {} },
12973
+ error_codes: ["authentication_required", "organization_scope_required", "organization_scope_mismatch", "invalid_input", "not_found", "forbidden", "malformed_response"]
12974
+ };
12975
+ OPPORTUNITY_MANAGEMENT_BINDINGS = [
12976
+ { ...opportunityCommon, operation: "opportunity.get", description: "Inspect one Brain Opportunity at its current source version", receipt: "current opportunity state and approved customer wording", receipt_type: "opportunity_get_receipt_v1" },
12977
+ { ...opportunityCommon, operation: "opportunity.propose", description: "Add a stable-key proposal to internal FDE review", inputs: { required: ["brand_id", "proposal", "command_id", "approved", "approved_effect", "approved_reversible"], optional: ["agent_id"], server_injected: {} }, approval_required: true, side_effect: "creates one add-only internal-review proposal", receipt: "created or reused internal-review proposal", receipt_type: "opportunity_propose_receipt_v1", error_codes: [...opportunityCommon.error_codes, "proposal_failed", "graph_decision_conflict"] },
12978
+ { ...opportunityCommon, operation: "opportunity.assign_and_send", description: "Assign and release exact approved wording to one named customer", inputs: { required: ["opportunity_id", "source_version", "command_id", "recipient_user_id", "recipient_name", "approved_wording", "approved", "approved_effect", "approved_reversible"], optional: ["brand_id"], server_injected: {} }, approval_required: true, side_effect: "moves the reviewed opportunity into the named customer's queue", receipt: "sent customer-queue state and command receipt", receipt_type: "opportunity_send_receipt_v1", error_codes: [...opportunityCommon.error_codes, "brain_opportunity_stale", "brain_opportunity_assignment_target_invalid", "missing_assignment", "wording_mismatch", "recipient_mismatch", "graph_decision_conflict"] },
12979
+ ...["reject", "defer", "annotate", "block"].map((decision) => ({ ...opportunityCommon, operation: `opportunity.${decision}`, description: `${decision} one reviewed Brain Opportunity`, inputs: { required: ["opportunity_id", "source_version", "command_id", "reason", "approved", "approved_effect", "approved_reversible"], optional: ["brand_id"], server_injected: {} }, approval_required: true, side_effect: `${decision}s the internal-review opportunity`, receipt: `${decision} decision and source read-back`, receipt_type: `opportunity_${decision}_receipt_v1`, error_codes: [...opportunityCommon.error_codes, "brain_opportunity_stale", "graph_decision_conflict"] }))
12980
+ ];
12878
12981
  InboxManagementCatalogResponseSchema = external_exports.object({
12879
12982
  contract_version: external_exports.literal(1),
12880
12983
  bindings: external_exports.array(InboxOperationBindingSchema),
12881
12984
  related_cli_commands: external_exports.array(external_exports.string())
12882
12985
  });
12986
+ OpportunityDecisionInputBaseSchema = external_exports.object({
12987
+ opportunity_id: external_exports.string().uuid(),
12988
+ brand_id: external_exports.string().uuid().optional(),
12989
+ source_version: external_exports.string().datetime(),
12990
+ command_id: external_exports.string().min(1).max(128),
12991
+ reason: external_exports.string().trim().min(1),
12992
+ approved: external_exports.literal(true),
12993
+ approved_reversible: external_exports.literal(true)
12994
+ });
12883
12995
  InboxManagementCallSchema = external_exports.discriminatedUnion("operation", [
12884
12996
  external_exports.object({
12885
12997
  operation: external_exports.literal("inbox.list"),
@@ -12892,7 +13004,80 @@ var init_inbox_management = __esm({
12892
13004
  external_exports.object({
12893
13005
  operation: external_exports.literal("inbox.get"),
12894
13006
  input: external_exports.object({ id: external_exports.string().min(1), brand_id: external_exports.string().uuid().optional() })
12895
- })
13007
+ }),
13008
+ 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" }) }),
13009
+ 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() }) }),
13010
+ 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() }) }),
13011
+ 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() }) }),
13012
+ 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() }) }),
13013
+ external_exports.object({ operation: external_exports.literal("change.revise"), input: external_exports.object({
13014
+ pr_number: external_exports.number().int().positive(),
13015
+ subject_revision: external_exports.string().min(1),
13016
+ command_id: external_exports.string().min(1).max(200),
13017
+ approved: external_exports.literal(true),
13018
+ approved_effect: external_exports.literal("request_workspace_change_revision"),
13019
+ approved_reversible: external_exports.literal(true),
13020
+ feedback: external_exports.string().min(1).max(4e3),
13021
+ file: external_exports.string().min(1).max(512),
13022
+ agent_id: external_exports.string().nullable().optional(),
13023
+ 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(),
13024
+ brand_id: external_exports.string().uuid().optional()
13025
+ }) }),
13026
+ external_exports.object({ operation: external_exports.literal("change.apply_revision"), input: external_exports.object({
13027
+ pr_number: external_exports.number().int().positive(),
13028
+ subject_revision: external_exports.string().min(1),
13029
+ command_id: external_exports.string().min(1).max(200),
13030
+ approved: external_exports.literal(true),
13031
+ approved_effect: external_exports.literal("commit_workspace_change_revision"),
13032
+ approved_reversible: external_exports.literal(true),
13033
+ file: external_exports.string().min(1).max(512),
13034
+ new_content: external_exports.string().min(1).max(1e6),
13035
+ commit_message: external_exports.string().min(1).max(200),
13036
+ file_sha: external_exports.string().min(1).max(64),
13037
+ branch: external_exports.string().optional(),
13038
+ brand_id: external_exports.string().uuid().optional()
13039
+ }) }),
13040
+ external_exports.object({ operation: external_exports.literal("opportunity.get"), input: external_exports.object({ opportunity_id: external_exports.string().uuid(), brand_id: external_exports.string().uuid().optional(), command_id: external_exports.string().min(1).max(128).optional() }) }),
13041
+ external_exports.object({ operation: external_exports.literal("opportunity.propose"), input: external_exports.object({
13042
+ brand_id: external_exports.string().uuid(),
13043
+ agent_id: external_exports.string().uuid().nullable().optional(),
13044
+ command_id: external_exports.string().min(1).max(128),
13045
+ approved: external_exports.literal(true),
13046
+ approved_effect: external_exports.literal("create_internal_opportunity_proposal"),
13047
+ approved_reversible: external_exports.literal(true),
13048
+ proposal: external_exports.object({
13049
+ opportunity_key: external_exports.string().min(1).max(240).optional(),
13050
+ title: external_exports.string().trim().min(1).max(500),
13051
+ function_key: external_exports.string().nullable().optional(),
13052
+ expectation_keys: external_exports.array(external_exports.string()).optional(),
13053
+ module_order: external_exports.number().int().optional(),
13054
+ priority: external_exports.enum(["high", "medium", "low"]),
13055
+ summary: external_exports.string(),
13056
+ why_it_matters: external_exports.string(),
13057
+ expected_artifacts: external_exports.array(external_exports.string()),
13058
+ subquestions: external_exports.array(external_exports.object({ key: external_exports.string(), prompt: external_exports.string(), purpose: external_exports.string(), required: external_exports.boolean() })),
13059
+ evidence: external_exports.array(external_exports.record(external_exports.string(), external_exports.unknown())),
13060
+ open_questions: external_exports.array(external_exports.string()),
13061
+ source: external_exports.string().min(1),
13062
+ proposed_assignee_user_id: external_exports.string().uuid().nullable().optional()
13063
+ })
13064
+ }) }),
13065
+ external_exports.object({ operation: external_exports.literal("opportunity.assign_and_send"), input: external_exports.object({
13066
+ opportunity_id: external_exports.string().uuid(),
13067
+ brand_id: external_exports.string().uuid().optional(),
13068
+ source_version: external_exports.string().datetime(),
13069
+ command_id: external_exports.string().min(1).max(128),
13070
+ recipient_user_id: external_exports.string().uuid(),
13071
+ recipient_name: external_exports.string().trim().min(1),
13072
+ approved_wording: external_exports.object({ title: external_exports.string(), questions: external_exports.array(external_exports.string()) }),
13073
+ approved: external_exports.literal(true),
13074
+ approved_effect: external_exports.literal("assign_and_release_customer_opportunity"),
13075
+ approved_reversible: external_exports.literal(true)
13076
+ }) }),
13077
+ external_exports.object({ operation: external_exports.literal("opportunity.reject"), input: OpportunityDecisionInputBaseSchema.extend({ approved_effect: external_exports.literal("reject_internal_opportunity") }) }),
13078
+ external_exports.object({ operation: external_exports.literal("opportunity.defer"), input: OpportunityDecisionInputBaseSchema.extend({ approved_effect: external_exports.literal("defer_internal_opportunity") }) }),
13079
+ external_exports.object({ operation: external_exports.literal("opportunity.annotate"), input: OpportunityDecisionInputBaseSchema.extend({ approved_effect: external_exports.literal("annotate_internal_opportunity") }) }),
13080
+ external_exports.object({ operation: external_exports.literal("opportunity.block"), input: OpportunityDecisionInputBaseSchema.extend({ approved_effect: external_exports.literal("block_internal_opportunity") }) })
12896
13081
  ]);
12897
13082
  InboxWorkItemSchema = external_exports.object({
12898
13083
  id: external_exports.string(),
@@ -12926,9 +13111,36 @@ var init_inbox_management = __esm({
12926
13111
  brand_name: external_exports.string().nullable()
12927
13112
  }),
12928
13113
  actor: external_exports.object({ user_id: external_exports.string(), role: external_exports.string() }),
12929
- command_id: external_exports.null(),
13114
+ command_id: external_exports.string().nullable(),
12930
13115
  outcome: external_exports.enum(["succeeded", "no_change", "pending", "unknown"])
12931
13116
  });
13117
+ UnknownMutationReceiptSchema = external_exports.object({
13118
+ state: external_exports.literal("unknown"),
13119
+ command_id: external_exports.string(),
13120
+ instruction: external_exports.literal("inspect_source_before_retry"),
13121
+ reason: external_exports.enum(["response_unproven", "read_back_unavailable", "postcondition_not_observed"]).default("response_unproven"),
13122
+ read_back: external_exports.object({ head_sha: external_exports.string(), pr_state: external_exports.string(), merged: external_exports.boolean() }).optional()
13123
+ });
13124
+ ChangeReadBackSchema = external_exports.discriminatedUnion("state", [
13125
+ external_exports.object({ state: external_exports.literal("verified"), head_sha: external_exports.string(), pr_state: external_exports.string(), merged: external_exports.boolean() }),
13126
+ external_exports.object({ state: external_exports.literal("unavailable"), instruction: external_exports.literal("inspect_source_before_retry") })
13127
+ ]);
13128
+ OpportunitySnapshotSchema = external_exports.object({
13129
+ id: external_exports.string().uuid(),
13130
+ opportunity_key: external_exports.string(),
13131
+ status: external_exports.string(),
13132
+ updated_at: external_exports.string(),
13133
+ title: external_exports.string(),
13134
+ summary: external_exports.string(),
13135
+ brand_id: external_exports.string().nullable(),
13136
+ assignee_user_id: external_exports.string().nullable(),
13137
+ customer_wording: external_exports.object({ title: external_exports.string(), questions: external_exports.array(external_exports.string()) })
13138
+ }).passthrough();
13139
+ OpportunityUnknownReceiptSchema = external_exports.object({ state: external_exports.literal("unknown"), command_id: external_exports.string(), instruction: external_exports.literal("inspect_source_before_retry") });
13140
+ OpportunityCommandSchema = external_exports.union([
13141
+ external_exports.object({ state: external_exports.literal("recorded"), operation: external_exports.string(), response: external_exports.unknown() }),
13142
+ external_exports.object({ state: external_exports.literal("not_recorded") })
13143
+ ]);
12932
13144
  InboxOperationEnvelopeSchema = external_exports.discriminatedUnion("operation", [
12933
13145
  InboxEnvelopeBaseSchema.extend({
12934
13146
  operation: external_exports.literal("inbox.list"),
@@ -12939,7 +13151,41 @@ var init_inbox_management = __esm({
12939
13151
  operation: external_exports.literal("inbox.get"),
12940
13152
  source_version: external_exports.string().nullable(),
12941
13153
  receipt: InboxGetReceiptSchema
12942
- })
13154
+ }),
13155
+ 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() }) }),
13156
+ InboxEnvelopeBaseSchema.extend({ operation: external_exports.literal("change.diff"), source_version: external_exports.string(), receipt: external_exports.object({
13157
+ pr_number: external_exports.number(),
13158
+ head_sha: external_exports.string(),
13159
+ base_sha: external_exports.string(),
13160
+ files: external_exports.array(external_exports.object({
13161
+ filename: external_exports.string(),
13162
+ status: external_exports.string(),
13163
+ additions: external_exports.number(),
13164
+ deletions: external_exports.number(),
13165
+ changes: external_exports.number(),
13166
+ previous_filename: external_exports.string().optional(),
13167
+ patch: external_exports.string().optional(),
13168
+ too_large: external_exports.boolean(),
13169
+ is_binary: external_exports.boolean(),
13170
+ intent: external_exports.string().nullable().optional(),
13171
+ change: external_exports.string().nullable().optional(),
13172
+ agentLabel: external_exports.string().nullable().optional()
13173
+ })),
13174
+ state: external_exports.string().optional(),
13175
+ merged: external_exports.boolean().optional(),
13176
+ merged_at: external_exports.string().nullable().optional(),
13177
+ created_at: external_exports.string().optional(),
13178
+ updated_at: external_exports.string().optional()
13179
+ }) }),
13180
+ 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() }) }),
13181
+ 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]) }),
13182
+ 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]) }),
13183
+ 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]) }),
13184
+ 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]) }),
13185
+ InboxEnvelopeBaseSchema.extend({ operation: external_exports.literal("opportunity.get"), source_version: external_exports.string(), receipt: external_exports.object({ state: external_exports.literal("complete"), opportunity: OpportunitySnapshotSchema, command: OpportunityCommandSchema.optional() }) }),
13186
+ InboxEnvelopeBaseSchema.extend({ operation: external_exports.literal("opportunity.propose"), source_version: external_exports.string(), receipt: external_exports.union([external_exports.object({ state: external_exports.enum(["created", "reused"]), opportunity: OpportunitySnapshotSchema, replayed: external_exports.boolean() }), OpportunityUnknownReceiptSchema]) }),
13187
+ InboxEnvelopeBaseSchema.extend({ operation: external_exports.literal("opportunity.assign_and_send"), source_version: external_exports.string(), receipt: external_exports.union([external_exports.object({ state: external_exports.literal("sent"), recipient: external_exports.object({ user_id: external_exports.string().uuid(), name: external_exports.string() }), wording: external_exports.object({ title: external_exports.string(), questions: external_exports.array(external_exports.string()) }), deduplicated: external_exports.boolean(), trace_id: external_exports.string(), receipt_event_id: external_exports.string(), read_back: OpportunitySnapshotSchema }), OpportunityUnknownReceiptSchema]) }),
13188
+ ...["reject", "defer", "annotate", "block"].map((decision) => InboxEnvelopeBaseSchema.extend({ operation: external_exports.literal(`opportunity.${decision}`), source_version: external_exports.string(), receipt: external_exports.union([external_exports.object({ state: external_exports.literal(decision), deduplicated: external_exports.boolean(), trace_id: external_exports.string(), receipt_event_id: external_exports.string(), read_back: OpportunitySnapshotSchema }), OpportunityUnknownReceiptSchema]) }))
12943
13189
  ]);
12944
13190
  }
12945
13191
  });
@@ -13643,7 +13889,11 @@ async function getInboxManagementOperations(session) {
13643
13889
  });
13644
13890
  if (!res.ok) throw await parseError(res);
13645
13891
  const json = await res.json();
13646
- return InboxManagementCatalogResponseSchema.parse(json.data);
13892
+ try {
13893
+ return InboxManagementCatalogResponseSchema.parse(json.data);
13894
+ } catch {
13895
+ throw new ApiError("The Inbox operation catalog response was malformed.", 502, "malformed_response");
13896
+ }
13647
13897
  }
13648
13898
  async function callInboxManagement(session, orgId, call) {
13649
13899
  const res = await cliApiFetch(`${apiBase()}/api/v1/inbox/manage`, {
@@ -13653,7 +13903,11 @@ async function callInboxManagement(session, orgId, call) {
13653
13903
  });
13654
13904
  if (!res.ok) throw await parseError(res);
13655
13905
  const json = await res.json();
13656
- return InboxOperationEnvelopeSchema.parse(json.data);
13906
+ try {
13907
+ return InboxOperationEnvelopeSchema.parse(json.data);
13908
+ } catch {
13909
+ throw new ApiError("The Inbox operation response was malformed.", 502, "malformed_response");
13910
+ }
13657
13911
  }
13658
13912
  function defaultApiBase(version) {
13659
13913
  return version.includes("-dev.") ? DEV_DEFAULT_BASE : PROD_DEFAULT_BASE;
@@ -18720,8 +18974,9 @@ async function inputObject(value) {
18720
18974
  function fail(error, output) {
18721
18975
  const value = error;
18722
18976
  const invalidInput = error instanceof SyntaxError || error instanceof ZodError;
18977
+ const unknownOutcome = error.name === "AbortError";
18723
18978
  emitError({
18724
- code: value.code ?? (invalidInput ? "invalid_input" : "inbox_operation_failed"),
18979
+ code: value.code ?? value.errorCode ?? (unknownOutcome ? "unknown_outcome" : invalidInput ? "invalid_input" : "inbox_operation_failed"),
18725
18980
  message: value.message ?? "Inbox operation failed."
18726
18981
  }, output, 1);
18727
18982
  throw new Error("unreachable");
@@ -18744,7 +18999,27 @@ async function runInboxManage(options) {
18744
18999
  if (!InboxManageOperationSchema.safeParse(options.operation).success) {
18745
19000
  throw Object.assign(new Error(`Unsupported Inbox operation: ${options.operation}`), { code: "unsupported_operation" });
18746
19001
  }
18747
- const call = InboxManagementCallSchema.parse({ operation: options.operation, input: await inputObject(options.input) });
19002
+ const input = await inputObject(options.input);
19003
+ const isMutation = options.operation.startsWith("change.") && !["change.get", "change.diff", "change.head"].includes(options.operation) || options.operation.startsWith("opportunity.") && options.operation !== "opportunity.get";
19004
+ if (isMutation) {
19005
+ const isProposal = options.operation === "opportunity.propose";
19006
+ const isOpportunity = options.operation.startsWith("opportunity.");
19007
+ const previewCall = isProposal ? InboxManagementCallSchema.parse({ operation: "inbox.list", input: { ...typeof input.brand_id === "string" ? { brand_id: input.brand_id } : {}, limit: 1 } }) : isOpportunity ? InboxManagementCallSchema.parse({ operation: "opportunity.get", input: { opportunity_id: input.opportunity_id, ...typeof input.brand_id === "string" ? { brand_id: input.brand_id } : {} } }) : InboxManagementCallSchema.parse({ operation: "change.get", input: { pr_number: input.pr_number, ...typeof input.brand_id === "string" ? { brand_id: input.brand_id } : {} } });
19008
+ const preview = await callInboxManagement(session, options.org, previewCall);
19009
+ 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" });
19010
+ const suppliedVersion = input.source_version ?? input.subject_revision;
19011
+ if (!isProposal && preview.source_version !== suppliedVersion) throw Object.assign(new Error(`The reviewed source revision ${String(suppliedVersion)} is stale; current revision is ${preview.source_version}.`), { code: "stale_review_task" });
19012
+ const recipient = input.recipient_name ? `; recipient: ${String(input.recipient_name)}` : "";
19013
+ const wording = input.approved_wording ? `; wording: ${JSON.stringify(input.approved_wording)}` : "";
19014
+ const mutation = MUTATION_EFFECTS[options.operation];
19015
+ const sourceItem = isProposal ? String(input.proposal && typeof input.proposal === "object" ? input.proposal.opportunity_key ?? "new stable-key proposal" : "new proposal") : String(input.opportunity_id ?? input.pr_number ?? "unknown");
19016
+ human(`Approval preview \u2014 organization: ${preview.scope.org_name} (${preview.scope.org_id}); brand: ${preview.scope.brand_name ?? "all brands"}; operation: ${options.operation}; source item: ${sourceItem}; source version: ${preview.source_version ?? "new proposal"}; effect: ${mutation?.effect ?? "unspecified"}; reversible: ${String(mutation?.reversible ?? "unspecified")}${recipient}${wording}`, options);
19017
+ if (!options.approve) {
19018
+ 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" });
19019
+ }
19020
+ }
19021
+ if (options.approve) input.approved = true;
19022
+ const call = InboxManagementCallSchema.parse({ operation: options.operation, input });
18748
19023
  const result = await callInboxManagement(session, options.org, call);
18749
19024
  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
19025
  human(`Resolved organization: ${result.scope.org_name} (${result.scope.org_id})`, options);
@@ -18753,6 +19028,7 @@ async function runInboxManage(options) {
18753
19028
  fail(error, options);
18754
19029
  }
18755
19030
  }
19031
+ var MUTATION_EFFECTS;
18756
19032
  var init_inbox_management2 = __esm({
18757
19033
  "src/commands/inbox-management.ts"() {
18758
19034
  "use strict";
@@ -18761,6 +19037,18 @@ var init_inbox_management2 = __esm({
18761
19037
  init_api();
18762
19038
  init_credentials();
18763
19039
  init_output();
19040
+ MUTATION_EFFECTS = {
19041
+ "change.approve": { effect: "merge_workspace_change", reversible: false },
19042
+ "change.decline": { effect: "close_workspace_change_without_merge", reversible: true },
19043
+ "change.revise": { effect: "request_workspace_change_revision", reversible: true },
19044
+ "change.apply_revision": { effect: "commit_workspace_change_revision", reversible: true },
19045
+ "opportunity.propose": { effect: "create_internal_opportunity_proposal", reversible: true },
19046
+ "opportunity.assign_and_send": { effect: "assign_and_release_customer_opportunity", reversible: true },
19047
+ "opportunity.reject": { effect: "reject_internal_opportunity", reversible: true },
19048
+ "opportunity.defer": { effect: "defer_internal_opportunity", reversible: true },
19049
+ "opportunity.annotate": { effect: "annotate_internal_opportunity", reversible: true },
19050
+ "opportunity.block": { effect: "block_internal_opportunity", reversible: true }
19051
+ };
18764
19052
  }
18765
19053
  });
18766
19054
 
@@ -20928,7 +21216,7 @@ inbox.command("operations").description("List the supported customer Inbox opera
20928
21216
  const { runInboxOperations: runInboxOperations2 } = await Promise.resolve().then(() => (init_inbox_management2(), inbox_management_exports));
20929
21217
  await runInboxOperations2(options);
20930
21218
  });
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) => {
21219
+ 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
21220
  const { runInboxManage: runInboxManage2 } = await Promise.resolve().then(() => (init_inbox_management2(), inbox_management_exports));
20933
21221
  await runInboxManage2({ operation, ...options });
20934
21222
  });