@agenticc/core 1.0.0

package/dist/audit/query.js.map

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

package/dist/conversation/context-builder.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Context Builder
+ *
+ * Builds LLM context from conversation history.
+ * Handles context length limits and message prioritization.
+ *
+ * _Requirements: 9.3_
+ */
+import type { ChatMessage } from '../llm/adapter.js';
+import type { Message } from './session.js';
+import type { StoredMessage } from './message-store.js';
+/**
+ * Context builder configuration
+ */
+export interface ContextBuilderConfig {
+    /** Maximum number of tokens in context (approximate) */
+    maxTokens?: number;
+    /** Maximum number of messages to include */
+    maxMessages?: number;
+    /** Whether to include system messages */
+    includeSystemMessages?: boolean;
+    /** Whether to include tool call details */
+    includeToolCalls?: boolean;
+    /** System prompt to prepend */
+    systemPrompt?: string;
+    /** Average characters per token (for estimation) */
+    charsPerToken?: number;
+}
+/**
+ * Built context result
+ */
+export interface BuiltContext {
+    /** Messages formatted for LLM */
+    messages: ChatMessage[];
+    /** Estimated token count */
+    estimatedTokens: number;
+    /** Number of messages included */
+    messageCount: number;
+    /** Whether context was truncated */
+    truncated: boolean;
+    /** Number of messages that were truncated */
+    truncatedCount: number;
+}
+/**
+ * Context Builder
+ *
+ * Builds LLM context from conversation history with intelligent
+ * truncation and prioritization.
+ */
+export declare class ContextBuilder {
+    private config;
+    constructor(config?: ContextBuilderConfig);
+    /**
+     * Build context from messages
+     *
+     * @param messages - Conversation messages (should be in chronological order)
+     * @param currentMessage - Optional current user message to append
+     * @returns Built context with LLM-formatted messages
+     */
+    build(messages: (Message | StoredMessage)[], currentMessage?: string): BuiltContext;
+    /**
+     * Build context from messages with a specific token budget
+     *
+     * @param messages - Conversation messages
+     * @param tokenBudget - Maximum tokens to use
+     * @returns Built context
+     */
+    buildWithBudget(messages: (Message | StoredMessage)[], tokenBudget: number): BuiltContext;
+    /**
+     * Convert messages to ChatMessage format without truncation
+     *
+     * @param messages - Conversation messages
+     * @returns Array of ChatMessage
+     */
+    toChat(messages: (Message | StoredMessage)[]): ChatMessage[];
+    /**
+     * Estimate token count for a string
+     *
+     * @param text - Text to estimate
+     * @returns Estimated token count
+     */
+    estimateTokens(text: string): number;
+    /**
+     * Estimate total tokens for messages
+     *
+     * @param messages - Messages to estimate
+     * @returns Total estimated tokens
+     */
+    estimateTotalTokens(messages: (Message | StoredMessage)[]): number;
+    /**
+     * Update configuration
+     *
+     * @param config - New configuration (merged with existing)
+     */
+    updateConfig(config: Partial<ContextBuilderConfig>): void;
+    /**
+     * Get current configuration
+     */
+    getConfig(): Required<ContextBuilderConfig>;
+    /**
+     * Prioritize messages for context building
+     */
+    private prioritizeMessages;
+    /**
+     * Convert a Message to ChatMessage format
+     */
+    private toChatMessage;
+}
+/**
+ * Create a new ContextBuilder instance
+ */
+export declare function createContextBuilder(config?: ContextBuilderConfig): ContextBuilder;
+/**
+ * Utility function to quickly build context from messages
+ */
+export declare function buildContext(messages: (Message | StoredMessage)[], options?: ContextBuilderConfig & {
+    currentMessage?: string;
+}): BuiltContext;
+//# sourceMappingURL=context-builder.d.ts.map

