ruvbot 0.1.0

package/dist/esm/core/entities/Agent.js

@@ -0,0 +1,84 @@
+/**
+ * Agent entity - represents an AI agent instance
+ */
+import { v4 as uuid } from 'uuid';
+export class AgentEntity {
+    id;
+    name;
+    config;
+    status;
+    createdAt;
+    lastActiveAt;
+    constructor(config) {
+        this.id = config.id || uuid();
+        this.name = config.name;
+        this.config = {
+            ...config,
+            id: this.id,
+        };
+        this.status = 'idle';
+        this.createdAt = new Date();
+        this.lastActiveAt = new Date();
+    }
+    /**
+     * Create a new agent with default configuration
+     */
+    static create(name, options) {
+        return new AgentEntity({
+            id: uuid(),
+            name,
+            model: options?.model ?? 'claude-sonnet-4-20250514',
+            temperature: options?.temperature ?? 0.7,
+            maxTokens: options?.maxTokens ?? 4096,
+            skills: options?.skills ?? ['search', 'summarize', 'memory'],
+            ...options,
+        });
+    }
+    /**
+     * Update agent status
+     */
+    setStatus(status) {
+        this.status = status;
+        this.lastActiveAt = new Date();
+    }
+    /**
+     * Check if agent is available for processing
+     */
+    isAvailable() {
+        return this.status === 'idle';
+    }
+    /**
+     * Check if agent has a specific skill
+     */
+    hasSkill(skillName) {
+        return this.config.skills?.includes(skillName) ?? false;
+    }
+    /**
+     * Get agent uptime in milliseconds
+     */
+    getUptime() {
+        return Date.now() - this.createdAt.getTime();
+    }
+    /**
+     * Serialize agent to JSON
+     */
+    toJSON() {
+        return {
+            id: this.id,
+            name: this.name,
+            config: this.config,
+            status: this.status,
+            createdAt: this.createdAt.toISOString(),
+            lastActiveAt: this.lastActiveAt.toISOString(),
+        };
+    }
+    /**
+     * Create agent from JSON
+     */
+    static fromJSON(data) {
+        const agent = new AgentEntity(data.config);
+        agent.status = data.status;
+        return agent;
+    }
+}
+//# sourceMappingURL=Agent.js.map

package/dist/esm/core/entities/Agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Agent.js","sourceRoot":"","sources":["../../../../src/core/entities/Agent.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,MAAM,MAAM,CAAC;AAGlC,MAAM,OAAO,WAAW;IACN,EAAE,CAAS;IACX,IAAI,CAAS;IACb,MAAM,CAAc;IAC7B,MAAM,CAAc;IACX,SAAS,CAAO;IACzB,YAAY,CAAO;IAE1B,YAAY,MAAmB;QAC7B,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG;YACZ,GAAG,MAAM;YACT,EAAE,EAAE,IAAI,CAAC,EAAE;SACZ,CAAC;QACF,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,YAAY,GAAG,IAAI,IAAI,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,IAAY,EAAE,OAA8B;QACxD,OAAO,IAAI,WAAW,CAAC;YACrB,EAAE,EAAE,IAAI,EAAE;YACV,IAAI;YACJ,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,0BAA0B;YACnD,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,GAAG;YACxC,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,IAAI;YACrC,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;YAC5D,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,MAAmB;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,YAAY,GAAG,IAAI,IAAI,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,SAAiB;QACxB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE;YACvC,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE;SAC9C,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAA6B;QAC3C,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,MAAqB,CAAC,CAAC;QAC1D,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAqB,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/esm/core/entities/Message.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Message entity - represents a single message in a conversation
+ */
+import type { Message, MessageRole, Attachment, MessageMetadata } from '../types.js';
+export interface CreateMessageOptions {
+    sessionId: string;
+    role: MessageRole;
+    content: string;
+    attachments?: Attachment[];
+    metadata?: MessageMetadata;
+}
+export declare class MessageEntity implements Message {
+    readonly id: string;
+    readonly sessionId: string;
+    readonly role: MessageRole;
+    content: string;
+    attachments?: Attachment[];
+    embedding?: Float32Array;
+    metadata?: MessageMetadata;
+    readonly createdAt: Date;
+    constructor(options: CreateMessageOptions & {
+        id?: string;
+    });
+    /**
+     * Create a user message
+     */
+    static user(sessionId: string, content: string, attachments?: Attachment[]): MessageEntity;
+    /**
+     * Create an assistant message
+     */
+    static assistant(sessionId: string, content: string, metadata?: MessageMetadata): MessageEntity;
+    /**
+     * Create a system message
+     */
+    static system(sessionId: string, content: string): MessageEntity;
+    /**
+     * Create a function result message
+     */
+    static functionResult(sessionId: string, name: string, result: unknown): MessageEntity;
+    /**
+     * Set embedding vector
+     */
+    setEmbedding(embedding: Float32Array): void;
+    /**
+     * Update metadata
+     */
+    updateMetadata(updates: Partial<MessageMetadata>): void;
+    /**
+     * Get token count if available
+     */
+    getTokenCount(): number | undefined;
+    /**
+     * Get latency if available
+     */
+    getLatency(): number | undefined;
+    /**
+     * Check if message has attachments
+     */
+    hasAttachments(): boolean;
+    /**
+     * Get content length
+     */
+    getContentLength(): number;
+    /**
+     * Check if message is from user
+     */
+    isFromUser(): boolean;
+    /**
+     * Check if message is from assistant
+     */
+    isFromAssistant(): boolean;
+    /**
+     * Truncate content to max length
+     */
+    truncate(maxLength: number): string;
+    /**
+     * Serialize message to JSON
+     */
+    toJSON(): Record<string, unknown>;
+    /**
+     * Create message from JSON
+     */
+    static fromJSON(data: Record<string, unknown>): MessageEntity;
+}
+//# sourceMappingURL=Message.d.ts.map

