@futdevpro/ccap 1.1.1

package/server/build/src/_modules/agent/new-user-message-handling.control-service.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CCAP_NewUserMessageHandling_ControlService = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const nts_dynamo_1 = require("@futdevpro/nts-dynamo");
+/**
+ * New user message handling + run queue control-service.
+ * Kezeli az execution/analyze közben érkező új üzeneteket.
+ */
+class CCAP_NewUserMessageHandling_ControlService extends nts_dynamo_1.DyNTS_SingletonService {
+    static getInstance() {
+        return CCAP_NewUserMessageHandling_ControlService.getSingletonInstance();
+    }
+    /** Session -> üzenet queue mapping. */
+    messageQueues = new Map();
+    /** Session -> cancel token mapping (analyze cancel). */
+    analyzeCancelTokens = new Map();
+    /** Session -> aktuális run flow phase (analyze vs execution routing). */
+    sessionPhases = new Map();
+    /**
+     * Aktuális phase beállítása a session-re (run-flow hívja lépések előtt).
+     */
+    setPhase(sessionId, phase) {
+        if (phase === null) {
+            this.sessionPhases.delete(sessionId);
+        }
+        else {
+            this.sessionPhases.set(sessionId, phase);
+        }
+    }
+    /**
+     * Aktuális phase lekérdezése (locked esetén: analyze vs execution routing).
+     */
+    getPhase(sessionId) {
+        return this.sessionPhases.get(sessionId) ?? null;
+    }
+    /**
+     * Execution közben érkezett üzenet kezelése (REQ-RUN-020).
+     * Az üzenet queue-ba kerül; a jelenlegi run befejezése után indul el.
+     */
+    handleMessageDuringExecution(params) {
+        this.queueMessage({
+            sessionId: params.sessionId,
+            message: params.message,
+            channel: params.channel,
+        });
+        fsm_dynamo_1.DyFM_Log.testInfo(`CCAP_NewMsgHandling | Message queued during execution`
+            + ` | session: ${params.sessionId}`
+            + ` | queue size: ${this.getQueueSize(params.sessionId)}`);
+    }
+    /**
+     * Analyze közben érkezett üzenet kezelése (REQ-RUN-021).
+     * Futó analízis cancel jelzése + üzenet queue-ba állítása.
+     */
+    handleMessageDuringAnalyze(params) {
+        // Cancel token beállítása a futó analízishez
+        this.analyzeCancelTokens.set(params.sessionId, true);
+        // Üzenet queue-ba állítása
+        this.queueMessage({
+            sessionId: params.sessionId,
+            message: params.message,
+            channel: params.channel,
+        });
+        fsm_dynamo_1.DyFM_Log.testInfo(`CCAP_NewMsgHandling | Analyze cancel triggered`
+            + ` | session: ${params.sessionId}`);
+    }
+    /**
+     * Üzenet sorba állítása.
+     */
+    queueMessage(params) {
+        const queue = this.messageQueues.get(params.sessionId) ?? [];
+        queue.push({
+            message: params.message,
+            channel: params.channel,
+            queuedAt: new Date(),
+        });
+        this.messageQueues.set(params.sessionId, queue);
+    }
+    /**
+     * Sorban álló üzenetek feldolgozása (drain).
+     * A run befejezése után hívódik; visszaadja és törli a queue-t.
+     */
+    drainQueue(sessionId) {
+        const queue = this.messageQueues.get(sessionId) ?? [];
+        this.messageQueues.delete(sessionId);
+        if (queue.length) {
+            fsm_dynamo_1.DyFM_Log.testInfo(`CCAP_NewMsgHandling | Queue drained`
+                + ` | session: ${sessionId}`
+                + ` | messages: ${queue.length}`);
+        }
+        return queue;
+    }
+    /**
+     * Sorban álló üzenetek lekérdezése (nem törlő).
+     */
+    getQueuedMessages(sessionId) {
+        return this.messageQueues.get(sessionId) ?? [];
+    }
+    /**
+     * Queue méret lekérdezése.
+     */
+    getQueueSize(sessionId) {
+        return this.messageQueues.get(sessionId)?.length ?? 0;
+    }
+    /**
+     * Analyze cancel token ellenőrzése.
+     */
+    isAnalyzeCancelled(sessionId) {
+        return this.analyzeCancelTokens.get(sessionId) ?? false;
+    }
+    /**
+     * Analyze cancel token törlése (új analyze induláskor).
+     */
+    clearAnalyzeCancelToken(sessionId) {
+        this.analyzeCancelTokens.delete(sessionId);
+    }
+    /**
+     * Szükséges-e a session-re érkezett üzenetek miatt újraindítás.
+     */
+    hasQueuedMessages(sessionId) {
+        return this.getQueueSize(sessionId) > 0;
+    }
+}
+exports.CCAP_NewUserMessageHandling_ControlService = CCAP_NewUserMessageHandling_ControlService;
+//# sourceMappingURL=new-user-message-handling.control-service.js.map

