@ductape/sdk 0.0.4-v51 → 0.0.4-v52

package/dist/agents/memory-manager.js

@@ -0,0 +1,383 @@
+"use strict";
+/**
+ * Memory Manager
+ *
+ * Manages agent memory - both short-term (conversation context)
+ * and long-term (persistent vector storage).
+ *
+ * Note: Long-term memory with vector stores requires a VectorDatabase service
+ * which is not yet implemented. This module provides an interface and
+ * in-memory fallback until vector database support is added.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryManager = exports.SimpleConversationSummarizer = exports.InMemoryVectorStore = exports.StubEmbeddingProvider = void 0;
+/**
+ * Stub embedding provider (returns random vectors until real implementation)
+ */
+class StubEmbeddingProvider {
+    constructor(dimensions = 1536) {
+        this.dimensions = dimensions;
+    }
+    async embed(text) {
+        // Generate deterministic pseudo-random embedding based on text hash
+        const hash = this.hashString(text);
+        return this.generateVector(hash);
+    }
+    async embedBatch(texts) {
+        return Promise.all(texts.map((t) => this.embed(t)));
+    }
+    hashString(str) {
+        let hash = 0;
+        for (let i = 0; i < str.length; i++) {
+            const char = str.charCodeAt(i);
+            hash = ((hash << 5) - hash) + char;
+            hash = hash & hash;
+        }
+        return Math.abs(hash);
+    }
+    generateVector(seed) {
+        const vector = [];
+        let current = seed;
+        for (let i = 0; i < this.dimensions; i++) {
+            current = (current * 1103515245 + 12345) & 0x7fffffff;
+            vector.push((current / 0x7fffffff) * 2 - 1);
+        }
+        return vector;
+    }
+}
+exports.StubEmbeddingProvider = StubEmbeddingProvider;
+/**
+ * In-memory vector store (fallback when real vector store not available)
+ */
+class InMemoryVectorStore {
+    constructor() {
+        this.vectors = new Map();
+    }
+    async upsert(vectors) {
+        for (const v of vectors) {
+            this.vectors.set(v.id, {
+                content: v.content,
+                embedding: v.embedding,
+                metadata: v.metadata,
+            });
+        }
+    }
+    async query(embedding, topK, filter) {
+        var _a;
+        const results = [];
+        for (const [, v] of this.vectors) {
+            // Apply filter if provided
+            if (filter) {
+                let match = true;
+                for (const [key, value] of Object.entries(filter)) {
+                    if (((_a = v.metadata) === null || _a === void 0 ? void 0 : _a[key]) !== value) {
+                        match = false;
+                        break;
+                    }
+                }
+                if (!match)
+                    continue;
+            }
+            // Calculate cosine similarity
+            const score = this.cosineSimilarity(embedding, v.embedding);
+            results.push({ content: v.content, metadata: v.metadata, score });
+        }
+        return results
+            .sort((a, b) => b.score - a.score)
+            .slice(0, topK);
+    }
+    async delete(ids) {
+        for (const id of ids) {
+            this.vectors.delete(id);
+        }
+    }
+    async clear(namespace) {
+        var _a;
+        if (!namespace) {
+            this.vectors.clear();
+            return;
+        }
+        // Clear only vectors in namespace
+        for (const [id, v] of this.vectors) {
+            if (((_a = v.metadata) === null || _a === void 0 ? void 0 : _a.namespace) === namespace) {
+                this.vectors.delete(id);
+            }
+        }
+    }
+    cosineSimilarity(a, b) {
+        if (a.length !== b.length)
+            return 0;
+        let dotProduct = 0;
+        let normA = 0;
+        let normB = 0;
+        for (let i = 0; i < a.length; i++) {
+            dotProduct += a[i] * b[i];
+            normA += a[i] * a[i];
+            normB += b[i] * b[i];
+        }
+        const magnitude = Math.sqrt(normA) * Math.sqrt(normB);
+        return magnitude === 0 ? 0 : dotProduct / magnitude;
+    }
+}
+exports.InMemoryVectorStore = InMemoryVectorStore;
+/**
+ * Simple conversation summarizer (extracts key points)
+ */
+class SimpleConversationSummarizer {
+    async summarize(messages) {
+        var _a;
+        // Simple extraction - in production, use LLM for better summaries
+        const keyPoints = [];
+        for (const msg of messages) {
+            if (msg.role === 'user') {
+                // Extract user requests
+                keyPoints.push(`User asked: ${this.truncate(msg.content, 100)}`);
+            }
+            else if (msg.role === 'assistant' && msg.content.length > 0) {
+                // Extract key assistant responses
+                keyPoints.push(`Assistant: ${this.truncate(msg.content, 100)}`);
+            }
+            else if (msg.role === 'tool' && msg.toolResult) {
+                // Extract tool results
+                keyPoints.push(`Tool ${(_a = msg.toolCall) === null || _a === void 0 ? void 0 : _a.name}: ${this.truncate(JSON.stringify(msg.toolResult), 80)}`);
+            }
+        }
+        return `Conversation summary:\n${keyPoints.slice(-10).join('\n')}`;
+    }
+    truncate(text, maxLength) {
+        if (text.length <= maxLength)
+            return text;
+        return text.slice(0, maxLength - 3) + '...';
+    }
+}
+exports.SimpleConversationSummarizer = SimpleConversationSummarizer;
+/**
+ * Memory Manager
+ *
+ * Handles both short-term (conversation) and long-term (vector) memory
+ * for agent executions.
+ */
+class MemoryManager {
+    constructor(config, executionId, agentTag, options) {
+        var _a;
+        this.conversation = [];
+        this.conversationSummary = null;
+        this.config = config;
+        this.executionId = executionId;
+        this.agentTag = agentTag;
+        this.namespace = (_a = config.longTerm) === null || _a === void 0 ? void 0 : _a.namespace;
+        // Use provided adapters or fallback to in-memory implementations
+        this.vectorStore = (options === null || options === void 0 ? void 0 : options.vectorStore) || new InMemoryVectorStore();
+        this.embeddingProvider = (options === null || options === void 0 ? void 0 : options.embeddingProvider) || new StubEmbeddingProvider();
+        this.summarizer = (options === null || options === void 0 ? void 0 : options.summarizer) || new SimpleConversationSummarizer();
+    }
+    // ==================== SHORT-TERM MEMORY ====================
+    /**
+     * Add a message to conversation history
+     */
+    addMessage(message) {
+        this.conversation.push(Object.assign(Object.assign({}, message), { timestamp: message.timestamp || Date.now() }));
+        // Check if we need to summarize
+        this.maybeCompactConversation();
+    }
+    /**
+     * Add multiple messages
+     */
+    addMessages(messages) {
+        for (const msg of messages) {
+            this.addMessage(msg);
+        }
+    }
+    /**
+     * Get conversation messages for LLM context
+     */
+    getConversationForContext() {
+        const shortTermConfig = this.config.shortTerm || {};
+        const maxMessages = shortTermConfig.maxMessages || 50;
+        // If we have a summary, prepend it
+        let messages = [...this.conversation];
+        if (this.conversationSummary && messages.length > maxMessages / 2) {
+            // Include summary as system message
+            messages = [
+                {
+                    role: 'system',
+                    content: this.conversationSummary,
+                    timestamp: Date.now(),
+                },
+                ...messages.slice(-Math.floor(maxMessages / 2)),
+            ];
+        }
+        // Truncate to max messages
+        return messages.slice(-maxMessages);
+    }
+    /**
+     * Get full conversation history
+     */
+    getFullConversation() {
+        return [...this.conversation];
+    }
+    /**
+     * Clear conversation history
+     */
+    clearConversation() {
+        this.conversation = [];
+        this.conversationSummary = null;
+    }
+    /**
+     * Compact conversation by summarizing older messages
+     */
+    async maybeCompactConversation() {
+        const shortTermConfig = this.config.shortTerm || {};
+        const summarizeAfter = shortTermConfig.summarizeAfter || 30;
+        const strategy = shortTermConfig.truncationStrategy || 'summarize';
+        if (this.conversation.length <= summarizeAfter) {
+            return;
+        }
+        switch (strategy) {
+            case 'fifo':
+                // Simple FIFO - remove oldest messages
+                this.conversation = this.conversation.slice(-summarizeAfter);
+                break;
+            case 'sliding_window':
+                // Keep recent messages with sliding window
+                const keepCount = Math.floor(summarizeAfter * 0.8);
+                this.conversation = this.conversation.slice(-keepCount);
+                break;
+            case 'summarize':
+                // Summarize older messages
+                const toSummarize = this.conversation.slice(0, -Math.floor(summarizeAfter / 2));
+                if (toSummarize.length > 0) {
+                    try {
+                        const summary = await this.summarizer.summarize(toSummarize);
+                        this.conversationSummary = this.conversationSummary
+                            ? `${this.conversationSummary}\n\n${summary}`
+                            : summary;
+                        this.conversation = this.conversation.slice(-Math.floor(summarizeAfter / 2));
+                    }
+                    catch (error) {
+                        // Fallback to FIFO if summarization fails
+                        this.conversation = this.conversation.slice(-summarizeAfter);
+                    }
+                }
+                break;
+        }
+    }
+    // ==================== LONG-TERM MEMORY ====================
+    /**
+     * Check if long-term memory is enabled
+     */
+    isLongTermEnabled() {
+        var _a, _b;
+        return (_b = (_a = this.config.longTerm) === null || _a === void 0 ? void 0 : _a.enabled) !== null && _b !== void 0 ? _b : false;
+    }
+    /**
+     * Store content in long-term memory
+     */
+    async remember(content, metadata) {
+        var _a;
+        if (!this.isLongTermEnabled()) {
+            console.warn('Long-term memory is not enabled. Content not stored.');
+            return;
+        }
+        const id = `${this.agentTag}:${this.executionId}:${Date.now()}`;
+        const embedding = await this.embeddingProvider.embed(content);
+        await this.vectorStore.upsert([
+            {
+                id,
+                content,
+                embedding,
+                metadata: Object.assign(Object.assign({}, metadata), { namespace: this.namespace, agent_tag: this.agentTag, execution_id: this.executionId, timestamp: Date.now() }),
+            },
+        ]);
+        // Auto-store to long-term memory is handled here
+        if ((_a = this.config.longTerm) === null || _a === void 0 ? void 0 : _a.autoStore) {
+            // Already stored above
+        }
+    }
+    /**
+     * Retrieve relevant content from long-term memory
+     */
+    async recall(query, topK) {
+        var _a, _b;
+        if (!this.isLongTermEnabled()) {
+            return [];
+        }
+        const k = topK || ((_a = this.config.longTerm) === null || _a === void 0 ? void 0 : _a.retrieveTopK) || 5;
+        const minSimilarity = ((_b = this.config.longTerm) === null || _b === void 0 ? void 0 : _b.minSimilarity) || 0.7;
+        const embedding = await this.embeddingProvider.embed(query);
+        const results = await this.vectorStore.query(embedding, k, {
+            namespace: this.namespace,
+        });
+        return results
+            .filter((r) => r.score >= minSimilarity)
+            .map((r) => ({
+            content: r.content,
+            metadata: r.metadata,
+            similarity: r.score,
+        }));
+    }
+    /**
+     * Clear long-term memory for this agent/namespace
+     */
+    async clearLongTermMemory() {
+        if (!this.isLongTermEnabled()) {
+            return;
+        }
+        await this.vectorStore.clear(this.namespace);
+    }
+    // ==================== CONTEXT BUILDING ====================
+    /**
+     * Build context for LLM call including relevant memories
+     */
+    async buildContext(currentQuery) {
+        const conversation = this.getConversationForContext();
+        let memories = [];
+        // Retrieve relevant long-term memories if enabled and query provided
+        if (this.isLongTermEnabled() && currentQuery) {
+            memories = await this.recall(currentQuery);
+        }
+        return { conversation, memories };
+    }
+    /**
+     * Format memories for inclusion in system prompt
+     */
+    formatMemoriesForPrompt(memories) {
+        if (memories.length === 0) {
+            return '';
+        }
+        const formattedMemories = memories
+            .map((m, i) => `[Memory ${i + 1}] ${m.content}`)
+            .join('\n\n');
+        return `\n\nRelevant information from memory:\n${formattedMemories}`;
+    }
+    // ==================== STATE MANAGEMENT ====================
+    /**
+     * Get memory state snapshot
+     */
+    getState() {
+        return {
+            conversationLength: this.conversation.length,
+            hasSummary: this.conversationSummary !== null,
+            longTermEnabled: this.isLongTermEnabled(),
+        };
+    }
+    /**
+     * Import conversation from another memory manager or serialized state
+     */
+    importConversation(messages, summary) {
+        this.conversation = [...messages];
+        this.conversationSummary = summary || null;
+    }
+    /**
+     * Export conversation for serialization
+     */
+    exportConversation() {
+        return {
+            messages: [...this.conversation],
+            summary: this.conversationSummary,
+        };
+    }
+}
+exports.MemoryManager = MemoryManager;
+exports.default = MemoryManager;
+//# sourceMappingURL=memory-manager.js.map

