@gracker/smartperfetto 1.0.13

package/dist/routes/agentReportRoutes.js

@@ -0,0 +1,100 @@
+"use strict";
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2024-2026 Gracker (Chris)
+// This file is part of SmartPerfetto. See LICENSE for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAgentReportRoutes = registerAgentReportRoutes;
+const sessionPersistenceService_1 = require("../services/sessionPersistenceService");
+const auth_1 = require("../middleware/auth");
+const resourceOwnership_1 = require("../services/resourceOwnership");
+function registerAgentReportRoutes(router, deps) {
+    router.get('/:sessionId/report', (req, res) => {
+        const { sessionId } = req.params;
+        const session = deps.getSession(sessionId);
+        if (!session || !(0, resourceOwnership_1.isOwnedByContext)(session, (0, auth_1.requireRequestContext)(req))) {
+            return (0, resourceOwnership_1.sendResourceNotFound)(res, 'Session not found');
+        }
+        if (session.status !== 'completed') {
+            return res.status(400).json({
+                success: false,
+                error: 'Session is not completed yet',
+                status: session.status,
+            });
+        }
+        const result = deps.recoverResultForSessionIfNeeded(sessionId, session);
+        if (!result) {
+            return res.status(404).json({
+                success: false,
+                error: 'No completed turn result available for this session',
+                hint: `Use /api/agent/v1/${sessionId}/turns to inspect historical turns`,
+            });
+        }
+        const conclusion = deps.normalizeNarrativeForClient(result.conclusion);
+        const findings = Array.isArray(result.findings) ? result.findings : [];
+        const clientFindings = deps.buildClientFindings(findings, session.scenes || []);
+        const resultContract = deps.buildSessionResultContract(session, clientFindings);
+        const hypotheses = Array.isArray(result.hypotheses) ? result.hypotheses : [];
+        const conversationTimeline = Array.isArray(session.conversationSteps)
+            ? session.conversationSteps
+            : [];
+        // Use snapshot as single source of truth for agentv3-specific state.
+        // Falls back to live getters for active sessions where snapshot hasn't been taken yet.
+        const snapshot = sessionPersistenceService_1.SessionPersistenceService.getInstance().loadSessionStateSnapshot(sessionId);
+        const analysisNotes = snapshot?.analysisNotes
+            ?? (typeof session.orchestrator?.getSessionNotes === 'function'
+                ? session.orchestrator.getSessionNotes(sessionId) : []);
+        const analysisPlan = snapshot?.analysisPlan
+            ?? (typeof session.orchestrator?.getSessionPlan === 'function'
+                ? session.orchestrator.getSessionPlan(sessionId) : null);
+        const uncertaintyFlags = snapshot?.uncertaintyFlags
+            ?? (typeof session.orchestrator?.getSessionUncertaintyFlags === 'function'
+                ? session.orchestrator.getSessionUncertaintyFlags(sessionId) : []);
+        const report = {
+            sessionId,
+            traceId: session.traceId,
+            query: session.query,
+            createdAt: session.createdAt,
+            completedAt: Date.now(),
+            summary: {
+                conclusion,
+                confidence: result.confidence,
+                totalDurationMs: result.totalDurationMs,
+                rounds: result.rounds,
+            },
+            findings: findings.map((f) => ({
+                id: f.id,
+                category: f.category,
+                severity: f.severity,
+                title: f.title,
+                description: f.description,
+            })),
+            hypotheses: hypotheses.map((h) => ({
+                id: h.id,
+                description: h.description,
+                status: h.status,
+                confidence: h.confidence,
+            })),
+            conversationTimeline: conversationTimeline.map((step) => ({
+                eventId: step.eventId,
+                ordinal: step.ordinal,
+                phase: step.phase,
+                role: step.role,
+                text: step.text,
+                timestamp: step.timestamp,
+                sourceEventType: step.sourceEventType,
+            })),
+            queryHistory: session.queryHistory || [],
+            conclusionHistory: session.conclusionHistory || [],
+            analysisNotes,
+            analysisPlan,
+            uncertaintyFlags,
+            resultContract,
+            logFile: session.logger.getLogFilePath(),
+        };
+        return res.json({
+            success: true,
+            report,
+        });
+    });
+}
+//# sourceMappingURL=agentReportRoutes.js.map

