@futdevpro/ccap 1.1.1

package/server/build/src/_modules/agent/run.data-service.js

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CCAP_Run_DataService = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const nts_dynamo_1 = require("@futdevpro/nts-dynamo");
+const ccap_run_status_type_enum_1 = require("../../_enums/ccap-run-status.type-enum");
+const run_status_transitions_const_1 = require("../../_collections/consts/run-status-transitions.const");
+const ccap_run_data_model_1 = require("../../_models/data-models/ccap-run.data-model");
+/**
+ * Run data-service.
+ * Run CRUD és lifecycle kezelés (create, status update, complete, get).
+ */
+class CCAP_Run_DataService extends nts_dynamo_1.DyNTS_DataService {
+    constructor(set) {
+        super(new ccap_run_data_model_1.CCAP_Run(set?.data), ccap_run_data_model_1.ccapRun_dataParams, set.issuer);
+    }
+    /**
+     * Új run létrehozása (status: initialized).
+     */
+    async createRun(sessionId) {
+        try {
+            this.data = new ccap_run_data_model_1.CCAP_Run({
+                sessionId: sessionId,
+                status: ccap_run_status_type_enum_1.CCAP_RunStatus_Type.initialized,
+                startedAt: new Date(),
+                iterationCount: 0,
+            });
+            await this.saveData();
+            fsm_dynamo_1.DyFM_Log.success(`CCAP_Run | Created: ${this.data._id}`
+                + ` | session: ${sessionId}`);
+            return this.data;
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('createRun', error),
+                errorCode: 'CCAP-RDS-CR0',
+                message: 'Failed to create run',
+            });
+        }
+    }
+    /**
+     * Run státusz frissítése.
+     * REQ-RUN-023: csak engedélyezett átmenetek; illegális → throw.
+     */
+    async updateRunStatus(params) {
+        try {
+            await this.getDataById(params.runId);
+            if (!this.data) {
+                throw new fsm_dynamo_1.DyFM_Error({
+                    ...this.getDefaultErrorSettings('updateRunStatus', new Error('Run not found')),
+                    errorCode: 'CCAP-RDS-URS1',
+                    status: 404,
+                    message: `Run not found: ${params.runId}`,
+                });
+            }
+            const currentStatus = this.data.status ?? ccap_run_status_type_enum_1.CCAP_RunStatus_Type.initialized;
+            const newStatus = params.status;
+            // Bármely állapotból → failed engedélyezett (hiba esetén)
+            if (newStatus === ccap_run_status_type_enum_1.CCAP_RunStatus_Type.failed) {
+                if (run_status_transitions_const_1.CCAP_RUN_STATUS_ANY_TO_FAILED.includes(currentStatus)) {
+                    this.data.status = newStatus;
+                    await this.saveData();
+                    fsm_dynamo_1.DyFM_Log.testInfo(`CCAP_Run | Status: ${params.status}`
+                        + ` | run: ${params.runId}`);
+                    return this.data;
+                }
+            }
+            const allowed = run_status_transitions_const_1.CCAP_RUN_STATUS_ALLOWED_TRANSITIONS.get(currentStatus);
+            if (allowed === undefined
+                || !allowed.includes(newStatus)) {
+                throw new fsm_dynamo_1.DyFM_Error({
+                    ...this.getDefaultErrorSettings('updateRunStatus', new Error('Illegal run status transition')),
+                    errorCode: 'CCAP-RDS-URS2',
+                    message: `Illegal run status transition: ${currentStatus} → ${newStatus}`,
+                });
+            }
+            this.data.status = params.status;
+            await this.saveData();
+            fsm_dynamo_1.DyFM_Log.testInfo(`CCAP_Run | Status: ${params.status}`
+                + ` | run: ${params.runId}`);
+            return this.data;
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('updateRunStatus', error),
+                errorCode: 'CCAP-RDS-URS0',
+                message: 'Failed to update run status',
+            });
+        }
+    }
+    /**
+     * Run lezárása eredménnyel.
+     */
+    async completeRun(params) {
+        try {
+            await this.getDataById(params.runId);
+            if (!this.data) {
+                throw new fsm_dynamo_1.DyFM_Error({
+                    ...this.getDefaultErrorSettings('completeRun', new Error('Run not found')),
+                    errorCode: 'CCAP-RDS-COMR1',
+                    status: 404,
+                    message: `Run not found: ${params.runId}`,
+                });
+            }
+            this.data.status = params.result.success
+                ? ccap_run_status_type_enum_1.CCAP_RunStatus_Type.completed
+                : ccap_run_status_type_enum_1.CCAP_RunStatus_Type.failed;
+            this.data.completedAt = new Date();
+            this.data.result = params.result;
+            await this.saveData();
+            fsm_dynamo_1.DyFM_Log.success(`CCAP_Run | Completed: ${params.runId}`
+                + ` | success: ${params.result.success}`);
+            return this.data;
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('completeRun', error),
+                errorCode: 'CCAP-RDS-COMR0',
+                message: 'Failed to complete run',
+            });
+        }
+    }
+    /**
+     * Run lekérése ID alapján.
+     */
+    async getRun(runId) {
+        try {
+            await this.getDataById(runId);
+            if (!this.data) {
+                throw new fsm_dynamo_1.DyFM_Error({
+                    ...this.getDefaultErrorSettings('getRun', new Error('Run not found')),
+                    errorCode: 'CCAP-RDS-GR1',
+                    status: 404,
+                    message: `Run not found: ${runId}`,
+                });
+            }
+            return this.data;
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('getRun', error),
+                errorCode: 'CCAP-RDS-GR0',
+                message: 'Failed to get run',
+            });
+        }
+    }
+}
+exports.CCAP_Run_DataService = CCAP_Run_DataService;
+//# sourceMappingURL=run.data-service.js.map

