@knpkv/agent-usage 0.1.0

package/dist/main.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+/**
+ * `agent-usage` — record Claude and Codex usage on this Machine and show it in a browser.
+ *
+ * - `agent-usage serve` ingests every minute, polls Claude limits every five, and prints the URL
+ *   that gets you in.
+ * - `agent-usage ingest [--json]` runs one ingest pass and reports what it found.
+ *
+ * @module
+ */
+import { NodeRuntime, NodeServices } from "@effect/platform-node";
+import { Console, Deferred, Effect, Fiber, Layer, Option, Schema } from "effect";
+import { Command, Flag } from "effect/cli";
+import * as Stdio from "effect/Stdio";
+import * as Stream from "effect/Stream";
+import { hostname } from "node:os";
+import { databaseLayer } from "./core/Database.js";
+import { ingestOnce } from "./core/Ingest.js";
+import { loadConfig } from "./server/Config.js";
+import { makeOwnerSessionSecrets, ownerSessionOrigin, ownerSessionUrl } from "./server/OwnerSession.js";
+import { makeServer, Port, PublicOrigin } from "./server/Server.js";
+import { IngestStatus as IngestStatusSchema } from "./shared/contracts.js";
+const config = loadConfig(hostname());
+const serve = Command.make("serve", {}, Effect.fn(function* () {
+    const stdio = yield* Stdio.Stdio;
+    const settings = yield* config;
+    const port = yield* Port;
+    const configuredOrigin = yield* PublicOrigin;
+    const security = yield* makeOwnerSessionSecrets(ownerSessionOrigin("127.0.0.1", port), Option.getOrUndefined(configuredOrigin));
+    const ready = yield* Deferred.make();
+    const server = yield* Layer.launch(makeServer({ config: settings, port, ready, security })).pipe(Effect.forkChild({ startImmediately: true }));
+    yield* Effect.raceFirst(Deferred.await(ready), Fiber.join(server));
+    // On stdout and nowhere else: this line is the credential, so it is never logged.
+    yield* Stream.make(`agent usage: ${ownerSessionUrl(security.browserOrigin, security)}\n`).pipe(Stream.run(stdio.stdout()));
+    return yield* Fiber.join(server);
+})).pipe(Command.withDescription("Record usage continuously and serve the browser view"));
+const describeSource = (name, status) => {
+    if (status.rootMissing)
+        return `${name}: no sessions directory`;
+    const skipped = status.skipped.unparseableLine + status.skipped.missingTimestamp + status.skipped.oversizedLine;
+    return [
+        `${name}: ${status.filesRead}/${status.filesScanned} files read, ${status.eventsAdded} events added`,
+        skipped > 0 ? `, ${skipped} lines skipped` : "",
+        status.unreadable.length > 0 ? `, ${status.unreadable.length} unreadable` : ""
+    ].join("");
+};
+const encodeStatus = Schema.encodeSync(Schema.fromJsonString(IngestStatusSchema));
+const ingest = Command.make("ingest", {
+    json: Flag.Boolean("json").pipe(Flag.withDescription("Print the status as one JSON value"), Flag.withDefault(false))
+}, Effect.fn(function* ({ json }) {
+    const settings = yield* config;
+    const status = yield* ingestOnce(settings.roots).pipe(
+    // This subcommand's entry point: the store opens for this one pass and closes with it.
+    // @effect-diagnostics-next-line strictEffectProvide:off
+    Effect.provide(databaseLayer(settings.storeDirectory)));
+    if (json)
+        return yield* Console.log(encodeStatus(status));
+    yield* Console.log(describeSource("claude", status.claude));
+    yield* Console.log(describeSource("codex", status.codex));
+    yield* Console.log(`took ${status.finishedAt - status.startedAt}ms`);
+})).pipe(Command.withDescription("Run one ingest pass and report what it found"));
+const cli = Command.make("agent-usage").pipe(Command.withDescription("Claude and Codex subscription usage over time, per ticket and against limits"), Command.withSubcommands([serve, ingest]), Command.run({ version: "0.1.0" }));
+// Executable entry point: the host platform is provided once for this process.
+NodeRuntime.runMain(cli.pipe(Effect.provide(NodeServices.layer)));
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

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

package/dist/server/Api.d.ts

