xapi-to 0.1.14 → 0.1.15

package/README.md

@@ -21,25 +21,25 @@ The published CLI runs on Node.js 18+. Bun is only required for local source dev
 
 ```bash
 # 1. Register a new account (apiKey saved automatically)
-xapi register
+xapi-to register
 
 # 1b. Or register with an inviter's referral code (please replace xapito to your referral code)
-xapi register --referral-code xapito
+xapi-to register --referral-code xapito
 
 # 2. Or set an existing key
-xapi config set apiKey=sk-xxx
+xapi-to config set apiKey=sk-xxx
 
 # 3. Or via env var
 export XAPI_KEY=sk-xxx
 
 # 4. Verify connectivity
-xapi config health
+xapi-to config health
 ```
 
 ## Usage
 
 ```
-xapi <command> [args] [flags]
+xapi-to <command> [args] [flags]
 ```
 
 ### Action Commands
@@ -47,23 +47,23 @@ xapi <command> [args] [flags]
 Unified interface for capabilities (built-in) and APIs (third-party). Use `--source capability|api` to filter.
 
 ```bash
-xapi list                                            # list all actions
-xapi list --source capability                        # only built-in capabilities
-xapi list --source api --category DeFi               # filter by source and category
-xapi list --page 2 --page-size 20                    # pagination
-xapi list --service-id <id>                          # filter by service
+xapi-to list                                            # list all actions
+xapi-to list --source capability                        # only built-in capabilities
+xapi-to list --source api --category DeFi               # filter by source and category
+xapi-to list --page 2 --page-size 20                    # pagination
+xapi-to list --service-id <id>                          # filter by service
 
-xapi search "twitter"                                # search by keyword
-xapi search "token price" --source api               # search APIs only
+xapi-to search "twitter"                                # search by keyword
+xapi-to search "token price" --source api               # search APIs only
 
-xapi categories                                      # list all categories
-xapi categories --source capability                  # categories for capabilities only
+xapi-to categories                                      # list all categories
+xapi-to categories --source capability                  # categories for capabilities only
 
-xapi services                                        # list all services
-xapi services --category Social --page-size 10       # filter and paginate
+xapi-to services                                        # list all services
+xapi-to services --category Social --page-size 10       # filter and paginate
 
-xapi get twitter.tweet_detail                        # get action schema
-xapi call twitter.tweet_detail --input '{"tweet_id":"1234567890"}'  # execute
+xapi-to get twitter.tweet_detail                        # get action schema
+xapi-to call twitter.tweet_detail --input '{"tweet_id":"1234567890"}'  # execute
 ```
 
 ### OAuth
@@ -71,30 +71,30 @@ xapi call twitter.tweet_detail --input '{"tweet_id":"1234567890"}'  # execute
 Bind third-party OAuth accounts (e.g. Twitter) to your API key.
 
 ```bash
-xapi oauth bind --provider twitter                   # bind Twitter account
-xapi oauth status                                    # list current bindings
-xapi oauth unbind <binding-id>                       # remove a binding
-xapi oauth providers                                 # list available providers
+xapi-to oauth bind --provider twitter                   # bind Twitter account
+xapi-to oauth status                                    # list current bindings
+xapi-to oauth unbind <binding-id>                       # remove a binding
+xapi-to oauth providers                                 # list available providers
 ```
 
 ### Account
 
 ```bash
-xapi register                                        # create account, saves apiKey automatically
-xapi register --referral-code xapito                 # register with an inviter's referral code (please replace xapito to your referral code)
-xapi register xapito                                 # positional shorthand for --referral-code
-xapi balance                                         # show USD balance
-xapi topup                                           # generate payment URL
-xapi topup --method stripe --amount 10               # stripe, $10
-xapi topup --method x402                             # x402 (USDC on Base)
+xapi-to register                                        # create account, saves apiKey automatically
+xapi-to register --referral-code xapito                 # register with an inviter's referral code (please replace xapito to your referral code)
+xapi-to register xapito                                 # positional shorthand for --referral-code
+xapi-to balance                                         # show USD balance
+xapi-to topup                                           # generate payment URL
+xapi-to topup --method stripe --amount 10               # stripe, $10
+xapi-to topup --method x402                             # x402 (USDC on Base)
 ```
 
 ### Config
 
 ```bash
-xapi config show                                     # show current config
-xapi config set apiKey=sk-xxx                        # save API key
-xapi config health                                   # check backend connectivity
+xapi-to config show                                     # show current config
+xapi-to config set apiKey=sk-xxx                        # save API key
+xapi-to config health                                   # check backend connectivity
 ```
 
 ## Workflow: Always GET before CALL