package/server/build/src/_modules/agent/run.data-service.js.map

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

package/server/build/src/_modules/agent/session-mutex.control-service.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CCAP_SessionMutex_ControlService = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const nts_dynamo_1 = require("@futdevpro/nts-dynamo");
+const fsm_dynamo_2 = require("@futdevpro/fsm-dynamo");
+/** Lock timeout: 5 perc. */
+const SESSION_LOCK_TIMEOUT_MS = 5 * fsm_dynamo_2.minute;
+/**
+ * Session mutex control-service.
+ * Session-szintű lock mechanizmus: egy session-ben egyszerre
+ * csak egy ANALYZE/RUN futhat. Async/await Promise-based locking.
+ */
+class CCAP_SessionMutex_ControlService extends nts_dynamo_1.DyNTS_SingletonService {
+    static getInstance() {
+        return CCAP_SessionMutex_ControlService.getSingletonInstance();
+    }
+    /** Aktív lock-ok session-önként. */
+    locks = new Map();
+    /** Várakozó queue-k session-önként. */
+    waitQueues = new Map();
+    /**
+     * Session-szintű lock szerzése.
+     * Ha a session már lock-olva van, várakozik amíg felszabadul.
+     */
+    async acquireLock(sessionId) {
+        // Ha már lock-olva van, várakozás
+        if (this.locks.has(sessionId)) {
+            await new Promise((resolve) => {
+                const queue = this.waitQueues.get(sessionId) ?? [];
+                queue.push(resolve);
+                this.waitQueues.set(sessionId, queue);
+            });
+        }
+        // Lock megszerzése
+        const timeoutHandle = setTimeout(() => {
+            fsm_dynamo_1.DyFM_Log.error(`CCAP_SessionMutex | Lock timeout`
+                + ` | session: ${sessionId}`
+                + ` | auto-releasing after ${SESSION_LOCK_TIMEOUT_MS}ms`);
+            this.releaseLock(sessionId);
+        }, SESSION_LOCK_TIMEOUT_MS);
+        const lock = {
+            resolve: () => { },
+            acquiredAt: Date.now(),
+            timeoutHandle: timeoutHandle,
+        };
+        this.locks.set(sessionId, lock);
+        fsm_dynamo_1.DyFM_Log.testInfo(`CCAP_SessionMutex | Lock acquired | session: ${sessionId}`);
+    }
+    /**
+     * Lock feloldása és a következő várakozó értesítése.
+     */
+    releaseLock(sessionId) {
+        const lock = this.locks.get(sessionId);
+        if (lock) {
+            clearTimeout(lock.timeoutHandle);
+            this.locks.delete(sessionId);
+            fsm_dynamo_1.DyFM_Log.testInfo(`CCAP_SessionMutex | Lock released`
+                + ` | session: ${sessionId}`
+                + ` | held for: ${Date.now() - lock.acquiredAt}ms`);
+        }
+        // Következő várakozó ébresztése
+        const queue = this.waitQueues.get(sessionId) ?? [];
+        if (queue.length) {
+            const next = queue.shift();
+            if (!queue.length) {
+                this.waitQueues.delete(sessionId);
+            }
+            if (next) {
+                next();
+            }
+        }
+    }
+    /**
+     * Lock állapot lekérdezése.
+     */
+    isLocked(sessionId) {
+        return this.locks.has(sessionId);
+    }
+    /**
+     * Automatikus lock/unlock wrapper.
+     * A megadott funkciót lock-olt állapotban futtatja.
+     */
+    async withLock(sessionId, fn) {
+        await this.acquireLock(sessionId);
+        try {
+            const result = await fn();
+            return result;
+        }
+        finally {
+            this.releaseLock(sessionId);
+        }
+    }
+}
+exports.CCAP_SessionMutex_ControlService = CCAP_SessionMutex_ControlService;
+//# sourceMappingURL=session-mutex.control-service.js.map

