@hasna/conversations 0.0.8 → 0.1.0

package/dist/lib/messages.d.ts

@@ -1,7 +1,27 @@
-import type { Message, SendMessageOptions, ReadMessagesOptions } from "../types.js";
+import type { Message, SendMessageOptions, ReadMessagesOptions, SearchMessagesOptions } 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 markChannelRead(channelName: string, reader: string): number;
+export declare function markSpaceRead(spaceName: string, reader: string): number;
 export declare function getMessageById(id: number): Message | null;
+export declare function markAllRead(agent: string): number;
+export interface ExportMessagesOptions {
+    space?: string;
+    session_id?: string;
+    from?: string;
+    since?: string;
+    until?: string;
+    format?: "json" | "csv";
+}
+export declare function exportMessages(opts?: ExportMessagesOptions): string;
+export declare function deleteMessage(id: number, agent: string): boolean;
+export declare function editMessage(id: number, agent: string, newContent: string): Message | null;
+export declare function pinMessage(id: number): Message | null;
+export declare function unpinMessage(id: number): Message | null;
+export declare function getPinnedMessages(opts?: {
+    space?: string;
+    session_id?: string;
+    limit?: number;
+}): Message[];
+export declare function searchMessages(opts: SearchMessagesOptions): Message[];

package/dist/lib/poll.d.ts

@@ -2,7 +2,7 @@ import type { Message } from "../types.js";
 export interface PollOptions {
     session_id?: string;
     to_agent?: string;
-    channel?: string;
+    space?: string;
     interval_ms?: number;
     on_messages: (messages: Message[]) => void;
 }
