@nyte-ai/host 0.0.18 → 0.0.21

package/dist/src/local/jobs.d.ts

@@ -1,5 +1,5 @@
 import type { ExecutionEnv } from "@nyte-ai/core";
-/** Returns `exec` for a folder: each call starts one process as a `Job` (a fresh id; `key` null, core keys pty jobs) in `cwd` resolved against `root` (default `root`), with `env` laid over `process.env`. A string command runs through the platform shell (`/bin/sh -c`, `cmd.exe /d /s /c` on Windows) and an argv directly; `[]` with `pty` runs the login shell (`shell()` read at each start, else `$SHELL`, else `/bin/sh`, as a login shell; §37h), a pty's environment carrying `TERM=xterm-256color`, `COLORTERM=truecolor` and `TERM_PROGRAM=Nyte` without Electron's `ELECTRON_RUN_AS_NODE` and `NODE_OPTIONS`, and `[]` without one throws `SdkError("invalid")`. A program that cannot start throws `SdkError("unavailable")`. Without `pty` the process is piped through `node:child_process` in its own process group, stdout and stderr interleaved in `output` (with `stdio: "protocol"`, stderr's frames tagged `stream: "stderr"` and the pipe paced like a pty, so a reader open from the start misses nothing) and stdin fed by `write`; with `pty` it runs under `@lydell/node-pty`, loaded on first use through `createRequire` (§41a; `loadPty`, given, loads it instead, on every pty start), at the given size, and a platform where it does not load throws `SdkError("unavailable")`. `output()` opens a reader over the last 1 MiB of output that yields `bytes`, a `gap` where the reader fell behind or opened after output was dropped, and `exit { code }` last; a merged pipe never stalls, and a pty or a protocol pipe pauses while its slowest open reader is 256 KiB behind, resuming once it is within 64 KiB. `resize` resizes a pty (`not-pty` for a pipe, `missing` once it ended); `idle` answers whether a pty's shell sits at a prompt: by its OSC 133 prompt markers once it sent one, else when it has printed nothing for 300 ms and the cursor's line holds text after the last newline, as a prompt does (false for a pipe); `stop` sends SIGTERM to a pipe's process group (SIGHUP to a pty), SIGKILL after 2 s, and answers `settled { outcome }` (also once it ended); `settled` resolves `exited { code, reason }` (`code` null after a signal), `reason` `exited` when the process ended on its own and `terminated` after `stop` or an aborted `signal`, and an aborted `settled` signal rejects with `SdkError("unavailable")`; `close` detaches this handle's readers. An aborted `signal` stops the process. `signal` on the options ends every reader of every job started here, leaving the processes running (what the provider's `close` does). */
+/** Returns `exec` for a folder: each call starts one process as a `Job` (a fresh id; `key` null, core keys pty jobs) in `cwd` resolved against `root` (default `root`), with `env` laid over `process.env`. A string command runs through the platform shell (`/bin/sh -c`, `cmd.exe /d /s /c` on Windows) and an argv directly; `[]` with `pty` runs the login shell (`shell()` read at each start, else `$SHELL`, else `/bin/sh`, as a login shell; §37h), a pty's environment carrying `TERM=xterm-256color`, `COLORTERM=truecolor` and `TERM_PROGRAM=Nyte` without Electron's `ELECTRON_RUN_AS_NODE` and `NODE_OPTIONS`, and `[]` without one throws `SdkError("invalid")`. A program that cannot start throws `SdkError("unavailable")`. Without `pty` the process is piped through `node:child_process` in its own process group, stdout and stderr interleaved in `output` (with `stdio: "protocol"`, stderr's frames tagged `stream: "stderr"` and the pipe paced like a pty, so a reader open from the start misses nothing) and stdin fed by `write`; with `pty` it runs under `@lydell/node-pty`, loaded on first use through `createRequire` (§41a; `loadPty`, given, loads it instead, on every pty start), at the given size, and a platform where it does not load throws `SdkError("unavailable")`. `output()` opens a reader over the last 1 MiB of output that yields `bytes`, a `gap` where the reader fell behind or opened after output was dropped, and `exit { code }` last; a merged pipe never stalls, and a pty or a protocol pipe pauses while its slowest open reader is 256 KiB behind, resuming once it is within 64 KiB. `resize` resizes a pty (`not-pty` for a pipe, `missing` once it ended); `idle` checks the OS process table for a login shell with no live children (false for a pipe or explicit command, true once it ended); `stop` sends SIGTERM to a pipe's process group (SIGHUP to a pty), SIGKILL after 2 s (on Windows, which has no signals, it ends a pipe's process tree at once with `taskkill /T /F`), and answers `settled { outcome }` (also once it ended); `settled` resolves `exited { code, reason }` (`code` null after a signal), `reason` `exited` when the process ended on its own and `terminated` after `stop` or an aborted `signal`, and an aborted `settled` signal rejects with `SdkError("unavailable")`; `close` detaches this handle's readers. An aborted `signal` stops the process. `signal` on the options ends every reader of every job started here, leaving the processes running (what the provider's `close` does). */
 export declare function localExec(root: string, options?: {
     readonly shell?: () => string | null;
     readonly signal?: AbortSignal;

package/dist/src/local/jobs.js

@@ -1,6 +1,7 @@
 import {
   localExec2
-} from "../../chunks/canvas-preview-ehf3vp31.js";
+} from "../../chunks/canvas-preview-vm9zdp2t.js";
+import"../../chunks/canvas-preview-bxnqt8cd.js";
 export {
   localExec2 as localExec
 };

package/dist/src/local/provider.js

@@ -1,18 +1,18 @@
 import {
   localProvider2
-} from "../../chunks/canvas-preview-yrfz2ak6.js";
-import"../../chunks/canvas-preview-rp6fz0w5.js";
-import"../../chunks/canvas-preview-xn10d4f8.js";
-import"../../chunks/canvas-preview-75db60xy.js";
+} from "../../chunks/canvas-preview-e3vnkkc5.js";
+import"../../chunks/canvas-preview-2jwbe14k.js";
+import"../../chunks/canvas-preview-5ekjx6sw.js";
+import"../../chunks/canvas-preview-8xc0vn7v.js";
 import"../../chunks/canvas-preview-1sq7z9jq.js";