package/server/build/src/_modules/agent/session-mutex.control-service.js.map

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

package/server/build/src/_modules/agent/session-mutex.control-service.spec.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const session_mutex_control_service_1 = require("./session-mutex.control-service");
+describe('CCAP_SessionMutex_ControlService', () => {
+    jasmine.DEFAULT_TIMEOUT_INTERVAL = 5 * fsm_dynamo_1.second;
+    const sessionId = 'test-session-mutex';
+    afterEach(() => {
+        const mutex = session_mutex_control_service_1.CCAP_SessionMutex_ControlService.getInstance();
+        if (mutex.isLocked(sessionId)) {
+            mutex.releaseLock(sessionId);
+        }
+    });
+    it('isLocked returns false when no lock', () => {
+        const mutex = session_mutex_control_service_1.CCAP_SessionMutex_ControlService.getInstance();
+        expect(mutex.isLocked(sessionId)).toBe(false);
+    });
+    it('acquireLock then releaseLock: isLocked true then false', async () => {
+        const mutex = session_mutex_control_service_1.CCAP_SessionMutex_ControlService.getInstance();
+        await mutex.acquireLock(sessionId);
+        expect(mutex.isLocked(sessionId)).toBe(true);
+        mutex.releaseLock(sessionId);
+        expect(mutex.isLocked(sessionId)).toBe(false);
+    });
+    it('withLock runs fn and releases after', async () => {
+        const mutex = session_mutex_control_service_1.CCAP_SessionMutex_ControlService.getInstance();
+        const result = await mutex.withLock(sessionId, async () => {
+            expect(mutex.isLocked(sessionId)).toBe(true);
+            return 42;
+        });
+        expect(result).toBe(42);
+        expect(mutex.isLocked(sessionId)).toBe(false);
+    });
+    it('second caller waits until first releases', async () => {
+        const mutex = session_mutex_control_service_1.CCAP_SessionMutex_ControlService.getInstance();
+        await mutex.acquireLock(sessionId);
+        const order = [];
+        const secondPromise = mutex.acquireLock(sessionId).then(() => {
+            order.push('second');
+            mutex.releaseLock(sessionId);
+        });
+        order.push('first');
+        mutex.releaseLock(sessionId);
+        await secondPromise;
+        expect(order).toEqual(['first', 'second']);
+    });
+});
+//# sourceMappingURL=session-mutex.control-service.spec.js.map

