trucontext 0.8.0 → 0.8.1

package/bin/cli.js

@@ -20,6 +20,7 @@ import { relationshipTypesListCommand } from '../src/commands/relationship-types
 import { docsListCommand, docsShowCommand } from '../src/commands/docs.js';
 import { registerRootsCommand } from '../src/commands/roots.js';
 import { registerCuriosityCommand } from '../src/commands/curiosity.js';
+import { usageCommand, usageHistoryCommand, plansCommand } from '../src/commands/billing.js';
 
 program
   .name('trucontext')
@@ -134,12 +135,6 @@ entities.command('edges <entityId>')
   .description('List edges for an entity')
   .action(entitiesEdgesCommand);
 
-// Root Nodes
-registerRootsCommand(program);
-
-// Curiosity
-registerCuriosityCommand(program);
-
 // Recipes
 const recipes = program.command('recipes').description('Manage recipes').action(function() { this.help(); });
 recipes.command('list')
@@ -185,4 +180,22 @@ const docs = program.command('docs').description('Browse API documentation').act
 docs.command('list').description('List all doc sections').action(docsListCommand);
 docs.command('show <slug>').description('Show a specific doc section').action(docsShowCommand);
 
+// Billing & Usage
+const billing = program.command('billing').description('View usage and billing').action(function() { this.help(); });
+billing.command('usage')
+  .description('View current usage metrics')
+  .option('-p, --period <period>', 'Period: current, today, week, month, year', 'current')
+  .action(usageCommand);
+billing.command('history')
+  .description('View usage history with time series data')
+  .option('-p, --period <period>', 'Period: today, week, month, 6months, year, ytd', 'month')
+  .action(usageHistoryCommand);
+billing.command('plans')
+  .description('View available plans')
+  .action(plansCommand);
+
+// Root nodes + Curiosity (registered as subcommand groups)
+registerRootsCommand(program);
+registerCuriosityCommand(program);
+
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trucontext",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "TruContext CLI — contextual memory for AI applications",
   "type": "module",
   "bin": {

package/src/commands/billing.js

@@ -0,0 +1,134 @@
+// billing.js — Usage and billing commands
+//
+// View API call counts, token usage, storage, and processing time.
+// Data is tracked per-app per-period (daily/monthly).
+
+import chalk from 'chalk';
+import { controlPlane } from '../client.js';
+import { getActiveApp } from '../config.js';
+
+function requireApp() {
+  const appId = getActiveApp();
+  if (!appId) {
+    console.error(chalk.red('No active app. Run: trucontext use <app>'));
+    process.exit(1);
+  }
+  return appId;
+}
+
+function formatNumber(n) {
+  if (n === null || n === undefined) return '0';
+  if (n >= 1_000_000) return `${(n / 1_000_000).toFixed(1)}M`;
+  if (n >= 1_000) return `${(n / 1_000).toFixed(1)}K`;
+  return String(n);
+}
+
+function formatBytes(bytes) {
+  if (!bytes) return '0 B';
+  if (bytes >= 1_073_741_824) return `${(bytes / 1_073_741_824).toFixed(1)} GB`;
+  if (bytes >= 1_048_576) return `${(bytes / 1_048_576).toFixed(1)} MB`;
+  if (bytes >= 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+  return `${bytes} B`;
+}
+
+function formatMs(ms) {
+  if (!ms) return '0.0 min';
+  if (ms >= 60_000) return `${(ms / 60_000).toFixed(1)} min`;
+  return `${(ms / 1000).toFixed(1)} sec`;
+}
+
+export async function usageCommand(options) {
+  try {
+    const appId = requireApp();
+    const period = options.period || 'current';
+    const res = await controlPlane('GET', `/billing/usage/${appId}?period=${period}`);
+    const usage = res.data?.data || res.data || {};
+
+    if (!usage || (!usage.apiCalls && !usage.llmInputTokens && !usage.processingMs)) {
+      console.log(chalk.yellow('No usage data available.'));
+      return;
+    }
+
+    console.log(chalk.bold('Usage Summary') + chalk.dim(` — ${period}`));
+    console.log();
+    console.log(`  API Calls:    ${chalk.bold(formatNumber(usage.apiCalls || 0))}${usage.limits?.apiCalls ? chalk.dim(` of ${formatNumber(usage.limits.apiCalls)}`) : ''}`);
+    console.log(`  Tokens:       ${chalk.bold(formatNumber((usage.llmInputTokens || 0) + (usage.llmOutputTokens || 0)))}${usage.limits?.llmTokens ? chalk.dim(` of ${formatNumber(usage.limits.llmTokens)}`) : ''}`);
+    console.log(`    Input:      ${chalk.dim(formatNumber(usage.llmInputTokens || 0))}`);
+    console.log(`    Output:     ${chalk.dim(formatNumber(usage.llmOutputTokens || 0))}`);
+    console.log(`  Compute Units: ${chalk.bold(formatNumber(usage.computeUnits || 0))}`);
+    console.log(`  Storage:      ${chalk.bold(formatBytes(usage.storageBytes || 0))}${usage.limits?.storageGb ? chalk.dim(` of ${usage.limits.storageGb} GB`) : ''}`);
+    console.log(`  Processing:   ${chalk.bold(formatMs(usage.processingMs || 0))}${usage.limits?.processingMinutes ? chalk.dim(` of ${usage.limits.processingMinutes} min`) : ''}`);
+
+    if (usage.planTier) {
+      console.log();
+      console.log(`  Plan:         ${chalk.cyan(usage.planTier)}`);
+    }
+  } catch (err) {
+    console.error(chalk.red(`Failed: ${err.message}`));
+    process.exit(1);
+  }
+}
+
+export async function usageHistoryCommand(options) {
+  try {
+    const appId = requireApp();
+    const period = options.period || 'month';
+    const res = await controlPlane('GET', `/billing/usage/${appId}/history?period=${period}&sources=true`);
+    const historyData = res.data?.data || res.data || {};
+    const history = historyData.history || [];
+
+    if (history.length === 0) {
+      console.log(chalk.yellow(`No usage history for period: ${period}`));
+      return;
+    }
+
+    console.log(chalk.bold(`Usage History`) + chalk.dim(` — ${period} (${history.length} entries)`));
+    console.log();
+    console.log(chalk.dim('  Date              API Calls   Tokens      Source'));
+    console.log(chalk.dim('  ────              ─────────   ──────      ──────'));
+
+    for (const entry of history) {
+      const date = entry.date || entry.period || '—';
+      const calls = formatNumber(entry.apiCalls || 0);
+      const tokens = formatNumber((entry.inputTokens || 0) + (entry.outputTokens || 0));
+      const source = entry.source || '—';
+      console.log(`  ${date.padEnd(18)} ${calls.padEnd(12)} ${tokens.padEnd(12)} ${chalk.dim(source)}`);
+    }
+  } catch (err) {
+    console.error(chalk.red(`Failed: ${err.message}`));
+    process.exit(1);
+  }
+}
+
+export async function plansCommand() {
+  try {
+    const res = await controlPlane('GET', '/billing/plans');
+    const plansData = res.data?.data || res.data || {};
+    const plans = plansData.plans || [];
+
+    if (plans.length === 0) {
+      console.log(chalk.yellow('No plans available.'));
+      return;
+    }
+
+    console.log(chalk.bold('Available Plans'));
+    console.log();
+
+    for (const plan of plans) {
+      const current = plan.current ? chalk.green(' (current)') : '';
+      console.log(`  ${chalk.bold(plan.name || plan.tier)}${current}`);
+      if (plan.price) console.log(`    Price: ${plan.price}`);
+      if (plan.description) console.log(`    ${chalk.dim(plan.description)}`);
+      if (plan.limits) {
+        const limits = plan.limits;
+        if (limits.apiCalls) console.log(`    API Calls: ${formatNumber(limits.apiCalls)}/mo`);
+        if (limits.tokens) console.log(`    Tokens: ${formatNumber(limits.tokens)}/mo`);
+        if (limits.storageBytes) console.log(`    Storage: ${formatBytes(limits.storageBytes)}`);
+      }
+      console.log();
+    }
+  } catch (err) {
+    console.error(chalk.red(`Failed: ${err.message}`));
+    process.exit(1);
+  }
+}