package/dist/routes/agentReportRoutes.js.map

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

package/dist/routes/agentResumeRoutes.d.ts

@@ -0,0 +1,14 @@
+import express from 'express';
+interface AssistantSessionStore {
+    getSession(sessionId: string): any;
+    setSession(sessionId: string, session: any): void;
+}
+interface AgentResumeRoutesDeps {
+    sessionStore: AssistantSessionStore;
+    buildSessionObservability: (session: any) => unknown;
+    buildRecoveredResultFromContext: (sessionId: string, context: any) => any;
+    buildTurnSummary: (turn: any) => unknown;
+}
+export declare function registerAgentResumeRoutes(router: express.Router, deps: AgentResumeRoutesDeps): void;
+export {};
+//# sourceMappingURL=agentResumeRoutes.d.ts.map

package/dist/routes/agentResumeRoutes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentResumeRoutes.d.ts","sourceRoot":"","sources":["../../src/routes/agentResumeRoutes.ts"],"names":[],"mappings":"AAIA,OAAO,OAAO,MAAM,SAAS,CAAC;AAiB9B,UAAU,qBAAqB;IAC7B,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC;IACnC,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI,CAAC;CACnD;AAED,UAAU,qBAAqB;IAC7B,YAAY,EAAE,qBAAqB,CAAC;IACpC,yBAAyB,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC;IACrD,+BAA+B,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,GAAG,CAAC;IAC1E,gBAAgB,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC;CAC1C;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,OAAO,CAAC,MAAM,EACtB,IAAI,EAAE,qBAAqB,GAC1B,IAAI,CA2QN"}

package/dist/routes/agentResumeRoutes.js