@@ -17,6 +17,6 @@ export declare function startPolling(opts: PollOptions): {
  */
 export declare function useMessages(sessionId: string, agent?: string): Message[];
 /**
- * React hook for polling messages in a channel.
+ * React hook for polling messages in a space.
  */
-export declare function useChannelMessages(channelName: string): Message[];
+export declare function useSpaceMessages(spaceName: string): Message[];

package/dist/lib/presence.d.ts

@@ -0,0 +1,7 @@
+import type { AgentPresence } from "../types.js";
+export declare function heartbeat(agent: string, status?: string, metadata?: Record<string, unknown>): void;
+export declare function getPresence(agent: string): AgentPresence | null;
+export declare function listAgents(opts?: {
+    online_only?: boolean;
+}): AgentPresence[];
+export declare function removePresence(agent: string): boolean;

package/dist/lib/projects.d.ts

@@ -0,0 +1,27 @@
+import type { Project, ProjectInfo } from "../types.js";
+export declare function createProject(opts: {
+    name: string;
+    created_by: string;
+    description?: string;
+    path?: string;
+    metadata?: Record<string, unknown>;
+    tags?: string[];
+    repository?: string;
+    settings?: Record<string, unknown>;
+}): Project;
+export declare function listProjects(opts?: {
+    status?: "active" | "archived";
+}): ProjectInfo[];
+export declare function getProject(id: string): ProjectInfo | null;
+export declare function getProjectByName(name: string): ProjectInfo | null;
+export declare function updateProject(id: string, updates: {
+    name?: string;
+    description?: string;
+    path?: string;
+    metadata?: Record<string, unknown>;
+    tags?: string[];
+    status?: "active" | "archived";
+    repository?: string;
+    settings?: Record<string, unknown>;
+}): Project;
+export declare function deleteProject(id: string): boolean;

package/dist/lib/projects.test.d.ts

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

package/dist/lib/spaces.d.ts

@@ -0,0 +1,29 @@
+import type { Space, SpaceInfo, SpaceMember } from "../types.js";
+/**
+ * Get the depth of a space in the hierarchy.
+ * Top-level = 0, child of top-level = 1, grandchild = 2.
+ */
+export declare function getSpaceDepth(spaceName: string): number;
+export declare function createSpace(name: string, createdBy: string, options?: {
+    description?: string;
+    parent_id?: string;
+    project_id?: string;
+}): Space;
+export declare function listSpaces(options?: {
+    project_id?: string;
+    parent_id?: string | null;
+    flat?: boolean;
+    include_archived?: boolean;
+}): SpaceInfo[];
+export declare function getSpace(name: string): SpaceInfo | null;
+export declare function joinSpace(spaceName: string, agent: string): boolean;
+export declare function leaveSpace(spaceName: string, agent: string): boolean;
+export declare function getSpaceMembers(spaceName: string): SpaceMember[];
+export declare function updateSpace(name: string, updates: {
+    description?: string;
+    parent_id?: string | null;
+    project_id?: string | null;
+}): Space;
+export declare function archiveSpace(name: string): Space;
+export declare function unarchiveSpace(name: string): Space;
+export declare function isSpaceMember(spaceName: string, agent: string): boolean;

package/dist/lib/spaces.test.d.ts

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

package/dist/mcp/index.d.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env bun
 /**
  * MCP server for conversations.
- * Exposes tools for sending, reading, and managing messages and channels between agents.
+ * Exposes tools for sending, reading, and managing messages, spaces, and projects between agents.
  *
  * Usage:
  *   conversations mcp          # Start MCP server on stdio

package/dist/server/serve.d.ts

@@ -6,4 +6,4 @@
  * Usage:
  *   conversations dashboard          # Start dashboard server
  */
-export declare function startDashboardServer(port?: number): Bun.Server<undefined>;
+export declare function startDashboardServer(port?: number, host?: string): Bun.Server<undefined>;

package/dist/types.d.ts

@@ -4,7 +4,7 @@ export interface Message {
     session_id: string;
     from_agent: string;
     to_agent: string;
-    channel: string | null;
+    space: string | null;
     content: string;
     priority: Priority;
     working_dir: string | null;
@@ -13,6 +13,8 @@ export interface Message {
     metadata: Record<string, unknown> | null;
     created_at: string;
     read_at: string | null;
+    edited_at: string | null;
+    pinned_at: string | null;
 }
 export interface Session {
     session_id: string;
@@ -21,27 +23,47 @@ export interface Session {
     message_count: number;
     unread_count: number;
 }
-export interface Channel {
+export interface Space {
     name: string;
     description: string | null;
+    parent_id: string | null;
+    project_id: string | null;
     created_by: string;
     created_at: string;
+    archived_at: string | null;
 }
-export interface ChannelMember {
-    channel: string;
+export interface SpaceMember {
+    space: string;
     agent: string;
     joined_at: string;
 }
-export interface ChannelInfo extends Channel {
+export interface SpaceInfo extends Space {
     member_count: number;
     message_count: number;
+    children?: SpaceInfo[];
+}
+export interface Project {
+    id: string;
+    name: string;
+    description: string | null;
+    path: string | null;
+    created_by: string;
+    created_at: string;
+    metadata: Record<string, unknown> | null;
+    tags: string[];
+    status: "active" | "archived";
+    repository: string | null;
+    settings: Record<string, unknown> | null;
+}
+export interface ProjectInfo extends Project {
+    space_count: number;
 }
 export interface SendMessageOptions {
     from: string;
     to: string;
     content: string;
     session_id?: string;
-    channel?: string;
+    space?: string;
     priority?: Priority;
     working_dir?: string;
     repository?: string;
@@ -52,8 +74,24 @@ export interface ReadMessagesOptions {
     session_id?: string;
     from?: string;
     to?: string;
-    channel?: string;
+    space?: string;
     since?: string;
+    since_id?: number;
     limit?: number;
     unread_only?: boolean;
+    order?: "asc" | "desc";
+}
+export interface SearchMessagesOptions {
+    query: string;
+    space?: string;
+    from?: string;
+    to?: string;
+    limit?: number;
+}
+export interface AgentPresence {
+    agent: string;
+    status: string;
+    last_seen_at: string;
+    online: boolean;
+    metadata: Record<string, unknown> | null;
 }

package/package.json

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