@lidianai/cli 0.1.1 → 0.1.2

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,10 @@ 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`
 
 ## 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));
 };
@@ -293,6 +321,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"])
 };
@@ -364,15 +393,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 +459,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 +481,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;

package/package.json

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

package/src/commands/consume.ts

@@ -16,6 +16,7 @@ export interface ConsumeCommandInput {
 }
 
 export interface ConsumeApiResponse {
+  executionId: string;
   data: unknown;
   credits: {
     spent: number;

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,
+  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"]),
 };
@@ -124,6 +127,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 +157,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 +214,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 +241,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,

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)})`,
   );