@lidianai/cli 0.1.0 → 0.1.1

package/AGENTS.md

@@ -0,0 +1,26 @@
+# AGENTS.md - Lidian CLI
+
+Guidelines for agents working in the `cli/` package.
+
+## Core Standards
+
+- Keep implementations simple, clean, and easy to read.
+- Prefer direct logic over clever abstractions and indirection.
+- Avoid obscure decisions and surprising behavior.
+
+## Required Simplification Pass
+
+After any feature or code change, always review your own diff and simplify before finishing:
+
+- remove dead code and temporary scaffolding
+- collapse duplicated logic
+- simplify branching/flow where possible
+- improve naming for clarity
+
+If complexity is unavoidable, add a short comment explaining why it is necessary.
+
+## Tooling Rules
+
+- Use `bun`/`bunx` only.
+- Run `bun run lint` and `bun run typecheck` before completion.
+- Use explicit types and avoid `any`.

package/README.md

@@ -5,36 +5,39 @@ Bun CLI for Lidian core REST endpoints.
 ## Install
 
 ```bash
-npm install -g @lidian/cli
-# or
-bunx @lidian/cli --help
+bunx @lidianai/cli --help
 ```
 
 ## Commands
 
 ```bash
-lidian query --q "<term>" [--page 1] [--pageSize 1..3] [--api-key <key>] [--json]
-lidian act --endpoint-id <uuid> --params '<json>' [--payment-rail prepaid_credits|x402] [--network base|ethereum] [--api-key <key>] [--json]
-lidian account [--api-key <key>] [--json]
+lidian discover --q "<term>" [--page 1] [--pageSize 1..3] [--category <name>] [--auth-type none|api_key|bearer|basic|oauth2|custom] [--min-price <cents>] [--max-price <cents>] [--api-key <key>] [--env production|staging] [--api-base <url>] [--json]
+lidian consume --endpoint-id <uuid> --params '<json>' [--payment-rail prepaid_credits|x402] [--network base|ethereum] [--api-key <key>] [--env production|staging] [--api-base <url>] [--json]
+lidian account [--api-key <key>] [--env production|staging] [--api-base <url>] [--json]
 lidian login [--key ld_...] [--json]
 lidian --help
 ```
 
-`query` returns API matches (`items[]`) from `/v1/query` with metadata and confidence fields (`matchScore`, `matchPercent`).
+`discover` returns API matches (`items[]`) from `/v1/discover` with metadata and confidence fields (`matchScore`, `matchPercent`).
 
 ## Auth
 
 - Store key locally: `lidian login --key ld_...` (writes `~/.lidian/config.json`)
 - Or run `lidian login` and paste your key after browser auth flow.
 - Resolution order: `--api-key` -> `LIDIAN_API_KEY` -> `~/.lidian/config.json`.
-- Optional: set `LIDIAN_API_BASE` (default `https://api.lidian.ai`).
+- API base resolution order:
+  - `--api-base`
+  - `LIDIAN_API_BASE`
+  - `--env` (`production` or `staging`)
+  - `LIDIAN_ENV` (`production` or `staging`)
+  - default `https://api.lidian.ai`
 
 ## x402
 
 When `--payment-rail x402` is used, CLI performs:
 1. `POST /v1/payments/requirements`
 2. `POST /v1/payments/verify`
-3. `POST /v1/act`
+3. `POST /v1/consume`
 
 ## Dev
 

package/bun.lock