package/dist/esm/core/entities/Message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Message.d.ts","sourceRoot":"","sources":["../../../../src/core/entities/Message.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAErF,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED,qBAAa,aAAc,YAAW,OAAO;IAC3C,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,IAAI,EAAE,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAClC,SAAgB,SAAS,EAAE,IAAI,CAAC;gBAEpB,OAAO,EAAE,oBAAoB,GAAG;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE;IAU3D;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,UAAU,EAAE,GAAG,aAAa;IAS1F;;OAEG;IACH,MAAM,CAAC,SAAS,CACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,eAAe,GACzB,aAAa;IAShB;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa;IAQhE;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,aAAa;IAQtF;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,YAAY,GAAG,IAAI;IAI3C;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAOvD;;OAEG;IACH,aAAa,IAAI,MAAM,GAAG,SAAS;IAInC;;OAEG;IACH,UAAU,IAAI,MAAM,GAAG,SAAS;IAIhC;;OAEG;IACH,cAAc,IAAI,OAAO;IAIzB;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAOnC;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAYjC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa;CAW9D"}

package/dist/esm/core/entities/Message.js

@@ -0,0 +1,154 @@
+/**
+ * Message entity - represents a single message in a conversation
+ */
+import { v4 as uuid } from 'uuid';
+export class MessageEntity {
+    id;
+    sessionId;
+    role;
+    content;
+    attachments;
+    embedding;
+    metadata;
+    createdAt;
+    constructor(options) {
+        this.id = options.id || uuid();
+        this.sessionId = options.sessionId;
+        this.role = options.role;
+        this.content = options.content;
+        this.attachments = options.attachments;
+        this.metadata = options.metadata;
+        this.createdAt = new Date();
+    }
+    /**
+     * Create a user message
+     */
+    static user(sessionId, content, attachments) {
+        return new MessageEntity({
+            sessionId,
+            role: 'user',
+            content,
+            attachments,
+        });
+    }
+    /**
+     * Create an assistant message
+     */
+    static assistant(sessionId, content, metadata) {
+        return new MessageEntity({
+            sessionId,
+            role: 'assistant',
+            content,
+            metadata,
+        });
+    }
+    /**
+     * Create a system message
+     */
+    static system(sessionId, content) {
+        return new MessageEntity({
+            sessionId,
+            role: 'system',
+            content,
+        });
+    }
+    /**
+     * Create a function result message
+     */
+    static functionResult(sessionId, name, result) {
+        return new MessageEntity({
+            sessionId,
+            role: 'function',
+            content: JSON.stringify({ name, result }),
+        });
+    }
+    /**
+     * Set embedding vector
+     */
+    setEmbedding(embedding) {
+        this.embedding = embedding;
+    }
+    /**
+     * Update metadata
+     */
+    updateMetadata(updates) {
+        this.metadata = {
+            ...this.metadata,
+            ...updates,
+        };
+    }
+    /**
+     * Get token count if available
+     */
+    getTokenCount() {
+        return this.metadata?.tokens;
+    }
+    /**
+     * Get latency if available
+     */
+    getLatency() {
+        return this.metadata?.latency;
+    }
+    /**
+     * Check if message has attachments
+     */
+    hasAttachments() {
+        return (this.attachments?.length ?? 0) > 0;
+    }
+    /**
+     * Get content length
+     */
+    getContentLength() {
+        return this.content.length;
+    }
+    /**
+     * Check if message is from user
+     */
+    isFromUser() {
+        return this.role === 'user';
+    }
+    /**
+     * Check if message is from assistant
+     */
+    isFromAssistant() {
+        return this.role === 'assistant';
+    }
+    /**
+     * Truncate content to max length
+     */
+    truncate(maxLength) {
+        if (this.content.length <= maxLength) {
+            return this.content;
+        }
+        return this.content.slice(0, maxLength - 3) + '...';
+    }
+    /**
+     * Serialize message to JSON
+     */
+    toJSON() {
+        return {
+            id: this.id,
+            sessionId: this.sessionId,
+            role: this.role,
+            content: this.content,
+            attachments: this.attachments,
+            metadata: this.metadata,
+            createdAt: this.createdAt.toISOString(),
+        };
+    }
+    /**
+     * Create message from JSON
+     */
+    static fromJSON(data) {
+        const message = new MessageEntity({
+            id: data.id,
+            sessionId: data.sessionId,
+            role: data.role,
+            content: data.content,
+            attachments: data.attachments,
+            metadata: data.metadata,
+        });
+        return message;
+    }
+}
+//# sourceMappingURL=Message.js.map