@@ -103,13 +103,13 @@ Before calling any action, always read its schema first to understand required p
 
 ```bash
 # 1. Find the action
-xapi search "twitter"
+xapi-to search "twitter"
 
 # 2. Read its schema
-xapi get twitter.tweet_detail
+xapi-to get twitter.tweet_detail
 
 # 3. Call with correct parameters
-xapi call twitter.tweet_detail --input '{"tweet_id":"1234567890"}'
+xapi-to call twitter.tweet_detail --input '{"tweet_id":"1234567890"}'
 ```
 
 ## Output Formats
@@ -117,9 +117,9 @@ xapi call twitter.tweet_detail --input '{"tweet_id":"1234567890"}'
 All output is JSON by default — designed for agent consumption.
 
 ```bash
-xapi list --format json                              # default, machine-readable
-xapi list --format pretty                            # pretty-printed JSON
-xapi list --format table                             # human-readable table
+xapi-to list --format json                              # default, machine-readable
+xapi-to list --format pretty                            # pretty-printed JSON
+xapi-to list --format table                             # human-readable table
 ```
 
 ## Environment Variables

package/dist/index.js

@@ -131,7 +131,7 @@ async function request(url, options, timeoutMs = DEFAULT_TIMEOUT_MS) {
       }
       if (data?.error === "OAuth Required" || data?.statusCode === 403 && data?.message?.includes("OAuth")) {
         throw new Error(
-          (data.message || "OAuth authorization required") + '. Run "xapi oauth bind" to connect your account.'
+          (data.message || "OAuth authorization required") + '. Run "xapi-to oauth bind" to connect your account.'
         );
       }
     }
