@hasna/conversations 0.1.33 → 0.2.1

package/dist/lib/graph.d.ts

@@ -0,0 +1,58 @@
+export interface GraphEdge {
+    from_type: string;
+    from_id: string;
+    to_type: string;
+    to_id: string;
+    relation: string;
+    weight: number;
+    metadata: Record<string, unknown> | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface RelatedEntity {
+    type: string;
+    id: string;
+    relation: string;
+    weight: number;
+}
+export interface AgentNetwork {
+    agent: string;
+    communicates_with: {
+        agent: string;
+        message_count: number;
+        last_at: string;
+    }[];
+    spaces: {
+        space: string;
+        message_count: number;
+    }[];
+    projects: string[];
+}
+/**
+ * Build the knowledge graph from messages, spaces, and projects.
+ * Scans all messages to create edges:
+ *   agent → communicates_with → agent (DM frequency)
+ *   agent → member_of → space (space membership)
+ *   agent → posts_in → space (message activity)
+ *   space → belongs_to → project (space-project link)
+ *   message → replies_to → message (threading)
+ */
+export declare function buildGraph(): {
+    edges_created: number;
+    edges_updated: number;
+};
+/**
+ * Get all entities related to a given entity.
+ */
+export declare function getRelated(entityType: string, entityId: string): RelatedEntity[];
+/**
+ * Get an agent's communication network.
+ */
+export declare function getAgentNetwork(agent: string): AgentNetwork;
+/**
+ * Get graph statistics.
+ */
+export declare function getGraphStats(): {
+    total_edges: number;
+    by_relation: Record<string, number>;
+};

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

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

package/dist/lib/hot.d.ts

@@ -0,0 +1,26 @@
+export interface HotSession {
+    session_id: string;
+    participants: string[];
+    space: string | null;
+    last_message_at: string;
+    message_count: number;
+    hotness_score: number;
+    metrics: {
+        msgs_last_1h: number;
+        msgs_last_24h: number;
+        unique_agents: number;
+        reaction_count: number;
+        reply_count: number;
+        high_priority_count: number;
+        blocker_count: number;
+        hours_since_last: number;
+    };
+}
+export interface HotSessionsOptions {
+    limit?: number;
+    min_score?: number;
+    space?: string;
+    project_id?: string;
+}
+export declare function computeHotness(sessionId: string): HotSession | null;
+export declare function listHotSessions(opts?: HotSessionsOptions): HotSession[];

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

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

package/dist/lib/messages.d.ts

@@ -1,4 +1,4 @@
-import type { Message, SendMessageOptions, ReadMessagesOptions, SearchMessagesOptions } from "../types.js";
+import type { Message, SendMessageOptions, ReadMessagesOptions, SearchMessagesOptions, SearchResult } from "../types.js";
 /** Strip null/undefined fields from a message for compact output. */
 export declare function compactMessage(msg: Message): Partial<Message>;
 export declare function sendMessage(opts: SendMessageOptions): Message;
@@ -28,4 +28,4 @@ export declare function getPinnedMessages(opts?: {
 }): Message[];
 export declare function getUnreadBlockers(agent: string): Message[];
 export declare function getThreadReplies(messageId: number): Message[];
-export declare function searchMessages(opts: SearchMessagesOptions): Message[];
+export declare function searchMessages(opts: SearchMessagesOptions): SearchResult[];

package/dist/lib/sessions.d.ts

@@ -1,4 +1,14 @@
 import type { Session } from "../types.js";
+export interface SessionActivity {
+    session_id: string;
+    msgs_last_1h: number;
+    msgs_last_24h: number;
+    unique_agents: number;
+    reply_ratio: number;
+    avg_priority: string;
+    reaction_count: number;
+    is_trending: boolean;
+}
 /**
  * List sessions, optionally filtered to those involving a specific agent.
  * Sessions are derived from messages — no separate sessions table.
@@ -8,3 +18,7 @@ export declare function listSessions(agent?: string): Session[];
  * Get a single session by ID.
  */
 export declare function getSession(sessionId: string): Session | null;
+/**
+ * Get activity metrics for a session — velocity, engagement, trending status.
+ */
+export declare function getSessionActivity(sessionId: string): SessionActivity | null;

package/dist/lib/summary.d.ts

@@ -0,0 +1,36 @@
+import { type TopicWeight } from "./topics.js";
+export interface ConversationSummary {
+    session_id: string;
+    participants: string[];
+    message_count: number;
+    date_range: {
+        first: string;
+        last: string;
+    };
+    topics: TopicWeight[];
+    key_messages: {
+        id: number;
+        from: string;
+        content: string;
+        reason: string;
+    }[];
+    unresolved_blockers: {
+        id: number;
+        from: string;
+        content: string;
+        created_at: string;
+    }[];
+    activity: {
+        reply_count: number;
+        reaction_count: number;
+        avg_priority: string;
+    };
+}
+export interface SummaryOptions {
+    limit?: number;
+}
+/**
+ * Generate a structured summary of a conversation (session or space).
+ * Uses message metadata — no LLM needed.
+ */
+export declare function getConversationSummary(sessionOrSpace: string, opts?: SummaryOptions): ConversationSummary | null;

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

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

package/dist/lib/topics.d.ts

@@ -0,0 +1,31 @@
+export interface TopicWeight {
+    topic: string;
+    weight: number;
+    count: number;
+}
+/**
+ * Extract weighted topics from a text string using TF-style keyword extraction.
+ * Filters stopwords, short words, and markdown syntax.
+ */
+export declare function extractTopics(text: string, topN?: number): TopicWeight[];
+/**
+ * Get topics for a space by aggregating recent messages.
+ */
+export declare function getSpaceTopics(spaceName: string, opts?: {
+    limit?: number;
+    since?: string;
+}): TopicWeight[];
+/**
+ * Get topics for a session by aggregating all messages.
+ */
+export declare function getSessionTopics(sessionId: string, opts?: {
+    limit?: number;
+}): TopicWeight[];
+/**
+ * Get trending topics across all spaces or a specific project.
+ */
+export declare function getTrendingTopics(opts?: {
+    project_id?: string;
+    hours?: number;
+    top_n?: number;
+}): TopicWeight[];

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

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

package/dist/types.d.ts

@@ -113,6 +113,11 @@ export interface SearchMessagesOptions {
     from?: string;
     to?: string;
     limit?: number;
+    sort?: "relevance" | "recent";
+}
+export interface SearchResult extends Message {
+    snippet: string | null;
+    relevance_score: number;
 }
 export interface AgentPresence {
     id: string;

package/package.json

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