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 +1 -1
- package/dist/index.js +305 -17
- package/dist/index.js.map +2 -2
- package/package.json +1 -1
package/dist/VERSION
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
0.1.8-dev.
|
|
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.
|
|
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([
|
|
12762
|
-
|
|
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.
|
|
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([
|
|
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.
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
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
|
});
|