@@ -0,0 +1,304 @@
+/** Authenticated HTTP routes. Every route reads; payload schemas live in shared/contracts. */
+import { HttpApi, HttpApiEndpoint, HttpApiGroup, HttpApiMiddleware, HttpApiSecurity } from "effect/http-api";
+import { ApiError, ForbiddenApiError, UnauthorizedApiError } from "../shared/contracts.js";
+export * from "../shared/contracts.js";
+declare const OwnerSessionAuth_base: HttpApiMiddleware.ServiceClass<OwnerSessionAuth, "@knpkv/agent-usage/OwnerSessionAuth", {
+    requires: never;
+    provides: never;
+    error: readonly [typeof UnauthorizedApiError, typeof ForbiddenApiError];
+    clientError: never;
+    requiredForClient: false;
+    security: {
+        readonly ownerCookie: HttpApiSecurity.ApiKey;
+    };
+}, HttpApiMiddleware.HttpApiMiddlewareSecurity<{
+    readonly ownerCookie: HttpApiSecurity.ApiKey;
+}, never, readonly [typeof UnauthorizedApiError, typeof ForbiddenApiError], never>>;
+export declare class OwnerSessionAuth extends OwnerSessionAuth_base {
+}
+declare const UsageApiGroup_base: HttpApiGroup.HttpApiGroup<"usage", HttpApiEndpoint.HttpApiEndpoint<"limits", "GET", "/api/limits", never, import("effect/Schema").toCodecStringTree<import("effect/Schema").Struct<{
+    readonly from: import("effect/Schema").compose<import("effect/Schema").Int, import("effect/Schema").NumberFromString>;
+    readonly to: import("effect/Schema").compose<import("effect/Schema").Int, import("effect/Schema").NumberFromString>;
+}>>, never, never, import("effect/Schema").toCodecJson<import("effect/Schema").Struct<{
+    readonly series: import("effect/Schema").$Array<import("effect/Schema").Struct<{
+        readonly agent: import("effect/Schema").Literals<readonly ["claude", "codex"]>;
+        readonly label: import("effect/Schema").String;
+        readonly windowMinutes: import("effect/Schema").NullOr<import("effect/Schema").Int>;
+        readonly points: import("effect/Schema").$Array<import("effect/Schema").Struct<{
+            readonly at: import("effect/Schema").Int;
+            readonly reading: import("effect/Schema").Union<readonly [import("effect/Schema").TaggedStruct<"Known", {
+                readonly usedPercent: import("effect/Schema").Finite;
+                readonly resetsAt: import("effect/Schema").NullOr<import("effect/Schema").Int>;
+            }>, import("effect/Schema").TaggedStruct<"Unknown", {
+                readonly reason: import("effect/Schema").Literals<readonly ["NoAuth", "AuthExpired", "NotSupported", "Fetch", "Parse", "NoData"]>;
+            }>]>;
+        }>>;
+    }>>;
+    readonly latest: import("effect/Schema").$Array<import("effect/Schema").Struct<{
+        readonly agent: import("effect/Schema").Literals<readonly ["claude", "codex"]>;
+        readonly machine: import("effect/Schema").NonEmptyString;
+        readonly source: import("effect/Schema").Literals<readonly ["claude-oauth-usage", "codex-rollout"]>;
+        readonly label: import("effect/Schema").NonEmptyString;
+        readonly windowMinutes: import("effect/Schema").NullOr<import("effect/Schema").Int>;
+        readonly observedAt: import("effect/Schema").Int;
+        readonly reading: import("effect/Schema").Union<readonly [import("effect/Schema").TaggedStruct<"Known", {
+            readonly usedPercent: import("effect/Schema").Finite;
+            readonly resetsAt: import("effect/Schema").NullOr<import("effect/Schema").Int>;
+        }>, import("effect/Schema").TaggedStruct<"Unknown", {
+            readonly reason: import("effect/Schema").Literals<readonly ["NoAuth", "AuthExpired", "NotSupported", "Fetch", "Parse", "NoData"]>;
+        }>]>;
+    }>>;
+    readonly balances: import("effect/Schema").$Array<import("effect/Schema").Struct<{
+        readonly kind: import("effect/Schema").Literals<readonly ["claude-extra-usage", "codex-credits"]>;
+        readonly machine: import("effect/Schema").NonEmptyString;
+        readonly observedAt: import("effect/Schema").Int;
+        readonly value: import("effect/Schema").Union<readonly [import("effect/Schema").TaggedStruct<"Known", {
+            readonly balance: import("effect/Schema").Union<readonly [import("effect/Schema").TaggedStruct<"Amount", {
+                readonly leftMinor: import("effect/Schema").Finite;
+                readonly limitMinor: import("effect/Schema").Finite;
+                readonly decimals: import("effect/Schema").Int;
+                readonly currency: import("effect/Schema").String;
+            }>, import("effect/Schema").TaggedStruct<"Credits", {
+                readonly credits: import("effect/Schema").Finite;
+            }>, import("effect/Schema").TaggedStruct<"Unlimited", {}>, import("effect/Schema").TaggedStruct<"Exhausted", {}>, import("effect/Schema").TaggedStruct<"Disabled", {}>]>;
+        }>, import("effect/Schema").TaggedStruct<"Unknown", {
+            readonly reason: import("effect/Schema").Literals<readonly ["NoAuth", "AuthExpired", "NotSupported", "Fetch", "Parse", "NoData"]>;
+        }>]>;
+    }>>;
+}>>, import("effect/Schema").toCodecJson<typeof ApiError>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"status", "GET", "/api/status", never, never, never, never, import("effect/Schema").toCodecJson<import("effect/Schema").Struct<{
+    readonly machine: import("effect/Schema").String;
+    readonly ingest: import("effect/Schema").NullOr<import("effect/Schema").Struct<{
+        readonly startedAt: import("effect/Schema").Int;
+        readonly finishedAt: import("effect/Schema").Int;
+        readonly claude: import("effect/Schema").Struct<{
+            readonly rootMissing: import("effect/Schema").Boolean;
+            readonly filesScanned: import("effect/Schema").Int;
+            readonly filesRead: import("effect/Schema").Int;
+            readonly eventsAdded: import("effect/Schema").Int;
+            readonly skipped: import("effect/Schema").Struct<{
+                readonly unparseableLine: import("effect/Schema").Int;
+                readonly missingTimestamp: import("effect/Schema").Int;
+                readonly oversizedLine: import("effect/Schema").Int;
+            }>;
+            readonly unreadable: import("effect/Schema").$Array<import("effect/Schema").Struct<{
+                readonly fileKey: import("effect/Schema").String;
+                readonly reason: import("effect/Schema").String;
+            }>>;
+        }>;
+        readonly codex: import("effect/Schema").Struct<{
+            readonly rootMissing: import("effect/Schema").Boolean;
+            readonly filesScanned: import("effect/Schema").Int;
+            readonly filesRead: import("effect/Schema").Int;
+            readonly eventsAdded: import("effect/Schema").Int;
+            readonly skipped: import("effect/Schema").Struct<{
+                readonly unparseableLine: import("effect/Schema").Int;
+                readonly missingTimestamp: import("effect/Schema").Int;
+                readonly oversizedLine: import("effect/Schema").Int;
+            }>;
+            readonly unreadable: import("effect/Schema").$Array<import("effect/Schema").Struct<{
+                readonly fileKey: import("effect/Schema").String;
+                readonly reason: import("effect/Schema").String;
+            }>>;
+        }>;
+    }>>;
+    readonly ingestFailure: import("effect/Schema").NullOr<import("effect/Schema").String>;
+    readonly limitsFailure: import("effect/Schema").NullOr<import("effect/Schema").String>;
+    readonly ticketLookupFailures: import("effect/Schema").$Array<import("effect/Schema").String>;
+}>>, never, never, never> | HttpApiEndpoint.HttpApiEndpoint<"usage", "GET", "/api/usage", never, import("effect/Schema").toCodecStringTree<import("effect/Schema").Struct<{
+    readonly from: import("effect/Schema").compose<import("effect/Schema").Int, import("effect/Schema").NumberFromString>;
+    readonly to: import("effect/Schema").compose<import("effect/Schema").Int, import("effect/Schema").NumberFromString>;
+    readonly timeZone: import("effect/Schema").String;
+    readonly bucket: import("effect/Schema").Literals<readonly ["hour", "day", "week"]>;
+    readonly agent: import("effect/Schema").Literals<readonly ["all", "claude", "codex"]>;
+}>>, never, never, import("effect/Schema").toCodecJson<import("effect/Schema").Struct<{
+    readonly periods: import("effect/Schema").$Array<import("effect/Schema").Struct<{
+        readonly key: import("effect/Schema").String;
+        readonly start: import("effect/Schema").Int;
+    }>>;
+    readonly bookings: import("effect/Schema").$Array<import("effect/Schema").Struct<{
+        readonly id: import("effect/Schema").String;
+        readonly booking: import("effect/Schema").Union<readonly [import("effect/Schema").TaggedStruct<"Ticket", {
+            readonly key: import("effect/Schema").String;
+        }>, import("effect/Schema").TaggedStruct<"Repo", {
+            readonly name: import("effect/Schema").String;
+        }>]>;
+        readonly title: import("effect/Schema").NullOr<import("effect/Schema").Union<readonly [import("effect/Schema").TaggedStruct<"Known", {
+            readonly summary: import("effect/Schema").String;
+        }>, import("effect/Schema").TaggedStruct<"Unknown", {
+            readonly reason: import("effect/Schema").Literals<readonly ["NotFound", "NotLookedUp"]>;
+        }>]>>;
+        readonly agents: import("effect/Schema").$Array<import("effect/Schema").Literals<readonly ["claude", "codex"]>>;
+        readonly requests: import("effect/Schema").Int;
+        readonly tokens: import("effect/Schema").Struct<{
+            readonly input: import("effect/Schema").Int;
+            readonly output: import("effect/Schema").Int;
+            readonly reasoning: import("effect/Schema").Int;
+            readonly cacheRead: import("effect/Schema").Int;
+            readonly cacheWrite5m: import("effect/Schema").Int;
+            readonly cacheWrite1h: import("effect/Schema").Int;
+        }>;
+        readonly costUsd: import("effect/Schema").Finite;
+        readonly unpricedTokens: import("effect/Schema").Int;
+        readonly unpricedModels: import("effect/Schema").$Array<import("effect/Schema").String>;
+    }>>;
+    readonly cells: import("effect/Schema").$Array<import("effect/Schema").Struct<{
+        readonly period: import("effect/Schema").Int;
+        readonly booking: import("effect/Schema").String;
+        readonly tokens: import("effect/Schema").Int;
+        readonly costUsd: import("effect/Schema").Finite;
+        readonly unpricedTokens: import("effect/Schema").Int;
+    }>>;
+    readonly unpriced: import("effect/Schema").Struct<{
+        readonly tokens: import("effect/Schema").Int;
+        readonly models: import("effect/Schema").$Array<import("effect/Schema").String>;
+    }>;
+    readonly ignoredKeys: import("effect/Schema").$Array<import("effect/Schema").Struct<{
+        readonly prefix: import("effect/Schema").String;
+        readonly requests: import("effect/Schema").Int;
+    }>>;
+}>>, import("effect/Schema").toCodecJson<typeof ApiError>, never, never>, false>;
+export declare class UsageApiGroup extends UsageApiGroup_base {
+}
+declare const AgentUsageApi_base: HttpApi.HttpApi<"AgentUsageApi", HttpApiGroup.HttpApiGroup<"usage", HttpApiEndpoint.HttpApiEndpoint<"usage", "GET", "/api/usage", never, import("effect/Schema").toCodecStringTree<import("effect/Schema").Struct<{
+    readonly from: import("effect/Schema").compose<import("effect/Schema").Int, import("effect/Schema").NumberFromString>;
+    readonly to: import("effect/Schema").compose<import("effect/Schema").Int, import("effect/Schema").NumberFromString>;
+    readonly timeZone: import("effect/Schema").String;
+    readonly bucket: import("effect/Schema").Literals<readonly ["hour", "day", "week"]>;
+    readonly agent: import("effect/Schema").Literals<readonly ["all", "claude", "codex"]>;
+}>>, never, never, import("effect/Schema").toCodecJson<import("effect/Schema").Struct<{
+    readonly periods: import("effect/Schema").$Array<import("effect/Schema").Struct<{
+        readonly key: import("effect/Schema").String;
+        readonly start: import("effect/Schema").Int;
+    }>>;
+    readonly bookings: import("effect/Schema").$Array<import("effect/Schema").Struct<{
+        readonly id: import("effect/Schema").String;
+        readonly booking: import("effect/Schema").Union<readonly [import("effect/Schema").TaggedStruct<"Ticket", {
+            readonly key: import("effect/Schema").String;
+        }>, import("effect/Schema").TaggedStruct<"Repo", {
+            readonly name: import("effect/Schema").String;
+        }>]>;
+        readonly title: import("effect/Schema").NullOr<import("effect/Schema").Union<readonly [import("effect/Schema").TaggedStruct<"Known", {
+            readonly summary: import("effect/Schema").String;
+        }>, import("effect/Schema").TaggedStruct<"Unknown", {
+            readonly reason: import("effect/Schema").Literals<readonly ["NotFound", "NotLookedUp"]>;
+        }>]>>;
+        readonly agents: import("effect/Schema").$Array<import("effect/Schema").Literals<readonly ["claude", "codex"]>>;
+        readonly requests: import("effect/Schema").Int;
+        readonly tokens: import("effect/Schema").Struct<{
+            readonly input: import("effect/Schema").Int;
+            readonly output: import("effect/Schema").Int;
+            readonly reasoning: import("effect/Schema").Int;
+            readonly cacheRead: import("effect/Schema").Int;
+            readonly cacheWrite5m: import("effect/Schema").Int;
+            readonly cacheWrite1h: import("effect/Schema").Int;
+        }>;
+        readonly costUsd: import("effect/Schema").Finite;
+        readonly unpricedTokens: import("effect/Schema").Int;
+        readonly unpricedModels: import("effect/Schema").$Array<import("effect/Schema").String>;
+    }>>;
+    readonly cells: import("effect/Schema").$Array<import("effect/Schema").Struct<{
+        readonly period: import("effect/Schema").Int;
+        readonly booking: import("effect/Schema").String;
+        readonly tokens: import("effect/Schema").Int;
+        readonly costUsd: import("effect/Schema").Finite;
+        readonly unpricedTokens: import("effect/Schema").Int;
+    }>>;
+    readonly unpriced: import("effect/Schema").Struct<{
+        readonly tokens: import("effect/Schema").Int;
+        readonly models: import("effect/Schema").$Array<import("effect/Schema").String>;
+    }>;
+    readonly ignoredKeys: import("effect/Schema").$Array<import("effect/Schema").Struct<{
+        readonly prefix: import("effect/Schema").String;
+        readonly requests: import("effect/Schema").Int;
+    }>>;
+}>>, import("effect/Schema").toCodecJson<typeof ApiError>, OwnerSessionAuth, never> | HttpApiEndpoint.HttpApiEndpoint<"limits", "GET", "/api/limits", never, import("effect/Schema").toCodecStringTree<import("effect/Schema").Struct<{
+    readonly from: import("effect/Schema").compose<import("effect/Schema").Int, import("effect/Schema").NumberFromString>;
+    readonly to: import("effect/Schema").compose<import("effect/Schema").Int, import("effect/Schema").NumberFromString>;
+}>>, never, never, import("effect/Schema").toCodecJson<import("effect/Schema").Struct<{
+    readonly series: import("effect/Schema").$Array<import("effect/Schema").Struct<{
+        readonly agent: import("effect/Schema").Literals<readonly ["claude", "codex"]>;
+        readonly label: import("effect/Schema").String;
+        readonly windowMinutes: import("effect/Schema").NullOr<import("effect/Schema").Int>;
+        readonly points: import("effect/Schema").$Array<import("effect/Schema").Struct<{
+            readonly at: import("effect/Schema").Int;
+            readonly reading: import("effect/Schema").Union<readonly [import("effect/Schema").TaggedStruct<"Known", {
+                readonly usedPercent: import("effect/Schema").Finite;
+                readonly resetsAt: import("effect/Schema").NullOr<import("effect/Schema").Int>;
+            }>, import("effect/Schema").TaggedStruct<"Unknown", {
+                readonly reason: import("effect/Schema").Literals<readonly ["NoAuth", "AuthExpired", "NotSupported", "Fetch", "Parse", "NoData"]>;
+            }>]>;
+        }>>;
+    }>>;
+    readonly latest: import("effect/Schema").$Array<import("effect/Schema").Struct<{
+        readonly agent: import("effect/Schema").Literals<readonly ["claude", "codex"]>;
+        readonly machine: import("effect/Schema").NonEmptyString;
+        readonly source: import("effect/Schema").Literals<readonly ["claude-oauth-usage", "codex-rollout"]>;
+        readonly label: import("effect/Schema").NonEmptyString;
+        readonly windowMinutes: import("effect/Schema").NullOr<import("effect/Schema").Int>;
+        readonly observedAt: import("effect/Schema").Int;
+        readonly reading: import("effect/Schema").Union<readonly [import("effect/Schema").TaggedStruct<"Known", {
+            readonly usedPercent: import("effect/Schema").Finite;
+            readonly resetsAt: import("effect/Schema").NullOr<import("effect/Schema").Int>;
+        }>, import("effect/Schema").TaggedStruct<"Unknown", {
+            readonly reason: import("effect/Schema").Literals<readonly ["NoAuth", "AuthExpired", "NotSupported", "Fetch", "Parse", "NoData"]>;
+        }>]>;
+    }>>;
+    readonly balances: import("effect/Schema").$Array<import("effect/Schema").Struct<{
+        readonly kind: import("effect/Schema").Literals<readonly ["claude-extra-usage", "codex-credits"]>;
+        readonly machine: import("effect/Schema").NonEmptyString;
+        readonly observedAt: import("effect/Schema").Int;
+        readonly value: import("effect/Schema").Union<readonly [import("effect/Schema").TaggedStruct<"Known", {
+            readonly balance: import("effect/Schema").Union<readonly [import("effect/Schema").TaggedStruct<"Amount", {
+                readonly leftMinor: import("effect/Schema").Finite;
+                readonly limitMinor: import("effect/Schema").Finite;
+                readonly decimals: import("effect/Schema").Int;
+                readonly currency: import("effect/Schema").String;
+            }>, import("effect/Schema").TaggedStruct<"Credits", {
+                readonly credits: import("effect/Schema").Finite;
+            }>, import("effect/Schema").TaggedStruct<"Unlimited", {}>, import("effect/Schema").TaggedStruct<"Exhausted", {}>, import("effect/Schema").TaggedStruct<"Disabled", {}>]>;
+        }>, import("effect/Schema").TaggedStruct<"Unknown", {
+            readonly reason: import("effect/Schema").Literals<readonly ["NoAuth", "AuthExpired", "NotSupported", "Fetch", "Parse", "NoData"]>;
+        }>]>;
+    }>>;
+}>>, import("effect/Schema").toCodecJson<typeof ApiError>, OwnerSessionAuth, never> | HttpApiEndpoint.HttpApiEndpoint<"status", "GET", "/api/status", never, never, never, never, import("effect/Schema").toCodecJson<import("effect/Schema").Struct<{
+    readonly machine: import("effect/Schema").String;
+    readonly ingest: import("effect/Schema").NullOr<import("effect/Schema").Struct<{
+        readonly startedAt: import("effect/Schema").Int;
+        readonly finishedAt: import("effect/Schema").Int;
+        readonly claude: import("effect/Schema").Struct<{
+            readonly rootMissing: import("effect/Schema").Boolean;
+            readonly filesScanned: import("effect/Schema").Int;
+            readonly filesRead: import("effect/Schema").Int;
+            readonly eventsAdded: import("effect/Schema").Int;
+            readonly skipped: import("effect/Schema").Struct<{
+                readonly unparseableLine: import("effect/Schema").Int;
+                readonly missingTimestamp: import("effect/Schema").Int;
+                readonly oversizedLine: import("effect/Schema").Int;
+            }>;
+            readonly unreadable: import("effect/Schema").$Array<import("effect/Schema").Struct<{
+                readonly fileKey: import("effect/Schema").String;
+                readonly reason: import("effect/Schema").String;
+            }>>;
+        }>;
+        readonly codex: import("effect/Schema").Struct<{
+            readonly rootMissing: import("effect/Schema").Boolean;
+            readonly filesScanned: import("effect/Schema").Int;
+            readonly filesRead: import("effect/Schema").Int;
+            readonly eventsAdded: import("effect/Schema").Int;
+            readonly skipped: import("effect/Schema").Struct<{
+                readonly unparseableLine: import("effect/Schema").Int;
+                readonly missingTimestamp: import("effect/Schema").Int;
+                readonly oversizedLine: import("effect/Schema").Int;
+            }>;
+            readonly unreadable: import("effect/Schema").$Array<import("effect/Schema").Struct<{
+                readonly fileKey: import("effect/Schema").String;
+                readonly reason: import("effect/Schema").String;
+            }>>;
+        }>;
+    }>>;
+    readonly ingestFailure: import("effect/Schema").NullOr<import("effect/Schema").String>;
+    readonly limitsFailure: import("effect/Schema").NullOr<import("effect/Schema").String>;
+    readonly ticketLookupFailures: import("effect/Schema").$Array<import("effect/Schema").String>;
+}>>, never, OwnerSessionAuth, never>, false>>;
+export declare class AgentUsageApi extends AgentUsageApi_base {
+}