package/dist/esm/core/entities/Message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Message.js","sourceRoot":"","sources":["../../../../src/core/entities/Message.ts"],"names":[],"mappings":"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"}

package/dist/esm/core/entities/Session.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Session entity - represents a conversation session
+ */
+import type { Session, SessionConfig, SessionContext, Message, Platform, Entity, MemoryEntry } from '../types.js';
+export declare class SessionEntity implements Session {
+    readonly id: string;
+    readonly agentId: string;
+    readonly userId?: string;
+    readonly channelId?: string;
+    readonly platform: Platform;
+    messages: Message[];
+    context: SessionContext;
+    metadata: Record<string, unknown>;
+    readonly createdAt: Date;
+    updatedAt: Date;
+    expiresAt?: Date;
+    constructor(config: SessionConfig);
+    /**
+     * Create a new session
+     */
+    static create(agentId: string, options?: Partial<SessionConfig>): SessionEntity;
+    /**
+     * Add a message to the session
+     */
+    addMessage(message: Message): void;
+    /**
+     * Get recent messages
+     */
+    getRecentMessages(count: number): Message[];
+    /**
+     * Get messages by role
+     */
+    getMessagesByRole(role: Message['role']): Message[];
+    /**
+     * Update session context
+     */
+    updateContext(updates: Partial<SessionContext>): void;
+    /**
+     * Add entity to context
+     */
+    addEntity(entity: Entity): void;
+    /**
+     * Add topic to context
+     */
+    addTopic(topic: string): void;
+    /**
+     * Set relevant memories from search
+     */
+    setRelevantMemories(memories: MemoryEntry[]): void;
+    /**
+     * Check if session is expired
+     */
+    isExpired(): boolean;
+    /**
+     * Extend session expiration
+     */
+    extend(ttl: number): void;
+    /**
+     * Get session duration in milliseconds
+     */
+    getDuration(): number;
+    /**
+     * Get message count
+     */
+    getMessageCount(): number;
+    /**
+     * Get conversation turns (user + assistant pairs)
+     */
+    getTurnCount(): number;
+    /**
+     * Build conversation history for LLM context
+     */
+    buildConversationHistory(maxMessages?: number): Array<{
+        role: string;
+        content: string;
+    }>;
+    /**
+     * Serialize session to JSON
+     */
+    toJSON(): Record<string, unknown>;
+    /**
+     * Create session from JSON
+     */
+    static fromJSON(data: Record<string, unknown>): SessionEntity;
+}
+//# sourceMappingURL=Session.d.ts.map

package/dist/esm/core/entities/Session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Session.d.ts","sourceRoot":"","sources":["../../../../src/core/entities/Session.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,OAAO,EACP,aAAa,EACb,cAAc,EACd,OAAO,EACP,QAAQ,EACR,MAAM,EACN,WAAW,EACZ,MAAM,aAAa,CAAC;AAErB,qBAAa,aAAc,YAAW,OAAO;IAC3C,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChC,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnC,SAAgB,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,SAAgB,SAAS,EAAE,IAAI,CAAC;IACzB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,CAAC,EAAE,IAAI,CAAC;gBAEZ,MAAM,EAAE,aAAa;IAoBjC;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa;IAO/E;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAKlC;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE;IAI3C;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,EAAE;IAInD;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;IAQrD;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAW/B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAO7B;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI;IAKlD;;OAEG;IACH,SAAS,IAAI,OAAO;IAKpB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKzB;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,wBAAwB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAQxF;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAoBjC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa;CAe9D"}

package/dist/esm/core/entities/Session.js

