agentic-insights 0.1.1

package/README.md

@@ -0,0 +1,44 @@
+# Agentic Insights
+
+`agentic-insights` launches a local dashboard that reads your Codex and Claude Code usage artifacts and helps you understand coding-agent usage, starting with water-impact estimates.
+
+## Run
+
+```bash
+npx agentic-insights@0.1.1
+```
+
+That command starts a local server, opens the dashboard in your browser, and reads usage data from your machine.
+
+You can also install a reusable command:
+
+```bash
+npm install -g agentic-insights
+agentic-insights
+```
+
+## Useful flags
+
+```bash
+agentic-insights --port 3001
+agentic-insights --host 127.0.0.1
+agentic-insights --codex-home /path/to/.codex
+agentic-insights --no-open
+```
+
+## Data source
+
+By default the app reads local Codex artifacts from:
+
+- `~/.codex/sessions`
+- `~/.codex/archived_sessions`
+- `~/.codex/log/codex-tui.log`
+- `~/.claude/projects`
+- `~/.claude/usage-data/session-meta`
+
+Override the Codex location with `--codex-home` or `CODEX_HOME=/path/to/.codex`. Claude Code usage is read from the default `~/.claude` home for the current user.
+
+## Repository
+
+- Source: https://github.com/max-stoddard/agentic-insights
+- Issues: https://github.com/max-stoddard/agentic-insights/issues

package/dist/args.d.ts

@@ -0,0 +1,11 @@
+export interface CliOptions {
+    codexHome: string | null;
+    help: boolean;
+    host: string;
+    openBrowser: boolean;
+    preferredPort: number;
+}
+export declare class CliArgumentError extends Error {
+}
+export declare function getHelpText(): string;
+export declare function parseCliArgs(argv: string[]): CliOptions;

package/dist/args.js

@@ -0,0 +1,71 @@
+const HELP_TEXT = `Agentic Insights
+
+Usage:
+  agentic-insights [options]
+
+Options:
+  --port <number>        Preferred local port (default: 3001)
+  --host <host>          Host to bind the local server to (default: 127.0.0.1)
+  --codex-home <path>    Override the Codex home directory
+  --no-open              Do not open the browser automatically
+  --help                 Show this help text
+`;
+export class CliArgumentError extends Error {
+}
+function parsePort(value) {
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isInteger(parsed) || parsed < 1 || parsed > 65_535) {
+        throw new CliArgumentError(`Invalid port: ${value}`);
+    }
+    return parsed;
+}
+function requireValue(flag, value) {
+    if (!value) {
+        throw new CliArgumentError(`Missing value for ${flag}`);
+    }
+    return value;
+}
+export function getHelpText() {
+    return HELP_TEXT;
+}
+export function parseCliArgs(argv) {
+    const options = {
+        codexHome: null,
+        help: false,
+        host: "127.0.0.1",
+        openBrowser: true,
+        preferredPort: 3001
+    };
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+        if (!arg) {
+            continue;
+        }
+        if (arg === "--help") {
+            options.help = true;
+            continue;
+        }
+        if (arg === "--no-open") {
+            options.openBrowser = false;
+            continue;
+        }
+        if (arg === "--port") {
+            options.preferredPort = parsePort(requireValue(arg, argv[index + 1]));
+            index += 1;
+            continue;
+        }
+        if (arg === "--host") {
+            options.host = requireValue(arg, argv[index + 1]);
+            index += 1;
+            continue;
+        }
+        if (arg === "--codex-home") {
+            options.codexHome = requireValue(arg, argv[index + 1]);
+            index += 1;
+            continue;
+        }
+        throw new CliArgumentError(`Unknown argument: ${arg}`);
+    }
+    return options;
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA,MAAM,SAAS,GAAG;;;;;;;;;;;CAWjB,CAAC;AAUF,MAAM,OAAO,gBAAiB,SAAQ,KAAK;CAAG;AAE9C,SAAS,SAAS,CAAC,KAAa;IAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,MAAM,EAAE,CAAC;QAC/D,MAAM,IAAI,gBAAgB,CAAC,iBAAiB,KAAK,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,YAAY,CAAC,IAAY,EAAE,KAAyB;IAC3D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,gBAAgB,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAc;IACzC,MAAM,OAAO,GAAe;QAC1B,SAAS,EAAE,IAAI;QACf,IAAI,EAAE,KAAK;QACX,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,IAAI;QACjB,aAAa,EAAE,IAAI;KACpB,CAAC;IAEF,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAExB,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,SAAS;QACX,CAAC;QAED,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;YACpB,SAAS;QACX,CAAC;QAED,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YACxB,OAAO,CAAC,WAAW,GAAG,KAAK,CAAC;YAC5B,SAAS;QACX,CAAC;QAED,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACrB,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACtE,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QAED,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,GAAG,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;YAClD,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QAED,IAAI,GAAG,KAAK,cAAc,EAAE,CAAC;YAC3B,OAAO,CAAC,SAAS,GAAG,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;YACvD,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QAED,MAAM,IAAI,gBAAgB,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/browser.d.ts