package/dist/conversation/context-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-builder.d.ts","sourceRoot":"","sources":["../../src/conversation/context-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,2CAA2C;IAC3C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,+BAA+B;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAcD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,4BAA4B;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,6CAA6C;IAC7C,cAAc,EAAE,MAAM,CAAC;CACxB;AAWD;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAiC;gBAEnC,MAAM,CAAC,EAAE,oBAAoB;IAIzC;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ,EAAE,CAAC,OAAO,GAAG,aAAa,CAAC,EAAE,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,YAAY;IAiFnF;;;;;;OAMG;IACH,eAAe,CAAC,QAAQ,EAAE,CAAC,OAAO,GAAG,aAAa,CAAC,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,YAAY;IAQzF;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,CAAC,OAAO,GAAG,aAAa,CAAC,EAAE,GAAG,WAAW,EAAE;IAwB5D;;;;;OAKG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIpC;;;;;OAKG;IACH,mBAAmB,CAAC,QAAQ,EAAE,CAAC,OAAO,GAAG,aAAa,CAAC,EAAE,GAAG,MAAM;IAclE;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI;IAIzD;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,oBAAoB,CAAC;IAI3C;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAsC1B;;OAEG;IACH,OAAO,CAAC,aAAa;CAgBtB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,cAAc,CAElF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,CAAC,OAAO,GAAG,aAAa,CAAC,EAAE,EACrC,OAAO,CAAC,EAAE,oBAAoB,GAAG;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3D,YAAY,CAGd"}

package/dist/conversation/context-builder.js