@@ -0,0 +1,182 @@
+/**
+ * Session entity - represents a conversation session
+ */
+import { v4 as uuid } from 'uuid';
+export class SessionEntity {
+    id;
+    agentId;
+    userId;
+    channelId;
+    platform;
+    messages;
+    context;
+    metadata;
+    createdAt;
+    updatedAt;
+    expiresAt;
+    constructor(config) {
+        this.id = config.id || uuid();
+        this.agentId = config.agentId;
+        this.userId = config.userId;
+        this.channelId = config.channelId;
+        this.platform = config.platform ?? 'api';
+        this.messages = [];
+        this.context = {
+            topics: [],
+            entities: [],
+        };
+        this.metadata = config.metadata ?? {};
+        this.createdAt = new Date();
+        this.updatedAt = new Date();
+        if (config.ttl) {
+            this.expiresAt = new Date(Date.now() + config.ttl);
+        }
+    }
+    /**
+     * Create a new session
+     */
+    static create(agentId, options) {
+        return new SessionEntity({
+            agentId,
+            ...options,
+        });
+    }
+    /**
+     * Add a message to the session
+     */
+    addMessage(message) {
+        this.messages.push(message);
+        this.updatedAt = new Date();
+    }
+    /**
+     * Get recent messages
+     */
+    getRecentMessages(count) {
+        return this.messages.slice(-count);
+    }
+    /**
+     * Get messages by role
+     */
+    getMessagesByRole(role) {
+        return this.messages.filter((m) => m.role === role);
+    }
+    /**
+     * Update session context
+     */
+    updateContext(updates) {
+        this.context = {
+            ...this.context,
+            ...updates,
+        };
+        this.updatedAt = new Date();
+    }
+    /**
+     * Add entity to context
+     */
+    addEntity(entity) {
+        // Avoid duplicates
+        const exists = this.context.entities.some((e) => e.type === entity.type && e.value === entity.value);
+        if (!exists) {
+            this.context.entities.push(entity);
+        }
+        this.updatedAt = new Date();
+    }
+    /**
+     * Add topic to context
+     */
+    addTopic(topic) {
+        if (!this.context.topics.includes(topic)) {
+            this.context.topics.push(topic);
+        }
+        this.updatedAt = new Date();
+    }
+    /**
+     * Set relevant memories from search
+     */
+    setRelevantMemories(memories) {
+        this.context.relevantMemories = memories;
+        this.updatedAt = new Date();
+    }
+    /**
+     * Check if session is expired
+     */
+    isExpired() {
+        if (!this.expiresAt)
+            return false;
+        return Date.now() > this.expiresAt.getTime();
+    }
+    /**
+     * Extend session expiration
+     */
+    extend(ttl) {
+        this.expiresAt = new Date(Date.now() + ttl);
+        this.updatedAt = new Date();
+    }
+    /**
+     * Get session duration in milliseconds
+     */
+    getDuration() {
+        return Date.now() - this.createdAt.getTime();
+    }
+    /**
+     * Get message count
+     */
+    getMessageCount() {
+        return this.messages.length;
+    }
+    /**
+     * Get conversation turns (user + assistant pairs)
+     */
+    getTurnCount() {
+        return Math.floor(this.messages.filter((m) => m.role === 'user').length);
+    }
+    /**
+     * Build conversation history for LLM context
+     */
+    buildConversationHistory(maxMessages) {
+        const messages = maxMessages ? this.getRecentMessages(maxMessages) : this.messages;
+        return messages.map((m) => ({
+            role: m.role,
+            content: m.content,
+        }));
+    }
+    /**
+     * Serialize session to JSON
+     */
+    toJSON() {
+        return {
+            id: this.id,
+            agentId: this.agentId,
+            userId: this.userId,
+            channelId: this.channelId,
+            platform: this.platform,
+            messages: this.messages,
+            context: {
+                summary: this.context.summary,
+                topics: this.context.topics,
+                entities: this.context.entities,
+            },
+            metadata: this.metadata,
+            createdAt: this.createdAt.toISOString(),
+            updatedAt: this.updatedAt.toISOString(),
+            expiresAt: this.expiresAt?.toISOString(),
+        };
+    }
+    /**
+     * Create session from JSON
+     */
+    static fromJSON(data) {
+        const session = new SessionEntity({
+            id: data.id,
+            agentId: data.agentId,
+            userId: data.userId,
+            channelId: data.channelId,
+            platform: data.platform,
+        });
+        session.messages = data.messages;
+        session.context = data.context;
+        session.metadata = data.metadata;
+        return session;
+    }
+}
+//# sourceMappingURL=Session.js.map

package/dist/esm/core/entities/Session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Session.js","sourceRoot":"","sources":["../../../../src/core/entities/Session.ts"],"names":[],"mappings":"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"}