@hasna/conversations 0.2.31 → 0.2.33

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.31",
+    version: "0.2.33",
     description: "Real-time CLI messaging for AI agents",
     type: "module",
     bin: {
@@ -15071,6 +15071,18 @@ function listProjects(opts) {
     params.push(opts.status);
   }
   const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+  let pagination = "";
+  if (typeof opts?.limit === "number" && Number.isFinite(opts.limit) && opts.limit > 0) {
+    pagination += " LIMIT ?";
+    params.push(Math.floor(opts.limit));
+  }
+  if (typeof opts?.offset === "number" && Number.isFinite(opts.offset) && opts.offset >= 0) {
+    if (!pagination.includes("LIMIT")) {
+      pagination += " LIMIT -1";
+    }
+    pagination += " OFFSET ?";
+    params.push(Math.floor(opts.offset));
+  }
   const rows = db2.prepare(`
     SELECT
       p.*,
@@ -15078,6 +15090,7 @@ function listProjects(opts) {
     FROM projects p
     ${where}
     ORDER BY p.name ASC
+    ${pagination}
   `).all(...params);
   return rows.map((row) => ({
     ...parseProject(row),
@@ -46969,6 +46982,16 @@ var init_channel = __esm(() => {
 function sleep2(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
+function parseOptionalDelayMs(value) {
+  return typeof value === "number" && value >= 0 ? value : undefined;
+}
+function normalizeTmuxTargets(rawTargets) {
+  const normalized = rawTargets.map((target) => String(target).trim());
+  if (normalized.some((target) => target.length === 0)) {
+    throw new Error("targets must not contain empty values");
+  }
+  return normalized;
+}
 function registerTmuxTools(server) {
   server.registerTool("tmux_send", {
     description: "Send a message to a tmux window (e.g. another agent's Claude Code session). " + "Pastes the text literally, waits for the pane to be idle, hits Enter, then verifies the message was submitted. " + "Retries up to N times on failure.",
@@ -46989,7 +47012,7 @@ function registerTmuxTools(server) {
     }
     try {
       const result = await tmuxSend(target.trim(), message, {
-        delayMs: typeof delay_ms === "number" && delay_ms > 0 ? delay_ms : undefined,
+        delayMs: parseOptionalDelayMs(delay_ms),
         retries: typeof retries === "number" && retries > 0 ? retries : undefined,
         verify: verify !== false
       });
@@ -47021,14 +47044,20 @@ function registerTmuxTools(server) {
       return { content: [{ type: "text", text: "message cannot be empty" }], isError: true };
     }
     const stagger = typeof stagger_ms === "number" && stagger_ms >= 0 ? stagger_ms : 500;
-    const results = new Array(targets.length);
-    await Promise.all(targets.map(async (rawTarget, i) => {
-      const target = String(rawTarget).trim();
+    let normalizedTargets;
+    try {
+      normalizedTargets = normalizeTmuxTargets(targets);
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      return { content: [{ type: "text", text: msg }], isError: true };
+    }
+    const results = new Array(normalizedTargets.length);
+    await Promise.all(normalizedTargets.map(async (target, i) => {
       if (i > 0 && stagger > 0)
         await sleep2(stagger * i);
       try {
         const result = await tmuxSend(target, message, {
-          delayMs: typeof delay_ms === "number" && delay_ms > 0 ? delay_ms : undefined,
+          delayMs: parseOptionalDelayMs(delay_ms),
           retries: typeof retries === "number" && retries > 0 ? retries : undefined,
           verify: verify !== false
         });
@@ -49614,6 +49643,11 @@ init_projects();
 init_db();
 init_identity();
 import chalk6 from "chalk";
+function requireDeleteConfirmation(confirmed) {
+  if (!confirmed) {
+    throw new Error("Project deletion requires --yes confirmation");
+  }
+}
 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) => {
@@ -49660,9 +49694,15 @@ function registerProjectCommands(program2) {
     }
     closeDb();
   });
-  project.command("list").description("List all projects").option("--status <status>", "Filter by status (active/archived)").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("--json", "Output as JSON").action((opts) => {
     const status = opts.status === "active" || opts.status === "archived" ? opts.status : undefined;
-    const projects = listProjects(status ? { 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;
+    const projects = listProjects({
+      ...status ? { status } : {},
+      ...limit !== undefined ? { limit } : {},
+      ...offset !== undefined ? { offset } : {}
+    });
     if (opts.json) {
       console.log(JSON.stringify(projects, null, 2));
     } else {
@@ -49739,8 +49779,9 @@ function registerProjectCommands(program2) {
     }
     closeDb();
   });
-  project.command("delete").description("Delete a project").argument("<id-or-name>", "Project ID or name").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("--json", "Output as JSON").action((id, opts) => {
     try {
+      requireDeleteConfirmation(opts.yes);
       const isUuid = /^[0-9a-f-]{36}$/i.test(id);
       const resolvedId = isUuid ? id : getProjectByName(id)?.id ?? id;
       const deleted = deleteProject(resolvedId);
@@ -49754,7 +49795,11 @@ function registerProjectCommands(program2) {
         console.log(chalk6.green(`Project deleted.`));
       }
     } catch (e) {
-      console.error(chalk6.red(e.message));
+      if (opts.json) {
+        console.log(JSON.stringify({ id, deleted: false, error: e.message }));
+      } else {
+        console.error(chalk6.red(e.message));
+      }
       process.exit(1);
     }
     closeDb();
@@ -49767,6 +49812,26 @@ init_identity();
 init_presence();
 init_projects();
 import chalk7 from "chalk";
+function buildWhoamiPayload(agent, source, presence, nowMs = Date.now()) {
+  if (!presence) {
+    return {
+      agent,
+      source,
+      online: false,
+      last_seen_at: null,
+      last_seen_ago_seconds: null
+    };
+  }
+  const lastSeenMs = new Date(`${presence.last_seen_at}Z`).getTime();
+  const deltaSeconds = Number.isFinite(lastSeenMs) ? Math.max(0, Math.floor((nowMs - lastSeenMs) / 1000)) : null;
+  return {
+    agent,
+    source,
+    online: presence.online,
+    last_seen_at: presence.last_seen_at,
+    last_seen_ago_seconds: deltaSeconds
+  };
+}
 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) => {
@@ -49911,7 +49976,7 @@ function registerAgentCommands(program2) {
     }
     closeDb();
   });
-  program2.command("whoami").description("Show current agent identity and online status").option("--from <agent>", "Explicit agent identity").action((opts) => {
+  program2.command("whoami").description("Show current agent identity and online status").option("--from <agent>", "Explicit agent identity").option("--json", "Output as JSON").action((opts) => {
     const envValue = process.env.CONVERSATIONS_AGENT_ID?.trim();
     const agent = resolveIdentity(opts.from);
     let source;
@@ -49927,11 +49992,15 @@ function registerAgentCommands(program2) {
       source = `auto-generated (${agentIdFile})`;
     }
     const presence = getPresence(agent);
+    const payload = buildWhoamiPayload(agent, source, presence);
+    if (opts.json) {
+      console.log(JSON.stringify(payload, null, 2));
+      closeDb();
+      return;
+    }
     let onlineStatus;
     if (presence && presence.online) {
-      const lastSeenMs = new Date(presence.last_seen_at + "Z").getTime();
-      const agoMs = Date.now() - lastSeenMs;
-      const agoSec = Math.floor(agoMs / 1000);
+      const agoSec = payload.last_seen_ago_seconds ?? 0;
       const agoStr = agoSec < 60 ? `${agoSec}s ago` : `${Math.floor(agoSec / 60)}m ago`;
       onlineStatus = chalk7.green(`yes`) + chalk7.dim(` (last seen ${agoStr})`);
     } else if (presence) {

package/bin/mcp.js

@@ -42094,6 +42094,18 @@ function listProjects(opts) {
     params.push(opts.status);
   }
   const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+  let pagination = "";
+  if (typeof opts?.limit === "number" && Number.isFinite(opts.limit) && opts.limit > 0) {
+    pagination += " LIMIT ?";
+    params.push(Math.floor(opts.limit));
+  }
+  if (typeof opts?.offset === "number" && Number.isFinite(opts.offset) && opts.offset >= 0) {
+    if (!pagination.includes("LIMIT")) {
+      pagination += " LIMIT -1";
+    }
+    pagination += " OFFSET ?";
+    params.push(Math.floor(opts.offset));
+  }
   const rows = db2.prepare(`
     SELECT
       p.*,
@@ -42101,6 +42113,7 @@ function listProjects(opts) {
     FROM projects p
     ${where}
     ORDER BY p.name ASC
+    ${pagination}
   `).all(...params);
   return rows.map((row) => ({
     ...parseProject(row),
@@ -44157,6 +44170,16 @@ async function tmuxSend(target, message, opts = {}) {
 function sleep2(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
+function parseOptionalDelayMs(value) {
+  return typeof value === "number" && value >= 0 ? value : undefined;
+}
+function normalizeTmuxTargets(rawTargets) {
+  const normalized = rawTargets.map((target) => String(target).trim());
+  if (normalized.some((target) => target.length === 0)) {
+    throw new Error("targets must not contain empty values");
+  }
+  return normalized;
+}
 function registerTmuxTools(server) {
   server.registerTool("tmux_send", {
     description: "Send a message to a tmux window (e.g. another agent's Claude Code session). " + "Pastes the text literally, waits for the pane to be idle, hits Enter, then verifies the message was submitted. " + "Retries up to N times on failure.",
@@ -44177,7 +44200,7 @@ function registerTmuxTools(server) {
     }
     try {
       const result = await tmuxSend(target.trim(), message, {
-        delayMs: typeof delay_ms === "number" && delay_ms > 0 ? delay_ms : undefined,
+        delayMs: parseOptionalDelayMs(delay_ms),
         retries: typeof retries === "number" && retries > 0 ? retries : undefined,
         verify: verify !== false
       });
@@ -44209,14 +44232,20 @@ function registerTmuxTools(server) {
       return { content: [{ type: "text", text: "message cannot be empty" }], isError: true };
     }
     const stagger = typeof stagger_ms === "number" && stagger_ms >= 0 ? stagger_ms : 500;
-    const results = new Array(targets.length);
-    await Promise.all(targets.map(async (rawTarget, i) => {
-      const target = String(rawTarget).trim();
+    let normalizedTargets;
+    try {
+      normalizedTargets = normalizeTmuxTargets(targets);
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      return { content: [{ type: "text", text: msg }], isError: true };
+    }
+    const results = new Array(normalizedTargets.length);
+    await Promise.all(normalizedTargets.map(async (target, i) => {
       if (i > 0 && stagger > 0)
         await sleep2(stagger * i);
       try {
         const result = await tmuxSend(target, message, {
-          delayMs: typeof delay_ms === "number" && delay_ms > 0 ? delay_ms : undefined,
+          delayMs: parseOptionalDelayMs(delay_ms),
           retries: typeof retries === "number" && retries > 0 ? retries : undefined,
           verify: verify !== false
         });
@@ -44240,7 +44269,7 @@ function registerTmuxTools(server) {
 // package.json
 var package_default = {
   name: "@hasna/conversations",
-  version: "0.2.31",
+  version: "0.2.33",
   description: "Real-time CLI messaging for AI agents",
   type: "module",
   bin: {

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

@@ -1,2 +1,15 @@
 import type { Command } from "commander";
+type PresenceView = {
+    online: boolean;
+    last_seen_at: string;
+} | null;
+export type WhoamiPayload = {
+    agent: string;
+    source: string;
+    online: boolean;
+    last_seen_at: string | null;
+    last_seen_ago_seconds: number | null;
+};
+export declare function buildWhoamiPayload(agent: string, source: string, presence: PresenceView, nowMs?: number): WhoamiPayload;
 export declare function registerAgentCommands(program: Command): void;
+export {};

package/dist/cli/commands/agents.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -1,2 +1,3 @@
 import type { Command } from "commander";
+export declare function requireDeleteConfirmation(confirmed?: boolean): void;
 export declare function registerProjectCommands(program: Command): void;

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

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -12428,6 +12428,18 @@ function listProjects(opts) {
     params.push(opts.status);
   }
   const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+  let pagination = "";
+  if (typeof opts?.limit === "number" && Number.isFinite(opts.limit) && opts.limit > 0) {
+    pagination += " LIMIT ?";
+    params.push(Math.floor(opts.limit));
+  }
+  if (typeof opts?.offset === "number" && Number.isFinite(opts.offset) && opts.offset >= 0) {
+    if (!pagination.includes("LIMIT")) {
+      pagination += " LIMIT -1";
+    }
+    pagination += " OFFSET ?";
+    params.push(Math.floor(opts.offset));
+  }
   const rows = db2.prepare(`
     SELECT
       p.*,
@@ -12435,6 +12447,7 @@ function listProjects(opts) {
     FROM projects p
     ${where}
     ORDER BY p.name ASC
+    ${pagination}
   `).all(...params);
   return rows.map((row) => ({
     ...parseProject(row),

package/dist/lib/projects.d.ts

@@ -11,6 +11,8 @@ export declare function createProject(opts: {
 }): Project;
 export declare function listProjects(opts?: {
     status?: "active" | "archived";
+    limit?: number;
+    offset?: number;
 }): ProjectInfo[];
 export declare function getProject(id: string): ProjectInfo | null;
 export declare function getProjectByName(name: string): ProjectInfo | null;

package/dist/mcp/tools/tmux.d.ts

@@ -5,4 +5,6 @@
  * smart paste → wait → Enter → verify behavior.
  */
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function parseOptionalDelayMs(value: unknown): number | undefined;
+export declare function normalizeTmuxTargets(rawTargets: unknown[]): string[];
 export declare function registerTmuxTools(server: McpServer): void;

package/dist/mcp/tools/tmux.test.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

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