@hasna/economy 0.4.0 → 0.5.0

package/dist/chunks/index-kgy9b6bf.js

@@ -0,0 +1,451 @@
+// @bun
+import {
+  buildBrief,
+  cloudListItems,
+  cloudObject,
+  economyCloudStorage,
+  packageMetadata,
+  queryBillingDiff,
+  queryExportRows,
+  queryForecast,
+  queryModelEfficiency,
+  queryProjectDetail,
+  queryRangeStats,
+  querySavingsSummary,
+  requireCurrentBillingDiffSummary,
+  requireCurrentSavingsReport
+} from "./index-axh32d30.js";
+import {
+  deleteBudget,
+  deleteGoal,
+  deleteModelPricing,
+  deleteProject,
+  deleteSubscription,
+  ensurePricingSeeded,
+  estimateCostFromRows,
+  getBudgetStatuses,
+  getGoalStatuses,
+  getMachineId,
+  getProject,
+  getSessionDetail,
+  insertFeedback,
+  listMachineRegistry,
+  listMachines,
+  listModelPricing,
+  listSubscriptions,
+  queryAccountBreakdown,
+  queryAccountBreakdownSince,
+  queryAgentBreakdown,
+  queryAgentBreakdownSince,
+  queryBillingSummary,
+  queryCostCenterBreakdown,
+  queryDailyBreakdown,
+  queryModelBreakdown,
+  queryModelBreakdownSince,
+  queryProjectBreakdown,
+  queryProjectBreakdownSince,
+  queryRequestsSince,
+  querySessions,
+  querySummary,
+  queryTopSessions,
+  queryUsageSnapshots,
+  requireCurrentBillingSummary,
+  requireCurrentCostSummary,
+  subscriptionId,
+  upsertBudget,
+  upsertGoal,
+  upsertModelPricing,
+  upsertProject,
+  upsertSubscription,
+  usageSnapshotFilterForPeriod,
+  validateIngest
+} from "./index-ez9thsr7.js";
+import {
+  __require
+} from "./index-p35cyhc4.js";
+
+// src/lib/store/index.ts
+import { randomUUID } from "crypto";
+function configuredSubscription(input) {
+  if (typeof input.account_key !== "string" || !input.account_key.trim()) {
+    throw new TypeError("account_key must identify the provider account; accepted: nonempty account key");
+  }
+  const now = new Date().toISOString();
+  const row = {
+    ...input,
+    id: input.id ?? subscriptionId(input),
+    monthly_fee_usd: input.monthly_fee_usd === undefined ? 0 : input.monthly_fee_usd,
+    included_usage_usd: input.included_usage_usd === undefined ? 0 : input.included_usage_usd,
+    fee_basis: input.monthly_fee_usd === undefined ? "unknown" : "configured",
+    included_basis: input.included_usage_usd === undefined ? "unknown" : "configured",
+    observed_station: input.observed_station ?? null,
+    observed_at: now,
+    created_at: now,
+    updated_at: now
+  };
+  validateIngest({ subscriptions: [row] });
+  return row;
+}
+
+class LocalStore {
+  transport = "local";
+  _db;
+  async db() {
+    if (!this._db) {
+      const { openDatabase } = await import("./sqlite-store-501f32ts.js");
+      this._db = openDatabase();
+      ensurePricingSeeded(this._db);
+    }
+    return this._db;
+  }
+  async summary(period, machine) {
+    return querySummary(await this.db(), period, machine);
+  }
+  async sessions(filter) {
+    return querySessions(await this.db(), filter);
+  }
+  async topSessions(n, agent, since) {
+    return queryTopSessions(await this.db(), n, agent, since);
+  }
+  async sessionDetail(id) {
+    return getSessionDetail(await this.db(), id);
+  }
+  async modelBreakdown(query = {}) {
+    return query.since ? queryModelBreakdownSince(await this.db(), query.since) : queryModelBreakdown(await this.db());
+  }
+  async agentBreakdown(query = {}) {
+    return query.since ? queryAgentBreakdownSince(await this.db(), query.since) : queryAgentBreakdown(await this.db(), query.period ?? "all", query.machine);
+  }
+  async projectBreakdown(query = {}) {
+    return query.since ? queryProjectBreakdownSince(await this.db(), query.since, query.machine) : queryProjectBreakdown(await this.db(), query.period ?? "all", query.machine);
+  }
+  async accountBreakdown(query = {}) {
+    return query.since ? queryAccountBreakdownSince(await this.db(), query.since) : queryAccountBreakdown(await this.db(), query.period ?? "all", query.machine);
+  }
+  async costCenterBreakdown(query = {}) {
+    return queryCostCenterBreakdown(await this.db(), query.period ?? "all", {
+      kind: query.kind,
+      machine: query.machine,
+      since: query.since
+    });
+  }
+  async accounts(period) {
+    return queryAccountBreakdown(await this.db(), period);
+  }
+  async daily(days, machine) {
+    return queryDailyBreakdown(await this.db(), days, machine);
+  }
+  async machines() {
+    return listMachines(await this.db());
+  }
+  async fleet(period) {
+    return {
+      summary: querySummary(await this.db(), period, undefined, true),
+      machines: listMachines(await this.db(), period),
+      registry: listMachineRegistry(await this.db())
+    };
+  }
+  async billingSummary(period) {
+    return queryBillingSummary(await this.db(), period);
+  }
+  async billingDiff(period) {
+    return queryBillingDiff(await this.db(), period);
+  }
+  async usage(period, agent) {
+    const snapshots = queryUsageSnapshots(await this.db(), { agent, ...usageSnapshotFilterForPeriod(period) });
+    const summary = querySummary(await this.db(), period, undefined, true, agent);
+    return { snapshots, summary };
+  }
+  async savings(period, agent) {
+    return querySavingsSummary(await this.db(), period, agent);
+  }
+  async listBudgets() {
+    return getBudgetStatuses(await this.db());
+  }
+  async listGoals() {
+    return getGoalStatuses(await this.db());
+  }
+  async listPricing() {
+    return listModelPricing(await this.db());
+  }
+  async listSubscriptions() {
+    return listSubscriptions(await this.db());
+  }
+  async listProjects() {
+    return queryProjectBreakdown(await this.db());
+  }
+  async brief(query = {}) {
+    return buildBrief(await this.db(), {
+      since: query.since,
+      machine: query.machine,
+      currentMachineId: query.currentMachineId,
+      localSyncAt: query.localSyncAt
+    });
+  }
+  async projectDetail(nameOrPath) {
+    return queryProjectDetail(await this.db(), nameOrPath);
+  }
+  async exportRows(type, period) {
+    return queryExportRows(await this.db(), type, period);
+  }
+  async rangeStats(from, to) {
+    return queryRangeStats(await this.db(), from, to);
+  }
+  async forecast() {
+    return queryForecast(await this.db());
+  }
+  async efficiency() {
+    return queryModelEfficiency(await this.db());
+  }
+  async recentRequests(since) {
+    return queryRequestsSince(await this.db(), since);
+  }
+  async estimate(input) {
+    return estimateCostFromRows(listModelPricing(await this.db()), input.model, input.inputTokens, input.outputTokens, input.cacheReadTokens ?? 0, input.cacheWriteTokens ?? 0, input.cacheWrite1hTokens ?? 0, input.cacheStorageTokenHours ?? 0);
+  }
+  async setBudget(input) {
+    const now = new Date().toISOString();
+    const budget = { id: randomUUID(), ...input, created_at: now, updated_at: now };
+    upsertBudget(await this.db(), budget);
+    return budget.id;
+  }
+  async removeBudget(id) {
+    deleteBudget(await this.db(), id);
+  }
+  async setGoal(input) {
+    const now = new Date().toISOString();
+    upsertGoal(await this.db(), { id: randomUUID(), ...input, created_at: now, updated_at: now });
+  }
+  async removeGoal(id) {
+    deleteGoal(await this.db(), id);
+  }
+  async setPricing(input) {
+    upsertModelPricing(await this.db(), { ...input, updated_at: new Date().toISOString() });
+  }
+  async removePricing(model) {
+    deleteModelPricing(await this.db(), model);
+  }
+  async setSubscription(input) {
+    const row = configuredSubscription(input);
+    const db = await this.db();
+    upsertSubscription(db, row);
+    return db.get("SELECT * FROM subscriptions WHERE id = ?", row.id);
+  }
+  async removeSubscription(id) {
+    deleteSubscription(await this.db(), id);
+  }
+  async addProject(path, name) {
+    upsertProject(await this.db(), {
+      id: randomUUID(),
+      path,
+      name,
+      description: null,
+      tags: [],
+      created_at: new Date().toISOString()
+    });
+  }
+  async renameProject(path, name) {
+    const existing = getProject(await this.db(), path);
+    if (!existing)
+      throw new Error("Project not found");
+    upsertProject(await this.db(), { ...existing, name });
+  }
+  async removeProject(path) {
+    deleteProject(await this.db(), path);
+  }
+  async sendFeedback(input) {
+    insertFeedback(await this.db(), {
+      message: input.message,
+      email: input.email ?? null,
+      category: input.category ?? "general",
+      version: packageMetadata.version,
+      machine_id: getMachineId()
+    });
+  }
+}
+function q(params) {
+  const out = {};
+  for (const [k, v] of Object.entries(params))
+    if (v !== undefined && v !== null && v !== "")
+      out[k] = v;
+  return out;
+}
+
+class ApiStore {
+  cloud;
+  transport = "cloud-http";
+  constructor(cloud) {
+    this.cloud = cloud;
+  }
+  async summary(period, machine) {
+    return requireCurrentCostSummary(await cloudObject(this.cloud, "/summary", q({ period, machine })));
+  }
+  async sessions(filter) {
+    return cloudListItems(this.cloud, "sessions", q({ ...filter }));
+  }
+  async topSessions(n, agent, since) {
+    return cloudListItems(this.cloud, "top", q({ n, agent, since }));
+  }
+  async sessionDetail(id) {
+    const matches = await cloudListItems(this.cloud, "sessions", q({ search: id, limit: 1 }));
+    const session = matches[0];
+    if (!session)
+      return null;
+    const requests = await cloudObject(this.cloud, `/sessions/${encodeURIComponent(String(session["id"]))}/requests`);
+    return { session, requests: requests ?? [] };
+  }
+  async modelBreakdown(query = {}) {
+    return cloudListItems(this.cloud, "breakdown", q({ by: "model", period: query.period, since: query.since }));
+  }
+  async agentBreakdown(query = {}) {
+    return cloudListItems(this.cloud, "breakdown", q({ by: "agent", period: query.period, since: query.since }));
+  }
+  async projectBreakdown(query = {}) {
+    return cloudListItems(this.cloud, "breakdown", q({ by: "project", period: query.period, since: query.since, machine: query.machine }));
+  }
+  async accountBreakdown(query = {}) {
+    return cloudListItems(this.cloud, "breakdown", q({ by: "account", period: query.period, since: query.since }));
+  }
+  async costCenterBreakdown(query = {}) {
+    const rows = await cloudListItems(this.cloud, "breakdown", q({
+      by: query.kind ?? "cost-center",
+      period: query.period,
+      since: query.since
+    }));
+    return rows.filter((row) => Boolean(row?.cost_center_id));
+  }
+  async accounts(period) {
+    return cloudListItems(this.cloud, "accounts", q({ period }));
+  }
+  async daily(days, machine) {
+    return cloudListItems(this.cloud, "daily", q({ days, machine }));
+  }
+  async machines() {
+    return cloudListItems(this.cloud, "machines");
+  }
+  async fleet(period) {
+    const data = await cloudObject(this.cloud, "/fleet", q({ period }));
+    return {
+      summary: requireCurrentCostSummary(data.summary),
+      machines: data.machines ?? [],
+      registry: data.registry ?? []
+    };
+  }
+  async billingSummary(period) {
+    return requireCurrentBillingSummary(await cloudObject(this.cloud, "/billing", q({ period })));
+  }
+  async billingDiff(period) {
+    return requireCurrentBillingDiffSummary(await cloudObject(this.cloud, "/billing/diff", q({ period })));
+  }
+  async usage(period, agent) {
+    const data = await cloudObject(this.cloud, "/usage", q({ period, agent }));
+    return { ...data, summary: requireCurrentCostSummary(data.summary) };
+  }
+  async savings(period, agent) {
+    return requireCurrentSavingsReport(await cloudObject(this.cloud, "/savings", q({ period, agent })));
+  }
+  async listBudgets() {
+    return cloudListItems(this.cloud, "budgets");
+  }
+  async listGoals() {
+    return cloudListItems(this.cloud, "goals");
+  }
+  async listPricing() {
+    return cloudListItems(this.cloud, "pricing");
+  }
+  async listSubscriptions() {
+    return cloudListItems(this.cloud, "subscriptions");
+  }
+  async listProjects() {
+    return cloudListItems(this.cloud, "projects");
+  }
+  async brief(query = {}) {
+    return cloudObject(this.cloud, "/brief", q({ since: query.since, machine: query.machine }));
+  }
+  async projectDetail(nameOrPath) {
+    return cloudObject(this.cloud, "/projects/detail", q({ q: nameOrPath }));
+  }
+  async exportRows(type, period) {
+    return cloudListItems(this.cloud, "export", q({ type, period }));
+  }
+  async rangeStats(from, to) {
+    return cloudObject(this.cloud, "/compare", q({ from, to }));
+  }
+  async forecast() {
+    return cloudObject(this.cloud, "/forecast");
+  }
+  async efficiency() {
+    return cloudListItems(this.cloud, "efficiency");
+  }
+  async recentRequests(since) {
+    return cloudListItems(this.cloud, "requests", q({ since }));
+  }
+  async estimate(input) {
+    const rows = await this.listPricing();
+    return estimateCostFromRows(rows, input.model, input.inputTokens, input.outputTokens, input.cacheReadTokens ?? 0, input.cacheWriteTokens ?? 0, input.cacheWrite1hTokens ?? 0, input.cacheStorageTokenHours ?? 0);
+  }
+  async setBudget(input) {
+    const created = await this.cloud.client.create("budgets", {
+      project_path: input.project_path,
+      ...input.agent ? { agent: input.agent } : {},
+      ...input.cost_center_id ? { cost_center_id: input.cost_center_id } : {},
+      period: input.period,
+      limit_usd: input.limit_usd,
+      alert_at_percent: input.alert_at_percent
+    });
+    return created?.id ?? "";
+  }
+  async removeBudget(id) {
+    await this.cloud.client.delete("budgets", id);
+  }
+  async setGoal(input) {
+    await this.cloud.client.create("goals", {
+      period: input.period,
+      project_path: input.project_path,
+      ...input.agent ? { agent: input.agent } : {},
+      limit_usd: input.limit_usd
+    });
+  }
+  async removeGoal(id) {
+    await this.cloud.client.delete("goals", id);
+  }
+  async setPricing(input) {
+    await this.cloud.client.create("pricing", { ...input, updated_at: new Date().toISOString() });
+  }
+  async removePricing(model) {
+    await this.cloud.client.delete("pricing", model);
+  }
+  async setSubscription(input) {
+    const row = configuredSubscription(input);
+    return this.cloud.client.create("subscriptions", row);
+  }
+  async removeSubscription(id) {
+    await this.cloud.client.delete("subscriptions", id);
+  }
+  async addProject(path, name) {
+    await this.cloud.client.create("project-registry", { path, name, description: null, tags: [] });
+  }
+  async renameProject(path, name) {
+    await this.cloud.client.delete("project-registry", path);
+    await this.cloud.client.create("project-registry", { path, name, description: null, tags: [] });
+  }
+  async removeProject(path) {
+    await this.cloud.client.delete("project-registry", path);
+  }
+  async sendFeedback(input) {
+    await this.cloud.client.create("feedback", {
+      message: input.message,
+      ...input.email ? { email: input.email } : {},
+      category: input.category ?? "general"
+    });
+  }
+}
+function getStore(env = process.env) {
+  const cloud = economyCloudStorage(env);
+  return cloud.active ? new ApiStore(cloud) : new LocalStore;
+}
+function isCloudStore(env = process.env) {
+  return economyCloudStorage(env).active;
+}
+
+export { getStore, isCloudStore };