package/dist/server/Api.js

@@ -0,0 +1,20 @@
+/** Authenticated HTTP routes. Every route reads; payload schemas live in shared/contracts. */
+import { HttpApi, HttpApiEndpoint, HttpApiGroup, HttpApiMiddleware, HttpApiSecurity } from "effect/http-api";
+import { ApiError, ForbiddenApiError, LimitsReport, RangeQuery, ServerStatus, UnauthorizedApiError, UsageQuery, UsageReport } from "../shared/contracts.js";
+export * from "../shared/contracts.js";
+export class OwnerSessionAuth extends HttpApiMiddleware.Service()("@knpkv/agent-usage/OwnerSessionAuth", {
+    error: [UnauthorizedApiError, ForbiddenApiError],
+    security: {
+        ownerCookie: HttpApiSecurity.apiKey({ in: "cookie", key: "agent_usage_owner" })
+    }
+}) {
+}
+export class UsageApiGroup extends HttpApiGroup.make("usage")
+    .add(HttpApiEndpoint.get("usage", "/usage", { query: UsageQuery, success: UsageReport, error: ApiError }))
+    .add(HttpApiEndpoint.get("limits", "/limits", { query: RangeQuery, success: LimitsReport, error: ApiError }))
+    .add(HttpApiEndpoint.get("status", "/status", { success: ServerStatus }))
+    .prefix("/api") {
+}
+export class AgentUsageApi extends HttpApi.make("AgentUsageApi").add(UsageApiGroup).middleware(OwnerSessionAuth) {
+}
+//# sourceMappingURL=Api.js.map

