agentstudio 0.1.18 → 0.1.21

package/utils/__tests__/sessionUtils.test.js

@@ -0,0 +1,295 @@
+"use strict";
+/**
+ * Unit tests for sessionUtils.ts
+ */
+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 });
+const vitest_1 = require("vitest");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const sessionUtils_1 = require("../sessionUtils");
+// Mock sessionManager
+vitest_1.vi.mock('../../services/sessionManager', () => ({
+    sessionManager: {
+        getSession: vitest_1.vi.fn(),
+        checkSessionExists: vitest_1.vi.fn(),
+        createNewSession: vitest_1.vi.fn()
+    }
+}));
+// Mock fs
+vitest_1.vi.mock('fs', () => ({
+    existsSync: vitest_1.vi.fn(),
+    mkdirSync: vitest_1.vi.fn(),
+    writeFileSync: vitest_1.vi.fn()
+}));
+// Mock claudeVersionStorage
+vitest_1.vi.mock('../../services/claudeVersionStorage', () => ({
+    getDefaultVersionId: vitest_1.vi.fn(),
+    getAllVersions: vitest_1.vi.fn()
+}));
+(0, vitest_1.describe)('sessionUtils', () => {
+    (0, vitest_1.beforeEach)(() => {
+        vitest_1.vi.clearAllMocks();
+    });
+    (0, vitest_1.describe)('handleSessionManagement', () => {
+        const mockAgent = 'test-agent';
+        const mockQueryOptions = { cwd: '/test', model: 'sonnet' };
+        (0, vitest_1.it)('should reuse existing session from memory', async () => {
+            const mockSession = { id: 'existing-session' };
+            const { sessionManager } = await Promise.resolve().then(() => __importStar(require('../../services/sessionManager')));
+            vitest_1.vi.mocked(sessionManager.getSession).mockReturnValue(mockSession);
+            const result = await (0, sessionUtils_1.handleSessionManagement)(mockAgent, 'existing-session', '/test/path', mockQueryOptions);
+            (0, vitest_1.expect)(result.claudeSession).toBe(mockSession);
+            (0, vitest_1.expect)(result.actualSessionId).toBe('existing-session');
+            (0, vitest_1.expect)(sessionManager.getSession).toHaveBeenCalledWith('existing-session');
+        });
+        (0, vitest_1.it)('should resume session if history exists in project', async () => {
+            const mockNewSession = { id: 'resumed-session' };
+            const { sessionManager } = await Promise.resolve().then(() => __importStar(require('../../services/sessionManager')));
+            vitest_1.vi.mocked(sessionManager.getSession).mockReturnValue(null);
+            vitest_1.vi.mocked(sessionManager.checkSessionExists).mockReturnValue(true);
+            vitest_1.vi.mocked(sessionManager.createNewSession).mockReturnValue(mockNewSession);
+            const result = await (0, sessionUtils_1.handleSessionManagement)(mockAgent, 'old-session', '/test/path', mockQueryOptions, 'version-1');
+            (0, vitest_1.expect)(result.claudeSession).toBe(mockNewSession);
+            (0, vitest_1.expect)(sessionManager.checkSessionExists).toHaveBeenCalledWith('old-session', '/test/path');
+            (0, vitest_1.expect)(sessionManager.createNewSession).toHaveBeenCalledWith(mockAgent, mockQueryOptions, 'old-session', 'version-1', undefined // modelId
+            );
+        });
+        (0, vitest_1.it)('should create new session if no history found', async () => {
+            const mockNewSession = { id: 'new-session' };
+            const { sessionManager } = await Promise.resolve().then(() => __importStar(require('../../services/sessionManager')));
+            vitest_1.vi.mocked(sessionManager.getSession).mockReturnValue(null);
+            vitest_1.vi.mocked(sessionManager.checkSessionExists).mockReturnValue(false);
+            vitest_1.vi.mocked(sessionManager.createNewSession).mockReturnValue(mockNewSession);
+            const result = await (0, sessionUtils_1.handleSessionManagement)(mockAgent, 'non-existent-session', '/test/path', mockQueryOptions);
+            (0, vitest_1.expect)(result.claudeSession).toBe(mockNewSession);
+            (0, vitest_1.expect)(sessionManager.createNewSession).toHaveBeenCalledWith(mockAgent, mockQueryOptions, undefined, undefined, undefined // modelId
+            );
+        });
+        (0, vitest_1.it)('should create new session when no sessionId provided', async () => {
+            const mockNewSession = { id: 'brand-new-session' };
+            const { sessionManager } = await Promise.resolve().then(() => __importStar(require('../../services/sessionManager')));
+            vitest_1.vi.mocked(sessionManager.createNewSession).mockReturnValue(mockNewSession);
+            const result = await (0, sessionUtils_1.handleSessionManagement)(mockAgent, null, '/test/path', mockQueryOptions);
+            (0, vitest_1.expect)(result.claudeSession).toBe(mockNewSession);
+            (0, vitest_1.expect)(result.actualSessionId).toBeNull();
+            (0, vitest_1.expect)(sessionManager.createNewSession).toHaveBeenCalledWith(mockAgent, mockQueryOptions, undefined, undefined, undefined // modelId
+            );
+        });
+    });
+    (0, vitest_1.describe)('isVisionModel', () => {
+        (0, vitest_1.it)('should return true if model supports vision', async () => {
+            const mockVersions = [
+                {
+                    id: 'version-1',
+                    models: [
+                        { id: 'sonnet', isVision: true },
+                        { id: 'opus', isVision: false }
+                    ]
+                }
+            ];
+            const { getAllVersions, getDefaultVersionId } = await Promise.resolve().then(() => __importStar(require('../../services/claudeVersionStorage')));
+            vitest_1.vi.mocked(getDefaultVersionId).mockResolvedValue('version-1');
+            vitest_1.vi.mocked(getAllVersions).mockResolvedValue(mockVersions);
+            const result = await (0, sessionUtils_1.isVisionModel)('sonnet');
+            (0, vitest_1.expect)(result).toBe(true);
+        });
+        (0, vitest_1.it)('should return false if model does not support vision', async () => {
+            const mockVersions = [
+                {
+                    id: 'version-1',
+                    models: [
+                        { id: 'sonnet', isVision: true },
+                        { id: 'opus', isVision: false }
+                    ]
+                }
+            ];
+            const { getAllVersions, getDefaultVersionId } = await Promise.resolve().then(() => __importStar(require('../../services/claudeVersionStorage')));
+            vitest_1.vi.mocked(getDefaultVersionId).mockResolvedValue('version-1');
+            vitest_1.vi.mocked(getAllVersions).mockResolvedValue(mockVersions);
+            const result = await (0, sessionUtils_1.isVisionModel)('opus');
+            (0, vitest_1.expect)(result).toBe(false);
+        });
+        (0, vitest_1.it)('should return true if version not found', async () => {
+            const { getAllVersions, getDefaultVersionId } = await Promise.resolve().then(() => __importStar(require('../../services/claudeVersionStorage')));
+            vitest_1.vi.mocked(getDefaultVersionId).mockResolvedValue('non-existent');
+            vitest_1.vi.mocked(getAllVersions).mockResolvedValue([]);
+            const result = await (0, sessionUtils_1.isVisionModel)('sonnet');
+            (0, vitest_1.expect)(result).toBe(true);
+        });
+        (0, vitest_1.it)('should return true if model not found in version', async () => {
+            const mockVersions = [
+                {
+                    id: 'version-1',
+                    models: [
+                        { id: 'sonnet', isVision: true }
+                    ]
+                }
+            ];
+            const { getAllVersions, getDefaultVersionId } = await Promise.resolve().then(() => __importStar(require('../../services/claudeVersionStorage')));
+            vitest_1.vi.mocked(getDefaultVersionId).mockResolvedValue('version-1');
+            vitest_1.vi.mocked(getAllVersions).mockResolvedValue(mockVersions);
+            const result = await (0, sessionUtils_1.isVisionModel)('unknown-model');
+            (0, vitest_1.expect)(result).toBe(true);
+        });
+    });
+    (0, vitest_1.describe)('saveImageToHiddenDir', () => {
+        (0, vitest_1.it)('should save image to hidden directory and return relative path', () => {
+            vitest_1.vi.mocked(fs.existsSync).mockReturnValue(true);
+            const imageData = Buffer.from('test-image-data').toString('base64');
+            const result = (0, sessionUtils_1.saveImageToHiddenDir)(imageData, 'image/jpeg', 1, '/test/project');
+            (0, vitest_1.expect)(fs.writeFileSync).toHaveBeenCalled();
+            (0, vitest_1.expect)(result).toMatch(/^\.agentstudio-images\/image1_\d+\.jpg$/);
+        });
+        (0, vitest_1.it)('should create hidden directory if it does not exist', () => {
+            vitest_1.vi.mocked(fs.existsSync).mockReturnValue(false);
+            const imageData = Buffer.from('test-image-data').toString('base64');
+            (0, sessionUtils_1.saveImageToHiddenDir)(imageData, 'image/png', 2, '/test/project');
+            (0, vitest_1.expect)(fs.mkdirSync).toHaveBeenCalledWith(path.join('/test/project', '.agentstudio-images'), { recursive: true });
+        });
+        (0, vitest_1.it)('should use correct file extension for different media types', () => {
+            vitest_1.vi.mocked(fs.existsSync).mockReturnValue(true);
+            const imageData = Buffer.from('test-image-data').toString('base64');
+            const pngResult = (0, sessionUtils_1.saveImageToHiddenDir)(imageData, 'image/png', 1);
+            (0, vitest_1.expect)(pngResult).toMatch(/\.png$/);
+            const gifResult = (0, sessionUtils_1.saveImageToHiddenDir)(imageData, 'image/gif', 2);
+            (0, vitest_1.expect)(gifResult).toMatch(/\.gif$/);
+            const webpResult = (0, sessionUtils_1.saveImageToHiddenDir)(imageData, 'image/webp', 3);
+            (0, vitest_1.expect)(webpResult).toMatch(/\.webp$/);
+        });
+    });
+    (0, vitest_1.describe)('buildUserMessageContent', () => {
+        (0, vitest_1.it)('should build message with text only', async () => {
+            const result = await (0, sessionUtils_1.buildUserMessageContent)('Hello, Claude!');
+            (0, vitest_1.expect)(result).toEqual({
+                type: 'user',
+                message: {
+                    role: 'user',
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'Hello, Claude!'
+                        }
+                    ]
+                }
+            });
+        });
+        (0, vitest_1.it)('should include images directly for vision models', async () => {
+            const mockVersions = [
+                {
+                    id: 'version-1',
+                    models: [{ id: 'sonnet', isVision: true }]
+                }
+            ];
+            const { getAllVersions, getDefaultVersionId } = await Promise.resolve().then(() => __importStar(require('../../services/claudeVersionStorage')));
+            vitest_1.vi.mocked(getDefaultVersionId).mockResolvedValue('version-1');
+            vitest_1.vi.mocked(getAllVersions).mockResolvedValue(mockVersions);
+            const images = [
+                {
+                    id: 'img1',
+                    data: 'base64imagedata',
+                    mediaType: 'image/jpeg',
+                    filename: 'test.jpg'
+                }
+            ];
+            const result = await (0, sessionUtils_1.buildUserMessageContent)('Analyze this image', images, 'sonnet', '/test/path', 'version-1');
+            (0, vitest_1.expect)(result.message.content).toHaveLength(2);
+            (0, vitest_1.expect)(result.message.content[0]).toEqual({
+                type: 'image',
+                source: {
+                    type: 'base64',
+                    media_type: 'image/jpeg',
+                    data: 'base64imagedata'
+                }
+            });
+            (0, vitest_1.expect)(result.message.content[1]).toEqual({
+                type: 'text',
+                text: 'Analyze this image'
+            });
+        });
+        (0, vitest_1.it)('should save images to file for non-vision models', async () => {
+            const mockVersions = [
+                {
+                    id: 'version-1',
+                    models: [{ id: 'opus', isVision: false }]
+                }
+            ];
+            const { getAllVersions, getDefaultVersionId } = await Promise.resolve().then(() => __importStar(require('../../services/claudeVersionStorage')));
+            vitest_1.vi.mocked(getDefaultVersionId).mockResolvedValue('version-1');
+            vitest_1.vi.mocked(getAllVersions).mockResolvedValue(mockVersions);
+            vitest_1.vi.mocked(fs.existsSync).mockReturnValue(true);
+            const images = [
+                {
+                    id: 'img1',
+                    data: Buffer.from('test-image-data').toString('base64'),
+                    mediaType: 'image/jpeg',
+                    filename: 'test.jpg'
+                }
+            ];
+            const result = await (0, sessionUtils_1.buildUserMessageContent)('Look at [image1]', images, 'opus', '/test/path', 'version-1');
+            (0, vitest_1.expect)(fs.writeFileSync).toHaveBeenCalled();
+            (0, vitest_1.expect)(result.message.content[0].text).toMatch(/@\.agentstudio-images\/image1_\d+\.jpg/);
+        });
+        (0, vitest_1.it)('should handle multiple images', async () => {
+            const mockVersions = [
+                {
+                    id: 'version-1',
+                    models: [{ id: 'sonnet', isVision: true }]
+                }
+            ];
+            const { getAllVersions, getDefaultVersionId } = await Promise.resolve().then(() => __importStar(require('../../services/claudeVersionStorage')));
+            vitest_1.vi.mocked(getDefaultVersionId).mockResolvedValue('version-1');
+            vitest_1.vi.mocked(getAllVersions).mockResolvedValue(mockVersions);
+            const images = [
+                {
+                    id: 'img1',
+                    data: 'imagedata1',
+                    mediaType: 'image/jpeg'
+                },
+                {
+                    id: 'img2',
+                    data: 'imagedata2',
+                    mediaType: 'image/png'
+                }
+            ];
+            const result = await (0, sessionUtils_1.buildUserMessageContent)('Analyze these images', images, 'sonnet', '/test/path', 'version-1');
+            (0, vitest_1.expect)(result.message.content).toHaveLength(3); // 2 images + 1 text
+            (0, vitest_1.expect)(result.message.content[0].type).toBe('image');
+            (0, vitest_1.expect)(result.message.content[1].type).toBe('image');
+            (0, vitest_1.expect)(result.message.content[2].type).toBe('text');
+        });
+    });
+});
+//# sourceMappingURL=sessionUtils.test.js.map

