lettactl 0.1.1

package/dist/lib/agent-manager.d.ts

@@ -0,0 +1,125 @@
+import { LettaClientWrapper } from './letta-client';
+export interface AgentConfigHashes {
+    overall: string;
+    systemPrompt: string;
+    tools: string;
+    model: string;
+    memoryBlocks: string;
+    folders: string;
+    sharedBlocks: string;
+}
+export interface AgentVersion {
+    id: string;
+    name: string;
+    baseName: string;
+    configHashes: AgentConfigHashes;
+    version: string;
+    lastUpdated: string;
+}
+export declare class AgentManager {
+    private client;
+    private agentRegistry;
+    constructor(client: LettaClientWrapper);
+    /**
+     * Generates a content hash for system prompt versioning
+     */
+    private generateContentHash;
+    /**
+     * Generates a timestamp-based version for system prompt changes
+     */
+    private generateTimestampVersion;
+    /**
+     * Parses version from agent name (e.g., "recipe-assistant__v__20241202-abc123ef")
+     */
+    private parseVersionFromName;
+    /**
+     * Loads existing agents from the server and builds the registry
+     * Note: We only store basic info here. Full configuration comparison
+     * happens in getOrCreateAgentName when we have the desired config.
+     */
+    loadExistingAgents(): Promise<void>;
+    /**
+     * Generates granular configuration hashes for each component
+     */
+    private generateAgentConfigHashes;
+    /**
+     * Determines if an agent needs to be created/updated based on complete configuration
+     */
+    getOrCreateAgentName(baseName: string, agentConfig: {
+        systemPrompt: string;
+        tools: string[];
+        toolSourceHashes?: Record<string, string>;
+        model?: string;
+        embedding?: string;
+        contextWindow?: number;
+        memoryBlocks?: Array<{
+            name: string;
+            description: string;
+            limit: number;
+            value: string;
+        }>;
+        memoryBlockFileHashes?: Record<string, string>;
+        folders?: Array<{
+            name: string;
+            files: string[];
+        }>;
+        sharedBlocks?: string[];
+    }, verbose?: boolean): Promise<{
+        agentName: string;
+        shouldCreate: boolean;
+        existingAgent?: AgentVersion;
+    }>;
+    /**
+     * Identifies what has changed between existing and desired agent configuration
+     */
+    getConfigChanges(existing: AgentVersion, newConfig: {
+        systemPrompt: string;
+        tools: string[];
+        toolSourceHashes?: Record<string, string>;
+        model?: string;
+        embedding?: string;
+        contextWindow?: number;
+        memoryBlocks?: Array<{
+            name: string;
+            description: string;
+            limit: number;
+            value: string;
+        }>;
+        memoryBlockFileHashes?: Record<string, string>;
+        folders?: Array<{
+            name: string;
+            files: string[];
+        }>;
+        sharedBlocks?: string[];
+    }): {
+        hasChanges: boolean;
+        changedComponents: string[];
+        newHashes: AgentConfigHashes;
+    };
+    /**
+     * Updates the registry after creating a new agent
+     */
+    updateRegistry(agentName: string, agentConfig: {
+        systemPrompt: string;
+        tools: 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[];
+    }, agentId: string): void;
+    /**
+     * Gets all agents with the same base name (for cleanup/management)
+     */
+    getAgentVersions(baseName: string): AgentVersion[];
+}
+//# sourceMappingURL=agent-manager.d.ts.map

package/dist/lib/agent-manager.d.ts.map

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

package/dist/lib/agent-manager.js