package/dist/server/Api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Api.js","sourceRoot":"","sources":["../../src/server/Api.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAC5G,OAAO,EACL,QAAQ,EACR,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,oBAAoB,EACpB,UAAU,EACV,WAAW,EACZ,MAAM,wBAAwB,CAAA;AAE/B,cAAc,wBAAwB,CAAA;AAEtC,MAAM,OAAO,gBAAiB,SAAQ,iBAAiB,CAAC,OAAO,EAAoB,CACjF,qCAAqC,EACrC;IACE,KAAK,EAAE,CAAC,oBAAoB,EAAE,iBAAiB,CAAC;IAChD,QAAQ,EAAE;QACR,WAAW,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,mBAAmB,EAAE,CAAC;KAChF;CACF,CACF;CAAG;AAEJ,MAAM,OAAO,aAAc,SAAQ,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC;KAC1D,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;KACzG,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;KAC5G,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;KACxE,MAAM,CAAC,MAAM,CAAC;CACf;AAEF,MAAM,OAAO,aAAc,SAAQ,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,UAAU,CAAC,gBAAgB,CAAC;CAAG"}

package/dist/server/Config.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Where this Machine's store and agent sessions live, from the environment.
+ *
+ * - `AGENT_USAGE_HOME` — the store directory (default `~/.local/share/agent-usage`)
+ * - `AGENT_USAGE_MACHINE` — the Machine name (default: the short, lower-cased hostname)
+ * - `CLAUDE_CONFIG_DIR` / `CODEX_HOME` — the agents' own roots (default `~/.claude`, `~/.codex`)
+ * - `AGENT_USAGE_PROJECTS` — extra Known Projects, comma-separated (`RPS,ABC`), for projects typed in
+ *   sessions before any branch named them
+ *
+ * @module
+ */
+import { Config, Effect, Path } from "effect";
+import type { SourceRoots } from "../core/Ingest.js";
+export interface AgentUsageConfig {
+    readonly storeDirectory: string;
+    /** Known Projects from configuration, added to those branches and paths name. */
+    readonly projects: ReadonlyArray<string>;
+    readonly claudeConfigDir: string;
+    readonly roots: SourceRoots;
+}
+/**
+ * The Machine name a hostname gives: the part before the first dot, lower-cased, so macOS's
+ * `Example-MacBook.local` and `Example-MacBook` name the same Machine.
+ */
+export declare const machineName: (hostname: string) => string;
+/** Reads the configuration; `hostname` comes from the executable, the only place that may ask. */
+export declare const loadConfig: (hostname: string) => Effect.Effect<AgentUsageConfig, Config.ConfigError, Path.Path>;