@@ -528,10 +528,10 @@ function generateCode(target, params) {
 
 // src/commands/action.ts
 var VALID_SOURCES = ["capability", "api"];
-var LIST_HELP = `xapi list - List all actions
+var LIST_HELP = `xapi-to list - List all actions
 
 USAGE
-  xapi list [flags]
+  xapi-to list [flags]
 
 FLAGS
   --source capability|api   Filter by source type
@@ -542,14 +542,14 @@ FLAGS
   --format json|pretty|table  Output format
 
 EXAMPLES
-  xapi list
-  xapi list --source api --format table
-  xapi list --category social --page 2
+  xapi-to list
+  xapi-to list --source api --format table
+  xapi-to list --category social --page 2
 `;
-var SEARCH_HELP = `xapi search - Search actions by keyword
+var SEARCH_HELP = `xapi-to search - Search actions by keyword
 
 USAGE
-  xapi search <query> [flags]
+  xapi-to search <query> [flags]
 
 FLAGS
   --source capability|api   Filter by source type
@@ -559,14 +559,14 @@ FLAGS
   --format json|pretty|table  Output format
 
 EXAMPLES
-  xapi search twitter
-  xapi search "tweet detail" --source api
-  xapi search weather --category utility --format table
+  xapi-to search twitter
+  xapi-to search "tweet detail" --source api
+  xapi-to search weather --category utility --format table
 `;
-var GET_HELP = `xapi get - Get action schema
+var GET_HELP = `xapi-to get - Get action schema
 
 USAGE
-  xapi get <id> [flags]
+  xapi-to get <id> [flags]
 
 FLAGS
   --method GET|POST|...     Filter by HTTP method
@@ -591,15 +591,15 @@ CODE TARGETS
   go                        Go (net/http)
 
 EXAMPLES
-  xapi get twitter.tweet_detail
-  xapi get twitter.tweet_detail --method POST
-  xapi get twitter.tweet_detail --code curl
-  xapi get twitter.tweet_detail --code python.httpx --format pretty
+  xapi-to get twitter.tweet_detail
+  xapi-to get twitter.tweet_detail --method POST
+  xapi-to get twitter.tweet_detail --code curl
+  xapi-to get twitter.tweet_detail --code python.httpx --format pretty
 `;
-var CALL_HELP = `xapi call - Execute an action
+var CALL_HELP = `xapi-to call - Execute an action
 
 USAGE
-  xapi call <id> --input '{"key":"val"}' [flags]
+  xapi-to call <id> --input '{"key":"val"}' [flags]
 
 FLAGS
   --input <json>            Input payload as JSON (required for execution)
@@ -625,9 +625,9 @@ CODE TARGETS
   go                        Go (net/http)
 
 EXAMPLES
-  xapi call twitter.tweet_detail --input '{"tweet_id":"1234567890"}'
-  xapi call twitter.tweet_detail --input '{"tweet_id":"123"}' --code py
-  xapi call twitter.tweet_detail --input '{"tweet_id":"123"}' --code curl --format pretty
+  xapi-to call twitter.tweet_detail --input '{"tweet_id":"1234567890"}'
+  xapi-to call twitter.tweet_detail --input '{"tweet_id":"123"}' --code py
+  xapi-to call twitter.tweet_detail --input '{"tweet_id":"123"}' --code curl --format pretty
 `;
 function showHelpIfRequested(flags, helpText) {
   if (flags.help) {
@@ -688,7 +688,7 @@ async function actionList2(args, flags) {
 async function actionSearch2(args, flags) {
   showHelpIfRequested(flags, SEARCH_HELP);
   const query = args[0];
-  if (!query) err("usage: xapi search <query>");
+  if (!query) err("usage: xapi-to search <query>");
   const cfg = getConfig();
   try {
     const res = await actionSearch(query, cfg, {
@@ -756,7 +756,7 @@ async function actionServices2(args, flags) {
 async function actionGet2(args, flags) {
   showHelpIfRequested(flags, GET_HELP);
   const id = args[0];
-  if (!id) err("usage: xapi get <id> [--method GET|POST|DELETE|...]");
+  if (!id) err("usage: xapi-to get <id> [--method GET|POST|DELETE|...]");
   if (flags.code) validateCodeFlag(flags);
   const cfg = getConfig();
   try {
@@ -788,7 +788,7 @@ async function actionGet2(args, flags) {
 async function actionCall2(args, flags) {
   showHelpIfRequested(flags, CALL_HELP);
   const id = args[0];
-  if (!id) err(`usage: xapi call <id> --input '{"key":"val"}'`);
+  if (!id) err(`usage: xapi-to call <id> --input '{"key":"val"}'`);
   if (flags.code) validateCodeFlag(flags);
   const cfg = getConfig();
   let input = {};
@@ -826,29 +826,29 @@ __export(config_exports, {
   configSet: () => configSet,
   configShow: () => configShow
 });
-var CONFIG_HELP = `xapi config - Manage CLI configuration
+var CONFIG_HELP = `xapi-to config - Manage CLI configuration
 
 USAGE
-  xapi config <command> [flags]
+  xapi-to config <command> [flags]
 
 COMMANDS
   show                       Show current config (host, apiKey path, etc.)
   set apiKey=<key>           Save API key to ~/.xapi/config.json
-  health                     Check backend connectivity (alias: xapi health)
+  health                     Check backend connectivity (alias: xapi-to health)
 
 FLAGS
   --format json|pretty|table   Output format
 
 EXAMPLES
-  xapi config show
-  xapi config set apiKey=xapi_abc123
-  xapi config health
+  xapi-to config show
+  xapi-to config set apiKey=xapi_abc123
+  xapi-to config health
 `;
 async function configShow(args, flags) {
   showConfig();
 }
 async function configSet(args, flags) {
-  if (args.length === 0) err("usage: xapi config set apiKey=<key>");
+  if (args.length === 0) err("usage: xapi-to config set apiKey=<key>");
   const updates = {};
   for (const arg of args) {
     const eq = arg.indexOf("=");
@@ -1016,10 +1016,10 @@ async function findCurrentKeyRecord(plaintextKey, jwtToken) {
   }
   return match;
 }
-var OAUTH_HELP = `xapi oauth - Manage OAuth bindings
+var OAUTH_HELP = `xapi-to oauth - Manage OAuth bindings
 
 USAGE
-  xapi oauth <command> [flags]
+  xapi-to oauth <command> [flags]
 
 COMMANDS
   bind [--provider <name>]   Bind an OAuth account to your API key
@@ -1032,12 +1032,12 @@ FLAGS
   --format json|pretty|table   Output format
 
 EXAMPLES
-  xapi oauth bind
-  xapi oauth bind --provider twitter
-  xapi oauth status
-  xapi oauth status --format pretty
-  xapi oauth unbind abc123
-  xapi oauth providers
+  xapi-to oauth bind
+  xapi-to oauth bind --provider twitter
+  xapi-to oauth status
+  xapi-to oauth status --format pretty
+  xapi-to oauth unbind abc123
+  xapi-to oauth providers
 `;
 async function oauthBind(args, flags) {
   const cfg = getConfig();
@@ -1086,7 +1086,7 @@ async function oauthBind(args, flags) {
 `);
         output({ status: "success", provider: provider.name, account }, flags.format);
       } else {
-        err("oauth bind timed out", 'Authorization was not completed within 5 minutes. Run "xapi oauth bind" again.');
+        err("oauth bind timed out", 'Authorization was not completed within 5 minutes. Run "xapi-to oauth bind" again.');
       }
     } else {
       output({
@@ -1110,7 +1110,7 @@ async function oauthStatus(args, flags) {
     if (!Array.isArray(bindings) || bindings.length === 0) {
       output({
         status: "no_bindings",
-        message: 'No OAuth bindings found. Run "xapi oauth bind" to connect an account.'
+        message: 'No OAuth bindings found. Run "xapi-to oauth bind" to connect an account.'
       }, flags.format);
       return;
     }
@@ -1137,7 +1137,7 @@ async function oauthUnbind(args, flags) {
   const apiKey = cfg.apiKey;
   const bindingId = args[0];
   if (!bindingId) {
-    err("usage: xapi oauth unbind <binding-id>", 'Get the binding ID from "xapi oauth status"');
+    err("usage: xapi-to oauth unbind <binding-id>", 'Get the binding ID from "xapi-to oauth status"');
   }
   try {
     const jwtToken = await loginAndGetJwt(apiKey);
@@ -1182,10 +1182,10 @@ function parseArgs(argv) {
   }
   return { positional, flags };
 }
-var HELP = `xapi - agent-friendly CLI for xapi
+var HELP = `xapi-to - agent-friendly CLI for xapi
 
 USAGE
-  xapi <command> [args] [flags]
+  xapi-to <command> [args] [flags]
 
 COMMANDS
   list                              List all actions
@@ -1223,11 +1223,11 @@ COMMANDS
 
   config show                       Show current config
   config set apiKey=<key>           Save API key to ~/.xapi/config.json
-  config health                     Check backend connectivity (alias: xapi health)
+  config health                     Check backend connectivity (alias: xapi-to health)
 
 GLOBAL FLAGS
   --format json|pretty|table        Output format (default: json)
-  --help                            Show help (use with a command for details, e.g. xapi get --help)
+  --help                            Show help (use with a command for details, e.g. xapi-to get --help)
 
 ENV VARS
   XAPI_KEY       API key (header: XAPI-Key)
@@ -1235,21 +1235,21 @@ ENV VARS
   XAPI_OUTPUT        Default output format
 
 EXAMPLES
-  xapi register
-  xapi register --referral-code xapito          # register with an inviter's referral code
-  xapi register xapito                          # positional shorthand
-  xapi list --format table
-  xapi list --source capability
-  xapi search twitter --source api
-  xapi get twitter.tweet_detail
-  xapi get twitter.tweet_detail --code curl
-  xapi get twitter.tweet_detail --code py --format pretty
-  xapi call twitter.tweet_detail --input '{"tweet_id":"1234567890"}'
-  xapi call twitter.tweet_detail --input '{"tweet_id":"1234567890"}' --code python
-  xapi categories
-  xapi services --format table
-  xapi config set apiKey=xapi_abc123
-  xapi health
+  xapi-to register
+  xapi-to register --referral-code xapito          # register with an inviter's referral code
+  xapi-to register xapito                          # positional shorthand
+  xapi-to list --format table
+  xapi-to list --source capability
+  xapi-to search twitter --source api
+  xapi-to get twitter.tweet_detail
+  xapi-to get twitter.tweet_detail --code curl
+  xapi-to get twitter.tweet_detail --code py --format pretty
+  xapi-to call twitter.tweet_detail --input '{"tweet_id":"1234567890"}'
+  xapi-to call twitter.tweet_detail --input '{"tweet_id":"1234567890"}' --code python
+  xapi-to categories
+  xapi-to services --format table
+  xapi-to config set apiKey=xapi_abc123
+  xapi-to health
 `;
 async function main() {
   const { positional, flags } = parseArgs(process.argv.slice(2));
@@ -1325,7 +1325,7 @@ async function main() {
       break;
     }
     default:
-      console.error(JSON.stringify({ error: `unknown command: ${cmd}`, hint: "run xapi --help" }));
+      console.error(JSON.stringify({ error: `unknown command: ${cmd}`, hint: "run xapi-to --help" }));
       process.exit(1);
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xapi-to",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "description": "Agent-friendly CLI for xapi - discover and call capabilities and APIs",
   "type": "module",
   "bin": {