package/utils/__tests__/sessionUtils.test.js.map

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

package/utils/agentCardCache.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Agent Card LRU Cache
+ *
+ * Implements optional caching for Agent Cards with automatic invalidation
+ * based on agent configuration hash changes.
+ *
+ * Features:
+ * - LRU eviction with configurable max size (default 100 entries)
+ * - Hash-based cache keys (deterministic from agent config)
+ * - O(1) get/set operations
+ * - Thread-safe for single-process deployments
+ *
+ * Phase 4: US2 - Agent Card Auto-Generation (T042)
+ */
+import type { AgentConfig } from '../types/agents.js';
+import type { AgentCard } from '../types/a2a.js';
+import type { ProjectContext } from '../services/a2a/agentCardService.js';
+/**
+ * Agent Card LRU Cache implementation
+ */
+export declare class AgentCardCache {
+    private maxSize;
+    private cache;
+    private head;
+    private tail;
+    constructor(maxSize?: number);
+    /**
+     * Get Agent Card from cache
+     *
+     * @param agentConfig - Agent configuration for hash calculation
+     * @param projectContext - Project context for hash calculation
+     * @returns Cached Agent Card or null if not found or expired
+     */
+    get(agentConfig: AgentConfig, projectContext: ProjectContext): AgentCard | null;
+    /**
+     * Set Agent Card in cache
+     *
+     * @param agentConfig - Agent configuration for hash calculation
+     * @param projectContext - Project context for hash calculation
+     * @param agentCard - Agent Card to cache
+     */
+    set(agentConfig: AgentConfig, projectContext: ProjectContext, agentCard: AgentCard): void;
+    /**
+     * Clear entire cache
+     */
+    clear(): void;
+    /**
+     * Get current cache size
+     */
+    size(): number;
+    /**
+     * Invalidate cache entry for specific agent config
+     *
+     * @param agentConfig - Agent configuration
+     * @param projectContext - Project context
+     * @returns true if entry was found and removed, false otherwise
+     */
+    invalidate(agentConfig: AgentConfig, projectContext: ProjectContext): boolean;
+    /**
+     * Generate cache key from agent config and project context
+     *
+     * Uses SHA-256 hash of deterministic JSON serialization.
+     * Hash includes:
+     * - Agent config fields that affect Agent Card (name, version, tools, etc.)
+     * - Project context (projectId, a2aAgentId, baseUrl)
+     *
+     * @param agentConfig - Agent configuration
+     * @param projectContext - Project context
+     * @returns SHA-256 hash as cache key
+     */
+    private generateCacheKey;
+    /**
+     * Move node to head (most recently used)
+     */
+    private moveToHead;
+    /**
+     * Add node to head
+     */
+    private addToHead;
+    /**
+     * Remove node from linked list
+     */
+    private removeNode;
+    /**
+     * Remove tail node (least recently used)
+     */
+    private removeTail;
+}
+/**
+ * Global singleton cache instance
+ */
+export declare const agentCardCache: AgentCardCache;
+//# sourceMappingURL=agentCardCache.d.ts.map