package/dist/server/Config.js

@@ -0,0 +1,49 @@
+/**
+ * Where this Machine's store and agent sessions live, from the environment.
+ *
+ * - `AGENT_USAGE_HOME` — the store directory (default `~/.local/share/agent-usage`)
+ * - `AGENT_USAGE_MACHINE` — the Machine name (default: the short, lower-cased hostname)
+ * - `CLAUDE_CONFIG_DIR` / `CODEX_HOME` — the agents' own roots (default `~/.claude`, `~/.codex`)
+ * - `AGENT_USAGE_PROJECTS` — extra Known Projects, comma-separated (`RPS,ABC`), for projects typed in
+ *   sessions before any branch named them
+ *
+ * @module
+ */
+import { Config, Effect, Path, Schema, SchemaTransformation } from "effect";
+/**
+ * The Machine name a hostname gives: the part before the first dot, lower-cased, so macOS's
+ * `Example-MacBook.local` and `Example-MacBook` name the same Machine.
+ */
+export const machineName = (hostname) => {
+    const short = hostname.split(".")[0]?.trim().toLowerCase() ?? "";
+    return short === "" ? "localhost" : short;
+};
+/** A Jira project key as the Booking pattern reads one. */
+const ProjectKey = Schema.String.check(Schema.isPattern(/^[A-Z][A-Z0-9]{1,9}$/u));
+/** `RPS, ABC` → `["RPS", "ABC"]`; an entry that is not a project key fails the configuration. */
+const Projects = Schema.String.pipe(Schema.decodeTo(Schema.Array(ProjectKey), SchemaTransformation.transform({
+    decode: (raw) => raw.split(",").map((entry) => entry.trim()).filter((entry) => entry !== ""),
+    encode: (keys) => keys.join(",")
+})));
+/** Reads the configuration; `hostname` comes from the executable, the only place that may ask. */
+export const loadConfig = (hostname) => Effect.gen(function* () {
+    const path = yield* Path.Path;
+    const home = yield* Config.String("HOME");
+    const storeDirectory = yield* Config.String("AGENT_USAGE_HOME").pipe(Config.withDefault(path.join(home, ".local", "share", "agent-usage")));
+    const machine = yield* Config.NonEmptyString("AGENT_USAGE_MACHINE").pipe(Config.withDefault(machineName(hostname)));
+    const claudeConfigDir = yield* Config.String("CLAUDE_CONFIG_DIR").pipe(Config.withDefault(path.join(home, ".claude")));
+    const codexHome = yield* Config.String("CODEX_HOME").pipe(Config.withDefault(path.join(home, ".codex")));
+    const projects = yield* Config.schema(Projects, "AGENT_USAGE_PROJECTS").pipe(Config.withDefault([]));
+    const config = {
+        storeDirectory,
+        projects,
+        claudeConfigDir,
+        roots: {
+            claudeProjects: path.join(claudeConfigDir, "projects"),
+            codexHome,
+            machine
+        }
+    };
+    return config;
+});
+//# sourceMappingURL=Config.js.map

