@nyte-ai/host 0.0.18 → 0.0.19

package/dist/src/index.js

@@ -11,59 +11,62 @@ import"../chunks/canvas-preview-wg80rbc2.js";
 import {
   identitySigner2
 } from "../chunks/canvas-preview-5mex725c.js";
-import"../chunks/canvas-preview-m02v4yy6.js";
+import"../chunks/canvas-preview-55s0y68g.js";
 import"../chunks/canvas-preview-rp4x6y1h.js";
-import"../chunks/canvas-preview-d9wwhbtz.js";
+import"../chunks/canvas-preview-aq5j4p25.js";
 import {
   listenFetch2
-} from "../chunks/canvas-preview-76fwvd6e.js";
+} from "../chunks/canvas-preview-w54ymtb3.js";
 import {
   listen2
-} from "../chunks/canvas-preview-98aj5p34.js";
+} from "../chunks/canvas-preview-ycepb05s.js";
 import"../chunks/canvas-preview-0nq75h9k.js";
-import"../chunks/canvas-preview-azg56359.js";
+import"../chunks/canvas-preview-bxnqt8cd.js";
 import"../chunks/canvas-preview-yjz0f7n4.js";
 import"../chunks/canvas-preview-kn7kvbfj.js";
 import {
   TEXT_LIMIT2,
   localFiles2
-} from "../chunks/canvas-preview-ymgz0937.js";
+} from "../chunks/canvas-preview-drctegz4.js";
 import"../chunks/canvas-preview-tjhabynd.js";
-import"../chunks/canvas-preview-zn2d0k9d.js";
+import"../chunks/canvas-preview-af86jz8t.js";
 import {
   localGit2
-} from "../chunks/canvas-preview-xn10d4f8.js";
+} from "../chunks/canvas-preview-5ekjx6sw.js";
 import {
   localGitHubAccount2,
   localGitHub2
-} from "../chunks/canvas-preview-75db60xy.js";
+} from "../chunks/canvas-preview-8xc0vn7v.js";
 import {
   folderIdentity2
 } from "../chunks/canvas-preview-1sq7z9jq.js";
 import {
   localExec2
-} from "../chunks/canvas-preview-ehf3vp31.js";
+} from "../chunks/canvas-preview-vm9zdp2t.js";
 import {
   localSnapshots2
-} from "../chunks/canvas-preview-senpjwep.js";
+} from "../chunks/canvas-preview-crmzxxt8.js";
 import {
   listWorktrees2,
   addWorktree2,
   hasBranch2,
   localWorktrees2
-} from "../chunks/canvas-preview-rp6fz0w5.js";
+} from "../chunks/canvas-preview-2jwbe14k.js";
 import {
   localProvider2
-} from "../chunks/canvas-preview-yrfz2ak6.js";
+} from "../chunks/canvas-preview-e3vnkkc5.js";
 import"../chunks/canvas-preview-kdqgrstc.js";
 import"../chunks/canvas-preview-5z63am63.js";
-import"../chunks/canvas-preview-h8hshnff.js";
+import"../chunks/canvas-preview-pkzqg96v.js";
 import"../chunks/canvas-preview-vaatfznm.js";
 import {
   createMcpHub2
-} from "../chunks/canvas-preview-8xgt67ka.js";
+} from "../chunks/canvas-preview-g5fkjs34.js";
 import"../chunks/canvas-preview-9aqczacs.js";
 import"../chunks/canvas-preview-4e0pxa32.js";