package/server/build/src/_modules/agent/session-mutex.control-service.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-mutex.control-service.spec.js","sourceRoot":"","sources":["../../../../src/_modules/agent/session-mutex.control-service.spec.ts"],"names":[],"mappings":";;AAAA,sDAA+C;AAE/C,mFAAmF;AAEnF,QAAQ,CAAC,kCAAkC,EAAE,GAAG,EAAE;IAChD,OAAO,CAAC,wBAAwB,GAAG,CAAC,GAAG,mBAAM,CAAC;IAE9C,MAAM,SAAS,GAAW,oBAAoB,CAAC;IAE/C,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,KAAK,GACT,gEAAgC,CAAC,WAAW,EAAE,CAAC;QACjD,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,KAAK,GACT,gEAAgC,CAAC,WAAW,EAAE,CAAC;QAEjD,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACtE,MAAM,KAAK,GACT,gEAAgC,CAAC,WAAW,EAAE,CAAC;QAEjD,MAAM,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE7C,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAC7B,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,KAAK,GACT,gEAAgC,CAAC,WAAW,EAAE,CAAC;QAEjD,MAAM,MAAM,GAAW,MAAM,KAAK,CAAC,QAAQ,CAAC,SAAS,EAAE,KAAK,IAAqB,EAAE;YACjF,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7C,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxB,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,KAAK,GACT,gEAAgC,CAAC,WAAW,EAAE,CAAC;QAEjD,MAAM,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAEnC,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,aAAa,GAAkB,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAS,EAAE;YAChF,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACrB,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAE7B,MAAM,aAAa,CAAC;QACpB,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/server/build/src/_modules/agent/tool-calling.control-service.js

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CCAP_ToolCalling_ControlService = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const ccap_llm_call_type_type_enum_1 = require("../../_enums/ccap-llm-call-type.type-enum");
+const context_management_control_service_1 = require("../context/context-management.control-service");
+const llm_control_service_1 = require("../llm/llm.control-service");
+const tool_description_prompt_template_1 = require("../llm/_collections/prompt-templates/tool-description.prompt-template");
+const monitoring_data_service_1 = require("../monitoring/monitoring.data-service");
+const tool_execution_control_service_1 = require("../tools/tool-execution.control-service");
+const tool_registry_control_service_1 = require("../tools/tool-registry.control-service");
+const tool_result_compacting_control_service_1 = require("./compacting/tool-result-compacting.control-service");
+const compacting_const_1 = require("./compacting/_collections/compacting.const");
+/**
+ * Tool calling control-service.
+ * TOOL_SELECT -> TOOL_DESCRIPTION -> TOOL_CALL flow,
+ * TOOL_GROUP_OPEN -> UPDATE_CONTEXT,
+ * CONTEXT_HANDLING -> pin/open/close context keys.
+ */
+class CCAP_ToolCalling_ControlService {
+    monitoringService = monitoring_data_service_1.CCAP_Monitoring_DataService.getInstance();
+    /**
+     * TOOL_SELECT kezelés: TOOL_DESCRIPTION (LLM) -> TOOL_CALL flow.
+     */
+    async handleToolSelect(params) {
+        const startTime = Date.now();
+        // Tool lekérése a registry-ből
+        const registry = tool_registry_control_service_1.CCAP_ToolRegistry_ControlService.getInstance();
+        const tool = registry.getTool(params.toolId);
+        if (!tool) {
+            return {
+                toolId: params.toolId,
+                toolName: params.toolId,
+                arguments: {},
+                result: {
+                    content: `Tool not found: ${params.toolId}`,
+                    success: false,
+                    error: `Tool not found: ${params.toolId}`,
+                },
+                durationMs: Date.now() - startTime,
+            };
+        }
+        // TOOL_DESCRIPTION: LLM hívás a tool argumentumok összeállításához
+        let toolArguments;
+        try {
+            toolArguments = await this.assembleToolArguments({
+                sessionId: params.sessionId,
+                tool: tool,
+                intent: params.intent,
+                conversationMessages: params.conversationMessages,
+            });
+        }
+        catch {
+            return {
+                toolId: params.toolId,
+                toolName: tool.name,
+                arguments: {},
+                result: {
+                    content: 'Tool parameter assembly failed.',
+                    success: false,
+                    error: 'Tool parameter assembly failed.',
+                },
+                durationMs: Date.now() - startTime,
+            };
+        }
+        // TOOL_CALL: tool végrehajtás
+        const toolExecutionService = new tool_execution_control_service_1.CCAP_ToolExecution_ControlService();
+        const result = await toolExecutionService.executeTool({
+            toolId: params.toolId,
+            arguments: toolArguments,
+            sessionId: params.sessionId,
+            runId: params.runId,
+        });
+        // Túl nagy tool result: compacting (REQ-COMP-022..030)
+        const llmService = llm_control_service_1.CCAP_Llm_ControlService.getInstance();
+        const contextWindowSize = llmService.getContextWindowSize(params.sessionId);
+        const thresholdChars = contextWindowSize
+            * compacting_const_1.TOO_LONG_TOOL_RESULT_THRESHOLD_RATIO
+            * compacting_const_1.CHARS_PER_TOKEN_ESTIMATE;
+        let resultContent = result.content;
+        if (result.content.length > thresholdChars) {
+            const compactingService = new tool_result_compacting_control_service_1.CCAP_ToolResultCompacting_ControlService();
+            const compacted = await compactingService.processToolResult({
+                sessionId: params.sessionId,
+                runId: params.runId,
+                toolResultContent: result.content,
+                runIntent: params.runIntent ?? '',
+                runGoal: params.runGoal ?? '',
+                toolIntent: params.intent,
+                contextWindowSize: contextWindowSize,
+            });
+            resultContent = compacted.forConversation;
+        }
+        const durationMs = Date.now() - startTime;
+        fsm_dynamo_1.DyFM_Log.testInfo(`CCAP_ToolCalling | TOOL_CALL completed`
+            + ` | tool: ${params.toolId}`
+            + ` | success: ${result.success}`
+            + ` | ${durationMs}ms`);
+        return {
+            toolId: params.toolId,
+            toolName: tool.name,
+            arguments: toolArguments,
+            result: {
+                content: resultContent,
+                success: result.success,
+                error: result.error,
+            },
+            durationMs: durationMs,
+        };
+    }
+    /**
+     * TOOL_GROUP_OPEN kezelés: group megnyitás -> UPDATE_CONTEXT.
+     */
+    handleToolGroupOpen(params) {
+        const registry = tool_registry_control_service_1.CCAP_ToolRegistry_ControlService.getInstance();
+        registry.openToolGroup({
+            sessionId: params.sessionId,
+            groupId: params.groupId,
+        });
+        fsm_dynamo_1.DyFM_Log.testInfo(`CCAP_ToolCalling | TOOL_GROUP_OPEN: ${params.groupId}`);
+    }
+    /**
+     * CONTEXT_HANDLING kezelés: pin/open/close context keys.
+     */
+    handleContextHandling(params) {
+        const contextMgmt = context_management_control_service_1.CCAP_ContextManagement_ControlService.getInstance();
+        // Pin keys
+        if (params.pinContextKeys?.length) {
+            for (const key of params.pinContextKeys) {
+                contextMgmt.pinContextKey({
+                    sessionId: params.sessionId,
+                    key: key,
+                });
+            }
+        }
+        // Open keys
+        if (params.openContextKeys?.length) {
+            for (const key of params.openContextKeys) {
+                contextMgmt.openContextKey({
+                    sessionId: params.sessionId,
+                    key: key,
+                });
+            }
+        }
+        // Close keys
+        if (params.closeContextKeys?.length) {
+            for (const key of params.closeContextKeys) {
+                contextMgmt.closeContextKey({
+                    sessionId: params.sessionId,
+                    key: key,
+                });
+            }
+        }
+    }
+    /**
+     * TOOL_DESCRIPTION: LLM hívás a tool argumentumok összeállításához.
+     */
+    async assembleToolArguments(params) {
+        try {
+            const userPrompt = tool_description_prompt_template_1.TOOL_DESCRIPTION_USER_PROMPT_TEMPLATE
+                .replace('{SELECTED_TOOL}', params.tool.id)
+                .replace('{INTENT}', params.intent)
+                .replace('{TOOL_SCHEMA}', JSON.stringify(params.tool.schema, null, 2));
+            const llmService = llm_control_service_1.CCAP_Llm_ControlService.getInstance();
+            const response = await llmService.callLlm({
+                sessionId: params.sessionId,
+                callType: ccap_llm_call_type_type_enum_1.CCAP_LlmCallType_Type.toolDescription,
+                systemPrompt: tool_description_prompt_template_1.TOOL_DESCRIPTION_SYSTEM_PROMPT,
+                messages: [
+                    ...params.conversationMessages,
+                    { role: 'user', content: userPrompt },
+                ],
+                options: { responseFormat: 'json' },
+            });
+            const parsed = JSON.parse(response.content);
+            return parsed;
+        }
+        catch (error) {
+            fsm_dynamo_1.DyFM_Log.error(`CCAP_ToolCalling | TOOL_DESCRIPTION failed`
+                + ` | tool: ${params.tool.id}`, error);
+            throw error;
+        }
+    }
+}
+exports.CCAP_ToolCalling_ControlService = CCAP_ToolCalling_ControlService;
+//# sourceMappingURL=tool-calling.control-service.js.map

