troxy-cli 1.8.2 → 1.8.3

package/bin/troxy.js

@@ -66,7 +66,7 @@ switch (command) {
       const res = await fetch('https://registry.npmjs.org/troxy-cli/latest', { signal: AbortSignal.timeout(3000) });
       const { version: latest } = await res.json();
       if (version !== latest) {
-        process.stdout.write(`  ⚠  ${latest} available — run: troxy update`);
+        process.stdout.write(`  ⚠  ${latest} available, run: troxy update`);
       }
     } catch {}
     process.stdout.write('\n');
@@ -139,7 +139,7 @@ switch (command) {
     Old:  ${oldPrefix ? oldPrefix + '... (revoked)' : '(none)'}
     New:  ${newPrefix}...
 
-  New key (shown once — save it now):
+  New key (shown once, save it now):
     ${newKey}
 
   ~/.troxy/config.json updated ✓
@@ -175,7 +175,7 @@ switch (command) {
       console.log(`
   troxy pay --merchant <name> --amount <n> [options]
 
-  Simulates a payment evaluation request — identical to what your AI agent sends.
+  Simulates a payment evaluation request, identical to what your AI agent sends.
   Use this to test your policies. Login required.
 
   By default, payments that come back ALLOW or NOTIFY are auto-confirmed as
@@ -189,7 +189,7 @@ switch (command) {
   Optional:
     --card <alias>      Card alias (default: "Work")
     --category <cat>    Merchant category (e.g. travel, software, food)
-    --no-confirm        Don't auto-confirm — leaves the row PENDING
+    --no-confirm        Don't auto-confirm, leaves the row PENDING
     --fail              Confirm as a failed charge instead of success
                         (simulates a declined card)
 
@@ -217,7 +217,7 @@ switch (command) {
     const result = await api.evaluate(body, apiKey);
     const ICON = { ALLOW: '✓', BLOCK: '✗', ESCALATE: '⏳', NOTIFY: '~' };
     const icon = ICON[result.decision] || '?';
-    const suffix = result.policy ? `  ←  "${result.policy}"` : result.reason ? `  —  ${result.reason}` : '  (default action)';
+    const suffix = result.policy ? `  ←  "${result.policy}"` : result.reason ? `  (${result.reason})` : '  (default action)';
     console.log(`\n  ${icon} ${result.decision}${suffix}`);
     if (result.audit_id) console.log(`  audit: ${result.audit_id}`);
 
@@ -236,7 +236,7 @@ switch (command) {
         }, apiKey);
         console.log(`  confirmed: charge ${status}`);
       } catch (e) {
-        console.log(`  (confirm step failed — row will stay PENDING)`);
+        console.log(`  (confirm step failed, row will stay PENDING)`);
       }
     }
     console.log();
@@ -301,7 +301,7 @@ switch (command) {
     const data   = await api.agentInsights(jwt, period);
     const d      = data;
     console.log(`
-  Insights — last ${d.period_days} days
+  Insights (last ${d.period_days} days)
   ──────────────────────────────────
   Total requests:  ${d.total_requests}
   Total spent:     $${Number(d.total_spent).toFixed(2)}
@@ -499,7 +499,7 @@ switch (command) {
   default:
     if (command) console.error(`  Unknown command: ${command}\n`);
     console.log(`
-  Troxy — AI payment control
+  Troxy: AI payment control
 
   First time? Run these two commands in order:
     1) npx troxy-cli init --key txy-...   (get key from https://dash.troxy.io)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "troxy-cli",
-  "version": "1.8.2",
+  "version": "1.8.3",
   "description": "AI payment control — protect your agent's payments with policies",
   "type": "module",
   "bin": {

package/src/approvals.js

@@ -13,7 +13,7 @@ async function _find(jwt, idPrefix) {
   const { items: approvals = [] } = await api.listApprovals(jwt);
   const matches = approvals.filter(a => a.id.startsWith(idPrefix));
   if (matches.length === 0) { console.error(`  No pending approval starting with "${idPrefix}". Run: troxy approvals list\n`); process.exit(1); }
-  if (matches.length > 1)   { console.error(`  "${idPrefix}" matches ${matches.length} pending approvals — use a longer prefix\n`); process.exit(1); }
+  if (matches.length > 1)   { console.error(`  "${idPrefix}" matches ${matches.length} pending approvals, use a longer prefix\n`); process.exit(1); }
   return matches[0];
 }
 

package/src/cards.js

@@ -81,7 +81,7 @@ export async function runCards([sub, ...args], flags) {
         body.default_action = action;
       }
       if (flags.notes != null) body.notes = flags.notes;
-      if (Object.keys(body).length === 0) { console.error('  Nothing to update — pass at least one option\n'); process.exit(1); }
+      if (Object.keys(body).length === 0) { console.error('  Nothing to update, pass at least one option\n'); process.exit(1); }
 
       await api.updateCard(jwt, card.id, body);
       console.log(`\n  Card "${name}" updated ✓\n`);

package/src/chat-budget.js

@@ -7,7 +7,7 @@ const VALID_ACTIONS    = ['block', 'allow', 'notify', 'escalate'];
 
 const HELP = {
   show: `  troxy chat-budget show\n\n  Shows Troxy Chat's monthly budget limits and what happens when they're hit.\n`,
-  set:  `  troxy chat-budget set [options]\n\n  Updates Troxy Chat's monthly budget. Login required.\n\n    --currency <cur>    USD, ILS, or EUR (default: USD)\n    --limit <n>          Monthly limit for that currency\n    --clear              Remove the limit for that currency\n    --action <action>    block, allow, notify, or escalate — what happens once the limit is hit\n\n  Examples:\n    troxy chat-budget set --currency USD --limit 500\n    troxy chat-budget set --action notify\n    troxy chat-budget set --currency EUR --clear\n`,
+  set:  `  troxy chat-budget set [options]\n\n  Updates Troxy Chat's monthly budget. Login required.\n\n    --currency <cur>    USD, ILS, or EUR (default: USD)\n    --limit <n>          Monthly limit for that currency\n    --clear              Remove the limit for that currency\n    --action <action>    block, allow, notify, or escalate: what happens once the limit is hit\n\n  Examples:\n    troxy chat-budget set --currency USD --limit 500\n    troxy chat-budget set --action notify\n    troxy chat-budget set --currency EUR --clear\n`,
 };
 
 export async function runChatBudget([sub, ...args], flags) {
@@ -56,7 +56,7 @@ export async function runChatBudget([sub, ...args], flags) {
       }
 
       if (Object.keys(body).length === 0) {
-        console.error('  Nothing to update — pass at least one option. Run troxy chat-budget set --help\n');
+        console.error('  Nothing to update, pass at least one option. Run troxy chat-budget set --help\n');
         process.exit(1);
       }
 

package/src/init.js

@@ -67,7 +67,7 @@ export async function runInit({ key } = {}) {
     process.exit(1);
   }
 
-  console.log('\n  Troxy — AI payment control\n');
+  console.log('\n  Troxy: AI payment control\n');
 
   // Validate the key by hitting /evaluate (404 card = key is valid, TypeError = network failure)
   process.stdout.write('  Validating API key...  ');

package/src/mcp-server.js

@@ -35,9 +35,9 @@ export async function runMcp() {
         'You MUST call the evaluate_payment tool before completing any purchase, payment, or financial transaction. ' +
         'Never submit a payment form, confirm a checkout, or transfer funds without first receiving an ALLOW decision from evaluate_payment. ' +
         'If the decision is BLOCK, abort the transaction and inform the user. ' +
-        'If the decision is ESCALATE, the response includes an approval_token. Immediately call wait_for_payment_approval with that token — it polls automatically until the payment is approved or declined (up to 10 minutes). Once it returns approved, call evaluate_payment again with the same payment details PLUS the approval_token field. The second call will return ALLOW without re-escalating. ' +
+        'If the decision is ESCALATE, the response includes an approval_token. Immediately call wait_for_payment_approval with that token; it polls automatically until the payment is approved or declined (up to 10 minutes). Once it returns approved, call evaluate_payment again with the same payment details PLUS the approval_token field. The second call will return ALLOW without re-escalating. ' +
         'If the decision is NOTIFY, proceed but the user will be notified. ' +
-        'When calling evaluate_payment, use the merchant\'s domain name as merchant_name when available (e.g. "amazon.com", "indigobloom.co.il") — this ensures consistent matching against policies. ' +
+        'When calling evaluate_payment, use the merchant\'s domain name as merchant_name when available (e.g. "amazon.com", "indigobloom.co.il"); this ensures consistent matching against policies. ' +
         'After every ALLOW or NOTIFY decision, attempt the payment, then call confirm_payment with the audit_id and the outcome (success/failed/cancelled). Always include a reason when the charge fails.',
     },
     { capabilities: { tools: {} } },
@@ -50,7 +50,7 @@ export async function runMcp() {
         description:
           'Report the actual outcome of a payment attempt to Troxy. ' +
           'Call this after every ALLOW or NOTIFY decision, once you know whether the charge succeeded or failed. ' +
-          'This is required for accurate audit logs — without it, approved payments show as unconfirmed.',
+          'This is required for accurate audit logs. Without it, approved payments show as unconfirmed.',
         inputSchema: {
           type: 'object',
           required: ['audit_id', 'status'],
@@ -124,7 +124,7 @@ export async function runMcp() {
             },
             currency: {
               type: 'string',
-              description: 'ISO 4217 currency code — always include this. Examples: "ILS" for Israeli Shekel (NIS), "USD" for US Dollar, "EUR" for Euro.',
+              description: 'ISO 4217 currency code. Always include this. Examples: "ILS" for Israeli Shekel (NIS), "USD" for US Dollar, "EUR" for Euro.',
             },
             approval_token: {
               type: 'string',
@@ -229,7 +229,7 @@ export async function runMcp() {
         text = `✗ Payment blocked by policy "${policy}". Do not proceed with this payment. (audit: ${audit_id})`;
         break;
       case 'ESCALATE':
-        text = `⏳ Payment requires human approval — a request has been sent to the account owner.\n\nApproval token: ${approval_token}\n\nNow call wait_for_payment_approval(approval_token="${approval_token}") to automatically detect approval. Do not proceed until it returns approved. (audit: ${audit_id})`;
+        text = `⏳ Payment requires human approval; a request has been sent to the account owner.\n\nApproval token: ${approval_token}\n\nNow call wait_for_payment_approval(approval_token="${approval_token}") to automatically detect approval. Do not proceed until it returns approved. (audit: ${audit_id})`;
         break;
       case 'NOTIFY':
         text = `✓ Payment approved with notification. Policy matched: "${policy}". (audit: ${audit_id})\n\nAfter the charge attempt completes, call confirm_payment with audit_id "${audit_id}" and status "success", "failed", or "cancelled".`;

package/src/mcps.js

@@ -4,13 +4,13 @@ import { requireJwt }                              from './auth.js';
 import { table }                                   from './print.js';
 
 const HELP = {
-  list:               `  troxy mcps list\n\n  Lists all MCP connections on your account — name, prefix, status, last seen,\n  policies assigned, default action, budgets, and which one is this machine.\n`,
+  list:               `  troxy mcps list\n\n  Lists all MCP connections on your account: name, prefix, status, last seen,\n  policies assigned, default action, budgets, and which one is this machine.\n`,
   rename:             `  troxy mcps rename --name <new-name> [--mcp <target>]\n\n  Renames an MCP. Without --mcp, renames this machine's MCP.\n\n  Options:\n    --name   New name\n    --mcp    Name/prefix of the MCP to rename (default: this machine)\n\n  Example:\n    troxy mcps rename --name "My Laptop"\n    troxy mcps rename --mcp "old-name" --name "Staging Server"\n`,
-  create:             `  troxy mcps create --name <name>\n\n  Creates a new API key for another agent/machine. The key is shown once —\n  save it, then run 'troxy init --key <key>' on that machine.\n\n  Options:\n    --name   Label for the new key\n`,
+  create:             `  troxy mcps create --name <name>\n\n  Creates a new API key for another agent/machine. The key is shown once.\n  Save it, then run 'troxy init --key <key>' on that machine.\n\n  Options:\n    --name   Label for the new key\n`,
   revoke:             `  troxy mcps revoke --mcp <name>\n\n  Permanently revokes an MCP's API key. That machine will stop being able\n  to evaluate payments until reconnected with a new key.\n`,
-  pause:              `  troxy pause / troxy mcps pause [--mcp <name>]\n\n  Pauses an MCP (blocks all its payment evaluations). Without --mcp, pauses\n  this machine's MCP — same as running 'troxy pause'.\n`,
+  pause:              `  troxy pause / troxy mcps pause [--mcp <name>]\n\n  Pauses an MCP (blocks all its payment evaluations). Without --mcp, pauses\n  this machine's MCP, same as running 'troxy pause'.\n`,
   resume:             `  troxy resume / troxy mcps resume [--mcp <name>]\n\n  Resumes a paused MCP. Without --mcp, resumes this machine's MCP.\n`,
-  budget:             `  troxy mcps budget --mcp <name> [options]\n\n  Sets or clears a monthly spend limit for a specific MCP.\n\n  Options:\n    --mcp <name>          MCP to configure (required)\n    --currency <cur>      USD, ILS, or EUR (default: USD)\n    --limit <n>           Monthly limit\n    --clear               Remove the limit for that currency\n    --action <action>     block, escalate, notify, or allow — what happens once hit\n    --reset-usage         Reset this cycle's usage back to 0\n\n  Example:\n    troxy mcps budget --mcp "My Laptop" --currency USD --limit 500\n`,
+  budget:             `  troxy mcps budget --mcp <name> [options]\n\n  Sets or clears a monthly spend limit for a specific MCP.\n\n  Options:\n    --mcp <name>          MCP to configure (required)\n    --currency <cur>      USD, ILS, or EUR (default: USD)\n    --limit <n>           Monthly limit\n    --clear               Remove the limit for that currency\n    --action <action>     block, escalate, notify, or allow: what happens once hit\n    --reset-usage         Reset this cycle's usage back to 0\n\n  Example:\n    troxy mcps budget --mcp "My Laptop" --currency USD --limit 500\n`,
   'set-default-action': `  troxy mcps set-default-action --mcp <name> --action <action>\n\n  Sets the fallback decision for an MCP when no policy matches.\n\n  Options:\n    --mcp <name>       MCP to configure (required)\n    --action <action>  ALLOW, BLOCK, ESCALATE, or NOTIFY\n`,
 };
 
@@ -86,7 +86,7 @@ export async function runMcps([sub, ...args], flags) {
       const result = await api.createToken(jwt, { name });
       console.log(`\n  API key created for "${name}":\n`);
       console.log(`    ${result.key}\n`);
-      console.log('  Shown once — save it now. Run "troxy init --key <key>" on that machine to connect it.\n');
+      console.log('  Shown once, save it now. Run "troxy init --key <key>" on that machine to connect it.\n');
       break;
     }
 
@@ -128,7 +128,7 @@ export async function runMcps([sub, ...args], flags) {
         else { console.error('  --limit is required (or pass --clear)\n'); process.exit(1); }
       }
       if (flags['reset-usage']) body.reset_usage = true;
-      if (Object.keys(body).length === 0) { console.error('  Nothing to update — pass at least one option\n'); process.exit(1); }
+      if (Object.keys(body).length === 0) { console.error('  Nothing to update, pass at least one option\n'); process.exit(1); }
       await api.updateTokenBudget(jwt, tok.id, body);
       console.log(`\n  Budget updated for "${tok.name || tok.prefix}" ✓\n`);
       break;

package/src/policies.js

@@ -14,7 +14,7 @@ function _promptYN(question) {
 const HELP = {
   list:         `  troxy policies list\n\n  Lists all policies in your account with their action, scope, status, and conditions.\n`,
   describe:     `  troxy policies describe --name <policy-name>\n\n  Shows full details for a single policy.\n\n  Options:\n    --name   Name of the policy (use single quotes for names with special chars)\n`,
-  create:       `  troxy policies create --name <name> --action <action> [options]\n  troxy policies create --describe "<plain English>"\n\n  Creates a new policy. Login required.\n\n  AI builder:\n    --describe "<text>"   Describe the policy in plain English (e.g. "block\n                          Amazon purchases over $200") and Troxy AI drafts\n                          it for you to confirm. Rate-limited per day.\n\n  Manual — required:\n    --name     Policy name\n    --action   ALLOW, BLOCK, NOTIFY, or ESCALATE\n\n  Manual — optional conditions:\n    --field      Field to match: amount, merchant_name, tx_per_day\n    --operator   eq, neq, gt, gte, lt, lte, contains, starts_with, not_contains, between\n    --value      Comparison value (e.g. 500, amazon)\n    --value2     Upper bound for 'between' operator\n\n  Priority:\n    --priority <n>   Explicit priority number (default: auto, max+10)\n                     Lower number = higher priority (evaluated first).\n\n  Scope (default: all agents — every MCP plus Troxy Chat):\n    --mcp <name>       Scope to one or more MCPs (comma-separated).\n                       Run 'troxy mcps list' to see MCP names.\n    --chat             Include Troxy Chat. Implied by default; combine with\n                       --mcp to scope to specific MCPs *and* chat, or use\n                       alone to scope to Troxy Chat only (no MCPs).\n    --no-chat          Exclude Troxy Chat from this policy's scope.\n\n  Examples:\n    troxy policies create --describe "block Amazon purchases over $200"\n    troxy policies create --name "Block large" --action BLOCK --field amount --operator gte --value 500\n    troxy policies create --name "Block Amazon" --action BLOCK --field merchant_name --operator contains --value amazon\n    troxy policies create --name "Cap volume" --action BLOCK --field tx_per_day --operator gt --value 20\n    troxy policies create --name "Allow Wiki" --action ALLOW --priority 5 --field merchant_name --operator contains --value Wiki\n    troxy policies create --name "Laptop only" --action BLOCK --mcp "My Laptop" --field amount --operator gte --value 100\n    troxy policies create --name "Multi-agent" --action BLOCK --mcp "My Laptop,Server" --field amount --operator gte --value 100\n    troxy policies create --name "Chat only" --action ESCALATE --chat --field amount --operator gte --value 200\n    troxy policies create --name "MCPs, no chat" --action BLOCK --no-chat --field merchant_name --operator contains --value casino\n`,
+  create:       `  troxy policies create --name <name> --action <action> [options]\n  troxy policies create --describe "<plain English>"\n\n  Creates a new policy. Login required.\n\n  AI builder:\n    --describe "<text>"   Describe the policy in plain English (e.g. "block\n                          Amazon purchases over $200") and Troxy AI drafts\n                          it for you to confirm. Rate-limited per day.\n\n  Manual (required):\n    --name     Policy name\n    --action   ALLOW, BLOCK, NOTIFY, or ESCALATE\n\n  Manual (optional conditions):\n    --field      Field to match: amount, merchant_name, tx_per_day\n    --operator   eq, neq, gt, gte, lt, lte, contains, starts_with, not_contains, between\n    --value      Comparison value (e.g. 500, amazon)\n    --value2     Upper bound for 'between' operator\n\n  Priority:\n    --priority <n>   Explicit priority number (default: auto, max+10)\n                     Lower number = higher priority (evaluated first).\n\n  Scope (default: all agents, every MCP plus Troxy Chat):\n    --mcp <name>       Scope to one or more MCPs (comma-separated).\n                       Run 'troxy mcps list' to see MCP names.\n    --chat             Include Troxy Chat. Implied by default; combine with\n                       --mcp to scope to specific MCPs *and* chat, or use\n                       alone to scope to Troxy Chat only (no MCPs).\n    --no-chat          Exclude Troxy Chat from this policy's scope.\n\n  Examples:\n    troxy policies create --describe "block Amazon purchases over $200"\n    troxy policies create --name "Block large" --action BLOCK --field amount --operator gte --value 500\n    troxy policies create --name "Block Amazon" --action BLOCK --field merchant_name --operator contains --value amazon\n    troxy policies create --name "Cap volume" --action BLOCK --field tx_per_day --operator gt --value 20\n    troxy policies create --name "Allow Wiki" --action ALLOW --priority 5 --field merchant_name --operator contains --value Wiki\n    troxy policies create --name "Laptop only" --action BLOCK --mcp "My Laptop" --field amount --operator gte --value 100\n    troxy policies create --name "Multi-agent" --action BLOCK --mcp "My Laptop,Server" --field amount --operator gte --value 100\n    troxy policies create --name "Chat only" --action ESCALATE --chat --field amount --operator gte --value 200\n    troxy policies create --name "MCPs, no chat" --action BLOCK --no-chat --field merchant_name --operator contains --value casino\n`,
   'set-priority': `  troxy policies set-priority --name <policy-name> --priority <n>\n\n  Changes the priority of a policy. Lower number = higher priority (evaluated first).\n\n  Options:\n    --name       Name of the policy\n    --priority   New priority number (e.g. 10, 20, 50)\n\n  Example:\n    troxy policies set-priority --name "Block Wiki" --priority 5\n`,
   resume:       `  troxy policies resume --name <policy-name>\n\n  Resumes a paused policy.\n\n  Options:\n    --name   Name of the policy to resume\n`,
   pause:        `  troxy policies pause --name <policy-name>\n\n  Pauses a policy without deleting it. The policy stops firing until you resume it.\n\n  Options:\n    --name   Name of the policy to pause\n`,
@@ -182,7 +182,7 @@ export async function runPolicies([sub, ...args], flags) {
       const appliesToChat = flags['no-chat'] ? false : true;
 
       if (!isGlobal && mcpIds.length === 0 && !appliesToChat) {
-        console.error('  Nothing to scope to — pass --mcp, --chat, or drop --no-chat\n'); process.exit(1);
+        console.error('  Nothing to scope to, pass --mcp, --chat, or drop --no-chat\n'); process.exit(1);
       }
 
       const priority = flags.priority != null ? parseInt(flags.priority, 10) : undefined;

package/src/secrets.js

@@ -5,7 +5,7 @@ import { table }       from './print.js';
 
 const HELP = {
   list:   `  troxy secrets list\n\n  Lists your saved LLM provider keys (used by Troxy Chat). Values are\n  never shown, only a masked preview.\n`,
-  set:    `  troxy secrets set --name <name> [--type api_key|text]\n\n  Saves or updates an LLM provider key. You'll be prompted for the value\n  so it never appears in your shell history. Login required.\n\n  Options:\n    --name    Label for this key (e.g. "OpenAI", "Anthropic")\n    --type    api_key (default) or text\n\n  Card secrets are dashboard-only — troxy secrets does not handle them.\n\n  Example:\n    troxy secrets set --name "OpenAI"\n`,
+  set:    `  troxy secrets set --name <name> [--type api_key|text]\n\n  Saves or updates an LLM provider key. You'll be prompted for the value\n  so it never appears in your shell history. Login required.\n\n  Options:\n    --name    Label for this key (e.g. "OpenAI", "Anthropic")\n    --type    api_key (default) or text\n\n  Card secrets are dashboard-only; troxy secrets does not handle them.\n\n  Example:\n    troxy secrets set --name "OpenAI"\n`,
   delete: `  troxy secrets delete --name <name>\n\n  Deletes a saved key. Login required.\n`,
 };
 

package/src/settings.js

@@ -32,7 +32,7 @@ export async function runSettings([sub, ...args], flags) {
     Notify email:      ${s.notify_prefs.notify_email || '(account email)'}
 
   Chat budget action:  ${s.chat_budget_action}
-  Chat budget limits:  ${s.chat_budget_limits.length ? s.chat_budget_limits.map(b => `${b.currency} ${b.used}/${b.limit}`).join(', ') : 'none set — run troxy chat-budget'}
+  Chat budget limits:  ${s.chat_budget_limits.length ? s.chat_budget_limits.map(b => `${b.currency} ${b.used}/${b.limit}`).join(', ') : 'none set, run troxy chat-budget'}
 `);
       break;
     }
@@ -69,7 +69,7 @@ export async function runSettings([sub, ...args], flags) {
       if (Object.keys(notify_prefs).length) body.notify_prefs = notify_prefs;
 
       if (Object.keys(body).length === 0) {
-        console.error('  Nothing to update — pass at least one option. Run troxy settings set --help\n');
+        console.error('  Nothing to update, pass at least one option. Run troxy settings set --help\n');
         process.exit(1);
       }
 

package/src/uninstall.js

@@ -84,7 +84,7 @@ function removeMcpEntries() {
 }
 
 export async function runUninstall() {
-  console.log('\n  Troxy — Uninstall\n');
+  console.log('\n  Troxy: Uninstall\n');
 
   const answer = await prompt('  This will remove Troxy from this machine. Continue? (y/N): ');
   if (answer.toLowerCase() !== 'y') {