@phnx-labs/agents-cli 1.21.0 → 1.21.2

package/dist/commands/view.js

@@ -1,6 +1,6 @@
 import { addHostOption } from '../lib/hosts/option.js';
 import chalk from 'chalk';
-import { visibleWidth, termLink } from '../lib/format.js';
+import { termLink } from '../lib/format.js';
 import ora from 'ora';
 import * as fs from 'fs';
 import * as path from 'path';
@@ -31,9 +31,31 @@ import { renderHarnessDetail } from './harness.js';
 import { loadManifest, isStale } from '../lib/staleness/index.js';
 import { confirm } from '@inquirer/prompts';
 import { formatPath, isInteractiveTerminal, isPromptCancelled } from './utils.js';
-import { terminalWidth, truncateToWidth, stringWidth } from '../lib/session/width.js';
+import { terminalWidth, truncateToWidth, stringWidth, padToWidth } from '../lib/session/width.js';
 /** Shared account identity formatter, re-exported for the view-specific tests. */
 export const accountColumnLabel = accountDisplayLabel;
+/**
+ * Overview (`agents view` with no agent filter) caps compact usage windows so
+ * multi-meter agents (Antigravity's four model quotas, Droid's three buckets)
+ * cannot force every row to pad past the terminal width and wrap. Single-agent
+ * views leave the cap unset and show every blocking window.
+ */
+const OVERVIEW_MAX_USAGE_WINDOWS = 2;
+/** Fixed width for the last-active column ("just now", "8h ago", "2d ago"). */
+const LAST_ACTIVE_COL_WIDTH = 10;
+/**
+ * Join fixed view columns with a consistent two-space gutter. Empty trailing
+ * columns are dropped so a row without an auth chip does not grow a dangling
+ * gutter, but interior empties stay padded so later columns stay aligned.
+ */
+export function joinViewColumns(cols) {
+    // Trim only pure-trailing empty strings so auth/status can be absent without
+    // shifting earlier columns for rows that do carry them.
+    let end = cols.length;
+    while (end > 0 && cols[end - 1] === '')
+        end--;
+    return cols.slice(0, end).join('  ');
+}
 /**
  * Custom harnesses (the `~/.agents/profiles/*.yml` bundles), sorted by name and
  * optionally narrowed to the ones that run on one host agent. YAMLs that fail
@@ -246,6 +268,8 @@ async function showInstalledVersions(filterAgentId, viewOpts) {
         : 'Checking installed agents...';
     const spinner = ora({ text: spinnerText, isSilent: !process.stdout.isTTY }).start();
     const agentsToShow = filterAgentId ? [filterAgentId] : ALL_AGENT_IDS;
+    // Overview caps meter count; single-agent view shows every blocking window.
+    const usageWindowCap = filterAgentId ? undefined : OVERVIEW_MAX_USAGE_WINDOWS;
     // A globally-installed CLI is superseded only by a NORMAL managed version — that
     // is when agents-cli owns the launcher and a "global" row would just be our own
     // shim reported back. `--isolated` promises the opposite: no default, no bare
@@ -265,7 +289,6 @@ async function showInstalledVersions(filterAgentId, viewOpts) {
     const cliStates = Object.fromEntries(await Promise.all(agentsToShow
         .filter((agentId) => !hasNonIsolatedVersion(agentId))
         .map(async (agentId) => [agentId, await getUnmanagedCliState(agentId)])));
-    spinner.stop();
     const showPaths = !!filterAgentId;
     const harnesses = getHarnesses(filterAgentId);
     // Auto-heal stale versioned aliases. Pre-v2 aliases (e.g. pre-CLAUDE_CONFIG_DIR
@@ -287,11 +310,15 @@ async function showInstalledVersions(filterAgentId, viewOpts) {
         }
     }
     // Shim healing is silent — users don't need to know about internal repairs
-    console.log(chalk.bold('Installed Agent CLIs\n'));
     const selfHost = machineId();
     // Read the auth-health cache once (not per version row — see the batching note above).
     const authCache = readAuthHealthCache();
-    // Pre-fetch account info for all versions in parallel
+    // Pre-fetch account info for all versions in parallel. Spinner stays up through
+    // account + usage so a multi-account cold path doesn't leave a blank terminal
+    // after "Checking…" vanishes (the hang the screenshots caught).
+    spinner.text = filterAgentId
+        ? `Loading ${agentLabel(filterAgentId)} accounts...`
+        : 'Loading accounts and usage...';
     const infoFetches = [];
     const globalInfoFetches = [];
     for (const agentId of agentsToShow) {
@@ -329,6 +356,7 @@ async function showInstalledVersions(filterAgentId, viewOpts) {
     // or org scope, not a specific installed version. Version homes cache those
     // values independently, so older installs can show stale values. Reuse the
     // freshest cache entry per stable usage identity and keep lastActive per version.
+    // Goes through the unified usage core (SWR cache + concurrency cap + timeout).
     const { canonicalByUsageKey, usageByKey } = await getUsageInfoByIdentity([
         ...infoResults.map(({ agentId, home, version, info }) => ({
             agentId,
@@ -342,6 +370,8 @@ async function showInstalledVersions(filterAgentId, viewOpts) {
             info,
         })),
     ], { forceRefresh: viewOpts?.forceRefresh });
+    spinner.stop();
+    console.log(chalk.bold('Installed Agent CLIs\n'));
     const mergeCanonical = (info) => {
         const key = getUsageLookupKey(info);
         if (!key)
@@ -441,7 +471,8 @@ async function showInstalledVersions(filterAgentId, viewOpts) {
                 }
             }
         }
-        // Second pass: compute max visible usage + status widths (now that maxPlanWidth is settled)
+        // Second pass: compute max visible usage + status widths (now that maxPlanWidth is settled).
+        // stringWidth (not String.length) so chalk + block-bar glyphs pad correctly.
         for (const agentId of versionManaged) {
             const versions = listInstalledVersions(agentId);
             for (const v of versions) {
@@ -451,10 +482,14 @@ async function showInstalledVersions(filterAgentId, viewOpts) {
                 const usageInfo = usageKey ? usageByKey.get(usageKey) : undefined;
                 const usageUnavailable = agentReportsUsage(agentId) && !!info?.signedIn && !usageInfo?.snapshot;
                 const usageUnverified = !!usageInfo?.snapshot && !!usageInfo.error;
-                const usageStr = formatUsageSummary(info?.plan || null, usageInfo?.snapshot || null, maxPlanWidth, { unavailable: usageUnavailable, unverified: usageUnverified });
-                maxUsageWidth = Math.max(maxUsageWidth, visibleWidth(usageStr));
+                const usageStr = formatUsageSummary(info?.plan || null, usageInfo?.snapshot || null, maxPlanWidth, {
+                    unavailable: usageUnavailable,
+                    unverified: usageUnverified,
+                    maxWindows: usageWindowCap,
+                });
+                maxUsageWidth = Math.max(maxUsageWidth, stringWidth(usageStr));
                 const statusStr = formatUsageStatusBadge(info?.usageStatus);
-                maxStatusWidth = Math.max(maxStatusWidth, visibleWidth(statusStr));
+                maxStatusWidth = Math.max(maxStatusWidth, stringWidth(statusStr));
             }
         }
         for (const agentId of versionManaged) {
@@ -496,18 +531,26 @@ async function showInstalledVersions(filterAgentId, viewOpts) {
                 const vInfo = rawInfo ? mergeCanonical(rawInfo) : undefined;
                 const usageKey = getUsageLookupKey(vInfo);
                 const usageInfo = usageKey ? usageByKey.get(usageKey) : undefined;
-                // Build columns, trimming trailing whitespace when columns are empty
+                // Fixed columns for every signed-in row so status / lastActive / auth
+                // stay vertically aligned across agents — even when this row has no
+                // usage bars or no rate-limit badge. Skipping empty columns mid-table
+                // was what made the multi-agent view look unjustified next to
+                // `agents view claude`.
                 const parts = [`    ${label}`];
                 // Configured model — same priority as the version, right beside it.
                 if (maxModelWidth > 0) {
                     const model = modelByKey.get(`${agentId}:${version}`) ?? '';
-                    parts.push(chalk.yellow(model.padEnd(maxModelWidth)));
+                    parts.push(chalk.yellow(padToWidth(model, maxModelWidth)));
                 }
                 const hasEmail = !!vInfo?.email;
                 const signedIn = !!vInfo?.signedIn;
                 const usageUnavailable = agentReportsUsage(agentId) && signedIn && !usageInfo?.snapshot;
                 const usageUnverified = !!usageInfo?.snapshot && !!usageInfo.error;
-                const usageStr = formatUsageSummary(vInfo?.plan || null, usageInfo?.snapshot || null, maxPlanWidth, { unavailable: usageUnavailable, unverified: usageUnverified });
+                const usageStr = formatUsageSummary(vInfo?.plan || null, usageInfo?.snapshot || null, maxPlanWidth, {
+                    unavailable: usageUnavailable,
+                    unverified: usageUnverified,
+                    maxWindows: usageWindowCap,
+                });
                 const hasUsage = usageStr.length > 0;
                 // Only show lastActive for versions with an actual logged-in account.
                 // Otherwise it reflects install time (misleading "just now" for fresh installs).
@@ -534,25 +577,21 @@ async function showInstalledVersions(filterAgentId, viewOpts) {
                         : '(logged out — log in with: ' + loginHint(agentId) + ')'));
                 }
                 else {
-                    if (hasEmail || hasUsage || hasActive || signedIn) {
-                        // Signed-in agents without a local email show their account id
-                        // (Kimi's user_id) or a "signed in" placeholder (Antigravity) so they
-                        // read as logged in, not blank.
-                        const display = accountColumnLabel(vInfo);
-                        const emailCol = display.padEnd(maxEmail);
-                        parts.push(display ? chalk.cyan(emailCol) : ' '.repeat(maxEmail));
-                    }
-                    if (hasUsage || hasActive) {
-                        const usagePad = ' '.repeat(Math.max(0, maxUsageWidth - visibleWidth(usageStr)));
-                        parts.push(usageStr + usagePad);
+                    // Always emit account / usage / status / lastActive columns once any
+                    // signed-in row exists in the table (widths are global). Empty cells
+                    // are space-padded so later columns do not drift left.
+                    const display = accountColumnLabel(vInfo);
+                    parts.push(display ? chalk.cyan(padToWidth(display, maxEmail)) : ' '.repeat(maxEmail));
+                    if (maxUsageWidth > 0) {
+                        parts.push(padToWidth(usageStr, maxUsageWidth));
                     }
-                    const statusStr = formatUsageStatusBadge(vInfo?.usageStatus);
                     if (maxStatusWidth > 0) {
-                        const statusPad = ' '.repeat(Math.max(0, maxStatusWidth - visibleWidth(statusStr)));
-                        parts.push(statusStr + statusPad);
+                        const statusStr = formatUsageStatusBadge(vInfo?.usageStatus);
+                        parts.push(padToWidth(statusStr, maxStatusWidth));
                     }
-                    if (hasActive)
-                        parts.push(activeStr);
+                    // Fixed-width lastActive so the auth chip (●/○/◐) lines up even when
+                    // some rows have no email-derived lastActive.
+                    parts.push(hasActive ? padToWidth(activeStr, LAST_ACTIVE_COL_WIDTH) : ' '.repeat(LAST_ACTIVE_COL_WIDTH));
                 }
                 if (runDefaultBits.length > 0) {
                     parts.push(chalk.gray(`run ${runDefaultBits.join(' ')}`));
@@ -560,7 +599,7 @@ async function showInstalledVersions(filterAgentId, viewOpts) {
                 const authChip = liveAuthChip(authCache, selfHost, agentId, version);
                 if (authChip)
                     parts.push(authChip);
-                console.log(parts.join('  '));
+                console.log(joinViewColumns(parts));
                 if (showPaths) {
                     const versionDir = getVersionDir(agentId, version);
                     console.log(chalk.gray(`      ${versionDir}`));
@@ -586,18 +625,25 @@ async function showInstalledVersions(filterAgentId, viewOpts) {
             const cliState = cliStates[agentId];
             return `${cliState?.version || 'installed'} (global)`.length;
         }));
-        // Pre-pass: max badge width so rows with `lastActive` line up whether or
-        // not THIS row carries a throttle badge. Without this, the row that DOES
-        // have "out of credits" shifts every other row's `lastActive` left by
-        // ~16 chars, exactly what the version-managed block at maxStatusWidth
-        // already solves above.
+        // Pre-pass: max badge/usage/email widths so columns line up the same way
+        // the version-managed block does (stringWidth for chalk-aware padding).
         let gMaxStatusWidth = 0;
+        let gMaxUsageWidth = 0;
+        let gMaxEmail = 0;
         for (const agentId of globallyInstalled) {
             const gInfoRaw = globalInfoMap.get(agentId);
             const gInfo = gInfoRaw ? mergeCanonical(gInfoRaw) : undefined;
-            const w = visibleWidth(formatUsageStatusBadge(gInfo?.usageStatus));
-            if (w > gMaxStatusWidth)
-                gMaxStatusWidth = w;
+            gMaxStatusWidth = Math.max(gMaxStatusWidth, stringWidth(formatUsageStatusBadge(gInfo?.usageStatus)));
+            const gUsageKey = getUsageLookupKey(gInfo);
+            const gUsage = gUsageKey ? usageByKey.get(gUsageKey) : undefined;
+            const gUsageStr = formatUsageSummary(gInfo?.plan || null, gUsage?.snapshot || null, 3, {
+                unverified: !!gUsage?.snapshot && !!gUsage.error,
+                maxWindows: usageWindowCap,
+            });
+            gMaxUsageWidth = Math.max(gMaxUsageWidth, stringWidth(gUsageStr));
+            const gDisplay = accountColumnLabel(gInfo);
+            if (gDisplay)
+                gMaxEmail = Math.max(gMaxEmail, gDisplay.length);
         }
         for (const agentId of globallyInstalled) {
             const agent = AGENTS[agentId];
@@ -613,22 +659,21 @@ async function showInstalledVersions(filterAgentId, viewOpts) {
             const gUsage = gUsageKey ? usageByKey.get(gUsageKey) : undefined;
             const gUsageStr = formatUsageSummary(gInfo?.plan || null, gUsage?.snapshot || null, 3, {
                 unverified: !!gUsage?.snapshot && !!gUsage.error,
+                maxWindows: usageWindowCap,
             });
             const gActiveStr = gInfo ? formatLastActive(gInfo.lastActive) : '';
             if (gInfo?.email || gUsageStr || gActiveStr || gInfo?.signedIn) {
                 const gDisplay = accountColumnLabel(gInfo);
-                parts.push(gDisplay ? chalk.cyan(gDisplay) : '');
+                parts.push(gDisplay ? chalk.cyan(padToWidth(gDisplay, gMaxEmail)) : ' '.repeat(gMaxEmail));
             }
-            if (gUsageStr || gActiveStr)
-                parts.push(gUsageStr);
-            const gStatusStr = formatUsageStatusBadge(gInfo?.usageStatus);
+            if (gMaxUsageWidth > 0)
+                parts.push(padToWidth(gUsageStr, gMaxUsageWidth));
             if (gMaxStatusWidth > 0) {
-                const statusPad = ' '.repeat(Math.max(0, gMaxStatusWidth - visibleWidth(gStatusStr)));
-                parts.push(gStatusStr + statusPad);
+                parts.push(padToWidth(formatUsageStatusBadge(gInfo?.usageStatus), gMaxStatusWidth));
             }
             if (gActiveStr)
-                parts.push(gActiveStr);
-            console.log(parts.join('  '));
+                parts.push(padToWidth(gActiveStr, LAST_ACTIVE_COL_WIDTH));
+            console.log(joinViewColumns(parts));
             if (showPaths && cliState?.path) {
                 console.log(chalk.gray(`      ${cliState.path}`));
             }

package/dist/index.js

@@ -94,7 +94,7 @@ if (IS_DEV_BUILD) {
 // module on each invocation (which loaded the whole ~50-module tree before the
 // first byte of output), the registry maps a command name to a thunk that
 // imports only what that command needs. See src/lib/startup/command-registry.ts.
-import { COMMAND_LOADERS, LAZY_COMMAND_NAMES, loadView, loadInspect, loadFeedback, loadCommands, loadHooks, loadSkills, loadRules, loadMemory, loadPermissions, loadMcp, loadCli, loadSubagents, loadPlugins, loadWorkflows, loadWorktree, loadVersions, loadImport, loadExport, loadPackages, loadRoutines, loadMonitors, loadProjects, loadRun, loadFork, loadDefaults, loadSet, loadModels, loadPrune, loadTrash, loadRestore, loadDoctor, loadApply, loadStatus, loadProfiles, loadHarness, loadSecrets, loadLogin, loadWallet, loadHelper, loadMenubar, loadBeta, loadSync, loadLock, loadRefreshRules, loadFactory, loadUsage, loadCost, loadPerf, loadOutput, loadBudget, loadAlias, loadMine, loadPty, loadTmux, loadWatchdog, loadBrowser, loadComputer, loadHosts, loadLogs, loadEvents, loadAudit, loadWebhook, loadFunnel, loadSsh, loadPull, loadPush, loadRepo, loadSetup, loadUninstall, loadShare, loadSend, loadFeed, loadActivity, loadMailboxes, } from './lib/startup/command-registry.js';
+import { COMMAND_LOADERS, LAZY_COMMAND_NAMES, loadView, loadInspect, loadFeedback, loadCommands, loadHooks, loadSkills, loadRules, loadMemory, loadPermissions, loadMcp, loadCli, loadSubagents, loadPlugins, loadWorkflows, loadWorktree, loadVersions, loadImport, loadExport, loadPackages, loadRoutines, loadMonitors, loadProjects, loadRun, loadFork, loadDefaults, loadSet, loadModels, loadPrune, loadTrash, loadRestore, loadDoctor, loadApply, loadStatus, loadProfiles, loadHarness, loadSecrets, loadLogin, loadWallet, loadHelper, loadMenubar, loadBeta, loadSync, loadLock, loadRefreshRules, loadFactory, loadUsage, loadCost, loadPerf, loadTrends, loadOutput, loadBudget, loadAlias, loadMine, loadPty, loadTmux, loadWatchdog, loadBrowser, loadComputer, loadHosts, loadLogs, loadEvents, loadAudit, loadWebhook, loadFunnel, loadSsh, loadPull, loadPush, loadRepo, loadSetup, loadUninstall, loadShare, loadSend, loadFeed, loadActivity, loadMailboxes, } from './lib/startup/command-registry.js';
 import { applyGlobalHelpConventions } from './lib/help.js';
 import { renderWhatsNew } from './lib/whats-new.js';
 import { getCliLaunch } from './lib/cli-entry.js';
@@ -197,6 +197,18 @@ program.hook('postAction', (_thisCommand, actionCommand) => {
             command,
             ...(durationMs !== undefined ? { durationMs } : {}),
         });
+        if (parts[0] === 'run') {
+            const agentName = actionCommand.args?.[0] ? String(actionCommand.args[0]).split('@')[0] : 'run';
+            void import('./lib/analytics/usage-db.js').then(({ recordUsage }) => {
+                recordUsage({
+                    kind: 'agent',
+                    name: agentName || 'run',
+                    event: 'invoke',
+                    source: 'cli',
+                    meta: durationMs !== undefined ? { durationMs } : undefined,
+                });
+            }).catch(() => { });
+        }
         // Disposable perf warehouse — fail-soft spool append (no SQLite on this path).
         if (durationMs !== undefined && parts[0] !== 'perf') {
             void import('./lib/perf/spool.js').then(({ recordSample }) => {
@@ -933,6 +945,7 @@ async function registerAllEagerCommands() {
     await reg(loadUsage);
     await reg(loadCost);
     await reg(loadPerf);
+    await reg(loadTrends);
     await reg(loadOutput);
     await reg(loadBudget);
     await reg(loadAlias);

package/dist/lib/activity.d.ts

@@ -89,6 +89,12 @@ export interface ActivityEvent {
     tool?: string;
     /** One-line human summary (plan title, PR command, sub-agent role, status text). */
     detail?: string;