package/server/build/src/_modules/agent/new-user-message-handling.control-service.js.map

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

package/server/build/src/_modules/agent/new-user-message-handling.control-service.spec.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const new_user_message_handling_control_service_1 = require("./new-user-message-handling.control-service");
+const ccap_messaging_provider_name_type_enum_1 = require("../../_enums/ccap-messaging-provider-name.type-enum");
+describe('CCAP_NewUserMessageHandling_ControlService', () => {
+    const sessionId = 'test-session-queue';
+    const channel = {
+        providerName: ccap_messaging_provider_name_type_enum_1.CCAP_MessagingProviderName_Type.ccapClient,
+        channelId: 'ch1',
+    };
+    afterEach(() => {
+        const service = new_user_message_handling_control_service_1.CCAP_NewUserMessageHandling_ControlService.getInstance();
+        service.setPhase(sessionId, null);
+        service.drainQueue(sessionId);
+        service.clearAnalyzeCancelToken(sessionId);
+    });
+    it('getPhase returns null when not set', () => {
+        const service = new_user_message_handling_control_service_1.CCAP_NewUserMessageHandling_ControlService.getInstance();
+        expect(service.getPhase(sessionId)).toBeNull();
+    });
+    it('setPhase and getPhase roundtrip', () => {
+        const service = new_user_message_handling_control_service_1.CCAP_NewUserMessageHandling_ControlService.getInstance();
+        service.setPhase(sessionId, 'analyze');
+        expect(service.getPhase(sessionId)).toBe('analyze');
+        service.setPhase(sessionId, null);
+        expect(service.getPhase(sessionId)).toBeNull();
+        service.setPhase(sessionId, 'execution');
+        expect(service.getPhase(sessionId)).toBe('execution');
+    });
+    it('queueMessage and getQueuedMessages return messages', () => {
+        const service = new_user_message_handling_control_service_1.CCAP_NewUserMessageHandling_ControlService.getInstance();
+        service.queueMessage({
+            sessionId: sessionId,
+            message: 'msg1',
+            channel: channel,
+        });
+        service.queueMessage({
+            sessionId: sessionId,
+            message: 'msg2',
+            channel: channel,
+        });
+        const queued = service.getQueuedMessages(sessionId);
+        expect(queued.length).toBe(2);
+        expect(queued[0].message).toBe('msg1');
+        expect(queued[1].message).toBe('msg2');
+        expect(service.getQueueSize(sessionId)).toBe(2);
+    });
+    it('drainQueue returns and clears queue', () => {
+        const service = new_user_message_handling_control_service_1.CCAP_NewUserMessageHandling_ControlService.getInstance();
+        service.queueMessage({
+            sessionId: sessionId,
+            message: 'drain-me',
+            channel: channel,
+        });
+        const drained = service.drainQueue(sessionId);
+        expect(drained.length).toBe(1);
+        expect(drained[0].message).toBe('drain-me');
+        expect(service.getQueuedMessages(sessionId)).toEqual([]);
+        expect(service.getQueueSize(sessionId)).toBe(0);
+    });
+    it('handleMessageDuringExecution queues message', () => {
+        const service = new_user_message_handling_control_service_1.CCAP_NewUserMessageHandling_ControlService.getInstance();
+        service.handleMessageDuringExecution({
+            sessionId: sessionId,
+            message: 'exec-msg',
+            channel: channel,
+        });
+        expect(service.getQueueSize(sessionId)).toBe(1);
+        expect(service.getQueuedMessages(sessionId)[0].message).toBe('exec-msg');
+    });
+    it('handleMessageDuringAnalyze sets cancel token and queues', () => {
+        const service = new_user_message_handling_control_service_1.CCAP_NewUserMessageHandling_ControlService.getInstance();
+        expect(service.isAnalyzeCancelled(sessionId)).toBe(false);
+        service.handleMessageDuringAnalyze({
+            sessionId: sessionId,
+            message: 'analyze-msg',
+            channel: channel,
+        });
+        expect(service.isAnalyzeCancelled(sessionId)).toBe(true);
+        expect(service.getQueueSize(sessionId)).toBe(1);
+        service.clearAnalyzeCancelToken(sessionId);
+        expect(service.isAnalyzeCancelled(sessionId)).toBe(false);
+    });
+    it('message during execution then during analyze: queue order and drain', () => {
+        const service = new_user_message_handling_control_service_1.CCAP_NewUserMessageHandling_ControlService.getInstance();
+        service.handleMessageDuringExecution({
+            sessionId: sessionId,
+            message: 'exec-first',
+            channel: channel,
+        });
+        service.handleMessageDuringAnalyze({
+            sessionId: sessionId,
+            message: 'analyze-second',
+            channel: channel,
+        });
+        expect(service.getQueueSize(sessionId)).toBe(2);
+        expect(service.isAnalyzeCancelled(sessionId)).toBe(true);
+        const drained = service.drainQueue(sessionId);
+        expect(drained.length).toBe(2);
+        expect(drained[0].message).toBe('exec-first');
+        expect(drained[1].message).toBe('analyze-second');
+        expect(service.getQueueSize(sessionId)).toBe(0);
+    });
+});
+//# sourceMappingURL=new-user-message-handling.control-service.spec.js.map