package/dist/chunks/index-kn5572kd.js

@@ -0,0 +1,124 @@
+// @bun
+import {
+  getServeApiToken
+} from "./index-w3bvv0ns.js";
+import {
+  getStore
+} from "./index-kgy9b6bf.js";
+import {
+  formatReportedUsd,
+  formatSummaryCoverage,
+  formatSummaryValue
+} from "./index-ez9thsr7.js";
+
+// src/cli/commands/tui.ts
+import chalk from "chalk";
+function topAgentFrom(rows) {
+  let top;
+  for (const row of rows) {
+    if (!top || row.cost_usd > top.cost_usd)
+      top = row;
+  }
+  return top?.agent ?? "\u2014";
+}
+function quotaFrom(snapshots) {
+  const claude = snapshots.find((s) => s.agent === "claude" && s.metric === "five_hour_utilization");
+  const codex = snapshots.find((s) => s.agent === "codex" && s.metric === "five_hour_utilization");
+  const parts = [];
+  if (claude)
+    parts.push(`claude ${claude.value.toFixed(0)}%`);
+  if (codex)
+    parts.push(`codex ${codex.value.toFixed(0)}%`);
+  return parts.length ? parts.join(" \xB7 ") : null;
+}
+async function gatherStatusData(store = getStore()) {
+  const [today, week, month, savings, machines, agents, usage] = await Promise.all([
+    store.summary("today"),
+    store.summary("week"),
+    store.summary("month"),
+    store.savings("month"),
+    store.machines(),
+    store.agentBreakdown({ period: "month" }),
+    store.usage("today")
+  ]);
+  return {
+    today,
+    week,
+    month,
+    savings,
+    machineCount: machines.length,
+    topAgent: topAgentFrom(agents),
+    quota: quotaFrom(usage?.snapshots ?? []),
+    transport: store.transport
+  };
+}
+function modeLabel(transport) {
+  return transport === "cloud-http" ? "hosted" : "local";
+}
+function buildStatusLine(data) {
+  const parts = [
+    `today ${formatSummaryValue(data.today)}`,
+    `week ${formatSummaryValue(data.week)}`,
+    `top ${data.topAgent}`,
+    `${data.machineCount} machines`,
+    modeLabel(data.transport),
+    "UTC; stored records only; source coverage unverified"
+  ];
+  if (data.quota)
+    parts.push(data.quota);
+  return parts.join(" \xB7 ");
+}
+function buildWaybarJson(data) {
+  return {
+    text: formatSummaryValue(data.today),
+    tooltip: buildStatusLine(data),
+    class: data.quota?.includes("%") && Number(data.quota.match(/(\d+)%/)?.[1] ?? 0) >= 80 ? "warning" : "default",
+    percentage: null,
+    summary: data.today,
+    summary_coverage: formatSummaryCoverage(data.today),
+    savings_usd: data.savings.saved_usd,
+    comparison_status: data.savings.comparison_status
+  };
+}
+async function printStatusLine() {
+  console.log(buildStatusLine(await gatherStatusData()));
+}
+async function printWaybarJson() {
+  console.log(JSON.stringify(buildWaybarJson(await gatherStatusData())));
+}
+async function runTui(opts) {
+  const interval = opts.interval ?? 30;
+  const render = async () => {
+    const data = await gatherStatusData();
+    process.stdout.write("\x1B[H\x1B[2J");
+    console.log(chalk.bold.cyan("  economy"));
+    console.log(chalk.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+    console.log(`  Today   ${chalk.green(formatSummaryValue(data.today))}   ${data.today.sessions} sessions`);
+    console.log(`  Week    ${formatSummaryValue(data.week)}   ${data.week.sessions} sessions`);
+    console.log(`  Month   ${formatSummaryValue(data.month)}   estimated plan benefit ${formatReportedUsd(data.savings.saved_usd)}`);
+    console.log(chalk.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+    console.log(`  ${formatSummaryCoverage(data.today)}`);
+    console.log(`  Top agent: ${data.topAgent}`);
+    if (data.quota)
+      console.log(`  Quota:     ${data.quota}`);
+    console.log(`  Fleet:     ${data.machineCount} machines`);
+    console.log(`  Store:     ${data.transport === "cloud-http" ? "hosted API" : "local"}`);
+    if (getServeApiToken())
+      console.log(chalk.dim("  API auth:  HASNA_ECONOMY_API_TOKEN set"));
+    console.log(chalk.dim(`
+  ${opts.watch ? `Refreshing every ${interval}s \u2014 Ctrl+C to exit` : "Run with --watch for live refresh"}`));
+  };
+  await render();
+  if (!opts.watch)
+    return;
+  const timer = setInterval(() => {
+    render();
+  }, interval * 1000);
+  process.on("SIGINT", () => {
+    clearInterval(timer);
+    process.exit(0);
+  });
+  await new Promise(() => {});
+}
+
+export { gatherStatusData, buildStatusLine, buildWaybarJson, printStatusLine, printWaybarJson, runTui };

package/dist/chunks/index-p35cyhc4.js

@@ -0,0 +1,4 @@
+// @bun
+var __require = import.meta.require;
+
+export { __require };

package/dist/chunks/index-w3bvv0ns.js

@@ -0,0 +1,26 @@
+// @bun
+// src/lib/serve-auth.ts
+function getServeApiToken() {
+  return process.env["HASNA_ECONOMY_API_TOKEN"];
+}
+function getServeBindHost() {
+  const explicit = process.env["ECONOMY_BIND"] ?? process.env["ECONOMY_HOST"];
+  if (explicit)
+    return explicit;
+  return getServeApiToken() ? "127.0.0.1" : "0.0.0.0";
+}
+function isAuthorizedRequest(req, path) {
+  const token = getServeApiToken();
+  if (!token)
+    return true;
+  if (path === "/health")
+    return true;
+  const auth = req.headers.get("Authorization");
+  if (auth === `Bearer ${token}`)
+    return true;
+  if (req.headers.get("X-Economy-Token") === token)
+    return true;
+  return false;
+}
+
+export { getServeApiToken, getServeBindHost, isAuthorizedRequest };