package/server/build/src/_modules/agent/tool-calling.control-service.js.map

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

package/server/build/src/_modules/context/_collections/context.const.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * Context management konstansok.
+ * Rögzített kulcsnevek és konfigurációs értékek.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_SESSION_CONTEXT_CACHE_SIZE_BYTES = exports.MAX_SESSION_CONTEXT_CACHE_ENTRIES = exports.CONTEXT_KEY_FILEBASE = exports.CONTEXT_KEY_CODEBASE = exports.CONTEXT_KEY_KNOWLEDGE = exports.CONTEXT_KEY_SELF = exports.CONTEXT_KEY_SYSTEM_DATA = exports.CONTEXT_KEY_USER_DATA = exports.CONTEXT_KEY_COMMON_CONTEXT = exports.CONTEXT_KEY_SESSION_INFO = void 0;
+/** Session info context kulcs neve. */
+exports.CONTEXT_KEY_SESSION_INFO = 'sessionInfo';
+/** Common context kulcs neve. */
+exports.CONTEXT_KEY_COMMON_CONTEXT = 'commonContext';
+/** User data kulcs neve (common context alkulcs). */
+exports.CONTEXT_KEY_USER_DATA = 'userData';
+/** System data kulcs neve (common context alkulcs). */
+exports.CONTEXT_KEY_SYSTEM_DATA = 'systemData';
+/** SELF kulcs neve (common context alkulcs). */
+exports.CONTEXT_KEY_SELF = 'self';
+/** Knowledge kulcs neve. */
+exports.CONTEXT_KEY_KNOWLEDGE = 'knowledge';
+/** Codebase kulcs neve (MVP5). */
+exports.CONTEXT_KEY_CODEBASE = 'codebase';
+/** Filebase kulcs neve (MVP5). */
+exports.CONTEXT_KEY_FILEBASE = 'filebase';
+/**
+ * Session context cache maximális elemszáma (REQ-CTX-003).
+ * Túllépéskor a legrégebben hozzáadott kulcsok törlődnek (FIFO).
+ */
+exports.MAX_SESSION_CONTEXT_CACHE_ENTRIES = 100;
+/**
+ * Session context cache maximális méret bájtban (opcionális eviction).
+ * Ha a JSON stringified méret túllépi, eviction indul.
+ */
+exports.MAX_SESSION_CONTEXT_CACHE_SIZE_BYTES = 50_000;
+//# sourceMappingURL=context.const.js.map

