@agenzo/merchant-cli 0.9.6 → 0.10.0

package/dist/index.js

@@ -2873,6 +2873,66 @@ var flightRefundConfirmSchema = flightSchema(
   { status: { type: "int", description: "Refund status after the action." } },
   { command: "agenzo-merchant-cli flight-flink refund-confirm --refund-order-no R1 --confirm 1 --idempotency-key k7", output_summary: "Refund confirmed or cancelled." }
 );
+var DATA_NOUN = "data-aisa";
+function dataSchema(spec) {
+  return { cli: CLI_NAME, noun: DATA_NOUN, ...spec };
+}
+var dataListCategoriesSchema = dataSchema({
+  verb: "list-categories",
+  description: "List the data categories and how many capabilities each one holds. Free: answered from the bundled index, no upstream call.",
+  flags: {
+    // No flags of its own — authentication rides on the global --api-key.
+  },
+  response: {
+    categories: { type: "array", description: "Categories ordered by size; each item is {category, endpoints}." }
+  },
+  example: { command: "agenzo-merchant-cli data-aisa list-categories", output_summary: 'The data categories with a capability count each \u2014 use it to answer "what can you look up".' }
+});
+var dataSearchSchema = dataSchema({
+  verb: "search",
+  description: "Find a data capability by keyword. Free: answered from the bundled index, no upstream call. Returns operationId + method + path + tags + summary + price_usd for each hit.",
+  flags: {
+    keyword: { type: "string", required: false, constraints: "Space- or comma-separated tokens, matched against operationId / path / summary / tags. Omitted returns the first `limit` capabilities as examples.", description: "What to look for, e.g. 'crypto price' or 'reddit'." },
+    limit: { type: "int", required: false, default: 15, constraints: "1..50; defaults to 15.", description: "How many hits to return." }
+  },
+  response: {
+    results: { type: "array", description: "Matching capabilities; each item is {operationId, method, path, tags, summary, price_usd}. Relay operationId VERBATIM into describe / query." }
+  },
+  example: { command: "agenzo-merchant-cli data-aisa search --keyword 'crypto price' --limit 5", output_summary: "Hits with operationId + price_usd; describe the chosen one before running it." }
+});
+var dataDescribeSchema = dataSchema({
+  verb: "describe",
+  description: "Read one capability's parameter spec, usage hint and unit price before calling it. Free: answered from the bundled index, no upstream call.",
+  flags: {
+    "operation-id": { type: "string", required: true, constraints: "An operationId returned by search, verbatim.", description: "Which capability to describe." }
+  },
+  response: {
+    operationId: { type: "string", description: "The capability id \u2014 pass it unchanged to query." },
+    method: { type: "string", description: "Upstream HTTP method of the capability." },
+    path: { type: "string", description: "Upstream path of the capability." },
+    params: { type: "array", description: "Declared parameters; each item is {name, in, required, type, desc}. `desc` may be an empty string." },
+    required: { type: "array", description: "Names of the required parameters." },
+    usage: { type: "string", description: "Human-readable call guidance: which params are required, where each one sits, how to assemble --params." },
+    price_usd: { type: "number|null", description: "Unit price of one query call, in USD." },
+    tags: { type: "array", description: "Categories this capability belongs to." },
+    cost_tier: { type: "string|null", description: "Coarse price band of this capability." }
+  },
+  example: { command: "agenzo-merchant-cli data-aisa describe --operation-id get_coingecko_simple_price", output_summary: "Parameter spec + unit price; build --params from params[].name, then query." }
+});
+var dataQuerySchema = dataSchema({
+  verb: "query",
+  description: "Run one capability and return its data. Charged per call. READ-ONLY: it fetches data and nothing else.",
+  flags: {
+    "operation-id": { type: "string", required: true, constraints: "An operationId returned by search, verbatim.", description: "Which capability to run." },
+    params: { type: "object", required: false, constraints: "A JSON object keyed by the parameter names from describe. Passed through as a whole; unknown keys are dropped.", description: "The capability's parameters." },
+    "idempotency-key": { type: "string", required: false, constraints: "Optional. [A-Za-z0-9_-]{1,128}. When absent the request is still sent (no prompt, nothing generated) and de-duplication falls back to the result cache.", description: "Caller-supplied de-duplication key, forwarded verbatim as the Idempotency-Key header." }
+  },
+  response: {
+    data: { type: "object", description: "The capability response, verbatim." },
+    cost_usd: { type: "number", description: "What this call cost, in USD." }
+  },
+  example: { command: `agenzo-merchant-cli data-aisa query --operation-id get_coingecko_simple_price --params '{"ids":"bitcoin","vs_currencies":"usd"}'`, output_summary: "Returns data (upstream payload, verbatim) plus cost_usd for this call." }
+});
 
 // src/ride-elife/quote.ts
 function need(value, flag) {
@@ -7503,6 +7563,169 @@ function registerFlightSkillCommand(parent) {
   });
 }
 
