@gracker/smartperfetto 1.0.13

package/dist/agentv3/types.d.ts

@@ -0,0 +1,443 @@
+import type { ArchitectureInfo } from '../agent/detectors/types';
+import type { Finding } from '../agent/types';
+import type { DetectedFocusApp } from './focusAppDetector';
+import type { SceneType } from './sceneClassifier';
+import type { OutputLanguage } from './outputLanguage';
+/** Query complexity level — determines which analysis pipeline to use. */
+export type QueryComplexity = 'quick' | 'full';
+/** Input signals for the complexity classifier. */
+export interface ComplexityClassifierInput {
+    query: string;
+    /** Scene type already classified by keyword matcher */
+    sceneType: SceneType;
+    /** Whether user selected a time range or slice in Perfetto UI */
+    hasSelectionContext: boolean;
+    /** Structured Perfetto UI selection, when present. Used to keep scoped slice/range lookups lightweight. */
+    selectionContext?: SelectionContext;
+    /** Whether a reference trace is loaded for comparison */
+    hasReferenceTrace: boolean;
+    /** Whether prior turns have produced findings (drill-down context) */
+    hasExistingFindings: boolean;
+    /** Whether the session already has a full analysis in a prior turn */
+    hasPriorFullAnalysis: boolean;
+}
+export interface SqlSchemaEntry {
+    id: string;
+    name: string;
+    category: string;
+    type: 'function' | 'view' | 'table' | 'table_function' | 'macro' | string;
+    description: string;
+    /** Perfetto stdlib module that defines this symbol, when known. */
+    module?: string;
+    /** INCLUDE statement required to load the defining module. */
+    include?: string;
+    /** Direct module includes declared by the defining stdlib module. */
+    moduleIncludes?: string[];
+    /** Transitive module includes resolved from stdlib docs / pfsql lineage. */
+    transitiveIncludes?: string[];
+    /** Tags emitted by upstream stdlib_docs.json. */
+    tags?: string[];
+    /** Source SQL file path relative to the repo root, when known. */
+    sourcePath?: string;
+    /** Column definitions for tables/views (when available in the schema index) */
+    columns?: Array<{
+        name: string;
+        type?: string;
+        description?: string;
+    }>;
+    /** Parameter definitions for functions (when available in the schema index) */
+    params?: Array<{
+        name: string;
+        type?: string;
+        description?: string;
+    }>;
+    returnType?: string;
+}
+export interface SqlSchemaIndex {
+    version: string;
+    generatedAt: string;
+    templates: SqlSchemaEntry[];
+}
+/** Context assembled before calling Claude, injected into the system prompt. */
+export interface ClaudeAnalysisContext {
+    query: string;
+    architecture?: ArchitectureInfo;
+    packageName?: string;
+    focusApps?: DetectedFocusApp[];
+    /** Detection method used for focus apps — affects display labels */
+    focusMethod?: 'battery_stats' | 'oom_adj' | 'frame_timeline' | 'none';
+    previousFindings?: Finding[];
+    conversationSummary?: string;
+    /** Perfetto SQL knowledge context matched to the user query (from ExtendedSqlKnowledgeBase) */
+    knowledgeBaseContext?: string;
+    /** Compact entity context from previous turns for drill-down / clarify resolution */
+    entityContext?: string;
+    /** Classified scene type for progressive prompt disclosure */
+    sceneType?: SceneType;
+    /** Structured analysis notes persisted by Claude via write_analysis_note tool */
+    analysisNotes?: AnalysisNote[];
+    /** Names of available sub-agents (when sub-agent mode is enabled) */
+    availableAgents?: string[];
+    /** Past SQL error-fix pairs for in-context learning */
+    sqlErrorFixPairs?: Array<{
+        errorSql: string;
+        errorMessage: string;
+        fixedSql: string;
+    }>;
+    /** Cross-session analysis pattern context (P2-2: Long-term memory) */
+    patternContext?: string;
+    /** Cross-session negative pattern context (P1: 负面记忆) */
+    negativePatternContext?: string;
+    /** Previous turn's analysis plan for multi-turn context (P1-G12) */
+    previousPlan?: AnalysisPlanV3;
+    /** Recent plan history (max 3) for deeper cross-turn context (P1-B1) */
+    planHistory?: AnalysisPlanV3[];
+    /** User's Perfetto UI selection context — scopes analysis to a time range or single slice */
+    selectionContext?: SelectionContext;
+    /** Comparison mode — when present, a reference trace is available for dual-trace analysis */
+    comparison?: ComparisonContext;
+    /** Trace data completeness diagnosis — injected at session init, informs data gap guidance */
+    traceCompleteness?: TraceCompleteness;
+    /** Detected trace OS — determines knowledge injection and SQL dialect */
+    traceOs?: 'android' | 'harmonyos' | 'unknown';
+    /** Detected trace format */
+    traceFormat?: 'perfetto_protobuf' | 'systrace_text' | 'atrace_text' | 'unknown';
+    /** User-facing output language for answers, reports, and insight text. */
+    outputLanguage?: OutputLanguage;
+}
+/** Discriminator for which trace data belongs to in comparison mode. */
+export type TraceSource = 'current' | 'reference';
+/** Context for dual-trace comparison mode. Orthogonal to scene type. */
+export interface ComparisonContext {
+    referenceTraceId: string;
+    referencePackageName?: string;
+    referenceFocusApps?: DetectedFocusApp[];
+    referenceArchitecture?: ArchitectureInfo;
+    /** Intersection of stdlib capabilities available on both trace processors */
+    commonCapabilities: string[];
+    /** Capabilities available on only one side — informs Claude about analysis limitations */
+    capabilityDiff?: {
+        currentOnly: string[];
+        referenceOnly: string[];
+    };
+    /** Alignment anchor for cross-trace time normalization */
+    compareAnchor?: CompareAnchor;
+}
+/** How to align time ranges between two traces for meaningful comparison. */
+export interface CompareAnchor {
+    /** Alignment strategy: by analysis phase, by user interaction window, or by relative time */
+    type: 'phase' | 'interaction_window' | 'relative_time';
+    currentRange?: {
+        startNs: number;
+        endNs: number;
+    };
+    referenceRange?: {
+        startNs: number;
+        endNs: number;
+    };
+}
+/** Status of a single analysis capability's data availability. */
+export type CapabilityStatus = 'available' | 'missing_config_suspected' | 'not_applicable' | 'insufficient_or_scene_absent';
+/** A single capability probe result. */
+export interface CapabilityProbeResult {
+    id: string;
+    displayName: string;
+    status: CapabilityStatus;
+    /** Primary table probed */
+    primaryTable: string;
+    /** Approximate row count (only when status is 'available' or 'insufficient_or_scene_absent') */
+    rowEstimate?: number;
+    /** Human-readable reason when not available */
+    reason?: string;
+}
+/** Complete trace data availability diagnosis. */
+export interface TraceCompleteness {
+    /** Capabilities with data ready for analysis */
+    available: CapabilityProbeResult[];
+    /** Capabilities missing due to suspected config issues — actionable */
+    missingConfig: CapabilityProbeResult[];
+    /** Capabilities not applicable to this trace's architecture/version */
+    notApplicable: CapabilityProbeResult[];
+    /** Capabilities with sparse data — ambiguous cause */
+    insufficient: CapabilityProbeResult[];
+    /** Timestamp of diagnosis */
+    diagnosedAt: number;
+}
+/** Area selection — user pressed M key to mark a time range. */
+export interface AreaSelectionContext {
+    kind: 'area';
+    startNs: number;
+    endNs: number;
+    durationNs?: number;
+    tracks?: SelectionTrackInfo[];
+    trackCount?: number;
+}
+/** Single slice selection — user clicked a slice in the timeline. */
+export interface TrackEventSelectionContext {
+    kind: 'track_event';
+    trackUri?: string;
+    eventId: number;
+    ts: number;
+    dur?: number;
+    name?: string;
+    threadName?: string;
+    processName?: string;
+    depth?: number;
+    childCount?: number;
+}
+/** Discriminated union: either an area or a single-slice selection from Perfetto UI. */
+export type SelectionContext = AreaSelectionContext | TrackEventSelectionContext;
+/** Human-readable metadata for a track in an area selection. */
+export interface SelectionTrackInfo {
+    uri: string;
+    threadName?: string;
+    processName?: string;
+    tid?: number;
+    pid?: number;
+    cpu?: number;
+    kind?: string;
+}
+/** A structured note written by Claude during analysis for cross-turn persistence. */
+export interface AnalysisNote {
+    section: 'hypothesis' | 'finding' | 'observation' | 'next_step';
+    content: string;
+    priority: 'high' | 'medium' | 'low';
+    timestamp: number;
+    /** In comparison mode, which trace this note pertains to (provenance tracking) */
+    sourceTrace?: TraceSource;
+}
+/**
+ * A more precise alternative to a bare tool-name match. When present on a
+ * phase, the plan adherence matcher requires both the tool short-name AND
+ * (when set) the matching `skillId`, so two `invoke_skill` calls targeting
+ * different skills are no longer interchangeable.
+ */
+export interface ExpectedCall {
+    /** Short tool name without the MCP prefix (e.g. `invoke_skill`, `execute_sql`). */
+    tool: string;
+    /** For `invoke_skill`, the required skillId. Other tools should leave this unset. */
+    skillId?: string;
+}
+/** A phase in Claude's analysis plan, submitted via submit_plan tool. */
+export interface PlanPhase {
+    id: string;
+    name: string;
+    goal: string;
+    /** Expected tool names this phase will use (for adherence tracking) */
+    expectedTools: string[];
+    /**
+     * Optional structured matchers — preferred over `expectedTools` when set.
+     * Lets a phase require a specific skillId for `invoke_skill` rather than
+     * accepting any invocation. Phase 0.6 of the v2.1 refactor introduces
+     * this; existing strategies continue to use `expectedTools` until they
+     * opt in.
+     */
+    expectedCalls?: ExpectedCall[];
+    status: 'pending' | 'in_progress' | 'completed' | 'skipped';
+    completedAt?: number;
+    /** Reasoning summary provided when completing/skipping this phase (P2-1) */
+    summary?: string;
+}
+/**
+ * Agent-declared waiver for a scene-template mandatory aspect. The agent
+ * uses this to opt out of an aspect (e.g. "trace lacks input timeline so
+ * input event detection is impossible") with an explicit justification.
+ * The hard-gate accepts the plan only when `reason` is substantial.
+ */
+export interface PlanAspectWaiver {
+    aspectId: string;
+    reason: string;
+}
+/** Structured analysis plan submitted by Claude before starting analysis. */
+export interface AnalysisPlanV3 {
+    phases: PlanPhase[];
+    successCriteria: string;
+    submittedAt: number;
+    /** Tool calls matched to phases during execution */
+    toolCallLog: ToolCallRecord[];
+    /** History of plan revisions (P1-3: Dynamic replan) */
+    revisionHistory?: PlanRevision[];
+    /** Agent-declared waivers for mandatory plan-template aspects. */
+    waivers?: PlanAspectWaiver[];
+    /**
+     * Mandatory aspects the agent failed to cover *and* did not waive after
+     * the hard-gate gave up enforcing (max attempts reached). Surfaced by
+     * `verifyPlanAdherence` as an error so the final verifier still flags
+     * the gap rather than letting it disappear silently.
+     */
+    unresolvedAspects?: string[];
+}
+/** Record of a plan revision for audit trail. */
+export interface PlanRevision {
+    /** Timestamp of the revision */
+    revisedAt: number;
+    /** Why the plan was revised */
+    reason: string;
+    /** Snapshot of phases before revision */
+    previousPhases: PlanPhase[];
+}
+/**
+ * Predicate testing whether a logged tool call satisfies a phase's
+ * expectations. `expectedCalls` (when set) trumps `expectedTools`; otherwise
+ * the legacy "any call with the right tool name" semantics apply. Tool
+ * names are normalised by stripping the MCP prefix on both sides.
+ */
+export declare function phaseMatchesCall(phase: PlanPhase, record: ToolCallRecord): boolean;
+/** Flatten a phase's expectations to plain tool names for log/UI rendering. */
+export declare function expectedToolNames(phase: PlanPhase): string[];
+/** Record of a tool call for plan adherence tracking. */
+export interface ToolCallRecord {
+    toolName: string;
+    timestamp: number;
+    /** Phase ID this tool call was matched to (if any) */
+    matchedPhaseId?: string;
+    /**
+     * One-line, human-readable digest of the tool's input. Used by plan
+     * adherence checks to confirm the *right* call was made, not just any call
+     * with the right tool name (e.g. distinguishing different `invoke_skill`
+     * targets).
+     */
+    inputSummary?: string;
+    /** For `invoke_skill`: the skillId argument, lifted out for direct matching. */
+    skillId?: string;
+    /** sha256(input) prefix — stable identifier across runs for the same call. */
+    paramsHash?: string;
+}
+/**
+ * Lifecycle state of a pattern. Controls injection weight and whether the
+ * pattern participates in supersede actions. Older entries that pre-date the
+ * state machine implicitly behave as `confirmed` for backward compatibility.
+ */
+export type PatternStatus = 'provisional' | 'confirmed' | 'rejected' | 'disputed' | 'disputed_late';
+/**
+ * Provenance fields linking an entry to the run that produced it.
+ * Per-turn primary key allows future feedback to map back to the right entry
+ * without ambiguity when a session has multiple turns.
+ */
+export interface PatternProvenance {
+    analysisRunId?: string;
+    sessionId?: string;
+    turnIndex?: number;
+    /** Enterprise scope for learned memory isolation. */
+    sourceTenantId?: string;
+    sourceWorkspaceId?: string;
+    sourceRunId?: string;
+    /** sha256 of trace file content (NOT the upload UUID — see scene/traceHash.ts). */
+    traceContentHash?: string;
+}
+/** A persistent analysis pattern learned from previous sessions. */
+export interface AnalysisPatternEntry {
+    id: string;
+    /** Trace feature fingerprint for similarity matching */
+    traceFeatures: string[];
+    /** Scene type of the analysis */
+    sceneType: string;
+    /** Key insights discovered */
+    keyInsights: string[];
+    /** Architecture type */
+    architectureType?: string;
+    /** Confidence of the original analysis */
+    confidence: number;
+    /** Timestamp of creation */
+    createdAt: number;
+    /** Number of times this pattern was matched */
+    matchCount: number;
+    /**
+     * Stable failure-mode hash. Populated by the migration for historical
+     * entries and by L1 pattern saving for new ones. Optional so older entries
+     * on disk parse cleanly; injection logic treats absence as "unknown" and
+     * skips cross-artifact deduplication.
+     */
+    failureModeHash?: string;
+    /** Lifecycle state. Defaults to 'confirmed' when absent (legacy entries). */
+    status?: PatternStatus;
+    /** First feedback timestamp — used to choose the `disputed` vs `disputed_late` window. */
+    firstFeedbackAt?: number;
+    /** Most recent feedback timestamp. */
+    lastFeedbackAt?: number;
+    /** Provenance fields tying this entry to the originating run. */
+    provenance?: PatternProvenance;
+    /**
+     * Bucket key for quota-fair eviction. Format depends on bucket type:
+     * positive = `${sceneType}::${archType}::${domainHash}`,
+     * negative = `${sceneType}::${archType}::${failureModeHash}`.
+     */
+    bucketKey?: string;
+}
+/** A negative pattern — records what strategies/approaches FAILED for similar traces. */
+export interface NegativePatternEntry {
+    id: string;
+    /** Trace feature fingerprint for similarity matching */
+    traceFeatures: string[];
+    /** Scene type of the analysis */
+    sceneType: string;
+    /** What failed: specific strategy, tool, SQL pattern */
+    failedApproaches: FailedApproach[];
+    /** Architecture type */
+    architectureType?: string;
+    /** Timestamp of creation */
+    createdAt: number;
+    /** Number of times this negative pattern was matched */
+    matchCount: number;
+    /** Stable failure-mode hash. See AnalysisPatternEntry.failureModeHash. */
+    failureModeHash?: string;
+    /** Lifecycle state. Defaults to 'confirmed' when absent (legacy entries). */
+    status?: PatternStatus;
+    firstFeedbackAt?: number;
+    lastFeedbackAt?: number;
+    /** Provenance fields tying this entry to the originating run. */
+    provenance?: PatternProvenance;
+    /** Bucket key for quota-fair eviction (negative form: scene::arch::failureModeHash). */
+    bucketKey?: string;
+}
+/** A specific approach that failed during analysis. */
+export interface FailedApproach {
+    /** Category: 'tool_failure' | 'strategy_failure' | 'verification_failure' | 'sql_error' */
+    type: 'tool_failure' | 'strategy_failure' | 'verification_failure' | 'sql_error';
+    /** What was attempted (tool name, SQL pattern, strategy description) */
+    approach: string;
+    /** Why it failed */
+    reason: string;
+    /** What worked instead (if known) */
+    workaround?: string;
+    /** Stable failure-mode hash for this specific approach (optional, see PR4). */
+    failureModeHash?: string;
+}
+/** Status of a hypothesis in the hypothesis-verify cycle. */
+export type HypothesisStatus = 'formed' | 'confirmed' | 'rejected';
+/** A structured hypothesis formed during analysis that must be resolved before concluding. */
+export interface Hypothesis {
+    id: string;
+    /** The hypothesis statement (e.g., "RenderThread blocked by Binder causing jank") */
+    statement: string;
+    status: HypothesisStatus;
+    /** What observation or data prompted this hypothesis */
+    basis?: string;
+    /** Evidence for confirmation/rejection */
+    evidence?: string;
+    formedAt: number;
+    resolvedAt?: number;
+}
+/** An uncertainty flag raised by Claude during analysis when making assumptions. */
+export interface UncertaintyFlag {
+    /** What aspect Claude is uncertain about */
+    topic: string;
+    /** What assumption Claude is making to proceed */
+    assumption: string;
+    /** What question Claude would ask the user if it could */
+    question: string;
+    timestamp: number;
+}
+/** Result of conclusion verification (heuristic + optional LLM). */
+export interface VerificationResult {
+    passed: boolean;
+    heuristicIssues: VerificationIssue[];
+    llmIssues?: VerificationIssue[];
+    durationMs: number;
+}
+export interface VerificationIssue {
+    type: 'missing_evidence' | 'too_many_criticals' | 'known_misdiagnosis' | 'severity_mismatch' | 'missing_check' | 'plan_deviation' | 'missing_reasoning' | 'unresolved_hypothesis' | 'truncation';
+    severity: 'warning' | 'error';
+    message: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/agentv3/types.d.ts.map

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

package/dist/agentv3/types.js

@@ -0,0 +1,37 @@
+"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.phaseMatchesCall = phaseMatchesCall;
+exports.expectedToolNames = expectedToolNames;
+/**
+ * Predicate testing whether a logged tool call satisfies a phase's
+ * expectations. `expectedCalls` (when set) trumps `expectedTools`; otherwise
+ * the legacy "any call with the right tool name" semantics apply. Tool
+ * names are normalised by stripping the MCP prefix on both sides.
+ */
+function phaseMatchesCall(phase, record) {
+    const MCP_PREFIX = 'mcp__smartperfetto__';
+    const shortTool = record.toolName.startsWith(MCP_PREFIX)
+        ? record.toolName.slice(MCP_PREFIX.length)
+        : record.toolName;
+    if (phase.expectedCalls && phase.expectedCalls.length > 0) {
+        return phase.expectedCalls.some(call => {
+            if (call.tool !== shortTool)
+                return false;
+            if (call.skillId && call.skillId !== record.skillId)
+                return false;
+            return true;
+        });
+    }
+    return phase.expectedTools.includes(shortTool);
+}
+/** Flatten a phase's expectations to plain tool names for log/UI rendering. */
+function expectedToolNames(phase) {
+    if (phase.expectedCalls && phase.expectedCalls.length > 0) {
+        return phase.expectedCalls.map(c => c.skillId ? `${c.tool}(${c.skillId})` : c.tool);
+    }
+    return phase.expectedTools;
+}
+//# sourceMappingURL=types.js.map

package/dist/agentv3/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agentv3/types.ts"],"names":[],"mappings":";AAAA,6CAA6C;AAC7C,0CAA0C;AAC1C,+DAA+D;;AA0T/D,4CAaC;AAGD,8CAKC;AA3BD;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,KAAgB,EAAE,MAAsB;IACvE,MAAM,UAAU,GAAG,sBAAsB,CAAC;IAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC;QACtD,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC;QAC1C,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IACpB,IAAI,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,OAAO,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACrC,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;gBAAE,OAAO,KAAK,CAAC;YAC1C,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO;gBAAE,OAAO,KAAK,CAAC;YAClE,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AACjD,CAAC;AAED,+EAA+E;AAC/E,SAAgB,iBAAiB,CAAC,KAAgB;IAChD,IAAI,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,OAAO,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,KAAK,CAAC,aAAa,CAAC;AAC7B,CAAC"}

package/dist/assistant/application/agentAnalyzeSessionService.d.ts

@@ -0,0 +1,130 @@
+import { type AgentRuntimeAnalysisResult, type Hypothesis, type IOrchestrator, type StreamingUpdate } from '../../agent';
+import type { ProviderScope } from '../../services/providerManager';
+import type { ComparisonReportSection, ComparisonSourceKind } from '../../agentv3/sessionStateSnapshot';
+import { type EnhancedSessionContext } from '../../agent/context/enhancedSessionContext';
+import { type SessionLogger } from '../../services/sessionLogger';
+import { SessionPersistenceService } from '../../services/sessionPersistenceService';
+import { AssistantApplicationService, type ManagedAssistantSession } from './assistantApplicationService';
+export interface AnalyzeSessionConversationStep {
+    eventId: string;
+    ordinal: number;
+    phase: 'progress' | 'thinking' | 'tool' | 'result' | 'error';
+    role: 'agent' | 'system';
+    text: string;
+    timestamp: number;
+    sourceEventType?: string;
+}
+export interface AnalyzeSessionAgentDialogueItem {
+    agentId: string;
+    type: 'task' | 'response' | 'question';
+    content: any;
+    timestamp: number;
+}
+export interface AnalyzeSessionAgentResponseItem {
+    taskId: string;
+    agentId: string;
+    response: any;
+    timestamp: number;
+}
+export interface AnalyzeSessionRunContext {
+    runId: string;
+    requestId: string;
+    sequence: number;
+    query: string;
+    startedAt: number;
+    completedAt?: number;
+    status: 'pending' | 'running' | 'completed' | 'failed' | 'quota_exceeded';
+    error?: string;
+}
+export interface AnalyzeManagedSession extends ManagedAssistantSession {
+    orchestrator: IOrchestrator;
+    orchestratorUpdateHandler?: (update: StreamingUpdate) => void;
+    traceId: string;
+    query: string;
+    tenantId?: string;
+    workspaceId?: string;
+    userId?: string;
+    /** Provider Manager profile used for this SDK session. null means env/default fallback is pinned. */
+    providerId?: string | null;
+    /** Non-secret ProviderSnapshot hash used to decide whether SDK session state can be reused. */
+    providerSnapshotHash?: string | null;
+    providerSnapshotChanged?: boolean;
+    providerSnapshotChangeReason?: string;
+    /** Reference trace ID for raw dual-trace comparison sessions. */
+    referenceTraceId?: string;
+    /** Comparison source model used by this session. */
+    comparisonSource?: ComparisonSourceKind;
+    /** Shared deterministic comparison section for report generation. */
+    comparisonReportSection?: ComparisonReportSection;
+    logger: SessionLogger;
+    result?: AgentRuntimeAnalysisResult;
+    hypotheses: Hypothesis[];
+    agentDialogue: AnalyzeSessionAgentDialogueItem[];
+    dataEnvelopes: any[];
+    agentResponses: AnalyzeSessionAgentResponseItem[];
+    conversationOrdinal: number;
+    conversationSteps: AnalyzeSessionConversationStep[];
+    runSequence?: number;
+    activeRun?: AnalyzeSessionRunContext;
+    lastRun?: AnalyzeSessionRunContext;
+    /** Cross-turn query history — appended on each turn, never overwritten */
+    queryHistory?: Array<{
+        turn: number;
+        query: string;
+        timestamp: number;
+    }>;
+    /** Cross-turn conclusion history — appended after each turn completes */
+    conclusionHistory?: Array<{
+        turn: number;
+        conclusion: string;
+        confidence: number;
+        timestamp: number;
+    }>;
+}
+interface SessionContextManagerLike {
+    set(sessionId: string, traceId: string, context: EnhancedSessionContext): void;
+}
+interface AgentAnalyzeSessionServiceDeps<TSession extends AnalyzeManagedSession> {
+    assistantAppService: AssistantApplicationService<TSession>;
+    createSessionLogger: (sessionId: string) => SessionLogger;
+    sessionPersistenceService: SessionPersistenceService;
+    /** Defaults to the module-level `sessionContextManager` singleton. Callers
+     *  (HTTP route, CLI) no longer need to import it just to satisfy the deps. */
+    sessionContextManager?: SessionContextManagerLike;
+    buildRecoveredResultFromContext: (sessionId: string, context: EnhancedSessionContext) => AgentRuntimeAnalysisResult | null;
+}
+interface PrepareAnalyzeSessionInput {
+    traceId: string;
+    query: string;
+    requestedSessionId?: string;
+    referenceTraceId?: string;
+    providerId?: string | null;
+    providerScope?: ProviderScope;
+    options?: any;
+}
+export interface PrepareAnalyzeSessionResult<TSession extends AnalyzeManagedSession> {
+    sessionId: string;
+    session: TSession;
+    isNewSession: boolean;
+}
+export declare class AnalyzeSessionPreparationError extends Error {
+    readonly code: string;
+    readonly httpStatus: number;
+    readonly hint?: string;
+    constructor(message: string, options: {
+        code: string;
+        httpStatus: number;
+        hint?: string;
+    });
+}
+export declare class AgentAnalyzeSessionService<TSession extends AnalyzeManagedSession> {
+    private readonly assistantAppService;
+    private readonly createSessionLogger;
+    private readonly sessionPersistenceService;
+    private readonly sessionContextManager;
+    private readonly buildRecoveredResultFromContext;
+    constructor(deps: AgentAnalyzeSessionServiceDeps<TSession>);
+    prepareSession(input: PrepareAnalyzeSessionInput): PrepareAnalyzeSessionResult<TSession>;
+}
+export {};
+//# sourceMappingURL=agentAnalyzeSessionService.d.ts.map

package/dist/assistant/application/agentAnalyzeSessionService.d.ts.map

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