-import"../../chunks/canvas-preview-ehf3vp31.js";
-import"../../chunks/canvas-preview-senpjwep.js";
+import"../../chunks/canvas-preview-vm9zdp2t.js";
+import"../../chunks/canvas-preview-crmzxxt8.js";
 import"../../chunks/canvas-preview-tjhabynd.js";
-import"../../chunks/canvas-preview-ymgz0937.js";
+import"../../chunks/canvas-preview-drctegz4.js";
 import"../../chunks/canvas-preview-kn7kvbfj.js";
-import"../../chunks/canvas-preview-azg56359.js";
 import"../../chunks/canvas-preview-yjz0f7n4.js";
-import"../../chunks/canvas-preview-zn2d0k9d.js";
+import"../../chunks/canvas-preview-af86jz8t.js";
+import"../../chunks/canvas-preview-bxnqt8cd.js";
 import"../../chunks/canvas-preview-0nq75h9k.js";
 import"../../chunks/canvas-preview-mgcx2b2p.js";
 export {

package/dist/src/local/snapshots.js

@@ -1,9 +1,9 @@
 import {
   localSnapshots2
-} from "../../chunks/canvas-preview-senpjwep.js";
+} from "../../chunks/canvas-preview-crmzxxt8.js";
 import"../../chunks/canvas-preview-tjhabynd.js";
 import"../../chunks/canvas-preview-kn7kvbfj.js";
-import"../../chunks/canvas-preview-azg56359.js";
+import"../../chunks/canvas-preview-bxnqt8cd.js";
 import"../../chunks/canvas-preview-0nq75h9k.js";
 import"../../chunks/canvas-preview-mgcx2b2p.js";
 export {

package/dist/src/local/worktrees.js

@@ -3,8 +3,8 @@ import {
   addWorktree2,
   hasBranch2,
   localWorktrees2
-} from "../../chunks/canvas-preview-rp6fz0w5.js";
-import"../../chunks/canvas-preview-azg56359.js";
+} from "../../chunks/canvas-preview-2jwbe14k.js";
+import"../../chunks/canvas-preview-bxnqt8cd.js";
 import"../../chunks/canvas-preview-0nq75h9k.js";
 export {
   addWorktree2 as addWorktree,

package/dist/src/mcp/connect.d.ts

@@ -5,24 +5,11 @@ import type { McpWorkspace } from "@nyte-ai/core/server";
 import type { McpOAuthConfig } from "@nyte-ai/schema";
 import type { McpServerEntry } from "./config.ts";
 import type { McpOAuthSettings } from "./oauth.ts";
-/**
- * Opens the transport to one server for one workspace. A url server that
- * needs OAuth sends its stored tokens; when it needs a new sign-in the
- * connection fails with `McpOAuthAuthorizationRequiredError`, after passing
- * the server's challenge to `challenged`. Throws when the entry cannot be
- * started, such as a missing `${VAR}`.
- */
 export type McpConnector = (entry: McpServerEntry, context: {
     readonly workspace: McpWorkspace;
     readonly home: string;
     readonly secrets: PluginStorage["secrets"];
     readonly challenged: (challenge: OAuthChallenge) => void;
 }) => McpTransport;
-/**
- * Runs stdio servers on this machine, in `cwd` resolved against the
- * workspace folder, and connects to url servers over streamable HTTP. A url
- * server without an `Authorization` header signs in with OAuth.
- */
 export declare const connectServer: McpConnector;
-/** A server's OAuth options with `${VAR}`s in `clientSecret` resolved. */
 export declare function oauthSettings(config: McpOAuthConfig, server: string): McpOAuthSettings;

package/dist/src/mcp/connect.js

@@ -1,7 +1,7 @@
 import {
   connectServer2,
   oauthSettings2
-} from "../../chunks/canvas-preview-h8hshnff.js";
+} from "../../chunks/canvas-preview-pkzqg96v.js";
 import"../../chunks/canvas-preview-5z63am63.js";
 export {
   connectServer2 as connectServer,

package/dist/src/mcp/hub.js

@@ -1,7 +1,7 @@
 import {
   createMcpHub2
-} from "../../chunks/canvas-preview-8xgt67ka.js";
-import"../../chunks/canvas-preview-h8hshnff.js";
+} from "../../chunks/canvas-preview-gh7c9831.js";
+import"../../chunks/canvas-preview-pkzqg96v.js";
 import"../../chunks/canvas-preview-5z63am63.js";
 import"../../chunks/canvas-preview-vaatfznm.js";
 import"../../chunks/canvas-preview-kdqgrstc.js";