+import"../chunks/canvas-preview-befkjea2.js";
+import"../chunks/canvas-preview-ec2mt7es.js";
+import"../chunks/canvas-preview-y5y6ghaw.js";
 import {
   loadPluginFiles2,
   loadPluginDirectory2,
@@ -76,19 +79,16 @@ import"../chunks/canvas-preview-69fkk9yn.js";
 import"../chunks/canvas-preview-zaaj99wd.js";
 import"../chunks/canvas-preview-0cmbkp2j.js";
 import {
-  StoreOwned2
-} from "../chunks/canvas-preview-a3yw0j70.js";
-import {
+  storePath2,
   sqliteStore2
-} from "../chunks/canvas-preview-evh92ywd.js";
+} from "../chunks/canvas-preview-tnqe7k0b.js";
 import {
   openHost2
-} from "../chunks/canvas-preview-vax9ne4e.js";
+} from "../chunks/canvas-preview-cawy6vbz.js";
 import {
   postgresStore2
 } from "../chunks/canvas-preview-4b6sayhg.js";
 export {
-  StoreOwned2 as StoreOwned,
   TEXT_LIMIT2 as TEXT_LIMIT,
   addWorktree2 as addWorktree,
   createMcpHub2 as createMcpHub,
@@ -116,5 +116,6 @@ export {
   postgresStore2 as postgresStore,
   sealSecret2 as sealSecret,
   seedSigner2 as seedSigner,
-  sqliteStore2 as sqliteStore
+  sqliteStore2 as sqliteStore,
+  storePath2 as storePath
 };

package/dist/src/listen-fetch.js

@@ -1,8 +1,8 @@
 import {
   listenFetch2
-} from "../chunks/canvas-preview-76fwvd6e.js";
-import"../chunks/canvas-preview-d9wwhbtz.js";
-import"../chunks/canvas-preview-m02v4yy6.js";
+} from "../chunks/canvas-preview-w54ymtb3.js";
+import"../chunks/canvas-preview-aq5j4p25.js";
+import"../chunks/canvas-preview-55s0y68g.js";
 import"../chunks/canvas-preview-rp4x6y1h.js";
 export {
   listenFetch2 as listenFetch

package/dist/src/listen.js

@@ -1,9 +1,9 @@
 import {
   listen2
-} from "../chunks/canvas-preview-98aj5p34.js";
-import"../chunks/canvas-preview-76fwvd6e.js";
-import"../chunks/canvas-preview-d9wwhbtz.js";
-import"../chunks/canvas-preview-m02v4yy6.js";
+} from "../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";
 export {
   listen2 as listen

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

@@ -1,3 +1,4 @@
+import type { ChildProcess, SpawnOptions } from "node:child_process";
 export type Ran = {
     readonly code: number | null;
     readonly stdout: Buffer;
@@ -12,4 +13,8 @@ export declare function run(file: string, args: readonly string[], options: {
     /** Kills the command after this long; it then ends with a null code. */
     readonly timeoutMs?: number;
 }): Promise<Ran>;
+/** Spawns `file` as `spawn` does, except that on Windows a `.cmd` or `.bat` file runs through `cmd.exe` with its arguments escaped, as Node no longer starts batch files without a shell. */
+export declare function spawnCommand(file: string, args: readonly string[], options: SpawnOptions): ChildProcess;
+/** Ends `child` with `signal`; on Windows, which has no signals, it ends the child's whole process tree with `taskkill /T /F`, as `kill` alone would leave what a batch file or a shell started running. */
+export declare function killTree(child: ChildProcess, signal: NodeJS.Signals): void;
 export declare function findExecutable(name: string, directories?: readonly string[]): Promise<string | null>;

package/dist/src/local/command.js

@@ -1,8 +1,12 @@
 import {
   run2,
+  spawnCommand2,
+  killTree2,
   findExecutable2
-} from "../../chunks/canvas-preview-azg56359.js";
+} from "../../chunks/canvas-preview-bxnqt8cd.js";
 export {
   findExecutable2 as findExecutable,
-  run2 as run
+  killTree2 as killTree,
+  run2 as run,
+  spawnCommand2 as spawnCommand
 };

package/dist/src/local/files.js

@@ -1,10 +1,10 @@
 import {
   TEXT_LIMIT2,
   localFiles2
-} from "../../chunks/canvas-preview-ymgz0937.js";
+} from "../../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-bxnqt8cd.js";
 import"../../chunks/canvas-preview-0nq75h9k.js";
 import"../../chunks/canvas-preview-mgcx2b2p.js";
 export {

package/dist/src/local/git-watch.d.ts

@@ -11,5 +11,5 @@ export type Repository = {
 export type GitWatcher = {
     subscribe(listener: (status: GitStatus) => void, fail: FeedSink<GitStatus>["fail"]): Disposer;
 };
-/** Returns the status watch `localGit` shares among its watchers: the first subscriber starts it and the last one stops it, and each gets the status at once, then again whenever a change could move it. A recursive `fs.watch` on the workspace hears worktree paths that `.gitignore` and `.git/info/exclude` do not ignore, and, in the git directory and the common directory, only HEAD, the index, branch and remote refs, `packed-refs`, `config` and the merge, cherry-pick, revert and rebase state, so object writes, logs and Nyte's snapshot refs read nothing; the `.git` entry itself appearing or going drops the remembered repository and starts over. Only where `fs.watch` is unavailable does it poll, every 2 s. */
+/** Returns the status watch `localGit` shares among its watchers: the first subscriber starts it and the last one stops it, and each gets the status at once, then again whenever a change could move it. A recursive `fs.watch` on the workspace hears worktree paths that `.gitignore` and `.git/info/exclude` do not ignore, and, in the git directory and the common directory, only HEAD, the index, branch and remote refs, `packed-refs`, `config` and the merge, cherry-pick, revert and rebase state, so object writes, logs and Nyte's snapshot refs read nothing; the `.git` entry itself appearing or going (not a change inside it, which Windows also reports on the folder) drops the remembered repository and starts over. Only where `fs.watch` is unavailable does it poll, every 2 s. */
 export declare function createWatcher(cwd: string, read: () => Promise<GitStatus>, repository: () => Promise<Repository | null>, forget: () => void): GitWatcher;

package/dist/src/local/git-watch.js

@@ -1,6 +1,6 @@
 import {
   createWatcher2
-} from "../../chunks/canvas-preview-zn2d0k9d.js";
+} from "../../chunks/canvas-preview-af86jz8t.js";
 import"../../chunks/canvas-preview-mgcx2b2p.js";
 export {
   createWatcher2 as createWatcher

package/dist/src/local/git.js

@@ -1,11 +1,11 @@
 import {
   localGit2
-} from "../../chunks/canvas-preview-xn10d4f8.js";
+} from "../../chunks/canvas-preview-5ekjx6sw.js";
 import"../../chunks/canvas-preview-tjhabynd.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/github.js

@@ -1,8 +1,8 @@
 import {
   localGitHubAccount2,
   localGitHub2
-} from "../../chunks/canvas-preview-75db60xy.js";
-import"../../chunks/canvas-preview-azg56359.js";
+} from "../../chunks/canvas-preview-8xc0vn7v.js";
+import"../../chunks/canvas-preview-bxnqt8cd.js";
 export {
   localGitHub2 as localGitHub,
   localGitHubAccount2 as localGitHubAccount

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-g5fkjs34.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-cawy6vbz.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-g5fkjs34.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-tnqe7k0b.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-tnqe7k0b.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-11nadadc.js";
 import"../chunks/canvas-preview-srgfpdmf.js";
+import"../chunks/canvas-preview-tnqe7k0b.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-fxa0rfb0.js";
+import"../chunks/canvas-preview-k1yg4fgp.js";
+import"../chunks/canvas-preview-11nadadc.js";
+import"../chunks/canvas-preview-kp75gb63.js";
 import"../chunks/canvas-preview-srgfpdmf.js";
+import"../chunks/canvas-preview-tnqe7k0b.js";
+import"../chunks/canvas-preview-zaaj99wd.js";
+import"../chunks/canvas-preview-0cmbkp2j.js";
 import"../chunks/canvas-preview-69fkk9yn.js";
 export {
   UsageScanner2 as UsageScanner,