@hyperline/cli 0.1.0-build.1.ed7561b → 0.1.0-build.1.ed8c065

package/dist/bin/hyperline-main.js

@@ -39223,6 +39223,1023 @@ Examples:
   });
 }
 
+// build/commands/generated/agents.js
+function registerAgentsCommands(parent) {
+  const resource = parent.command("agents").description("Manage agents");
+  resource.command("list-agent-plans").description(`List AI agent billing plans: workspace-level offers carrying a billing mode (wallet/credits/windows), rate card, allowance windows, markups and per-seat credit grants. Filter by mode; paginated with take/skip.`).option("--mode <value>", `mode`).option("--take <number>", `take`).option("--skip <number>", `skip`).addHelpText("after", `
+Examples:
+    hyperline agents list-agent-plans
+    hyperline agents list-agent-plans --mode <mode> --take <take>`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.mode !== void 0)
+      args.mode = opts.mode;
+    if (opts.take !== void 0)
+      args.take = Number(opts.take);
+    if (opts.skip !== void 0)
+      args.skip = Number(opts.skip);
+    await ctx.execute({
+      method: "GET",
+      path: "/v1/agents/plans",
+      args,
+      queryParamKeys: ["mode", "take", "skip"]
+    });
+  });
+  resource.command("create-agent-plan").description(`Create an AI agent billing plan: name, billing mode (wallet/credits/windows), rate card reference, allowance windows, markups, per-seat credit grants and overage stance. Past-limit usage is priced EITHER by overage_markup_percent over the base rates OR by overage_rate_card_id, a currency rate card whose own rates are the overage price \u2014 never both. Metered overage mints the plan's invoice container.`).requiredOption("--name <value>", `name`).option("--rate-card-id <value>", `rate_card_id`).option("--overage-mode <value>", `overage_mode`).option("--markup-percent <value>", `markup_percent`).option("--overage-markup-percent <value>", `overage_markup_percent`).option("--overage-rate-card-id <value>", `overage_rate_card_id`).option("--windows <json>", `windows`).option("--per-seat-credits <value>", `per_seat_credits`).option("--grant-rollover-enabled", `grant_rollover_enabled`).option("--settlement-interval-minutes <number>", `settlement_interval_minutes`).option("--settlement-schedule <value>", `settlement_schedule`).requiredOption("--mode <value>", `mode`).addHelpText("after", `
+Examples:
+    hyperline agents create-agent-plan --name <name> --mode <mode>
+    hyperline agents create-agent-plan --name <name> --mode <mode> --rate-card-id <rate_card_id> --overage-mode <overage_mode>
+    hyperline agents create-agent-plan --name <name> --mode <mode> --output json`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.name !== void 0)
+      args.name = opts.name;
+    if (opts.rateCardId !== void 0)
+      args.rate_card_id = opts.rateCardId;
+    if (opts.overageMode !== void 0)
+      args.overage_mode = opts.overageMode;
+    if (opts.markupPercent !== void 0)
+      args.markup_percent = opts.markupPercent;
+    if (opts.overageMarkupPercent !== void 0)
+      args.overage_markup_percent = opts.overageMarkupPercent;
+    if (opts.overageRateCardId !== void 0)
+      args.overage_rate_card_id = opts.overageRateCardId;
+    if (opts.perSeatCredits !== void 0)
+      args.per_seat_credits = opts.perSeatCredits;
+    if (opts.settlementSchedule !== void 0)
+      args.settlement_schedule = opts.settlementSchedule;
+    if (opts.mode !== void 0)
+      args.mode = opts.mode;
+    if (opts.settlementIntervalMinutes !== void 0)
+      args.settlement_interval_minutes = Number(opts.settlementIntervalMinutes);
+    if (opts.grantRolloverEnabled !== void 0)
+      args.grant_rollover_enabled = true;
+    if (opts.windows !== void 0)
+      args.windows = JSON.parse(opts.windows);
+    await ctx.execute({
+      method: "POST",
+      path: "/v1/agents/plans",
+      args,
+      queryParamKeys: []
+    });
+  });
+  resource.command("get-agent-plan").description(`Get one AI agent billing plan by id, with its embedded rate card, window definitions, markups, per-seat grants and minted catalog object ids.`).requiredOption("--plan-id <value>", `plan_id parameter`).addHelpText("after", `
+Examples:
+    hyperline agents get-agent-plan --plan-id <plan_id>`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.planId !== void 0)
+      args.plan_id = opts.planId;
+    await ctx.execute({
+      method: "GET",
+      path: "/v1/agents/plans/{plan_id}",
+      args,
+      queryParamKeys: []
+    });
+  });
+  resource.command("replace-agent-plan").description(`Replace an AI agent billing plan (whole-row semantics). Changes take effect on the next call for every customer on the plan; mode is immutable. Overage is priced by overage_markup_percent or by overage_rate_card_id, never both.`).requiredOption("--plan-id <value>", `plan_id parameter`).requiredOption("--name <value>", `name`).option("--rate-card-id <value>", `rate_card_id`).option("--overage-mode <value>", `overage_mode`).option("--markup-percent <value>", `markup_percent`).option("--overage-markup-percent <value>", `overage_markup_percent`).option("--overage-rate-card-id <value>", `overage_rate_card_id`).option("--windows <json>", `windows`).option("--per-seat-credits <value>", `per_seat_credits`).option("--grant-rollover-enabled", `grant_rollover_enabled`).option("--settlement-interval-minutes <number>", `settlement_interval_minutes`).option("--settlement-schedule <value>", `settlement_schedule`).addHelpText("after", `
+Examples:
+    hyperline agents replace-agent-plan --plan-id <plan_id> --name <name>
+    hyperline agents replace-agent-plan --plan-id <plan_id> --name <name> --rate-card-id <rate_card_id> --overage-mode <overage_mode>
+    hyperline agents replace-agent-plan --plan-id <plan_id> --name <name> --output json`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.planId !== void 0)
+      args.plan_id = opts.planId;
+    if (opts.name !== void 0)
+      args.name = opts.name;
+    if (opts.rateCardId !== void 0)
+      args.rate_card_id = opts.rateCardId;
+    if (opts.overageMode !== void 0)
+      args.overage_mode = opts.overageMode;
+    if (opts.markupPercent !== void 0)
+      args.markup_percent = opts.markupPercent;
+    if (opts.overageMarkupPercent !== void 0)
+      args.overage_markup_percent = opts.overageMarkupPercent;
+    if (opts.overageRateCardId !== void 0)
+      args.overage_rate_card_id = opts.overageRateCardId;
+    if (opts.perSeatCredits !== void 0)
+      args.per_seat_credits = opts.perSeatCredits;
+    if (opts.settlementSchedule !== void 0)
+      args.settlement_schedule = opts.settlementSchedule;
+    if (opts.settlementIntervalMinutes !== void 0)
+      args.settlement_interval_minutes = Number(opts.settlementIntervalMinutes);
+    if (opts.grantRolloverEnabled !== void 0)
+      args.grant_rollover_enabled = true;
+    if (opts.windows !== void 0)
+      args.windows = JSON.parse(opts.windows);
+    await ctx.execute({
+      method: "PUT",
+      path: "/v1/agents/plans/{plan_id}",
+      args,
+      queryParamKeys: []
+    });
+  });
+  resource.command("delete-agent-plan").description(`Delete an AI agent billing plan. Refused (409, plan_in_use) while any customer is still attached to it.`).requiredOption("--plan-id <value>", `plan_id parameter`).option("--yes", "Skip confirmation").addHelpText("after", `
+Examples:
+    hyperline agents delete-agent-plan --plan-id <plan_id>
+    hyperline agents delete-agent-plan --plan-id <plan_id> --output json`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.planId !== void 0)
+      args.plan_id = opts.planId;
+    if (!opts.yes) {
+      const confirmed = await confirmPrompt("Are you sure? Pass --yes to skip. [y/N] ");
+      if (!confirmed) {
+        process.stdout.write("Aborted.\n");
+        return;
+      }
+    }
+    await ctx.execute({
+      method: "DELETE",
+      path: "/v1/agents/plans/{plan_id}",
+      args,
+      queryParamKeys: []
+    });
+  });
+  resource.command("get-agent-default-plan").description(`Get the workspace's default AI agent billing plan marker (plan id and auto_apply flag). 404 when none is set.`).addHelpText("after", `
+Examples:
+    hyperline agents get-agent-default-plan`).action(async (_opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    await ctx.execute({
+      method: "GET",
+      path: "/v1/agents/default-plan",
+      args,
+      queryParamKeys: []
+    });
+  });
+  resource.command("set-agent-default-plan").description(`Mark one plan as the workspace's default AI agent billing plan (body: plan_id, optional auto_apply). Replaces the previous marker; 404 when the plan is not this workspace's.`).requiredOption("--plan-id <value>", `plan_id`).option("--auto-apply", `auto_apply`).addHelpText("after", `
+Examples:
+    hyperline agents set-agent-default-plan --plan-id <plan_id>
+    hyperline agents set-agent-default-plan --plan-id <plan_id> --auto-apply
+    hyperline agents set-agent-default-plan --plan-id <plan_id> --output json`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.planId !== void 0)
+      args.plan_id = opts.planId;
+    if (opts.autoApply !== void 0)
+      args.auto_apply = true;
+    await ctx.execute({
+      method: "PUT",
+      path: "/v1/agents/default-plan",
+      args,
+      queryParamKeys: []
+    });
+  });
+  resource.command("clear-agent-default-plan").description(`Clear the workspace's default AI agent billing plan marker. The plan itself is untouched. 404 when none is set.`).option("--yes", "Skip confirmation").addHelpText("after", `
+Examples:
+    hyperline agents clear-agent-default-plan
+    hyperline agents clear-agent-default-plan --output json`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (!opts.yes) {
+      const confirmed = await confirmPrompt("Are you sure? Pass --yes to skip. [y/N] ");
+      if (!confirmed) {
+        process.stdout.write("Aborted.\n");
+        return;
+      }
+    }
+    await ctx.execute({
+      method: "DELETE",
+      path: "/v1/agents/default-plan",
+      args,
+      queryParamKeys: []
+    });
+  });
+  resource.command("list-agent-rate-cards").description(`List AI rate cards: named pricing row sets in credits, window units or currency. Shows what plans/policies/products depend on each. Filter by denomination, currency or name search; paginated with take/skip.`).option("--denomination <value>", `denomination`).option("--currency <value>", `currency`).option("--search <value>", `search`).option("--take <number>", `take`).option("--skip <number>", `skip`).addHelpText("after", `
+Examples:
+    hyperline agents list-agent-rate-cards
+    hyperline agents list-agent-rate-cards --denomination <denomination> --currency <currency>`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.denomination !== void 0)
+      args.denomination = opts.denomination;
+    if (opts.currency !== void 0)
+      args.currency = opts.currency;
+    if (opts.search !== void 0)
+      args.search = opts.search;
+    if (opts.take !== void 0)
+      args.take = Number(opts.take);
+    if (opts.skip !== void 0)
+      args.skip = Number(opts.skip);
+    await ctx.execute({
+      method: "GET",
+      path: "/v1/agents/rate-cards",
+      args,
+      queryParamKeys: ["denomination", "currency", "search", "take", "skip"]
+    });
+  });
+  resource.command("create-agent-rate-card").description(`Create an AI rate card with llm rows (per-1M input/output token rates) and item rows (per-unit rates), a denomination (credits/units/currency) and an optional USD fallback conversion.`).requiredOption("--name <value>", `name`).option("--description <value>", `description`).option("--fallback-per-usd <value>", `fallback_per_usd`).requiredOption("--rows <json>", `rows`).requiredOption("--denomination <value>", `denomination`).option("--currency <value>", `currency`).addHelpText("after", `
+Examples:
+    hyperline agents create-agent-rate-card --name <name> --rows <rows> --denomination <denomination>
+    hyperline agents create-agent-rate-card --name <name> --rows <rows> --denomination <denomination> --description <description> --fallback-per-usd <fallback_per_usd>
+    hyperline agents create-agent-rate-card --name <name> --rows <rows> --denomination <denomination> --output json`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.name !== void 0)
+      args.name = opts.name;
+    if (opts.description !== void 0)
+      args.description = opts.description;
+    if (opts.fallbackPerUsd !== void 0)
+      args.fallback_per_usd = opts.fallbackPerUsd;
+    if (opts.denomination !== void 0)
+      args.denomination = opts.denomination;
+    if (opts.currency !== void 0)
+      args.currency = opts.currency;
+    if (opts.rows !== void 0)
+      args.rows = JSON.parse(opts.rows);
+    await ctx.execute({
+      method: "POST",
+      path: "/v1/agents/rate-cards",
+      args,
+      queryParamKeys: []
+    });
+  });
+  resource.command("get-agent-rate-card").description(`Get one AI rate card by id with all its pricing rows and usage counts (plans, policies, credit product).`).requiredOption("--rate-card-id <value>", `rate_card_id parameter`).addHelpText("after", `
+Examples:
+    hyperline agents get-agent-rate-card --rate-card-id <rate_card_id>`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.rateCardId !== void 0)
+      args.rate_card_id = opts.rateCardId;
+    await ctx.execute({
+      method: "GET",
+      path: "/v1/agents/rate-cards/{rate_card_id}",
+      args,
+      queryParamKeys: []
+    });
+  });
+  resource.command("replace-agent-rate-card").description(`Replace an AI rate card's rows, name, description and USD fallback (whole-card semantics). Denomination and currency are immutable.`).requiredOption("--rate-card-id <value>", `rate_card_id parameter`).requiredOption("--name <value>", `name`).option("--description <value>", `description`).option("--fallback-per-usd <value>", `fallback_per_usd`).requiredOption("--rows <json>", `rows`).addHelpText("after", `
+Examples:
+    hyperline agents replace-agent-rate-card --rate-card-id <rate_card_id> --name <name> --rows <rows>
+    hyperline agents replace-agent-rate-card --rate-card-id <rate_card_id> --name <name> --rows <rows> --description <description> --fallback-per-usd <fallback_per_usd>
+    hyperline agents replace-agent-rate-card --rate-card-id <rate_card_id> --name <name> --rows <rows> --output json`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.rateCardId !== void 0)
+      args.rate_card_id = opts.rateCardId;
+    if (opts.name !== void 0)
+      args.name = opts.name;
+    if (opts.description !== void 0)
+      args.description = opts.description;
+    if (opts.fallbackPerUsd !== void 0)
+      args.fallback_per_usd = opts.fallbackPerUsd;
+    if (opts.rows !== void 0)
+      args.rows = JSON.parse(opts.rows);
+    await ctx.execute({
+      method: "PUT",
+      path: "/v1/agents/rate-cards/{rate_card_id}",
+      args,
+      queryParamKeys: []
+    });
+  });
+  resource.command("delete-agent-rate-card").description(`Delete an AI rate card. Refused (409, rate_card_in_use) while any plan, credit product or customer policy still uses it.`).requiredOption("--rate-card-id <value>", `rate_card_id parameter`).option("--yes", "Skip confirmation").addHelpText("after", `
+Examples:
+    hyperline agents delete-agent-rate-card --rate-card-id <rate_card_id>
+    hyperline agents delete-agent-rate-card --rate-card-id <rate_card_id> --output json`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.rateCardId !== void 0)
+      args.rate_card_id = opts.rateCardId;
+    if (!opts.yes) {
+      const confirmed = await confirmPrompt("Are you sure? Pass --yes to skip. [y/N] ");
+      if (!confirmed) {
+        process.stdout.write("Aborted.\n");
+        return;
+      }
+    }
+    await ctx.execute({
+      method: "DELETE",
+      path: "/v1/agents/rate-cards/{rate_card_id}",
+      args,
+      queryParamKeys: []
+    });
+  });
+  resource.command("list-agent-credit-products").description(`List the credit products AI agent usage can draw down, with their purchasable packs and default rate cards. Customer pot balances live on the customer credits endpoints.`).addHelpText("after", `
+Examples:
+    hyperline agents list-agent-credit-products`).action(async (_opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    await ctx.execute({
+      method: "GET",
+      path: "/v1/agents/credit-products",
+      args,
+      queryParamKeys: []
+    });
+  });
+  resource.command("list-agent-cost-catalog").description(`List the AI cost catalog: registry model prices merged with this workspace's negotiated overrides, its own custom cost items (source custom), and the unpriced pairs its telemetry has carried (source unlisted). Rates are USD decimal strings. Pass enabled_only=true for just the enabled catalog.`).option("--enabled-only <value>", `enabled_only`).addHelpText("after", `
+Examples:
+    hyperline agents list-agent-cost-catalog
+    hyperline agents list-agent-cost-catalog --enabled-only <enabled_only>`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.enabledOnly !== void 0)
+      args.enabled_only = opts.enabledOnly;
+    await ctx.execute({
+      method: "GET",
+      path: "/v1/agents/cost-catalog",
+      args,
+      queryParamKeys: ["enabled_only"]
+    });
+  });
+  resource.command("create-agent-cost-catalog-item").description(`Create a custom AI cost item so a non-LLM vendor call is priced instead of landing unpriced at $0. provider/item must match hyperline.cost({ vendor, item }) verbatim and each dimensions[].key must match the unit the SDK sends. Re-creating an existing open item returns it unchanged (200); a pair the global registry already prices is refused \u2014 use the overrides endpoint for that.`).requiredOption("--provider <value>", `provider`).requiredOption("--item <value>", `item`).requiredOption("--dimensions <json>", `dimensions`).addHelpText("after", `
+Examples:
+    hyperline agents create-agent-cost-catalog-item --provider <provider> --item <item> --dimensions <dimensions>
+    hyperline agents create-agent-cost-catalog-item --provider <provider> --item <item> --dimensions <dimensions> --output json`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.provider !== void 0)
+      args.provider = opts.provider;
+    if (opts.item !== void 0)
+      args.item = opts.item;
+    if (opts.dimensions !== void 0)
+      args.dimensions = JSON.parse(opts.dimensions);
+    await ctx.execute({
+      method: "POST",
+      path: "/v1/agents/cost-catalog/items",
+      args,
+      queryParamKeys: []
+    });
+  });
+  resource.command("delete-agent-cost-catalog-item").description(`Close a custom AI cost item by its custom_item_id. History is kept; new calls on that pair go back to unpriced. An override id passed here is a 404.`).requiredOption("--item-id <value>", `item_id parameter`).option("--yes", "Skip confirmation").addHelpText("after", `
+Examples:
+    hyperline agents delete-agent-cost-catalog-item --item-id <item_id>
+    hyperline agents delete-agent-cost-catalog-item --item-id <item_id> --output json`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.itemId !== void 0)
+      args.item_id = opts.itemId;
+    if (!opts.yes) {
+      const confirmed = await confirmPrompt("Are you sure? Pass --yes to skip. [y/N] ");
+      if (!confirmed) {
+        process.stdout.write("Aborted.\n");
+        return;
+      }
+    }
+    await ctx.execute({
+      method: "DELETE",
+      path: "/v1/agents/cost-catalog/items/{item_id}",
+      args,
+      queryParamKeys: []
+    });
+  });
+  resource.command("upsert-agent-cost-catalog-override").description(`Set this workspace's negotiated price for a registry AI model (input/output/cached/cache-write USD per 1M tokens, plus optional dimensions). Replaces any open override immediately; historical calls keep their original rate. A pair the registry does not know is refused \u2014 create a custom cost item instead.`).requiredOption("--provider <value>", `provider`).requiredOption("--model <value>", `model`).requiredOption("--input-per-m-tokens <value>", `input_per_m_tokens`).requiredOption("--output-per-m-tokens <value>", `output_per_m_tokens`).option("--cached-input-per-m-tokens <value>", `cached_input_per_m_tokens`).option("--cache-write-per-m-tokens <value>", `cache_write_per_m_tokens`).option("--dimensions <json>", `dimensions`).addHelpText("after", `
+Examples:
+    hyperline agents upsert-agent-cost-catalog-override --provider <provider> --model <model> --input-per-m-tokens <input_per_m_tokens> --output-per-m-tokens <output_per_m_tokens>
+    hyperline agents upsert-agent-cost-catalog-override --provider <provider> --model <model> --input-per-m-tokens <input_per_m_tokens> --output-per-m-tokens <output_per_m_tokens> --cached-input-per-m-tokens <cached_input_per_m_tokens> --cache-write-per-m-tokens <cache_write_per_m_tokens>
+    hyperline agents upsert-agent-cost-catalog-override --provider <provider> --model <model> --input-per-m-tokens <input_per_m_tokens> --output-per-m-tokens <output_per_m_tokens> --output json`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.provider !== void 0)
+      args.provider = opts.provider;
+    if (opts.model !== void 0)
+      args.model = opts.model;
+    if (opts.inputPerMTokens !== void 0)
+      args.input_per_m_tokens = opts.inputPerMTokens;
+    if (opts.outputPerMTokens !== void 0)
+      args.output_per_m_tokens = opts.outputPerMTokens;
+    if (opts.cachedInputPerMTokens !== void 0)
+      args.cached_input_per_m_tokens = opts.cachedInputPerMTokens;
+    if (opts.cacheWritePerMTokens !== void 0)
+      args.cache_write_per_m_tokens = opts.cacheWritePerMTokens;
+    if (opts.dimensions !== void 0)
+      args.dimensions = JSON.parse(opts.dimensions);
+    await ctx.execute({
+      method: "PUT",
+      path: "/v1/agents/cost-catalog/overrides",
+      args,
+      queryParamKeys: []
+    });
+  });
+  resource.command("delete-agent-cost-catalog-override").description(`Close this workspace's negotiated price override by its override.id; pricing falls back to the global registry rate. A custom cost item id passed here is a 404.`).requiredOption("--override-id <value>", `override_id parameter`).option("--yes", "Skip confirmation").addHelpText("after", `
+Examples:
+    hyperline agents delete-agent-cost-catalog-override --override-id <override_id>
+    hyperline agents delete-agent-cost-catalog-override --override-id <override_id> --output json`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.overrideId !== void 0)
+      args.override_id = opts.overrideId;
+    if (!opts.yes) {
+      const confirmed = await confirmPrompt("Are you sure? Pass --yes to skip. [y/N] ");
+      if (!confirmed) {
+        process.stdout.write("Aborted.\n");
+        return;
+      }
+    }
+    await ctx.execute({
+      method: "DELETE",
+      path: "/v1/agents/cost-catalog/overrides/{override_id}",
+      args,
+      queryParamKeys: []
+    });
+  });
+  resource.command("list-agent-customer-policies").description(`List all AI billing policies (scopes) for one customer: the default shared pool plus per-agent overrides. Accepts Hyperline or external customer ids.`).requiredOption("--customer-id <value>", `customer_id parameter`).addHelpText("after", `
+Examples:
+    hyperline agents list-agent-customer-policies --customer-id <customer_id>`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.customerId !== void 0)
+      args.customer_id = opts.customerId;
+    await ctx.execute({
+      method: "GET",
+      path: "/v1/agents/customers/{customer_id}/policies",
+      args,
+      queryParamKeys: []
+    });
+  });
+  resource.command("get-agent-customer-policy").description(`Get one customer's AI billing policy \u2014 the default shared pool, or one agent's own scope via the agent query param.`).requiredOption("--customer-id <value>", `customer_id parameter`).option("--agent <value>", `agent`).addHelpText("after", `
+Examples:
+    hyperline agents get-agent-customer-policy --customer-id <customer_id>
+    hyperline agents get-agent-customer-policy --customer-id <customer_id> --agent <agent>`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.customerId !== void 0)
+      args.customer_id = opts.customerId;
+    if (opts.agent !== void 0)
+      args.agent = opts.agent;
+    await ctx.execute({
+      method: "GET",
+      path: "/v1/agents/customers/{customer_id}/policy",
+      args,
+      queryParamKeys: ["agent"]
+    });
+  });
+  resource.command("upsert-agent-customer-policy").description(`Create or replace one customer's AI billing policy (whole-row). Pass plan_id to attach the customer to a billing plan \u2014 this also attaches the plan's overage invoice container to their subscription. Past-limit usage is priced by overage_markup_percent over the base rates, or by overage_rate_card_id (a currency rate card whose rates ARE the overage price) \u2014 never both. Wallet/credit pots are auto-opened empty.`).requiredOption("--customer-id <value>", `customer_id parameter`).option("--agent <value>", `agent`).option("--internal-description <value>", `internal_description`).requiredOption("--mode <value>", `mode`).option("--wallet-id <value>", `wallet_id`).option("--credit-product-id <value>", `credit_product_id`).option("--markup-percent <value>", `markup_percent`).option("--overage-mode <value>", `overage_mode`).option("--overage-markup-percent <value>", `overage_markup_percent`).option("--overage-rate-card-id <value>", `overage_rate_card_id`).option("--overage-wallet-id <value>", `overage_wallet_id`).option("--floor <value>", `floor`).option("--settlement-interval-minutes <number>", `settlement_interval_minutes`).option("--settlement-schedule <value>", `settlement_schedule`).option("--credit-rates <json>", `credit_rates`).option("--window-rates <json>", `window_rates`).option("--rate-card-id <value>", `rate_card_id`).option("--plan-id <value>", `plan_id`).requiredOption("--blocked", `blocked`).addHelpText("after", `
+Examples:
+    hyperline agents upsert-agent-customer-policy --customer-id <customer_id> --mode <mode> --blocked
+    hyperline agents upsert-agent-customer-policy --customer-id <customer_id> --mode <mode> --blocked --agent <agent> --internal-description <internal_description>
+    hyperline agents upsert-agent-customer-policy --customer-id <customer_id> --mode <mode> --blocked --output json`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.customerId !== void 0)
+      args.customer_id = opts.customerId;
+    if (opts.agent !== void 0)
+      args.agent = opts.agent;
+    if (opts.internalDescription !== void 0)
+      args.internal_description = opts.internalDescription;
+    if (opts.mode !== void 0)
+      args.mode = opts.mode;
+    if (opts.walletId !== void 0)
+      args.wallet_id = opts.walletId;
+    if (opts.creditProductId !== void 0)
+      args.credit_product_id = opts.creditProductId;
+    if (opts.markupPercent !== void 0)
+      args.markup_percent = opts.markupPercent;
+    if (opts.overageMode !== void 0)
+      args.overage_mode = opts.overageMode;
+    if (opts.overageMarkupPercent !== void 0)
+      args.overage_markup_percent = opts.overageMarkupPercent;
+    if (opts.overageRateCardId !== void 0)
+      args.overage_rate_card_id = opts.overageRateCardId;
+    if (opts.overageWalletId !== void 0)
+      args.overage_wallet_id = opts.overageWalletId;
+    if (opts.floor !== void 0)
+      args.floor = opts.floor;
+    if (opts.settlementSchedule !== void 0)
+      args.settlement_schedule = opts.settlementSchedule;
+    if (opts.rateCardId !== void 0)
+      args.rate_card_id = opts.rateCardId;
+    if (opts.planId !== void 0)
+      args.plan_id = opts.planId;
+    if (opts.settlementIntervalMinutes !== void 0)
+      args.settlement_interval_minutes = Number(opts.settlementIntervalMinutes);
+    if (opts.blocked !== void 0)
+      args.blocked = true;
+    if (opts.creditRates !== void 0)
+      args.credit_rates = JSON.parse(opts.creditRates);
+    if (opts.windowRates !== void 0)
+      args.window_rates = JSON.parse(opts.windowRates);
+    await ctx.execute({
+      method: "PUT",
+      path: "/v1/agents/customers/{customer_id}/policy",
+      args,
+      queryParamKeys: ["agent"]
+    });
+  });
+  resource.command("delete-agent-customer-policy").description(`Delete one customer's AI billing policy scope. Refused (409) while it owes unsettled consumption or while agent overrides still depend on it.`).requiredOption("--customer-id <value>", `customer_id parameter`).option("--agent <value>", `agent`).option("--yes", "Skip confirmation").addHelpText("after", `
+Examples:
+    hyperline agents delete-agent-customer-policy --customer-id <customer_id>
+    hyperline agents delete-agent-customer-policy --customer-id <customer_id> --agent <agent>
+    hyperline agents delete-agent-customer-policy --customer-id <customer_id> --output json`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.customerId !== void 0)
+      args.customer_id = opts.customerId;
+    if (opts.agent !== void 0)
+      args.agent = opts.agent;
+    if (!opts.yes) {
+      const confirmed = await confirmPrompt("Are you sure? Pass --yes to skip. [y/N] ");
+      if (!confirmed) {
+        process.stdout.write("Aborted.\n");
+        return;
+      }
+    }
+    await ctx.execute({
+      method: "DELETE",
+      path: "/v1/agents/customers/{customer_id}/policy",
+      args,
+      queryParamKeys: ["agent"]
+    });
+  });
+  resource.command("apply-agent-default-plan").description(`Apply the workspace's default AI agent billing plan to one customer (by id or external id). Idempotent; refuses (409) if the customer already has a different billing policy, 404 when no default plan is set.`).requiredOption("--customer-id <value>", `customer_id parameter`).addHelpText("after", `
+Examples:
+    hyperline agents apply-agent-default-plan --customer-id <customer_id>
+    hyperline agents apply-agent-default-plan --customer-id <customer_id> --output json`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.customerId !== void 0)
+      args.customer_id = opts.customerId;
+    await ctx.execute({
+      method: "POST",
+      path: "/v1/agents/customers/{customer_id}/apply-default-plan",
+      args,
+      queryParamKeys: []
+    });
+  });
+  resource.command("get-agent-customer-balance").description(`Get one customer's live AI balance, shaped by their billing mode: wallet shadow balance, credit pot, or rolling window meters with reset times. Includes per-agent scopes and overage state.`).requiredOption("--customer-id <value>", `customer_id parameter`).option("--agent <value>", `agent`).addHelpText("after", `
+Examples:
+    hyperline agents get-agent-customer-balance --customer-id <customer_id>
+    hyperline agents get-agent-customer-balance --customer-id <customer_id> --agent <agent>`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.customerId !== void 0)
+      args.customer_id = opts.customerId;
+    if (opts.agent !== void 0)
+      args.agent = opts.agent;
+    await ctx.execute({
+      method: "GET",
+      path: "/v1/agents/customers/{customer_id}/balance",
+      args,
+      queryParamKeys: ["agent"]
+    });
+  });
+  resource.command("reset-agent-customer-windows").description(`Reset one customer's open AI allowance windows so their next call starts a fresh full allowance. Windows-mode scopes only.`).requiredOption("--customer-id <value>", `customer_id parameter`).option("--agent <value>", `agent`).addHelpText("after", `
+Examples:
+    hyperline agents reset-agent-customer-windows --customer-id <customer_id>
+    hyperline agents reset-agent-customer-windows --customer-id <customer_id> --agent <agent>
+    hyperline agents reset-agent-customer-windows --customer-id <customer_id> --output json`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.customerId !== void 0)
+      args.customer_id = opts.customerId;
+    if (opts.agent !== void 0)
+      args.agent = opts.agent;
+    await ctx.execute({
+      method: "POST",
+      path: "/v1/agents/customers/{customer_id}/windows/reset",
+      args,
+      queryParamKeys: ["agent"]
+    });
+  });
+  resource.command("list-agent-customer-consumption").description(`List one customer's AI consumption ledger entries, newest first, with amounts, denominations and overage flags. Filter by agent scope, overage, and from/to time range; paginated with take/skip.`).requiredOption("--customer-id <value>", `customer_id parameter`).option("--agent <value>", `agent`).option("--overage", `overage`).option("--from <value>", `from`).option("--to <value>", `to`).option("--take <number>", `take`).option("--skip <number>", `skip`).addHelpText("after", `
+Examples:
+    hyperline agents list-agent-customer-consumption --customer-id <customer_id>
+    hyperline agents list-agent-customer-consumption --customer-id <customer_id> --agent <agent> --overage`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.customerId !== void 0)
+      args.customer_id = opts.customerId;
+    if (opts.agent !== void 0)
+      args.agent = opts.agent;
+    if (opts.from !== void 0)
+      args.from = opts.from;
+    if (opts.to !== void 0)
+      args.to = opts.to;
+    if (opts.take !== void 0)
+      args.take = Number(opts.take);
+    if (opts.skip !== void 0)
+      args.skip = Number(opts.skip);
+    if (opts.overage !== void 0)
+      args.overage = true;
+    await ctx.execute({
+      method: "GET",
+      path: "/v1/agents/customers/{customer_id}/consumption",
+      args,
+      queryParamKeys: ["agent", "overage", "from", "to", "take", "skip"]
+    });
+  });
+  resource.command("get-agent-customer-overview").description(`Get one customer's full AI billing overview: default policy, per-agent scopes, balances and billed consumption totals in one read.`).requiredOption("--customer-id <value>", `customer_id parameter`).addHelpText("after", `
+Examples:
+    hyperline agents get-agent-customer-overview --customer-id <customer_id>`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.customerId !== void 0)
+      args.customer_id = opts.customerId;
+    await ctx.execute({
+      method: "GET",
+      path: "/v1/agents/customers/{customer_id}/overview",
+      args,
+      queryParamKeys: []
+    });
+  });
+}
+
+// build/commands/generated/aggregators.js
+function registerAggregatorsCommands(parent) {
+  const resource = parent.command("aggregators").description("Manage aggregators");
+  resource.command("list").description(`List all aggregators with pagination. Aggregators define how billable events are counted or summed to compute usage.`).option("--take <number>", `take`).option("--skip <number>", `skip`).addHelpText("after", `
+Examples:
+    hyperline aggregators list
+    hyperline aggregators list --take <take>`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.take !== void 0)
+      args.take = Number(opts.take);
+    if (opts.skip !== void 0)
+      args.skip = Number(opts.skip);
+    await ctx.execute({
+      method: "GET",
+      path: "/v1/aggregators",
+      args,
+      queryParamKeys: ["take", "skip"]
+    });
+  });
+  resource.command("create").description(`Create a new aggregator that counts or sums billable events. Aggregators can then be linked to products via aggregator_id.`).requiredOption("--entity <value>", `The billable event entity to aggregate.`).option("--type <value>", `The type of aggregator.`).option("--where <json>", `Filter conditions for the aggregation.`).option("--name <value>", `Name of the aggregator.`).option("--description <value>", `Description of the aggregator.`).option("--allow-negative-values", `Whether the aggregator can produce negative values.`).option("--aggregate-on-customers-enabled", `Whether the aggregator should aggregate on customers.`).option("--custom-event-name <value>", `Custom event name for the aggregator.`).option("--exposed-event-keys <json>", `Event keys exposed by the aggregator.`).option("--unit-name <value>", `Display name of the unit being measured (e.g. 'user', 'request'). Used as fallback for products attached to this aggregator.`).option("--default-interval-count <number>", `Default interval count for usage periods.`).option("--default-interval-period <value>", `Default interval period for usage periods.`).option("--thresholds <json>", `Thresholds for the aggregator.`).requiredOption("--operation <value>", `The aggregation operation to perform.`).option("--property <value>", `The property to sum.`).addHelpText("after", `
+Examples:
+    hyperline aggregators create --entity <entity> --operation <operation>
+    hyperline aggregators create --entity <entity> --operation <operation> --type <type> --where <where>
+    hyperline aggregators create --entity <entity> --operation <operation> --output json`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.entity !== void 0)
+      args.entity = opts.entity;
+    if (opts.type !== void 0)
+      args.type = opts.type;
+    if (opts.name !== void 0)
+      args.name = opts.name;
+    if (opts.description !== void 0)
+      args.description = opts.description;
+    if (opts.customEventName !== void 0)
+      args.custom_event_name = opts.customEventName;
+    if (opts.unitName !== void 0)
+      args.unit_name = opts.unitName;
+    if (opts.defaultIntervalPeriod !== void 0)
+      args.default_interval_period = opts.defaultIntervalPeriod;
+    if (opts.operation !== void 0)
+      args.operation = opts.operation;
+    if (opts.property !== void 0)
+      args.property = opts.property;
+    if (opts.defaultIntervalCount !== void 0)
+      args.default_interval_count = Number(opts.defaultIntervalCount);
+    if (opts.allowNegativeValues !== void 0)
+      args.allow_negative_values = true;
+    if (opts.aggregateOnCustomersEnabled !== void 0)
+      args.aggregate_on_customers_enabled = true;
+    if (opts.where !== void 0)
+      args.where = JSON.parse(opts.where);
+    if (opts.exposedEventKeys !== void 0)
+      args.exposed_event_keys = JSON.parse(opts.exposedEventKeys);
+    if (opts.thresholds !== void 0)
+      args.thresholds = JSON.parse(opts.thresholds);
+    await ctx.execute({
+      method: "POST",
+      path: "/v1/aggregators",
+      args,
+      queryParamKeys: []
+    });
+  });
+  resource.command("get").description(`Retrieve a specific aggregator by ID.`).requiredOption("--id <value>", `id parameter`).addHelpText("after", `
+Examples:
+    hyperline aggregators get --id <id>`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.id !== void 0)
+      args.id = opts.id;
+    await ctx.execute({
+      method: "GET",
+      path: "/v1/aggregators/{id}",
+      args,
+      queryParamKeys: []
+    });
+  });
+  resource.command("update").description(`Update an existing aggregator's configuration.`).requiredOption("--id <value>", `id parameter`).option("--entity <value>", `The billable event entity to aggregate.`).option("--type <value>", `The type of aggregator.`).option("--where <json>", `Filter conditions for the aggregation.`).option("--name <value>", `Name of the aggregator.`).option("--description <value>", `Description of the aggregator.`).option("--allow-negative-values", `Whether the aggregator can produce negative values.`).option("--aggregate-on-customers-enabled", `Whether the aggregator should aggregate on customers.`).option("--custom-event-name <value>", `Custom event name for the aggregator.`).option("--exposed-event-keys <json>", `Event keys exposed by the aggregator.`).option("--unit-name <value>", `Display name of the unit being measured (e.g. 'user', 'request'). Used as fallback for products attached to this aggregator.`).option("--default-interval-count <number>", `Default interval count for usage periods.`).option("--default-interval-period <value>", `Default interval period for usage periods.`).option("--thresholds <json>", `Thresholds for the aggregator. Replaces existing thresholds.`).option("--operation <value>", `The aggregation operation to perform.`).option("--property <value>", `The property to sum. Required when operation is 'sum'.`).addHelpText("after", `
+Examples:
+    hyperline aggregators update --id <id>
+    hyperline aggregators update --id <id> --entity <entity> --type <type>
+    hyperline aggregators update --id <id> --output json`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.id !== void 0)
+      args.id = opts.id;
+    if (opts.entity !== void 0)
+      args.entity = opts.entity;
+    if (opts.type !== void 0)
+      args.type = opts.type;
+    if (opts.name !== void 0)
+      args.name = opts.name;
+    if (opts.description !== void 0)
+      args.description = opts.description;
+    if (opts.customEventName !== void 0)
+      args.custom_event_name = opts.customEventName;
+    if (opts.unitName !== void 0)
+      args.unit_name = opts.unitName;
+    if (opts.defaultIntervalPeriod !== void 0)
+      args.default_interval_period = opts.defaultIntervalPeriod;
+    if (opts.operation !== void 0)
+      args.operation = opts.operation;
+    if (opts.property !== void 0)
+      args.property = opts.property;
+    if (opts.defaultIntervalCount !== void 0)
+      args.default_interval_count = Number(opts.defaultIntervalCount);
+    if (opts.allowNegativeValues !== void 0)
+      args.allow_negative_values = true;
+    if (opts.aggregateOnCustomersEnabled !== void 0)
+      args.aggregate_on_customers_enabled = true;
+    if (opts.where !== void 0)
+      args.where = JSON.parse(opts.where);
+    if (opts.exposedEventKeys !== void 0)
+      args.exposed_event_keys = JSON.parse(opts.exposedEventKeys);
+    if (opts.thresholds !== void 0)
+      args.thresholds = JSON.parse(opts.thresholds);
+    await ctx.execute({
+      method: "PUT",
+      path: "/v1/aggregators/{id}",
+      args,
+      queryParamKeys: []
+    });
+  });
+  resource.command("delete").description(`Delete an aggregator by ID. Will fail if the aggregator is linked to a product.`).requiredOption("--id <value>", `id parameter`).option("--yes", "Skip confirmation").addHelpText("after", `
+Examples:
+    hyperline aggregators delete --id <id>
+    hyperline aggregators delete --id <id> --output json`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.id !== void 0)
+      args.id = opts.id;
+    if (!opts.yes) {
+      const confirmed = await confirmPrompt("Are you sure? Pass --yes to skip. [y/N] ");
+      if (!confirmed) {
+        process.stdout.write("Aborted.\n");
+        return;
+      }
+    }
+    await ctx.execute({
+      method: "DELETE",
+      path: "/v1/aggregators/{id}",
+      args,
+      queryParamKeys: []
+    });
+  });
+}
+
+// build/commands/generated/aggregators-usage.js
+function registerAggregators_UsageCommands(parent) {
+  const resource = parent.command("aggregators-usage").description("Manage aggregators > usage");
+  resource.command("get-aggregator-usage").description(`Retrieve a usage row for an aggregator. Use the timeseries, group-by-customer or events endpoints to query metering data.`).requiredOption("--id <value>", `id parameter`).addHelpText("after", `
+Examples:
+    hyperline aggregators-usage get-aggregator-usage --id <id>`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.id !== void 0)
+      args.id = opts.id;
+    await ctx.execute({
+      method: "GET",
+      path: "/v1/aggregators/{id}/usage",
+      args,
+      queryParamKeys: []
+    });
+  });
+  resource.command("get-aggregator-usage-timeseries").description(`Get client-wide usage for an aggregator bucketed by month/day/hour over a period.`).requiredOption("--id <value>", `id parameter`).option("--start-date <value>", `ISO-8601 date string.`).option("--end-date <value>", `ISO-8601 date string.`).option("--aggregator-filter-id <value>", `Optional aggregator filter ID. When set, restricts the result to events matching that filter's config. Must belong to the aggregator in the path.`).option("--group-by <value>", `Bucket size for the timeseries.`).addHelpText("after", `
+Examples:
+    hyperline aggregators-usage get-aggregator-usage-timeseries --id <id>
+    hyperline aggregators-usage get-aggregator-usage-timeseries --id <id> --start-date <start_date> --end-date <end_date>`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.id !== void 0)
+      args.id = opts.id;
+    if (opts.startDate !== void 0)
+      args.start_date = opts.startDate;
+    if (opts.endDate !== void 0)
+      args.end_date = opts.endDate;
+    if (opts.aggregatorFilterId !== void 0)
+      args.aggregator_filter_id = opts.aggregatorFilterId;
+    if (opts.groupBy !== void 0)
+      args.group_by = opts.groupBy;
+    await ctx.execute({
+      method: "GET",
+      path: "/v1/aggregators/{id}/usage/timeseries",
+      args,
+      queryParamKeys: [
+        "start_date",
+        "end_date",
+        "aggregator_filter_id",
+        "group_by"
+      ]
+    });
+  });
+  resource.command("get-aggregator-usage-group-by-customer").description(`Per-customer total usage for an aggregator over a period, ranked by total. Paginated with take/skip.`).requiredOption("--id <value>", `id parameter`).option("--start-date <value>", `ISO-8601 date string.`).option("--end-date <value>", `ISO-8601 date string.`).option("--aggregator-filter-id <value>", `Optional aggregator filter ID. When set, restricts the result to events matching that filter's config. Must belong to the aggregator in the path.`).option("--take <number>", `take`).option("--skip <number>", `skip`).addHelpText("after", `
+Examples:
+    hyperline aggregators-usage get-aggregator-usage-group-by-customer --id <id>
+    hyperline aggregators-usage get-aggregator-usage-group-by-customer --id <id> --start-date <start_date> --end-date <end_date>`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.id !== void 0)
+      args.id = opts.id;
+    if (opts.startDate !== void 0)
+      args.start_date = opts.startDate;
+    if (opts.endDate !== void 0)
+      args.end_date = opts.endDate;
+    if (opts.aggregatorFilterId !== void 0)
+      args.aggregator_filter_id = opts.aggregatorFilterId;
+    if (opts.take !== void 0)
+      args.take = Number(opts.take);
+    if (opts.skip !== void 0)
+      args.skip = Number(opts.skip);
+    await ctx.execute({
+      method: "GET",
+      path: "/v1/aggregators/{id}/usage/group-by-customer",
+      args,
+      queryParamKeys: [
+        "start_date",
+        "end_date",
+        "aggregator_filter_id",
+        "take",
+        "skip"
+      ]
+    });
+  });
+  resource.command("get-aggregator-usage-events").description(`List raw billable events for an aggregator across every customer of the client. Paginated with take/skip.`).requiredOption("--id <value>", `id parameter`).option("--start-date <value>", `ISO-8601 date string.`).option("--end-date <value>", `ISO-8601 date string.`).option("--aggregator-filter-id <value>", `Optional aggregator filter ID. When set, restricts the result to events matching that filter's config. Must belong to the aggregator in the path.`).option("--take <number>", `take`).option("--skip <number>", `skip`).addHelpText("after", `
+Examples:
+    hyperline aggregators-usage get-aggregator-usage-events --id <id>
+    hyperline aggregators-usage get-aggregator-usage-events --id <id> --start-date <start_date> --end-date <end_date>`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.id !== void 0)
+      args.id = opts.id;
+    if (opts.startDate !== void 0)
+      args.start_date = opts.startDate;
+    if (opts.endDate !== void 0)
+      args.end_date = opts.endDate;
+    if (opts.aggregatorFilterId !== void 0)
+      args.aggregator_filter_id = opts.aggregatorFilterId;
+    if (opts.take !== void 0)
+      args.take = Number(opts.take);
+    if (opts.skip !== void 0)
+      args.skip = Number(opts.skip);
+    await ctx.execute({
+      method: "GET",
+      path: "/v1/aggregators/{id}/usage/events",
+      args,
+      queryParamKeys: [
+        "start_date",
+        "end_date",
+        "aggregator_filter_id",
+        "take",
+        "skip"
+      ]
+    });
+  });
+}
+
 // build/commands/generated/analytics.js
 function registerAnalyticsCommands(parent) {
   const resource = parent.command("analytics").description("Manage analytics");
@@ -41181,6 +42198,130 @@ Examples:
   });
 }
 