@@ -0,0 +1,6 @@
+export interface BrowserLaunchSpec {
+    args: string[];
+    command: string;
+}
+export declare function getBrowserLaunchSpec(url: string, platform?: NodeJS.Platform): BrowserLaunchSpec | null;
+export declare function openBrowser(url: string, platform?: NodeJS.Platform): Promise<boolean>;

package/dist/browser.js

@@ -0,0 +1,42 @@
+import { spawn } from "node:child_process";
+export function getBrowserLaunchSpec(url, platform = process.platform) {
+    switch (platform) {
+        case "darwin":
+            return {
+                command: "open",
+                args: [url]
+            };
+        case "win32":
+            return {
+                command: "cmd",
+                args: ["/c", "start", "", url]
+            };
+        case "linux":
+            return {
+                command: "xdg-open",
+                args: [url]
+            };
+        default:
+            return null;
+    }
+}
+export async function openBrowser(url, platform = process.platform) {
+    const spec = getBrowserLaunchSpec(url, platform);
+    if (!spec) {
+        return false;
+    }
+    return new Promise((resolve) => {
+        const child = spawn(spec.command, spec.args, {
+            detached: true,
+            stdio: "ignore"
+        });
+        child.once("error", () => {
+            resolve(false);
+        });
+        child.once("spawn", () => {
+            child.unref();
+            resolve(true);
+        });
+    });
+}
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAO3C,MAAM,UAAU,oBAAoB,CAAC,GAAW,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ;IAC3E,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO;gBACL,OAAO,EAAE,MAAM;gBACf,IAAI,EAAE,CAAC,GAAG,CAAC;aACZ,CAAC;QACJ,KAAK,OAAO;YACV,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC;aAC/B,CAAC;QACJ,KAAK,OAAO;YACV,OAAO;gBACL,OAAO,EAAE,UAAU;gBACnB,IAAI,EAAE,CAAC,GAAG,CAAC;aACZ,CAAC;QACJ;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAW,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ;IACxE,MAAM,IAAI,GAAG,oBAAoB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACjD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE;YAC3C,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC;QAEH,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;YACvB,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;YACvB,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,3 @@
+export declare function resolveCodexHome(cliValue: string | null, envValue: string | undefined): string;
+export declare function resolveBrowserHost(host: string): string;
+export declare function formatUrl(host: string, port: number): string;

package/dist/config.js