@@ -0,0 +1,43 @@
+{
+  "lockfileVersion": 1,
+  "configVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "@lidian/cli",
+      "devDependencies": {
+        "@biomejs/biome": "^2.4.4",
+        "@types/bun": "^1.3.9",
+        "typescript": "^5.9.3",
+      },
+    },
+  },
+  "packages": {
+    "@biomejs/biome": ["@biomejs/biome@2.4.4", "", { "optionalDependencies": { "@biomejs/cli-darwin-arm64": "2.4.4", "@biomejs/cli-darwin-x64": "2.4.4", "@biomejs/cli-linux-arm64": "2.4.4", "@biomejs/cli-linux-arm64-musl": "2.4.4", "@biomejs/cli-linux-x64": "2.4.4", "@biomejs/cli-linux-x64-musl": "2.4.4", "@biomejs/cli-win32-arm64": "2.4.4", "@biomejs/cli-win32-x64": "2.4.4" }, "bin": { "biome": "bin/biome" } }, "sha512-tigwWS5KfJf0cABVd52NVaXyAVv4qpUXOWJ1rxFL8xF1RVoeS2q/LK+FHgYoKMclJCuRoCWAPy1IXaN9/mS61Q=="],
+
+    "@biomejs/cli-darwin-arm64": ["@biomejs/cli-darwin-arm64@2.4.4", "", { "os": "darwin", "cpu": "arm64" }, "sha512-jZ+Xc6qvD6tTH5jM6eKX44dcbyNqJHssfl2nnwT6vma6B1sj7ZLTGIk6N5QwVBs5xGN52r3trk5fgd3sQ9We9A=="],
+
+    "@biomejs/cli-darwin-x64": ["@biomejs/cli-darwin-x64@2.4.4", "", { "os": "darwin", "cpu": "x64" }, "sha512-Dh1a/+W+SUCXhEdL7TiX3ArPTFCQKJTI1mGncZNWfO+6suk+gYA4lNyJcBB+pwvF49uw0pEbUS49BgYOY4hzUg=="],
+
+    "@biomejs/cli-linux-arm64": ["@biomejs/cli-linux-arm64@2.4.4", "", { "os": "linux", "cpu": "arm64" }, "sha512-V/NFfbWhsUU6w+m5WYbBenlEAz8eYnSqRMDMAW3K+3v0tYVkNyZn8VU0XPxk/lOqNXLSCCrV7FmV/u3SjCBShg=="],
+
+    "@biomejs/cli-linux-arm64-musl": ["@biomejs/cli-linux-arm64-musl@2.4.4", "", { "os": "linux", "cpu": "arm64" }, "sha512-+sPAXq3bxmFwhVFJnSwkSF5Rw2ZAJMH3MF6C9IveAEOdSpgajPhoQhbbAK12SehN9j2QrHpk4J/cHsa/HqWaYQ=="],
+
+    "@biomejs/cli-linux-x64": ["@biomejs/cli-linux-x64@2.4.4", "", { "os": "linux", "cpu": "x64" }, "sha512-R4+ZCDtG9kHArasyBO+UBD6jr/FcFCTH8QkNTOCu0pRJzCWyWC4EtZa2AmUZB5h3e0jD7bRV2KvrENcf8rndBg=="],
+
+    "@biomejs/cli-linux-x64-musl": ["@biomejs/cli-linux-x64-musl@2.4.4", "", { "os": "linux", "cpu": "x64" }, "sha512-gGvFTGpOIQDb5CQ2VC0n9Z2UEqlP46c4aNgHmAMytYieTGEcfqhfCFnhs6xjt0S3igE6q5GLuIXtdQt3Izok+g=="],
+
+    "@biomejs/cli-win32-arm64": ["@biomejs/cli-win32-arm64@2.4.4", "", { "os": "win32", "cpu": "arm64" }, "sha512-trzCqM7x+Gn832zZHgr28JoYagQNX4CZkUZhMUac2YxvvyDRLJDrb5m9IA7CaZLlX6lTQmADVfLEKP1et1Ma4Q=="],
+
+    "@biomejs/cli-win32-x64": ["@biomejs/cli-win32-x64@2.4.4", "", { "os": "win32", "cpu": "x64" }, "sha512-gnOHKVPFAAPrpoPt2t+Q6FZ7RPry/FDV3GcpU53P3PtLNnQjBmKyN2Vh/JtqXet+H4pme8CC76rScwdjDcT1/A=="],
+
+    "@types/bun": ["@types/bun@1.3.9", "", { "dependencies": { "bun-types": "1.3.9" } }, "sha512-KQ571yULOdWJiMH+RIWIOZ7B2RXQGpL1YQrBtLIV3FqDcCu6FsbFUBwhdKUlCKUpS3PJDsHlJ1QKlpxoVR+xtw=="],
+
+    "@types/node": ["@types/node@25.3.0", "", { "dependencies": { "undici-types": "~7.18.0" } }, "sha512-4K3bqJpXpqfg2XKGK9bpDTc6xO/xoUP/RBWS7AtRMug6zZFaRekiLzjVtAoZMquxoAbzBvy5nxQ7veS5eYzf8A=="],
+
+    "bun-types": ["bun-types@1.3.9", "", { "dependencies": { "@types/node": "*" } }, "sha512-+UBWWOakIP4Tswh0Bt0QD0alpTY8cb5hvgiYeWCMet9YukHbzuruIEeXC2D7nMJPB12kbh8C7XJykSexEqGKJg=="],
+
+    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
+
+    "undici-types": ["undici-types@7.18.2", "", {}, "sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w=="],
+  }
+}

package/dist/index.js

@@ -24,15 +24,15 @@ var verifyPaymentAddress = async (http, apiKey, payTo) => {
   return http.post("/v1/payments/verify", { payTo }, apiKey);
 };
 
-// src/commands/act.ts
-var runActCommand = async (http, apiKey, input) => {
+// src/commands/consume.ts
+var runConsumeCommand = async (http, apiKey, input) => {
   if (!isUuid(input.endpointId)) {
     throw new CliError("endpointId must be a valid UUID.");
   }
   if (input.paymentRail === "x402") {
     const requirements = await requestPaymentRequirements(http, apiKey, input.endpointId, input.network);
     const verification = await verifyPaymentAddress(http, apiKey, requirements.payTo);
-    const execution2 = await http.post("/v1/act", input, apiKey);
+    const execution2 = await http.post("/v1/consume", input, apiKey);
     return {
       execution: execution2,
       payment: {
@@ -41,13 +41,35 @@ var runActCommand = async (http, apiKey, input) => {
       }
     };
   }
-  const execution = await http.post("/v1/act", input, apiKey);
+  const execution = await http.post("/v1/consume", input, apiKey);
   return { execution };
 };
 var isUuid = (value) => {
   return /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value);
 };
 
+// src/commands/discover.ts
+var runDiscoverCommand = async (http, apiKey, input) => {
+  if (input.pageSize < 1 || input.pageSize > 3) {
+    throw new CliError("pageSize must be between 1 and 3.");
+  }
+  const params = new URLSearchParams;
+  params.set("q", input.q);
+  params.set("page", String(input.page));
+  params.set("pageSize", String(input.pageSize));
+  if (input.category)
+    params.set("category", input.category);
+  if (input.authType)
+    params.set("authType", input.authType);
+  if (typeof input.minPrice === "number") {
+    params.set("minPrice", String(input.minPrice));
+  }
+  if (typeof input.maxPrice === "number") {
+    params.set("maxPrice", String(input.maxPrice));
+  }
+  return http.get(`/v1/discover?${params.toString()}`, apiKey);
+};
+
 // src/commands/login.ts
 import { stdin, stdout } from "process";
 import { createInterface } from "readline/promises";
@@ -93,7 +115,7 @@ var printResult = (result, asJson) => {
   }
   print(formatForHuman(result));
 };
