@agenzo/merchant-cli 0.1.1

package/dist/index.js

@@ -0,0 +1,897 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command as Command8 } from "commander";
+
+// src/core/errors.ts
+var ErrorCodes = {
+  QUOTE_EXPIRED: "QUOTE_EXPIRED",
+  VEHICLE_UNAVAILABLE: "VEHICLE_UNAVAILABLE",
+  BOOKING_FAILED: "BOOKING_FAILED",
+  CANCELLATION_NOT_ALLOWED: "CANCELLATION_NOT_ALLOWED",
+  SERVICE_NOT_FOUND: "SERVICE_NOT_FOUND",
+  PARAM_IDEMPOTENCY_KEY_REQUIRED: "PARAM_IDEMPOTENCY_KEY_REQUIRED",
+  NETWORK_ERROR: "NETWORK_ERROR",
+  TIMEOUT: "TIMEOUT",
+  CLI_OUTDATED: "CLI_OUTDATED",
+  CONFIG_ERROR: "CONFIG_ERROR",
+  NOT_IMPLEMENTED: "NOT_IMPLEMENTED"
+};
+var CliError = class extends Error {
+  constructor(code, message, recovery, exitCode = 1) {
+    super(message);
+    this.code = code;
+    this.recovery = recovery;
+    this.exitCode = exitCode;
+    this.name = "CliError";
+  }
+  code;
+  recovery;
+  exitCode;
+};
+
+// src/core/config-manager.ts
+import { mkdirSync, readFileSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+var DEFAULT_HOST = "https://agent.everonet.com";
+var CONFIG_DIR = join(homedir(), ".agenzo-merchant-cli");
+var CONFIG_PATH = join(CONFIG_DIR, "config.json");
+function read() {
+  let raw;
+  try {
+    raw = readFileSync(CONFIG_PATH, "utf-8");
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return { host: DEFAULT_HOST };
+    }
+    throw error;
+  }
+  try {
+    const parsed = JSON.parse(raw);
+    return { host: parsed.host ?? DEFAULT_HOST };
+  } catch {
+    throw new CliError(
+      ErrorCodes.CONFIG_ERROR,
+      `Invalid config file: ${CONFIG_PATH}`,
+      "Delete the file to reset to defaults."
+    );
+  }
+}
+function write(config) {
+  mkdirSync(CONFIG_DIR, { recursive: true });
+  writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2), "utf-8");
+}
+function getHost() {
+  return read().host;
+}
+function setHost(host) {
+  write({ host: host.replace(/\/+$/, "") });
+}
+function resetHost() {
+  write({ host: DEFAULT_HOST });
+}
+
+// src/core/formatter.ts
+var ICONS = {
+  success: "\u2713",
+  error: "\u2717",
+  info: "\u2139",
+  warning: "\u26A0"
+};
+var SPINNER_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+function createSpinner(message) {
+  const isTty = Boolean(process.stderr.isTTY);
+  let current = message;
+  if (!isTty) {
+    return {
+      update(msg) {
+        current = msg;
+      },
+      stop() {
+      },
+      succeed(msg) {
+        if (msg) process.stderr.write(`${Formatter.status("success", msg)}
+`);
+      },
+      fail(msg) {
+        process.stderr.write(`${Formatter.status("error", msg ?? current)}
+`);
+      }
+    };
+  }
+  let frame = 0;
+  const render = () => {
+    process.stderr.write(`\r\x1B[K${SPINNER_FRAMES[frame]} ${current}`);
+    frame = (frame + 1) % SPINNER_FRAMES.length;
+  };
+  render();
+  const timer = setInterval(render, 80);
+  const clear = () => {
+    clearInterval(timer);
+    process.stderr.write("\r\x1B[K");
+  };
+  return {
+    update(msg) {
+      current = msg;
+    },
+    stop() {
+      clear();
+    },
+    succeed(msg) {
+      clear();
+      if (msg) process.stderr.write(`${Formatter.status("success", msg)}
+`);
+    },
+    fail(msg) {
+      clear();
+      process.stderr.write(`${Formatter.status("error", msg ?? current)}
+`);
+    }
+  };
+}
+function stringify(value) {
+  if (value === null || value === void 0) return "";
+  if (typeof value === "object") return JSON.stringify(value);
+  return String(value);
+}
+var Formatter = class _Formatter {
+  /** Status-prefixed line, e.g. "✓ done". */
+  static status(type, message) {
+    return `${ICONS[type]} ${message}`;
+  }
+  /** Aligned columnar table for list output. */
+  static table(headers, rows) {
+    const widths = headers.map(
+      (h, i) => Math.max(h.length, ...rows.map((r) => (r[i] ?? "").length))
+    );
+    const line = (cells) => cells.map((c, i) => (c ?? "").padEnd(widths[i])).join("  ");
+    return [
+      line(headers),
+      widths.map((w) => "-".repeat(w)).join("  "),
+      ...rows.map(line)
+    ].join("\n");
+  }
+  /** Key-value detail output with left-aligned keys. */
+  static keyValue(entries) {
+    const width = Math.max(0, ...entries.map(([k]) => k.length));
+    return entries.map(([k, v]) => `${k.padEnd(width)}  ${v}`).join("\n");
+  }
+  /** Best-effort human-readable rendering of arbitrary data. */
+  static auto(data) {
+    if (Array.isArray(data)) {
+      return _Formatter.arrayTable(data);
+    }
+    if (data && typeof data === "object") {
+      const obj = data;
+      const scalarEntries = [];
+      const tableSections = [];
+      for (const [k, v] of Object.entries(obj)) {
+        if (Array.isArray(v) && v.some((i) => i && typeof i === "object")) {
+          tableSections.push(`${k}:
+${_Formatter.arrayTable(v)}`);
+        } else {
+          scalarEntries.push([k, stringify(v)]);
+        }
+      }
+      const parts = [];
+      if (scalarEntries.length) parts.push(_Formatter.keyValue(scalarEntries));
+      parts.push(...tableSections);
+      return parts.join("\n\n");
+    }
+    return stringify(data);
+  }
+  /** Render an array of objects as an aligned table; falls back gracefully. */
+  static arrayTable(items) {
+    if (items.length === 0) return "(empty)";
+    const rows = items.filter(
+      (i) => Boolean(i) && typeof i === "object"
+    );
+    if (rows.length === 0) {
+      return items.map((i) => stringify(i)).join(", ");
+    }
+    const headers = Object.keys(rows[0]);
+    return _Formatter.table(
+      headers,
+      rows.map((r) => headers.map((h) => stringify(r[h])))
+    );
+  }
+};
+
+// src/core/output.ts
+function emit(data, format = "json") {
+  if (format === "table") {
+    console.log(Formatter.auto(data));
+  } else {
+    console.log(JSON.stringify(data, null, 2));
+  }
+}
+function emitSchema(schema, format = "json") {
+  if (format === "table") {
+    console.log(Formatter.keyValue(Object.entries(schema.params)));
+  } else {
+    console.log(JSON.stringify(schema, null, 2));
+  }
+}
+
+// src/core/version.ts
+import { readFileSync as readFileSync2 } from "fs";
+import { dirname, join as join2 } from "path";
+import { fileURLToPath } from "url";
+var UPGRADE_COMMAND = "npm install -g agenzo-merchant-cli@latest";
+var FALLBACK_VERSION = "0.1.0";
+var cached = null;
+function getCurrentVersion() {
+  if (cached !== null) return cached;
+  const here = dirname(fileURLToPath(import.meta.url));
+  const candidates = [
+    join2(here, "..", "package.json"),
+    join2(here, "..", "..", "package.json")
+  ];
+  for (const p of candidates) {
+    try {
+      const pkg = JSON.parse(readFileSync2(p, "utf-8"));
+      if (typeof pkg.version === "string") {
+        cached = pkg.version;
+        return cached;
+      }
+    } catch {
+    }
+  }
+  cached = FALLBACK_VERSION;
+  return cached;
+}
+function compareVersion(a, b) {
+  const parse = (v) => v.trim().replace(/^v/, "").split(/[-+]/)[0].split(".").map((n) => parseInt(n, 10) || 0);
+  const pa = parse(a);
+  const pb = parse(b);
+  for (let i = 0; i < 3; i++) {
+    const diff = (pa[i] ?? 0) - (pb[i] ?? 0);
+    if (diff !== 0) return diff;
+  }
+  return 0;
+}
+function enforceMinVersion(header) {
+  const min = header?.trim();
+  if (!min) return;
+  const current = getCurrentVersion();
+  if (compareVersion(current, min) < 0) {
+    throw new CliError(
+      ErrorCodes.CLI_OUTDATED,
+      `CLI ${current} is below the required minimum ${min}.`,
+      `Upgrade: ${UPGRADE_COMMAND}`,
+      2
+    );
+  }
+}
+
+// src/ride/quote.ts
+import { Command } from "commander";
+
+// src/core/api-client.ts
+var RIDE_PREFIX = "/api/v3/agent-pay";
+var ApiClient = class {
+  host;
+  apiKey;
+  timeout;
+  constructor(options) {
+    this.apiKey = options.apiKey;
+    this.host = (options.host ?? getHost()).replace(/\/+$/, "");
+    this.timeout = options.timeout ?? 3e4;
+  }
+  get(path, options = {}) {
+    return this.request("GET", path, options);
+  }
+  post(path, options = {}) {
+    return this.request("POST", path, options);
+  }
+  async request(method, path, options) {
+    let url = `${this.host}${RIDE_PREFIX}${path}`;
+    if (options.query) {
+      const params = new URLSearchParams();
+      for (const [key, value] of Object.entries(options.query)) {
+        if (value !== void 0) params.set(key, String(value));
+      }
+      const qs = params.toString();
+      if (qs) url += `?${qs}`;
+    }
+    const headers = {
+      "X-Api-Key": this.apiKey,
+      "User-Agent": `agenzo-merchant-cli/${getCurrentVersion()}`
+    };
+    if (options.body) headers["Content-Type"] = "application/json";
+    if (options.idempotencyKey) headers["Idempotency-Key"] = options.idempotencyKey;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeout);
+    let response;
+    try {
+      response = await fetch(url, {
+        method,
+        headers,
+        body: options.body ? JSON.stringify(options.body) : void 0,
+        signal: controller.signal
+      });
+    } catch (error) {
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new CliError(
+          ErrorCodes.TIMEOUT,
+          `Request timed out after ${this.timeout}ms: ${url}`,
+          "Retry, or check your network connection."
+        );
+      }
+      throw new CliError(
+        ErrorCodes.NETWORK_ERROR,
+        `Network request failed: ${url}`,
+        "Check your network connection and the configured API host."
+      );
+    } finally {
+      clearTimeout(timer);
+    }
+    enforceMinVersion(response.headers.get("x-cli-min-version"));
+    const text = await response.text();
+    let envelope;
+    try {
+      envelope = JSON.parse(text);
+    } catch {
+      throw new CliError(
+        ErrorCodes.NETWORK_ERROR,
+        `Unexpected non-JSON response (HTTP ${response.status}) from ${url}`
+      );
+    }
+    if (envelope.code !== void 0 && envelope.code !== "0000") {
+      const code = envelope.code;
+      const message = envelope.message ?? `Request failed (HTTP ${response.status})`;
+      throw new CliError(code, message);
+    }
+    return envelope.data;
+  }
+};
+
+// src/core/prompt-engine.ts
+import { confirm, input, password, select } from "@inquirer/prompts";
+var PromptEngine = class {
+  static async resolveInput(flagValue, options) {
+    if (flagValue !== void 0) return flagValue;
+    if (options.type === "password") {
+      return password({ message: options.message, mask: "*" });
+    }
+    if (options.type === "select" && options.choices) {
+      return select({ message: options.message, choices: options.choices });
+    }
+    return input({ message: options.message, validate: options.validate });
+  }
+  /** Confirmation prompt; auto-approves when `--yes` is set. */
+  static async confirm(message, yes) {
+    if (yes) return true;
+    return confirm({ message });
+  }
+};
+
+// src/utils/cli-help.ts
+function explicitFormat() {
+  const argv = process.argv;
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === "--format=json" || a === "--format" && argv[i + 1] === "json") return "json";
+    if (a === "--format=table" || a === "--format" && argv[i + 1] === "table") return "table";
+  }
+  return void 0;
+}
+function attachSchemaHelp(cmd, schema) {
+  const baseHelp = cmd.helpInformation.bind(cmd);
+  cmd.helpInformation = (ctx) => {
+    const format = explicitFormat();
+    if (!format) return baseHelp(ctx);
+    emitSchema(schema, format);
+    return "";
+  };
+  return cmd;
+}
+
+// src/ride/quote.ts
+var quoteSchema = {
+  description: "Request fare quotes for a ride between two points.",
+  params: {
+    "pickup-lat": "number \u2014 pickup latitude",
+    "pickup-lng": "number \u2014 pickup longitude",
+    "pickup-name": "string \u2014 pickup location name",
+    "dropoff-lat": "number \u2014 dropoff latitude",
+    "dropoff-lng": "number \u2014 dropoff longitude",
+    "dropoff-name": "string \u2014 dropoff location name",
+    "pickup-time": 'number|string \u2014 epoch seconds, or "now"',
+    "passenger-name": "string \u2014 lead passenger full name",
+    "passenger-phone": "string \u2014 passenger phone in E.164 format",
+    "passenger-count": "number \u2014 optional passenger count",
+    "luggage-count": "number \u2014 optional luggage count",
+    "passenger-email": "string \u2014 optional passenger email",
+    "children-count": "number \u2014 optional children count"
+  },
+  response: {
+    vehicle_classes: "VehicleClass[] \u2014 each: vehicle_class, price{amount,currency,quote_id}, passenger_capacity, luggage_capacity (amount is a decimal in the currency standard unit, e.g. 42.50 = $42.50)",
+    meet_and_greet: "object|null \u2014 { available: boolean, price: { amount, currency } } when applicable",
+    is_airport_transfer: "boolean",
+    airport_direction: "string|null \u2014 pickup/dropoff direction for airport transfers"
+  }
+};
+function need(value, flag) {
+  if (value === void 0) throw new CliError("PARAM_REQUIRED", `Missing required --${flag}.`);
+  return value;
+}
+function num(value, flag) {
+  const n = Number(need(value, flag));
+  if (!Number.isFinite(n)) throw new CliError("PARAM_INVALID", `--${flag} must be a number.`);
+  return n;
+}
+function buildQuoteCommand() {
+  const cmd = new Command("quote").description(quoteSchema.description).option("--pickup-lat <lat>", "Pickup latitude").option("--pickup-lng <lng>", "Pickup longitude").option("--pickup-name <name>", "Pickup location name").option("--dropoff-lat <lat>", "Dropoff latitude").option("--dropoff-lng <lng>", "Dropoff longitude").option("--dropoff-name <name>", "Dropoff location name").option("--pickup-time <time>", 'Pickup time: epoch seconds, or "now"').option("--passenger-name <name>", "Lead passenger full name").option("--passenger-phone <phone>", "Passenger phone (E.164)").option("--passenger-count <n>", "Passenger count").option("--luggage-count <n>", "Luggage count").option("--passenger-email <email>", "Passenger email").option("--children-count <n>", "Children count").action(async (_opts, command) => {
+    const o = command.optsWithGlobals();
+    const format = o.format === "table" ? "table" : "json";
+    const apiKey = await PromptEngine.resolveInput(o.apiKey, {
+      message: "API key:",
+      type: "password"
+    });
+    const body = {
+      pickup: {
+        lat: num(o.pickupLat, "pickup-lat"),
+        lng: num(o.pickupLng, "pickup-lng"),
+        name: need(o.pickupName, "pickup-name")
+      },
+      dropoff: {
+        lat: num(o.dropoffLat, "dropoff-lat"),
+        lng: num(o.dropoffLng, "dropoff-lng"),
+        name: need(o.dropoffName, "dropoff-name")
+      },
+      pickup_time: o.pickupTime === "now" ? "now" : num(o.pickupTime, "pickup-time"),
+      passenger_name: need(o.passengerName, "passenger-name"),
+      passenger_phone: need(o.passengerPhone, "passenger-phone")
+    };
+    if (o.passengerCount !== void 0) body.passenger_count = num(o.passengerCount, "passenger-count");
+    if (o.luggageCount !== void 0) body.luggage_count = num(o.luggageCount, "luggage-count");
+    if (o.childrenCount !== void 0) body.children_count = num(o.childrenCount, "children-count");
+    if (o.passengerEmail !== void 0) body.passenger_email = o.passengerEmail;
+    const client = new ApiClient({ apiKey });
+    const spinner = createSpinner("Fetching quotes...");
+    try {
+      const data = await client.post("/ride/quote", { body });
+      spinner.stop();
+      emit(data, format);
+    } catch (err) {
+      spinner.fail("Quote request failed");
+      throw err;
+    }
+  });
+  return attachSchemaHelp(cmd, quoteSchema);
+}
+
+// src/ride/book.ts
+import { Command as Command2 } from "commander";
+
+// src/utils/idempotency.ts
+import { input as input2 } from "@inquirer/prompts";
+var KEY_PATTERN = /^[A-Za-z0-9_-]{1,128}$/;
+var RULE = "Use 1-128 characters from [A-Za-z0-9_-].";
+function normalizeIdempotencyKey(key) {
+  const trimmed = key.trim();
+  if (!KEY_PATTERN.test(trimmed)) {
+    throw new CliError(
+      ErrorCodes.PARAM_IDEMPOTENCY_KEY_REQUIRED,
+      `Invalid idempotency key: "${key}".`,
+      RULE
+    );
+  }
+  return trimmed;
+}
+async function resolveIdempotencyKey(flagValue, options) {
+  if (flagValue !== void 0) return normalizeIdempotencyKey(flagValue);
+  if (options.yes) {
+    throw new CliError(
+      ErrorCodes.PARAM_IDEMPOTENCY_KEY_REQUIRED,
+      "An idempotency key is required for write operations.",
+      "Pass --idempotency-key <key>; the CLI never auto-generates one."
+    );
+  }
+  const entered = await input2({
+    message: "Idempotency key:",
+    validate: (v) => KEY_PATTERN.test(v.trim()) || RULE
+  });
+  return normalizeIdempotencyKey(entered);
+}
+
+// src/ride/book.ts
+var bookSchema = {
+  description: "Book a ride against a previously returned quote.",
+  params: {
+    "quote-id": "string \u2014 required, quote id from `ride quote`",
+    "vehicle-class": "string \u2014 required, chosen vehicle class",
+    "price-amount": "number \u2014 required, fare in decimal currency units (not cents)",
+    "price-currency": "string \u2014 currency code (default USD)",
+    "payment-order-id": "string \u2014 conditional. Required for pay_per_call billing (a PAID order from payment-cli); omit for monthly_settlement (deducted from the settlement account)",
+    "passenger-name": "string \u2014 required, passenger full name",
+    "passenger-phone": "string \u2014 required, passenger phone",
+    "passenger-email": "string \u2014 optional passenger email",
+    "luggage-count": "number \u2014 optional luggage count",
+    "special-requests": "string \u2014 optional free-text requests",
+    "pickup-lat": "number \u2014 required, pickup latitude",
+    "pickup-lng": "number \u2014 required, pickup longitude",
+    "pickup-name": "string \u2014 required, pickup location name",
+    "dropoff-lat": "number \u2014 required, dropoff latitude",
+    "dropoff-lng": "number \u2014 required, dropoff longitude",
+    "dropoff-name": "string \u2014 required, dropoff location name",
+    "pickup-time": 'number|string \u2014 required, epoch seconds or "now" (must match quote)',
+    "meet-and-greet": "boolean \u2014 optional meet & greet service",
+    "meet-and-greet-price": "number \u2014 optional meet & greet surcharge",
+    "welcome-sign": "string \u2014 optional welcome sign text",
+    "arrival-flight-no": "string \u2014 optional arrival flight number",
+    "arrival-airline": "string \u2014 optional arrival airline",
+    "departure-flight-no": "string \u2014 optional departure flight number",
+    "departure-airline": "string \u2014 optional departure airline",
+    "idempotency-key": "string \u2014 required, sent as the Idempotency-Key header (never in body)"
+  },
+  response: {
+    ride_id: "string \u2014 booked ride id, used by `ride get` / `ride cancel`",
+    order_id: "string \u2014 internal ride order id (rio_...)",
+    status: "string \u2014 initial ride status (e.g. INIT / Pending)",
+    price: "{ amount, currency, quote_id } \u2014 confirmed fare",
+    payment_status: "string \u2014 ON_ACCOUNT (monthly_settlement) or PAID (pay_per_call)",
+    billing_entry_id: "string \u2014 settlement ledger entry id (monthly_settlement only)"
+  }
+};
+function buildBookCommand() {
+  return new Command2("book").description(bookSchema.description).helpOption(false).option("--help", "Show help (add --format json for the machine-readable schema)").option("--format <format>", "Output format: json|table").option("--api-key <key>", "API key for runtime requests").option("--yes", "Skip confirmation prompts").option("--quote-id <id>", "Quote id from `ride quote`").option("--vehicle-class <class>", "Chosen vehicle class").option("--price-amount <amount>", "Fare in decimal currency units (not cents)").option("--price-currency <currency>", "Currency code (default USD)").option("--payment-order-id <id>", "Paid payment order id (pay_per_call mode only)").option("--passenger-name <name>", "Passenger full name").option("--passenger-phone <phone>", "Passenger phone").option("--passenger-email <email>", "Passenger email").option("--luggage-count <n>", "Luggage count").option("--special-requests <text>", "Free-text special requests").option("--pickup-lat <lat>", "Pickup latitude").option("--pickup-lng <lng>", "Pickup longitude").option("--pickup-name <name>", "Pickup location name").option("--dropoff-lat <lat>", "Dropoff latitude").option("--dropoff-lng <lng>", "Dropoff longitude").option("--dropoff-name <name>", "Dropoff location name").option("--pickup-time <time>", 'Pickup time: epoch seconds, or "now"').option("--meet-and-greet", "Enable meet & greet service").option("--meet-and-greet-price <amount>", "Meet & greet surcharge").option("--welcome-sign <text>", "Welcome sign text").option("--arrival-flight-no <no>", "Arrival flight number").option("--arrival-airline <airline>", "Arrival airline").option("--departure-flight-no <no>", "Departure flight number").option("--departure-airline <airline>", "Departure airline").option("--idempotency-key <key>", "Caller-supplied idempotency key").action(async (_options, command) => {
+    const merged = command.optsWithGlobals();
+    const format = merged.format === "table" ? "table" : "json";
+    if (merged.help) {
+      const wantsSchema = process.argv.some((a) => a === "--format" || a.startsWith("--format="));
+      if (wantsSchema) emitSchema(bookSchema, format);
+      else command.outputHelp();
+      return;
+    }
+    const yes = merged.yes === true;
+    const apiKey = await PromptEngine.resolveInput(merged.apiKey, {
+      message: "API key:",
+      type: "password"
+    });
+    const quoteId = await PromptEngine.resolveInput(merged.quoteId, { message: "Quote id:" });
+    const vehicleClass = await PromptEngine.resolveInput(merged.vehicleClass, {
+      message: "Vehicle class:"
+    });
+    const priceAmount = await PromptEngine.resolveInput(merged.priceAmount, {
+      message: "Price amount (decimal):"
+    });
+    const passengerName = await PromptEngine.resolveInput(merged.passengerName, {
+      message: "Passenger name:"
+    });
+    const passengerPhone = await PromptEngine.resolveInput(merged.passengerPhone, {
+      message: "Passenger phone:"
+    });
+    const body = {
+      quote_id: quoteId,
+      vehicle_class: vehicleClass,
+      price_amount: Number(priceAmount),
+      price_currency: merged.priceCurrency ?? "USD",
+      passenger_name: passengerName,
+      passenger_phone: passengerPhone
+    };
+    if (merged.paymentOrderId) body.payment_order_id = merged.paymentOrderId;
+    if (merged.passengerEmail) body.passenger_email = merged.passengerEmail;
+    if (merged.luggageCount !== void 0) body.luggage_count = Number(merged.luggageCount);
+    if (merged.specialRequests) body.special_requests = merged.specialRequests;
+    if (merged.pickupLat || merged.pickupLng || merged.pickupName) {
+      body.pickup = { lat: Number(merged.pickupLat), lng: Number(merged.pickupLng), name: merged.pickupName };
+    }
+    if (merged.dropoffLat || merged.dropoffLng || merged.dropoffName) {
+      body.dropoff = { lat: Number(merged.dropoffLat), lng: Number(merged.dropoffLng), name: merged.dropoffName };
+    }
+    if (merged.pickupTime) body.pickup_time = merged.pickupTime;
+    if (merged.meetAndGreet) body.meet_and_greet = true;
+    if (merged.meetAndGreetPrice !== void 0) body.meet_and_greet_price = Number(merged.meetAndGreetPrice);
+    if (merged.welcomeSign) body.welcome_sign = merged.welcomeSign;
+    if (merged.arrivalFlightNo || merged.arrivalAirline) {
+      body.arrival_flight = { flight_no: merged.arrivalFlightNo, airline: merged.arrivalAirline };
+    }
+    if (merged.departureFlightNo || merged.departureAirline) {
+      body.departure_flight = { flight_no: merged.departureFlightNo, airline: merged.departureAirline };
+    }
+    if (!await PromptEngine.confirm(`Book ride with quote ${quoteId}?`, yes)) {
+      console.log(Formatter.status("info", "Booking aborted."));
+      return;
+    }
+    const idempotencyKey = await resolveIdempotencyKey(merged.idempotencyKey, { yes });
+    const client = new ApiClient({ apiKey });
+    const spinner = createSpinner("Booking ride...");
+    try {
+      const data = await client.post("/ride/book", { body, idempotencyKey });
+      spinner.stop();
+      emit(data, format);
+    } catch (err) {
+      spinner.fail("Booking failed");
+      throw err;
+    }
+  });
+}
+
+// src/ride/get.ts
+import { Command as Command3 } from "commander";
+var rideGetSchema = {
+  description: "Retrieve a single ride order status by id (repeatable for polling).",
+  params: {
+    "order-id": "string \u2014 ride order id (the ride_id returned by `ride book`)"
+  },
+  response: {
+    status: "OrderStatus \u2014 case-sensitive; terminal states: At destination | Cancelled | Rejected | Customer no show | Driver no show",
+    from: "GeoPoint \u2014 pickup",
+    to: "GeoPoint \u2014 dropoff",
+    pickup_time: "number|string",
+    vehicle_class: "string",
+    price: "Price{amount,currency} \u2014 amount is a decimal in the currency standard unit",
+    passenger: "Passenger",
+    driver: "Driver \u2014 present after assignment",
+    vehicle: "Vehicle \u2014 present after assignment"
+  }
+};
+function buildRideGetCommand() {
+  const cmd = new Command3("get").description(rideGetSchema.description).option("--order-id <id>", "Ride order id (the ride_id returned by `ride book`)").action(async (_opts, command) => {
+    const o = command.optsWithGlobals();
+    const format = o.format === "table" ? "table" : "json";
+    const apiKey = await PromptEngine.resolveInput(o.apiKey, {
+      message: "API key:",
+      type: "password"
+    });
+    const orderId = await PromptEngine.resolveInput(o.orderId, { message: "Order id:" });
+    const client = new ApiClient({ apiKey });
+    const spinner = createSpinner("Fetching ride status...");
+    try {
+      const data = await client.get(
+        `/ride/${encodeURIComponent(orderId)}/status`
+      );
+      spinner.stop();
+      emit(data, format);
+    } catch (err) {
+      spinner.fail("Failed to fetch ride status");
+      throw err;
+    }
+  });
+  return attachSchemaHelp(cmd, rideGetSchema);
+}
+
+// src/ride/cancel.ts
+import { Command as Command4 } from "commander";
+var cancelSchema = {
+  description: "Cancel a ride order; may incur a cancellation fee.",
+  params: {
+    "order-id": "string \u2014 required, order id (a.k.a. ride id) to cancel",
+    "idempotency-key": "string \u2014 required, sent as the Idempotency-Key header (never in body)"
+  },
+  response: {
+    ride_id: "string \u2014 cancelled ride id",
+    ride_stat: "string \u2014 resulting ride status",
+    cancellation: "{ cancellation_fee, reversal_amount, currency }"
+  }
+};
+function buildCancelCommand() {
+  return new Command4("cancel").description(cancelSchema.description).helpOption(false).option("--help", "Show help (add --format json for the machine-readable schema)").option("--format <format>", "Output format: json|table").option("--api-key <key>", "API key for runtime requests").option("--yes", "Skip confirmation prompts").option("--order-id <id>", "Order id (a.k.a. ride id) to cancel").option("--idempotency-key <key>", "Caller-supplied idempotency key").action(async (_options, command) => {
+    const merged = command.optsWithGlobals();
+    const format = merged.format === "table" ? "table" : "json";
+    if (merged.help) {
+      const wantsSchema = process.argv.some((a) => a === "--format" || a.startsWith("--format="));
+      if (wantsSchema) emitSchema(cancelSchema, format);
+      else command.outputHelp();
+      return;
+    }
+    const yes = merged.yes === true;
+    const apiKey = await PromptEngine.resolveInput(merged.apiKey, {
+      message: "API key:",
+      type: "password"
+    });
+    const orderId = await PromptEngine.resolveInput(merged.orderId, { message: "Order id:" });
+    if (!await PromptEngine.confirm(`Cancel order ${orderId}? This may incur a fee.`, yes)) {
+      console.log(Formatter.status("info", "Cancellation aborted."));
+      return;
+    }
+    const idempotencyKey = await resolveIdempotencyKey(merged.idempotencyKey, { yes });
+    const client = new ApiClient({ apiKey });
+    const spinner = createSpinner("Cancelling ride...");
+    try {
+      const data = await client.post(`/ride/${encodeURIComponent(orderId)}/cancel`, { idempotencyKey });
+      spinner.stop();
+      emit(data, format);
+    } catch (err) {
+      spinner.fail("Cancellation failed");
+      throw err;
+    }
+  });
+}
+
+// src/ride/list-orders.ts
+import { Command as Command5 } from "commander";
+var listOrdersSchema = {
+  description: "List ride orders with pagination and optional filters.",
+  params: {
+    page: "number \u2014 page number (default 1)",
+    "page-size": "number \u2014 page size (default 20)",
+    status: "OrderStatus \u2014 optional status filter",
+    "order-type": "string \u2014 optional order type filter"
+  },
+  response: {
+    orders: "Order[]",
+    total: "number",
+    page: "number",
+    page_size: "number"
+  }
+};
+function buildListOrdersCommand() {
+  const cmd = new Command5("list-orders").description(listOrdersSchema.description).option("--page <page>", "Page number", "1").option("--page-size <size>", "Page size", "20").option("--status <status>", "Filter by order status").option("--order-type <type>", "Filter by order type").action(async (_opts, command) => {
+    const o = command.optsWithGlobals();
+    const format = o.format === "table" ? "table" : "json";
+    const apiKey = await PromptEngine.resolveInput(o.apiKey, {
+      message: "API key:",
+      type: "password"
+    });
+    const client = new ApiClient({ apiKey });
+    const spinner = createSpinner("Fetching orders...");
+    try {
+      const data = await client.get("/ride/orders", {
+        query: {
+          page: Number(o.page),
+          page_size: Number(o.pageSize),
+          status: o.status,
+          order_type: o.orderType
+        }
+      });
+      spinner.stop();
+      emit(data, format);
+    } catch (err) {
+      spinner.fail("Failed to fetch orders");
+      throw err;
+    }
+  });
+  return attachSchemaHelp(cmd, listOrdersSchema);
+}
+
+// src/services/list.ts
+import { Command as Command6 } from "commander";
+
+// src/services/registry.ts
+var SERVICE_REGISTRY = [
+  {
+    service_id: "ride",
+    name: "Ride",
+    description: "On-demand ride ordering: quote a fare, book it, poll status, and cancel.",
+    version: "1.0.0",
+    provider: "elife",
+    cli_noun: "ride",
+    verbs: ["quote", "book", "get", "cancel", "list-orders"],
+    verb_descriptions: {
+      quote: "Request fare quotes for a ride between two points.",
+      book: "Book a ride using a quote_id returned by quote.",
+      get: "Retrieve a ride order by id (poll for status changes).",
+      cancel: "Cancel a ride order by id.",
+      "list-orders": "List previously placed ride orders."
+    },
+    workflow: ["quote", "book", "get (poll for status)", "cancel (optional)"],
+    since: "2026-06-01",
+    discovery: { help_command: "agenzo-merchant-cli ride --help" },
+    billing: { mode: "pay_per_call" }
+  }
+];
+function findService(serviceId) {
+  return SERVICE_REGISTRY.find((s) => s.service_id === serviceId);
+}
+
+// src/services/list.ts
+var servicesListSchema = {
+  description: "List available merchant services from the registry.",
+  params: {},
+  response: {
+    services: "Service[] \u2014 each with service_id, name, provider, cli_noun, version, verbs, billing_mode"
+  }
+};
+function resolveFormat(cmd) {
+  return cmd.optsWithGlobals().format === "table" ? "table" : "json";
+}
+function buildServicesListCommand() {
+  return new Command6("list").description(servicesListSchema.description).helpOption(false).option("-h, --help", "Show help; with --format json prints the schema").action((opts, cmd) => {
+    const format = resolveFormat(cmd);
+    if (opts.help) {
+      emitSchema(servicesListSchema, format);
+      return;
+    }
+    const services = SERVICE_REGISTRY.map((s) => ({
+      service_id: s.service_id,
+      name: s.name,
+      provider: s.provider,
+      cli_noun: s.cli_noun,
+      version: s.version,
+      verbs: s.verbs.join(", "),
+      billing_mode: s.billing.mode
+    }));
+    emit(services, format);
+  });
+}
+
+// src/services/get.ts
+import { Command as Command7 } from "commander";
+var serviceGetSchema = {
+  description: "Retrieve a single merchant service by id, with verb and workflow detail.",
+  params: {
+    "service-id": "string \u2014 service id to retrieve"
+  },
+  response: {
+    service_id: "string",
+    name: "string",
+    description: "string",
+    version: "string",
+    provider: "string",
+    cli_noun: "string",
+    verbs: "string[]",
+    verb_descriptions: "Record<verb, description>",
+    workflow: "string[] \u2014 ordered steps quote\u2192book\u2192get(poll)\u2192[cancel]",
+    since: "string \u2014 ISO date",
+    discovery: "{ help_command: string }",
+    billing: '{ mode: "pay_per_call" }'
+  }
+};
+function resolveFormat2(cmd) {
+  return cmd.optsWithGlobals().format === "table" ? "table" : "json";
+}
+function buildServiceGetCommand() {
+  return new Command7("get").description(serviceGetSchema.description).argument("[service-id]", "Service id to retrieve").helpOption(false).option("-h, --help", "Show help; with --format json prints the schema").action((serviceId, opts, cmd) => {
+    const format = resolveFormat2(cmd);
+    if (opts.help) {
+      emitSchema(serviceGetSchema, format);
+      return;
+    }
+    const service = serviceId ? findService(serviceId) : void 0;
+    if (!service) {
+      throw new CliError(
+        ErrorCodes.SERVICE_NOT_FOUND,
+        `Service '${serviceId ?? ""}' not found in the registry (SERVICE_NOT_FOUND).`,
+        'Run "services list" to see available services.'
+      );
+    }
+    emit(service, format);
+  });
+}
+
+// src/index.ts
+function resolveFormat3(cmd) {
+  return cmd.optsWithGlobals().format === "table" ? "table" : "json";
+}
+async function main() {
+  const program = new Command8();
+  program.name("agenzo-merchant-cli").description("CLI for ordering rides and querying merchant services").version(getCurrentVersion()).option("--format <format>", "Output format: json|table", "json").option("--yes", "Skip confirmation prompts (for automation/AI Agents)", false).option("--api-key <key>", "API key for runtime requests");
+  const config = program.command("config").description("Local API host configuration");
+  config.command("set-host <url>").description("Set the API host").action((url) => {
+    setHost(url);
+    console.log(Formatter.status("success", `API host set to ${getHost()}`));
+  });
+  config.command("reset-host").description("Reset the API host to the default").action(() => {
+    resetHost();
+    console.log(Formatter.status("success", `API host reset to ${getHost()}`));
+  });
+  config.command("show").description("Show the current configuration").action((_options, cmd) => {
+    emit({ host: getHost() }, resolveFormat3(cmd));
+  });
+  const ride = program.command("ride").description("Ride ordering: quote, book, get, cancel, list-orders");
+  ride.addCommand(buildQuoteCommand());
+  ride.addCommand(buildBookCommand());
+  ride.addCommand(buildRideGetCommand());
+  ride.addCommand(buildCancelCommand());
+  ride.addCommand(buildListOrdersCommand());
+  const services = program.command("services").description("Service registry: list, get");
+  services.addCommand(buildServicesListCommand());
+  services.addCommand(buildServiceGetCommand());
+  await program.parseAsync(process.argv);
+}
+main().catch((error) => {
+  if (error instanceof CliError) {
+    console.error(Formatter.status("error", error.message));
+    if (error.recovery) console.error(Formatter.status("info", error.recovery));
+    process.exit(error.exitCode);
+  }
+  console.error(
+    Formatter.status("error", error instanceof Error ? error.message : "An unexpected error occurred")
+  );
+  process.exit(1);
+});
+//# sourceMappingURL=index.js.map