@@ -0,0 +1,263 @@
+"use strict";
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2024-2026 Gracker (Chris)
+// This file is part of SmartPerfetto. See LICENSE for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAgentResumeRoutes = registerAgentResumeRoutes;
+const enhancedSessionContext_1 = require("../agent/context/enhancedSessionContext");
+const traceProcessorService_1 = require("../services/traceProcessorService");
+const agentRuntime_1 = require("../agentRuntime");
+const sessionLogger_1 = require("../services/sessionLogger");
+const sessionPersistenceService_1 = require("../services/sessionPersistenceService");
+const providerManager_1 = require("../services/providerManager");
+const providerSnapshot_1 = require("../services/providerManager/providerSnapshot");
+const auth_1 = require("../middleware/auth");
+const resourceOwnership_1 = require("../services/resourceOwnership");
+const traceMetadataStore_1 = require("../services/traceMetadataStore");
+function registerAgentResumeRoutes(router, deps) {
+    router.post('/resume', async (req, res) => {
+        const requestContext = (0, auth_1.requireRequestContext)(req);
+        const { sessionId, traceId } = req.body || {};
+        if (!sessionId || typeof sessionId !== 'string') {
+            return res.status(400).json({
+                success: false,
+                error: 'sessionId is required',
+            });
+        }
+        const existingSession = deps.sessionStore.getSession(sessionId);
+        if (existingSession) {
+            if (!(0, resourceOwnership_1.isOwnedByContext)(existingSession, requestContext)) {
+                return (0, resourceOwnership_1.sendResourceNotFound)(res, 'Session not found');
+            }
+            return res.json({
+                success: true,
+                sessionId,
+                status: existingSession.status,
+                message: 'Session already active',
+                restored: false,
+                observability: deps.buildSessionObservability(existingSession),
+            });
+        }
+        try {
+            const persistenceService = sessionPersistenceService_1.SessionPersistenceService.getInstance();
+            if (!persistenceService.hasSessionContext(sessionId)) {
+                return res.status(404).json({
+                    success: false,
+                    error: 'Session not found in persistence',
+                    hint: 'Session may have expired or was never persisted',
+                });
+            }
+            const persistedSession = persistenceService.getSession(sessionId);
+            if (!persistedSession) {
+                return res.status(404).json({
+                    success: false,
+                    error: 'Session metadata not found',
+                });
+            }
+            if (!(0, resourceOwnership_1.isOwnedByContext)(persistedSession.metadata, requestContext)) {
+                return (0, resourceOwnership_1.sendResourceNotFound)(res, 'Session not found');
+            }
+            if (traceId && traceId !== persistedSession.traceId) {
+                return res.status(400).json({
+                    success: false,
+                    error: 'traceId mismatch for resume',
+                    hint: `This session was created for traceId=${persistedSession.traceId}. Upload/choose that trace to resume.`,
+                    code: 'TRACE_ID_MISMATCH',
+                });
+            }
+            const effectiveTraceId = persistedSession.traceId;
+            if (!await (0, traceMetadataStore_1.readTraceMetadataForContext)(effectiveTraceId, requestContext)) {
+                return (0, resourceOwnership_1.sendResourceNotFound)(res, 'Trace not found in backend');
+            }
+            const traceProcessorService = (0, traceProcessorService_1.getTraceProcessorService)();
+            const trace = await traceProcessorService.getOrLoadTrace(effectiveTraceId);
+            if (!trace) {
+                return res.status(404).json({
+                    success: false,
+                    error: 'Trace not found in backend',
+                    hint: 'Please upload the trace before resuming the session',
+                    code: 'TRACE_NOT_UPLOADED',
+                });
+            }
+            const restoredContext = persistenceService.loadSessionContext(sessionId);
+            if (!restoredContext) {
+                return res.status(500).json({
+                    success: false,
+                    error: 'Failed to deserialize session context',
+                });
+            }
+            enhancedSessionContext_1.sessionContextManager.set(sessionId, effectiveTraceId, restoredContext);
+            const providerSvc = (0, providerManager_1.getProviderService)();
+            const providerScope = {
+                tenantId: requestContext.tenantId,
+                workspaceId: requestContext.workspaceId,
+                userId: requestContext.userId,
+            };
+            const snapshot = persistenceService.loadSessionStateSnapshot(sessionId);
+            const snapshotProviderId = snapshot?.agentRuntimeProviderId;
+            const restoredProviderId = snapshot
+                ? snapshotProviderId ?? null
+                : providerSvc.getRawEffectiveProvider(providerScope)?.id ?? null;
+            if (typeof snapshotProviderId === 'string' && !providerSvc.getRawProvider(snapshotProviderId, providerScope)) {
+                return res.status(404).json({
+                    success: false,
+                    error: `Provider not found: ${snapshotProviderId}`,
+                    code: 'PROVIDER_NOT_FOUND',
+                    hint: 'This persisted session was created with a Provider Manager profile that no longer exists. Recreate the provider or start a new chat.',
+                });
+            }
+            const restoredProviderSnapshotHash = (0, providerSnapshot_1.resolveProviderRuntimeSnapshot)(providerSvc, restoredProviderId, restoredProviderId ? undefined : snapshot?.agentRuntimeKind, providerScope).snapshotHash;
+            const providerSnapshotChanged = Boolean(snapshot?.agentRuntimeProviderSnapshotHash &&
+                snapshot.agentRuntimeProviderSnapshotHash !== restoredProviderSnapshotHash);
+            const orchestrator = (0, agentRuntime_1.createAgentOrchestrator)({
+                traceProcessorService: (0, traceProcessorService_1.getTraceProcessorService)(),
+                providerId: restoredProviderId,
+                runtimeOverride: restoredProviderId ? undefined : snapshot?.agentRuntimeKind,
+                providerScope,
+            });
+            const focusSnapshot = persistenceService.loadFocusStore(sessionId);
+            if (focusSnapshot && typeof orchestrator.getFocusStore === 'function') {
+                orchestrator.getFocusStore().loadSnapshot(focusSnapshot);
+                orchestrator.getFocusStore().syncWithEntityStore(restoredContext.getEntityStore());
+            }
+            const traceAgentStateSnapshot = persistenceService.loadTraceAgentState(sessionId);
+            if (traceAgentStateSnapshot) {
+                restoredContext.setTraceAgentState(traceAgentStateSnapshot);
+            }
+            const logger = (0, sessionLogger_1.createSessionLogger)(sessionId);
+            logger.setMetadata({
+                traceId: effectiveTraceId,
+                query: persistedSession.question,
+                architecture: 'agent-driven',
+                resumed: true,
+            });
+            logger.info('AgentRoutes', 'Session restored from persistence', {
+                entityStoreStats: restoredContext.getEntityStore().getStats(),
+                turnCount: restoredContext.getAllTurns().length,
+            });
+            if (providerSnapshotChanged) {
+                logger.warn('AgentRoutes', 'Provider snapshot changed; SDK session state will not be restored', {
+                    providerId: restoredProviderId,
+                    previousProviderSnapshotHash: snapshot?.agentRuntimeProviderSnapshotHash,
+                    nextProviderSnapshotHash: restoredProviderSnapshotHash,
+                });
+            }
+            const restoredTurns = restoredContext.getAllTurns();
+            const latestTurn = restoredTurns.length > 0 ? restoredTurns[restoredTurns.length - 1] : null;
+            const recoveredResult = deps.buildRecoveredResultFromContext(sessionId, restoredContext);
+            const restoredRunSequence = Math.max(0, restoredTurns.length);
+            const restoredRun = restoredRunSequence > 0
+                ? {
+                    runId: `run-${sessionId}-${restoredRunSequence}-recovered`,
+                    requestId: `recovered-${sessionId}-${restoredRunSequence}`,
+                    sequence: restoredRunSequence,
+                    query: latestTurn?.query || persistedSession.question,
+                    startedAt: latestTurn?.timestamp || persistedSession.createdAt,
+                    completedAt: persistedSession.updatedAt,
+                    status: 'completed',
+                }
+                : undefined;
+            const owner = (0, resourceOwnership_1.normalizeResourceOwner)(persistedSession.metadata);
+            // Unified snapshot restoration — all fields populated from single source
+            // Restore ClaudeRuntime Maps (notes, plans, hypotheses, flags, artifacts, architecture, sdkSessionId)
+            if (snapshot && !providerSnapshotChanged && typeof orchestrator.restoreFromSnapshot === 'function') {
+                orchestrator.restoreFromSnapshot(sessionId, effectiveTraceId, snapshot);
+                logger.info('AgentRoutes', 'ClaudeRuntime Maps restored from snapshot', {
+                    notes: snapshot.analysisNotes.length,
+                    hasPlan: !!snapshot.analysisPlan,
+                    hypotheses: snapshot.claudeHypotheses?.length || 0,
+                    flags: snapshot.uncertaintyFlags.length,
+                    artifacts: snapshot.artifacts?.length || 0,
+                });
+            }
+            else if (typeof orchestrator.restoreArchitectureCache === 'function' && persistedSession.metadata?.architectureSnapshot) {
+                // Compatibility path for older persisted sessions that predate unified snapshots.
+                orchestrator.restoreArchitectureCache(effectiveTraceId, persistedSession.metadata.architectureSnapshot);
+            }
+            deps.sessionStore.setSession(sessionId, {
+                orchestrator,
+                sessionId,
+                sseClients: [],
+                result: recoveredResult || undefined,
+                status: 'completed',
+                traceId: effectiveTraceId,
+                tenantId: owner.tenantId,
+                workspaceId: owner.workspaceId,
+                userId: owner.userId,
+                providerId: restoredProviderId,
+                providerSnapshotHash: restoredProviderSnapshotHash,
+                providerSnapshotChanged: providerSnapshotChanged || undefined,
+                providerSnapshotChangeReason: providerSnapshotChanged
+                    ? 'provider_snapshot_hash_mismatch'
+                    : undefined,
+                query: latestTurn?.query || persistedSession.question,
+                createdAt: persistedSession.createdAt,
+                lastActivityAt: Date.now(),
+                logger,
+                // All fields now restored from snapshot (previously agentDialogue/agentResponses were hardcoded to [])
+                hypotheses: snapshot?.hypotheses || [],
+                agentDialogue: snapshot?.agentDialogue || [],
+                dataEnvelopes: snapshot?.dataEnvelopes || [],
+                agentResponses: snapshot?.agentResponses || [],
+                conversationOrdinal: snapshot?.conversationOrdinal || 0,
+                conversationSteps: snapshot?.conversationSteps || [],
+                queryHistory: snapshot?.queryHistory || [],
+                conclusionHistory: snapshot?.conclusionHistory || [],
+                runSequence: snapshot?.runSequence || restoredRunSequence,
+                activeRun: restoredRun,
+                lastRun: restoredRun,
+                sseEventSeq: 0,
+                sseEventBuffer: [],
+            });
+            return res.json({
+                success: true,
+                sessionId,
+                traceId: effectiveTraceId,
+                status: 'completed',
+                message: providerSnapshotChanged
+                    ? 'Session restored from persistence with a fresh SDK runtime because provider configuration changed'
+                    : 'Session restored from persistence',
+                restored: true,
+                providerSnapshotChanged: providerSnapshotChanged || undefined,
+                observability: restoredRun
+                    ? {
+                        runId: restoredRun.runId,
+                        requestId: restoredRun.requestId,
+                        runSequence: restoredRun.sequence,
+                        status: restoredRun.status,
+                    }
+                    : undefined,
+                historyEndpoints: {
+                    turns: `/api/agent/v1/${sessionId}/turns`,
+                    latestTurn: `/api/agent/v1/${sessionId}/turns/latest`,
+                },
+                restoredStats: {
+                    turnCount: restoredTurns.length,
+                    latestTurn: latestTurn ? deps.buildTurnSummary(latestTurn) : null,
+                    entityStore: restoredContext.getEntityStore().getStats(),
+                    focusStore: focusSnapshot ? orchestrator.getFocusStore().getStats() : null,
+                    traceAgentState: traceAgentStateSnapshot
+                        ? {
+                            version: traceAgentStateSnapshot.version,
+                            updatedAt: traceAgentStateSnapshot.updatedAt,
+                            turns: Array.isArray(traceAgentStateSnapshot.turnLog)
+                                ? traceAgentStateSnapshot.turnLog.length
+                                : 0,
+                            goal: traceAgentStateSnapshot.goal?.normalizedGoal ||
+                                traceAgentStateSnapshot.goal?.userGoal ||
+                                '',
+                        }
+                        : null,
+                },
+            });
+        }
+        catch (error) {
+            console.error('[AgentRoutes] Session restore failed:', error);
+            return res.status(500).json({
+                success: false,
+                error: error.message || 'Failed to restore session',
+            });
+        }
+    });
+}
+//# sourceMappingURL=agentResumeRoutes.js.map

package/dist/routes/agentResumeRoutes.js.map

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

package/dist/routes/agentRoutes.d.ts

@@ -0,0 +1,3 @@
+declare const router: import("express-serve-static-core").Router;
+export default router;
+//# sourceMappingURL=agentRoutes.d.ts.map

package/dist/routes/agentRoutes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentRoutes.d.ts","sourceRoot":"","sources":["../../src/routes/agentRoutes.ts"],"names":[],"mappings":"AA4IA,QAAA,MAAM,MAAM,4CAAmB,CAAC;AAk1JhC,eAAe,MAAM,CAAC"}