+// build/commands/generated/customers-usage.js
+function registerCustomers_UsageCommands(parent) {
+  const resource = parent.command("customers-usage").description("Manage customers > usage");
+  resource.command("list-customer-usage").description(`List one usage row per aggregator for a single customer over a period (total + event count per aggregator).`).requiredOption("--id <value>", `id parameter`).option("--start-date <value>", `ISO-8601 date string.`).option("--end-date <value>", `ISO-8601 date string.`).addHelpText("after", `
+Examples:
+    hyperline customers-usage list-customer-usage --id <id>
+    hyperline customers-usage list-customer-usage --id <id> --start-date <start_date> --end-date <end_date>`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.id !== void 0)
+      args.id = opts.id;
+    if (opts.startDate !== void 0)
+      args.start_date = opts.startDate;
+    if (opts.endDate !== void 0)
+      args.end_date = opts.endDate;
+    await ctx.execute({
+      method: "GET",
+      path: "/v1/customers/{id}/usage",
+      args,
+      queryParamKeys: ["start_date", "end_date"]
+    });
+  });
+  resource.command("get-customer-usage").description(`Get the usage of a customer for a specific aggregator over a period.`).requiredOption("--id <value>", `id parameter`).requiredOption("--aggregator-id <value>", `aggregator_id parameter`).option("--start-date <value>", `ISO-8601 date string.`).option("--end-date <value>", `ISO-8601 date string.`).addHelpText("after", `
+Examples:
+    hyperline customers-usage get-customer-usage --id <id> --aggregator-id <aggregator_id>
+    hyperline customers-usage get-customer-usage --id <id> --aggregator-id <aggregator_id> --start-date <start_date> --end-date <end_date>`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.id !== void 0)
+      args.id = opts.id;
+    if (opts.aggregatorId !== void 0)
+      args.aggregator_id = opts.aggregatorId;
+    if (opts.startDate !== void 0)
+      args.start_date = opts.startDate;
+    if (opts.endDate !== void 0)
+      args.end_date = opts.endDate;
+    await ctx.execute({
+      method: "GET",
+      path: "/v1/customers/{id}/usage/{aggregator_id}",
+      args,
+      queryParamKeys: ["start_date", "end_date"]
+    });
+  });
+  resource.command("get-customer-usage-timeseries").description(`Get per-bucket usage for a customer + aggregator (month/day/hour).`).requiredOption("--id <value>", `id parameter`).requiredOption("--aggregator-id <value>", `aggregator_id parameter`).option("--start-date <value>", `ISO-8601 date string.`).option("--end-date <value>", `ISO-8601 date string.`).option("--aggregator-filter-id <value>", `Optional aggregator filter ID. When set, restricts the result to events matching that filter's config. Must belong to the aggregator in the path.`).option("--group-by <value>", `Bucket size for the timeseries.`).addHelpText("after", `
+Examples:
+    hyperline customers-usage get-customer-usage-timeseries --id <id> --aggregator-id <aggregator_id>
+    hyperline customers-usage get-customer-usage-timeseries --id <id> --aggregator-id <aggregator_id> --start-date <start_date> --end-date <end_date>`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.id !== void 0)
+      args.id = opts.id;
+    if (opts.aggregatorId !== void 0)
+      args.aggregator_id = opts.aggregatorId;
+    if (opts.startDate !== void 0)
+      args.start_date = opts.startDate;
+    if (opts.endDate !== void 0)
+      args.end_date = opts.endDate;
+    if (opts.aggregatorFilterId !== void 0)
+      args.aggregator_filter_id = opts.aggregatorFilterId;
+    if (opts.groupBy !== void 0)
+      args.group_by = opts.groupBy;
+    await ctx.execute({
+      method: "GET",
+      path: "/v1/customers/{id}/usage/{aggregator_id}/timeseries",
+      args,
+      queryParamKeys: [
+        "start_date",
+        "end_date",
+        "aggregator_filter_id",
+        "group_by"
+      ]
+    });
+  });
+  resource.command("get-customer-usage-events").description(`List raw billable events for a customer + aggregator over a period. Paginated with take/skip.`).requiredOption("--id <value>", `id parameter`).requiredOption("--aggregator-id <value>", `aggregator_id parameter`).option("--start-date <value>", `ISO-8601 date string.`).option("--end-date <value>", `ISO-8601 date string.`).option("--aggregator-filter-id <value>", `Optional aggregator filter ID. When set, restricts the result to events matching that filter's config. Must belong to the aggregator in the path.`).option("--take <number>", `take`).option("--skip <number>", `skip`).addHelpText("after", `
+Examples:
+    hyperline customers-usage get-customer-usage-events --id <id> --aggregator-id <aggregator_id>
+    hyperline customers-usage get-customer-usage-events --id <id> --aggregator-id <aggregator_id> --start-date <start_date> --end-date <end_date>`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.id !== void 0)
+      args.id = opts.id;
+    if (opts.aggregatorId !== void 0)
+      args.aggregator_id = opts.aggregatorId;
+    if (opts.startDate !== void 0)
+      args.start_date = opts.startDate;
+    if (opts.endDate !== void 0)
+      args.end_date = opts.endDate;
+    if (opts.aggregatorFilterId !== void 0)
+      args.aggregator_filter_id = opts.aggregatorFilterId;
+    if (opts.take !== void 0)
+      args.take = Number(opts.take);
+    if (opts.skip !== void 0)
+      args.skip = Number(opts.skip);
+    await ctx.execute({
+      method: "GET",
+      path: "/v1/customers/{id}/usage/{aggregator_id}/events",
+      args,
+      queryParamKeys: [
+        "start_date",
+        "end_date",
+        "aggregator_filter_id",
+        "take",
+        "skip"
+      ]
+    });
+  });
+}
+
 // build/commands/generated/exports.js
 function registerExportsCommands(parent) {
   const resource = parent.command("exports").description("Manage exports");
@@ -45555,7 +46696,10 @@ function registerAllCommands(program2) {
   registerAccounting_ReportsCommands(program2);
   registerAccounting_Revenue_RecognitionCommands(program2);
   registerAccounting_RulesCommands(program2);
+  registerAgentsCommands(program2);
   registerCustom_PropertiesCommands(program2);
+  registerAggregatorsCommands(program2);
+  registerAggregators_UsageCommands(program2);
   registerAnalyticsCommands(program2);
   registerBank_AccountsCommands(program2);
   registerCompaniesCommands(program2);
@@ -45566,6 +46710,7 @@ function registerAllCommands(program2) {
   registerCustomers_AddressCommands(program2);
   registerCustomers_ShippingCommands(program2);
   registerCustomersCommands(program2);
+  registerCustomers_UsageCommands(program2);
   registerOrganisationsCommands(program2);
   registerCustomers_SegmentsCommands(program2);
   registerExportsCommands(program2);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperline/cli",
-  "version": "0.1.0-build.1.ed7561b",
+  "version": "0.1.0-build.1.ed8c065",
   "description": "Agent-first CLI for Hyperline API",
   "type": "module",
   "main": "./dist/index.js",
@@ -54,8 +54,5 @@
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
-  },
-  "volta": {
-    "extends": "../../package.json"
   }
 }