package/server/build/src/_modules/agent/new-user-message-handling.control-service.spec.js.map

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

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

@@ -0,0 +1,210 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CCAP_RunFinalization_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 ccap_message_role_type_enum_1 = require("../../_enums/ccap-message-role.type-enum");
+const ccap_monitoring_event_type_enum_1 = require("../../_enums/ccap-monitoring-event.type-enum");
+const ccap_run_status_type_enum_1 = require("../../_enums/ccap-run-status.type-enum");
+const ccap_context_key_source_type_enum_1 = require("../../_enums/ccap-context-key-source.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 run_finalization_prompt_template_1 = require("../llm/_collections/prompt-templates/run-finalization.prompt-template");
+const messaging_router_control_service_1 = require("../messaging/messaging-router.control-service");
+const monitoring_data_service_1 = require("../monitoring/monitoring.data-service");
+const conversation_data_service_1 = require("../session/conversation.data-service");
+const run_data_service_1 = require("./run.data-service");
+/**
+ * Run finalization control-service.
+ * A run lezárási folyamat: LLM RUN_FINALIZATION hívás,
+ * ANSWER küldés, UPDATE_CONVERSATIONS, UPDATE_CONTEXT, run status frissítés.
+ */
+class CCAP_RunFinalization_ControlService {
+    /** Monitoring service. */
+    monitoringService = monitoring_data_service_1.CCAP_Monitoring_DataService.getInstance();
+    /**
+     * Run lezárás: LLM finalization hívás + post-finalization műveletek.
+     */
+    async finalizeRun(params) {
+        const startTime = Date.now();
+        try {
+            // Run status: finalizing
+            const runDS = new run_data_service_1.CCAP_Run_DataService({ issuer: 'run-finalization' });
+            await runDS.updateRunStatus({
+                runId: params.runId,
+                status: ccap_run_status_type_enum_1.CCAP_RunStatus_Type.finalizing,
+            });
+            // LLM RUN_FINALIZATION hívás
+            const finalizationResult = await this.callFinalizationLlm(params);
+            // Post-finalization műveletek végrehajtása
+            await this.executePostFinalization({
+                sessionId: params.sessionId,
+                runId: params.runId,
+                userMessage: params.userMessage,
+                result: finalizationResult,
+            });
+            // Run status: completed/failed
+            await runDS.completeRun({
+                runId: params.runId,
+                result: {
+                    runSummary: finalizationResult.runSummary,
+                    answerToUser: finalizationResult.answerToUser,
+                    success: finalizationResult.success,
+                },
+            });
+            // Monitoring event
+            this.monitoringService.recordEvent({
+                eventType: ccap_monitoring_event_type_enum_1.CCAP_MonitoringEvent_Type.step,
+                sessionId: params.sessionId,
+                runId: params.runId,
+                data: {
+                    step: 'run-finalization',
+                    success: finalizationResult.success,
+                    contextCacheKeys: finalizationResult.toContextCache
+                        ? Object.keys(finalizationResult.toContextCache).length
+                        : 0,
+                    pinnedKeys: finalizationResult.pinContextKeys?.length ?? 0,
+                },
+                durationMs: Date.now() - startTime,
+                status: finalizationResult.success ? 'completed' : 'failed',
+            });
+            fsm_dynamo_1.DyFM_Log.success(`CCAP_RunFinalization | Completed`
+                + ` | session: ${params.sessionId}`
+                + ` | success: ${finalizationResult.success}`);
+            return finalizationResult;
+        }
+        catch (error) {
+            fsm_dynamo_1.DyFM_Log.error('CCAP_RunFinalization | LLM call failed, using fallback', error);
+            // Fallback finalization
+            const fallback = this.generateFallbackFinalization();
+            // Post-finalization a fallback-kel
+            await this.executePostFinalization({
+                sessionId: params.sessionId,
+                runId: params.runId,
+                userMessage: params.userMessage,
+                result: fallback,
+            });
+            // Run status: failed
+            const runDS = new run_data_service_1.CCAP_Run_DataService({ issuer: 'run-finalization' });
+            await runDS.completeRun({
+                runId: params.runId,
+                result: {
+                    runSummary: fallback.runSummary,
+                    answerToUser: fallback.answerToUser,
+                    success: fallback.success,
+                },
+            });
+            return fallback;
+        }
+    }
+    /**
+     * LLM RUN_FINALIZATION hívás végrehajtása.
+     */
+    async callFinalizationLlm(params) {
+        const llmService = llm_control_service_1.CCAP_Llm_ControlService.getInstance();
+        // Conversation üzenetek + finalization user prompt
+        const messages = [
+            ...params.conversationMessages,
+            { role: 'user', content: run_finalization_prompt_template_1.RUN_FINALIZATION_USER_PROMPT_TEMPLATE },
+        ];
+        const response = await llmService.callLlm({
+            sessionId: params.sessionId,
+            callType: ccap_llm_call_type_type_enum_1.CCAP_LlmCallType_Type.runFinalization,
+            systemPrompt: run_finalization_prompt_template_1.RUN_FINALIZATION_SYSTEM_PROMPT,
+            messages: messages,
+            options: { responseFormat: 'json' },
+        });
+        const parsed = JSON.parse(response.content);
+        return {
+            runSummary: parsed.runSummary ?? '',
+            answerToUser: parsed.answerToUser ?? '',
+            success: parsed.success ?? false,
+            toContextCache: parsed.toContextCache,
+            pinContextKeys: parsed.pinContextKeys,
+        };
+    }
+    /**
+     * Post-finalization műveletek: ANSWER, UPDATE_CONVERSATIONS, UPDATE_CONTEXT.
+     */
+    async executePostFinalization(params) {
+        // ANSWER: végső válasz küldése a user-nek
+        if (params.result.answerToUser) {
+            const router = messaging_router_control_service_1.CCAP_MessagingRouter_ControlService.getInstance();
+            await router.routeOutput({
+                sessionId: params.sessionId,
+                outputType: messaging_router_control_service_1.CCAP_MessagingOutputType.answer,
+                content: params.result.answerToUser,
+                runId: params.runId,
+            });
+        }
+        // UPDATE_CONVERSATIONS: conversation listák frissítése
+        const conversationDS = new conversation_data_service_1.CCAP_Conversation_DataService();
+        const newMessages = [
+            {
+                role: ccap_message_role_type_enum_1.CCAP_MessageRole_Type.user,
+                content: params.userMessage,
+                timestamp: new Date(),
+            },
+            {
+                role: ccap_message_role_type_enum_1.CCAP_MessageRole_Type.assistant,
+                content: params.result.answerToUser,
+                timestamp: new Date(),
+                runId: params.runId,
+            },
+        ];
+        await conversationDS.updateConversations({
+            sessionId: params.sessionId,
+            newMessages: newMessages,
+            issuer: 'run-finalization',
+        });
+        // UPDATE_CONTEXT: toContextCache → session context cache
+        if (params.result.toContextCache) {
+            const contextMgmt = context_management_control_service_1.CCAP_ContextManagement_ControlService.getInstance();
+            for (const [key, value] of Object.entries(params.result.toContextCache)) {
+                contextMgmt.createNewContext({
+                    sessionId: params.sessionId,
+                    key: key,
+                    content: value,
+                    source: ccap_context_key_source_type_enum_1.CCAP_ContextKeySource_Type.llm,
+                });
+            }
+        }
+        // UPDATE_CONTEXT: pinContextKeys → pinned state
+        if (params.result.pinContextKeys?.length) {
+            const contextMgmt = context_management_control_service_1.CCAP_ContextManagement_ControlService.getInstance();
+            for (const key of params.result.pinContextKeys) {
+                contextMgmt.pinContextKey({
+                    sessionId: params.sessionId,
+                    key: key,
+                });
+            }
+        }
+        // Monitoring: context update event
+        this.monitoringService.recordEvent({
+            eventType: ccap_monitoring_event_type_enum_1.CCAP_MonitoringEvent_Type.contextUpdate,
+            sessionId: params.sessionId,
+            runId: params.runId,
+            data: {
+                step: 'post-finalization-context-update',
+                cachedKeys: params.result.toContextCache
+                    ? Object.keys(params.result.toContextCache)
+                    : [],
+                pinnedKeys: params.result.pinContextKeys ?? [],
+            },
+            status: 'success',
+        });
+    }
+    /**
+     * Fallback finalization generálás ha az LLM hívás fail-el.
+     */
+    generateFallbackFinalization() {
+        return {
+            runSummary: 'Run finalization failed; fallback response generated.',
+            answerToUser: 'I completed processing but encountered an error'
+                + ' during finalization. Please review the results.',
+            success: false,
+        };
+    }
+}
+exports.CCAP_RunFinalization_ControlService = CCAP_RunFinalization_ControlService;
+//# sourceMappingURL=run-finalization.control-service.js.map

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

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