@@ -0,0 +1,254 @@
+"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.AgentManager = void 0;
+const response_normalizer_1 = require("./response-normalizer");
+const crypto = __importStar(require("crypto"));
+class AgentManager {
+    constructor(client) {
+        this.agentRegistry = new Map();
+        this.client = client;
+    }
+    /**
+     * Generates a content hash for system prompt versioning
+     */
+    generateContentHash(content) {
+        return crypto.createHash('sha256').update(content).digest('hex').substring(0, 16);
+    }
+    /**
+     * Generates a timestamp-based version for system prompt changes
+     */
+    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}`;
+    }
+    /**
+     * Parses version from agent name (e.g., "recipe-assistant__v__20241202-abc123ef")
+     */
+    parseVersionFromName(agentName) {
+        const versionMatch = agentName.match(/^(.+)__v__(.+)$/);
+        if (versionMatch) {
+            return { baseName: versionMatch[1], version: versionMatch[2] };
+        }
+        return { baseName: agentName, version: null };
+    }
+    /**
+     * Loads existing agents from the server and builds the registry
+     * Note: We only store basic info here. Full configuration comparison
+     * happens in getOrCreateAgentName when we have the desired config.
+     */
+    async loadExistingAgents() {
+        const agents = await this.client.listAgents();
+        const agentList = (0, response_normalizer_1.normalizeResponse)(agents);
+        for (const agent of agentList) {
+            if (agent.name && agent.system) {
+                // For existing agents, store basic info for lookup
+                // Full configuration hashing will be done during comparison
+                const configHashes = {
+                    overall: '', // Will be populated during comparison
+                    systemPrompt: this.generateContentHash(agent.system),
+                    tools: '',
+                    model: '',
+                    memoryBlocks: '',
+                    folders: '',
+                    sharedBlocks: ''
+                };
+                const { baseName, version } = this.parseVersionFromName(agent.name);
+                const agentVersion = {
+                    id: agent.id,
+                    name: agent.name,
+                    baseName: baseName,
+                    configHashes: configHashes,
+                    version: version || 'latest',
+                    lastUpdated: agent.last_updated || new Date().toISOString()
+                };
+                // Store by base name for lookup
+                const existingAgent = this.agentRegistry.get(baseName);
+                if (!existingAgent || agentVersion.lastUpdated > existingAgent.lastUpdated) {
+                    this.agentRegistry.set(baseName, agentVersion);
+                }
+            }
+        }
+    }
+    /**
+     * Generates granular configuration hashes for each component
+     */
+    generateAgentConfigHashes(config) {
+        // System prompt hash
+        const systemPromptHash = this.generateContentHash(config.systemPrompt);
+        // Tools hash - includes tool names and source code content when available
+        const toolsWithContent = (config.tools || []).map(toolName => ({
+            name: toolName,
+            sourceHash: config.toolSourceHashes?.[toolName] || ''
+        })).sort((a, b) => a.name.localeCompare(b.name));
+        const toolsHash = this.generateContentHash(JSON.stringify(toolsWithContent));
+        // Model configuration hash (model + embedding + context window)
+        const modelConfig = {
+            model: config.model || "google_ai/gemini-2.5-pro",
+            embedding: config.embedding || "letta/letta-free",
+            contextWindow: config.contextWindow || 64000
+        };
+        const modelHash = this.generateContentHash(JSON.stringify(modelConfig));
+        // Memory blocks hash - includes file content when available
+        const normalizedMemoryBlocks = (config.memoryBlocks || [])
+            .map(block => ({
+            name: block.name,
+            description: block.description,
+            limit: block.limit,
+            contentHash: config.memoryBlockFileHashes?.[block.name] || this.generateContentHash(block.value)
+        }))
+            .sort((a, b) => a.name.localeCompare(b.name));
+        const memoryBlocksHash = this.generateContentHash(JSON.stringify(normalizedMemoryBlocks));
+        // Folders hash - includes file contents when available  
+        const normalizedFolders = (config.folders || [])
+            .map(folder => ({
+            name: folder.name,
+            files: [...folder.files].sort(),
+            fileContentHashes: folder.fileContentHashes || {}
+        }))
+            .sort((a, b) => a.name.localeCompare(b.name));
+        const foldersHash = this.generateContentHash(JSON.stringify(normalizedFolders));
+        // Shared blocks hash
+        const sharedBlocksHash = this.generateContentHash(JSON.stringify([...(config.sharedBlocks || [])].sort()));
+        // Overall hash combining all components
+        const overallHash = this.generateContentHash(JSON.stringify({
+            systemPrompt: systemPromptHash,
+            tools: toolsHash,
+            model: modelHash,
+            memoryBlocks: memoryBlocksHash,
+            folders: foldersHash,
+            sharedBlocks: sharedBlocksHash
+        }));
+        return {
+            overall: overallHash,
+            systemPrompt: systemPromptHash,
+            tools: toolsHash,
+            model: modelHash,
+            memoryBlocks: memoryBlocksHash,
+            folders: foldersHash,
+            sharedBlocks: sharedBlocksHash
+        };
+    }
+    /**
+     * Determines if an agent needs to be created/updated based on complete configuration
+     */
+    async getOrCreateAgentName(baseName, agentConfig, verbose = false) {
+        const desiredConfigHashes = this.generateAgentConfigHashes(agentConfig);
+        const existingAgent = this.agentRegistry.get(baseName);
+        if (!existingAgent) {
+            // No agent with this base name exists
+            if (verbose)
+                console.log(`  No existing agent found for: ${baseName}`);
+            return {
+                agentName: baseName,
+                shouldCreate: true
+            };
+        }
+        // For existing agents, we need to compare properly by generating current config hash
+        // from the server state. For now, we'll always prefer partial updates over recreation.
+        if (verbose)
+            console.log(`  Found existing agent: ${existingAgent.name}, checking for changes...`);
+        // Always return existing agent to trigger partial update logic in apply command
+        // The actual comparison will happen in the DiffEngine
+        return {
+            agentName: existingAgent.name,
+            shouldCreate: false,
+            existingAgent
+        };
+    }
+    /**
+     * Identifies what has changed between existing and desired agent configuration
+     */
+    getConfigChanges(existing, newConfig) {
+        const newHashes = this.generateAgentConfigHashes(newConfig);
+        const changedComponents = [];
+        // Compare each component hash
+        if (existing.configHashes.systemPrompt !== newHashes.systemPrompt) {
+            changedComponents.push('systemPrompt');
+        }
+        if (existing.configHashes.tools !== newHashes.tools) {
+            changedComponents.push('tools');
+        }
+        if (existing.configHashes.model !== newHashes.model) {
+            changedComponents.push('model');
+        }
+        if (existing.configHashes.memoryBlocks !== newHashes.memoryBlocks) {
+            changedComponents.push('memoryBlocks');
+        }
+        if (existing.configHashes.folders !== newHashes.folders) {
+            changedComponents.push('folders');
+        }
+        if (existing.configHashes.sharedBlocks !== newHashes.sharedBlocks) {
+            changedComponents.push('sharedBlocks');
+        }
+        return {
+            hasChanges: changedComponents.length > 0,
+            changedComponents,
+            newHashes
+        };
+    }
+    /**
+     * Updates the registry after creating a new agent
+     */
+    updateRegistry(agentName, agentConfig, agentId) {
+        const configHashes = this.generateAgentConfigHashes(agentConfig);
+        const { baseName, version } = this.parseVersionFromName(agentName);
+        const agentVersion = {
+            id: agentId,
+            name: agentName,
+            baseName: baseName,
+            configHashes: configHashes,
+            version: version || 'latest',
+            lastUpdated: new Date().toISOString()
+        };
+        this.agentRegistry.set(baseName, agentVersion);
+    }
+    /**
+     * Gets all agents with the same base name (for cleanup/management)
+     */
+    getAgentVersions(baseName) {
+        const versions = [];
+        for (const agent of this.agentRegistry.values()) {
+            if (agent.baseName === baseName) {
+                versions.push(agent);
+            }
+        }
+        return versions.sort((a, b) => b.lastUpdated.localeCompare(a.lastUpdated));
+    }
+}
+exports.AgentManager = AgentManager;
+//# sourceMappingURL=agent-manager.js.map

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

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

package/dist/lib/agent-resolver.d.ts

@@ -0,0 +1,12 @@
+import { LettaClientWrapper } from './letta-client';
+export declare class AgentResolver {
+    private client;
+    constructor(client: LettaClientWrapper);
+    findAgentByName(name: string): Promise<{
+        agent: any;
+        allAgents: any[];
+    }>;
+    getAllAgents(): Promise<any[]>;
+    getAgentWithDetails(agentId: string): Promise<any>;
+}
+//# sourceMappingURL=agent-resolver.d.ts.map

package/dist/lib/agent-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-resolver.d.ts","sourceRoot":"","sources":["../../src/lib/agent-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGpD,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAqB;gBAEvB,MAAM,EAAE,kBAAkB;IAIhC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,GAAG,CAAC;QAAC,SAAS,EAAE,GAAG,EAAE,CAAA;KAAE,CAAC;IAYxE,YAAY,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAK9B,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;CAGzD"}

package/dist/lib/agent-resolver.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentResolver = void 0;
+const response_normalizer_1 = require("./response-normalizer");
+class AgentResolver {
+    constructor(client) {
+        this.client = client;
+    }
+    async findAgentByName(name) {
+        const agents = await this.client.listAgents();
+        const agentList = (0, response_normalizer_1.normalizeResponse)(agents);
+        const agent = agentList.find((a) => a.name === name);
+        if (!agent) {
+            throw new Error(`Agent "${name}" not found`);
+        }
+        return { agent, allAgents: agentList };
+    }
+    async getAllAgents() {
+        const agents = await this.client.listAgents();
+        return (0, response_normalizer_1.normalizeResponse)(agents);
+    }
+    async getAgentWithDetails(agentId) {
+        return await this.client.getAgent(agentId);
+    }
+}
+exports.AgentResolver = AgentResolver;
+//# sourceMappingURL=agent-resolver.js.map

package/dist/lib/agent-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-resolver.js","sourceRoot":"","sources":["../../src/lib/agent-resolver.ts"],"names":[],"mappings":";;;AACA,+DAA0D;AAE1D,MAAa,aAAa;IAGxB,YAAY,MAA0B;QACpC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,IAAY;QAChC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QAC9C,MAAM,SAAS,GAAG,IAAA,uCAAiB,EAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAE1D,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,aAAa,CAAC,CAAC;QAC/C,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QAC9C,OAAO,IAAA,uCAAiB,EAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,OAAe;QACvC,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;CACF;AA3BD,sCA2BC"}

package/dist/lib/block-manager.d.ts

@@ -0,0 +1,63 @@
+import { LettaClientWrapper } from './letta-client';
+export interface BlockVersion {
+    id: string;
+    label: string;
+    description: string;
+    value: string;
+    limit: number;
+    contentHash: string;
+    version: string;
+    isShared: boolean;
+    lastUpdated: string;
+    userDefined: boolean;
+}
+export declare class BlockManager {
+    private client;
+    private blockRegistry;
+    constructor(client: LettaClientWrapper);
+    /**
+     * Generates a content hash for version detection
+     */
+    private generateContentHash;
+    /**
+     * Loads existing blocks from the server and builds the registry
+     */
+    loadExistingBlocks(): Promise<void>;
+    /**
+     * Parses version string from block label (e.g., "block_name__v__20241202-a1b2c3d4" -> "20241202-a1b2c3d4")
+     */
+    private parseVersionFromLabel;
+    /**
+     * Gets the registry key for a block
+     */
+    private getBlockKey;
+    /**
+     * Generates a timestamp-based version string
+     */
+    private generateTimestampVersion;
+    /**
+     * Validates and sanitizes user-defined version tags
+     */
+    private validateUserVersion;
+    /**
+     * Creates a versioned block label
+     */
+    private createVersionedLabel;
+    /**
+     * Gets or creates a shared block, with enhanced versioning support
+     */
+    getOrCreateSharedBlock(blockConfig: any): Promise<string>;
+    /**
+     * Gets or creates an agent-specific block with enhanced versioning
+     */
+    getOrCreateAgentBlock(blockConfig: any, agentName: string): Promise<string>;
+    /**
+     * Gets the shared block ID by name
+     */
+    getSharedBlockId(blockName: string): string | null;
+    /**
+     * Lists all block versions for debugging/reporting
+     */
+    getBlockRegistry(): Map<string, BlockVersion>;
+}
+//# sourceMappingURL=block-manager.d.ts.map

package/dist/lib/block-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-manager.d.ts","sourceRoot":"","sources":["../../src/lib/block-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAIpD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,aAAa,CAAmC;gBAE5C,MAAM,EAAE,kBAAkB;IAItC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BzC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAK7B;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAOhC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAK3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;OAEG;IACG,sBAAsB,CAAC,WAAW,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IAqF/D;;OAEG;IACG,qBAAqB,CAAC,WAAW,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAsFjF;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAMlD;;OAEG;IACH,gBAAgB,IAAI,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC;CAG9C"}