@@ -0,0 +1,17 @@
+import os from "node:os";
+import path from "node:path";
+export function resolveCodexHome(cliValue, envValue) {
+    const selected = cliValue ?? envValue ?? path.join(os.homedir(), ".codex");
+    return path.resolve(selected);
+}
+export function resolveBrowserHost(host) {
+    if (host === "0.0.0.0" || host === "::" || host === "[::]") {
+        return "127.0.0.1";
+    }
+    return host;
+}
+export function formatUrl(host, port) {
+    const normalizedHost = host.includes(":") && !host.startsWith("[") ? `[${host}]` : host;
+    return `http://${normalizedHost}:${port}`;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,UAAU,gBAAgB,CAAC,QAAuB,EAAE,QAA4B;IACpF,MAAM,QAAQ,GAAG,QAAQ,IAAI,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC3E,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3D,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,IAAY;IAClD,MAAM,cAAc,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IACxF,OAAO,UAAU,cAAc,IAAI,IAAI,EAAE,CAAC;AAC5C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+import path from "node:path";
+import process from "node:process";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { CliArgumentError, getHelpText, parseCliArgs } from "./args.js";
+import { openBrowser } from "./browser.js";
+import { formatUrl, resolveBrowserHost, resolveCodexHome } from "./config.js";
+import { findAvailablePort } from "./port.js";
+function getRuntimeDir() {
+    const currentFile = fileURLToPath(import.meta.url);
+    return path.resolve(path.dirname(currentFile), "runtime");
+}
+async function loadRuntimeModule() {
+    const runtimeModuleUrl = pathToFileURL(path.join(getRuntimeDir(), "server", "app.js")).href;
+    return import(runtimeModuleUrl);
+}
+async function run() {
+    const options = parseCliArgs(process.argv.slice(2));
+    if (options.help) {
+        console.log(getHelpText());
+        return;
+    }
+    const codexHome = resolveCodexHome(options.codexHome, process.env.CODEX_HOME);
+    process.env.CODEX_HOME = codexHome;
+    const selectedPort = await findAvailablePort(options.host, options.preferredPort);
+    const { createApp } = await loadRuntimeModule();
+    const app = createApp({
+        webDistDir: path.join(getRuntimeDir(), "web")
+    });
+    let shuttingDown = false;
+    const shutdown = async (signal) => {
+        if (shuttingDown) {
+            return;
+        }
+        shuttingDown = true;
+        console.log(`\nReceived ${signal}. Shutting down Agentic Insights...`);
+        await app.close();
+        process.exit(0);
+    };
+    process.once("SIGINT", () => {
+        void shutdown("SIGINT");
+    });
+    process.once("SIGTERM", () => {
+        void shutdown("SIGTERM");
+    });
+    await app.listen({ host: options.host, port: selectedPort });
+    const browserHost = resolveBrowserHost(options.host);
+    const url = formatUrl(browserHost, selectedPort);
+    console.log(`Agentic Insights is running at ${url}`);
+    console.log(`Reading Codex usage from ${codexHome}`);
+    if (selectedPort !== options.preferredPort) {
+        console.log(`Port ${options.preferredPort} was unavailable. Using ${selectedPort} instead.`);
+    }
+    if (options.openBrowser) {
+        const opened = await openBrowser(url);
+        if (!opened) {
+            console.log("Could not open your browser automatically. Open the URL above manually.");
+        }
+    }
+    else {
+        console.log("Browser auto-open disabled.");
+    }
+    console.log("Press Ctrl+C to stop the local dashboard.");
+}
+run().catch((error) => {
+    if (error instanceof CliArgumentError) {
+        console.error(error.message);
+        console.error("");
+        console.error(getHelpText());
+        process.exit(1);
+    }
+    const message = error instanceof Error ? error.message : "Unknown launcher error";
+    console.error(`Failed to start Agentic Insights: ${message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/port.d.ts

@@ -0,0 +1,2 @@
+export type PortAvailabilityProbe = (host: string, port: number) => Promise<boolean>;
+export declare function findAvailablePort(host: string, preferredPort: number, maxAttempts?: number, probe?: PortAvailabilityProbe): Promise<number>;

package/dist/port.js

@@ -0,0 +1,38 @@
+import net from "node:net";
+function isRetryablePortError(error) {
+    if (!error || typeof error !== "object" || !("code" in error)) {
+        return false;
+    }
+    const code = error.code;
+    return code === "EADDRINUSE" || code === "EACCES";
+}
+function canListen(host, port) {
+    return new Promise((resolve, reject) => {
+        const server = net.createServer();
+        server.once("error", (error) => {
+            server.close();
+            if (isRetryablePortError(error)) {
+                resolve(false);
+                return;
+            }
+            reject(error);
+        });
+        server.once("listening", () => {
+            server.close(() => resolve(true));
+        });
+        server.listen(port, host);
+    });
+}
+export async function findAvailablePort(host, preferredPort, maxAttempts = 25, probe = canListen) {
+    for (let offset = 0; offset < maxAttempts; offset += 1) {
+        const candidate = preferredPort + offset;
+        if (candidate > 65_535) {
+            break;
+        }
+        if (await probe(host, candidate)) {
+            return candidate;
+        }
+    }
+    throw new Error(`Could not find an available port starting from ${preferredPort}.`);
+}
+//# sourceMappingURL=port.js.map

package/dist/port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.js","sourceRoot":"","sources":["../src/port.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,UAAU,CAAC;AAI3B,SAAS,oBAAoB,CAAC,KAAc;IAC1C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,EAAE,CAAC;QAC9D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,IAAI,GAAI,KAA2B,CAAC,IAAI,CAAC;IAC/C,OAAO,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,QAAQ,CAAC;AACpD,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,IAAY;IAC3C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC;QAElC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC7B,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;gBAChC,OAAO,CAAC,KAAK,CAAC,CAAC;gBACf,OAAO;YACT,CAAC;YAED,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;YAC5B,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAY,EACZ,aAAqB,EACrB,WAAW,GAAG,EAAE,EAChB,QAA+B,SAAS;IAExC,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC;QACvD,MAAM,SAAS,GAAG,aAAa,GAAG,MAAM,CAAC;QACzC,IAAI,SAAS,GAAG,MAAM,EAAE,CAAC;YACvB,MAAM;QACR,CAAC;QAED,IAAI,MAAM,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;YACjC,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,kDAAkD,aAAa,GAAG,CAAC,CAAC;AACtF,CAAC"}

package/dist/runtime/node_modules/@agentic-insights/shared/index.d.ts

@@ -0,0 +1,159 @@
+export type Bucket = "day" | "week" | "month";
+export interface WaterRange {
+    low: number;
+    central: number;
+    high: number;
+}
+export interface TokenTotals {
+    totalTokens: number;
+    supportedTokens: number;
+    excludedTokens: number;
+    unestimatedTokens: number;
+}
+export interface CoverageCounts {
+    supportedEvents: number;
+    excludedEvents: number;
+    tokenOnlyEvents: number;
+}
+export interface CoverageSummary {
+    sessions: number;
+    prompts: number;
+    excludedModels: number;
+}
+export interface WeeklyGrowthMetric {
+    current: number;
+    previous: number;
+    increase: number;
+}
+export interface WeeklyGrowthSummary {
+    sessions: WeeklyGrowthMetric;
+    prompts: WeeklyGrowthMetric;
+    tokens: WeeklyGrowthMetric;
+}
+export type ModelUsageStatus = "allowed" | "unknown" | "local";
+export interface ModelUsageEntry {
+    provider: string;
+    model: string;
+    totalTokens: number;
+    events: number;
+    supportedTokens: number;
+    excludedTokens: number;
+    unestimatedTokens: number;
+    status: ModelUsageStatus;
+    statusNote: string | null;
+}
+export type CoverageClassification = "supported" | "excluded" | "token_only";
+export interface CoverageDetail {
+    provider: string;
+    model: string;
+    source: string;
+    tokens: number;
+    events: number;
+    classification: CoverageClassification;
+    reason: string | null;
+}
+export interface ExclusionSummary {
+    provider: string;
+    model: string;
+    source: string;
+    tokens: number;
+    events: number;
+    reason: string;
+}
+export interface CalibrationSnapshot {
+    referenceEventCostUsd: number;
+    computedAt: number;
+    supportedEventCount: number;
+    supportedMedianSource: string;
+}
+export type DiagnosticsState = "ready" | "no_data" | "read_error" | "indexing";
+export type IndexingPhase = "discovering" | "parsing" | "estimating" | "finalizing";
+export interface IndexingStatus {
+    phase: IndexingPhase;
+    startedAt: number;
+    updatedAt: number;
+}
+export interface OverviewDiagnostics {
+    state: DiagnosticsState;
+    codexHome: string;
+    message: string | null;
+}
+export interface OverviewResponse {
+    tokenTotals: TokenTotals;
+    waterLitres: WaterRange;
+    coverage: CoverageCounts;
+    coverageSummary: CoverageSummary;
+    weeklyGrowth: WeeklyGrowthSummary;
+    modelUsage: ModelUsageEntry[];
+    coverageDetails: CoverageDetail[];
+    exclusions: ExclusionSummary[];
+    lastIndexedAt: number | null;
+    calibration: CalibrationSnapshot | null;
+    indexing: IndexingStatus | null;
+    diagnostics: OverviewDiagnostics;
+}
+export interface TimeseriesPoint {
+    startTs: number;
+    key: string;
+    label: string;
+    tokens: number;
+    excludedTokens: number;
+    unestimatedTokens: number;
+    waterLitres: WaterRange;
+}
+export interface TimeseriesResponse {
+    bucket: Bucket;
+    points: TimeseriesPoint[];
+}
+export interface PricingEntry {
+    provider: string;
+    model: string;
+    inputUsdPerMillion: number;
+    cachedInputUsdPerMillion: number;
+    outputUsdPerMillion: number;
+    sourceUrl: string;
+    sourceLabel: string;
+}
+export type MethodologyTabId = "prompts" | "water" | "energy" | "carbon";
+export interface MethodologySourceLink {
+    label: string;
+    url: string;
+}
+export type WaterComparisonType = "direct_intake" | "embedded_footprint" | "operational_use";
+export interface WaterScaleComparison {
+    id: "cup-of-water" | "person-per-day" | "coffee" | "jeans" | "manufacturing-a-car" | "golf-course-daily";
+    label: string;
+    litres: number;
+    comparisonType: WaterComparisonType;
+    description: string;
+    sourceLabel: string;
+    sourceUrl: string;
+    sourceNote?: string;
+    singularLabel?: string;
+    pluralLabel?: string;
+}
+export interface WaterProductEquivalent extends WaterScaleComparison {
+    singularLabel: string;
+    pluralLabel: string;
+}
+export declare const WATER_SCALE_COMPARISONS: readonly WaterScaleComparison[];
+export declare const WATER_PRODUCT_EQUIVALENTS: readonly WaterProductEquivalent[];
+export interface PricingCatalogMetadata {
+    generatedAt: string;
+    sourceRepoUrl: string;
+    sourceDirectoryUrl: string;
+    licenseUrl: string;
+    providerCount: number;
+    modelCount: number;
+}
+export interface MethodologyResponse {
+    pricingTable: PricingEntry[];
+    benchmarkCoefficients: WaterRange;
+    calibration: CalibrationSnapshot | null;
+    exclusions: ExclusionSummary[];
+    pricingCatalog: PricingCatalogMetadata;
+    sourcesByTab: Record<MethodologyTabId, MethodologySourceLink[]>;
+}
+export interface ErrorResponse {
+    error: string;
+}

package/dist/runtime/node_modules/@agentic-insights/shared/index.js

@@ -0,0 +1,70 @@
+export const WATER_SCALE_COMPARISONS = [
+    {
+        id: "cup-of-water",
+        label: "A cup of water",
+        litres: 0.24,
+        comparisonType: "direct_intake",
+        description: "The volume of one metric cup of drinking water.",
+        sourceLabel: "NIST Metric Kitchen: Cooking Measurement Equivalencies",
+        sourceUrl: "https://www.nist.gov/pml/owm/metric-kitchen-cooking-measurement-equivalencies",
+        sourceNote: "Uses NIST's 1 cup = 240 mL conversion."
+    },
+    {
+        id: "person-per-day",
+        label: "A daily intake",
+        litres: 2.25,
+        comparisonType: "direct_intake",
+        description: "A representative daily adult drinking-water intake from fluids.",
+        sourceLabel: "EFSA Dietary Reference Values for Water",
+        sourceUrl: "https://www.efsa.europa.eu/en/efsajournal/pub/1459",
+        sourceNote: "Midpoint of EFSA adult adequate intakes: 2.0 L/day for females and 2.5 L/day for males."
+    },
+    {
+        id: "coffee",
+        label: "A cup of coffee",
+        litres: 140,
+        comparisonType: "embedded_footprint",
+        description: "The embedded freshwater footprint associated with one cup of coffee.",
+        sourceLabel: "Ecological Economics DOI: The water footprint of coffee and tea consumption in the Netherlands",
+        sourceUrl: "https://doi.org/10.1016/j.ecolecon.2007.02.022",
+        sourceNote: "Represents the study's published water footprint per cup of coffee.",
+        singularLabel: "cup of coffee",
+        pluralLabel: "cups of coffee"
+    },
+    {
+        id: "jeans",
+        label: "A pair of jeans",
+        litres: 3781,
+        comparisonType: "embedded_footprint",
+        description: "The embedded freshwater footprint for one pair of denim jeans.",
+        sourceLabel: "Sustainability Science DOI: Comparing ecological and water footprint of denim jeans and a tri-blend T-shirt",
+        sourceUrl: "https://doi.org/10.1007/s11625-022-01131-0",
+        sourceNote: "Uses the study's published footprint for a pair of denim jeans.",
+        singularLabel: "pair of jeans",
+        pluralLabel: "pairs of jeans"
+    },
+    {
+        id: "manufacturing-a-car",
+        label: "A car",
+        litres: 67500,
+        comparisonType: "operational_use",
+        description: "A lifecycle water-consumption estimate for a European passenger car.",
+        sourceLabel: "Environmental Science & Technology DOI: Water Footprint of European Cars: Potential Impacts of Water Consumption along Automobile Life Cycles",
+        sourceUrl: "https://doi.org/10.1021/es2040043",
+        sourceNote: "Uses the midpoint of the study's 52–83 m³/car range. The paper reports that more than 95% occurs in the production phase."
+    },
+    {
+        id: "golf-course-daily",
+        label: "A golf course per day",
+        litres: 515000,
+        comparisonType: "operational_use",
+        description: "Approximate daily irrigation-scale water use for an average 18-hole U.S. golf course.",
+        sourceLabel: "GCSAA Golf Course Environmental Profile: Phase II Water Use and Conservation Practices on U.S. Golf Courses",
+        sourceUrl: "https://www.gcsaa.org/docs/default-source/Environment/phase-2-water-use-survey-full-report.pdf?sfvrsn=2b39123e_4",
+        sourceNote: "Derived as about 515,000 L/day from the 152.5 acre-feet/year 18-hole facility average used in GCSAA profile summaries."
+    }
+];
+export const WATER_PRODUCT_EQUIVALENTS = WATER_SCALE_COMPARISONS.filter((comparison) => (comparison.id === "coffee" || comparison.id === "jeans") &&
+    comparison.singularLabel !== undefined &&
+    comparison.pluralLabel !== undefined);
+//# sourceMappingURL=index.js.map

package/dist/runtime/node_modules/@agentic-insights/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA0KA,MAAM,CAAC,MAAM,uBAAuB,GAAoC;IACtE;QACE,EAAE,EAAE,cAAc;QAClB,KAAK,EAAE,gBAAgB;QACvB,MAAM,EAAE,IAAI;QACZ,cAAc,EAAE,eAAe;QAC/B,WAAW,EAAE,iDAAiD;QAC9D,WAAW,EAAE,wDAAwD;QACrE,SAAS,EAAE,+EAA+E;QAC1F,UAAU,EAAE,wCAAwC;KACrD;IACD;QACE,EAAE,EAAE,gBAAgB;QACpB,KAAK,EAAE,gBAAgB;QACvB,MAAM,EAAE,IAAI;QACZ,cAAc,EAAE,eAAe;QAC/B,WAAW,EAAE,iEAAiE;QAC9E,WAAW,EAAE,yCAAyC;QACtD,SAAS,EAAE,oDAAoD;QAC/D,UAAU,EAAE,yFAAyF;KACtG;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,iBAAiB;QACxB,MAAM,EAAE,GAAG;QACX,cAAc,EAAE,oBAAoB;QACpC,WAAW,EAAE,sEAAsE;QACnF,WAAW,EAAE,gGAAgG;QAC7G,SAAS,EAAE,gDAAgD;QAC3D,UAAU,EAAE,qEAAqE;QACjF,aAAa,EAAE,eAAe;QAC9B,WAAW,EAAE,gBAAgB;KAC9B;IACD;QACE,EAAE,EAAE,OAAO;QACX,KAAK,EAAE,iBAAiB;QACxB,MAAM,EAAE,IAAI;QACZ,cAAc,EAAE,oBAAoB;QACpC,WAAW,EAAE,gEAAgE;QAC7E,WAAW,EAAE,6GAA6G;QAC1H,SAAS,EAAE,4CAA4C;QACvD,UAAU,EAAE,iEAAiE;QAC7E,aAAa,EAAE,eAAe;QAC9B,WAAW,EAAE,gBAAgB;KAC9B;IACD;QACE,EAAE,EAAE,qBAAqB;QACzB,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,KAAK;QACb,cAAc,EAAE,iBAAiB;QACjC,WAAW,EAAE,sEAAsE;QACnF,WAAW,EAAE,+IAA+I;QAC5J,SAAS,EAAE,mCAAmC;QAC9C,UAAU,EAAE,2HAA2H;KACxI;IACD;QACE,EAAE,EAAE,mBAAmB;QACvB,KAAK,EAAE,uBAAuB;QAC9B,MAAM,EAAE,MAAM;QACd,cAAc,EAAE,iBAAiB;QACjC,WAAW,EAAE,uFAAuF;QACpG,WAAW,EAAE,6GAA6G;QAC1H,SAAS,EAAE,kHAAkH;QAC7H,UAAU,EAAE,wHAAwH;KACrI;CACO,CAAC;AAEX,MAAM,CAAC,MAAM,yBAAyB,GAAsC,uBAAuB,CAAC,MAAM,CACxG,CAAC,UAAU,EAAwC,EAAE,CACnD,CAAC,UAAU,CAAC,EAAE,KAAK,QAAQ,IAAI,UAAU,CAAC,EAAE,KAAK,OAAO,CAAC;IACzD,UAAU,CAAC,aAAa,KAAK,SAAS;IACtC,UAAU,CAAC,WAAW,KAAK,SAAS,CACvC,CAAC"}

package/dist/runtime/node_modules/@agentic-insights/shared/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@agentic-insights/shared",
+  "private": true,
+  "type": "module",
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./index.js"
+    }
+  }
+}

package/dist/runtime/server/aggregation.d.ts

@@ -0,0 +1,5 @@
+import type { Bucket, TimeseriesPoint } from "@agentic-insights/shared";
+import type { ClassifiedUsageEvent } from "./types.js";
+export declare function aggregateDayTimeseries(events: ClassifiedUsageEvent[], timeZone: string): TimeseriesPoint[];
+export declare function aggregateFromDayBuckets(dayPoints: TimeseriesPoint[], bucket: Bucket, timeZone: string): TimeseriesPoint[];
+export declare function aggregateTimeseries(events: ClassifiedUsageEvent[], bucket: Bucket, timeZone: string): TimeseriesPoint[];