+    /**
+     * Short subject for deliberate status posts (`feed post --title`). Phone
+     * broadcasts put this on the first line; `detail` is the body. Optional on
+     * older events that only carried `detail`.
+     */
+    title?: string;
     /** Extracted URL when the event has one (e.g. the opened PR). */
     url?: string;
     /** Auto-stamped process identity for deliberate posts (from pid registry / env). */

package/dist/lib/activity.js

@@ -141,6 +141,7 @@ function parseLine(line) {
             kind: parsed.kind,
             tool: parsed.tool,
             detail: parsed.detail,
+            title: typeof parsed.title === 'string' ? parsed.title : undefined,
             url: parsed.url,
             pid: typeof parsed.pid === 'number' ? parsed.pid : undefined,
             launchId: parsed.launchId,
@@ -398,6 +399,8 @@ export function formatProgressUpdate(ev, opts = {}) {
     ].filter((c) => Boolean(c));
     if (chips.length > 0)
         lines.push(`    ${chalk.gray(chips.join(' · '))}`);
+    if (ev.title)
+        lines.push(`    ${chalk.white.bold(ev.title)}`);
     if (ev.detail)
         lines.push(`    ${chalk.white(`"${ev.detail}"`)}`);
     if (ev.attachments?.length) {

package/dist/lib/agents.js

@@ -1754,8 +1754,8 @@ export async function getAccountInfo(agentId, home) {
     }
 }
 // Fresh window for the cached session walk. Matches USAGE_CACHE_FRESH_MS in
-// usage.ts so a launch storm reuses both probes for the same period.
-const LAST_ACTIVE_CACHE_FRESH_MS = 2 * 60 * 1000;
+// usage.ts (5 minutes) so a launch storm reuses both probes for the same period.
+const LAST_ACTIVE_CACHE_FRESH_MS = 5 * 60 * 1000;
 const getLastActiveCachePath = () => path.join(getCacheDir(), 'last-active.json');
 /**
  * Determine when the agent was last used by checking session file mtimes,

package/dist/lib/analytics/dashboard.d.ts

@@ -0,0 +1,11 @@
+import { RECIPE_IDS, runRecipe, trendsWindow, type RecipeId, type RecipeSection, type TrendsWindow } from './recipes.js';
+export interface TrendsDashboard {
+    window: TrendsWindow;
+    durationMs: number;
+    sections: RecipeSection[];
+}
+export declare function buildTrendsDashboard(opts?: {
+    days?: number;
+    ids?: RecipeId[];
+}): TrendsDashboard;
+export { trendsWindow, runRecipe, RECIPE_IDS, type RecipeId, type RecipeSection };

package/dist/lib/analytics/dashboard.js

@@ -0,0 +1,31 @@
+import { RECIPE_IDS, runRecipe, trendsWindow, } from './recipes.js';
+const DEFAULT_ORDER = [
+    'harness-mix',
+    'model-mix',
+    'session-volume',
+    'token-ratio',
+    'tools-per-session',
+    'secrets-hot',
+    'browser-activity',
+    'resource-mix',
+];
+export function buildTrendsDashboard(opts = {}) {
+    const t0 = Date.now();
+    const win = trendsWindow(opts.days ?? 7);
+    const ids = opts.ids ?? DEFAULT_ORDER;
+    const sections = [];
+    for (const id of ids) {
+        if (!RECIPE_IDS.includes(id))
+            continue;
+        const section = runRecipe(id, win);
+        if (section.empty)
+            continue;
+        sections.push(section);
+    }
+    return {
+        window: win,
+        durationMs: Date.now() - t0,
+        sections,
+    };
+}
+export { trendsWindow, runRecipe, RECIPE_IDS };

package/dist/lib/analytics/recipes.d.ts

@@ -0,0 +1,32 @@
+import { type UsageKind } from './usage-db.js';
+export interface TrendsWindow {
+    days: number;
+    sinceIso: string;
+}
+export interface RecipeSection {
+    id: string;
+    title: string;
+    store: 'sessions' | 'usage';
+    rows: Array<Record<string, string | number | null>>;
+    empty?: boolean;
+}
+export declare function trendsWindow(days: number): TrendsWindow;
+export declare function recipeHarnessMix(win: TrendsWindow): RecipeSection;
+export declare function recipeModelMix(win: TrendsWindow): RecipeSection;
+export declare function recipeToolsPerSession(win: TrendsWindow): RecipeSection;
+export declare function recipeTokenRatio(win: TrendsWindow): RecipeSection;
+export declare function recipeSessionVolume(win: TrendsWindow): RecipeSection;
+export declare function recipeSecretsHot(win: TrendsWindow): RecipeSection;
+export declare function recipeBrowserActivity(win: TrendsWindow): RecipeSection;
+export declare function recipeResourceMix(win: TrendsWindow): RecipeSection;
+export type RecipeId = 'harness-mix' | 'model-mix' | 'tools-per-session' | 'token-ratio' | 'session-volume' | 'secrets-hot' | 'browser-activity' | 'resource-mix';
+export declare const RECIPE_IDS: readonly RecipeId[];
+export declare function runRecipe(id: RecipeId, win: TrendsWindow): RecipeSection;
+export declare function listRecipes(): Array<{
+    id: RecipeId;
+    title: string;
+    store: 'sessions' | 'usage';
+}>;
+export declare function hasSessionsInWindow(win: TrendsWindow): boolean;
+export declare function usageKindsPresent(win: TrendsWindow): UsageKind[];
+export declare function usageEventCount(kind: UsageKind, win: TrendsWindow): number;