package/dist/server/Config.js.map

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

package/dist/server/Handlers.d.ts

@@ -0,0 +1,5 @@
+import { UsageStore } from "../core/Store.js";
+import { RuntimeState } from "./Runtime.js";
+/** More periods than any chart can draw legibly; a range that needs more wants a coarser bucket. */
+export declare const MAX_PERIODS = 2500;
+export declare const UsageLive: import("effect/Layer").Layer<import("effect/http-api/HttpApiGroup").Service<"AgentUsageApi", "usage">, never, import("./Api.js").OwnerSessionAuth | RuntimeState | UsageStore>;

package/dist/server/Handlers.js

@@ -0,0 +1,48 @@
+/**
+ * The read handlers: usage per period and Booking, limit series and balances, and status.
+ *
+ * @module
+ */
+import { Effect, SubscriptionRef } from "effect";
+import { HttpApiBuilder } from "effect/http-api";
+import { attribute } from "../core/Attribution.js";
+import { buildLimitsReport, buildUsageReport, checkTimeZone, periodsOf } from "../core/Report.js";
+import { UsageStore } from "../core/Store.js";
+import { ticketTitles } from "../core/Tickets.js";
+import { AgentUsageApi, ApiError } from "./Api.js";
+import { currentKnownProjects, RuntimeState } from "./Runtime.js";
+/** More periods than any chart can draw legibly; a range that needs more wants a coarser bucket. */
+export const MAX_PERIODS = 2_500;
+const storeUnavailable = (error) => new ApiError({ message: `The usage store could not be read (${error.operation})` });
+const checkRange = (from, to) => from < to ? Effect.void : Effect.fail(new ApiError({ message: "The range must end after it starts" }));
+export const UsageLive = HttpApiBuilder.group(AgentUsageApi, "usage", (handlers) => Effect.gen(function* () {
+    const store = yield* UsageStore;
+    const state = yield* RuntimeState;
+    return handlers
+        .handle("usage", ({ query }) => Effect.gen(function* () {
+        yield* checkRange(query.from, query.to);
+        yield* checkTimeZone(query.timeZone).pipe(Effect.mapError((error) => new ApiError({ message: `Unknown time zone: ${error.zone}` })));
+        if ((query.to - query.from) / (query.bucket === "hour" ? 3_600_000 : 86_400_000) > MAX_PERIODS) {
+            return yield* new ApiError({ message: "Too many periods: choose a shorter range or a larger bucket" });
+        }
+        const periods = periodsOf({ ...query });
+        const groups = (yield* store.usageGroups({ ...query, machine: state.machine })).filter((group) => query.agent === "all" || group.agent === query.agent);
+        const projects = yield* currentKnownProjects.pipe(Effect.provideService(UsageStore, store), Effect.provideService(RuntimeState, state));
+        const keys = [
+            ...new Set(groups.flatMap((group) => {
+                const { booking } = attribute(group.attribution, projects);
+                return booking._tag === "Ticket" ? [booking.key] : [];
+            }))
+        ];
+        const titles = yield* ticketTitles(keys).pipe(Effect.provideService(UsageStore, store));
+        return buildUsageReport(groups, periods, titles, projects, query.to);
+    }).pipe(Effect.catchTag("StoreError", (error) => Effect.fail(storeUnavailable(error)))))
+        .handle("limits", ({ query }) => Effect.gen(function* () {
+        yield* checkRange(query.from, query.to);
+        const snapshots = yield* store.limitSnapshots({ from: query.from, to: query.to, machine: state.machine });
+        const balances = yield* store.latestBalances(state.machine);
+        return { ...buildLimitsReport(snapshots, query), balances };
+    }).pipe(Effect.catchTag("StoreError", (error) => Effect.fail(storeUnavailable(error)))))
+        .handle("status", () => SubscriptionRef.get(state.status));
+}));
+//# sourceMappingURL=Handlers.js.map