package/dist/src/open.d.ts

@@ -1,42 +1,14 @@
 import type { Models } from "@nyte-ai/ai";
 import type { WorkspaceTarget } from "@nyte-ai/schema";
 import type { Host, OpenOptions, Plugin, Store } from "@nyte-ai/core";
-/**
- * Describes what `openHost` takes: `OpenOptions` with `store`, `workspace`,
- * `models` and `plugins` optional, `secrets` defaulting to this machine's key,
- * and the home directory holding `.nyte`. Every `OpenOptions` is one, so the
- * sdk's Node `open` passes its options straight through.
- */
 export type OpenHostOptions = Omit<OpenOptions, "store" | "workspace" | "models" | "plugins"> & {
-    /** The host's store; absent, `sqliteStore` at `<home>/.nyte/nyte.db`, which the host then closes with itself (§51c). */
     readonly store?: Store;
-    /** Where a root session acts when `create` names none; default the local folder `process.cwd()` (§51c). */
     readonly workspace?: WorkspaceTarget;
-    /** The `@nyte-ai/ai` catalog; absent, `nyteModels` over this host's encrypted credential store (§42e). */
     readonly models?: Models;
-    /** Core plugins loaded after the first-party built-ins and before the plugin files; default none. One with a built-in's id replaces that built-in, as a bundled client's `codemode` runtime does, and a `local` environment provider among them replaces the default one. */
     readonly plugins?: readonly Plugin<"core">[];
-    /** The directory whose `.nyte` holds the store, settings, plugins, secrets key and identity key; default `os.homedir()`. */
     readonly home?: string;
-    /** The login shell the default local provider's pty jobs run, read at each start; absent or null is `$SHELL`. */
     readonly shell?: () => string | null;
+    readonly label?: string;
+    readonly onRevoked?: () => void;
 };
-/**
- * Opens the Node host the sdk's Node `open` calls: `composeHost` with
- * `home` (default `os.homedir()`), `store` (default `<home>/.nyte/nyte.db`,
- * checked every 500 ms for another process's commits, which are then read so
- * a second process on the file sees the first one's runs live),
- * `workspace` (default the local folder `process.cwd()`), `secrets` (default
- * `defaultSecrets(home)`), `models` (default `nyteModels`), `localProvider`
- * unless a plugin provides the `local` environment, every first-party plugin
- * of `@nyte-ai/plugin` that `plugins` does not replace by id, then `plugins`
- * and `filePlugins`' files, `settingsSeed`'s seed and
- * `hostDescription()`; each file that did not load becomes a
- * `server.report` row. The host's `loadPlugins` is `pluginLoader` over
- * the plugin directories (§47l), which `watchPlugins` watches for hot reload
- * (§49a). `listen` defaults `identity` to `identitySigner(host.hostId, home)`
- * and `describe` to the description; nothing here reads the secrets key, even
- * with a credential stored (§50d, §55). `close()` stops the watch, closes the
- * open listeners, the host, then a store it opened.
- */
 export declare function openHost(options: OpenHostOptions): Promise<Host>;

package/dist/src/open.js

