@ours.network/cli 2.0.4 → 2.1.0

package/dist/commands.d.ts

@@ -96,7 +96,7 @@ export declare const COMMAND_GROUPS: {
                 readonly handler: "setup";
                 readonly summary: "Write one or more safe daemon settings noninteractively.";
                 readonly effects: "Writes a mode-0600 JSON config unless --dry-run is used. Unknown and secret fields already present are preserved and never printed.";
-                readonly example: "ours config setup --port 3070 --state-dir /srv/ours-a --api-visibility owner";
+                readonly example: "ours config setup --port 3070 --state-dir /srv/ours-a --history-max-bytes 104857600 --api-visibility owner";
             };
         };
     };

package/dist/commands.js

@@ -4,7 +4,7 @@ import {
   IDENTITY_PREBIND_EXCEPTIONS,
   commandSpec,
   isCommandGroup
-} from "./chunk-QKDH6CJR.js";
+} from "./chunk-GQHDQR6I.js";
 export {
   COMMAND_GROUPS,
   DESTRUCTIVE_OPERATIONS,

package/dist/config-command.js

@@ -1,7 +1,7 @@
 import {
   setupConfig,
   showConfig
-} from "./chunk-DRQEV4SN.js";
+} from "./chunk-3C5WAQAT.js";
 import "./chunk-6K2JBKHI.js";
 export {
   setupConfig,

package/dist/{daemon-LTJHJDWZ.js → daemon-5UZIR37V.js}

@@ -1,7 +1,7 @@
 import {
   assertConfigNotDrifted,
   loadConfig
-} from "./chunk-FXKFSNKS.js";
+} from "./chunk-DTWZF3ZG.js";
 
 // ../../src/internal/daemon.ts
 import * as fs2 from "node:fs";
