@ours.network/cli 1.0.1 → 2.0.1

package/dist/{chunk-QRNZFPNJ.js → chunk-MS4TDUZY.js}

@@ -8,7 +8,6 @@ var str = (help, required = false, values, valueName = "TEXT", allowEmpty = fals
 var bool = (help, required = false) => ({ kind: "boolean", help, valueName: "true|false", required });
 var integer = (help, required = false, positive = false) => ({ kind: "integer", help, valueName: "N", required, positive });
 var strings = (help, required = false) => ({ kind: "string[]", help, valueName: "VALUE,...", required });
-var integers = (help, required = false) => ({ kind: "integer[]", help, valueName: "N,...", required });
 var none = {};
 var OPERATION_SPECS = {
   "create-identity": {
@@ -210,55 +209,55 @@ var OPERATION_SPECS = {
     }
   },
   "list-incoming-messages": { method: "listIncomingMessages", fields: none, summary: "List inbox metadata and status without revealing message bodies.", effects: "Read-only; message status is unchanged." },
-  "get-messages": { method: "getMessages", fields: none, summary: "Return every unread message body and mark those messages processed.", effects: "Mutates inbox status. This is the only message-body read and is exactly-once unless the returned message IDs are deferred." },
-  "defer-messages": {
-    method: "deferMessages",
-    fields: { msg_ids: integers("Comma-separated numeric message IDs to return to unread state.", true) },
-    summary: "Return processed messages to the unread queue.",
-    effects: "Mutates inbox status.",
-    exampleInput: { msg_ids: [12, 13] }
+  "get-messages": {
+    method: "getMessages",
+    fields: { limit: integer("Maximum unread messages to return (default 50, maximum 200).", false, true) },
+    summary: "Return the oldest unread message bodies and mark exactly those rows read.",
+    effects: "Mutates SQLite inbox state and then best-effort attempts body-free read receipts."
   },
-  "defer-files": {
-    method: "deferFiles",
-    fields: { file_ids: integers("Comma-separated numeric file IDs\u2014not wire IDs\u2014to return to unread state.", true) },
-    summary: "Return processed files to the unread queue.",
-    effects: "Mutates inbox status; already-unread files are left unchanged.",
-    exampleInput: { file_ids: [4, 5] }
-  },
-  "get-conversation": {
-    method: "getConversation",
-    fields: { contact: str("Contact name or container ID.", true, void 0, "CONTACT") },
-    summary: "Show retained conversation history with one contact, oldest first.",
-    effects: "Read-only. It is empty when history retention is disabled.",
-    exampleInput: { contact: "Peer" }
+  "list-history": {
+    method: "listHistory",
+    fields: {
+      peer_cid: str("Filter by authenticated peer container ID.", false, void 0, "CID"),
+      direction: str("Filter by direction.", false, ["in", "out"], "in|out"),
+      before_seq: integer("Return rows before this cursor.", false, true),
+      limit: integer("Maximum rows to return (default 50, maximum 200).", false, true)
+    },
+    summary: "List persistent message history newest first with cursor pagination.",
+    effects: "Read-only."
   },
-  "get-receipts": {
-    method: "getReceipts",
-    fields: { contact: str("Contact name or container ID.", true, void 0, "CONTACT") },
-    summary: "Show delivered/read receipts received for sent messages.",
-    effects: "Read-only. Receipts are retained only when conversation history is enabled.",
-    exampleInput: { contact: "Peer" }
+  "get-history-item": {
+    method: "getHistoryItem",
+    fields: { wire_id: str("Exact message wire ID.", true, void 0, "WIRE_ID") },
+    summary: "Look up one persistent message-history item by wire ID.",
+    effects: "Read-only."
   },
-  "mark-read": {
-    method: "markRead",
-    fields: { contact: str("Contact name or container ID.", true, void 0, "CONTACT") },
-    summary: "Mark unread inbound entries in one conversation as read.",
-    effects: "Mutates conversation state and sends read receipts for newly marked messages.",
-    exampleInput: { contact: "Peer" }
+  "list-files": {
+    method: "listFiles",
+    fields: {
+      peer_cid: str("Filter by authenticated peer container ID.", false, void 0, "CID"),
+      direction: str("Filter by direction.", false, ["in", "out"], "in|out"),
+      before_seq: integer("Return rows before this cursor.", false, true),
+      limit: integer("Maximum rows to return (default 50, maximum 200).", false, true)
+    },
+    summary: "List persistent file history newest first with cursor pagination.",
+    effects: "Read-only; returns metadata, not bytes."
   },
-  "set-conversation-policy": {
-    method: "setConversationPolicy",
-    fields: { keep_history: bool("Enable or disable retained conversation history and receipt support.", true) },
-    summary: "Set conversation-history policy for the bound identity.",
-    effects: "Writes identity-local policy. Existing contacts learn newly enabled receipt capability on later outbound traffic.",
-    exampleInput: { keep_history: true }
+  "get-file-info": {
+    method: "getFileInfo",
+    fields: { wire_id: str("Exact file wire ID.", true, void 0, "WIRE_ID") },
+    summary: "Look up one persistent file-history item by wire ID.",
+    effects: "Read-only; returns metadata, not bytes."
   },
   "list-incoming-files": { method: "listIncomingFiles", fields: none, summary: "List incoming-file metadata for authorization.", effects: "Read-only: returns no bytes and does not change file status. Authorize using the authenticated sender ID, not its display name." },
   "get-files": {
     method: "getFiles",
-    fields: { wire_ids: strings("Comma-separated unread file wire IDs; omit to retrieve every unread file.") },
-    summary: "Write approved unread files into the bound identity\u2019s files directory.",
-    effects: "Writes received bytes and marks retrieved files processed. An explicit selection must contain 1\u201332 unique 64-hex wire IDs.",
+    fields: {
+      wire_ids: strings("Comma-separated unread file wire IDs; omit for an oldest-first batch."),
+      limit: integer("Maximum files in an unselected batch (default 50, maximum 200).", false, true)
+    },
+    summary: "Return immutable blob paths for approved unread files.",
+    effects: "Marks retrieved SQLite file rows read. An explicit selection must contain 1\u201332 unique 64-hex wire IDs.",
     exampleInput: { wire_ids: ["0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"] }
   },
   version: { method: "version", fields: none, summary: "Show the selected daemon\u2019s version and protocol information.", effects: "Read-only." },

package/dist/{chunk-QZIL3IT7.js → chunk-NRPPG3WH.js}

@@ -87,7 +87,7 @@ function childEnvironment(selection) {
 async function serveDaemon(selection, managed = false) {
   if (selection.endpoint !== void 0) throw new Error("--endpoint selects a running daemon and cannot be used with daemon serve");
   Object.assign(process.env, childEnvironment(selection));
-  const { startDaemon } = await import("./daemon-UUG6P6GK.js");
+  const { startDaemon } = await import("./daemon-YCC24SVU.js");
   const handle = await startDaemon();
   if (managed) {
     const response = await fetch(`http://127.0.0.1:${handle.port}/state-dir`);

package/dist/{chunk-SDNTPCKW.js → chunk-NWRXKQBD.js}

@@ -118,31 +118,29 @@ var COMMAND_GROUPS = {
     }
   },
   message: {
-    summary: "Send encrypted text and manage the incoming message queue.",
+    summary: "Send encrypted text and consume the SQLite-backed unread queue.",
     commands: {
       send: operation("send-message"),
       list: operation("list-incoming-messages"),
-      get: operation("get-messages"),
-      defer: operation("defer-messages")
+      get: operation("get-messages")
     }
   },
   file: {
-    summary: "Send encrypted files and authorize, retrieve, or defer received files.",
+    summary: "Send encrypted files and authorize or retrieve received files.",
     commands: {
       send: operation("send-file"),
       list: operation("list-incoming-files"),
       get: operation("get-files"),
-      fetch: operation("fetch-file"),
-      defer: operation("defer-files")
+      fetch: operation("fetch-file")
     }
   },
-  conversation: {
-    summary: "Inspect retained conversations and receipts, mark them read, and set retention policy.",
+  history: {
+    summary: "Inspect persistent SQLite-backed message and file history.",
     commands: {
-      show: operation("get-conversation"),
-      receipts: operation("get-receipts"),
-      "mark-read": operation("mark-read"),
-      policy: operation("set-conversation-policy")
+      list: operation("list-history"),
+      get: operation("get-history-item"),
+      files: operation("list-files"),
+      "file-info": operation("get-file-info")
     }
   }
 };

package/dist/commands.d.ts

@@ -143,36 +143,34 @@ export declare const COMMAND_GROUPS: {
         };
     };
     readonly message: {
-        readonly summary: "Send encrypted text and manage the incoming message queue.";
+        readonly summary: "Send encrypted text and consume the SQLite-backed unread queue.";
         readonly commands: {
             readonly send: OperationCommandSpec;
             readonly list: OperationCommandSpec;
             readonly get: OperationCommandSpec;
-            readonly defer: OperationCommandSpec;
         };
     };
     readonly file: {
-        readonly summary: "Send encrypted files and authorize, retrieve, or defer received files.";
+        readonly summary: "Send encrypted files and authorize or retrieve received files.";
         readonly commands: {
             readonly send: OperationCommandSpec;
             readonly list: OperationCommandSpec;
             readonly get: OperationCommandSpec;
             readonly fetch: OperationCommandSpec;
-            readonly defer: OperationCommandSpec;
         };
     };
-    readonly conversation: {
-        readonly summary: "Inspect retained conversations and receipts, mark them read, and set retention policy.";
+    readonly history: {
+        readonly summary: "Inspect persistent SQLite-backed message and file history.";
         readonly commands: {
-            readonly show: OperationCommandSpec;
-            readonly receipts: OperationCommandSpec;
-            readonly 'mark-read': OperationCommandSpec;
-            readonly policy: OperationCommandSpec;
+            readonly list: OperationCommandSpec;
+            readonly get: OperationCommandSpec;
+            readonly files: OperationCommandSpec;
+            readonly 'file-info': OperationCommandSpec;
         };
     };
 };
 export type CommandGroup = keyof typeof COMMAND_GROUPS;
-export declare const DESTRUCTIVE_OPERATIONS: Set<"version" | "identities" | "unread" | "create-identity" | "create-temporary-identity" | "close-temporary-identity" | "create-root-identity" | "define-local-identity-file" | "choose-identity" | "list-identities" | "current-identity" | "remove-identity" | "release-lease" | "generate-invite" | "list-invites" | "revoke-invite" | "add-contact" | "list-contacts" | "list-local-contact-book" | "set-local-book-policy" | "remove-contact" | "rename-contact" | "respond-to-introduction" | "set-bio" | "set-persona" | "send-message" | "send-file" | "list-incoming-messages" | "get-messages" | "defer-messages" | "defer-files" | "get-conversation" | "get-receipts" | "mark-read" | "set-conversation-policy" | "list-incoming-files" | "get-files" | "state-dir" | "watch-notifications" | "fetch-file">;
-export declare const IDENTITY_PREBIND_EXCEPTIONS: Set<"version" | "identities" | "unread" | "create-identity" | "create-temporary-identity" | "close-temporary-identity" | "create-root-identity" | "define-local-identity-file" | "choose-identity" | "list-identities" | "current-identity" | "remove-identity" | "release-lease" | "generate-invite" | "list-invites" | "revoke-invite" | "add-contact" | "list-contacts" | "list-local-contact-book" | "set-local-book-policy" | "remove-contact" | "rename-contact" | "respond-to-introduction" | "set-bio" | "set-persona" | "send-message" | "send-file" | "list-incoming-messages" | "get-messages" | "defer-messages" | "defer-files" | "get-conversation" | "get-receipts" | "mark-read" | "set-conversation-policy" | "list-incoming-files" | "get-files" | "state-dir" | "watch-notifications" | "fetch-file">;
+export declare const DESTRUCTIVE_OPERATIONS: Set<"version" | "identities" | "unread" | "create-identity" | "create-temporary-identity" | "close-temporary-identity" | "create-root-identity" | "define-local-identity-file" | "choose-identity" | "list-identities" | "current-identity" | "remove-identity" | "release-lease" | "generate-invite" | "list-invites" | "revoke-invite" | "add-contact" | "list-contacts" | "list-local-contact-book" | "set-local-book-policy" | "remove-contact" | "rename-contact" | "respond-to-introduction" | "set-bio" | "set-persona" | "send-message" | "send-file" | "list-incoming-messages" | "get-messages" | "list-history" | "get-history-item" | "list-files" | "get-file-info" | "list-incoming-files" | "get-files" | "state-dir" | "watch-notifications" | "fetch-file">;
+export declare const IDENTITY_PREBIND_EXCEPTIONS: Set<"version" | "identities" | "unread" | "create-identity" | "create-temporary-identity" | "close-temporary-identity" | "create-root-identity" | "define-local-identity-file" | "choose-identity" | "list-identities" | "current-identity" | "remove-identity" | "release-lease" | "generate-invite" | "list-invites" | "revoke-invite" | "add-contact" | "list-contacts" | "list-local-contact-book" | "set-local-book-policy" | "remove-contact" | "rename-contact" | "respond-to-introduction" | "set-bio" | "set-persona" | "send-message" | "send-file" | "list-incoming-messages" | "get-messages" | "list-history" | "get-history-item" | "list-files" | "get-file-info" | "list-incoming-files" | "get-files" | "state-dir" | "watch-notifications" | "fetch-file">;
 export declare function isCommandGroup(value: string): value is CommandGroup;
 export declare function commandSpec(group: CommandGroup, command: string): CommandSpec | undefined;

package/dist/commands.js

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

package/dist/{daemon-UUG6P6GK.js → daemon-YCC24SVU.js}

@@ -204,7 +204,7 @@ async function releaseHeld(lock) {
 async function bootKernel() {
   const { lock, acquired } = await ensureLock();
   try {
-    const { bootWrapper } = await import("./boot-35BOHNSZ.js");
+    const { bootWrapper } = await import("./boot-LJ2V4NSS.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-TDJBEWTU.js");
+    const runtime = await import("./server-2RIEOKDA.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-ZFE47KH3.js";
-import "./chunk-QRNZFPNJ.js";
+} from "./chunk-FKSRG5UJ.js";
+import "./chunk-MS4TDUZY.js";
 import "./chunk-6NFATG6P.js";
-import "./chunk-SDNTPCKW.js";
+import "./chunk-NWRXKQBD.js";
 export {
   helpHint,
   helpRequestPath,

package/dist/lifecycle.js

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

package/dist/main.js

@@ -17,7 +17,7 @@ import {
   helpHint,
   helpRequestPath,
   renderHelp
-} from "./chunk-ZFE47KH3.js";
+} from "./chunk-FKSRG5UJ.js";
 import {
   invokeOperation,
   isOperationName,
@@ -26,7 +26,7 @@ import {
   operationNames,
   operationValueFlags,
   parseOperationJson
-} from "./chunk-QRNZFPNJ.js";
+} from "./chunk-MS4TDUZY.js";
 import {
   CliUsageError,
   parseFlags,
@@ -37,13 +37,13 @@ import {
   IDENTITY_PREBIND_EXCEPTIONS,
   commandSpec,
   isCommandGroup
-} from "./chunk-SDNTPCKW.js";
+} from "./chunk-NWRXKQBD.js";
 import {
   inspectDaemon,
   serveDaemon,
   startDaemonManaged,
   stopDaemonManaged
-} from "./chunk-QZIL3IT7.js";
+} from "./chunk-NRPPG3WH.js";
 import {
   attachClient,
   defaultConfigPath,
@@ -54,7 +54,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" : "1.0.1";
+var CLI_VERSION = false ? "0.0.0-dev" : "2.0.1";
 var COMMON_VALUES = /* @__PURE__ */ new Set(["--endpoint", "--port", "--state-dir", "--config", "--identity"]);
 var COMMON_BOOLEANS = /* @__PURE__ */ new Set(["--json", "--yes", "--help"]);
 function selectionFrom(values) {

package/dist/operations.d.ts

@@ -315,75 +315,49 @@ export declare const OPERATION_SPECS: {
     };
     readonly 'get-messages': {
         readonly method: "getMessages";
-        readonly fields: {};
-        readonly summary: "Return every unread message body and mark those messages processed.";
-        readonly effects: "Mutates inbox status. This is the only message-body read and is exactly-once unless the returned message IDs are deferred.";
-    };
-    readonly 'defer-messages': {
-        readonly method: "deferMessages";
-        readonly fields: {
-            readonly msg_ids: FieldSpec;
-        };
-        readonly summary: "Return processed messages to the unread queue.";
-        readonly effects: "Mutates inbox status.";
-        readonly exampleInput: {
-            readonly msg_ids: readonly [12, 13];
-        };
-    };
-    readonly 'defer-files': {
-        readonly method: "deferFiles";
         readonly fields: {
-            readonly file_ids: FieldSpec;
-        };
-        readonly summary: "Return processed files to the unread queue.";
-        readonly effects: "Mutates inbox status; already-unread files are left unchanged.";
-        readonly exampleInput: {
-            readonly file_ids: readonly [4, 5];
+            readonly limit: FieldSpec;
         };
+        readonly summary: "Return the oldest unread message bodies and mark exactly those rows read.";
+        readonly effects: "Mutates SQLite inbox state and then best-effort attempts body-free read receipts.";
     };
-    readonly 'get-conversation': {
-        readonly method: "getConversation";
+    readonly 'list-history': {
+        readonly method: "listHistory";
         readonly fields: {
-            readonly contact: FieldSpec;
-        };
-        readonly summary: "Show retained conversation history with one contact, oldest first.";
-        readonly effects: "Read-only. It is empty when history retention is disabled.";
-        readonly exampleInput: {
-            readonly contact: "Peer";
+            readonly peer_cid: FieldSpec;
+            readonly direction: FieldSpec;
+            readonly before_seq: FieldSpec;
+            readonly limit: FieldSpec;
         };
+        readonly summary: "List persistent message history newest first with cursor pagination.";
+        readonly effects: "Read-only.";
     };
-    readonly 'get-receipts': {
-        readonly method: "getReceipts";
+    readonly 'get-history-item': {
+        readonly method: "getHistoryItem";
         readonly fields: {
-            readonly contact: FieldSpec;
-        };
-        readonly summary: "Show delivered/read receipts received for sent messages.";
-        readonly effects: "Read-only. Receipts are retained only when conversation history is enabled.";
-        readonly exampleInput: {
-            readonly contact: "Peer";
+            readonly wire_id: FieldSpec;
         };
+        readonly summary: "Look up one persistent message-history item by wire ID.";
+        readonly effects: "Read-only.";
     };
-    readonly 'mark-read': {
-        readonly method: "markRead";
+    readonly 'list-files': {
+        readonly method: "listFiles";
         readonly fields: {
-            readonly contact: FieldSpec;
-        };
-        readonly summary: "Mark unread inbound entries in one conversation as read.";
-        readonly effects: "Mutates conversation state and sends read receipts for newly marked messages.";
-        readonly exampleInput: {
-            readonly contact: "Peer";
+            readonly peer_cid: FieldSpec;
+            readonly direction: FieldSpec;
+            readonly before_seq: FieldSpec;
+            readonly limit: FieldSpec;
         };
+        readonly summary: "List persistent file history newest first with cursor pagination.";
+        readonly effects: "Read-only; returns metadata, not bytes.";
     };
-    readonly 'set-conversation-policy': {
-        readonly method: "setConversationPolicy";
+    readonly 'get-file-info': {
+        readonly method: "getFileInfo";
         readonly fields: {
-            readonly keep_history: FieldSpec;
-        };
-        readonly summary: "Set conversation-history policy for the bound identity.";
-        readonly effects: "Writes identity-local policy. Existing contacts learn newly enabled receipt capability on later outbound traffic.";
-        readonly exampleInput: {
-            readonly keep_history: true;
+            readonly wire_id: FieldSpec;
         };
+        readonly summary: "Look up one persistent file-history item by wire ID.";
+        readonly effects: "Read-only; returns metadata, not bytes.";
     };
     readonly 'list-incoming-files': {
         readonly method: "listIncomingFiles";
@@ -395,9 +369,10 @@ export declare const OPERATION_SPECS: {
         readonly method: "getFiles";
         readonly fields: {
             readonly wire_ids: FieldSpec;
+            readonly limit: FieldSpec;
         };
-        readonly summary: "Write approved unread files into the bound identity’s files directory.";
-        readonly effects: "Writes received bytes and marks retrieved files processed. An explicit selection must contain 1–32 unique 64-hex wire IDs.";
+        readonly summary: "Return immutable blob paths for approved unread files.";
+        readonly effects: "Marks retrieved SQLite file rows read. An explicit selection must contain 1–32 unique 64-hex wire IDs.";
         readonly exampleInput: {
             readonly wire_ids: readonly ["0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"];
         };

package/dist/operations.js

@@ -9,7 +9,7 @@ import {
   operationSpec,
   operationValueFlags,
   parseOperationJson
-} from "./chunk-QRNZFPNJ.js";
+} from "./chunk-MS4TDUZY.js";
 import "./chunk-6NFATG6P.js";
 export {
   OPERATION_SPECS,