@@ -1,36 +1,38 @@
 import {
   openHost2
-} from "../chunks/canvas-preview-vax9ne4e.js";
+} from "../chunks/canvas-preview-y7kq0c8q.js";
 import"../chunks/canvas-preview-4e0pxa32.js";
+import"../chunks/canvas-preview-y5y6ghaw.js";
+import"../chunks/canvas-preview-ec2mt7es.js";
+import"../chunks/canvas-preview-befkjea2.js";
 import"../chunks/canvas-preview-9aqczacs.js";
-import"../chunks/canvas-preview-yrfz2ak6.js";
-import"../chunks/canvas-preview-rp6fz0w5.js";
-import"../chunks/canvas-preview-xn10d4f8.js";
-import"../chunks/canvas-preview-75db60xy.js";
+import"../chunks/canvas-preview-e3vnkkc5.js";
+import"../chunks/canvas-preview-2jwbe14k.js";
+import"../chunks/canvas-preview-5ekjx6sw.js";
+import"../chunks/canvas-preview-8xc0vn7v.js";
 import"../chunks/canvas-preview-1sq7z9jq.js";
-import"../chunks/canvas-preview-ehf3vp31.js";
-import"../chunks/canvas-preview-senpjwep.js";
+import"../chunks/canvas-preview-vm9zdp2t.js";
+import"../chunks/canvas-preview-crmzxxt8.js";
 import"../chunks/canvas-preview-tjhabynd.js";
-import"../chunks/canvas-preview-8xgt67ka.js";
-import"../chunks/canvas-preview-h8hshnff.js";
+import"../chunks/canvas-preview-gh7c9831.js";
+import"../chunks/canvas-preview-pkzqg96v.js";
 import"../chunks/canvas-preview-5z63am63.js";
 import"../chunks/canvas-preview-vaatfznm.js";
-import"../chunks/canvas-preview-ymgz0937.js";
+import"../chunks/canvas-preview-drctegz4.js";
 import"../chunks/canvas-preview-kn7kvbfj.js";
-import"../chunks/canvas-preview-azg56359.js";
 import"../chunks/canvas-preview-yjz0f7n4.js";
-import"../chunks/canvas-preview-zn2d0k9d.js";
+import"../chunks/canvas-preview-af86jz8t.js";
 import"../chunks/canvas-preview-s94ebwf5.js";
 import"../chunks/canvas-preview-kdqgrstc.js";
-import"../chunks/canvas-preview-evh92ywd.js";
+import"../chunks/canvas-preview-mstbvwz3.js";
 import"../chunks/canvas-preview-zaaj99wd.js";
-import"../chunks/canvas-preview-a3yw0j70.js";
-import"../chunks/canvas-preview-98aj5p34.js";
-import"../chunks/canvas-preview-76fwvd6e.js";
-import"../chunks/canvas-preview-d9wwhbtz.js";
-import"../chunks/canvas-preview-m02v4yy6.js";
+import"../chunks/canvas-preview-ycepb05s.js";
+import"../chunks/canvas-preview-w54ymtb3.js";
+import"../chunks/canvas-preview-aq5j4p25.js";
+import"../chunks/canvas-preview-55s0y68g.js";
 import"../chunks/canvas-preview-rp4x6y1h.js";
 import"../chunks/canvas-preview-skzwvw4d.js";
+import"../chunks/canvas-preview-bxnqt8cd.js";
 import"../chunks/canvas-preview-518dh8by.js";
 import"../chunks/canvas-preview-0cmbkp2j.js";
 import"../chunks/canvas-preview-69fkk9yn.js";

package/dist/src/serve/binding.js

@@ -1,6 +1,6 @@
 import {
   bindConnection2
-} from "../../chunks/canvas-preview-m02v4yy6.js";
+} from "../../chunks/canvas-preview-55s0y68g.js";
 export {
   bindConnection2 as bindConnection
 };

package/dist/src/serve/handler.js