@@ -0,0 +1,252 @@
+/**
+ * Context Builder
+ *
+ * Builds LLM context from conversation history.
+ * Handles context length limits and message prioritization.
+ *
+ * _Requirements: 9.3_
+ */
+/**
+ * Default configuration
+ */
+const DEFAULT_CONFIG = {
+    maxTokens: 4000,
+    maxMessages: 20,
+    includeSystemMessages: true,
+    includeToolCalls: true,
+    systemPrompt: '',
+    charsPerToken: 4,
+};
+/**
+ * Context Builder
+ *
+ * Builds LLM context from conversation history with intelligent
+ * truncation and prioritization.
+ */
+export class ContextBuilder {
+    config;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Build context from messages
+     *
+     * @param messages - Conversation messages (should be in chronological order)
+     * @param currentMessage - Optional current user message to append
+     * @returns Built context with LLM-formatted messages
+     */
+    build(messages, currentMessage) {
+        // Filter and prioritize messages
+        const prioritized = this.prioritizeMessages(messages);
+        // Calculate available tokens
+        let availableTokens = this.config.maxTokens;
+        const result = [];
+        let truncated = false;
+        let truncatedCount = 0;
+        // Add system prompt if configured
+        if (this.config.systemPrompt) {
+            const systemTokens = this.estimateTokens(this.config.systemPrompt);
+            result.push({
+                role: 'system',
+                content: this.config.systemPrompt,
+            });
+            availableTokens -= systemTokens;
+        }
+        // Reserve tokens for current message if provided
+        let currentMessageTokens = 0;
+        if (currentMessage) {
+            currentMessageTokens = this.estimateTokens(currentMessage);
+            availableTokens -= currentMessageTokens;
+        }
+        // Select messages that fit within token limit
+        const selectedMessages = [];
+        let totalTokens = 0;
+        // Process messages from most recent to oldest (higher priority first)
+        const sortedByPriority = [...prioritized].sort((a, b) => b.priority - a.priority);
+        for (const pm of sortedByPriority) {
+            if (selectedMessages.length >= this.config.maxMessages) {
+                truncated = true;
+                truncatedCount++;
+                continue;
+            }
+            if (totalTokens + pm.tokenEstimate <= availableTokens) {
+                selectedMessages.push(pm);
+                totalTokens += pm.tokenEstimate;
+            }
+            else {
+                truncated = true;
+                truncatedCount++;
+            }
+        }
+        // Sort selected messages back to chronological order
+        selectedMessages.sort((a, b) => a.message.timestamp.getTime() - b.message.timestamp.getTime());
+        // Convert to ChatMessage format
+        for (const pm of selectedMessages) {
+            const chatMessage = this.toChatMessage(pm.message);
+            if (chatMessage) {
+                result.push(chatMessage);
+            }
+        }
+        // Add current message if provided
+        if (currentMessage) {
+            result.push({
+                role: 'user',
+                content: currentMessage,
+            });
+            totalTokens += currentMessageTokens;
+        }
+        return {
+            messages: result,
+            estimatedTokens: totalTokens +
+                (this.config.systemPrompt ? this.estimateTokens(this.config.systemPrompt) : 0),
+            messageCount: result.length,
+            truncated,
+            truncatedCount,
+        };
+    }
+    /**
+     * Build context from messages with a specific token budget
+     *
+     * @param messages - Conversation messages
+     * @param tokenBudget - Maximum tokens to use
+     * @returns Built context
+     */
+    buildWithBudget(messages, tokenBudget) {
+        const originalMaxTokens = this.config.maxTokens;
+        this.config.maxTokens = tokenBudget;
+        const result = this.build(messages);
+        this.config.maxTokens = originalMaxTokens;
+        return result;
+    }
+    /**
+     * Convert messages to ChatMessage format without truncation
+     *
+     * @param messages - Conversation messages
+     * @returns Array of ChatMessage
+     */
+    toChat(messages) {
+        const result = [];
+        // Add system prompt if configured
+        if (this.config.systemPrompt) {
+            result.push({
+                role: 'system',
+                content: this.config.systemPrompt,
+            });
+        }
+        // Sort by timestamp to ensure chronological order
+        const sorted = [...messages].sort((a, b) => a.timestamp.getTime() - b.timestamp.getTime());
+        for (const message of sorted) {
+            const chatMessage = this.toChatMessage(message);
+            if (chatMessage) {
+                result.push(chatMessage);
+            }
+        }
+        return result;
+    }
+    /**
+     * Estimate token count for a string
+     *
+     * @param text - Text to estimate
+     * @returns Estimated token count
+     */
+    estimateTokens(text) {
+        return Math.ceil(text.length / this.config.charsPerToken);
+    }
+    /**
+     * Estimate total tokens for messages
+     *
+     * @param messages - Messages to estimate
+     * @returns Total estimated tokens
+     */
+    estimateTotalTokens(messages) {
+        let total = 0;
+        if (this.config.systemPrompt) {
+            total += this.estimateTokens(this.config.systemPrompt);
+        }
+        for (const message of messages) {
+            total += this.estimateTokens(message.content);
+            if (this.config.includeToolCalls && message.toolCalls) {
+                total += this.estimateTokens(JSON.stringify(message.toolCalls));
+            }
+        }
+        return total;
+    }
+    /**
+     * Update configuration
+     *
+     * @param config - New configuration (merged with existing)
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+    /**
+     * Get current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Prioritize messages for context building
+     */
+    prioritizeMessages(messages) {
+        const result = [];
+        const now = Date.now();
+        for (let i = 0; i < messages.length; i++) {
+            const message = messages[i];
+            // Skip system messages if not configured to include them
+            if (message.role === 'system' && !this.config.includeSystemMessages) {
+                continue;
+            }
+            // Calculate priority based on:
+            // 1. Recency (more recent = higher priority)
+            // 2. Position (later in conversation = higher priority)
+            // 3. Role (user messages slightly higher priority)
+            const recencyScore = 1 - (now - message.timestamp.getTime()) / (24 * 60 * 60 * 1000);
+            const positionScore = i / messages.length;
+            const roleScore = message.role === 'user' ? 0.1 : 0;
+            const priority = recencyScore * 0.5 + positionScore * 0.4 + roleScore;
+            // Estimate tokens
+            let tokenEstimate = this.estimateTokens(message.content);
+            if (this.config.includeToolCalls && message.toolCalls) {
+                tokenEstimate += this.estimateTokens(JSON.stringify(message.toolCalls));
+            }
+            result.push({
+                message,
+                priority,
+                tokenEstimate,
+            });
+        }
+        return result;
+    }
+    /**
+     * Convert a Message to ChatMessage format
+     */
+    toChatMessage(message) {
+        let content = message.content;
+        // Append tool call information if configured
+        if (this.config.includeToolCalls && message.toolCalls && message.toolCalls.length > 0) {
+            const toolCallSummary = message.toolCalls
+                .map((tc) => `[Tool: ${tc.toolName}] ${tc.result.success ? '✓' : '✗'} ${tc.result.content}`)
+                .join('\n');
+            content = `${content}\n\n${toolCallSummary}`;
+        }
+        return {
+            role: message.role === 'assistant' ? 'assistant' : message.role,
+            content,
+        };
+    }
+}
+/**
+ * Create a new ContextBuilder instance
+ */
+export function createContextBuilder(config) {
+    return new ContextBuilder(config);
+}
+/**
+ * Utility function to quickly build context from messages
+ */
+export function buildContext(messages, options) {
+    const builder = new ContextBuilder(options);
+    return builder.build(messages, options?.currentMessage);
+}
+//# sourceMappingURL=context-builder.js.map