-var printQueryResult = (result, asJson) => {
+var printDiscoverResult = (result, asJson) => {
   if (asJson) {
     printResult(result, true);
     return;
@@ -105,10 +127,10 @@ var printQueryResult = (result, asJson) => {
   print(`Found ${result.items.length} of ${result.total} APIs (page ${result.page}).`);
   for (const item of result.items) {
     const confidence = item.matchPercent ? ` confidence=${item.matchPercent.toFixed(1)}%` : "";
-    print(`- ${item.name} (${item.id}) auth=${item.authType} cost=${item.defaultCostPerUse}c${confidence}`);
+    print(`- ${item.name} (${item.id}) auth=${item.authType} cost=${item.defaultCostPerUse}c (${formatUsd(item.defaultCostPerUse)})${confidence}`);
   }
 };
-var printActResult = (result, asJson) => {
+var printConsumeResult = (result, asJson) => {
   if (asJson) {
     printResult(result.execution, true);
     return;
@@ -124,10 +146,10 @@ var printAccountResult = (result, asJson) => {
     return;
   }
   print(`Account: ${result.user.id}`);
-  print(`Balance: ${result.balance.balance} credits`);
+  print(`Balance: ${result.balance.balance} cents (${formatUsd(result.balance.balance)})`);
 };
 var printExecutionResult = (result) => {
-  print(`Execution succeeded. Spent=${result.credits.spent} balance=${result.credits.balance}`);
+  print(`Execution succeeded. Spent=${result.credits.spent} cents (${formatUsd(result.credits.spent)}) balance=${result.credits.balance} cents (${formatUsd(result.credits.balance)})`);
   print(JSON.stringify(result.data, null, 2));
 };
 var formatForHuman = (value) => {
@@ -136,6 +158,9 @@ var formatForHuman = (value) => {
   }
   return JSON.stringify(value, null, 2);
 };
+var formatUsd = (cents) => {
+  return `$${(cents / 100).toFixed(2)}`;
+};
 var fail = (error) => {
   if (error instanceof CliError) {
     printError(`Error: ${error.message}`);
@@ -198,19 +223,6 @@ var openUrl = (url) => {
   } catch {}
 };
 
-// src/commands/query.ts
-var runQueryCommand = async (http, apiKey, input) => {
-  if (input.pageSize < 1 || input.pageSize > 3) {
-    throw new CliError("pageSize must be between 1 and 3.");
-  }
-  const params = new URLSearchParams({
-    q: input.q,
-    page: String(input.page),
-    pageSize: String(input.pageSize)
-  });
-  return http.get(`/v1/query?${params.toString()}`, apiKey);
-};
-
 // src/lib/auth.ts
 var resolveApiKey = async (argsApiKey) => {
   const config = await readConfig();
@@ -264,10 +276,23 @@ var handleResponse = async (response) => {
 
 // src/index.ts
 var DEFAULT_API_BASE = "https://api.lidian.ai";
-var GLOBAL_OPTIONS = new Set(["api-key", "api-base", "json", "help"]);
+var API_BASE_BY_ENV = {
+  production: "https://api.lidian.ai",
+  staging: "https://staging-api.lidian.ai"
+};
+var GLOBAL_OPTIONS = new Set(["api-key", "api-base", "env", "json", "help"]);
+var BOOLEAN_OPTIONS = new Set(["json", "help"]);
 var COMMAND_OPTIONS = {
-  query: new Set(["q", "page", "pageSize"]),
-  act: new Set(["endpoint-id", "params", "payment-rail", "network"]),
+  discover: new Set([
+    "q",
+    "page",
+    "pageSize",
+    "category",
+    "auth-type",
+    "min-price",
+    "max-price"
+  ]),
+  consume: new Set(["endpoint-id", "params", "payment-rail", "network"]),
   account: new Set([]),
   login: new Set(["key"])
 };
@@ -277,7 +302,7 @@ var main = async () => {
     return;
   }
   const parsed = parseArgs(process.argv.slice(2));
-  const apiBase = String(parsed.options["api-base"] ?? process.env.LIDIAN_API_BASE ?? DEFAULT_API_BASE);
+  const apiBase = resolveApiBase(asString(parsed.options["api-base"]), asEnvironment(asString(parsed.options.env) ?? process.env.LIDIAN_ENV));
   const asJson = Boolean(parsed.options.json);
   const http = createHttpClient(apiBase);
   switch (parsed.command) {
@@ -291,39 +316,46 @@ var main = async () => {
       }
       return;
     }
-    case "query": {
+    case "discover": {
       const apiKey = await resolveApiKey(asString(parsed.options["api-key"]));
       const qValue = asString(parsed.options.q);
       if (!qValue) {
-        throw new CliError("Missing --q for query command.");
+        throw new CliError("Missing --q for discover command.");
       }
       const page = toInt(asString(parsed.options.page), 1);
       const pageSize = toInt(asString(parsed.options.pageSize), 1);
-      const result = await runQueryCommand(http, apiKey, {
+      const authType = asAuthType(asString(parsed.options["auth-type"]));
+      const minPrice = toNumber(asString(parsed.options["min-price"]), "min-price");
+      const maxPrice = toNumber(asString(parsed.options["max-price"]), "max-price");
+      const result = await runDiscoverCommand(http, apiKey, {
         q: qValue,
         page,
-        pageSize
+        pageSize,
+        category: asString(parsed.options.category),
+        ...authType ? { authType } : {},
+        ...typeof minPrice === "number" ? { minPrice } : {},
+        ...typeof maxPrice === "number" ? { maxPrice } : {}
       });
-      printQueryResult(result, asJson);
+      printDiscoverResult(result, asJson);
       return;
     }
-    case "act": {
+    case "consume": {
       const apiKey = await resolveApiKey(asString(parsed.options["api-key"]));
       const endpointIdValue = asString(parsed.options["endpoint-id"]);
       if (!endpointIdValue) {
-        throw new CliError("Missing --endpoint-id for act command.");
+        throw new CliError("Missing --endpoint-id for consume command.");
       }
       const paramsRaw = asString(parsed.options.params) ?? "{}";
       const params = parseJsonObject(paramsRaw, "--params");
       const paymentRail = asPaymentRail(asString(parsed.options["payment-rail"]) ?? "prepaid_credits");
-      const network = asString(parsed.options.network);
-      const result = await runActCommand(http, apiKey, {
+      const network = asNetwork(asString(parsed.options.network));
+      const result = await runConsumeCommand(http, apiKey, {
         endpointId: endpointIdValue,
         params,
         paymentRail,
         ...network ? { network } : {}
       });
-      printActResult(result, asJson);
+      printConsumeResult(result, asJson);
       return;
     }
     case "account": {
@@ -338,9 +370,9 @@ var main = async () => {
 };
 var parseArgs = (argv) => {
   const command = argv[0];
-  if (command !== "query" && command !== "act" && command !== "account" && command !== "login") {
+  if (command !== "discover" && command !== "consume" && command !== "account" && command !== "login") {
     printUsage();
-    throw new CliError("Invalid command. Use one of: login, query, act, account.", 1);
+    throw new CliError("Invalid command. Use one of: login, discover, consume, account.", 1);
   }
   const options = {};
   let index = 1;
@@ -356,6 +388,9 @@ var parseArgs = (argv) => {
     }
     const next = argv[index + 1];
     if (!next || next.startsWith("--")) {
+      if (!BOOLEAN_OPTIONS.has(key)) {
+        throw new CliError(`Missing value for --${key}`);
+      }
       options[key] = true;
       index += 1;
       continue;
@@ -371,10 +406,16 @@ var parseArgs = (argv) => {
 var printUsage = () => {
   print("Usage:");
   print("  lidian login [--key ld_...] [--json]");
-  print('  lidian query --q "<term>" [--page 1] [--pageSize 1..3] [--api-key <key>] [--json]');
-  print("  lidian act --endpoint-id <uuid> --params '<json>' [--payment-rail prepaid_credits|x402] [--api-key <key>] [--json]");
+  print('  lidian discover --q "<term>" [--page 1] [--pageSize 1..3] [--category <name>] [--auth-type none|api_key|bearer|basic|oauth2|custom]');
+  print("               [--min-price <cents>] [--max-price <cents>] [--api-key <key>] [--env production|staging] [--api-base <url>] [--json]");
+  print("  lidian consume --endpoint-id <uuid> --params '<json>' [--payment-rail prepaid_credits|x402] [--api-key <key>] [--env production|staging] [--api-base <url>] [--json]");
   print("             [--network base|ethereum]");
-  print("  lidian account [--api-key <key>] [--json]");
+  print("  lidian account [--api-key <key>] [--env production|staging] [--api-base <url>] [--json]");
+  print("");
+  print("Env resolution:");
+  print("  --api-base > LIDIAN_API_BASE > --env > LIDIAN_ENV > production");
+  print(`  production=${API_BASE_BY_ENV.production}`);
+  print(`  staging=${API_BASE_BY_ENV.staging}`);
 };
 var asString = (value) => {
   if (typeof value === "string")
@@ -385,13 +426,27 @@ var toInt = (value, fallback) => {
   if (!value)
     return fallback;
   const parsed = Number.parseInt(value, 10);
-  if (Number.isNaN(parsed)) {
+  if (Number.isNaN(parsed) || parsed < 1) {
     throw new CliError(`Invalid integer value: ${value}`);
   }
   return parsed;
 };
+var toNumber = (value, flagName) => {
+  if (!value)
+    return;
+  const parsed = Number(value);
+  if (Number.isNaN(parsed)) {
+    throw new CliError(`Invalid --${flagName} value: ${value}`);
+  }
+  return parsed;
+};
 var parseJsonObject = (value, flagName) => {
-  const parsed = JSON.parse(value);
+  let parsed;
+  try {
+    parsed = JSON.parse(value);
+  } catch {
+    throw new CliError(`${flagName} must be valid JSON.`);
+  }
   if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
     throw new CliError(`${flagName} must be a JSON object.`);
   }
@@ -402,4 +457,43 @@ var asPaymentRail = (value) => {
     return value;
   throw new CliError("Invalid --payment-rail. Use prepaid_credits or x402.");
 };
+var asAuthType = (value) => {
+  if (!value)
+    return;
+  const valid = new Set([
+    "none",
+    "api_key",
+    "bearer",
+    "basic",
+    "oauth2",
+    "custom"
+  ]);
+  if (valid.has(value)) {
+    return value;
+  }
+  throw new CliError("Invalid --auth-type. Use none, api_key, bearer, basic, oauth2, or custom.");
+};
+var asNetwork = (value) => {
+  if (!value)
+    return;
+  if (value === "base" || value === "ethereum")
+    return value;
+  throw new CliError("Invalid --network. Use base or ethereum.");
+};
+var asEnvironment = (value) => {
+  if (!value)
+    return;
+  if (value === "production" || value === "staging")
+    return value;
+  throw new CliError("Invalid --env. Use production or staging.");
+};
+var resolveApiBase = (cliApiBase, environment) => {
+  if (cliApiBase)
+    return cliApiBase;
+  if (process.env.LIDIAN_API_BASE)
+    return process.env.LIDIAN_API_BASE;
+  if (environment)
+    return API_BASE_BY_ENV[environment];
+  return DEFAULT_API_BASE;
+};
 main().catch(fail);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lidianai/cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "private": false,
   "type": "module",
   "publishConfig": {

package/src/commands/{act.ts → consume.ts}

@@ -8,14 +8,14 @@ import {
 
 export type PaymentRail = "prepaid_credits" | "x402";
 
-export interface ActCommandInput {
+export interface ConsumeCommandInput {
   endpointId: string;
   params: Record<string, unknown>;
   paymentRail: PaymentRail;
   network?: string;
 }
 
-export interface ActApiResponse {
+export interface ConsumeApiResponse {
   data: unknown;
   credits: {
     spent: number;
@@ -23,19 +23,19 @@ export interface ActApiResponse {
   };
 }
 
-export interface ActCommandResult {
-  execution: ActApiResponse;
+export interface ConsumeCommandResult {
+  execution: ConsumeApiResponse;
   payment?: {
     requirements: PaymentRequirementsResponse;
     verified: boolean;
   };
 }
 
-export const runActCommand = async (
+export const runConsumeCommand = async (
   http: HttpClient,
   apiKey: string,
-  input: ActCommandInput,
-): Promise<ActCommandResult> => {
+  input: ConsumeCommandInput,
+): Promise<ConsumeCommandResult> => {
   if (!isUuid(input.endpointId)) {
     throw new CliError("endpointId must be a valid UUID.");
   }
@@ -53,8 +53,8 @@ export const runActCommand = async (
       requirements.payTo,
     );
 
-    const execution = await http.post<ActApiResponse, ActCommandInput>(
-      "/v1/act",
+    const execution = await http.post<ConsumeApiResponse, ConsumeCommandInput>(
+      "/v1/consume",
       input,
       apiKey,
     );
@@ -68,8 +68,8 @@ export const runActCommand = async (
     };
   }
 
-  const execution = await http.post<ActApiResponse, ActCommandInput>(
-    "/v1/act",
+  const execution = await http.post<ConsumeApiResponse, ConsumeCommandInput>(
+    "/v1/consume",
     input,
     apiKey,
   );

package/src/commands/discover.ts

@@ -0,0 +1,59 @@
+import { CliError } from "@/lib/errors";
+import type { HttpClient } from "@/lib/http";
+
+export interface DiscoverCommandInput {
+  q: string;
+  page: number;
+  pageSize: number;
+  category?: string;
+  authType?: "none" | "api_key" | "bearer" | "basic" | "oauth2" | "custom";
+  minPrice?: number;
+  maxPrice?: number;
+}
+
+export interface DiscoverApiResponse {
+  items: Array<{
+    id: string;
+    merchantId: string | null;
+    name: string;
+    description: string | null;
+    endpointBase: string;
+    authType: "none" | "api_key" | "bearer" | "basic" | "oauth2" | "custom";
+    defaultCostPerUse: number;
+    isActive: boolean;
+    openapiSpecUrl: string | null;
+    createdAt: string;
+    updatedAt: string;
+    matchScore?: number;
+    matchPercent?: number;
+  }>;
+  total: number;
+  page: number;
+  pageSize: number;
+}
+
+export const runDiscoverCommand = async (
+  http: HttpClient,
+  apiKey: string,
+  input: DiscoverCommandInput,
+): Promise<DiscoverApiResponse> => {
+  if (input.pageSize < 1 || input.pageSize > 3) {
+    throw new CliError("pageSize must be between 1 and 3.");
+  }
+  const params = new URLSearchParams();
+  params.set("q", input.q);
+  params.set("page", String(input.page));
+  params.set("pageSize", String(input.pageSize));
+  if (input.category) params.set("category", input.category);
+  if (input.authType) params.set("authType", input.authType);
+  if (typeof input.minPrice === "number") {
+    params.set("minPrice", String(input.minPrice));
+  }
+  if (typeof input.maxPrice === "number") {
+    params.set("maxPrice", String(input.maxPrice));
+  }
+  return http.get<DiscoverApiResponse>(
+    `/v1/discover?${params.toString()}`,
+    apiKey,
+  );
+};

package/src/index.ts

@@ -1,9 +1,9 @@
 #!/usr/bin/env bun
 
 import { runAccountCommand } from "@/commands/account";
-import { type PaymentRail, runActCommand } from "@/commands/act";
+import { type PaymentRail, runConsumeCommand } from "@/commands/consume";
+import { runDiscoverCommand } from "@/commands/discover";
 import { runLoginCommand } from "@/commands/login";
-import { runQueryCommand } from "@/commands/query";
 import { resolveApiKey } from "@/lib/auth";
 import { CliError } from "@/lib/errors";
 import { createHttpClient } from "@/lib/http";
@@ -11,20 +11,35 @@ import {
   fail,
   print,
   printAccountResult,
-  printActResult,
-  printQueryResult,
+  printConsumeResult,
+  printDiscoverResult,
 } from "@/lib/output";
 
 interface ParsedArgs {
-  command: "query" | "act" | "account" | "login";
+  command: "discover" | "consume" | "account" | "login";
   options: Record<string, string | boolean>;
 }
 
 const DEFAULT_API_BASE = "https://api.lidian.ai";
-const GLOBAL_OPTIONS = new Set(["api-key", "api-base", "json", "help"]);
+const API_BASE_BY_ENV = {
+  production: "https://api.lidian.ai",
+  staging: "https://staging-api.lidian.ai",
+} as const;
+type Environment = keyof typeof API_BASE_BY_ENV;
+
+const GLOBAL_OPTIONS = new Set(["api-key", "api-base", "env", "json", "help"]);
+const BOOLEAN_OPTIONS = new Set(["json", "help"]);
 const COMMAND_OPTIONS: Record<ParsedArgs["command"], Set<string>> = {
-  query: new Set(["q", "page", "pageSize"]),
-  act: new Set(["endpoint-id", "params", "payment-rail", "network"]),
+  discover: new Set([
+    "q",
+    "page",
+    "pageSize",
+    "category",
+    "auth-type",
+    "min-price",
+    "max-price",
+  ]),
+  consume: new Set(["endpoint-id", "params", "payment-rail", "network"]),
   account: new Set([]),
   login: new Set(["key"]),
 };
@@ -35,10 +50,9 @@ const main = async (): Promise<void> => {
     return;
   }
   const parsed = parseArgs(process.argv.slice(2));
-  const apiBase = String(
-    parsed.options["api-base"] ??
-      process.env.LIDIAN_API_BASE ??
-      DEFAULT_API_BASE,
+  const apiBase = resolveApiBase(
+    asString(parsed.options["api-base"]),
+    asEnvironment(asString(parsed.options.env) ?? process.env.LIDIAN_ENV),
   );
   const asJson = Boolean(parsed.options.json);
   const http = createHttpClient(apiBase);
@@ -54,41 +68,54 @@ const main = async (): Promise<void> => {
       }
       return;
     }
-    case "query": {
+    case "discover": {
       const apiKey = await resolveApiKey(asString(parsed.options["api-key"]));
       const qValue = asString(parsed.options.q);
       if (!qValue) {
-        throw new CliError("Missing --q for query command.");
+        throw new CliError("Missing --q for discover command.");
       }
       const page = toInt(asString(parsed.options.page), 1);
       const pageSize = toInt(asString(parsed.options.pageSize), 1);
-      const result = await runQueryCommand(http, apiKey, {
+      const authType = asAuthType(asString(parsed.options["auth-type"]));
+      const minPrice = toNumber(
+        asString(parsed.options["min-price"]),
+        "min-price",
+      );
+      const maxPrice = toNumber(
+        asString(parsed.options["max-price"]),
+        "max-price",
+      );
+      const result = await runDiscoverCommand(http, apiKey, {
         q: qValue,
         page,
         pageSize,
+        category: asString(parsed.options.category),
+        ...(authType ? { authType } : {}),
+        ...(typeof minPrice === "number" ? { minPrice } : {}),
+        ...(typeof maxPrice === "number" ? { maxPrice } : {}),
       });
-      printQueryResult(result, asJson);
+      printDiscoverResult(result, asJson);
       return;
     }
-    case "act": {
+    case "consume": {
       const apiKey = await resolveApiKey(asString(parsed.options["api-key"]));
       const endpointIdValue = asString(parsed.options["endpoint-id"]);
       if (!endpointIdValue) {
-        throw new CliError("Missing --endpoint-id for act command.");
+        throw new CliError("Missing --endpoint-id for consume command.");
       }
       const paramsRaw = asString(parsed.options.params) ?? "{}";
       const params = parseJsonObject(paramsRaw, "--params");
       const paymentRail = asPaymentRail(
         asString(parsed.options["payment-rail"]) ?? "prepaid_credits",
       );
-      const network = asString(parsed.options.network);
-      const result = await runActCommand(http, apiKey, {
+      const network = asNetwork(asString(parsed.options.network));
+      const result = await runConsumeCommand(http, apiKey, {
         endpointId: endpointIdValue,
         params,
         paymentRail,
         ...(network ? { network } : {}),
       });
-      printActResult(result, asJson);
+      printConsumeResult(result, asJson);
       return;
     }
     case "account": {
@@ -105,14 +132,14 @@ const main = async (): Promise<void> => {
 const parseArgs = (argv: string[]): ParsedArgs => {
   const command = argv[0];
   if (
-    command !== "query" &&
-    command !== "act" &&
+    command !== "discover" &&
+    command !== "consume" &&
     command !== "account" &&
     command !== "login"
   ) {
     printUsage();
     throw new CliError(
-      "Invalid command. Use one of: login, query, act, account.",
+      "Invalid command. Use one of: login, discover, consume, account.",
       1,
     );
   }
@@ -132,6 +159,9 @@ const parseArgs = (argv: string[]): ParsedArgs => {
     }
     const next = argv[index + 1];
     if (!next || next.startsWith("--")) {
+      if (!BOOLEAN_OPTIONS.has(key)) {
+        throw new CliError(`Missing value for --${key}`);
+      }
       options[key] = true;
       index += 1;
       continue;
@@ -151,13 +181,23 @@ const printUsage = (): void => {
   print("Usage:");
   print("  lidian login [--key ld_...] [--json]");
   print(
-    '  lidian query --q "<term>" [--page 1] [--pageSize 1..3] [--api-key <key>] [--json]',
+    '  lidian discover --q "<term>" [--page 1] [--pageSize 1..3] [--category <name>] [--auth-type none|api_key|bearer|basic|oauth2|custom]',
   );
   print(
-    "  lidian act --endpoint-id <uuid> --params '<json>' [--payment-rail prepaid_credits|x402] [--api-key <key>] [--json]",
+    "               [--min-price <cents>] [--max-price <cents>] [--api-key <key>] [--env production|staging] [--api-base <url>] [--json]",
+  );
+  print(
+    "  lidian consume --endpoint-id <uuid> --params '<json>' [--payment-rail prepaid_credits|x402] [--api-key <key>] [--env production|staging] [--api-base <url>] [--json]",
   );
   print("             [--network base|ethereum]");
-  print("  lidian account [--api-key <key>] [--json]");
+  print(
+    "  lidian account [--api-key <key>] [--env production|staging] [--api-base <url>] [--json]",
+  );
+  print("");
+  print("Env resolution:");
+  print("  --api-base > LIDIAN_API_BASE > --env > LIDIAN_ENV > production");
+  print(`  production=${API_BASE_BY_ENV.production}`);
+  print(`  staging=${API_BASE_BY_ENV.staging}`);
 };
 
 const asString = (value: string | boolean | undefined): string | undefined => {
@@ -168,17 +208,34 @@ const asString = (value: string | boolean | undefined): string | undefined => {
 const toInt = (value: string | undefined, fallback: number): number => {
   if (!value) return fallback;
   const parsed = Number.parseInt(value, 10);
-  if (Number.isNaN(parsed)) {
+  if (Number.isNaN(parsed) || parsed < 1) {
     throw new CliError(`Invalid integer value: ${value}`);
   }
   return parsed;
 };
 
+const toNumber = (
+  value: string | undefined,
+  flagName: string,
+): number | undefined => {
+  if (!value) return undefined;
+  const parsed = Number(value);
+  if (Number.isNaN(parsed)) {
+    throw new CliError(`Invalid --${flagName} value: ${value}`);
+  }
+  return parsed;
+};
+
 const parseJsonObject = (
   value: string,
   flagName: string,
 ): Record<string, unknown> => {
-  const parsed = JSON.parse(value) as unknown;
+  let parsed: unknown;
+  try {
+    parsed = JSON.parse(value) as unknown;
+  } catch {
+    throw new CliError(`${flagName} must be valid JSON.`);
+  }
   if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
     throw new CliError(`${flagName} must be a JSON object.`);
   }
@@ -190,4 +247,59 @@ const asPaymentRail = (value: string): PaymentRail => {
   throw new CliError("Invalid --payment-rail. Use prepaid_credits or x402.");
 };
 
+const asAuthType = (
+  value: string | undefined,
+):
+  | "none"
+  | "api_key"
+  | "bearer"
+  | "basic"
+  | "oauth2"
+  | "custom"
+  | undefined => {
+  if (!value) return undefined;
+  const valid = new Set([
+    "none",
+    "api_key",
+    "bearer",
+    "basic",
+    "oauth2",
+    "custom",
+  ]);
+  if (valid.has(value)) {
+    return value as
+      | "none"
+      | "api_key"
+      | "bearer"
+      | "basic"
+      | "oauth2"
+      | "custom";
+  }
+  throw new CliError(
+    "Invalid --auth-type. Use none, api_key, bearer, basic, oauth2, or custom.",
+  );
+};
+
+const asNetwork = (value: string | undefined): string | undefined => {
+  if (!value) return undefined;
+  if (value === "base" || value === "ethereum") return value;
+  throw new CliError("Invalid --network. Use base or ethereum.");
+};
+
+const asEnvironment = (value: string | undefined): Environment | undefined => {
+  if (!value) return undefined;
+  if (value === "production" || value === "staging") return value;
+  throw new CliError("Invalid --env. Use production or staging.");
+};
+
+const resolveApiBase = (
+  cliApiBase: string | undefined,
+  environment: Environment | undefined,
+): string => {
+  if (cliApiBase) return cliApiBase;
+  if (process.env.LIDIAN_API_BASE) return process.env.LIDIAN_API_BASE;
+  if (environment) return API_BASE_BY_ENV[environment];
+  return DEFAULT_API_BASE;
+};
+
 main().catch(fail);

package/src/lib/output.ts

@@ -1,6 +1,9 @@
 import type { AccountApiResponse } from "@/commands/account";
-import type { ActApiResponse, ActCommandResult } from "@/commands/act";
-import type { QueryApiResponse } from "@/commands/query";
+import type {
+  ConsumeApiResponse,
+  ConsumeCommandResult,
+} from "@/commands/consume";
+import type { DiscoverApiResponse } from "@/commands/discover";
 import { CliError } from "@/lib/errors";
 
 export const print = (message: string): void => {
@@ -19,8 +22,8 @@ export const printResult = (result: unknown, asJson: boolean): void => {
   print(formatForHuman(result));
 };
 
-export const printQueryResult = (
-  result: QueryApiResponse,
+export const printDiscoverResult = (
+  result: DiscoverApiResponse,
   asJson: boolean,
 ): void => {
   if (asJson) {
@@ -39,13 +42,13 @@ export const printQueryResult = (
       ? ` confidence=${item.matchPercent.toFixed(1)}%`
       : "";
     print(
-      `- ${item.name} (${item.id}) auth=${item.authType} cost=${item.defaultCostPerUse}c${confidence}`,
+      `- ${item.name} (${item.id}) auth=${item.authType} cost=${item.defaultCostPerUse}c (${formatUsd(item.defaultCostPerUse)})${confidence}`,
     );
   }
 };
 
-export const printActResult = (
-  result: ActCommandResult,
+export const printConsumeResult = (
+  result: ConsumeCommandResult,
   asJson: boolean,
 ): void => {
   if (asJson) {
@@ -69,12 +72,14 @@ export const printAccountResult = (
     return;
   }
   print(`Account: ${result.user.id}`);
-  print(`Balance: ${result.balance.balance} credits`);
+  print(
+    `Balance: ${result.balance.balance} cents (${formatUsd(result.balance.balance)})`,
+  );
 };
 
-const printExecutionResult = (result: ActApiResponse): void => {
+const printExecutionResult = (result: ConsumeApiResponse): void => {
   print(
-    `Execution succeeded. Spent=${result.credits.spent} balance=${result.credits.balance}`,
+    `Execution succeeded. Spent=${result.credits.spent} cents (${formatUsd(result.credits.spent)}) balance=${result.credits.balance} cents (${formatUsd(result.credits.balance)})`,
   );
   print(JSON.stringify(result.data, null, 2));
 };
@@ -86,6 +91,10 @@ const formatForHuman = (value: unknown): string => {
   return JSON.stringify(value, null, 2);
 };
 
+const formatUsd = (cents: number): string => {
+  return `$${(cents / 100).toFixed(2)}`;
+};
+
 export const fail = (error: unknown): never => {
   if (error instanceof CliError) {
     printError(`Error: ${error.message}`);

package/src/commands/query.ts

@@ -1,45 +0,0 @@
-import { CliError } from "@/lib/errors";
-import type { HttpClient } from "@/lib/http";
-
-export interface QueryCommandInput {
-  q: string;
-  page: number;
-  pageSize: number;
-}
-
-export interface QueryApiResponse {
-  items: Array<{
-    id: string;
-    merchantId: string | null;
-    name: string;
-    description: string | null;
-    endpointBase: string;
-    authType: "none" | "api_key" | "bearer" | "basic" | "oauth2" | "custom";
-    defaultCostPerUse: number;
-    isActive: boolean;
-    openapiSpecUrl: string | null;
-    createdAt: string;
-    updatedAt: string;
-    matchScore?: number;
-    matchPercent?: number;
-  }>;
-  total: number;
-  page: number;
-  pageSize: number;
-}
-
-export const runQueryCommand = async (
-  http: HttpClient,
-  apiKey: string,
-  input: QueryCommandInput,
-): Promise<QueryApiResponse> => {
-  if (input.pageSize < 1 || input.pageSize > 3) {
-    throw new CliError("pageSize must be between 1 and 3.");
-  }
-  const params = new URLSearchParams({
-    q: input.q,
-    page: String(input.page),
-    pageSize: String(input.pageSize),
-  });
-  return http.get<QueryApiResponse>(`/v1/query?${params.toString()}`, apiKey);
-};