package/server/build/src/_modules/context/_collections/context.const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.const.js","sourceRoot":"","sources":["../../../../../src/_modules/context/_collections/context.const.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,uCAAuC;AAC1B,QAAA,wBAAwB,GAAW,aAAa,CAAC;AAE9D,iCAAiC;AACpB,QAAA,0BAA0B,GAAW,eAAe,CAAC;AAElE,qDAAqD;AACxC,QAAA,qBAAqB,GAAW,UAAU,CAAC;AAExD,uDAAuD;AAC1C,QAAA,uBAAuB,GAAW,YAAY,CAAC;AAE5D,gDAAgD;AACnC,QAAA,gBAAgB,GAAW,MAAM,CAAC;AAE/C,4BAA4B;AACf,QAAA,qBAAqB,GAAW,WAAW,CAAC;AAEzD,kCAAkC;AACrB,QAAA,oBAAoB,GAAW,UAAU,CAAC;AAEvD,kCAAkC;AACrB,QAAA,oBAAoB,GAAW,UAAU,CAAC;AAEvD;;;GAGG;AACU,QAAA,iCAAiC,GAAW,GAAG,CAAC;AAE7D;;;GAGG;AACU,QAAA,oCAAoC,GAAW,MAAM,CAAC"}

package/server/build/src/_modules/context/_collections/context.const.spec.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const context_const_1 = require("./context.const");
+describe('context.const', () => {
+    it('exports expected key names', () => {
+        expect(context_const_1.CONTEXT_KEY_SESSION_INFO).toBe('sessionInfo');
+        expect(context_const_1.CONTEXT_KEY_COMMON_CONTEXT).toBe('commonContext');
+        expect(context_const_1.CONTEXT_KEY_USER_DATA).toBe('userData');
+        expect(context_const_1.CONTEXT_KEY_SYSTEM_DATA).toBe('systemData');
+        expect(context_const_1.CONTEXT_KEY_SELF).toBe('self');
+        expect(context_const_1.CONTEXT_KEY_KNOWLEDGE).toBe('knowledge');
+        expect(context_const_1.CONTEXT_KEY_CODEBASE).toBe('codebase');
+        expect(context_const_1.CONTEXT_KEY_FILEBASE).toBe('filebase');
+    });
+    it('exports cache limits', () => {
+        expect(context_const_1.MAX_SESSION_CONTEXT_CACHE_ENTRIES).toBe(100);
+        expect(context_const_1.MAX_SESSION_CONTEXT_CACHE_SIZE_BYTES).toBe(50_000);
+    });
+});
+//# sourceMappingURL=context.const.spec.js.map