package/utils/agentCardCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentCardCache.d.ts","sourceRoot":"","sources":["../../src/utils/agentCardCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAY1E;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,IAAI,CAAmB;IAC/B,OAAO,CAAC,IAAI,CAAmB;gBAEnB,OAAO,GAAE,MAAY;IAOjC;;;;;;OAMG;IACH,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI;IAc/E;;;;;;OAMG;IACH,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;IAgCzF;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,IAAI,IAAI,MAAM;IAId;;;;;;OAMG;IACH,UAAU,CAAC,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,GAAG,OAAO;IAa7E;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,gBAAgB;IA0BxB;;OAEG;IACH,OAAO,CAAC,UAAU;IAKlB;;OAEG;IACH,OAAO,CAAC,SAAS;IAejB;;OAEG;IACH,OAAO,CAAC,UAAU;IAclB;;OAEG;IACH,OAAO,CAAC,UAAU;CAanB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,gBAA0B,CAAC"}

package/utils/agentCardCache.js

@@ -0,0 +1,212 @@
+"use strict";
+/**
+ * Agent Card LRU Cache
+ *
+ * Implements optional caching for Agent Cards with automatic invalidation
+ * based on agent configuration hash changes.
+ *
+ * Features:
+ * - LRU eviction with configurable max size (default 100 entries)
+ * - Hash-based cache keys (deterministic from agent config)
+ * - O(1) get/set operations
+ * - Thread-safe for single-process deployments
+ *
+ * Phase 4: US2 - Agent Card Auto-Generation (T042)
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentCardCache = exports.AgentCardCache = void 0;
+const crypto_1 = __importDefault(require("crypto"));
+/**
+ * Agent Card LRU Cache implementation
+ */
+class AgentCardCache {
+    maxSize;
+    cache;
+    head;
+    tail;
+    constructor(maxSize = 100) {
+        this.maxSize = maxSize;
+        this.cache = new Map();
+        this.head = null;
+        this.tail = null;
+    }
+    /**
+     * Get Agent Card from cache
+     *
+     * @param agentConfig - Agent configuration for hash calculation
+     * @param projectContext - Project context for hash calculation
+     * @returns Cached Agent Card or null if not found or expired
+     */
+    get(agentConfig, projectContext) {
+        const key = this.generateCacheKey(agentConfig, projectContext);
+        const node = this.cache.get(key);
+        if (!node) {
+            return null;
+        }
+        // Move accessed node to head (most recently used)
+        this.moveToHead(node);
+        return node.value;
+    }
+    /**
+     * Set Agent Card in cache
+     *
+     * @param agentConfig - Agent configuration for hash calculation
+     * @param projectContext - Project context for hash calculation
+     * @param agentCard - Agent Card to cache
+     */
+    set(agentConfig, projectContext, agentCard) {
+        const key = this.generateCacheKey(agentConfig, projectContext);
+        const existingNode = this.cache.get(key);
+        if (existingNode) {
+            // Update existing node
+            existingNode.value = agentCard;
+            this.moveToHead(existingNode);
+            return;
+        }
+        // Create new node
+        const newNode = {
+            key,
+            value: agentCard,
+            prev: null,
+            next: null,
+        };
+        this.cache.set(key, newNode);
+        this.addToHead(newNode);
+        // Check if cache size exceeded
+        if (this.cache.size > this.maxSize) {
+            // Remove least recently used (tail)
+            if (this.tail) {
+                this.cache.delete(this.tail.key);
+                this.removeTail();
+            }
+        }
+    }
+    /**
+     * Clear entire cache
+     */
+    clear() {
+        this.cache.clear();
+        this.head = null;
+        this.tail = null;
+    }
+    /**
+     * Get current cache size
+     */
+    size() {
+        return this.cache.size;
+    }
+    /**
+     * Invalidate cache entry for specific agent config
+     *
+     * @param agentConfig - Agent configuration
+     * @param projectContext - Project context
+     * @returns true if entry was found and removed, false otherwise
+     */
+    invalidate(agentConfig, projectContext) {
+        const key = this.generateCacheKey(agentConfig, projectContext);
+        const node = this.cache.get(key);
+        if (!node) {
+            return false;
+        }
+        this.cache.delete(key);
+        this.removeNode(node);
+        return true;
+    }
+    /**
+     * Generate cache key from agent config and project context
+     *
+     * Uses SHA-256 hash of deterministic JSON serialization.
+     * Hash includes:
+     * - Agent config fields that affect Agent Card (name, version, tools, etc.)
+     * - Project context (projectId, a2aAgentId, baseUrl)
+     *
+     * @param agentConfig - Agent configuration
+     * @param projectContext - Project context
+     * @returns SHA-256 hash as cache key
+     */
+    generateCacheKey(agentConfig, projectContext) {
+        // Extract relevant fields from agent config (exclude timestamps)
+        const relevantConfig = {
+            id: agentConfig.id,
+            name: agentConfig.name,
+            description: agentConfig.description,
+            version: agentConfig.version,
+            allowedTools: agentConfig.allowedTools,
+            source: agentConfig.source,
+        };
+        // Combine with project context
+        const cacheData = {
+            agentConfig: relevantConfig,
+            projectContext: {
+                projectId: projectContext.projectId,
+                a2aAgentId: projectContext.a2aAgentId,
+                baseUrl: projectContext.baseUrl,
+            },
+        };
+        // Generate deterministic hash
+        const json = JSON.stringify(cacheData, Object.keys(cacheData).sort());
+        return crypto_1.default.createHash('sha256').update(json).digest('hex');
+    }
+    /**
+     * Move node to head (most recently used)
+     */
+    moveToHead(node) {
+        this.removeNode(node);
+        this.addToHead(node);
+    }
+    /**
+     * Add node to head
+     */
+    addToHead(node) {
+        node.prev = null;
+        node.next = this.head;
+        if (this.head) {
+            this.head.prev = node;
+        }
+        this.head = node;
+        if (!this.tail) {
+            this.tail = node;
+        }
+    }
+    /**
+     * Remove node from linked list
+     */
+    removeNode(node) {
+        if (node.prev) {
+            node.prev.next = node.next;
+        }
+        else {
+            this.head = node.next;
+        }
+        if (node.next) {
+            node.next.prev = node.prev;
+        }
+        else {
+            this.tail = node.prev;
+        }
+    }
+    /**
+     * Remove tail node (least recently used)
+     */
+    removeTail() {
+        if (!this.tail) {
+            return;
+        }
+        if (this.tail.prev) {
+            this.tail.prev.next = null;
+        }
+        else {
+            this.head = null;
+        }
+        this.tail = this.tail.prev;
+    }
+}
+exports.AgentCardCache = AgentCardCache;
+/**
+ * Global singleton cache instance
+ */
+exports.agentCardCache = new AgentCardCache(100);
+//# sourceMappingURL=agentCardCache.js.map

package/utils/agentCardCache.js.map

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