package/dist/agents/memory-manager.js.map

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

package/dist/agents/tool-registry.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Tool Registry
+ *
+ * Manages agent tools, their schemas, and execution.
+ * Provides tool conversion for LLM tool calling format.
+ */
+import { IAgentTool, IAgentToolSchema, IToolCallResult, IAgentToolContext } from './types';
+/**
+ * LLM-specific tool format (Anthropic Claude)
+ */
+export interface IClaudeToolDefinition {
+    name: string;
+    description: string;
+    input_schema: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+/**
+ * LLM-specific tool format (OpenAI)
+ */
+export interface IOpenAIToolDefinition {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: 'object';
+            properties: Record<string, unknown>;
+            required?: string[];
+        };
+    };
+}
+/**
+ * Tool execution options
+ */
+export interface IToolExecutionOptions {
+    /** Timeout override */
+    timeout?: number;
+    /** Retry count override */
+    retries?: number;
+    /** Skip confirmation even if tool requires it */
+    skipConfirmation?: boolean;
+}
+/**
+ * Tool Registry
+ *
+ * Manages tool definitions, validation, and execution for agents.
+ */
+export declare class ToolRegistry {
+    /** Registered tools by tag */
+    private tools;
+    /** Tool handlers (stored separately for serialization) */
+    private handlers;
+    /**
+     * Register a single tool
+     */
+    register(tool: IAgentTool): void;
+    /**
+     * Register multiple tools
+     */
+    registerMany(tools: IAgentTool[]): void;
+    /**
+     * Unregister a tool
+     */
+    unregister(tag: string): boolean;
+    /**
+     * Check if a tool exists
+     */
+    has(tag: string): boolean;
+    /**
+     * Get a tool by tag
+     */
+    get(tag: string): IAgentTool | undefined;
+    /**
+     * Get all tool tags
+     */
+    getTags(): string[];
+    /**
+     * Get tool count
+     */
+    get size(): number;
+    /**
+     * Get tool schemas (without handlers, for storage/API)
+     */
+    getSchemas(): IAgentToolSchema[];
+    /**
+     * Convert tools to Claude/Anthropic format
+     */
+    toClaudeFormat(): IClaudeToolDefinition[];
+    /**
+     * Convert tools to OpenAI format
+     */
+    toOpenAIFormat(): IOpenAIToolDefinition[];
+    /**
+     * Execute a tool
+     */
+    execute(tag: string, params: Record<string, unknown>, context: IAgentToolContext, options?: IToolExecutionOptions): Promise<IToolCallResult>;
+    /**
+     * Check if tool requires confirmation
+     */
+    requiresConfirmation(tag: string): boolean;
+    /**
+     * Get estimated cost for a tool
+     */
+    getCostEstimate(tag: string): number | undefined;
+    /**
+     * Clear all tools
+     */
+    clear(): void;
+    /**
+     * Convert IToolParam to JSON Schema format
+     */
+    private convertParametersToJsonSchema;
+    /**
+     * Convert single parameter to JSON Schema
+     */
+    private convertParamToJsonSchema;
+    /**
+     * Get required parameter names
+     */
+    private getRequiredParameters;
+    /**
+     * Validate parameters against schema
+     */
+    private validateParameters;
+    /**
+     * Validate parameter type
+     */
+    private validateType;
+    /**
+     * Execute with timeout
+     */
+    private executeWithTimeout;
+    /**
+     * Sleep helper
+     */
+    private sleep;
+}
+export default ToolRegistry;