@hasna/conversations 0.0.1

package/dist/lib/db.d.ts

@@ -0,0 +1,4 @@
+import { Database } from "bun:sqlite";
+export declare function getDbPath(): string;
+export declare function getDb(): Database;
+export declare function closeDb(): void;

package/dist/lib/identity.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Resolve agent identity.
+ * Priority: explicit flag → CONVERSATIONS_AGENT_ID env → "user" fallback
+ */
+export declare function resolveIdentity(explicit?: string): string;
+/**
+ * Require an explicit identity (for headless/MCP use).
+ * Throws if no identity is set via flag or env.
+ */
+export declare function requireIdentity(explicit?: string): string;

package/dist/lib/messages.d.ts

@@ -0,0 +1,6 @@
+import type { Message, SendMessageOptions, ReadMessagesOptions } from "../types.js";
+export declare function sendMessage(opts: SendMessageOptions): Message;
+export declare function readMessages(opts?: ReadMessagesOptions): Message[];
+export declare function markRead(ids: number[], reader: string): number;
+export declare function markSessionRead(sessionId: string, reader: string): number;
+export declare function getMessageById(id: number): Message | null;

package/dist/lib/poll.d.ts

@@ -0,0 +1,17 @@
+import type { Message } from "../types.js";
+export interface PollOptions {
+    session_id?: string;
+    to_agent?: string;
+    interval_ms?: number;
+    on_messages: (messages: Message[]) => void;
+}
+/**
+ * Start polling for new messages. Returns a stop function.
+ */
+export declare function startPolling(opts: PollOptions): {
+    stop: () => void;
+};
+/**
+ * React hook for polling messages in a session.
+ */
+export declare function useMessages(sessionId: string, agent?: string): Message[];

package/dist/lib/sessions.d.ts

@@ -0,0 +1,10 @@
+import type { Session } from "../types.js";
+/**
+ * List sessions, optionally filtered to those involving a specific agent.
+ * Sessions are derived from messages — no separate sessions table.
+ */
+export declare function listSessions(agent?: string): Session[];
+/**
+ * Get a single session by ID.
+ */
+export declare function getSession(sessionId: string): Session | null;

package/dist/mcp/index.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env bun
+/**
+ * MCP server for conversations.
+ * Exposes tools for sending, reading, and managing messages between agents.
+ *
+ * Usage:
+ *   convo mcp          # Start MCP server on stdio
+ *   convo-mcp          # Direct binary
+ */
+export declare function startMcpServer(): Promise<void>;

package/dist/types.d.ts

@@ -0,0 +1,41 @@
+export type Priority = "low" | "normal" | "high" | "urgent";
+export interface Message {
+    id: number;
+    session_id: string;
+    from_agent: string;
+    to_agent: string;
+    content: string;
+    priority: Priority;
+    working_dir: string | null;
+    repository: string | null;
+    branch: string | null;
+    metadata: Record<string, unknown> | null;
+    created_at: string;
+    read_at: string | null;
+}
+export interface Session {
+    session_id: string;
+    participants: string[];
+    last_message_at: string;
+    message_count: number;
+    unread_count: number;
+}
+export interface SendMessageOptions {
+    from: string;
+    to: string;
+    content: string;
+    session_id?: string;
+    priority?: Priority;
+    working_dir?: string;
+    repository?: string;
+    branch?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface ReadMessagesOptions {
+    session_id?: string;
+    from?: string;
+    to?: string;
+    since?: string;
+    limit?: number;
+    unread_only?: boolean;
+}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@hasna/conversations",
+  "version": "0.0.1",
+  "description": "Real-time CLI messaging for AI agents",
+  "type": "module",
+  "bin": {
+    "convo": "./bin/index.js",
+    "convo-mcp": "./bin/mcp.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist/",
+    "bin/",
+    "LICENSE",
+    "README.md"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "bun build ./src/cli/index.tsx --outdir ./bin --target bun --external ink --external react --external chalk && bun build ./src/mcp/index.ts --outfile ./bin/mcp.js --target bun && bun build ./src/index.ts --outdir ./dist --target bun && tsc --emitDeclarationOnly --declaration --outDir dist",
+    "test": "bun test",
+    "dev": "bun run ./src/cli/index.tsx",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "bun run build"
+  },
+  "keywords": [
+    "conversations",
+    "messaging",
+    "ai",
+    "agent",
+    "cli",
+    "typescript",
+    "bun",
+    "claude",
+    "mcp"
+  ],
+  "author": "Hasna",
+  "license": "Apache-2.0",
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/react": "^18.2.0",
+    "typescript": "^5"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "ink": "^5.0.1",
+    "ink-select-input": "^6.0.0",
+    "ink-spinner": "^5.0.0",
+    "ink-text-input": "^6.0.0",
+    "react": "^18.2.0",
+    "zod": "^4.3.6"
+  },
+  "engines": {
+    "bun": ">=1.0.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hasna/conversations.git"
+  }
+}