lettactl 0.1.1

package/dist/lib/block-manager.js

@@ -0,0 +1,288 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlockManager = void 0;
+const response_normalizer_1 = require("./response-normalizer");
+const crypto = __importStar(require("crypto"));
+class BlockManager {
+    constructor(client) {
+        this.blockRegistry = new Map();
+        this.client = client;
+    }
+    /**
+     * Generates a content hash for version detection
+     */
+    generateContentHash(content) {
+        return crypto.createHash('sha256').update(content).digest('hex').substring(0, 16);
+    }
+    /**
+     * Loads existing blocks from the server and builds the registry
+     */
+    async loadExistingBlocks() {
+        const blocks = await this.client.listBlocks();
+        const blockList = (0, response_normalizer_1.normalizeResponse)(blocks);
+        for (const block of blockList) {
+            if (block.label && block.value) {
+                const contentHash = this.generateContentHash(block.value);
+                const version = this.parseVersionFromLabel(block.label);
+                const isShared = block.label.startsWith('shared_');
+                const blockVersion = {
+                    id: block.id,
+                    label: block.label,
+                    description: block.description || '',
+                    value: block.value,
+                    limit: block.limit || 0,
+                    contentHash,
+                    version,
+                    isShared,
+                    lastUpdated: block.updated_at || new Date().toISOString(),
+                    userDefined: false // We can't know if existing blocks had user-defined versions
+                };
+                this.blockRegistry.set(this.getBlockKey(block.label, isShared), blockVersion);
+            }
+        }
+    }
+    /**
+     * Parses version string from block label (e.g., "block_name__v__20241202-a1b2c3d4" -> "20241202-a1b2c3d4")
+     */
+    parseVersionFromLabel(label) {
+        const versionMatch = label.match(/__v__(.+)$/);
+        return versionMatch ? versionMatch[1] : 'initial';
+    }
+    /**
+     * Gets the registry key for a block
+     */
+    getBlockKey(baseName, isShared) {
+        const cleanName = baseName.replace(/__v__.+$/, ''); // Remove version suffix
+        return isShared ? `shared:${cleanName}` : cleanName;
+    }
+    /**
+     * Generates a timestamp-based version string
+     */
+    generateTimestampVersion(contentHash) {
+        const now = new Date();
+        const timestamp = now.toISOString().slice(0, 10).replace(/-/g, ''); // YYYYMMDD
+        const shortHash = contentHash.substring(0, 8);
+        return `${timestamp}-${shortHash}`;
+    }
+    /**
+     * Validates and sanitizes user-defined version tags
+     */
+    validateUserVersion(version) {
+        // Remove spaces, convert to lowercase, replace invalid chars with dashes
+        return version.trim().toLowerCase().replace(/[^a-z0-9.-]/g, '-');
+    }
+    /**
+     * Creates a versioned block label
+     */
+    createVersionedLabel(baseName, version, isFirstVersion = false) {
+        return isFirstVersion && version === 'initial' ? baseName : `${baseName}__v__${version}`;
+    }
+    /**
+     * Gets or creates a shared block, with enhanced versioning support
+     */
+    async getOrCreateSharedBlock(blockConfig) {
+        const blockKey = this.getBlockKey(blockConfig.name, true);
+        const contentHash = this.generateContentHash(blockConfig.value);
+        const existing = this.blockRegistry.get(blockKey);
+        // Determine version strategy
+        let newVersion;
+        let userDefined = false;
+        if (blockConfig.version) {
+            newVersion = this.validateUserVersion(blockConfig.version);
+            userDefined = true;
+        }
+        else {
+            newVersion = existing ? this.generateTimestampVersion(contentHash) : 'initial';
+        }
+        if (existing) {
+            // Check if content has changed or user wants a specific version
+            if (existing.contentHash === contentHash && !blockConfig.version) {
+                console.log(`Using existing shared block: ${existing.label}`);
+                return existing.id;
+            }
+            else {
+                // Content changed or user specified version
+                const newLabel = this.createVersionedLabel(blockConfig.name, newVersion);
+                const reason = blockConfig.version
+                    ? `user tagged as '${newVersion}'`
+                    : `content changed (${newVersion})`;
+                console.log(`Creating shared block ${newLabel} (${reason}, was ${existing.label})`);
+                const newBlock = await this.client.createBlock({
+                    label: newLabel,
+                    description: blockConfig.description,
+                    value: blockConfig.value,
+                    limit: blockConfig.limit
+                });
+                const blockVersion = {
+                    id: newBlock.id,
+                    label: newLabel,
+                    description: blockConfig.description,
+                    value: blockConfig.value,
+                    limit: blockConfig.limit,
+                    contentHash,
+                    version: newVersion,
+                    isShared: true,
+                    lastUpdated: new Date().toISOString(),
+                    userDefined
+                };
+                this.blockRegistry.set(blockKey, blockVersion);
+                return newBlock.id;
+            }
+        }
+        else {
+            // Create new shared block
+            const isFirstVersion = newVersion === 'initial';
+            const newLabel = this.createVersionedLabel(blockConfig.name, newVersion, isFirstVersion);
+            console.log(`Creating new shared block: ${newLabel}${userDefined ? ` (tagged: ${newVersion})` : ''}`);
+            const newBlock = await this.client.createBlock({
+                label: newLabel,
+                description: blockConfig.description,
+                value: blockConfig.value,
+                limit: blockConfig.limit
+            });
+            const blockVersion = {
+                id: newBlock.id,
+                label: newLabel,
+                description: blockConfig.description,
+                value: blockConfig.value,
+                limit: blockConfig.limit,
+                contentHash,
+                version: newVersion,
+                isShared: true,
+                lastUpdated: new Date().toISOString(),
+                userDefined
+            };
+            this.blockRegistry.set(blockKey, blockVersion);
+            return newBlock.id;
+        }
+    }
+    /**
+     * Gets or creates an agent-specific block with enhanced versioning
+     */
+    async getOrCreateAgentBlock(blockConfig, agentName) {
+        const fullBlockName = `${blockConfig.name}`;
+        const blockKey = this.getBlockKey(fullBlockName, false);
+        const contentHash = this.generateContentHash(blockConfig.value);
+        const existing = this.blockRegistry.get(blockKey);
+        // Determine version strategy
+        let newVersion;
+        let userDefined = false;
+        if (blockConfig.version) {
+            newVersion = this.validateUserVersion(blockConfig.version);
+            userDefined = true;
+        }
+        else {
+            newVersion = existing ? this.generateTimestampVersion(contentHash) : 'initial';
+        }
+        if (existing) {
+            // Check if content has changed or user wants a specific version
+            if (existing.contentHash === contentHash && !blockConfig.version) {
+                console.log(`Using existing block: ${existing.label}`);
+                return existing.id;
+            }
+            else {
+                // Content changed or user specified version
+                const newLabel = this.createVersionedLabel(fullBlockName, newVersion);
+                const reason = blockConfig.version
+                    ? `user tagged as '${newVersion}'`
+                    : `content changed (${newVersion})`;
+                console.log(`Creating block ${newLabel} (${reason}, was ${existing.label})`);
+                const newBlock = await this.client.createBlock({
+                    label: newLabel,
+                    description: blockConfig.description,
+                    value: blockConfig.value,
+                    limit: blockConfig.limit
+                });
+                const blockVersion = {
+                    id: newBlock.id,
+                    label: newLabel,
+                    description: blockConfig.description,
+                    value: blockConfig.value,
+                    limit: blockConfig.limit,
+                    contentHash,
+                    version: newVersion,
+                    isShared: false,
+                    lastUpdated: new Date().toISOString(),
+                    userDefined
+                };
+                this.blockRegistry.set(blockKey, blockVersion);
+                return newBlock.id;
+            }
+        }
+        else {
+            // Create new agent block
+            const isFirstVersion = newVersion === 'initial';
+            const newLabel = this.createVersionedLabel(fullBlockName, newVersion, isFirstVersion);
+            console.log(`Creating new block: ${newLabel}${userDefined ? ` (tagged: ${newVersion})` : ''}`);
+            const newBlock = await this.client.createBlock({
+                label: newLabel,
+                description: blockConfig.description,
+                value: blockConfig.value,
+                limit: blockConfig.limit
+            });
+            const blockVersion = {
+                id: newBlock.id,
+                label: newLabel,
+                description: blockConfig.description,
+                value: blockConfig.value,
+                limit: blockConfig.limit,
+                contentHash,
+                version: newVersion,
+                isShared: false,
+                lastUpdated: new Date().toISOString(),
+                userDefined
+            };
+            this.blockRegistry.set(blockKey, blockVersion);
+            return newBlock.id;
+        }
+    }
+    /**
+     * Gets the shared block ID by name
+     */
+    getSharedBlockId(blockName) {
+        const blockKey = this.getBlockKey(blockName, true);
+        const existing = this.blockRegistry.get(blockKey);
+        return existing ? existing.id : null;
+    }
+    /**
+     * Lists all block versions for debugging/reporting
+     */
+    getBlockRegistry() {
+        return new Map(this.blockRegistry);
+    }
+}
+exports.BlockManager = BlockManager;
+//# sourceMappingURL=block-manager.js.map