@@ -204,7 +204,7 @@ async function releaseHeld(lock) {
 async function bootKernel() {
   const { lock, acquired } = await ensureLock();
   try {
-    const { bootWrapper } = await import("./boot-HNJ7ZR5L.js");
+    const { bootWrapper } = await import("./boot-QLA3LXVX.js");
     await bootWrapper();
   } catch (error) {
     if (acquired) await releaseHeld(lock);
@@ -214,7 +214,7 @@ async function bootKernel() {
 async function startDaemon(opts = {}) {
   const { lock, acquired } = await ensureLock();
   try {
-    const runtime = await import("./server-35QOYLY4.js");
+    const runtime = await import("./server-3PM3QOPD.js");
     const { onRuntimeLoaded, ...daemonOptions } = opts;
     onRuntimeLoaded?.();
     const handle = await runtime.startDaemon({

package/dist/help.js

@@ -3,10 +3,10 @@ import {
   helpRequestPath,
   renderHelp,
   renderTopHelp
-} from "./chunk-NNHFXFLS.js";
+} from "./chunk-H7DX6EHZ.js";
 import "./chunk-MS4TDUZY.js";
 import "./chunk-6NFATG6P.js";
-import "./chunk-QKDH6CJR.js";
+import "./chunk-GQHDQR6I.js";
 export {
   helpHint,
   helpRequestPath,

package/dist/lifecycle.js

@@ -10,7 +10,7 @@ import {
   startDaemonManaged,
   stopDaemonManaged,
   writeManagedRecord
-} from "./chunk-DZH2YEXT.js";
+} from "./chunk-UHYUIHM2.js";
 import "./chunk-6K2JBKHI.js";
 export {
   DAEMON_LOG_FILE,

package/dist/main.js

@@ -12,12 +12,12 @@ import {
 import {
   setupConfig,
   showConfig
-} from "./chunk-DRQEV4SN.js";
+} from "./chunk-3C5WAQAT.js";
 import {
   helpHint,
   helpRequestPath,
   renderHelp
-} from "./chunk-NNHFXFLS.js";
+} from "./chunk-H7DX6EHZ.js";
 import {
   invokeOperation,
   isOperationName,
@@ -37,14 +37,14 @@ import {
   IDENTITY_PREBIND_EXCEPTIONS,
   commandSpec,
   isCommandGroup
-} from "./chunk-QKDH6CJR.js";
+} from "./chunk-GQHDQR6I.js";
 import {
   DEFAULT_DAEMON_READINESS_TIMEOUT_MS,
   inspectDaemon,
   serveDaemon,
   startDaemonManaged,
   stopDaemonManaged
-} from "./chunk-DZH2YEXT.js";
+} from "./chunk-UHYUIHM2.js";
 import {
   attachClient,
   defaultConfigPath,
@@ -55,7 +55,7 @@ import {
 import { existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join, resolve } from "node:path";
-var CLI_VERSION = false ? "0.0.0-dev" : "2.0.4";
+var CLI_VERSION = false ? "0.0.0-dev" : "2.1.0";
 var COMMON_VALUES = /* @__PURE__ */ new Set(["--endpoint", "--port", "--state-dir", "--config", "--identity"]);
 var COMMON_BOOLEANS = /* @__PURE__ */ new Set(["--json", "--yes", "--help"]);
 var DAEMON_READINESS_TIMEOUT_ENV = "OURS_DAEMON_READINESS_TIMEOUT_MS";
@@ -164,7 +164,13 @@ async function runGrouped(group, args, io) {
   return 0;
 }
 async function runConfig(args, io) {
-  const values = /* @__PURE__ */ new Set([...COMMON_VALUES, "--broker-url", "--gc-interval-ms", "--api-visibility"]);
+  const values = /* @__PURE__ */ new Set([
+    ...COMMON_VALUES,
+    "--broker-url",
+    "--gc-interval-ms",
+    "--history-max-bytes",
+    "--api-visibility"
+  ]);
   const flags = parseFlags(args, values, /* @__PURE__ */ new Set(["--json", "--dry-run", "--help"]));
   const action = flags.positionals[0];
   const spec = action === void 0 ? void 0 : commandSpec("config", action);
@@ -179,6 +185,9 @@ async function runConfig(args, io) {
   if (flags.values["--port"]) patch.port = parseInteger(flags.values["--port"], "--port", 1, 65535);
   if (flags.values["--state-dir"]) patch.stateDir = resolve(flags.values["--state-dir"]);
   if (flags.values["--gc-interval-ms"]) patch.gcIntervalMs = parseInteger(flags.values["--gc-interval-ms"], "--gc-interval-ms", 1);
+  if (flags.values["--history-max-bytes"]) {
+    patch.historyMaxBytes = parseInteger(flags.values["--history-max-bytes"], "--history-max-bytes", 0);
+  }
   if (flags.values["--api-visibility"]) {
     const visibility = flags.values["--api-visibility"];
     if (!["owner", "shared", "open"].includes(visibility)) throw new CliUsageError("--api-visibility must be owner, shared, or open");

package/dist/{server-35QOYLY4.js → server-3PM3QOPD.js}

@@ -4,6 +4,7 @@ import {
   CONFIG,
   FILE_SELECTION_CAP,
   GC_INTERVAL_MS,
+  HISTORY_MAX_BYTES,
   PORT,
   PROTOCOL_VERSION,
   STATE_DIR,
@@ -32,11 +33,13 @@ import {
   exportSigningSecret,
   findIdentityFile,
   getFileHistoryItem,
+  getHistoryStorageStatus,
   getMessageHistoryItem,
   getMessageHistorySummary,
   hashLeaseToken,
   identities,
   identityDir,
+  initializeHistoryRetention,
   isSelectableWireId,
   keyPath,
   leaseByToken,
@@ -47,10 +50,12 @@ import {
   listMessageHistory,
   log,
   mutatingTx,
+  noteHistoryStorageMutation,
   openHistory,
   outboundRemovalInFlight,
   persistBindings,
   pidDefinitelyDead,
+  pinHistoryItems,
   pinRegistrar,
   provisionIdentity,
   publishToBook,
@@ -77,12 +82,14 @@ import {
   sessionReaperIntervalMs,
   setNotifyHook,
   startupProgress,
+  stopHistoryRetention,
   structuredVoiceOutcome,
   sttStatus,
   takeUnreadFiles,
   takeUnreadMessages,
   tombstones,
   transcribeVoice,
+  unpinHistoryItems,
   unpublishFromBook,
   unreadSummary,
   validateName,
@@ -91,11 +98,11 @@ import {
   withScopeAsync,
   wrapper,
   writeTempMetaFile
-} from "./chunk-TSYICL3I.js";
+} from "./chunk-YPDZQ4XD.js";
 import {
   buildIdentityFile,
   writeIdentityFile
-} from "./chunk-FXKFSNKS.js";
+} from "./chunk-DTWZF3ZG.js";
 
 // ../../src/http/server.ts
 import { createServer as createHttpServer } from "node:http";
@@ -1467,8 +1474,11 @@ async function getFiles(ctx, a = {}) {
     if (wire_ids.some((wire) => !isSelectableWireId(wire))) throw errMalformedId();
     if (new Set(wire_ids).size !== wire_ids.length) throw errDuplicateId();
   }
+  let pinned = [];
   try {
     const selected = takeUnreadFiles(id, { wire_ids, limit: a.limit });
+    pinned = selected.files.map((file) => file.wire_id);
+    pinHistoryItems(id.dir, "file", pinned);
     const files = [];
     const lines = [];
     for (const file of selected.files) {
@@ -1535,6 +1545,11 @@ ${lines.join("\n")}`,
       throw errUnknownOrStaleId();
     }
     throw errTool("get_files", message);
+  } finally {
+    if (pinned.length > 0) {
+      unpinHistoryItems(id.dir, "file", pinned);
+      noteHistoryStorageMutation(id.dir);
+    }
   }
 }
 function saveFileFallbackNotice(ctx, a) {
@@ -1848,7 +1863,14 @@ function looksLikeInitializeRequest(body) {
   const m = body;
   return m.jsonrpc === "2.0" && m.method === "initialize";
 }
-var LOAD_TIME_CONFIG_FIELDS = ["brokerUrl", "port", "stateDir", "gcIntervalMs", "apiVisibility"];
+var LOAD_TIME_CONFIG_FIELDS = [
+  "brokerUrl",
+  "port",
+  "stateDir",
+  "gcIntervalMs",
+  "historyMaxBytes",
+  "apiVisibility"
+];
 function readBody(req) {
   return new Promise((resolve2, reject) => {
     let data = "";
@@ -1898,6 +1920,10 @@ async function startHttpDaemon(opts) {
   log("booting wrapper\u2026");
   try {
     await bootWrapper();
+    const historyStorage = initializeHistoryRetention(STATE_DIR, HISTORY_MAX_BYTES);
+    log(
+      `history storage ${historyStorage.state} (physical=${historyStorage.physical_bytes}, cap=${historyStorage.max_bytes}, overflow=${historyStorage.overflow_bytes})`
+    );
     startGcTimer();
   } catch (err) {
     if (installedHook) clearNotifyHook(installedHook);
@@ -2027,6 +2053,12 @@ async function startHttpDaemon(opts) {
       res.end(JSON.stringify(unreadSummary()));
       return;
     }
+    if (req.method === "GET" && url.pathname === "/history-storage") {
+      if (!requireAuth(req, res)) return;
+      res.writeHead(200, { "Content-Type": "application/json" });
+      res.end(JSON.stringify(getHistoryStorageStatus()));
+      return;
+    }
     {
       const m = /^\/identities\/([^/]+)\/notifications$/.exec(url.pathname);
       if (req.method === "GET" && m) {
@@ -2223,6 +2255,7 @@ async function startHttpDaemon(opts) {
     torn = true;
     clearInterval(sessionReaper);
     stopGcTimer();
+    stopHistoryRetention();
     if (installedHook) clearNotifyHook(installedHook);
     for (const sid of Object.keys(transports)) {
       try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ours.network/cli",
-  "version": "2.0.4",
+  "version": "2.1.0",
   "description": "Transport-neutral operator CLI for the ours shared daemon",
   "type": "module",
   "license": "FSL-1.1-Apache-2.0",