@hasna/conversations 0.2.33 → 0.2.34

package/bin/index.js

@@ -14928,7 +14928,7 @@ var init_presence = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hasna/conversations",
-    version: "0.2.33",
+    version: "0.2.34",
     description: "Real-time CLI messaging for AI agents",
     type: "module",
     bin: {
@@ -15769,7 +15769,7 @@ async function tmuxSend(target, message, opts = {}) {
 }
 function registerTmuxCommands(program2) {
   const tmux = program2.command("tmux").description("Dispatch messages to tmux windows (Claude Code sessions)");
-  tmux.command("send").description("Send a message to a tmux window with paste+wait+Enter+verify").requiredOption("--target <target>", "Tmux target: session:window or session:window.pane").requiredOption("--message <text>", "Message text to send").option("--delay <ms>", "Wait time (ms) after paste before hitting Enter (default: adaptive 25-1500ms)", parseInt).option("--retries <n>", "Max retry attempts (default: 3)", parseInt).option("--no-verify", "Skip verification after sending").option("--json", "Output result as JSON").action(async (opts) => {
+  tmux.command("send").description("Send a message to a tmux window with paste+wait+Enter+verify").requiredOption("--target <target>", "Tmux target: session:window or session:window.pane").requiredOption("--message <text>", "Message text to send").option("--delay <ms>", "Wait time (ms) after paste before hitting Enter (default: adaptive 25-1500ms)", parseInt).option("--retries <n>", "Max retry attempts (default: 3)", parseInt).option("--no-verify", "Skip verification after sending").option("-j, --json", "Output result as JSON").action(async (opts) => {
     const target = opts.target.trim();
     const message = opts.message;
     if (!target) {
@@ -15804,7 +15804,7 @@ function registerTmuxCommands(program2) {
       process.exit(1);
     }
   });
-  tmux.command("broadcast").description("Send the same message to multiple tmux windows").requiredOption("--targets <list>", "Comma-separated list of tmux targets").requiredOption("--message <text>", "Message text to send").option("--delay <ms>", "Wait time (ms) after paste before Enter (default: adaptive 25-1500ms)", parseInt).option("--stagger <ms>", "Delay (ms) between each target (default: 500)", parseInt).option("--retries <n>", "Max retry attempts per target (default: 3)", parseInt).option("--no-verify", "Skip verification after sending").option("--json", "Output results as JSON").action(async (opts) => {
+  tmux.command("broadcast").description("Send the same message to multiple tmux windows").requiredOption("--targets <list>", "Comma-separated list of tmux targets").requiredOption("--message <text>", "Message text to send").option("--delay <ms>", "Wait time (ms) after paste before Enter (default: adaptive 25-1500ms)", parseInt).option("--stagger <ms>", "Delay (ms) between each target (default: 500)", parseInt).option("--retries <n>", "Max retry attempts per target (default: 3)", parseInt).option("--no-verify", "Skip verification after sending").option("-j, --json", "Output results as JSON").action(async (opts) => {
     const targets = opts.targets.split(",").map((t) => t.trim()).filter(Boolean);
     const message = opts.message;
     const stagger = Number.isFinite(opts.stagger) && opts.stagger >= 0 ? opts.stagger : 500;
@@ -48835,7 +48835,7 @@ init_presence();
 init_db();
 import chalk4 from "chalk";
 function registerMessagingCommands(program2) {
-  program2.command("send").description("Send a message to an agent").argument("<message>", "Message content").option("--to <agent>", "Recipient agent ID (required unless --space is used)").option("--from <agent>", "Sender agent ID").option("--session <id>", "Session ID (auto-generated if omitted)").option("--priority <level>", "Priority: low, normal, high, urgent", "normal").option("--working-dir <path>", "Working directory context").option("--repository <repo>", "Repository context").option("--branch <branch>", "Branch context").option("--metadata <json>", "JSON metadata string").option("--space <name>", "Send to a space instead of a specific agent").option("--blocking", "Send as a blocking message (recipient must acknowledge)").option("--json", "Output as JSON").action((message, opts) => {
+  program2.command("send").description("Send a message to an agent").argument("<message>", "Message content").option("--to <agent>", "Recipient agent ID (required unless --space is used)").option("--from <agent>", "Sender agent ID").option("--session <id>", "Session ID (auto-generated if omitted)").option("--priority <level>", "Priority: low, normal, high, urgent", "normal").option("--working-dir <path>", "Working directory context").option("--repository <repo>", "Repository context").option("--branch <branch>", "Branch context").option("--metadata <json>", "JSON metadata string").option("--space <name>", "Send to a space instead of a specific agent").option("--blocking", "Send as a blocking message (recipient must acknowledge)").option("-j, --json", "Output as JSON").action((message, opts) => {
     const from = resolveIdentity(opts.from).trim();
     const to = typeof opts.to === "string" ? opts.to.trim() : "";
     const space = typeof opts.space === "string" ? opts.space.trim() : "";
@@ -48884,7 +48884,7 @@ function registerMessagingCommands(program2) {
     }
     closeDb();
   });
-  program2.command("read").description("Read messages").option("--session <id>", "Filter by session ID").option("--from <agent>", "Filter by sender").option("--to <agent>", "Filter by recipient").option("--space <name>", "Filter by space").option("--since <timestamp>", "Messages after this ISO timestamp").option("--limit <n>", "Max messages to return", parseInt).option("--unread", "Only unread messages").option("--mark-read", "Mark returned messages as read").option("--json", "Output as JSON").action((opts) => {
+  program2.command("read").description("Read messages").option("--session <id>", "Filter by session ID").option("--from <agent>", "Filter by sender").option("--to <agent>", "Filter by recipient").option("--space <name>", "Filter by space").option("--since <timestamp>", "Messages after this ISO timestamp").option("--limit <n>", "Max messages to return", parseInt).option("--unread", "Only unread messages").option("--mark-read", "Mark returned messages as read").option("-j, --json", "Output as JSON").action((opts) => {
     const messages = readMessages({
       session_id: opts.session,
       from: opts.from,
@@ -48929,7 +48929,7 @@ function registerMessagingCommands(program2) {
     }
     closeDb();
   });
-  program2.command("digest").description("Show unread message digest (preview only, auto-marks read)").argument("[space]", "Space name to digest (omit for DMs)").option("--since <timestamp>", "Messages after this ISO timestamp").option("--limit <n>", "Max messages to show", parseInt).option("--to <agent>", "Filter by recipient (for DMs)").option("--json", "Output as JSON").action((spaceArg, opts) => {
+  program2.command("digest").description("Show unread message digest (preview only, auto-marks read)").argument("[space]", "Space name to digest (omit for DMs)").option("--since <timestamp>", "Messages after this ISO timestamp").option("--limit <n>", "Max messages to show", parseInt).option("--to <agent>", "Filter by recipient (for DMs)").option("-j, --json", "Output as JSON").action((spaceArg, opts) => {
     const result = readDigest({
       space: spaceArg || undefined,
       since: opts.since,
@@ -48956,7 +48956,7 @@ function registerMessagingCommands(program2) {
     }
     closeDb();
   });
-  program2.command("search").description("Search messages by content").argument("<query>", "Search query string").option("--space <name>", "Filter by space").option("--from <agent>", "Filter by sender").option("--to <agent>", "Filter by recipient").option("--limit <n>", "Max results to return", parseInt).option("--json", "Output as JSON").action((query, opts) => {
+  program2.command("search").description("Search messages by content").argument("<query>", "Search query string").option("--space <name>", "Filter by space").option("--from <agent>", "Filter by sender").option("--to <agent>", "Filter by recipient").option("--limit <n>", "Max results to return", parseInt).option("-j, --json", "Output as JSON").action((query, opts) => {
     const q = typeof query === "string" ? query.trim() : "";
     if (!q) {
       console.error(chalk4.red("Search query cannot be empty."));
@@ -48989,7 +48989,7 @@ function registerMessagingCommands(program2) {
     }
     closeDb();
   });
-  program2.command("since").description("Show all activity (DMs + spaces) since a duration ago").argument("<duration>", "Duration: e.g. 30m, 2h, 1d").option("--json", "Output as JSON").action((duration, opts) => {
+  program2.command("since").description("Show all activity (DMs + spaces) since a duration ago").argument("<duration>", "Duration: e.g. 30m, 2h, 1d").option("-j, --json", "Output as JSON").action((duration, opts) => {
     const match = duration.match(/^(\d+)([mhd])$/);
     if (!match) {
       console.error(chalk4.red(`Invalid duration "${duration}". Use format: 30m, 2h, 1d`));
@@ -49023,7 +49023,7 @@ function registerMessagingCommands(program2) {
     }
     closeDb();
   });
-  program2.command("reply").description("Reply to a message (uses same session)").argument("<message>", "Reply content").requiredOption("--to <message-id>", "Message ID to reply to", parseInt).option("--from <agent>", "Sender agent ID").option("--priority <level>", "Priority: low, normal, high, urgent", "normal").option("--json", "Output as JSON").action((message, opts) => {
+  program2.command("reply").description("Reply to a message (uses same session)").argument("<message>", "Reply content").requiredOption("--to <message-id>", "Message ID to reply to", parseInt).option("--from <agent>", "Sender agent ID").option("--priority <level>", "Priority: low, normal, high, urgent", "normal").option("-j, --json", "Output as JSON").action((message, opts) => {
     const original = getMessageById(opts.to);
     if (!original) {
       console.error(chalk4.red(`Message #${opts.to} not found.`));
@@ -49056,7 +49056,7 @@ function registerMessagingCommands(program2) {
     }
     closeDb();
   });
-  program2.command("mark-read").description("Mark messages as read").argument("[ids...]", "Message IDs to mark as read").option("--all", "Mark all messages as read").option("--session <id>", "Mark all messages in session as read").option("--space <name>", "Mark all messages in space as read").option("--agent <id>", "Agent marking messages as read").option("--json", "Output as JSON").action((ids, opts) => {
+  program2.command("mark-read").description("Mark messages as read").argument("[ids...]", "Message IDs to mark as read").option("--all", "Mark all messages as read").option("--session <id>", "Mark all messages in session as read").option("--space <name>", "Mark all messages in space as read").option("--agent <id>", "Agent marking messages as read").option("-j, --json", "Output as JSON").action((ids, opts) => {
     const agent = resolveIdentity(opts.agent);
     let count = 0;
     if (opts.all) {
@@ -49091,7 +49091,7 @@ function registerMessagingCommands(program2) {
     console.log(result);
     closeDb();
   });
-  program2.command("edit").description("Edit a message (only sender can edit)").argument("<id>", "Message ID", parseInt).argument("<new-content>", "New message content").option("--from <agent>", "Sender agent ID").option("--json", "Output as JSON").action((id, newContent, opts) => {
+  program2.command("edit").description("Edit a message (only sender can edit)").argument("<id>", "Message ID", parseInt).argument("<new-content>", "New message content").option("--from <agent>", "Sender agent ID").option("-j, --json", "Output as JSON").action((id, newContent, opts) => {
     const agent = resolveIdentity(opts.from).trim();
     const content = typeof newContent === "string" ? newContent : "";
     if (!agent) {
@@ -49115,7 +49115,7 @@ function registerMessagingCommands(program2) {
     }
     closeDb();
   });
-  program2.command("delete").description("Delete a message (only sender can delete)").argument("<id>", "Message ID", parseInt).option("--from <agent>", "Sender agent ID").option("--json", "Output as JSON").action((id, opts) => {
+  program2.command("delete").description("Delete a message (only sender can delete)").argument("<id>", "Message ID", parseInt).option("--from <agent>", "Sender agent ID").option("-j, --json", "Output as JSON").action((id, opts) => {
     const agent = resolveIdentity(opts.from).trim();
     if (!agent) {
       console.error(chalk4.red("Agent identity is required."));
@@ -49134,7 +49134,7 @@ function registerMessagingCommands(program2) {
     }
     closeDb();
   });
-  program2.command("pin").description("Pin a message").argument("<id>", "Message ID", parseInt).option("--json", "Output as JSON").action((id, opts) => {
+  program2.command("pin").description("Pin a message").argument("<id>", "Message ID", parseInt).option("-j, --json", "Output as JSON").action((id, opts) => {
     const msg = pinMessage(id);
     if (opts.json) {
       console.log(JSON.stringify(msg, null, 2));
@@ -49148,7 +49148,7 @@ function registerMessagingCommands(program2) {
     }
     closeDb();
   });
-  program2.command("unpin").description("Unpin a message").argument("<id>", "Message ID", parseInt).option("--json", "Output as JSON").action((id, opts) => {
+  program2.command("unpin").description("Unpin a message").argument("<id>", "Message ID", parseInt).option("-j, --json", "Output as JSON").action((id, opts) => {
     const msg = unpinMessage(id);
     if (opts.json) {
       console.log(JSON.stringify(msg, null, 2));
@@ -49162,7 +49162,7 @@ function registerMessagingCommands(program2) {
     }
     closeDb();
   });
-  program2.command("pinned").description("List pinned messages").option("--space <name>", "Filter by space").option("--session <id>", "Filter by session ID").option("--limit <n>", "Max results", parseInt).option("--json", "Output as JSON").action((opts) => {
+  program2.command("pinned").description("List pinned messages").option("--space <name>", "Filter by space").option("--session <id>", "Filter by session ID").option("--limit <n>", "Max results", parseInt).option("-j, --json", "Output as JSON").action((opts) => {
     const messages = getPinnedMessages({ space: opts.space, session_id: opts.session, limit: opts.limit });
     if (opts.json) {
       console.log(JSON.stringify(messages, null, 2));
@@ -49182,7 +49182,7 @@ function registerMessagingCommands(program2) {
     }
     closeDb();
   });
-  program2.command("blockers").description("Check for unread blocking messages").option("--from <agent>", "Agent to check blockers for").option("--json", "Output as JSON").action((opts) => {
+  program2.command("blockers").description("Check for unread blocking messages").option("--from <agent>", "Agent to check blockers for").option("-j, --json", "Output as JSON").action((opts) => {
     const agent = resolveIdentity(opts.from);
     const blockers = getUnreadBlockers(agent);
     if (opts.json) {
@@ -49311,7 +49311,7 @@ Acknowledge with: conversations mark-read ${blockers.map((b) => b.id).join(" ")}
       process.exit(0);
     });
   });
-  program2.command("update").description("Check for and install updates").option("--check", "Only check for updates, don't install").option("--json", "Output as JSON").action(async (opts) => {
+  program2.command("update").description("Check for and install updates").option("--check", "Only check for updates, don't install").option("-j, --json", "Output as JSON").action(async (opts) => {
     const pkg = await Promise.resolve().then(() => __toESM(require_package(), 1));
     const current = pkg.version;
     let latest;
@@ -49376,7 +49376,7 @@ init_terminal_markdown();
 import chalk5 from "chalk";
 function registerSpaceCommands(program2) {
   const space = program2.command("space").description("Manage spaces");
-  space.command("create").description("Create a new space").argument("<name>", "Space name").option("--description <text>", "Space description").option("--parent <name>", "Parent space name (for nesting)").option("--project <id>", "Project ID to associate with").option("--from <agent>", "Creator agent ID").option("--json", "Output as JSON").action((name, opts) => {
+  space.command("create").description("Create a new space").argument("<name>", "Space name").option("--description <text>", "Space description").option("--parent <name>", "Parent space name (for nesting)").option("--project <id>", "Project ID to associate with").option("--from <agent>", "Creator agent ID").option("-j, --json", "Output as JSON").action((name, opts) => {
     const agent = resolveIdentity(opts.from).trim();
     const spaceName = typeof name === "string" ? name.trim() : "";
     if (!agent) {
@@ -49409,7 +49409,7 @@ function registerSpaceCommands(program2) {
     }
     closeDb();
   });
-  space.command("list").description("List all spaces").option("--project <id>", "Filter by project ID").option("--parent <name>", "Filter by parent space name").option("--top-level", "Show only top-level spaces").option("--archived", "Include archived spaces").option("--json", "Output as JSON").action((opts) => {
+  space.command("list").description("List all spaces").option("--project <id>", "Filter by project ID").option("--parent <name>", "Filter by parent space name").option("--top-level", "Show only top-level spaces").option("--archived", "Include archived spaces").option("-j, --json", "Output as JSON").action((opts) => {
     const listOpts = {};
     if (opts.project)
       listOpts.project_id = opts.project;
@@ -49437,7 +49437,7 @@ function registerSpaceCommands(program2) {
     }
     closeDb();
   });
-  space.command("update").description("Update a space").argument("<name>", "Space name").option("--description <text>", "New description").option("--parent <name>", "New parent space name").option("--project <id>", "New project ID").option("--json", "Output as JSON").action((name, opts) => {
+  space.command("update").description("Update a space").argument("<name>", "Space name").option("--description <text>", "New description").option("--parent <name>", "New parent space name").option("--project <id>", "New project ID").option("-j, --json", "Output as JSON").action((name, opts) => {
     const spaceName = typeof name === "string" ? name.trim() : "";
     if (!spaceName) {
       console.error(chalk5.red("Space name cannot be empty."));
@@ -49463,7 +49463,7 @@ function registerSpaceCommands(program2) {
     }
     closeDb();
   });
-  space.command("archive").description("Archive a space").argument("<name>", "Space name").option("--json", "Output as JSON").action((name, opts) => {
+  space.command("archive").description("Archive a space").argument("<name>", "Space name").option("-j, --json", "Output as JSON").action((name, opts) => {
     const spaceName = typeof name === "string" ? name.trim() : "";
     if (!spaceName) {
       console.error(chalk5.red("Space name cannot be empty."));
@@ -49482,7 +49482,7 @@ function registerSpaceCommands(program2) {
     }
     closeDb();
   });
-  space.command("unarchive").description("Unarchive a space").argument("<name>", "Space name").option("--json", "Output as JSON").action((name, opts) => {
+  space.command("unarchive").description("Unarchive a space").argument("<name>", "Space name").option("-j, --json", "Output as JSON").action((name, opts) => {
     const spaceName = typeof name === "string" ? name.trim() : "";
     if (!spaceName) {
       console.error(chalk5.red("Space name cannot be empty."));
@@ -49501,7 +49501,7 @@ function registerSpaceCommands(program2) {
     }
     closeDb();
   });
-  space.command("send").description("Send a message to a space").argument("<space>", "Space name").argument("<message>", "Message content").option("--from <agent>", "Sender agent ID").option("--priority <level>", "Priority: low, normal, high, urgent", "normal").option("--json", "Output as JSON").action((spaceName, message, opts) => {
+  space.command("send").description("Send a message to a space").argument("<space>", "Space name").argument("<message>", "Message content").option("--from <agent>", "Sender agent ID").option("--priority <level>", "Priority: low, normal, high, urgent", "normal").option("-j, --json", "Output as JSON").action((spaceName, message, opts) => {
     const from = resolveIdentity(opts.from).trim();
     const spaceArg = typeof spaceName === "string" ? spaceName.trim() : "";
     const content = typeof message === "string" ? message : "";
@@ -49537,7 +49537,7 @@ function registerSpaceCommands(program2) {
     }
     closeDb();
   });
-  space.command("read").description("Read messages from a space").argument("<space>", "Space name").option("--since <timestamp>", "Messages after this ISO timestamp").option("--limit <n>", "Max messages to return", parseInt).option("--json", "Output as JSON").action((spaceName, opts) => {
+  space.command("read").description("Read messages from a space").argument("<space>", "Space name").option("--since <timestamp>", "Messages after this ISO timestamp").option("--limit <n>", "Max messages to return", parseInt).option("-j, --json", "Output as JSON").action((spaceName, opts) => {
     const spaceArg = typeof spaceName === "string" ? spaceName.trim() : "";
     if (!spaceArg) {
       console.error(chalk5.red("Space name cannot be empty."));
@@ -49569,7 +49569,7 @@ function registerSpaceCommands(program2) {
     }
     closeDb();
   });
-  space.command("join").description("Join a space").argument("<space>", "Space name").option("--from <agent>", "Agent ID").option("--json", "Output as JSON").action((spaceName, opts) => {
+  space.command("join").description("Join a space").argument("<space>", "Space name").option("--from <agent>", "Agent ID").option("-j, --json", "Output as JSON").action((spaceName, opts) => {
     const agent = resolveIdentity(opts.from).trim();
     const spaceArg = typeof spaceName === "string" ? spaceName.trim() : "";
     if (!agent) {
@@ -49592,7 +49592,7 @@ function registerSpaceCommands(program2) {
     }
     closeDb();
   });
-  space.command("leave").description("Leave a space").argument("<space>", "Space name").option("--from <agent>", "Agent ID").option("--json", "Output as JSON").action((spaceName, opts) => {
+  space.command("leave").description("Leave a space").argument("<space>", "Space name").option("--from <agent>", "Agent ID").option("-j, --json", "Output as JSON").action((spaceName, opts) => {
     const agent = resolveIdentity(opts.from).trim();
     const spaceArg = typeof spaceName === "string" ? spaceName.trim() : "";
     if (!agent) {
@@ -49615,7 +49615,7 @@ function registerSpaceCommands(program2) {
     }
     closeDb();
   });
-  space.command("members").description("List space members").argument("<space>", "Space name").option("--json", "Output as JSON").action((spaceName, opts) => {
+  space.command("members").description("List space members").argument("<space>", "Space name").option("-j, --json", "Output as JSON").action((spaceName, opts) => {
     const spaceArg = typeof spaceName === "string" ? spaceName.trim() : "";
     if (!spaceArg) {
       console.error(chalk5.red("Space name cannot be empty."));
@@ -49648,9 +49648,20 @@ function requireDeleteConfirmation(confirmed) {
     throw new Error("Project deletion requires --yes confirmation");
   }
 }
+function parseProjectListPagination(limitInput, offsetInput) {
+  if (limitInput !== undefined && (!Number.isFinite(limitInput) || Number(limitInput) <= 0)) {
+    throw new Error("--limit must be a positive integer.");
+  }
+  if (offsetInput !== undefined && (!Number.isFinite(offsetInput) || Number(offsetInput) < 0)) {
+    throw new Error("--offset must be a non-negative integer.");
+  }
+  const limit = Number.isFinite(limitInput) ? Math.floor(Number(limitInput)) : undefined;
+  const offset = Number.isFinite(offsetInput) ? Math.floor(Number(offsetInput)) : undefined;
+  return { limit, offset };
+}
 function registerProjectCommands(program2) {
   const project = program2.command("project").description("Manage projects");
-  project.command("create").description("Create a new project").argument("<name>", "Project name").option("--description <text>", "Project description").option("--path <path>", "Project path on disk").option("--repository <url>", "Repository URL").option("--tags <json>", "JSON array of tags").option("--from <agent>", "Creator agent ID").option("--json", "Output as JSON").action((name, opts) => {
+  project.command("create").description("Create a new project").argument("<name>", "Project name").option("--description <text>", "Project description").option("--path <path>", "Project path on disk").option("--repository <url>", "Repository URL").option("--tags <json>", "JSON array of tags").option("--from <agent>", "Creator agent ID").option("-j, --json", "Output as JSON").action((name, opts) => {
     const agent = resolveIdentity(opts.from).trim();
     const projectName = typeof name === "string" ? name.trim() : "";
     if (!agent) {
@@ -49694,10 +49705,16 @@ function registerProjectCommands(program2) {
     }
     closeDb();
   });
-  project.command("list").description("List all projects").option("--status <status>", "Filter by status (active/archived)").option("--limit <n>", "Limit results", parseInt).option("--offset <n>", "Skip first N results", parseInt).option("--json", "Output as JSON").action((opts) => {
+  project.command("list").description("List all projects").option("--status <status>", "Filter by status (active/archived)").option("--limit <n>", "Limit results", parseInt).option("--offset <n>", "Skip first N results", parseInt).option("-j, --json", "Output as JSON").action((opts) => {
     const status = opts.status === "active" || opts.status === "archived" ? opts.status : undefined;
-    const limit = Number.isFinite(opts.limit) && opts.limit > 0 ? opts.limit : undefined;
-    const offset = Number.isFinite(opts.offset) && opts.offset >= 0 ? opts.offset : undefined;
+    let limit;
+    let offset;
+    try {
+      ({ limit, offset } = parseProjectListPagination(opts.limit, opts.offset));
+    } catch (e) {
+      console.error(chalk6.red(e.message));
+      process.exit(1);
+    }
     const projects = listProjects({
       ...status ? { status } : {},
       ...limit !== undefined ? { limit } : {},
@@ -49718,7 +49735,7 @@ function registerProjectCommands(program2) {
     }
     closeDb();
   });
-  project.command("get").description("Get project details").argument("<id-or-name>", "Project ID or name").option("--json", "Output as JSON").action((idOrName, opts) => {
+  project.command("get").description("Get project details").argument("<id-or-name>", "Project ID or name").option("-j, --json", "Output as JSON").action((idOrName, opts) => {
     let p = getProject(idOrName);
     if (!p)
       p = getProjectByName(idOrName);
@@ -49744,7 +49761,7 @@ function registerProjectCommands(program2) {
     }
     closeDb();
   });
-  project.command("update").description("Update a project").argument("<id-or-name>", "Project ID or name").option("--name <name>", "New name").option("--description <text>", "New description").option("--path <path>", "New path").option("--status <status>", "New status (active/archived)").option("--repository <url>", "New repository URL").option("--tags <json>", "New tags (JSON array)").option("--json", "Output as JSON").action((id, opts) => {
+  project.command("update").description("Update a project").argument("<id-or-name>", "Project ID or name").option("--name <name>", "New name").option("--description <text>", "New description").option("--path <path>", "New path").option("--status <status>", "New status (active/archived)").option("--repository <url>", "New repository URL").option("--tags <json>", "New tags (JSON array)").option("-j, --json", "Output as JSON").action((id, opts) => {
     const updates = {};
     if (opts.name)
       updates.name = opts.name;
@@ -49779,7 +49796,7 @@ function registerProjectCommands(program2) {
     }
     closeDb();
   });
-  project.command("delete").description("Delete a project").argument("<id-or-name>", "Project ID or name").option("--yes", "Confirm project deletion").option("--json", "Output as JSON").action((id, opts) => {
+  project.command("delete").description("Delete a project").argument("<id-or-name>", "Project ID or name").option("--yes", "Confirm project deletion").option("-j, --json", "Output as JSON").action((id, opts) => {
     try {
       requireDeleteConfirmation(opts.yes);
       const isUuid = /^[0-9a-f-]{36}$/i.test(id);
@@ -49834,7 +49851,7 @@ function buildWhoamiPayload(agent, source, presence, nowMs = Date.now()) {
 }
 function registerAgentCommands(program2) {
   const agents = program2.command("agents").description("Manage agents");
-  agents.command("list").description("List all agents with their presence status").option("--online", "Only show online agents").option("--json", "Output as JSON").action((opts) => {
+  agents.command("list").description("List all agents with their presence status").option("--online", "Only show online agents").option("-j, --json", "Output as JSON").action((opts) => {
     const agent = resolveIdentity();
     heartbeat(agent);
     const agentsList = listAgents({ online_only: opts.online });
@@ -49854,7 +49871,7 @@ function registerAgentCommands(program2) {
     }
     closeDb();
   });
-  agents.command("remove").description("Remove an agent from the presence list").argument("<name>", "Agent name to remove").option("--json", "Output as JSON").action((name, opts) => {
+  agents.command("remove").description("Remove an agent from the presence list").argument("<name>", "Agent name to remove").option("-j, --json", "Output as JSON").action((name, opts) => {
     const agentName = typeof name === "string" ? name.trim() : "";
     if (!agentName) {
       console.error(chalk7.red("Agent name cannot be empty."));
@@ -49873,7 +49890,7 @@ function registerAgentCommands(program2) {
     }
     closeDb();
   });
-  agents.command("rename").description("Rename an agent in the presence list").argument("<old-name>", "Current agent name").argument("<new-name>", "New agent name").option("--json", "Output as JSON").action((oldName, newName, opts) => {
+  agents.command("rename").description("Rename an agent in the presence list").argument("<old-name>", "Current agent name").argument("<new-name>", "New agent name").option("-j, --json", "Output as JSON").action((oldName, newName, opts) => {
     const old = typeof oldName === "string" ? oldName.trim() : "";
     const renamed = typeof newName === "string" ? newName.trim() : "";
     if (!old || !renamed) {
@@ -49897,7 +49914,7 @@ function registerAgentCommands(program2) {
     }
     closeDb();
   });
-  agents.command("register").description("Register an agent with conflict detection (30 min active window)").argument("<name>", "Agent name to register").option("--session <id>", "Session ID (default: random UUID)").option("--role <role>", "Agent role (default: agent)").option("--project <id>", "Project ID to lock agent to").option("--force", "Force takeover even if another session is active").option("--json", "Output as JSON").action((name, opts) => {
+  agents.command("register").description("Register an agent with conflict detection (30 min active window)").argument("<name>", "Agent name to register").option("--session <id>", "Session ID (default: random UUID)").option("--role <role>", "Agent role (default: agent)").option("--project <id>", "Project ID to lock agent to").option("--force", "Force takeover even if another session is active").option("-j, --json", "Output as JSON").action((name, opts) => {
     const agentName = (typeof name === "string" ? name : "").trim();
     if (!agentName) {
       console.error(chalk7.red("Agent name is required."));
@@ -49922,7 +49939,7 @@ function registerAgentCommands(program2) {
     }
     closeDb();
   });
-  agents.command("heartbeat").description("Send a presence heartbeat to mark yourself as active").option("--from <agent>", "Agent identity (default: CONVERSATIONS_AGENT_ID or auto)").option("--status <status>", "Status: online, busy, idle (default: online)").option("--json", "Output as JSON").action((opts) => {
+  agents.command("heartbeat").description("Send a presence heartbeat to mark yourself as active").option("--from <agent>", "Agent identity (default: CONVERSATIONS_AGENT_ID or auto)").option("--status <status>", "Status: online, busy, idle (default: online)").option("-j, --json", "Output as JSON").action((opts) => {
     const agent = resolveIdentity(opts.from);
     const status = opts.status || "online";
     heartbeat(agent, status);
@@ -49934,7 +49951,7 @@ function registerAgentCommands(program2) {
     closeDb();
   });
   const focus = program2.command("focus").description("Manage agent project focus");
-  focus.command("set").description("Set your project focus \u2014 scopes read operations to this project").argument("<project>", "Project ID or name").option("--from <agent>", "Agent identity").option("--json", "Output as JSON").action((projectArg, opts) => {
+  focus.command("set").description("Set your project focus \u2014 scopes read operations to this project").argument("<project>", "Project ID or name").option("--from <agent>", "Agent identity").option("-j, --json", "Output as JSON").action((projectArg, opts) => {
     const agent = resolveIdentity(opts.from);
     const project = getProject(projectArg) || getProjectByName(projectArg);
     if (!project) {
@@ -49949,7 +49966,7 @@ function registerAgentCommands(program2) {
     }
     closeDb();
   });
-  focus.command("clear").description("Clear your project focus").option("--from <agent>", "Agent identity").option("--json", "Output as JSON").action((opts) => {
+  focus.command("clear").description("Clear your project focus").option("--from <agent>", "Agent identity").option("-j, --json", "Output as JSON").action((opts) => {
     const agent = resolveIdentity(opts.from);
     getDb().prepare("UPDATE agent_presence SET project_id = NULL WHERE agent = ?").run(agent);
     if (opts.json) {
@@ -49959,7 +49976,7 @@ function registerAgentCommands(program2) {
     }
     closeDb();
   });
-  focus.command("get").description("Show current project focus").option("--from <agent>", "Agent identity").option("--json", "Output as JSON").action((opts) => {
+  focus.command("get").description("Show current project focus").option("--from <agent>", "Agent identity").option("-j, --json", "Output as JSON").action((opts) => {
     const agent = resolveIdentity(opts.from);
     const presence = getPresence(agent);
     const projectId = presence?.project_id ?? null;
@@ -49976,7 +49993,7 @@ function registerAgentCommands(program2) {
     }
     closeDb();
   });
-  program2.command("whoami").description("Show current agent identity and online status").option("--from <agent>", "Explicit agent identity").option("--json", "Output as JSON").action((opts) => {
+  program2.command("whoami").description("Show current agent identity and online status").option("--from <agent>", "Explicit agent identity").option("-j, --json", "Output as JSON").action((opts) => {
     const envValue = process.env.CONVERSATIONS_AGENT_ID?.trim();
     const agent = resolveIdentity(opts.from);
     let source;
@@ -50030,7 +50047,7 @@ var import__package = __toESM(require_package(), 1);
 import chalk8 from "chalk";
 function registerAnalyticsCommands(program2) {
   const graph = program2.command("graph").description("Knowledge graph operations");
-  graph.command("build").description("Build/rebuild knowledge graph from messages, spaces, projects").option("--json", "Output as JSON").action((opts) => {
+  graph.command("build").description("Build/rebuild knowledge graph from messages, spaces, projects").option("-j, --json", "Output as JSON").action((opts) => {
     const result = buildGraph();
     if (opts.json) {
       console.log(JSON.stringify(result, null, 2));
@@ -50039,7 +50056,7 @@ function registerAnalyticsCommands(program2) {
     }
     closeDb();
   });
-  graph.command("stats").description("Show knowledge graph statistics").option("--json", "Output as JSON").action((opts) => {
+  graph.command("stats").description("Show knowledge graph statistics").option("-j, --json", "Output as JSON").action((opts) => {
     const stats = getGraphStats();
     if (opts.json) {
       console.log(JSON.stringify(stats, null, 2));
@@ -50052,7 +50069,7 @@ function registerAnalyticsCommands(program2) {
     }
     closeDb();
   });
-  graph.command("agent").description("Show an agent's communication network").argument("<name>", "Agent name").option("--json", "Output as JSON").action((name, opts) => {
+  graph.command("agent").description("Show an agent's communication network").argument("<name>", "Agent name").option("-j, --json", "Output as JSON").action((name, opts) => {
     const network = getAgentNetwork(name);
     if (opts.json) {
       console.log(JSON.stringify(network, null, 2));
@@ -50077,7 +50094,7 @@ function registerAnalyticsCommands(program2) {
     }
     closeDb();
   });
-  program2.command("summary").description("Get a structured summary of a conversation").argument("<target>", "Session ID or space name").option("--json", "Output as JSON").action((target, opts) => {
+  program2.command("summary").description("Get a structured summary of a conversation").argument("<target>", "Session ID or space name").option("-j, --json", "Output as JSON").action((target, opts) => {
     const summary = getConversationSummary(target);
     if (!summary) {
       console.error(chalk8.red(`No messages found for "${target}"`));
@@ -50113,7 +50130,7 @@ function registerAnalyticsCommands(program2) {
     }
     closeDb();
   });
-  program2.command("topics").description("Extract topics from a space, session, or trending globally").option("--space <name>", "Topics for a specific space").option("--session <id>", "Topics for a specific session").option("--hours <n>", "Trending topics in last N hours", parseInt).option("--json", "Output as JSON").action((opts) => {
+  program2.command("topics").description("Extract topics from a space, session, or trending globally").option("--space <name>", "Topics for a specific space").option("--session <id>", "Topics for a specific session").option("--hours <n>", "Trending topics in last N hours", parseInt).option("-j, --json", "Output as JSON").action((opts) => {
     let topics;
     if (opts.space) {
       topics = getSpaceTopics(opts.space);
@@ -50139,7 +50156,7 @@ function registerAnalyticsCommands(program2) {
     }
     closeDb();
   });
-  program2.command("hot").description("Show hot conversations ranked by activity").option("--limit <n>", "Max results", parseInt).option("--min-score <n>", "Minimum hotness score", parseInt).option("--space <name>", "Filter by space").option("--json", "Output as JSON").action((opts) => {
+  program2.command("hot").description("Show hot conversations ranked by activity").option("--limit <n>", "Max results", parseInt).option("--min-score <n>", "Minimum hotness score", parseInt).option("--space <name>", "Filter by space").option("-j, --json", "Output as JSON").action((opts) => {
     const sessions = listHotSessions({
       limit: opts.limit ?? 10,
       min_score: opts.minScore,
@@ -50165,7 +50182,7 @@ function registerAnalyticsCommands(program2) {
     }
     closeDb();
   });
-  program2.command("context").description("One-shot session boot context for agents: online agents, unread DMs, spaces, recent activity").option("--json", "Output as JSON").action((opts) => {
+  program2.command("context").description("One-shot session boot context for agents: online agents, unread DMs, spaces, recent activity").option("-j, --json", "Output as JSON").action((opts) => {
     const agent = resolveIdentity();
     heartbeat(agent);
     const db2 = getDb();
@@ -50212,7 +50229,7 @@ function registerAnalyticsCommands(program2) {
     }
     closeDb();
   });
-  program2.command("sessions").description("List conversation sessions").option("--agent <id>", "Filter sessions involving this agent").option("--json", "Output as JSON").action((opts) => {
+  program2.command("sessions").description("List conversation sessions").option("--agent <id>", "Filter sessions involving this agent").option("-j, --json", "Output as JSON").action((opts) => {
     const sessions = listSessions(opts.agent);
     if (opts.json) {
       console.log(JSON.stringify(sessions, null, 2));
@@ -50229,7 +50246,7 @@ function registerAnalyticsCommands(program2) {
     }
     closeDb();
   });
-  program2.command("status").description("Show database stats").option("--json", "Output as JSON").action((opts) => {
+  program2.command("status").description("Show database stats").option("-j, --json", "Output as JSON").action((opts) => {
     const db2 = getDb();
     const dbPath = getDbPath2();
     const totalMessages = db2.prepare("SELECT COUNT(*) as count FROM messages").get().count;
@@ -50258,7 +50275,7 @@ function registerAnalyticsCommands(program2) {
     }
     closeDb();
   });
-  program2.command("doctor").description("Check conversations setup and health").option("--json", "Output as JSON").action(async (opts) => {
+  program2.command("doctor").description("Check conversations setup and health").option("-j, --json", "Output as JSON").action(async (opts) => {
     const checks = [];
     try {
       const db2 = getDb();
@@ -50332,7 +50349,7 @@ function registerAnalyticsCommands(program2) {
       }
     }
   });
-  program2.command("react").description("Add an emoji reaction to a message").argument("<id>", "Message ID", parseInt).argument("<emoji>", "Emoji to react with").option("--from <agent>", "Agent identity override").option("--json", "Output as JSON").action((id, emoji, opts) => {
+  program2.command("react").description("Add an emoji reaction to a message").argument("<id>", "Message ID", parseInt).argument("<emoji>", "Emoji to react with").option("--from <agent>", "Agent identity override").option("-j, --json", "Output as JSON").action((id, emoji, opts) => {
     const agent = resolveIdentity(opts.from);
     const reaction = addReaction(id, agent, emoji);
     if (opts.json) {
@@ -50342,7 +50359,7 @@ function registerAnalyticsCommands(program2) {
     }
     closeDb();
   });
-  program2.command("unreact").description("Remove an emoji reaction from a message").argument("<id>", "Message ID", parseInt).argument("<emoji>", "Emoji to remove").option("--from <agent>", "Agent identity override").option("--json", "Output as JSON").action((id, emoji, opts) => {
+  program2.command("unreact").description("Remove an emoji reaction from a message").argument("<id>", "Message ID", parseInt).argument("<emoji>", "Emoji to remove").option("--from <agent>", "Agent identity override").option("-j, --json", "Output as JSON").action((id, emoji, opts) => {
     const agent = resolveIdentity(opts.from);
     const removed = removeReaction(id, agent, emoji);
     if (opts.json) {
@@ -50356,7 +50373,7 @@ function registerAnalyticsCommands(program2) {
     }
     closeDb();
   });
-  program2.command("reactions").description("Show emoji reactions on a message").argument("<id>", "Message ID", parseInt).option("--json", "Output as JSON").action((id, opts) => {
+  program2.command("reactions").description("Show emoji reactions on a message").argument("<id>", "Message ID", parseInt).option("-j, --json", "Output as JSON").action((id, opts) => {
     const summary = getReactionSummary(id);
     if (opts.json) {
       console.log(JSON.stringify(summary, null, 2));

package/bin/mcp.js

@@ -44269,7 +44269,7 @@ function registerTmuxTools(server) {
 // package.json
 var package_default = {
   name: "@hasna/conversations",
-  version: "0.2.33",
+  version: "0.2.34",
   description: "Real-time CLI messaging for AI agents",
   type: "module",
   bin: {

package/dist/cli/commands/projects.d.ts

@@ -1,3 +1,7 @@
 import type { Command } from "commander";
 export declare function requireDeleteConfirmation(confirmed?: boolean): void;
+export declare function parseProjectListPagination(limitInput: unknown, offsetInput: unknown): {
+    limit: number | undefined;
+    offset: number | undefined;
+};
 export declare function registerProjectCommands(program: Command): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/conversations",
-  "version": "0.2.33",
+  "version": "0.2.34",
   "description": "Real-time CLI messaging for AI agents",
   "type": "module",
   "bin": {