package/server/build/src/_modules/context/_collections/context.const.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.const.spec.js","sourceRoot":"","sources":["../../../../../src/_modules/context/_collections/context.const.spec.ts"],"names":[],"mappings":";;AAAA,mDAWyB;AAEzB,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,wCAAwB,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACrD,MAAM,CAAC,0CAA0B,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACzD,MAAM,CAAC,qCAAqB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,CAAC,uCAAuB,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACnD,MAAM,CAAC,gCAAgB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,CAAC,qCAAqB,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAChD,MAAM,CAAC,oCAAoB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC9C,MAAM,CAAC,oCAAoB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,iDAAiC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpD,MAAM,CAAC,oDAAoC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/server/build/src/_modules/context/common-context.data-service.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CCAP_CommonContext_DataService = void 0;
+/**
+ * Common context data-service.
+ * Közös rendszer kontextus építése: user data, system data, SELF információk.
+ * Kulcstárként exponálva az agentnek (REQ-CTX-007).
+ */
+class CCAP_CommonContext_DataService {
+    /**
+     * Common context összeállítása config-ból és rendszeradatokból.
+     */
+    static buildCommonContext(params) {
+        return {
+            userData: CCAP_CommonContext_DataService.buildUserData(params?.userData),
+            systemData: CCAP_CommonContext_DataService.buildSystemData(),
+            selfData: CCAP_CommonContext_DataService.buildSelfData(),
+        };
+    }
+    /**
+     * Az agent számára elérhető kulcsok listája.
+     */
+    static getAvailableKeys() {
+        return [
+            'userData',
+            'userData.nickName',
+            'userData.birthDate',
+            'userData.age',
+            'userData.nationality',
+            'systemData',
+            'systemData.currentDateTime',
+            'systemData.os',
+            'systemData.hardware',
+            'self',
+            'self.ccapDocumentations',
+            'self.ccapConfigCommands',
+            'self.previousSessions',
+            'self.thisSession',
+            'self.reportSelfIssue',
+        ];
+    }
+    /**
+     * User data építése.
+     */
+    static buildUserData(overrides) {
+        return {
+            nickName: overrides?.nickName ?? undefined,
+            birthDate: overrides?.birthDate ?? undefined,
+            age: overrides?.age ?? undefined,
+            nationality: overrides?.nationality ?? undefined,
+        };
+    }
+    /**
+     * System data építése a rendszeradatokból.
+     */
+    static buildSystemData() {
+        return {
+            currentDateTime: new Date().toISOString(),
+            systemData: `Node.js ${process.version}`,
+            os: `${process.platform} ${process.arch}`,
+            hardware: `Memory: ${Math.round(process.memoryUsage().heapTotal / 1024 / 1024)}MB`,
+        };
+    }
+    /**
+     * SELF data építése: a rendszer önmagáról szóló információk.
+     */
+    static buildSelfData() {
+        return {
+            ccapDocumentations: 'Available via context key: self.ccapDocumentations',
+            ccapConfigCommands: 'Available via context key: self.ccapConfigCommands',
+            previousSessions: 'Available via context key: self.previousSessions',
+            thisSession: 'Available via context key: self.thisSession',
+            reportSelfIssue: 'Available via context key: self.reportSelfIssue',
+        };
+    }
+}
+exports.CCAP_CommonContext_DataService = CCAP_CommonContext_DataService;
+//# sourceMappingURL=common-context.data-service.js.map