@@ -1,7 +1,7 @@
 import {
   createHandler2
-} from "../../chunks/canvas-preview-d9wwhbtz.js";
-import"../../chunks/canvas-preview-m02v4yy6.js";
+} from "../../chunks/canvas-preview-aq5j4p25.js";
+import"../../chunks/canvas-preview-55s0y68g.js";
 import"../../chunks/canvas-preview-rp4x6y1h.js";
 export {
   createHandler2 as createHandler

package/dist/src/sqlite.d.ts

@@ -1,5 +1,6 @@
 import type { Store } from "@nyte-ai/core";
-/** Returns a `Store` over one `node:sqlite` `DatabaseSync`: a file at `path` (WAL mode, opened only by the process that `claimStore` makes its owner, so a second process rejects with `SdkError("unavailable")` before it reads or migrates the file) or an in-memory database. The first `open()` brings it to core's `STORE_VERSION` with `migrateStore` (core's `objects`, `refs`, `log` and `store_meta` tables; each commit one `BEGIN IMMEDIATE`), a file store whose migration rewrites records first saving those refs' rows (name, target, revision; objects are never deleted, so the rows restore them) to `backups/store-<time>-<pid>-<uuid>-v<from>-v<to>.json` beside it, keeping the newest three backups, and rejects with `SdkError("unavailable")` for a store a newer Nyte migrated; a `migrations` table an older Nyte left is kept and ignored. `put` ids the value with core's `objectId` and stores its JSON once; `putBlob` buffers the stream, ids it with `blobId` and stores the bytes once; an object and a blob that share an id share the row, each column filled once (§41f); `blob` reads the bytes back with their size and a null mime. `refs.set` is one `BEGIN IMMEDIATE` transaction with `RefStore.set`'s semantics, each revision a random UUID, that first rejects with `SdkError("unavailable")` when a newer Nyte has migrated the store since it opened. `list(prefix)` reads the name range from `prefix` in name order (BINARY, by code point); `log` returns the events after `after` in seq order up to `limit`, each validated as a `SessionEvent`; `tail` is the session's last seq, or 0; `commitMark` is the writer connection's `PRAGMA data_version`, which moves only for another connection's commit. `checkpoints` keeps one fold checkpoint per session in `fold_checkpoints`, a write at a lower seq leaving the kept one, and `gap` counts a session's events past a seq and sums their UTF-8 bytes. File stores run `list` and `log` on a read-only worker and WAL checkpoints on a separate worker, checking at 1,000 frames and after 100 ms idle with a 10,000-frame writer backstop; unavailable workers warn and fall back to the main connection. Checkpoints use fullfsync on macOS, WAL reuse retains at most 32 MiB, and opening refreshes planner statistics. Writes binding more than 64 KiB use uncached statements. Every `open()` returns a connection over the one writer; `close()` waits for opening and worker shutdown before closing it, and an open during close waits to reopen. */
+/** The local store's file: `NYTE_DB` when set, so a source run keeps its own chats, else `.nyte/nyte.db` under `home`. */
+export declare function storePath(home: string): string;
 export declare function sqliteStore(input: {
     readonly path: string;
 } | {

package/dist/src/sqlite.js

@@ -1,10 +1,11 @@
 import {
+  storePath2,
   sqliteStore2
-} from "../chunks/canvas-preview-evh92ywd.js";
+} from "../chunks/canvas-preview-mstbvwz3.js";
 import"../chunks/canvas-preview-zaaj99wd.js";
-import"../chunks/canvas-preview-a3yw0j70.js";
 import"../chunks/canvas-preview-0cmbkp2j.js";
 import"../chunks/canvas-preview-69fkk9yn.js";
 export {
-  sqliteStore2 as sqliteStore
+  sqliteStore2 as sqliteStore,
+  storePath2 as storePath
 };

package/dist/src/store-usage.js

@@ -4,8 +4,11 @@ import {
   shiftDay2,
   projectUsageReport2,
   readNyteUsage2
-} from "../chunks/canvas-preview-5hxat7hh.js";
+} from "../chunks/canvas-preview-geg2gckp.js";
 import"../chunks/canvas-preview-srgfpdmf.js";
+import"../chunks/canvas-preview-mstbvwz3.js";
+import"../chunks/canvas-preview-zaaj99wd.js";
+import"../chunks/canvas-preview-0cmbkp2j.js";
 import"../chunks/canvas-preview-69fkk9yn.js";
 export {
   USAGE_EVENTS2 as USAGE_EVENTS,

package/dist/src/usage-history.d.ts

@@ -0,0 +1,54 @@
+import type { Stats } from "node:fs";
+import { Type, type TSchema } from "typebox";
+export interface HistoryLine {
+    readonly text: string;
+    /** False for a last line without its newline: its writer may still be appending it. */
+    readonly terminated: boolean;
+}
+export interface HistoryFold<Scan> {
+    line(line: HistoryLine): void;
+    scan(): Scan;
+}
+/** Folds a history file's lines into a scan. `scan()` returns a copy, so folding goes on without changing it. */
+export type HistoryParser<Scan> = (from: Scan | undefined) => HistoryFold<Scan>;
+export interface FileScan<Scan> {
+    readonly size: number;
+    readonly mtimeMs: number;
+    /** The byte after the last newline, where a grown file resumes. */
+    readonly position: number;
+    /** The scan of every line up to `position`. */
+    readonly committed: Scan;
+}
+export declare function fileScanSchema<Scan extends TSchema>(scan: Scan): Type.TObject<{
+    size: Type.TNumber;
+    mtimeMs: Type.TNumber;
+    position: Type.TNumber;
+    committed: Scan;
+}>;
+/** Scans keyed by path. A scan answers while its file keeps the size and mtime it was read at. */
+export declare class UsageScanCache<Scan> {
+    #private;
+    constructor(files?: Iterable<readonly [string, FileScan<Scan>]>);
+    keys(): IterableIterator<string>;
+    entries(): IterableIterator<[string, FileScan<Scan>]>;
+    get(path: string): FileScan<Scan> | undefined;
+    set(path: string, scan: FileScan<Scan>): void;
+    /** Forgets every file a read did not reach. */
+    keepOnly(seen: ReadonlySet<string>): void;
+    /** Whether a scan was added or forgotten since the last {@link markSaved}. */
+    get changed(): boolean;
+    markSaved(): void;
+}
+/**
+ * Reads a history file through `cache`. An unchanged file answers from the cache without being
+ * opened, and a file that only grew is read from its last newline on; any other change rereads it.
+ * A last line without its newline is folded into the answer but not the cache, since its writer may
+ * still be appending it: the next read starts from that line again.
+ */
+export declare function readHistory<Scan>(path: string, info: Stats, parser: HistoryParser<Scan>, cache: UsageScanCache<Scan> | undefined, signal: AbortSignal | undefined): Promise<Scan>;
+/** Reads a cache document written by {@link writeCacheDocument}; a missing, torn or outdated one reads as `undefined`. */
+export declare function readCacheDocument<Document>(path: string, validator: {
+    Check(value: unknown): value is Document;
+}): Promise<Document | undefined>;
+/** Replaces the cache document whole, so a reader never sees half of one. Resolves whether the write landed. */
+export declare function writeCacheDocument<Document>(path: string, document: Document): Promise<boolean>;

package/dist/src/usage-history.js

@@ -0,0 +1,14 @@
+import {
+  fileScanSchema2,
+  UsageScanCache2,
+  readHistory2,
+  readCacheDocument2,
+  writeCacheDocument2
+} from "../chunks/canvas-preview-kp75gb63.js";
+export {
+  UsageScanCache2 as UsageScanCache,
+  fileScanSchema2 as fileScanSchema,
+  readCacheDocument2 as readCacheDocument,
+  readHistory2 as readHistory,
+  writeCacheDocument2 as writeCacheDocument
+};

package/dist/src/usage-service.d.ts

@@ -13,7 +13,8 @@ export interface UsageScanReader {
 export declare function catalogForUsage(models: Pick<Models, "getModels">): readonly Model<Api>[];
 export declare class UsageScanner implements UsageScanReader {
     private readonly home;
-    private readonly caches;
+    private readonly cachePath;
+    private caches;
     private readonly models;
     private readonly scans;
     constructor(home: string);

package/dist/src/usage-service.js

@@ -1,10 +1,14 @@
 import {
   catalogForUsage2,
   UsageScanner2
-} from "../chunks/canvas-preview-1ta3avah.js";
-import"../chunks/canvas-preview-0nrnbt76.js";
-import"../chunks/canvas-preview-5hxat7hh.js";
+} from "../chunks/canvas-preview-k2xaz0ym.js";
+import"../chunks/canvas-preview-eehzfefa.js";
+import"../chunks/canvas-preview-geg2gckp.js";
+import"../chunks/canvas-preview-kp75gb63.js";
 import"../chunks/canvas-preview-srgfpdmf.js";
+import"../chunks/canvas-preview-mstbvwz3.js";
+import"../chunks/canvas-preview-zaaj99wd.js";
+import"../chunks/canvas-preview-0cmbkp2j.js";
 import"../chunks/canvas-preview-69fkk9yn.js";
 export {
   UsageScanner2 as UsageScanner,

package/dist/src/usage-worker.js

@@ -1,10 +1,14 @@
-import"../chunks/canvas-preview-srgfpdmf.js";
 import"../chunks/canvas-preview-69fkk9yn.js";
-import"../chunks/canvas-preview-5hxat7hh.js";
-import"../chunks/canvas-preview-0nrnbt76.js";
+import"../chunks/canvas-preview-zaaj99wd.js";
+import"../chunks/canvas-preview-0cmbkp2j.js";
+import"../chunks/canvas-preview-mstbvwz3.js";
+import"../chunks/canvas-preview-srgfpdmf.js";
+import"../chunks/canvas-preview-geg2gckp.js";
+import"../chunks/canvas-preview-kp75gb63.js";
+import"../chunks/canvas-preview-eehzfefa.js";
 import {
   UsageScanner2
-} from "../chunks/canvas-preview-1ta3avah.js";
+} from "../chunks/canvas-preview-k2xaz0ym.js";
 
 // src/usage-worker.ts
 import { parentPort } from "node:worker_threads";

package/dist/src/usage.d.ts

@@ -1,29 +1,83 @@
+import { Type, type Static } from "typebox";
 import { type Models } from "@nyte-ai/ai";
-import type { LocalHistoryUsage } from "./usage-types.ts";
-import type { Usage } from "@nyte-ai/schema/model";
+import { UsageScanCache } from "./usage-history.ts";
+import type { LocalHistoryUsage, UsageWindow } from "./usage-types.ts";
 export interface ClaudeCodeUsageOptions {
     readonly models: Pick<Models, "getModels">;
+    readonly window: UsageWindow;
     readonly configDir?: string;
     readonly signal?: AbortSignal;
     readonly cache?: UsageScanCache<ClaudeCodeFileScan>;
 }
-export type UsageScanCache<T> = Map<string, FileScan<T>>;
-export interface FileScan<T> {
-    readonly size: number;
-    readonly mtimeMs: number;
-    readonly scan: T;
-}
-export interface ClaudeCodeFileScan {
-    readonly keyed: readonly (readonly [string, Snapshot])[];
-    readonly anonymous: readonly Snapshot[];
-    readonly malformedRecords: number;
-}
 export type ClaudeCodeUsage = LocalHistoryUsage;
-export interface Snapshot {
-    readonly model: string;
-    readonly usage: Usage;
-    readonly costUSD: number | undefined;
-}
+declare const snapshot: Type.TObject<{
+    model: Type.TString;
+    usage: Type.TObject<{
+        input: Type.TNumber;
+        output: Type.TNumber;
+        cacheRead: Type.TNumber;
+        cacheWrite: Type.TNumber;
+        cacheWrite1h: Type.TOptional<Type.TNumber>;
+        reasoning: Type.TOptional<Type.TNumber>;
+        totalTokens: Type.TNumber;
+        cost: Type.TObject<{
+            input: Type.TNumber;
+            output: Type.TNumber;
+            cacheRead: Type.TNumber;
+            cacheWrite: Type.TNumber;
+            total: Type.TNumber;
+        }>;
+    }>;
+    costUSD: Type.TOptional<Type.TNumber>;
+    at: Type.TUnion<[Type.TNumber, Type.TNull]>;
+}>;
+export type Snapshot = Static<typeof snapshot>;
+declare const claudeCodeFileScan: Type.TObject<{
+    keyed: Type.TArray<Type.TTuple<[Type.TString, Type.TObject<{
+        model: Type.TString;
+        usage: Type.TObject<{
+            input: Type.TNumber;
+            output: Type.TNumber;
+            cacheRead: Type.TNumber;
+            cacheWrite: Type.TNumber;
+            cacheWrite1h: Type.TOptional<Type.TNumber>;
+            reasoning: Type.TOptional<Type.TNumber>;
+            totalTokens: Type.TNumber;
+            cost: Type.TObject<{
+                input: Type.TNumber;
+                output: Type.TNumber;
+                cacheRead: Type.TNumber;
+                cacheWrite: Type.TNumber;
+                total: Type.TNumber;
+            }>;
+        }>;
+        costUSD: Type.TOptional<Type.TNumber>;
+        at: Type.TUnion<[Type.TNumber, Type.TNull]>;
+    }>]>>;
+    anonymous: Type.TArray<Type.TObject<{
+        model: Type.TString;
+        usage: Type.TObject<{
+            input: Type.TNumber;
+            output: Type.TNumber;
+            cacheRead: Type.TNumber;
+            cacheWrite: Type.TNumber;
+            cacheWrite1h: Type.TOptional<Type.TNumber>;
+            reasoning: Type.TOptional<Type.TNumber>;
+            totalTokens: Type.TNumber;
+            cost: Type.TObject<{
+                input: Type.TNumber;
+                output: Type.TNumber;
+                cacheRead: Type.TNumber;
+                cacheWrite: Type.TNumber;
+                total: Type.TNumber;
+            }>;
+        }>;
+        costUSD: Type.TOptional<Type.TNumber>;
+        at: Type.TUnion<[Type.TNumber, Type.TNull]>;
+    }>>;
+    malformedRecords: Type.TInteger;
+}>;
+export type ClaudeCodeFileScan = Static<typeof claudeCodeFileScan>;
 /**
  * Reads Claude Code's local usage under `<configDir>/projects`. The configured root may be a
  * symlink (as may a system ancestor such as macOS `/tmp`), but links below it are skipped, to
@@ -35,19 +89,82 @@ export declare function readClaudeCodeUsage(options: ClaudeCodeUsageOptions): Pr
 export type CodexUsage = LocalHistoryUsage;
 export interface CodexUsageOptions {
     readonly models: Pick<Models, "getModels">;
+    readonly window: UsageWindow;
     readonly homeDir?: string;
     readonly signal?: AbortSignal;
     readonly cache?: UsageScanCache<CodexFileScan>;
 }
-export interface CodexFileScan {
-    readonly modern: readonly (readonly [string, CodexRow])[];
-    readonly legacy: readonly CodexRow[];
-    readonly malformedRecords: number;
-}
-export interface CodexRow {
-    readonly model: string;
-    readonly usage: Usage;
-}
+declare const codexRow: Type.TObject<{
+    model: Type.TString;
+    usage: Type.TObject<{
+        input: Type.TNumber;
+        output: Type.TNumber;
+        cacheRead: Type.TNumber;
+        cacheWrite: Type.TNumber;
+        cacheWrite1h: Type.TOptional<Type.TNumber>;
+        reasoning: Type.TOptional<Type.TNumber>;
+        totalTokens: Type.TNumber;
+        cost: Type.TObject<{
+            input: Type.TNumber;
+            output: Type.TNumber;
+            cacheRead: Type.TNumber;
+            cacheWrite: Type.TNumber;
+            total: Type.TNumber;
+        }>;
+    }>;
+    at: Type.TUnion<[Type.TNumber, Type.TNull]>;
+}>;
+export type CodexRow = Static<typeof codexRow>;
+declare const codexFileScan: Type.TObject<{
+    modern: Type.TArray<Type.TTuple<[Type.TString, Type.TObject<{
+        model: Type.TString;
+        usage: Type.TObject<{
+            input: Type.TNumber;
+            output: Type.TNumber;
+            cacheRead: Type.TNumber;
+            cacheWrite: Type.TNumber;
+            cacheWrite1h: Type.TOptional<Type.TNumber>;
+            reasoning: Type.TOptional<Type.TNumber>;
+            totalTokens: Type.TNumber;
+            cost: Type.TObject<{
+                input: Type.TNumber;
+                output: Type.TNumber;
+                cacheRead: Type.TNumber;
+                cacheWrite: Type.TNumber;
+                total: Type.TNumber;
+            }>;
+        }>;
+        at: Type.TUnion<[Type.TNumber, Type.TNull]>;
+    }>]>>;
+    legacy: Type.TArray<Type.TObject<{
+        model: Type.TString;
+        usage: Type.TObject<{
+            input: Type.TNumber;
+            output: Type.TNumber;
+            cacheRead: Type.TNumber;
+            cacheWrite: Type.TNumber;
+            cacheWrite1h: Type.TOptional<Type.TNumber>;
+            reasoning: Type.TOptional<Type.TNumber>;
+            totalTokens: Type.TNumber;
+            cost: Type.TObject<{
+                input: Type.TNumber;
+                output: Type.TNumber;
+                cacheRead: Type.TNumber;
+                cacheWrite: Type.TNumber;
+                total: Type.TNumber;
+            }>;
+        }>;
+        at: Type.TUnion<[Type.TNumber, Type.TNull]>;
+    }>>;
+    malformedRecords: Type.TInteger;
+    cursor: Type.TObject<{
+        model: Type.TString;
+        sawMeta: Type.TBoolean;
+        signature: Type.TOptional<Type.TString>;
+        forkAnchorMs: Type.TOptional<Type.TNumber>;
+    }>;
+}>;
+export type CodexFileScan = Static<typeof codexFileScan>;
 /**
  * Reads Codex's local usage from `sessions` and `archived_sessions` (where the legacy format
  * lives). A `response_id` is unique across files, so one map dedups a forked rollout's repeated
@@ -61,12 +178,18 @@ export interface UsageScanCaches {
     readonly codex: UsageScanCache<CodexFileScan>;
 }
 export declare function createUsageScanCaches(): UsageScanCaches;
+/** Restores the scans {@link saveUsageScanCaches} wrote to `path`; each still answers only while its file is unchanged. */
+export declare function loadUsageScanCaches(path: string): Promise<UsageScanCaches>;
+/** Writes `caches` to `path` when a read changed them since they were last saved; a failed write is tried again on the next save. */
+export declare function saveUsageScanCaches(path: string, caches: UsageScanCaches): Promise<void>;
 export interface LocalUsage {
     readonly claudeCode: LocalHistoryUsage;
     readonly codex: LocalHistoryUsage;
 }
 export declare function readLocalUsage(options: {
     readonly models: Pick<Models, "getModels">;
+    readonly window: UsageWindow;
     readonly signal?: AbortSignal;
     readonly caches?: UsageScanCaches;
 }): Promise<LocalUsage>;
+export {};