package/dist/server/Handlers.js.map

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

package/dist/server/HttpApplication.d.ts

@@ -0,0 +1,7 @@
+/** The same authenticated routes, bootstrap exchange and static client in production and tests. */
+import { FileSystem, Layer, Path } from "effect";
+import { HttpRouter } from "effect/http";
+/** True only when `candidate` is `root` itself or one of its path-segment descendants. */
+export declare const isWithinDirectory: (path: Path.Path, root: string, candidate: string) => boolean;
+/** Supply the store, runtime state and owner secrets; listener and platform belong to the executable. */
+export declare const application: Layer.Layer<never, never, FileSystem.FileSystem | import("effect/http/Etag").Generator | import("effect/http/HttpPlatform").HttpPlatform | HttpRouter.HttpRouter | import("./OwnerSession.js").OwnerSessionSecrets | Path.Path | HttpRouter.Request<"Error", import("effect/PlatformError").BadArgument> | HttpRouter.Request<"Error", import("effect/http/HttpBody").HttpBodyError> | HttpRouter.Request<"Error", import("effect/PlatformError").PlatformError> | HttpRouter.Request<"Requires", FileSystem.FileSystem> | HttpRouter.Request<"Requires", import("./OwnerSession.js").OwnerSessionSecrets> | HttpRouter.Request<"Requires", Path.Path> | import("./Runtime.js").RuntimeState | import("../core/Store.js").UsageStore>;