package/dist/lib/block-manager.js.map

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

package/dist/lib/diff-engine.d.ts

@@ -0,0 +1,129 @@
+import { LettaClientWrapper } from './letta-client';
+import { AgentVersion } from './agent-manager';
+import { BlockManager } from './block-manager';
+export interface ToolDiff {
+    toAdd: Array<{
+        name: string;
+        id: string;
+    }>;
+    toRemove: Array<{
+        name: string;
+        id: string;
+    }>;
+    toUpdate: Array<{
+        name: string;
+        currentId: string;
+        newId: string;
+        reason: string;
+    }>;
+    unchanged: Array<{
+        name: string;
+        id: string;
+    }>;
+}
+export interface BlockDiff {
+    toAdd: Array<{
+        name: string;
+        id: string;
+    }>;
+    toRemove: Array<{
+        name: string;
+        id: string;
+    }>;
+    toUpdate: Array<{
+        name: string;
+        currentId: string;
+        newId: string;
+    }>;
+    unchanged: Array<{
+        name: string;
+        id: string;
+    }>;
+}
+export interface FolderDiff {
+    toAttach: Array<{
+        name: string;
+        id: string;
+    }>;
+    toDetach: Array<{
+        name: string;
+        id: string;
+    }>;
+    toUpdate: Array<{
+        name: string;
+        id: string;
+        filesToAdd: string[];
+        filesToRemove: string[];
+        filesToUpdate: string[];
+    }>;
+    unchanged: Array<{
+        name: string;
+        id: string;
+    }>;
+}
+export interface AgentUpdateOperations {
+    updateFields?: {
+        systemPrompt?: string;
+        model?: string;
+        embedding?: string;
+        contextWindow?: number;
+    };
+    tools?: ToolDiff;
+    blocks?: BlockDiff;
+    folders?: FolderDiff;
+    preservesConversation: boolean;
+    operationCount: number;
+}
+/**
+ * DiffEngine determines what specific operations are needed to update an agent
+ * while preserving conversation history whenever possible
+ */
+export declare class DiffEngine {
+    private client;
+    private blockManager;
+    private basePath;
+    constructor(client: LettaClientWrapper, blockManager: BlockManager, basePath?: string);
+    /**
+     * Analyzes differences between existing and desired agent configuration
+     * and generates specific update operations that preserve conversation history
+     */
+    generateUpdateOperations(existingAgent: AgentVersion, desiredConfig: {
+        systemPrompt: string;
+        tools: string[];
+        toolSourceHashes?: Record<string, string>;
+        model?: string;
+        embedding?: string;
+        contextWindow?: number;
+        memoryBlocks?: Array<{
+            name: string;
+            description: string;
+            limit: number;
+            value: string;
+        }>;
+        folders?: Array<{
+            name: string;
+            files: string[];
+        }>;
+        sharedBlocks?: string[];
+    }, toolRegistry: Map<string, string>, folderRegistry: Map<string, string>, verbose?: boolean): Promise<AgentUpdateOperations>;
+    private analyzeToolChanges;
+    private analyzeBlockChanges;
+    private analyzeFolderChanges;
+    /**
+     * Applies the update operations to the agent
+     */
+    applyUpdateOperations(agentId: string, operations: AgentUpdateOperations, verbose?: boolean): Promise<void>;
+    /**
+     * Helper method to add a file to an existing folder
+     */
+    private addFileToFolder;
+    /**
+     * Helper method to remove a file from a folder
+     */
+    private removeFileFromFolder;
+    /**
+     * Helper method to update an existing file in a folder
+     */
+    private updateFileInFolder;
+}
+//# sourceMappingURL=diff-engine.d.ts.map

package/dist/lib/diff-engine.d.ts.map

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