package/dist/conversation/context-builder.js.map

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

package/dist/conversation/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Conversation Module
+ *
+ * Provides conversation history management, message storage,
+ * and context building for the Agent.
+ */
+export * from './session.js';
+export * from './message-store.js';
+export * from './context-builder.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/conversation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/conversation/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC"}

package/dist/conversation/index.js

@@ -0,0 +1,10 @@
+/**
+ * Conversation Module
+ *
+ * Provides conversation history management, message storage,
+ * and context building for the Agent.
+ */
+export * from './session.js';
+export * from './message-store.js';
+export * from './context-builder.js';
+//# sourceMappingURL=index.js.map

package/dist/conversation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/conversation/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC"}

package/dist/conversation/message-store.d.ts

@@ -0,0 +1,231 @@
+/**
+ * Message Store
+ *
+ * Provides persistent storage for conversation messages.
+ * Supports storing user messages, agent responses, and tool call records.
+ *
+ * _Requirements: 9.2_
+ */
+import type { AgentResponse, ToolCallRecord } from '../types/response.js';
+import type { Message, Session } from './session.js';
+/**
+ * Stored message with additional persistence metadata
+ */
+export interface StoredMessage extends Message {
+    /** Session ID this message belongs to */
+    sessionId: string;
+    /** Whether the message has been persisted */
+    persisted: boolean;
+    /** Persistence timestamp */
+    persistedAt?: Date;
+}
+/**
+ * Stored session with persistence metadata
+ */
+export interface StoredSession extends Session {
+    /** Whether the session has been persisted */
+    persisted: boolean;
+    /** Persistence timestamp */
+    persistedAt?: Date;
+}
+/**
+ * Message query options
+ */
+export interface MessageQueryOptions {
+    /** Filter by session ID */
+    sessionId?: string;
+    /** Filter by role */
+    role?: 'user' | 'assistant' | 'system';
+    /** Filter by response type (for assistant messages) */
+    responseType?: string;
+    /** Filter by timestamp (after) */
+    after?: Date;
+    /** Filter by timestamp (before) */
+    before?: Date;
+    /** Include tool calls in results */
+    includeToolCalls?: boolean;
+    /** Maximum number of messages to return */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+    /** Sort order */
+    order?: 'asc' | 'desc';
+}
+/**
+ * Tool call query options
+ */
+export interface ToolCallQueryOptions {
+    /** Filter by session ID */
+    sessionId?: string;
+    /** Filter by tool name */
+    toolName?: string;
+    /** Filter by success status */
+    success?: boolean;
+    /** Filter by timestamp (after) */
+    after?: Date;
+    /** Filter by timestamp (before) */
+    before?: Date;
+    /** Maximum number of results */
+    limit?: number;
+}
+/**
+ * Stored tool call record with additional metadata
+ */
+export interface StoredToolCall extends ToolCallRecord {
+    /** Unique ID for this tool call */
+    id: string;
+    /** Session ID */
+    sessionId: string;
+    /** Message ID this tool call belongs to */
+    messageId: string;
+    /** Timestamp of the tool call */
+    timestamp: Date;
+}
+/**
+ * Message Store
+ *
+ * In-memory message store with support for persistence hooks.
+ * Can be extended with database persistence by implementing the
+ * MessagePersistence interface.
+ */
+export declare class MessageStore {
+    private messages;
+    private sessions;
+    private toolCalls;
+    private messagesBySession;
+    private toolCallsBySession;
+    private toolCallsByMessage;
+    /**
+     * Store a user message
+     *
+     * @param sessionId - Session ID
+     * @param content - Message content
+     * @param metadata - Optional metadata
+     * @returns The stored message
+     */
+    storeUserMessage(sessionId: string, content: string, metadata?: Record<string, unknown>): StoredMessage;
+    /**
+     * Store an assistant message with agent response
+     *
+     * @param sessionId - Session ID
+     * @param response - Agent response
+     * @param metadata - Optional metadata
+     * @returns The stored message
+     */
+    storeAssistantMessage(sessionId: string, response: AgentResponse, metadata?: Record<string, unknown>): StoredMessage;
+    /**
+     * Store a system message
+     *
+     * @param sessionId - Session ID
+     * @param content - Message content
+     * @returns The stored message
+     */
+    storeSystemMessage(sessionId: string, content: string): StoredMessage;
+    /**
+     * Store tool call records
+     *
+     * @param sessionId - Session ID
+     * @param messageId - Message ID
+     * @param toolCalls - Tool call records
+     */
+    private storeToolCalls;
+    /**
+     * Get a message by ID
+     *
+     * @param messageId - Message ID
+     * @returns The message or undefined
+     */
+    getMessage(messageId: string): StoredMessage | undefined;
+    /**
+     * Query messages with filters
+     *
+     * @param options - Query options
+     * @returns Array of matching messages
+     */
+    queryMessages(options?: MessageQueryOptions): StoredMessage[];
+    /**
+     * Get conversation history for a session
+     * Messages are returned in chronological order
+     *
+     * @param sessionId - Session ID
+     * @returns Array of messages ordered by timestamp
+     */
+    getSessionHistory(sessionId: string): StoredMessage[];
+    /**
+     * Query tool calls with filters
+     *
+     * @param options - Query options
+     * @returns Array of matching tool calls
+     */
+    queryToolCalls(options?: ToolCallQueryOptions): StoredToolCall[];
+    /**
+     * Get tool calls for a specific message
+     *
+     * @param messageId - Message ID
+     * @returns Array of tool calls
+     */
+    getToolCallsForMessage(messageId: string): StoredToolCall[];
+    /**
+     * Get a session by ID
+     *
+     * @param sessionId - Session ID
+     * @returns The session or undefined
+     */
+    getSession(sessionId: string): StoredSession | undefined;
+    /**
+     * Get all sessions
+     *
+     * @returns Array of all sessions
+     */
+    getAllSessions(): StoredSession[];
+    /**
+     * Delete a message
+     *
+     * @param messageId - Message ID
+     * @returns True if deleted
+     */
+    deleteMessage(messageId: string): boolean;
+    /**
+     * Delete all messages in a session
+     *
+     * @param sessionId - Session ID
+     * @returns Number of messages deleted
+     */
+    deleteSessionMessages(sessionId: string): number;
+    /**
+     * Get message count for a session
+     *
+     * @param sessionId - Session ID
+     * @returns Number of messages
+     */
+    getMessageCount(sessionId: string): number;
+    /**
+     * Get total message count across all sessions
+     *
+     * @returns Total number of messages
+     */
+    getTotalMessageCount(): number;
+    /**
+     * Get total tool call count
+     *
+     * @returns Total number of tool calls
+     */
+    getTotalToolCallCount(): number;
+    /**
+     * Clear all data
+     */
+    clear(): void;
+    /**
+     * Ensure a session exists
+     */
+    private ensureSession;
+    /**
+     * Add a message to storage
+     */
+    private addMessage;
+}
+/**
+ * Create a new MessageStore instance
+ */
+export declare function createMessageStore(): MessageStore;
+//# sourceMappingURL=message-store.d.ts.map

package/dist/conversation/message-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-store.d.ts","sourceRoot":"","sources":["../../src/conversation/message-store.ts"],"names":[],"mappings":"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"}