+// src/data-aisa/_helpers.ts
+function need23(value, flag) {
+  if (value === void 0) {
+    throw new CliError("PARAM_INVALID", `Missing required --${flag}.`);
+  }
+  return value;
+}
+function num11(value, flag) {
+  const n = Number(need23(value, flag));
+  if (!Number.isFinite(n)) {
+    throw new CliError("PARAM_INVALID", `--${flag} must be a number.`);
+  }
+  return n;
+}
+function jsonObject(raw, flag) {
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    throw new CliError("PARAM_INVALID", `--${flag} must be a JSON object.`);
+  }
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    throw new CliError("PARAM_INVALID", `--${flag} must be a JSON object.`);
+  }
+  return parsed;
+}
+function verbatimIdempotencyKey(raw, flag) {
+  if (!IDEMPOTENCY_KEY_PATTERN.test(raw)) {
+    throw new CliError(
+      "PARAM_INVALID",
+      `Invalid --${flag}: "${raw}". ${IDEMPOTENCY_KEY_RULE}`
+    );
+  }
+  return raw;
+}
+function resolveApiKey2(flag) {
+  return PromptEngine.resolveInput(flag, { message: "API Key:", type: "password" });
+}
+async function render4(data, format, text) {
+  const resolved = resolveFormat(format);
+  const result = { data, text: () => text(data) };
+  await renderWithContext(result, { format: resolved }, new ConfigManager());
+}
+function kv(data) {
+  const lines = Object.entries(data).map(([k, v]) => [
+    k,
+    typeof v === "object" && v !== null ? JSON.stringify(v) : String(v ?? "-")
+  ]);
+  return Formatter.keyValue(lines);
+}
+
+// src/data-aisa/list-categories.ts
+function registerDataListCategoriesCommand(parent, deps) {
+  const cmd = parent.command("list-categories").description(
+    "List the data categories and how many capabilities each one holds. Free (answered from the bundled index, no upstream call), read-only."
+  ).option("--api-key <key>", "API Key for authentication (X-Api-Key)");
+  attachSchemaHelp(cmd, dataListCategoriesSchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const apiKey = await resolveApiKey2(opts.apiKey);
+    const spinner = format === "json" ? null : createSpinner("Fetching data categories...");
+    const result = await deps.apiClient.get("/data/categories", {
+      type: "api-key",
+      key: apiKey
+    });
+    spinner?.stop();
+    if (!result.success) throw CliError.fromApi(result, { auth: "api-key" });
+    await render4(result.data, opts.format, (d) => JSON.stringify(d, null, 2));
+  });
+}
+
+// src/data-aisa/search.ts
+function registerDataSearchCommand(parent, deps) {
+  const cmd = parent.command("search").description(
+    "Find a data capability by keyword. Free (answered from the bundled index, no upstream call), read-only. Returns operationId + method + path + tags + summary + price_usd for each hit."
+  ).option("--api-key <key>", "API Key for authentication (X-Api-Key)").option(
+    "--keyword <kw>",
+    "What to look for, e.g. 'crypto price' or 'reddit'. Space- or comma-separated tokens; omitted returns the first --limit capabilities as examples."
+  ).option("--limit <n>", "How many hits to return (1-50)", "15");
+  attachSchemaHelp(cmd, dataSearchSchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const apiKey = await resolveApiKey2(opts.apiKey);
+    const params = {};
+    if (opts.keyword !== void 0) params.keyword = String(opts.keyword);
+    if (opts.limit !== void 0) {
+      params.limit = String(num11(opts.limit, "limit"));
+    }
+    const spinner = format === "json" ? null : createSpinner("Searching data capabilities...");
+    const result = await deps.apiClient.get(
+      "/data/search",
+      { type: "api-key", key: apiKey },
+      params
+    );
+    spinner?.stop();
+    if (!result.success) throw CliError.fromApi(result, { auth: "api-key" });
+    await render4(result.data, opts.format, (d) => JSON.stringify(d, null, 2));
+  });
+}
+
+// src/data-aisa/describe.ts
+function registerDataDescribeCommand(parent, deps) {
+  const cmd = parent.command("describe").description(
+    "Read one capability's parameter spec, usage hint and unit price before calling it. Free (answered from the bundled index, no upstream call), read-only."
+  ).option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--operation-id <id>", "Which capability to describe \u2014 an operationId returned by search, verbatim");
+  attachSchemaHelp(cmd, dataDescribeSchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const operationId = need23(opts.operationId, "operation-id");
+    const apiKey = await resolveApiKey2(opts.apiKey);
+    const spinner = format === "json" ? null : createSpinner("Fetching capability spec...");
+    const result = await deps.apiClient.get(
+      `/data/describe/${encodeURIComponent(operationId)}`,
+      { type: "api-key", key: apiKey }
+    );
+    spinner?.stop();
+    if (!result.success) throw CliError.fromApi(result, { auth: "api-key" });
+    await render4(result.data, opts.format, (d) => kv(d));
+  });
+}
+
+// src/data-aisa/query.ts
+function registerDataQueryCommand(parent, deps) {
+  const cmd = parent.command("query").description(
+    "Run one capability and return its data. Charged per call. READ-ONLY: it fetches data and nothing else."
+  ).option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--operation-id <id>", "Which capability to run \u2014 an operationId returned by search, verbatim").option(
+    "--params <json>",
+    "The capability's parameters as a JSON object keyed by the parameter names from describe. Passed through as a whole; unknown keys are dropped."
+  ).option(
+    "--idempotency-key <key>",
+    "Optional de-duplication key (1-128 chars [A-Za-z0-9_-]) forwarded verbatim as the Idempotency-Key header; never auto-generated, and omitting it is fine"
+  );
+  attachSchemaHelp(cmd, dataQuerySchema);
+  cmd.action(async () => {
+    const opts = cmd.optsWithGlobals();
+    const format = resolveFormat(opts.format);
+    const operationId = need23(opts.operationId, "operation-id");
+    const body = { operation_id: operationId };
+    if (opts.params !== void 0) {
+      body.params = jsonObject(opts.params, "params");
+    }
+    let idempotencyKey;
+    if (opts.idempotencyKey !== void 0) {
+      idempotencyKey = verbatimIdempotencyKey(opts.idempotencyKey, "idempotency-key");
+    }
+    const extraHeaders = idempotencyKey ? { "Idempotency-Key": idempotencyKey } : void 0;
+    const apiKey = await resolveApiKey2(opts.apiKey);
+    const spinner = format === "json" ? null : createSpinner("Fetching data...");
+    const result = await deps.apiClient.post(
+      "/data/query",
+      { type: "api-key", key: apiKey },
+      body,
+      extraHeaders
+    );
+    spinner?.stop();
+    if (!result.success) throw CliError.fromApi(result, { auth: "api-key" });
+    await render4(result.data, opts.format, (d) => kv(d));
+  });
+}
+
 // src/index.ts
 var programRef;
 async function main() {
@@ -7673,6 +7896,13 @@ Key notes:
   registerRefundDetailCommand(flightCmd, deps);
   registerRefundConfirmCommand(flightCmd, deps);
   registerFlightSkillCommand(flightCmd);
+  const dataCmd = program.command("data-aisa").description(
+    "AIsa read-only information lookup (crypto, markets, web & news, SEO, social, prediction markets, research): list-categories / search / describe / query. Pay-per-call READ-ONLY lookups \u2014 it never places an order and never takes money."
+  );
+  registerDataListCategoriesCommand(dataCmd, deps);
+  registerDataSearchCommand(dataCmd, deps);
+  registerDataDescribeCommand(dataCmd, deps);
+  registerDataQueryCommand(dataCmd, deps);
   await program.parseAsync(process.argv);
 }
 function resolveActiveFormat() {