Reading your costs

// The last 7 days of events. lastDays is an alternative to { startDate, endDate }.
const page = await bear.usage.events({
  lastDays: 7,
  limit: 100,        // optional (default 100, max 1000)
  offset: 0,         // optional
});
// Query INPUTS are camelCase; response FIELDS are snake_case (1:1 with the API wire).
for (const e of page.events) console.log(e.model, e.input_tokens);
// -> gpt-4o 12
// -> claude-3-5-sonnet 340 ...

const s = await bear.usage.summary({ lastDays: 30 });
console.log(s.total_events, s.total_input_tokens, s.total_output_tokens);
// -> 1240 8460210 2103400

const byModel = await bear.costs.byModel({ lastDays: 30 });
for (const item of byModel.items) {
  console.log(item.attribution_value, item.total_cost, item.percent_of_total);
}
// -> gpt-4o 1284.55 61.2
// -> claude-3-5-sonnet 640.18 30.5
console.log('Total:', byModel.total_cost); // -> Total: 2098.90

// Scope any cost query to one end user by external id.
const user = bear.costs.forUser('user_123');
const summary = await user.summary({ lastDays: 30 });
const byModel = await user.byModel({ lastDays: 30 });

// Break cost down by any custom dimension you tagged events with.
const result = await bear.attribution.byDimension({
  dimension: 'team',
  lastDays: 30,
});
for (const item of result.items) console.log(item.attribution_value, item.total_cost);
// -> growth 1420.30
// -> platform 678.60   ('growth' / 'platform' came from metadata.team at track() time)

// List the agents / workflows that have data in a range:
const { values } = await bear.attribution.agents({ lastDays: 30 });
// -> ['support-triage', 'billing-helper']

// Absolute dates pin an exact reporting window (a calendar month here).
// Every dated reader also accepts { lastDays: n } instead; lastDays is
// resolved client-side into start/end dates before the request is sent.
const result = await bear.margins.summary({ startDate: '2026-01-01', endDate: '2026-01-31' });
console.log(result.summary.margin_percent); // -> 72.4

const byUser = await bear.margins.byEndUser({ startDate: '2026-01-01', endDate: '2026-01-31' });
for (const u of byUser.end_users) console.log(u.end_user_name, u.margin_percent);
// -> acme-corp 81.2
// -> globex 54.9

// insights names its absolute bounds start/end, but lastDays works the same way.
const result = await bear.insights.summary({
  lastDays: 30,
  include: ['distributions'],
  limit: 10,
});
console.log(result.totals.cost.current); // -> 2098.90 (total cost this period)