@lidianai/cli 0.1.1 → 0.1.3

package/README.md

@@ -13,6 +13,7 @@ bunx @lidianai/cli --help
 ```bash
 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 feedback --execution-id <uuid> --rank <0..10> [--feedback "<text>"] [--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
@@ -37,7 +38,14 @@ lidian --help
 When `--payment-rail x402` is used, CLI performs:
 1. `POST /v1/payments/requirements`
 2. `POST /v1/payments/verify`
-3. `POST /v1/consume`
+3. `POST /v1/consume` (returns `executionId`)
+
+Submit feedback later:
+4. `POST /v1/consume/feedback` with `executionId`, `rank`, optional `feedback`
+
+Default payment rail behavior when `--payment-rail` is omitted:
+- with API key/token: `prepaid_credits`
+- without auth: `x402`
 
 ## Dev
 

package/dist/index.js

@@ -70,6 +70,23 @@ var runDiscoverCommand = async (http, apiKey, input) => {
   return http.get(`/v1/discover?${params.toString()}`, apiKey);
 };
 
+// src/commands/feedback.ts
+var runFeedbackCommand = async (http, apiKey, input) => {
+  if (!isUuid2(input.executionId)) {
+    throw new CliError("executionId must be a valid UUID.");
+  }
+  if (!Number.isInteger(input.rank) || input.rank < 0 || input.rank > 10) {
+    throw new CliError("rank must be an integer between 0 and 10.");
+  }
+  if (typeof input.feedback === "string" && input.feedback.length > 1000) {
+    throw new CliError("feedback cannot exceed 1000 characters.");
+  }
+  return http.post("/v1/consume/feedback", input, apiKey);
+};
+var isUuid2 = (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/login.ts
 import { stdin, stdout } from "process";
 import { createInterface } from "readline/promises";
@@ -148,7 +165,18 @@ var printAccountResult = (result, asJson) => {
   print(`Account: ${result.user.id}`);
   print(`Balance: ${result.balance.balance} cents (${formatUsd(result.balance.balance)})`);
 };
+var printFeedbackResult = (result, asJson) => {
+  if (asJson) {
+    printResult(result, true);
+    return;
+  }
+  const feedback = result.feedback ?? "<none>";
+  print(`Feedback saved for execution=${result.executionId} rank=${result.rank} submittedBy=${result.submittedBy}`);
+  print(`Updated at: ${result.updatedAt}`);
+  print(`Comment: ${feedback}`);
+};
 var printExecutionResult = (result) => {
+  print(`Execution ID: ${result.executionId}`);
   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));
 };
@@ -226,11 +254,7 @@ var openUrl = (url) => {
 // src/lib/auth.ts
 var resolveApiKey = async (argsApiKey) => {
   const config = await readConfig();
-  const key = argsApiKey ?? process.env.LIDIAN_API_KEY ?? config.apiKey;
-  if (!key) {
-    throw new CliError("Missing API key. Use `lidian login --key ld_...`, pass --api-key, or set LIDIAN_API_KEY.");
-  }
-  return key;
+  return argsApiKey ?? process.env.LIDIAN_API_KEY ?? config.apiKey;
 };
 
 // src/lib/http.ts
@@ -257,15 +281,26 @@ var createHttpClient = (baseUrl) => {
     }
   };
 };
-var authHeaders = (apiKey) => ({
-  Authorization: `Bearer ${apiKey}`
-});
+var authHeaders = (apiKey) => {
+  if (!apiKey || apiKey.trim().length === 0) {
+    return {};
+  }
+  return {
+    Authorization: `Bearer ${apiKey}`
+  };
+};
 var handleResponse = async (response) => {
   const json = await response.json().catch(() => null);
   if (!response.ok) {
     if (json && "success" in json && json.success === false) {
       throw new CliError(`${json.error.code}: ${json.error.message}`, 1);
     }
+    if (json && typeof json === "object" && "error" in json && typeof json.error === "string") {
+      throw new CliError(json.error, 1);
+    }
+    if (json && typeof json === "object" && "message" in json && typeof json.message === "string") {
+      throw new CliError(json.message, 1);
+    }
     throw new CliError(`Request failed with status ${response.status}`, 1);
   }
   if (!json || !("success" in json) || json.success !== true) {
@@ -293,6 +328,7 @@ var COMMAND_OPTIONS = {
     "max-price"
   ]),
   consume: new Set(["endpoint-id", "params", "payment-rail", "network"]),
+  feedback: new Set(["execution-id", "rank", "feedback"]),
   account: new Set([]),
   login: new Set(["key"])
 };
@@ -347,7 +383,7 @@ var main = async () => {
       }
       const paramsRaw = asString(parsed.options.params) ?? "{}";
       const params = parseJsonObject(paramsRaw, "--params");
-      const paymentRail = asPaymentRail(asString(parsed.options["payment-rail"]) ?? "prepaid_credits");
+      const paymentRail = resolvePaymentRail(asString(parsed.options["payment-rail"]), apiKey);
       const network = asNetwork(asString(parsed.options.network));
       const result = await runConsumeCommand(http, apiKey, {
         endpointId: endpointIdValue,
@@ -364,15 +400,35 @@ var main = async () => {
       printAccountResult(result, asJson);
       return;
     }
+    case "feedback": {
+      const apiKey = await resolveApiKey(asString(parsed.options["api-key"]));
+      const executionId = asString(parsed.options["execution-id"]);
+      if (!executionId) {
+        throw new CliError("Missing --execution-id for feedback command.");
+      }
+      const rankRaw = asString(parsed.options.rank);
+      if (!rankRaw) {
+        throw new CliError("Missing --rank for feedback command.");
+      }
+      const rank = toIntInRange(rankRaw, "rank", 0, 10);
+      const feedback = asString(parsed.options.feedback);
+      const result = await runFeedbackCommand(http, apiKey, {
+        executionId,
+        rank,
+        ...feedback ? { feedback } : {}
+      });
+      printFeedbackResult(result, asJson);
+      return;
+    }
     default:
       throw new CliError("Unknown command.", 1);
   }
 };
 var parseArgs = (argv) => {
   const command = argv[0];
-  if (command !== "discover" && command !== "consume" && command !== "account" && command !== "login") {
+  if (command !== "discover" && command !== "consume" && command !== "feedback" && command !== "account" && command !== "login") {
     printUsage();
-    throw new CliError("Invalid command. Use one of: login, discover, consume, account.", 1);
+    throw new CliError("Invalid command. Use one of: login, discover, consume, feedback, account.", 1);
   }
   const options = {};
   let index = 1;
@@ -410,6 +466,7 @@ var printUsage = () => {
   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 feedback --execution-id <uuid> --rank <0..10> [--feedback "<text>"] [--api-key <key>] [--env production|staging] [--api-base <url>] [--json]');
   print("  lidian account [--api-key <key>] [--env production|staging] [--api-base <url>] [--json]");
   print("");
   print("Env resolution:");
@@ -431,6 +488,13 @@ var toInt = (value, fallback) => {
   }
   return parsed;
 };
+var toIntInRange = (value, flagName, min, max) => {
+  const parsed = Number.parseInt(value, 10);
+  if (Number.isNaN(parsed) || String(parsed) !== value || parsed < min || parsed > max) {
+    throw new CliError(`Invalid --${flagName} value: ${value}. Expected integer ${min}..${max}.`);
+  }
+  return parsed;
+};
 var toNumber = (value, flagName) => {
   if (!value)
     return;
@@ -457,6 +521,12 @@ var asPaymentRail = (value) => {
     return value;
   throw new CliError("Invalid --payment-rail. Use prepaid_credits or x402.");
 };
+var resolvePaymentRail = (value, apiKey) => {
+  if (value) {
+    return asPaymentRail(value);
+  }
+  return apiKey && apiKey.trim().length > 0 ? "prepaid_credits" : "x402";
+};
 var asAuthType = (value) => {
   if (!value)
     return;

package/package.json

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

package/src/commands/account.ts

@@ -17,7 +17,7 @@ export interface AccountApiResponse {
 
 export const runAccountCommand = async (
   http: HttpClient,
-  apiKey: string,
+  apiKey: string | undefined,
 ): Promise<AccountApiResponse> => {
   return http.get<AccountApiResponse>("/v1/account", apiKey);
 };

package/src/commands/consume.ts

@@ -16,6 +16,7 @@ export interface ConsumeCommandInput {
 }
 
 export interface ConsumeApiResponse {
+  executionId: string;
   data: unknown;
   credits: {
     spent: number;
@@ -33,7 +34,7 @@ export interface ConsumeCommandResult {
 
 export const runConsumeCommand = async (
   http: HttpClient,
-  apiKey: string,
+  apiKey: string | undefined,
   input: ConsumeCommandInput,
 ): Promise<ConsumeCommandResult> => {
   if (!isUuid(input.endpointId)) {

package/src/commands/discover.ts

@@ -34,7 +34,7 @@ export interface DiscoverApiResponse {
 
 export const runDiscoverCommand = async (
   http: HttpClient,
-  apiKey: string,
+  apiKey: string | undefined,
   input: DiscoverCommandInput,
 ): Promise<DiscoverApiResponse> => {
   if (input.pageSize < 1 || input.pageSize > 3) {

package/src/commands/feedback.ts

@@ -0,0 +1,44 @@
+import { CliError } from "@/lib/errors";
+import type { HttpClient } from "@/lib/http";
+
+export interface FeedbackCommandInput {
+  executionId: string;
+  rank: number;
+  feedback?: string;
+}
+
+export interface FeedbackApiResponse {
+  executionId: string;
+  rank: number;
+  feedback: string | null;
+  submittedBy: "agent" | "human";
+  updatedAt: string;
+}
+
+export const runFeedbackCommand = async (
+  http: HttpClient,
+  apiKey: string | undefined,
+  input: FeedbackCommandInput,
+): Promise<FeedbackApiResponse> => {
+  if (!isUuid(input.executionId)) {
+    throw new CliError("executionId must be a valid UUID.");
+  }
+  if (!Number.isInteger(input.rank) || input.rank < 0 || input.rank > 10) {
+    throw new CliError("rank must be an integer between 0 and 10.");
+  }
+  if (typeof input.feedback === "string" && input.feedback.length > 1000) {
+    throw new CliError("feedback cannot exceed 1000 characters.");
+  }
+
+  return http.post<FeedbackApiResponse, FeedbackCommandInput>(
+    "/v1/consume/feedback",
+    input,
+    apiKey,
+  );
+};
+
+const isUuid = (value: string): boolean => {
+  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,
+  );
+};

package/src/index.ts

@@ -3,6 +3,7 @@
 import { runAccountCommand } from "@/commands/account";
 import { type PaymentRail, runConsumeCommand } from "@/commands/consume";
 import { runDiscoverCommand } from "@/commands/discover";
+import { runFeedbackCommand } from "@/commands/feedback";
 import { runLoginCommand } from "@/commands/login";
 import { resolveApiKey } from "@/lib/auth";
 import { CliError } from "@/lib/errors";
@@ -13,10 +14,11 @@ import {
   printAccountResult,
   printConsumeResult,
   printDiscoverResult,
+  printFeedbackResult,
 } from "@/lib/output";
 
 interface ParsedArgs {
-  command: "discover" | "consume" | "account" | "login";
+  command: "discover" | "consume" | "feedback" | "account" | "login";
   options: Record<string, string | boolean>;
 }
 
@@ -40,6 +42,7 @@ const COMMAND_OPTIONS: Record<ParsedArgs["command"], Set<string>> = {
     "max-price",
   ]),
   consume: new Set(["endpoint-id", "params", "payment-rail", "network"]),
+  feedback: new Set(["execution-id", "rank", "feedback"]),
   account: new Set([]),
   login: new Set(["key"]),
 };
@@ -105,8 +108,9 @@ const main = async (): Promise<void> => {
       }
       const paramsRaw = asString(parsed.options.params) ?? "{}";
       const params = parseJsonObject(paramsRaw, "--params");
-      const paymentRail = asPaymentRail(
-        asString(parsed.options["payment-rail"]) ?? "prepaid_credits",
+      const paymentRail = resolvePaymentRail(
+        asString(parsed.options["payment-rail"]),
+        apiKey,
       );
       const network = asNetwork(asString(parsed.options.network));
       const result = await runConsumeCommand(http, apiKey, {
@@ -124,6 +128,26 @@ const main = async (): Promise<void> => {
       printAccountResult(result, asJson);
       return;
     }
+    case "feedback": {
+      const apiKey = await resolveApiKey(asString(parsed.options["api-key"]));
+      const executionId = asString(parsed.options["execution-id"]);
+      if (!executionId) {
+        throw new CliError("Missing --execution-id for feedback command.");
+      }
+      const rankRaw = asString(parsed.options.rank);
+      if (!rankRaw) {
+        throw new CliError("Missing --rank for feedback command.");
+      }
+      const rank = toIntInRange(rankRaw, "rank", 0, 10);
+      const feedback = asString(parsed.options.feedback);
+      const result = await runFeedbackCommand(http, apiKey, {
+        executionId,
+        rank,
+        ...(feedback ? { feedback } : {}),
+      });
+      printFeedbackResult(result, asJson);
+      return;
+    }
     default:
       throw new CliError("Unknown command.", 1);
   }
@@ -134,12 +158,13 @@ const parseArgs = (argv: string[]): ParsedArgs => {
   if (
     command !== "discover" &&
     command !== "consume" &&
+    command !== "feedback" &&
     command !== "account" &&
     command !== "login"
   ) {
     printUsage();
     throw new CliError(
-      "Invalid command. Use one of: login, discover, consume, account.",
+      "Invalid command. Use one of: login, discover, consume, feedback, account.",
       1,
     );
   }
@@ -190,6 +215,9 @@ const printUsage = (): void => {
     "  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 feedback --execution-id <uuid> --rank <0..10> [--feedback "<text>"] [--api-key <key>] [--env production|staging] [--api-base <url>] [--json]',
+  );
   print(
     "  lidian account [--api-key <key>] [--env production|staging] [--api-base <url>] [--json]",
   );
@@ -214,6 +242,26 @@ const toInt = (value: string | undefined, fallback: number): number => {
   return parsed;
 };
 
+const toIntInRange = (
+  value: string,
+  flagName: string,
+  min: number,
+  max: number,
+): number => {
+  const parsed = Number.parseInt(value, 10);
+  if (
+    Number.isNaN(parsed) ||
+    String(parsed) !== value ||
+    parsed < min ||
+    parsed > max
+  ) {
+    throw new CliError(
+      `Invalid --${flagName} value: ${value}. Expected integer ${min}..${max}.`,
+    );
+  }
+  return parsed;
+};
+
 const toNumber = (
   value: string | undefined,
   flagName: string,
@@ -247,6 +295,16 @@ const asPaymentRail = (value: string): PaymentRail => {
   throw new CliError("Invalid --payment-rail. Use prepaid_credits or x402.");
 };
 
+const resolvePaymentRail = (
+  value: string | undefined,
+  apiKey: string | undefined,
+): PaymentRail => {
+  if (value) {
+    return asPaymentRail(value);
+  }
+  return apiKey && apiKey.trim().length > 0 ? "prepaid_credits" : "x402";
+};
+
 const asAuthType = (
   value: string | undefined,
 ):

package/src/lib/auth.ts

@@ -1,15 +1,8 @@
 import { readConfig } from "@/lib/config";
-import { CliError } from "@/lib/errors";
 
 export const resolveApiKey = async (
   argsApiKey: string | undefined,
-): Promise<string> => {
+): Promise<string | undefined> => {
   const config = await readConfig();
-  const key = argsApiKey ?? process.env.LIDIAN_API_KEY ?? config.apiKey;
-  if (!key) {
-    throw new CliError(
-      "Missing API key. Use `lidian login --key ld_...`, pass --api-key, or set LIDIAN_API_KEY.",
-    );
-  }
-  return key;
+  return argsApiKey ?? process.env.LIDIAN_API_KEY ?? config.apiKey;
 };

package/src/lib/http.ts

@@ -13,25 +13,30 @@ export interface ApiFailure {
   };
 }
 
-type ApiResponse<T> = ApiSuccess<T> | ApiFailure;
+interface PlainApiError {
+  error?: string;
+  message?: string;
+}
+
+type ApiResponse<T> = ApiSuccess<T> | ApiFailure | PlainApiError;
 
 export interface HttpClient {
-  get<T>(path: string, apiKey: string): Promise<T>;
-  post<T, B>(path: string, body: B, apiKey: string): Promise<T>;
+  get<T>(path: string, apiKey?: string): Promise<T>;
+  post<T, B>(path: string, body: B, apiKey?: string): Promise<T>;
 }
 
 export const createHttpClient = (baseUrl: string): HttpClient => {
   const normalizedBaseUrl = baseUrl.replace(/\/$/, "");
 
   return {
-    async get<T>(path: string, apiKey: string): Promise<T> {
+    async get<T>(path: string, apiKey?: string): Promise<T> {
       const response = await fetch(`${normalizedBaseUrl}${path}`, {
         method: "GET",
         headers: authHeaders(apiKey),
       });
       return handleResponse<T>(response);
     },
-    async post<T, B>(path: string, body: B, apiKey: string): Promise<T> {
+    async post<T, B>(path: string, body: B, apiKey?: string): Promise<T> {
       const response = await fetch(`${normalizedBaseUrl}${path}`, {
         method: "POST",
         headers: {
@@ -45,9 +50,14 @@ export const createHttpClient = (baseUrl: string): HttpClient => {
   };
 };
 
-const authHeaders = (apiKey: string): HeadersInit => ({
-  Authorization: `Bearer ${apiKey}`,
-});
+const authHeaders = (apiKey?: string): HeadersInit => {
+  if (!apiKey || apiKey.trim().length === 0) {
+    return {};
+  }
+  return {
+    Authorization: `Bearer ${apiKey}`,
+  };
+};
 
 const handleResponse = async <T>(response: Response): Promise<T> => {
   const json = (await response
@@ -58,6 +68,22 @@ const handleResponse = async <T>(response: Response): Promise<T> => {
     if (json && "success" in json && json.success === false) {
       throw new CliError(`${json.error.code}: ${json.error.message}`, 1);
     }
+    if (
+      json &&
+      typeof json === "object" &&
+      "error" in json &&
+      typeof json.error === "string"
+    ) {
+      throw new CliError(json.error, 1);
+    }
+    if (
+      json &&
+      typeof json === "object" &&
+      "message" in json &&
+      typeof json.message === "string"
+    ) {
+      throw new CliError(json.message, 1);
+    }
     throw new CliError(`Request failed with status ${response.status}`, 1);
   }
 

package/src/lib/output.ts

@@ -4,6 +4,7 @@ import type {
   ConsumeCommandResult,
 } from "@/commands/consume";
 import type { DiscoverApiResponse } from "@/commands/discover";
+import type { FeedbackApiResponse } from "@/commands/feedback";
 import { CliError } from "@/lib/errors";
 
 export const print = (message: string): void => {
@@ -77,7 +78,24 @@ export const printAccountResult = (
   );
 };
 
+export const printFeedbackResult = (
+  result: FeedbackApiResponse,
+  asJson: boolean,
+): void => {
+  if (asJson) {
+    printResult(result, true);
+    return;
+  }
+  const feedback = result.feedback ?? "<none>";
+  print(
+    `Feedback saved for execution=${result.executionId} rank=${result.rank} submittedBy=${result.submittedBy}`,
+  );
+  print(`Updated at: ${result.updatedAt}`);
+  print(`Comment: ${feedback}`);
+};
+
 const printExecutionResult = (result: ConsumeApiResponse): void => {
+  print(`Execution ID: ${result.executionId}`);
   print(
     `Execution succeeded. Spent=${result.credits.spent} cents (${formatUsd(result.credits.spent)}) balance=${result.credits.balance} cents (${formatUsd(result.credits.balance)})`,
   );

package/src/lib/x402.ts

@@ -27,7 +27,7 @@ export interface PaymentVerifyResponse {
 
 export const requestPaymentRequirements = async (
   http: HttpClient,
-  apiKey: string,
+  apiKey: string | undefined,
   endpointId: string,
   network?: string,
 ): Promise<PaymentRequirementsResponse> => {
@@ -43,7 +43,7 @@ export const requestPaymentRequirements = async (
 
 export const verifyPaymentAddress = async (
   http: HttpClient,
-  apiKey: string,
+  apiKey: string | undefined,
   payTo: string,
 ): Promise<PaymentVerifyResponse> => {
   return http.post<PaymentVerifyResponse, { payTo: string }>(