@conto_finance/create-conto-agent 0.4.7 → 0.5.0

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/cli.js CHANGED
@@ -1,23 +1,32 @@
1
1
  import {
2
+ ApiClient,
2
3
  CLI_PACKAGE_VERSION,
3
4
  HttpTransportError,
5
+ REVIEW_EXIT_CODES_HELP,
4
6
  apiUrl,
5
7
  browserAuth,
8
+ createApiClient,
9
+ createOwnerClient,
10
+ directOrReview,
6
11
  fetchChains,
7
12
  fingerprintSecret,
13
+ followChange,
8
14
  getChain,
15
+ isTightenOnlyRefusal,
9
16
  normalizeBaseUrl,
10
17
  parseSecureBaseUrl,
11
18
  projectStateFile,
19
+ proposeForReview,
12
20
  readProjectStateFile,
13
21
  redactSecrets,
22
+ reportReview,
14
23
  requestJson,
15
24
  responseErrorCode,
16
25
  responseErrorMessage,
17
26
  retryAfterSeconds,
18
27
  runInit,
19
28
  writeProjectStateFile
20
- } from "./chunk-HSJDGYZ5.js";
29
+ } from "./chunk-HDSRGTWB.js";
21
30
  import {
22
31
  VELOCITY_PERIODS,
23
32
  buildVelocityCountValue,
@@ -55,238 +64,6 @@ import { Command } from "commander";
55
64
 
56
65
  // src/commands/test-report.ts
57
66
  import fs from "fs";
58
-
59
- // src/lib/api-client.ts
60
- var REQUEST_TIMEOUT_MS = 3e4;
61
- function assertSecureBaseUrl(baseUrl) {
62
- let parsed;
63
- try {
64
- parsed = new URL(baseUrl);
65
- } catch {
66
- throw new Error(`Invalid base URL: ${baseUrl}`);
67
- }
68
- if (parsed.protocol !== "https:" && parsed.hostname !== "localhost" && parsed.hostname !== "127.0.0.1") {
69
- throw new Error("baseUrl must use https (except for localhost)");
70
- }
71
- }
72
- var ApiClient = class {
73
- baseUrl;
74
- apiKey;
75
- orgApiKey;
76
- constructor(options) {
77
- this.baseUrl = options.baseUrl.replace(/\/$/, "");
78
- assertSecureBaseUrl(this.baseUrl);
79
- this.apiKey = options.apiKey;
80
- this.orgApiKey = options.orgApiKey;
81
- }
82
- async request(method, path2, options) {
83
- const url = `${this.baseUrl}${path2}`;
84
- const authType = options?.auth || "sdk";
85
- const token = authType === "org" ? this.orgApiKey : this.apiKey;
86
- const headers = {
87
- "Content-Type": "application/json",
88
- "User-Agent": `create-conto-agent/${CLI_PACKAGE_VERSION}`
89
- };
90
- if (token) {
91
- headers["Authorization"] = `Bearer ${token}`;
92
- }
93
- const controller = new AbortController();
94
- const timeoutId = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
95
- try {
96
- const response = await fetch(url, {
97
- method,
98
- headers,
99
- body: options?.body ? JSON.stringify(options.body) : void 0,
100
- signal: controller.signal
101
- });
102
- const contentType = response.headers.get("content-type") || "";
103
- if (!contentType.includes("application/json")) {
104
- const error = new Error(
105
- response.status === 404 ? `API endpoint not found: ${path2}` : `API returned non-JSON response (${response.status})`
106
- );
107
- error.code = response.status === 404 ? "NOT_FOUND" : "INVALID_RESPONSE";
108
- error.status = response.status;
109
- throw error;
110
- }
111
- const data = await response.json();
112
- if (!response.ok) {
113
- const error = new Error(data.error || `API request failed: ${response.status}`);
114
- error.code = data.code || "API_ERROR";
115
- error.status = response.status;
116
- error.body = data;
117
- throw error;
118
- }
119
- return data;
120
- } catch (err) {
121
- if (err instanceof Error && err.name === "AbortError") {
122
- const error = new Error(
123
- `Request timed out after ${REQUEST_TIMEOUT_MS / 1e3}s`
124
- );
125
- error.code = "TIMEOUT";
126
- error.status = 0;
127
- throw error;
128
- }
129
- throw err;
130
- } finally {
131
- clearTimeout(timeoutId);
132
- }
133
- }
134
- async getTestReport(options) {
135
- const query = new URLSearchParams({ allowed: options.allowed, denied: options.denied });
136
- if (options.review) query.set("review", options.review);
137
- if (options.reviewOutcome) query.set("reviewOutcome", options.reviewOutcome);
138
- return this.request("GET", `/api/sdk/test-report?${query}`);
139
- }
140
- // ── Org-level Admin APIs (used during init) ──
141
- async createWallet(params) {
142
- return this.request("POST", "/api/wallets", { body: params, auth: "org" });
143
- }
144
- async createAgent(params) {
145
- return this.request("POST", "/api/agents", { body: params, auth: "org" });
146
- }
147
- async linkWalletToAgent(agentId, params) {
148
- return this.request("POST", `/api/agents/${encodeURIComponent(agentId)}/wallets`, {
149
- body: params,
150
- auth: "org"
151
- });
152
- }
153
- async createPolicy(params) {
154
- return this.request("POST", "/api/policies", { body: params, auth: "org" });
155
- }
156
- async updatePolicy(policyId, params) {
157
- return this.request("PATCH", `/api/policies/${encodeURIComponent(policyId)}`, { body: params, auth: "org" });
158
- }
159
- async deletePolicy(policyId) {
160
- return this.request("DELETE", `/api/policies/${encodeURIComponent(policyId)}`, { auth: "org" });
161
- }
162
- async addPolicyRule(policyId, rule) {
163
- return this.request(
164
- "POST",
165
- `/api/policies/${encodeURIComponent(policyId)}/rules`,
166
- {
167
- body: rule,
168
- auth: "org"
169
- }
170
- );
171
- }
172
- async deletePolicyRule(policyId, ruleId) {
173
- return this.request(
174
- "DELETE",
175
- `/api/policies/${encodeURIComponent(policyId)}/rules/${encodeURIComponent(ruleId)}`,
176
- { auth: "org" }
177
- );
178
- }
179
- async listOrgPolicies() {
180
- return this.request("GET", "/api/policies", { auth: "org" });
181
- }
182
- async assignPolicyToAgent(agentId, policyId) {
183
- return this.request("POST", `/api/agents/${encodeURIComponent(agentId)}/policies`, {
184
- body: { policyId },
185
- auth: "org"
186
- });
187
- }
188
- async unassignPolicyFromAgent(agentId, policyId) {
189
- return this.request(
190
- "DELETE",
191
- `/api/agents/${encodeURIComponent(agentId)}/policies?policyId=${encodeURIComponent(policyId)}`,
192
- {
193
- auth: "org"
194
- }
195
- );
196
- }
197
- async createSdkKey(agentId, params) {
198
- return this.request("POST", `/api/agents/${encodeURIComponent(agentId)}/sdk-keys`, {
199
- body: params,
200
- auth: "org"
201
- });
202
- }
203
- async fundWallet(walletId) {
204
- return this.request("POST", `/api/wallets/${encodeURIComponent(walletId)}/faucet`, { auth: "org" });
205
- }
206
- // ── SDK Agent APIs (used by CLI commands) ──
207
- async getSetup() {
208
- return this.request("GET", "/api/sdk/setup");
209
- }
210
- async getAgentInfo() {
211
- const data = await this.request("GET", "/api/sdk/agents/me");
212
- return {
213
- agent: {
214
- id: data.id,
215
- name: data.name,
216
- agentType: data.agentType,
217
- status: data.status,
218
- createdAt: data.createdAt
219
- },
220
- organization: { name: data.organizationId },
221
- walletCount: data.summary?.walletCount ?? 0,
222
- summary: data.summary
223
- };
224
- }
225
- async getWallets() {
226
- return this.request("GET", "/api/sdk/wallets");
227
- }
228
- async getSpendingLimits() {
229
- const data = await this.request("GET", "/api/sdk/spending-limits");
230
- return {
231
- limits: (data.wallets || []).map((w) => ({
232
- walletId: w.walletId,
233
- walletName: w.name,
234
- daily: {
235
- limit: w.limits?.daily ?? 0,
236
- spent: w.spent?.today ?? 0,
237
- remaining: w.remaining?.daily ?? 0
238
- },
239
- weekly: w.limits?.weekly ? {
240
- limit: w.limits.weekly,
241
- spent: w.spent?.thisWeek ?? 0,
242
- remaining: w.remaining?.weekly ?? 0
243
- } : void 0,
244
- monthly: w.limits?.monthly ? {
245
- limit: w.limits.monthly,
246
- spent: w.spent?.thisMonth ?? 0,
247
- remaining: w.remaining?.monthly ?? 0
248
- } : void 0,
249
- perTransaction: w.limits?.perTransaction ?? 0
250
- }))
251
- };
252
- }
253
- async requestPayment(params) {
254
- return this.request("POST", "/api/sdk/payments/request", { body: params });
255
- }
256
- async executePayment(requestId) {
257
- return this.request("POST", `/api/sdk/payments/${encodeURIComponent(requestId)}/execute`, { body: {} });
258
- }
259
- async getPaymentStatus(requestId) {
260
- return this.request("GET", `/api/sdk/payments/${encodeURIComponent(requestId)}`);
261
- }
262
- async getTransactions(params) {
263
- const query = new URLSearchParams();
264
- if (params?.limit) query.set("limit", String(params.limit));
265
- if (params?.status) query.set("status", params.status);
266
- const qs = query.toString() ? `?${query.toString()}` : "";
267
- return this.request("GET", `/api/sdk/transactions${qs}`);
268
- }
269
- async getTransaction(id) {
270
- return this.request("GET", `/api/sdk/transactions/${encodeURIComponent(id)}`);
271
- }
272
- async getPolicies() {
273
- return this.request("GET", "/api/sdk/policies");
274
- }
275
- async getAlerts(params) {
276
- const query = new URLSearchParams();
277
- if (params?.status) query.set("status", params.status);
278
- const qs = query.toString() ? `?${query.toString()}` : "";
279
- return this.request("GET", `/api/sdk/alerts${qs}`);
280
- }
281
- async getAnalytics() {
282
- return this.request("GET", "/api/sdk/analytics");
283
- }
284
- };
285
- function createApiClient(options) {
286
- return new ApiClient(options);
287
- }
288
-
289
- // src/commands/test-report.ts
290
67
  async function testReportCommand(options) {
291
68
  try {
292
69
  const config = loadConfig();
@@ -968,9 +745,171 @@ async function balanceCommand() {
968
745
  }
969
746
 
970
747
  // src/commands/pay.ts
748
+ import chalk3 from "chalk";
749
+
750
+ // src/lib/payment-review.ts
971
751
  import chalk2 from "chalk";
752
+ var PAYMENT_EXIT_CODES_HELP = `
753
+ Payments that need approval:
754
+ the command prints a review link, opens it when it can, waits for the
755
+ decision, and sends the payment once it is approved.
756
+
757
+ conto pay status <requestId> Check a payment waiting for approval
758
+ conto pay execute <requestId> Send a payment an approver already approved
759
+
760
+ Exit codes:
761
+ 0 sent, or already handled
762
+ 1 request failed
763
+ 3 an approver rejected the payment
764
+ 4 still waiting for approval (--no-wait, or the wait timed out)
765
+ 5 the approval expired or was cancelled
766
+ `;
767
+ var PAY_EXIT_REJECTED = 3;
768
+ var PAY_EXIT_PENDING = 4;
769
+ var PAY_EXIT_EXPIRED = 5;
770
+ var POLL_INTERVAL_MS = Number(process.env.CONTO_REVIEW_POLL_MS) || 3e3;
771
+ var DEFAULT_WAIT_SECONDS = 300;
772
+ var PaymentReviewClient = class extends ApiClient {
773
+ startReview(paymentRequestId) {
774
+ return this.request("POST", "/api/sdk/approval-reviews", {
775
+ body: { paymentRequestId, client: { name: "conto-cli", version: CLI_PACKAGE_VERSION } }
776
+ });
777
+ }
778
+ getReview(reviewSessionId) {
779
+ return this.request(
780
+ "GET",
781
+ `/api/sdk/approval-reviews/${encodeURIComponent(reviewSessionId)}`
782
+ );
783
+ }
784
+ };
785
+ function interactive() {
786
+ return Boolean(process.stdout.isTTY) && !isJsonMode();
787
+ }
788
+ function waitSeconds(wait) {
789
+ if (wait === false) return 0;
790
+ if (typeof wait === "string" && wait.trim() !== "") {
791
+ const seconds = Number(wait);
792
+ if (!Number.isFinite(seconds) || seconds < 0)
793
+ throw new Error("--wait takes a number of seconds");
794
+ return Math.min(Math.round(seconds), DEFAULT_WAIT_SECONDS);
795
+ }
796
+ if (wait === true) return DEFAULT_WAIT_SECONDS;
797
+ return interactive() ? DEFAULT_WAIT_SECONDS : 0;
798
+ }
799
+ var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
800
+ async function followPaymentReview(api, paymentRequestId, options = {}) {
801
+ let review = await api.startReview(paymentRequestId);
802
+ if (review.nextAction.type === "START_REVIEW_AGAIN") {
803
+ review = await api.startReview(paymentRequestId);
804
+ }
805
+ if (review.state === "PENDING_REVIEW" && review.reviewUrl && !isJsonMode()) {
806
+ printPending("This payment needs an approver to confirm it.");
807
+ printKeyValue("Review", review.reviewUrl);
808
+ if (options.open ?? interactive()) {
809
+ try {
810
+ const open = (await import("open")).default;
811
+ await open(review.reviewUrl);
812
+ } catch {
813
+ }
814
+ }
815
+ }
816
+ const deadline = Date.now() + waitSeconds(options.wait) * 1e3;
817
+ while (review.nextAction.type === "WAIT_FOR_REVIEW" && Date.now() < deadline) {
818
+ await sleep(POLL_INTERVAL_MS);
819
+ review = await api.getReview(review.reviewSessionId);
820
+ }
821
+ return review;
822
+ }
823
+ function paymentReviewExitCode(review) {
824
+ if (review.state === "REJECTED") return PAY_EXIT_REJECTED;
825
+ if (review.state === "EXPIRED" || review.state === "CANCELLED") return PAY_EXIT_EXPIRED;
826
+ if (review.nextAction.type === "WAIT_FOR_REVIEW" || review.state === "CHANGED") {
827
+ return PAY_EXIT_PENDING;
828
+ }
829
+ return 0;
830
+ }
831
+ function printReviewOutcome(review, requestId) {
832
+ if (review.nextAction.type === "WAIT_FOR_REVIEW") {
833
+ printPending("Still waiting for approval. Nothing was sent.");
834
+ console.log(chalk2.dim(` Check later with: conto pay status ${requestId}`));
835
+ return;
836
+ }
837
+ console.log(chalk2.dim(` ${review.nextAction.message}`));
838
+ }
839
+
840
+ // src/commands/pay.ts
841
+ async function sendPayment(api, requestId, config) {
842
+ const result = await api.executePayment(requestId);
843
+ if (isJsonMode()) {
844
+ printJson(result);
845
+ return;
846
+ }
847
+ if (config.sandboxMode === "test") {
848
+ printSuccess("Payment recorded in sandbox test mode");
849
+ } else {
850
+ printSuccess("Payment sent!");
851
+ }
852
+ if (result.receipt?.txHash) printKeyValue("TX Hash", result.receipt?.txHash);
853
+ printKeyValue("Amount", printAmount(result.amount, result.currency));
854
+ printKeyValue("Recipient", result.recipient);
855
+ printKeyValue("Status", result.status);
856
+ printKeyValue("Request ID", requestId);
857
+ if (result.receipt?.settlementMode)
858
+ printKeyValue("Settlement mode", result.receipt.settlementMode);
859
+ if (result.receipt?.explorerUrl) printKeyValue("Explorer", result.receipt?.explorerUrl);
860
+ console.log("");
861
+ }
862
+ async function reviewAndSend(api, requestId, config, options) {
863
+ const review = await followPaymentReview(api, requestId, options);
864
+ if (review.nextAction.type === "EXECUTE_PAYMENT") {
865
+ return sendPayment(api, requestId, config);
866
+ }
867
+ process.exitCode = paymentReviewExitCode(review);
868
+ if (isJsonMode()) {
869
+ printJson({ requestId, review });
870
+ return;
871
+ }
872
+ printReviewOutcome(review, requestId);
873
+ }
874
+ function handlePayError(err) {
875
+ const code = err.code;
876
+ const message = err instanceof Error ? err.message : "Payment failed";
877
+ if (isJsonMode()) {
878
+ printJson({ error: message, code });
879
+ process.exit(1);
880
+ }
881
+ printError(message);
882
+ if (code === "INSUFFICIENT_SCOPE") {
883
+ console.log(
884
+ chalk3.dim(' This SDK key cannot execute payments. Run "conto doctor" to see its scopes,')
885
+ );
886
+ console.log(chalk3.dim(" or create a new standard SDK key (includes payments:execute)."));
887
+ } else if (code === "EXECUTION_UNAVAILABLE") {
888
+ console.log(chalk3.dim(" Try again later or contact Conto support if the issue continues."));
889
+ }
890
+ process.exit(1);
891
+ }
892
+ async function payFollowUpCommand(subcommand, requestId, options) {
893
+ const config = loadConfig();
894
+ if (!config.apiKey) {
895
+ printError(
896
+ 'Not configured. Run "npx @conto_finance/create-conto-agent" or "conto login" first.'
897
+ );
898
+ process.exit(1);
899
+ }
900
+ const api = new PaymentReviewClient({ baseUrl: config.baseUrl, apiKey: config.apiKey });
901
+ try {
902
+ if (subcommand === "execute") return await sendPayment(api, requestId, config);
903
+ return await reviewAndSend(api, requestId, config, { wait: false, open: false, ...options });
904
+ } catch (err) {
905
+ handlePayError(err);
906
+ }
907
+ }
972
908
  var DRY_RUN_NOTICE = "Dry run: nothing was sent to Conto and no policy evaluation was performed.";
973
909
  async function payCommand(address, amountStr, options) {
910
+ if (address === "status" || address === "execute") {
911
+ return payFollowUpCommand(address, amountStr, options);
912
+ }
974
913
  const config = loadConfig();
975
914
  const validation = validatePaymentRequest({
976
915
  address,
@@ -992,7 +931,7 @@ async function payCommand(address, amountStr, options) {
992
931
  });
993
932
  } else {
994
933
  for (const error of validation.errors) printError(error);
995
- console.log(chalk2.dim(`
934
+ console.log(chalk3.dim(`
996
935
  ${DRY_RUN_NOTICE}`));
997
936
  }
998
937
  process.exit(1);
@@ -1016,15 +955,15 @@ async function payCommand(address, amountStr, options) {
1016
955
  if (options.wallet) printKeyValue("Wallet", options.wallet);
1017
956
  console.log("");
1018
957
  printSuccess("Input is valid");
1019
- console.log(chalk2.dim(` Would send: POST ${url}`));
1020
- console.log(chalk2.dim(` ${JSON.stringify(validation.body)}`));
958
+ console.log(chalk3.dim(` Would send: POST ${url}`));
959
+ console.log(chalk3.dim(` ${JSON.stringify(validation.body)}`));
1021
960
  if (!config.apiKey) {
1022
961
  printWarning('No API key configured. Run "conto login" before sending payments.');
1023
962
  }
1024
963
  console.log("");
1025
964
  printWarning(DRY_RUN_NOTICE);
1026
- console.log(chalk2.dim(' Run "conto limits" to see current spend limits.'));
1027
- console.log(chalk2.dim(" Run without --dry-run to submit the payment for policy evaluation."));
965
+ console.log(chalk3.dim(' Run "conto limits" to see current spend limits.'));
966
+ console.log(chalk3.dim(" Run without --dry-run to submit the payment for policy evaluation."));
1028
967
  console.log("");
1029
968
  return;
1030
969
  }
@@ -1039,7 +978,7 @@ async function payCommand(address, amountStr, options) {
1039
978
  process.exit(1);
1040
979
  }
1041
980
  const amount = validation.body.amount;
1042
- const api = createApiClient({
981
+ const api = new PaymentReviewClient({
1043
982
  baseUrl: config.baseUrl,
1044
983
  apiKey: config.apiKey
1045
984
  });
@@ -1066,24 +1005,18 @@ async function payCommand(address, amountStr, options) {
1066
1005
  printError("Payment denied by policy");
1067
1006
  if (request.violations) {
1068
1007
  for (const v of request.violations) {
1069
- console.log(chalk2.red(` ${v.message}`));
1008
+ console.log(chalk3.red(` ${v.message}`));
1070
1009
  }
1071
1010
  }
1072
1011
  if (request.reasons.length > 0) {
1073
- console.log(chalk2.dim(`
1012
+ console.log(chalk3.dim(`
1074
1013
  Reasons: ${request.reasons.join(", ")}`));
1075
1014
  }
1076
1015
  process.exit(1);
1077
1016
  }
1078
1017
  if (request.status === "REQUIRES_APPROVAL") {
1079
- if (isJsonMode()) {
1080
- printJson(request);
1081
- return;
1082
- }
1083
- printPending("Payment requires manual approval");
1084
- printKeyValue("Request ID", request.requestId);
1085
- console.log(chalk2.dim(" Approve in the Conto dashboard to execute."));
1086
- return;
1018
+ if (!isJsonMode()) printKeyValue("Request ID", request.requestId);
1019
+ return await reviewAndSend(api, request.requestId, config, options);
1087
1020
  }
1088
1021
  if (request.status !== "APPROVED") {
1089
1022
  if (isJsonMode()) {
@@ -1093,47 +1026,14 @@ async function payCommand(address, amountStr, options) {
1093
1026
  printPending(`Payment is ${request.status}`);
1094
1027
  printKeyValue("Request ID", request.requestId);
1095
1028
  if (request.reasons.length > 0) {
1096
- console.log(chalk2.dim(` Reasons: ${request.reasons.join(", ")}`));
1029
+ console.log(chalk3.dim(` Reasons: ${request.reasons.join(", ")}`));
1097
1030
  }
1098
- console.log(chalk2.dim(" Check the Conto dashboard for next steps."));
1099
- return;
1100
- }
1101
- const result = await api.executePayment(request.requestId);
1102
- if (isJsonMode()) {
1103
- printJson(result);
1031
+ console.log(chalk3.dim(" Check the Conto dashboard for next steps."));
1104
1032
  return;
1105
1033
  }
1106
- if (config.sandboxMode === "test") {
1107
- printSuccess("Payment recorded in sandbox test mode");
1108
- } else {
1109
- printSuccess("Payment sent!");
1110
- }
1111
- if (result.receipt?.txHash) printKeyValue("TX Hash", result.receipt?.txHash);
1112
- printKeyValue("Amount", printAmount(result.amount, result.currency));
1113
- printKeyValue("Recipient", result.recipient);
1114
- printKeyValue("Status", result.status);
1115
- printKeyValue("Request ID", request.requestId);
1116
- if (result.receipt?.settlementMode)
1117
- printKeyValue("Settlement mode", result.receipt.settlementMode);
1118
- if (result.receipt?.explorerUrl) printKeyValue("Explorer", result.receipt?.explorerUrl);
1119
- console.log("");
1034
+ await sendPayment(api, request.requestId, config);
1120
1035
  } catch (err) {
1121
- const code = err.code;
1122
- const message = err instanceof Error ? err.message : "Payment failed";
1123
- if (isJsonMode()) {
1124
- printJson({ error: message, code });
1125
- process.exit(1);
1126
- }
1127
- printError(message);
1128
- if (code === "INSUFFICIENT_SCOPE") {
1129
- console.log(
1130
- chalk2.dim(' This SDK key cannot execute payments. Run "conto doctor" to see its scopes,')
1131
- );
1132
- console.log(chalk2.dim(" or create a new standard SDK key (includes payments:execute)."));
1133
- } else if (code === "EXECUTION_UNAVAILABLE") {
1134
- console.log(chalk2.dim(" Try again later or contact Conto support if the issue continues."));
1135
- }
1136
- process.exit(1);
1036
+ handlePayError(err);
1137
1037
  }
1138
1038
  }
1139
1039
 
@@ -1225,7 +1125,7 @@ async function transactionsCommand(id, options) {
1225
1125
  }
1226
1126
 
1227
1127
  // src/commands/wallets.ts
1228
- import chalk3 from "chalk";
1128
+ import chalk4 from "chalk";
1229
1129
  async function walletsCommand(subcommand, options = {}) {
1230
1130
  const config = loadConfig();
1231
1131
  if (!config.apiKey) {
@@ -1338,20 +1238,20 @@ async function walletsCommand(subcommand, options = {}) {
1338
1238
  console.log("");
1339
1239
  if (chainEntry?.faucetAvailable && config.testnet) {
1340
1240
  console.log(
1341
- chalk3.cyan(
1241
+ chalk4.cyan(
1342
1242
  ' This is a testnet wallet. Use "conto fund --faucet" to get free test tokens.'
1343
1243
  )
1344
1244
  );
1345
1245
  console.log("");
1346
1246
  } else {
1347
- console.log(` To fund your agent wallet, send ${chalk3.bold(w.currency || "USD")} to:
1247
+ console.log(` To fund your agent wallet, send ${chalk4.bold(w.currency || "USD")} to:
1348
1248
  `);
1349
- console.log(chalk3.bold(` ${w.address}`));
1249
+ console.log(chalk4.bold(` ${w.address}`));
1350
1250
  console.log("");
1351
1251
  const instructions = getFundingInstructions(w.currency || "USD", chainEntry);
1352
1252
  console.log(` How to get ${w.currency || "USD"}:`);
1353
1253
  for (const instruction of instructions) {
1354
- console.log(` ${chalk3.dim("\u2022")} ${instruction}`);
1254
+ console.log(` ${chalk4.dim("\u2022")} ${instruction}`);
1355
1255
  }
1356
1256
  console.log("");
1357
1257
  if (chainEntry) {
@@ -1403,7 +1303,7 @@ function getFundingInstructions(currency, chain) {
1403
1303
  }
1404
1304
 
1405
1305
  // src/commands/policies.ts
1406
- import chalk4 from "chalk";
1306
+ import chalk5 from "chalk";
1407
1307
  import * as p from "@clack/prompts";
1408
1308
  var POLICY_TYPES = [
1409
1309
  {
@@ -1621,7 +1521,7 @@ var ACTIONS = [
1621
1521
  hint: "Payment needs human approval if rule triggers"
1622
1522
  }
1623
1523
  ];
1624
- async function policiesCommand(subcommand = "list", idOrAmount, extra) {
1524
+ async function policiesCommand(subcommand = "list", idOrAmount, extra, reviewOptions = {}) {
1625
1525
  const config = loadConfig();
1626
1526
  if (!config.apiKey) {
1627
1527
  printError(
@@ -1629,7 +1529,7 @@ async function policiesCommand(subcommand = "list", idOrAmount, extra) {
1629
1529
  );
1630
1530
  process.exit(1);
1631
1531
  }
1632
- const api = createApiClient({
1532
+ const api = createOwnerClient({
1633
1533
  baseUrl: config.baseUrl,
1634
1534
  apiKey: config.apiKey,
1635
1535
  orgApiKey: config.orgApiKey
@@ -1647,13 +1547,13 @@ async function policiesCommand(subcommand = "list", idOrAmount, extra) {
1647
1547
  printError("Usage: conto policies update <policy-id>");
1648
1548
  process.exit(1);
1649
1549
  }
1650
- return await updatePolicy(api, idOrAmount);
1550
+ return await updatePolicy(api, idOrAmount, reviewOptions);
1651
1551
  case "delete":
1652
1552
  if (!idOrAmount) {
1653
1553
  printError("Usage: conto policies delete <policy-id>");
1654
1554
  process.exit(1);
1655
1555
  }
1656
- return await deletePolicy(api, idOrAmount);
1556
+ return await deletePolicy(api, idOrAmount, reviewOptions);
1657
1557
  case "assign":
1658
1558
  if (!idOrAmount) {
1659
1559
  printError("Usage: conto policies assign <policy-id>");
@@ -1665,7 +1565,7 @@ async function policiesCommand(subcommand = "list", idOrAmount, extra) {
1665
1565
  printError("Usage: conto policies unassign <policy-id>");
1666
1566
  process.exit(1);
1667
1567
  }
1668
- return await unassignPolicy(api, config.agentId, idOrAmount);
1568
+ return await unassignPolicy(api, config.agentId, idOrAmount, reviewOptions);
1669
1569
  case "add-rule":
1670
1570
  if (!idOrAmount) {
1671
1571
  printError("Usage: conto policies add-rule <policy-id>");
@@ -1677,7 +1577,25 @@ async function policiesCommand(subcommand = "list", idOrAmount, extra) {
1677
1577
  printError("Usage: conto policies remove-rule <policy-id> <rule-id>");
1678
1578
  process.exit(1);
1679
1579
  }
1680
- return await removeRule(api, idOrAmount, extra);
1580
+ return await removeRule(api, idOrAmount, extra, reviewOptions);
1581
+ case "versions":
1582
+ if (!idOrAmount) {
1583
+ printError("Usage: conto policies versions <policy-id>");
1584
+ process.exit(1);
1585
+ }
1586
+ return await listVersions(api, idOrAmount);
1587
+ case "rollback":
1588
+ if (!idOrAmount || !extra) {
1589
+ printError("Usage: conto policies rollback <policy-id> <version>");
1590
+ process.exit(1);
1591
+ }
1592
+ return await rollbackPolicy(api, idOrAmount, Number(extra), reviewOptions);
1593
+ case "simulate":
1594
+ if (!idOrAmount) {
1595
+ printError("Usage: conto policies simulate <policy-id>");
1596
+ process.exit(1);
1597
+ }
1598
+ return await simulatePolicy(api, idOrAmount);
1681
1599
  case "help":
1682
1600
  return printPolicyHelp();
1683
1601
  default:
@@ -1707,21 +1625,21 @@ async function listAgentPolicies(api) {
1707
1625
  }
1708
1626
  printHeader("Agent Policies");
1709
1627
  for (const policy of policies) {
1710
- const scope = policy.scope === "organization" ? chalk4.dim("[organization]") : chalk4.cyan(`[${policy.appliesVia.join("+")}]`);
1628
+ const scope = policy.scope === "organization" ? chalk5.dim("[organization]") : chalk5.cyan(`[${policy.appliesVia.join("+")}]`);
1711
1629
  console.log(
1712
1630
  `
1713
- ${chalk4.bold(policy.name)} ${scope} ${chalk4.dim(`(${policy.policyType}, priority: ${policy.priority})`)}`
1631
+ ${chalk5.bold(policy.name)} ${scope} ${chalk5.dim(`(${policy.policyType}, priority: ${policy.priority})`)}`
1714
1632
  );
1715
- console.log(` ${chalk4.dim("ID:")} ${policy.id}`);
1633
+ console.log(` ${chalk5.dim("ID:")} ${policy.id}`);
1716
1634
  console.log(
1717
- ` ${chalk4.dim("Active:")} ${policy.isActive ? chalk4.green("Yes") : chalk4.red("No")}`
1635
+ ` ${chalk5.dim("Active:")} ${policy.isActive ? chalk5.green("Yes") : chalk5.red("No")}`
1718
1636
  );
1719
1637
  if (policy.rules.length > 0) {
1720
- console.log(` ${chalk4.dim("Rules:")}`);
1638
+ console.log(` ${chalk5.dim("Rules:")}`);
1721
1639
  for (const rule of policy.rules) {
1722
1640
  const valueDisplay = formatRuleValue(rule.ruleType, rule.value);
1723
1641
  console.log(
1724
- ` ${chalk4.dim("\u2022")} ${rule.ruleType} ${rule.operator} ${valueDisplay} \u2192 ${rule.action}`
1642
+ ` ${chalk5.dim("\u2022")} ${rule.ruleType} ${rule.operator} ${valueDisplay} \u2192 ${rule.action}`
1725
1643
  );
1726
1644
  }
1727
1645
  }
@@ -1744,18 +1662,18 @@ async function listAllPolicies(api) {
1744
1662
  const scope = policy.scope === "organization" ? "organization-wide" : `${agentCount} agents`;
1745
1663
  console.log(
1746
1664
  `
1747
- ${chalk4.bold(policy.name)} ${chalk4.dim(`(${policy.policyType}, priority: ${policy.priority}, ${scope})`)}`
1665
+ ${chalk5.bold(policy.name)} ${chalk5.dim(`(${policy.policyType}, priority: ${policy.priority}, ${scope})`)}`
1748
1666
  );
1749
- console.log(` ${chalk4.dim("ID:")} ${policy.id}`);
1667
+ console.log(` ${chalk5.dim("ID:")} ${policy.id}`);
1750
1668
  console.log(
1751
- ` ${chalk4.dim("Active:")} ${policy.isActive ? chalk4.green("Yes") : chalk4.red("No")}`
1669
+ ` ${chalk5.dim("Active:")} ${policy.isActive ? chalk5.green("Yes") : chalk5.red("No")}`
1752
1670
  );
1753
1671
  if (policy.rules.length > 0) {
1754
- console.log(` ${chalk4.dim("Rules:")}`);
1672
+ console.log(` ${chalk5.dim("Rules:")}`);
1755
1673
  for (const rule of policy.rules) {
1756
1674
  const valueDisplay = formatRuleValue(rule.ruleType, rule.value);
1757
1675
  console.log(
1758
- ` ${chalk4.dim("\u2022")} [${rule.id.slice(-6)}] ${rule.ruleType} ${rule.operator} ${valueDisplay} \u2192 ${rule.action}`
1676
+ ` ${chalk5.dim("\u2022")} [${rule.id.slice(-6)}] ${rule.ruleType} ${rule.operator} ${valueDisplay} \u2192 ${rule.action}`
1759
1677
  );
1760
1678
  }
1761
1679
  }
@@ -1819,7 +1737,7 @@ async function createPolicy(api, agentId) {
1819
1737
  if (assignToAgent) printSuccess("Assigned to current agent");
1820
1738
  }
1821
1739
  }
1822
- async function updatePolicy(api, policyId) {
1740
+ async function updatePolicy(api, policyId, reviewOptions) {
1823
1741
  const name = await p.text({
1824
1742
  message: "New name (leave empty to skip)",
1825
1743
  initialValue: ""
@@ -1857,22 +1775,63 @@ async function updatePolicy(api, policyId) {
1857
1775
  printInfo("No changes to make.");
1858
1776
  return;
1859
1777
  }
1860
- const result = await api.updatePolicy(policyId, params);
1778
+ let result;
1779
+ try {
1780
+ result = await api.updatePolicy(policyId, params);
1781
+ } catch (err) {
1782
+ if (!isTightenOnlyRefusal(err)) throw err;
1783
+ return proposePolicyUpdate(api, policyId, params, reviewOptions);
1784
+ }
1861
1785
  if (isJsonMode()) {
1862
1786
  printJson(result);
1863
1787
  } else {
1864
1788
  printSuccess(`Policy "${result.name}" updated`);
1865
1789
  }
1866
1790
  }
1867
- async function deletePolicy(api, policyId) {
1868
- const confirm2 = await p.confirm({
1791
+ async function proposePolicyUpdate(api, policyId, params, reviewOptions) {
1792
+ if (params.scope !== void 0) {
1793
+ throw new Error("This key can't change a policy's scope. Change it in the dashboard.");
1794
+ }
1795
+ const proposals = [];
1796
+ if (params.name !== void 0 || params.priority !== void 0) {
1797
+ proposals.push({
1798
+ action: "update_policy",
1799
+ input: {
1800
+ policy_id: policyId,
1801
+ ...params.name !== void 0 ? { name: params.name } : {},
1802
+ ...params.priority !== void 0 ? { priority: params.priority } : {}
1803
+ },
1804
+ done: "Policy updated."
1805
+ });
1806
+ }
1807
+ if (params.isActive !== void 0) {
1808
+ proposals.push({
1809
+ action: params.isActive ? "activate_policy" : "deactivate_policy",
1810
+ input: { policy_id: policyId },
1811
+ done: params.isActive ? "Policy turned on." : "Policy turned off."
1812
+ });
1813
+ }
1814
+ for (const proposal of proposals) {
1815
+ const outcome = await proposeForReview(api, proposal.action, proposal.input, reviewOptions);
1816
+ reportReview(outcome, proposal.done);
1817
+ if (outcome.exitCode !== 0) return;
1818
+ }
1819
+ }
1820
+ async function deletePolicy(api, policyId, reviewOptions) {
1821
+ const confirm3 = await p.confirm({
1869
1822
  message: `Delete policy ${policyId}? This cannot be undone.`
1870
1823
  });
1871
- if (p.isCancel(confirm2) || !confirm2) {
1824
+ if (p.isCancel(confirm3) || !confirm3) {
1872
1825
  printInfo("Cancelled.");
1873
1826
  return;
1874
1827
  }
1875
- await api.deletePolicy(policyId);
1828
+ const result = await directOrReview(
1829
+ api,
1830
+ () => api.deletePolicy(policyId),
1831
+ async () => ({ action: "delete_policy", input: { policy_id: policyId } }),
1832
+ reviewOptions
1833
+ );
1834
+ if ("review" in result) return reportReview(result.review, `Policy ${policyId} deleted`);
1876
1835
  printSuccess(`Policy ${policyId} deleted`);
1877
1836
  }
1878
1837
  async function assignPolicy(api, agentId, policyId) {
@@ -1883,8 +1842,19 @@ async function assignPolicy(api, agentId, policyId) {
1883
1842
  printSuccess(`Policy ${policyId} assigned to agent`);
1884
1843
  }
1885
1844
  }
1886
- async function unassignPolicy(api, agentId, policyId) {
1887
- await api.unassignPolicyFromAgent(agentId, policyId);
1845
+ async function unassignPolicy(api, agentId, policyId, reviewOptions) {
1846
+ const result = await directOrReview(
1847
+ api,
1848
+ () => api.unassignPolicyFromAgent(agentId, policyId),
1849
+ async () => ({
1850
+ action: "remove_policy_from_agent",
1851
+ input: { policy_id: policyId, agent_id: agentId }
1852
+ }),
1853
+ reviewOptions
1854
+ );
1855
+ if ("review" in result) {
1856
+ return reportReview(result.review, `Policy ${policyId} unassigned from agent`);
1857
+ }
1888
1858
  if (isJsonMode()) {
1889
1859
  printJson({ success: true, agentId, policyId });
1890
1860
  } else {
@@ -1901,8 +1871,26 @@ async function addRule(api, policyId) {
1901
1871
  printSuccess(`Rule "${rule.ruleType}" added to policy`);
1902
1872
  }
1903
1873
  }
1904
- async function removeRule(api, policyId, ruleId) {
1905
- await api.deletePolicyRule(policyId, ruleId);
1874
+ async function removeRule(api, policyId, ruleId, reviewOptions) {
1875
+ const result = await directOrReview(
1876
+ api,
1877
+ () => api.deletePolicyRule(policyId, ruleId),
1878
+ async () => {
1879
+ const { rules } = await api.listPolicyRules(policyId);
1880
+ if (!rules.some((rule) => rule.id === ruleId)) {
1881
+ throw new Error(`Rule ${ruleId} is not on policy ${policyId}.`);
1882
+ }
1883
+ return {
1884
+ action: "update_policy",
1885
+ input: {
1886
+ policy_id: policyId,
1887
+ rules: toToolRules(rules.filter((rule) => rule.id !== ruleId))
1888
+ }
1889
+ };
1890
+ },
1891
+ reviewOptions
1892
+ );
1893
+ if ("review" in result) return reportReview(result.review, `Rule ${ruleId} removed from policy`);
1906
1894
  if (isJsonMode()) {
1907
1895
  printJson({ success: true, policyId, ruleId });
1908
1896
  } else {
@@ -2003,8 +1991,8 @@ async function promptForRule(policyType) {
2003
1991
  };
2004
1992
  }
2005
1993
  function printPolicyHelp() {
2006
- console.log(chalk4.bold("\n Conto Policy Management\n"));
2007
- console.log(chalk4.bold(" Commands:"));
1994
+ console.log(chalk5.bold("\n Conto Policy Management\n"));
1995
+ console.log(chalk5.bold(" Commands:"));
2008
1996
  console.log(" conto policies List agent policies");
2009
1997
  console.log(" conto policies all List all org policies");
2010
1998
  console.log(" conto policies create Create a new policy");
@@ -2015,11 +2003,11 @@ function printPolicyHelp() {
2015
2003
  console.log(" conto policies add-rule <id> Add a rule");
2016
2004
  console.log(" conto policies remove-rule <id> <rid> Remove a rule");
2017
2005
  console.log(" conto policies help This help page");
2018
- console.log(chalk4.bold("\n Policy Types:"));
2006
+ console.log(chalk5.bold("\n Policy Types:"));
2019
2007
  for (const pt of POLICY_TYPES) {
2020
- console.log(` ${chalk4.cyan(pt.value.padEnd(22))} ${chalk4.dim(pt.hint)}`);
2008
+ console.log(` ${chalk5.cyan(pt.value.padEnd(22))} ${chalk5.dim(pt.hint)}`);
2021
2009
  }
2022
- console.log(chalk4.bold("\n Common Rule Types:"));
2010
+ console.log(chalk5.bold("\n Common Rule Types:"));
2023
2011
  const commonRules = [
2024
2012
  ["MAX_AMOUNT", "Max per-transaction amount (e.g. 500)"],
2025
2013
  ["DAILY_LIMIT", "Max total spend per day (e.g. 1000)"],
@@ -2033,9 +2021,9 @@ function printPolicyHelp() {
2033
2021
  ["DATE_RANGE", 'JSON: {"start":"2025-01-01","end":"2025-12-31"}']
2034
2022
  ];
2035
2023
  for (const [rule, desc] of commonRules) {
2036
- console.log(` ${chalk4.cyan(rule.padEnd(28))} ${chalk4.dim(desc)}`);
2024
+ console.log(` ${chalk5.cyan(rule.padEnd(28))} ${chalk5.dim(desc)}`);
2037
2025
  }
2038
- console.log(chalk4.bold("\n Value Examples:"));
2026
+ console.log(chalk5.bold("\n Value Examples:"));
2039
2027
  console.log(" Spend limits: 500");
2040
2028
  console.log(' Address lists: ["0xabc...","0xdef..."]');
2041
2029
  console.log(' Country codes: ["CU","IR","KP","SY","RU"]');
@@ -2043,24 +2031,24 @@ function printPolicyHelp() {
2043
2031
  console.log(' Velocity: {"maxCount":5,"period":"HOUR"}');
2044
2032
  console.log(' Date range: {"start":"2025-01-01","end":"2025-12-31"}');
2045
2033
  console.log(' Categories: ["API_PROVIDER","CLOUD","SAAS"]');
2046
- console.log(chalk4.bold("\n Operators:"));
2034
+ console.log(chalk5.bold("\n Operators:"));
2047
2035
  console.log(" LTE (<= at most) GTE (>= at least) EQUALS NOT_EQUALS");
2048
2036
  console.log(" IN_LIST NOT_IN_LIST BETWEEN DENY");
2049
- console.log(chalk4.bold("\n Actions:"));
2050
- console.log(` ${chalk4.green("ALLOW")} Payment proceeds if rule passes`);
2051
- console.log(` ${chalk4.red("DENY")} Payment is blocked`);
2052
- console.log(` ${chalk4.yellow("REQUIRE_APPROVAL")} Payment needs human approval`);
2053
- console.log(chalk4.bold("\n Examples:"));
2054
- console.log(chalk4.dim(" # Create a $500/day spend limit"));
2037
+ console.log(chalk5.bold("\n Actions:"));
2038
+ console.log(` ${chalk5.green("ALLOW")} Payment proceeds if rule passes`);
2039
+ console.log(` ${chalk5.red("DENY")} Payment is blocked`);
2040
+ console.log(` ${chalk5.yellow("REQUIRE_APPROVAL")} Payment needs human approval`);
2041
+ console.log(chalk5.bold("\n Examples:"));
2042
+ console.log(chalk5.dim(" # Create a $500/day spend limit"));
2055
2043
  console.log(" conto policies create");
2056
- console.log(chalk4.dim(" # Add a weekly limit rule to an existing policy"));
2044
+ console.log(chalk5.dim(" # Add a weekly limit rule to an existing policy"));
2057
2045
  console.log(" conto policies add-rule cmn4abc123");
2058
- console.log(chalk4.dim(" # Deactivate a policy without deleting"));
2046
+ console.log(chalk5.dim(" # Deactivate a policy without deleting"));
2059
2047
  console.log(" conto policies update cmn4abc123");
2060
- console.log(chalk4.dim(" # View all policies as JSON"));
2048
+ console.log(chalk5.dim(" # View all policies as JSON"));
2061
2049
  console.log(" conto policies all --json");
2062
2050
  console.log(`
2063
- ${chalk4.dim("Full docs: https://conto.finance/docs/cli/policies")}
2051
+ ${chalk5.dim("Full docs: https://conto.finance/docs/cli/policies")}
2064
2052
  `);
2065
2053
  }
2066
2054
  function formatRuleValue(ruleType, value) {
@@ -2075,9 +2063,89 @@ function formatRuleValue(ruleType, value) {
2075
2063
  }
2076
2064
  return value;
2077
2065
  }
2066
+ function toToolRules(rules) {
2067
+ return rules.map((rule) => ({
2068
+ rule_type: rule.ruleType,
2069
+ operator: rule.operator,
2070
+ value: rule.value,
2071
+ action: rule.action
2072
+ }));
2073
+ }
2074
+ async function listVersions(api, policyId) {
2075
+ const { versions } = await api.listPolicyVersions(policyId);
2076
+ if (isJsonMode()) return printJson(versions);
2077
+ if (versions.length === 0) return printInfo("This policy has no saved versions yet.");
2078
+ printHeader("Policy versions");
2079
+ for (const version of versions) {
2080
+ console.log(
2081
+ ` ${chalk5.bold(`v${version.version}`)} ${version.changeType.toLowerCase()} ${chalk5.dim(
2082
+ new Date(version.createdAt).toLocaleString()
2083
+ )} ${version.rulesCount} rule${version.rulesCount === 1 ? "" : "s"}${version.note ? chalk5.dim(` ${version.note}`) : ""}`
2084
+ );
2085
+ }
2086
+ console.log("");
2087
+ }
2088
+ async function rollbackPolicy(api, policyId, version, reviewOptions) {
2089
+ if (!Number.isInteger(version) || version < 1) {
2090
+ throw new Error(
2091
+ "Pass the version number to restore, for example: conto policies rollback <id> 3"
2092
+ );
2093
+ }
2094
+ const result = await directOrReview(
2095
+ api,
2096
+ () => api.rollbackPolicyDirect(policyId, version),
2097
+ async () => {
2098
+ const { snapshot } = await api.getPolicyVersion(policyId, version);
2099
+ return {
2100
+ action: "update_policy",
2101
+ input: {
2102
+ policy_id: policyId,
2103
+ name: snapshot.name,
2104
+ description: snapshot.description,
2105
+ priority: snapshot.priority,
2106
+ rules: toToolRules(snapshot.rules)
2107
+ }
2108
+ };
2109
+ },
2110
+ reviewOptions
2111
+ );
2112
+ if ("review" in result) return reportReview(result.review, `Policy restored to v${version}`);
2113
+ if (isJsonMode()) return printJson(result.direct);
2114
+ printSuccess(`Policy restored to v${version}`);
2115
+ }
2116
+ async function simulatePolicy(api, policyId) {
2117
+ const policy = await api.getPolicy(policyId);
2118
+ const { summary, results } = await api.simulatePolicy({
2119
+ candidatePolicy: {
2120
+ name: policy.name,
2121
+ policyType: policy.policyType,
2122
+ rules: policy.rules.map((rule) => ({
2123
+ ruleType: rule.ruleType,
2124
+ operator: rule.operator,
2125
+ value: rule.value,
2126
+ action: rule.action
2127
+ }))
2128
+ }
2129
+ });
2130
+ if (isJsonMode()) return printJson({ summary, results });
2131
+ printHeader(`${policy.name} on your last ${summary.total} payments`);
2132
+ console.log(
2133
+ ` ${summary.allow} allowed, ${summary.deny} blocked, ${summary.requireApproval} need approval`
2134
+ );
2135
+ console.log(
2136
+ chalk5.dim(` ${summary.newlyBlocked} newly blocked, ${summary.newlyAllowed} newly allowed`)
2137
+ );
2138
+ const changed = results.filter((row) => row.changed).slice(0, 10);
2139
+ for (const row of changed) {
2140
+ console.log(
2141
+ ` ${row.amount} to ${row.recipient ?? "unknown"}: ${row.currentResult} -> ${row.wouldBe}${row.reasons[0] ? chalk5.dim(` ${row.reasons[0]}`) : ""}`
2142
+ );
2143
+ }
2144
+ console.log("");
2145
+ }
2078
2146
 
2079
2147
  // src/commands/limits.ts
2080
- import chalk5 from "chalk";
2148
+ import chalk6 from "chalk";
2081
2149
  async function limitsCommand() {
2082
2150
  const config = loadConfig();
2083
2151
  if (!config.apiKey) {
@@ -2103,21 +2171,21 @@ async function limitsCommand() {
2103
2171
  printHeader("Spending Limits");
2104
2172
  for (const l of limits) {
2105
2173
  console.log(`
2106
- ${chalk5.bold(l.walletName)}`);
2174
+ ${chalk6.bold(l.walletName)}`);
2107
2175
  const dailyPct = l.daily.limit > 0 ? Math.round(l.daily.spent / l.daily.limit * 100) : 0;
2108
2176
  console.log(
2109
- ` ${chalk5.dim("Daily:")} ${bar(dailyPct)} ${printAmount(l.daily.spent, "USD")} / ${printAmount(l.daily.limit, "USD")} ${chalk5.dim(`(${printAmount(l.daily.remaining, "USD")} remaining)`)}`
2177
+ ` ${chalk6.dim("Daily:")} ${bar(dailyPct)} ${printAmount(l.daily.spent, "USD")} / ${printAmount(l.daily.limit, "USD")} ${chalk6.dim(`(${printAmount(l.daily.remaining, "USD")} remaining)`)}`
2110
2178
  );
2111
2179
  if (l.weekly) {
2112
2180
  const weeklyPct = l.weekly.limit > 0 ? Math.round(l.weekly.spent / l.weekly.limit * 100) : 0;
2113
2181
  console.log(
2114
- ` ${chalk5.dim("Weekly:")} ${bar(weeklyPct)} ${printAmount(l.weekly.spent, "USD")} / ${printAmount(l.weekly.limit, "USD")} ${chalk5.dim(`(${printAmount(l.weekly.remaining, "USD")} remaining)`)}`
2182
+ ` ${chalk6.dim("Weekly:")} ${bar(weeklyPct)} ${printAmount(l.weekly.spent, "USD")} / ${printAmount(l.weekly.limit, "USD")} ${chalk6.dim(`(${printAmount(l.weekly.remaining, "USD")} remaining)`)}`
2115
2183
  );
2116
2184
  }
2117
2185
  if (l.monthly) {
2118
2186
  const monthlyPct = l.monthly.limit > 0 ? Math.round(l.monthly.spent / l.monthly.limit * 100) : 0;
2119
2187
  console.log(
2120
- ` ${chalk5.dim("Monthly:")} ${bar(monthlyPct)} ${printAmount(l.monthly.spent, "USD")} / ${printAmount(l.monthly.limit, "USD")} ${chalk5.dim(`(${printAmount(l.monthly.remaining, "USD")} remaining)`)}`
2188
+ ` ${chalk6.dim("Monthly:")} ${bar(monthlyPct)} ${printAmount(l.monthly.spent, "USD")} / ${printAmount(l.monthly.limit, "USD")} ${chalk6.dim(`(${printAmount(l.monthly.remaining, "USD")} remaining)`)}`
2121
2189
  );
2122
2190
  }
2123
2191
  printKeyValue(" Per-TX max", printAmount(l.perTransaction, "USD"));
@@ -2141,7 +2209,64 @@ function bar(pct, width = 15) {
2141
2209
  }
2142
2210
 
2143
2211
  // src/commands/alerts.ts
2144
- import chalk6 from "chalk";
2212
+ import chalk8 from "chalk";
2213
+
2214
+ // src/lib/owner-command.ts
2215
+ import chalk7 from "chalk";
2216
+ var LOGIN_HINT = 'This command needs your organization login. Run "conto login" (or set CONTO_ORG_API_KEY) and try again.';
2217
+ async function runOwnerCommand(needs, fn) {
2218
+ const config = loadConfig();
2219
+ if (needs === "org" && !config.orgApiKey) {
2220
+ fail(LOGIN_HINT, "ORG_KEY_REQUIRED");
2221
+ return;
2222
+ }
2223
+ if (needs === "sdk" && !config.apiKey) {
2224
+ fail(
2225
+ 'Not configured. Run "npx @conto_finance/create-conto-agent" or "conto login" first.',
2226
+ "SDK_KEY_REQUIRED"
2227
+ );
2228
+ return;
2229
+ }
2230
+ const api = createOwnerClient({
2231
+ baseUrl: config.baseUrl,
2232
+ apiKey: config.apiKey,
2233
+ orgApiKey: config.orgApiKey
2234
+ });
2235
+ try {
2236
+ await fn({ api, config });
2237
+ } catch (err) {
2238
+ const error = err;
2239
+ if (error.status === 401) {
2240
+ fail(`${error.message}. ${LOGIN_HINT}`, error.code ?? "AUTH_FAILED");
2241
+ return;
2242
+ }
2243
+ fail(error.message || "Request failed", error.code, error.recovery);
2244
+ }
2245
+ }
2246
+ function fail(message, code, recovery) {
2247
+ process.exitCode = 1;
2248
+ if (isJsonMode()) {
2249
+ printJson({
2250
+ ok: false,
2251
+ error: message,
2252
+ ...code ? { code } : {},
2253
+ ...recovery ? { recovery } : {}
2254
+ });
2255
+ return;
2256
+ }
2257
+ printError(message);
2258
+ if (recovery) console.log(chalk7.dim(` ${recovery}`));
2259
+ }
2260
+ function parseUsd(value, flag) {
2261
+ if (value === void 0) return void 0;
2262
+ const amount = Number(value);
2263
+ if (!Number.isFinite(amount) || amount < 0) {
2264
+ throw new Error(`${flag} takes an amount in USD, for example 250`);
2265
+ }
2266
+ return amount;
2267
+ }
2268
+
2269
+ // src/commands/alerts.ts
2145
2270
  async function alertsCommand(options = {}) {
2146
2271
  const config = loadConfig();
2147
2272
  if (!config.apiKey) {
@@ -2190,20 +2315,449 @@ async function alertsCommand(options = {}) {
2190
2315
  function severityColor(severity) {
2191
2316
  switch (severity.toUpperCase()) {
2192
2317
  case "CRITICAL":
2193
- return chalk6.red.bold(severity);
2318
+ return chalk8.red.bold(severity);
2194
2319
  case "HIGH":
2195
- return chalk6.red(severity);
2320
+ return chalk8.red(severity);
2196
2321
  case "MEDIUM":
2197
- return chalk6.yellow(severity);
2322
+ return chalk8.yellow(severity);
2198
2323
  case "LOW":
2199
- return chalk6.dim(severity);
2324
+ return chalk8.dim(severity);
2200
2325
  default:
2201
2326
  return severity;
2202
2327
  }
2203
2328
  }
2329
+ async function alertUpdateCommand(alertId, action) {
2330
+ await runOwnerCommand("sdk", async ({ api }) => {
2331
+ const result = await api.updateAlert(alertId, action);
2332
+ if (isJsonMode()) return printJson(result);
2333
+ printSuccess(action === "acknowledge" ? "Alert acknowledged." : "Alert resolved.");
2334
+ });
2335
+ }
2336
+
2337
+ // src/commands/agents.ts
2338
+ import * as p2 from "@clack/prompts";
2339
+ async function agentsListCommand() {
2340
+ await runOwnerCommand("org", async ({ api }) => {
2341
+ const { agents } = await api.listAgents();
2342
+ if (isJsonMode()) return printJson(agents);
2343
+ if (agents.length === 0) return printInfo("No agents yet.");
2344
+ printHeader("Agents");
2345
+ printTable(
2346
+ ["ID", "Name", "Status", "Wallets", "Payments"],
2347
+ agents.map((agent) => [
2348
+ agent.id,
2349
+ agent.name,
2350
+ agent.status,
2351
+ agent.linkedWalletCount ?? 0,
2352
+ agent.transactionCount ?? 0
2353
+ ])
2354
+ );
2355
+ });
2356
+ }
2357
+ async function agentsShowCommand(agentId) {
2358
+ await runOwnerCommand("org", async ({ api }) => {
2359
+ const agent = await api.getAgent(agentId);
2360
+ if (isJsonMode()) return printJson(agent);
2361
+ printHeader(agent.name);
2362
+ printKeyValue("ID", agent.id);
2363
+ printKeyValue("Status", agent.status);
2364
+ if (agent.environment) printKeyValue("Environment", agent.environment);
2365
+ if (agent.owner?.name) printKeyValue("Owner", agent.owner.name);
2366
+ printKeyValue("Linked wallets", agent.linkedWalletCount ?? 0);
2367
+ printKeyValue("Payments", agent.transactionCount ?? 0);
2368
+ });
2369
+ }
2370
+ async function agentsPauseCommand(agentId) {
2371
+ await runOwnerCommand("org", async ({ api }) => {
2372
+ const agent = await api.updateAgentStatus(agentId, "PAUSED");
2373
+ if (isJsonMode()) return printJson(agent);
2374
+ printSuccess(`Agent ${agent.name} is paused. Its key stops working for new payments.`);
2375
+ });
2376
+ }
2377
+ async function agentsResumeCommand(agentId, options) {
2378
+ await runOwnerCommand("org", async ({ api }) => {
2379
+ const result = await directOrReview(
2380
+ api,
2381
+ () => api.updateAgentStatus(agentId, "ACTIVE"),
2382
+ async () => ({ action: "activate_agent", input: { agent_id: agentId } }),
2383
+ options
2384
+ );
2385
+ if ("review" in result) return reportReview(result.review, "Agent resumed.");
2386
+ if (isJsonMode()) return printJson(result.direct);
2387
+ printSuccess(`Agent ${result.direct.name} is active again.`);
2388
+ });
2389
+ }
2390
+ async function agentsFreezeCommand(agentId, options) {
2391
+ await runOwnerCommand("org", async ({ api }) => {
2392
+ const result = await api.freezeAgent(agentId, {
2393
+ ...options.reason ? { reason: options.reason } : {},
2394
+ freezeWallets: options.wallets === true
2395
+ });
2396
+ if (isJsonMode()) return printJson(result);
2397
+ printSuccess(
2398
+ options.wallets ? "Agent frozen, along with the wallets only it uses." : "Agent frozen. It cannot pay until the freeze is lifted."
2399
+ );
2400
+ });
2401
+ }
2402
+ async function agentsUnfreezeCommand(agentId, options) {
2403
+ await runOwnerCommand("org", async ({ api }) => {
2404
+ const result = await directOrReview(
2405
+ api,
2406
+ () => api.unfreezeAgent(agentId, {
2407
+ ...options.reason ? { reason: options.reason } : {},
2408
+ unfreezeWallets: options.wallets === true
2409
+ }),
2410
+ async () => ({
2411
+ action: "activate_agent",
2412
+ input: {
2413
+ agent_id: agentId,
2414
+ restore_wallets: options.wallets === true,
2415
+ ...options.reason ? { reason: options.reason } : {}
2416
+ }
2417
+ }),
2418
+ options
2419
+ );
2420
+ if ("review" in result) return reportReview(result.review, "Freeze lifted.");
2421
+ if (isJsonMode()) return printJson(result.direct);
2422
+ printSuccess("Freeze lifted. The agent can pay again within its limits.");
2423
+ });
2424
+ }
2425
+ async function agentsDeleteCommand(agentId, options) {
2426
+ await runOwnerCommand("org", async ({ api }) => {
2427
+ if (!options.yes) {
2428
+ if (!process.stdin.isTTY || isJsonMode()) {
2429
+ throw new Error("Deleting an agent cannot be undone. Pass --yes to confirm.");
2430
+ }
2431
+ const agent = await api.getAgent(agentId);
2432
+ const confirmed = await p2.confirm({
2433
+ message: `Delete agent ${agent.name}? Its keys stop working. This cannot be undone.`
2434
+ });
2435
+ if (p2.isCancel(confirmed) || !confirmed) return printInfo("Cancelled.");
2436
+ }
2437
+ const result = await directOrReview(
2438
+ api,
2439
+ () => api.deleteAgent(agentId),
2440
+ async () => ({ action: "delete_agent", input: { agent_id: agentId } }),
2441
+ options
2442
+ );
2443
+ if ("review" in result) return reportReview(result.review, "Agent deleted.");
2444
+ if (isJsonMode()) return printJson(result.direct);
2445
+ printSuccess("Agent deleted.");
2446
+ });
2447
+ }
2448
+ async function agentsKeysListCommand(agentId) {
2449
+ await runOwnerCommand("org", async ({ api }) => {
2450
+ const keys = await api.listSdkKeys(agentId);
2451
+ if (isJsonMode()) return printJson(keys);
2452
+ if (keys.length === 0) return printInfo("This agent has no SDK keys.");
2453
+ printHeader("SDK keys");
2454
+ printTable(
2455
+ ["ID", "Name", "Prefix", "Type", "Status", "Last used"],
2456
+ keys.map((key) => [
2457
+ key.id,
2458
+ key.name,
2459
+ key.keyPrefix,
2460
+ key.keyType,
2461
+ key.revokedAt ? "revoked" : key.isActive ? "active" : "inactive",
2462
+ key.lastUsedAt ? new Date(key.lastUsedAt).toLocaleString() : "never"
2463
+ ])
2464
+ );
2465
+ });
2466
+ }
2467
+ async function agentsKeysCreateCommand(agentId, options) {
2468
+ await runOwnerCommand("org", async ({ api }) => {
2469
+ const name = options.name?.trim() || "CLI key";
2470
+ const result = await directOrReview(
2471
+ api,
2472
+ () => api.createSdkKeyDirect(agentId, name),
2473
+ async () => ({ action: "generate_sdk_key", input: { agent_id: agentId, key_name: name } }),
2474
+ options
2475
+ );
2476
+ if ("review" in result) return reportReview(result.review, `SDK key "${name}" created.`);
2477
+ if (isJsonMode()) return printJson(result.direct);
2478
+ printSuccess(`SDK key "${name}" created.`);
2479
+ printKeyValue("SDK key", result.direct.key);
2480
+ printWarning("This key is shown once. Store it now, for example as CONTO_API_KEY in .env.");
2481
+ });
2482
+ }
2483
+ async function agentsKeysRevokeCommand(agentId, keyId) {
2484
+ await runOwnerCommand("org", async ({ api }) => {
2485
+ const result = await api.revokeSdkKey(agentId, keyId);
2486
+ if (isJsonMode()) return printJson(result);
2487
+ printSuccess("SDK key revoked. It stops working right away.");
2488
+ });
2489
+ }
2490
+
2491
+ // src/commands/wallet-controls.ts
2492
+ var PERIODS = [
2493
+ ["perTx", "per_tx", "PerTx"],
2494
+ ["daily", "daily", "Daily"],
2495
+ ["weekly", "weekly", "Weekly"],
2496
+ ["monthly", "monthly", "Monthly"]
2497
+ ];
2498
+ function readLimits(options) {
2499
+ const body = {};
2500
+ const input = {};
2501
+ for (const [flag, snake, camel] of PERIODS) {
2502
+ const amount = parseUsd(options[flag], `--${flag === "perTx" ? "per-tx" : flag}`);
2503
+ if (amount === void 0) continue;
2504
+ body[`spendLimit${camel}`] = amount;
2505
+ input[`spend_limit_${snake}`] = amount;
2506
+ }
2507
+ if (options.clearWeekly) {
2508
+ body.spendLimitWeekly = null;
2509
+ input.remove_weekly_limit = true;
2510
+ }
2511
+ if (options.clearMonthly) {
2512
+ body.spendLimitMonthly = null;
2513
+ input.remove_monthly_limit = true;
2514
+ }
2515
+ return { body, input };
2516
+ }
2517
+ async function walletFreezeCommand(walletId) {
2518
+ await runOwnerCommand("org", async ({ api }) => {
2519
+ const wallet = await api.updateWallet(walletId, "FROZEN");
2520
+ if (isJsonMode()) return printJson(wallet);
2521
+ printSuccess("Wallet frozen. No agent can pay from it until it is unfrozen.");
2522
+ });
2523
+ }
2524
+ async function walletUnfreezeCommand(walletId, options) {
2525
+ await runOwnerCommand("org", async ({ api }) => {
2526
+ const result = await directOrReview(
2527
+ api,
2528
+ () => api.updateWallet(walletId, "ACTIVE"),
2529
+ async () => ({ action: "reactivate_wallet", input: { wallet_id: walletId } }),
2530
+ options
2531
+ );
2532
+ if ("review" in result) return reportReview(result.review, "Wallet unfrozen.");
2533
+ if (isJsonMode()) return printJson(result.direct);
2534
+ printSuccess("Wallet unfrozen. Linked agents can pay from it again.");
2535
+ });
2536
+ }
2537
+ async function walletLinkCommand(agentId, walletId, options) {
2538
+ await runOwnerCommand("org", async ({ api }) => {
2539
+ const { body, input } = readLimits(options);
2540
+ const delegation = options.delegation?.toUpperCase();
2541
+ const result = await directOrReview(
2542
+ api,
2543
+ () => api.linkWallet(agentId, {
2544
+ walletId,
2545
+ ...body,
2546
+ ...delegation ? { delegationType: delegation } : {}
2547
+ }),
2548
+ async () => ({
2549
+ action: "link_wallet_to_agent",
2550
+ input: {
2551
+ agent_id: agentId,
2552
+ wallet_id: walletId,
2553
+ ...input,
2554
+ ...delegation ? { delegation_type: delegation } : {}
2555
+ }
2556
+ }),
2557
+ options
2558
+ );
2559
+ if ("review" in result) return reportReview(result.review, "Wallet linked.");
2560
+ if (isJsonMode()) return printJson(result.direct);
2561
+ printSuccess("Wallet linked. The agent can spend from it within the limits set.");
2562
+ });
2563
+ }
2564
+ async function walletUnlinkCommand(agentId, walletId) {
2565
+ await runOwnerCommand("org", async ({ api }) => {
2566
+ const result = await api.unlinkWallet(agentId, walletId);
2567
+ if (isJsonMode()) return printJson(result);
2568
+ printSuccess("Wallet unlinked. The agent can no longer spend from it.");
2569
+ });
2570
+ }
2571
+ async function walletLimitsCommand(agentId, walletId, options) {
2572
+ await runOwnerCommand("org", async ({ api }) => {
2573
+ const { body, input } = readLimits(options);
2574
+ if (Object.keys(body).length === 0) {
2575
+ throw new Error(
2576
+ "Pass at least one limit: --per-tx, --daily, --weekly, --monthly, --clear-weekly, or --clear-monthly."
2577
+ );
2578
+ }
2579
+ const result = await directOrReview(
2580
+ api,
2581
+ () => api.updateWalletLink(agentId, walletId, body),
2582
+ async () => ({
2583
+ action: "update_agent_wallet_limits",
2584
+ input: { agent_id: agentId, wallet_id: walletId, ...input }
2585
+ }),
2586
+ options
2587
+ );
2588
+ if ("review" in result) return reportReview(result.review, "Limits updated.");
2589
+ if (isJsonMode()) return printJson(result.direct);
2590
+ printSuccess("Limits updated.");
2591
+ });
2592
+ }
2593
+
2594
+ // src/commands/counterparties.ts
2595
+ async function counterpartiesListCommand() {
2596
+ await runOwnerCommand("org", async ({ api }) => {
2597
+ const { counterparties } = await api.listCounterparties();
2598
+ if (isJsonMode()) return printJson(counterparties);
2599
+ if (counterparties.length === 0) return printInfo("No payees yet.");
2600
+ printHeader("Payees");
2601
+ printTable(
2602
+ ["ID", "Name", "Address", "Status", "Trust"],
2603
+ counterparties.map((payee) => [
2604
+ payee.id,
2605
+ payee.name,
2606
+ payee.address ? truncateAddress(payee.address) : "",
2607
+ payee.lifecycleStatus,
2608
+ `${payee.trustLevel} (${payee.trustScore})`
2609
+ ])
2610
+ );
2611
+ });
2612
+ }
2613
+ async function counterpartiesShowCommand(id) {
2614
+ await runOwnerCommand("org", async ({ api }) => {
2615
+ const payee = await api.getCounterparty(id);
2616
+ if (isJsonMode()) return printJson(payee);
2617
+ printHeader(payee.name);
2618
+ printKeyValue("ID", payee.id);
2619
+ if (payee.address) printKeyValue("Address", payee.address);
2620
+ printKeyValue("Type", payee.type);
2621
+ printKeyValue("Status", payee.lifecycleStatus);
2622
+ printKeyValue("Trust", `${payee.trustLevel} (${payee.trustScore})`);
2623
+ });
2624
+ }
2625
+ async function counterpartiesAddCommand(options) {
2626
+ await runOwnerCommand("org", async ({ api }) => {
2627
+ if (!options.name || !options.address) {
2628
+ throw new Error("Pass --name and --address.");
2629
+ }
2630
+ const payee = await api.createCounterparty({
2631
+ name: options.name,
2632
+ address: options.address,
2633
+ ...options.type ? { type: options.type.toUpperCase() } : {},
2634
+ ...options.category ? { category: options.category } : {}
2635
+ });
2636
+ if (isJsonMode()) return printJson(payee);
2637
+ printSuccess(`Payee ${payee.name} added. It stays pending until it is approved.`);
2638
+ printKeyValue("ID", payee.id);
2639
+ });
2640
+ }
2641
+ async function counterpartiesBlockCommand(id) {
2642
+ await runOwnerCommand("org", async ({ api }) => {
2643
+ const payee = await api.updateCounterparty(id, { lifecycleStatus: "BLOCKED" });
2644
+ if (isJsonMode()) return printJson(payee);
2645
+ printSuccess(`Payee ${payee.name} is blocked. Agents cannot pay it.`);
2646
+ });
2647
+ }
2648
+ async function counterpartiesApproveCommand(id, options) {
2649
+ await runOwnerCommand("org", async ({ api }) => {
2650
+ const result = await directOrReview(
2651
+ api,
2652
+ () => api.updateCounterparty(id, { lifecycleStatus: "APPROVED" }),
2653
+ async () => ({
2654
+ action: "set_counterparty_status",
2655
+ input: {
2656
+ counterparty_id: id,
2657
+ status: "APPROVED",
2658
+ ...options.reason ? { reason: options.reason } : {}
2659
+ }
2660
+ }),
2661
+ options
2662
+ );
2663
+ if ("review" in result) return reportReview(result.review, "Payee approved.");
2664
+ if (isJsonMode()) return printJson(result.direct);
2665
+ printSuccess(`Payee ${result.direct.name} is approved.`);
2666
+ });
2667
+ }
2668
+
2669
+ // src/commands/channels.ts
2670
+ import { randomBytes } from "crypto";
2671
+ async function channelsListCommand() {
2672
+ await runOwnerCommand("org", async ({ api }) => {
2673
+ const { channels } = await api.listChannels();
2674
+ if (isJsonMode()) return printJson(channels);
2675
+ if (channels.length === 0) return printInfo("No event delivery channels yet.");
2676
+ printHeader("Event delivery channels");
2677
+ printTable(
2678
+ ["ID", "Name", "Type", "Sends to", "Events", "Status"],
2679
+ channels.map((channel) => [
2680
+ channel.id,
2681
+ channel.name,
2682
+ channel.channelType,
2683
+ channel.destination ?? "",
2684
+ channel.eventTypes.join(", "),
2685
+ channel.needsAttention ? "needs attention" : channel.isActive ? "active" : "off"
2686
+ ])
2687
+ );
2688
+ });
2689
+ }
2690
+ async function channelsAddCommand(options) {
2691
+ await runOwnerCommand("org", async ({ api }) => {
2692
+ const type = options.type?.toUpperCase();
2693
+ if (!options.name || !type) throw new Error("Pass --name and --type (email or webhook).");
2694
+ let config;
2695
+ let webhookSecret;
2696
+ if (type === "EMAIL") {
2697
+ const recipients = (options.recipients ?? "").split(",").map((email) => email.trim()).filter(Boolean);
2698
+ if (recipients.length === 0) throw new Error("Pass --recipients with one or more emails.");
2699
+ config = { recipients };
2700
+ } else if (type === "WEBHOOK") {
2701
+ if (!options.url) throw new Error("Pass --url with the https address to send events to.");
2702
+ webhookSecret = process.env.CONTO_WEBHOOK_SECRET || randomBytes(32).toString("hex");
2703
+ config = { url: options.url, secret: webhookSecret };
2704
+ } else {
2705
+ throw new Error(
2706
+ "The CLI adds email and webhook channels. Add Slack, Telegram or WhatsApp in Settings > Event Delivery."
2707
+ );
2708
+ }
2709
+ const eventTypes = options.events?.split(",").map((event) => event.trim()).filter(Boolean);
2710
+ const created = await api.createChannel({
2711
+ channelType: type,
2712
+ name: options.name,
2713
+ config,
2714
+ ...eventTypes?.length ? { eventTypes } : {}
2715
+ });
2716
+ if (isJsonMode()) {
2717
+ return printJson({ ...created, ...webhookSecret ? { webhookSecret } : {} });
2718
+ }
2719
+ printSuccess(`Channel ${options.name} added.`);
2720
+ if (webhookSecret && !process.env.CONTO_WEBHOOK_SECRET) {
2721
+ printKeyValue("Signing secret", webhookSecret);
2722
+ printWarning("Store this secret now to verify event signatures. It is not shown again.");
2723
+ }
2724
+ });
2725
+ }
2726
+ async function channelsTestCommand(id) {
2727
+ await runOwnerCommand("org", async ({ api }) => {
2728
+ const result = await api.testChannel(id);
2729
+ if (isJsonMode()) return printJson(result);
2730
+ printSuccess("Test event sent.");
2731
+ });
2732
+ }
2733
+ async function channelsRemoveCommand(id, options) {
2734
+ await runOwnerCommand("org", async ({ api }) => {
2735
+ const result = await directOrReview(
2736
+ api,
2737
+ () => api.deleteChannel(id),
2738
+ async () => ({ action: "remove_notification_channel", input: { channel_id: id } }),
2739
+ options
2740
+ );
2741
+ if ("review" in result) return reportReview(result.review, "Channel removed.");
2742
+ if (isJsonMode()) return printJson(result.direct);
2743
+ printSuccess("Channel removed.");
2744
+ });
2745
+ }
2746
+
2747
+ // src/commands/changes.ts
2748
+ async function changesStatusCommand(changeId, options) {
2749
+ await runOwnerCommand("org", async ({ api }) => {
2750
+ const change = await api.getOwnerAction(changeId);
2751
+ const outcome = await followChange(api, change, { open: false, wait: false, ...options });
2752
+ reportReview(
2753
+ outcome,
2754
+ change.change.action ? `${change.change.action}: done.` : "Change applied."
2755
+ );
2756
+ });
2757
+ }
2204
2758
 
2205
2759
  // src/commands/config.ts
2206
- import chalk7 from "chalk";
2760
+ import chalk9 from "chalk";
2207
2761
  var FORBIDDEN_CONFIG_PATH_SEGMENTS = /* @__PURE__ */ new Set(["__proto__", "prototype", "constructor"]);
2208
2762
  function isSafeConfigPath(parts) {
2209
2763
  return parts.length > 0 && parts.every(
@@ -2244,23 +2798,23 @@ async function configCommand(key, value) {
2244
2798
  return;
2245
2799
  }
2246
2800
  printHeader("Configuration");
2247
- printKeyValue("API Key", config.apiKey ? maskSecret(config.apiKey) : chalk7.dim("not set"));
2801
+ printKeyValue("API Key", config.apiKey ? maskSecret(config.apiKey) : chalk9.dim("not set"));
2248
2802
  printKeyValue(
2249
2803
  "Organization credential expires",
2250
- config.orgApiKeyExpiresAt || chalk7.dim("not recorded")
2804
+ config.orgApiKeyExpiresAt || chalk9.dim("not recorded")
2251
2805
  );
2252
2806
  printKeyValue("Base URL", config.baseUrl);
2253
- printKeyValue("Agent ID", config.agentId || chalk7.dim("not set"));
2254
- printKeyValue("Chain", config.chainName || chalk7.dim("not set"));
2255
- printKeyValue("Chain ID", config.chainId || chalk7.dim("not set"));
2256
- printKeyValue("Currency", config.currency || chalk7.dim("not set"));
2257
- printKeyValue("Explorer", config.explorerUrl || chalk7.dim("not set"));
2258
- printKeyValue("Wallet ID", config.walletId || chalk7.dim("not set"));
2259
- printKeyValue("Wallet Address", config.walletAddress || chalk7.dim("not set"));
2807
+ printKeyValue("Agent ID", config.agentId || chalk9.dim("not set"));
2808
+ printKeyValue("Chain", config.chainName || chalk9.dim("not set"));
2809
+ printKeyValue("Chain ID", config.chainId || chalk9.dim("not set"));
2810
+ printKeyValue("Currency", config.currency || chalk9.dim("not set"));
2811
+ printKeyValue("Explorer", config.explorerUrl || chalk9.dim("not set"));
2812
+ printKeyValue("Wallet ID", config.walletId || chalk9.dim("not set"));
2813
+ printKeyValue("Wallet Address", config.walletAddress || chalk9.dim("not set"));
2260
2814
  printKeyValue("Testnet", config.testnet ? "Yes" : "No");
2261
2815
  console.log("");
2262
- console.log(chalk7.dim(" Config sources: ~/.conto/config.json + .env.local"));
2263
- console.log(chalk7.dim(" Update with: conto config <key> <value>"));
2816
+ console.log(chalk9.dim(" Config sources: ~/.conto/config.json + .env.local"));
2817
+ console.log(chalk9.dim(" Update with: conto config <key> <value>"));
2264
2818
  console.log("");
2265
2819
  }
2266
2820
 
@@ -2397,15 +2951,15 @@ async function testWebhook(url) {
2397
2951
  // src/commands/sandbox.ts
2398
2952
  import fs2 from "fs";
2399
2953
  import path from "path";
2400
- import { setTimeout as sleep } from "timers/promises";
2401
- import chalk8 from "chalk";
2954
+ import { setTimeout as sleep2 } from "timers/promises";
2955
+ import chalk10 from "chalk";
2402
2956
 
2403
2957
  // src/lib/sandbox-handoff-client.ts
2404
2958
  var HANDOFF_PATH = "/api/agents/sandbox/handoff";
2405
2959
  var DEFAULT_POLL_INTERVAL_SECONDS = 5;
2406
2960
  var MIN_POLL_INTERVAL_SECONDS = 1;
2407
2961
  var MAX_POLL_INTERVAL_SECONDS = 60;
2408
- var REQUEST_TIMEOUT_MS2 = 15e3;
2962
+ var REQUEST_TIMEOUT_MS = 15e3;
2409
2963
  var SANDBOX_ORG_KEY_PATTERN = /^conto_[a-f0-9]{64}$/;
2410
2964
  var HANDOFF_TOKEN_PATTERN = /^conto_claim_[a-f0-9]{64}$/;
2411
2965
  function isHandoffToken(value) {
@@ -2509,7 +3063,7 @@ async function initiateHandoff(input) {
2509
3063
  url: apiUrl(input.baseUrl, HANDOFF_PATH),
2510
3064
  method: "POST",
2511
3065
  bearer: input.sandboxKey,
2512
- timeoutMs: REQUEST_TIMEOUT_MS2,
3066
+ timeoutMs: REQUEST_TIMEOUT_MS,
2513
3067
  signal: input.signal
2514
3068
  });
2515
3069
  } catch (error) {
@@ -2560,7 +3114,7 @@ async function inspectHandoff(input) {
2560
3114
  url: apiUrl(input.baseUrl, input.statusPath),
2561
3115
  method: "GET",
2562
3116
  bearer: input.token,
2563
- timeoutMs: REQUEST_TIMEOUT_MS2,
3117
+ timeoutMs: REQUEST_TIMEOUT_MS,
2564
3118
  signal: input.signal
2565
3119
  });
2566
3120
  } catch (error) {
@@ -2645,7 +3199,7 @@ var SANDBOX_CLAIM_EXIT_CODES = {
2645
3199
  interrupted: 130
2646
3200
  };
2647
3201
  var DEFAULT_BASE_URL = "https://conto.finance";
2648
- var DEFAULT_WAIT_SECONDS = 300;
3202
+ var DEFAULT_WAIT_SECONDS2 = 300;
2649
3203
  var MAX_WAIT_SECONDS = 3600;
2650
3204
  var MAX_CONSECUTIVE_POLL_ERRORS = 3;
2651
3205
  var TEST_MODE_AFTER_CLAIM = {
@@ -2844,7 +3398,7 @@ function pendingFields(state, options) {
2844
3398
  function printHandoff(state, reused, cli) {
2845
3399
  console.log("");
2846
3400
  console.log(
2847
- ` ${chalk8.bold("Sandbox claim link")} ${chalk8.dim(`(expires ${state.expiresAt})`)}${reused ? chalk8.dim(" reused") : ""}`
3401
+ ` ${chalk10.bold("Sandbox claim link")} ${chalk10.dim(`(expires ${state.expiresAt})`)}${reused ? chalk10.dim(" reused") : ""}`
2848
3402
  );
2849
3403
  console.log("");
2850
3404
  console.log(` ${state.verificationUrl}`);
@@ -2859,7 +3413,7 @@ function printHandoff(state, reused, cli) {
2859
3413
  printInfo(`Check the status: ${cli} sandbox claim-status`);
2860
3414
  }
2861
3415
  function parseWaitSeconds(timeout) {
2862
- if (timeout === void 0) return { ok: true, seconds: DEFAULT_WAIT_SECONDS };
3416
+ if (timeout === void 0) return { ok: true, seconds: DEFAULT_WAIT_SECONDS2 };
2863
3417
  if (!/^\d+$/.test(timeout)) {
2864
3418
  return { ok: false, message: "--timeout takes a whole number of seconds." };
2865
3419
  }
@@ -2883,7 +3437,7 @@ async function waitForClaim(credential, state, timeoutSeconds, stats) {
2883
3437
  const remaining = deadline - Date.now();
2884
3438
  if (remaining <= 0) return { kind: "timeout", lastRetryAfterSeconds };
2885
3439
  try {
2886
- await sleep(Math.min(delayMs, remaining), void 0, { signal: interrupt.signal });
3440
+ await sleep2(Math.min(delayMs, remaining), void 0, { signal: interrupt.signal });
2887
3441
  } catch {
2888
3442
  return { kind: "interrupted" };
2889
3443
  }
@@ -3349,6 +3903,12 @@ async function runSandboxClaimStatus() {
3349
3903
 
3350
3904
  // src/cli.ts
3351
3905
  var program = new Command();
3906
+ function withReview(command) {
3907
+ return command.option("--wait [seconds]", "Wait for the owner review (default when run in a terminal)").option("--no-wait", "Print the review link and return without waiting").option("--no-open", "Do not open the review page in a browser").addHelpText("after", REVIEW_EXIT_CODES_HELP);
3908
+ }
3909
+ function withLimits(command) {
3910
+ return command.option("--per-tx <usd>", "Per-payment limit in USD").option("--daily <usd>", "Daily limit in USD").option("--weekly <usd>", "Weekly limit in USD").option("--monthly <usd>", "Monthly limit in USD");
3911
+ }
3352
3912
  var INIT_EXIT_CODES_HELP = `
3353
3913
  Exit codes:
3354
3914
  0 setup complete
@@ -3408,18 +3968,84 @@ program.command("webhooks").description("Test local webhook handlers").command("
3408
3968
  program.command("status").description("Agent info, wallet balances, spending summary").action(statusCommand);
3409
3969
  program.command("doctor").description("Diagnose setup: auth, key scopes, wallet, chain, balance, base URL").action(doctorCommand);
3410
3970
  program.command("balance").description("Wallet balances across all linked wallets").action(balanceCommand);
3411
- program.command("pay <address> <amount>").description("Request + execute a payment").option("--purpose <purpose>", "Payment purpose").option("--category <category>", "Spend category").option("--dry-run", "Validate input and show the request without sending it (no policy check)").option("--wallet <walletId>", "Specific wallet to use").action(payCommand);
3971
+ program.command("pay <address> <amount>").description("Request + execute a payment").option("--purpose <purpose>", "Payment purpose").option("--category <category>", "Spend category").option("--dry-run", "Validate input and show the request without sending it (no policy check)").option("--wallet <walletId>", "Specific wallet to use").option(
3972
+ "--wait [seconds]",
3973
+ "Wait for approval when it is needed (default when run in a terminal)"
3974
+ ).option("--no-wait", "Print the approval link and return without waiting").option("--no-open", "Do not open the approval page in a browser").addHelpText("after", PAYMENT_EXIT_CODES_HELP).action(payCommand);
3412
3975
  program.command("test-report").description("Save buyer-side payment, control, and review evidence without executing payments").requiredOption("--allowed <id>", "Completed allowed payment request ID").requiredOption("--denied <id>", "Policy-denied payment request ID").option("--review <id>", "Review exercise payment request ID").option("--review-outcome <outcome>", "Expected review outcome: approved, denied, or expired").requiredOption("--output <file>", "New owner-only JSON report file (never overwritten)").action(testReportCommand);
3413
3976
  program.command("transactions [id]").description("List recent transactions or view details").option("--limit <n>", "Number of transactions", "10").option("--status <status>", "Filter by status").action(transactionsCommand);
3414
- program.command("wallets").description("List wallets with balances").action(() => walletsCommand("list"));
3977
+ var walletsGroup = program.command("wallets").description("List wallets with balances, or change wallet controls").action(() => walletsCommand("list"));
3978
+ walletsGroup.command("list").description("List wallets with balances").action(() => walletsCommand("list"));
3979
+ walletsGroup.command("freeze <walletId>").description("Freeze a wallet so no agent can pay from it").action(walletFreezeCommand);
3980
+ withReview(
3981
+ walletsGroup.command("unfreeze <walletId>").description("Unfreeze a wallet (owner review)")
3982
+ ).action(walletUnfreezeCommand);
3983
+ withReview(
3984
+ withLimits(
3985
+ walletsGroup.command("link <agentId> <walletId>").description("Let an agent spend from a wallet (owner review)").option("--delegation <type>", "limited, full, view_only, preapproved, or allowlist")
3986
+ )
3987
+ ).action(walletLinkCommand);
3988
+ walletsGroup.command("unlink <agentId> <walletId>").description("Stop an agent spending from a wallet").action(walletUnlinkCommand);
3989
+ withReview(
3990
+ withLimits(
3991
+ walletsGroup.command("limits <agentId> <walletId>").description("Change an agent's limits on a wallet (raising one goes to owner review)").option("--clear-weekly", "Remove the weekly limit").option("--clear-monthly", "Remove the monthly limit")
3992
+ )
3993
+ ).action(walletLimitsCommand);
3994
+ var agentsGroup = program.command("agents").description("Manage the organization's agents");
3995
+ agentsGroup.command("list").description("List agents").action(agentsListCommand);
3996
+ agentsGroup.command("show <agentId>").description("Show one agent").action(agentsShowCommand);
3997
+ agentsGroup.command("pause <agentId>").description("Pause an agent").action(agentsPauseCommand);
3998
+ withReview(
3999
+ agentsGroup.command("resume <agentId>").description("Resume a paused agent (owner review)")
4000
+ ).action(agentsResumeCommand);
4001
+ agentsGroup.command("freeze <agentId>").description("Freeze an agent").option("--reason <text>", "Why, for the audit log").option("--wallets", "Also freeze wallets only this agent uses").action(agentsFreezeCommand);
4002
+ withReview(
4003
+ agentsGroup.command("unfreeze <agentId>").description("Lift a freeze (owner review)").option("--reason <text>", "Why, for the audit log").option("--wallets", "Also unfreeze the wallets frozen with it")
4004
+ ).action(agentsUnfreezeCommand);
4005
+ withReview(
4006
+ agentsGroup.command("delete <agentId>").description("Delete an agent (owner review)").option("--yes", "Skip the confirmation prompt")
4007
+ ).action(agentsDeleteCommand);
4008
+ var keysGroup = agentsGroup.command("keys").description("Manage an agent's SDK keys").argument("[agentId]", "Agent to list keys for").action((agentId) => {
4009
+ if (!agentId) {
4010
+ keysGroup.help();
4011
+ return;
4012
+ }
4013
+ return agentsKeysListCommand(agentId);
4014
+ });
4015
+ withReview(
4016
+ keysGroup.command("create <agentId>").description("Create an SDK key (owner review, shown once)").option("--name <name>", "Key label")
4017
+ ).action(agentsKeysCreateCommand);
4018
+ keysGroup.command("revoke <agentId> <keyId>").description("Revoke an SDK key").action(agentsKeysRevokeCommand);
4019
+ var payeesGroup = program.command("counterparties").description("Manage the organization's payees");
4020
+ payeesGroup.command("list").description("List payees").action(counterpartiesListCommand);
4021
+ payeesGroup.command("show <id>").description("Show one payee").action(counterpartiesShowCommand);
4022
+ payeesGroup.command("add").description("Add a payee for review").option("--name <name>", "Payee name").option("--address <address>", "Wallet address").option("--type <type>", "vendor, service, agent, or other").option("--category <category>", "Spend category").action(counterpartiesAddCommand);
4023
+ payeesGroup.command("block <id>").description("Block a payee").action(counterpartiesBlockCommand);
4024
+ withReview(
4025
+ payeesGroup.command("approve <id>").description("Approve or unblock a payee (owner review)").option("--reason <text>", "Why, for the audit log")
4026
+ ).action(counterpartiesApproveCommand);
4027
+ var channelsGroup = program.command("channels").description("Manage event delivery channels");
4028
+ channelsGroup.command("list").description("List channels").action(channelsListCommand);
4029
+ channelsGroup.command("add").description("Add an email or webhook channel").option("--name <name>", "Channel name").option("--type <type>", "email or webhook").option("--recipients <emails>", "Comma-separated emails (email)").option("--url <url>", "https address to send events to (webhook)").option("--events <types>", "Comma-separated event types (default: approval.requested)").action(channelsAddCommand);
4030
+ channelsGroup.command("test <id>").description("Send a test event").action(channelsTestCommand);
4031
+ withReview(
4032
+ channelsGroup.command("remove <id>").description("Remove a channel (owner review)")
4033
+ ).action(channelsRemoveCommand);
4034
+ withReview(
4035
+ program.command("changes").description("Follow changes sent to owner review").command("status <changeId>").description("Show where a change stands, and collect it once approved")
4036
+ ).action((changeId, opts) => changesStatusCommand(changeId, opts));
3415
4037
  program.command("fund").description("Show wallet funding instructions").option("--faucet", "Request testnet funds from the configured faucet").action((opts) => walletsCommand("fund", { faucet: opts.faucet === true }));
3416
- program.command("policies [subcommand] [id] [extra]").description(
3417
- "Manage spending policies (list, all, create, update, delete, assign, unassign, add-rule, remove-rule)"
4038
+ withReview(
4039
+ program.command("policies [subcommand] [id] [extra]").description(
4040
+ "Manage spending policies (list, all, create, update, delete, assign, unassign, add-rule, remove-rule, versions, rollback, simulate)"
4041
+ )
3418
4042
  ).action(
3419
- (subcommand, id, extra) => policiesCommand(subcommand || "list", id, extra)
4043
+ (subcommand, id, extra, opts) => policiesCommand(subcommand || "list", id, extra, opts)
3420
4044
  );
3421
4045
  program.command("limits").description("Show spending limits and remaining budget").action(limitsCommand);
3422
- program.command("alerts").description("List alerts").option("--active", "Show only active alerts").option("--unread", "Alias for --active").action(alertsCommand);
4046
+ var alertsGroup = program.command("alerts").description("List alerts, or acknowledge or resolve one").option("--active", "Show only active alerts").option("--unread", "Alias for --active").action(alertsCommand);
4047
+ alertsGroup.command("ack <alertId>").description("Acknowledge an alert").action((alertId) => alertUpdateCommand(alertId, "acknowledge"));
4048
+ alertsGroup.command("resolve <alertId>").description("Resolve an alert").action((alertId) => alertUpdateCommand(alertId, "resolve"));
3423
4049
  program.command("config [key] [value]").description("Show or update configuration").action(configCommand);
3424
4050
  program.command("login").description("Authenticate with Conto").option("--base-url <url>", "Conto instance URL").action(loginCommand);
3425
4051
  program.command("logout").description("Clear stored credentials").action(async () => {