@gracker/smartperfetto 1.0.13

package/dist/agent/traceRecorder.js

@@ -0,0 +1,122 @@
+"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.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentTraceRecorder = void 0;
+exports.getAgentTraceRecorder = getAgentTraceRecorder;
+exports.resetAgentTraceRecorder = resetAgentTraceRecorder;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+class AgentTraceRecorder {
+    constructor(config) {
+        this.traces = [];
+        this.config = {
+            outputDir: config?.outputDir || path_1.default.join(process.cwd(), 'agent-traces'),
+            enabled: config?.enabled ?? true,
+            maxTraces: config?.maxTraces || 100,
+        };
+        if (this.config.enabled) {
+            this.ensureOutputDir();
+        }
+    }
+    ensureOutputDir() {
+        if (!fs_1.default.existsSync(this.config.outputDir)) {
+            fs_1.default.mkdirSync(this.config.outputDir, { recursive: true });
+        }
+    }
+    record(query, traceId, orchestratorTrace, confidence) {
+        const totalToolCalls = orchestratorTrace.expertTraces.reduce((sum, et) => sum + et.toolCalls.length, 0);
+        const recorded = {
+            id: `trace_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,
+            timestamp: new Date().toISOString(),
+            query,
+            traceId,
+            orchestratorTrace,
+            metadata: {
+                totalDurationMs: orchestratorTrace.totalDuration,
+                totalLLMCalls: orchestratorTrace.totalLLMCalls,
+                totalToolCalls,
+                totalFindings: orchestratorTrace.expertTraces.reduce((sum, et) => sum + et.thoughts.filter(t => t.decision === 'conclude').length, 0),
+                expertCount: orchestratorTrace.expertTraces.length,
+                confidence,
+            },
+        };
+        this.traces.push(recorded);
+        if (this.traces.length > this.config.maxTraces) {
+            this.traces.shift();
+        }
+        if (this.config.enabled) {
+            this.saveTrace(recorded);
+        }
+        return recorded;
+    }
+    saveTrace(trace) {
+        const filename = `${trace.id}.json`;
+        const filepath = path_1.default.join(this.config.outputDir, filename);
+        fs_1.default.writeFileSync(filepath, JSON.stringify(trace, null, 2));
+    }
+    getTrace(id) {
+        return this.traces.find(t => t.id === id);
+    }
+    getRecentTraces(limit = 10) {
+        return this.traces.slice(-limit);
+    }
+    getStatistics() {
+        if (this.traces.length === 0) {
+            return {
+                totalTraces: 0,
+                avgDurationMs: 0,
+                avgConfidence: 0,
+                avgToolCalls: 0,
+                avgLLMCalls: 0,
+            };
+        }
+        const sum = this.traces.reduce((acc, t) => ({
+            duration: acc.duration + t.metadata.totalDurationMs,
+            confidence: acc.confidence + t.metadata.confidence,
+            toolCalls: acc.toolCalls + t.metadata.totalToolCalls,
+            llmCalls: acc.llmCalls + t.metadata.totalLLMCalls,
+        }), { duration: 0, confidence: 0, toolCalls: 0, llmCalls: 0 });
+        const count = this.traces.length;
+        return {
+            totalTraces: count,
+            avgDurationMs: Math.round(sum.duration / count),
+            avgConfidence: Math.round((sum.confidence / count) * 100) / 100,
+            avgToolCalls: Math.round((sum.toolCalls / count) * 10) / 10,
+            avgLLMCalls: Math.round((sum.llmCalls / count) * 10) / 10,
+        };
+    }
+    loadTracesFromDisk() {
+        if (!fs_1.default.existsSync(this.config.outputDir))
+            return;
+        const files = fs_1.default.readdirSync(this.config.outputDir)
+            .filter(f => f.endsWith('.json'))
+            .sort();
+        for (const file of files.slice(-this.config.maxTraces)) {
+            try {
+                const content = fs_1.default.readFileSync(path_1.default.join(this.config.outputDir, file), 'utf-8');
+                const trace = JSON.parse(content);
+                this.traces.push(trace);
+            }
+            catch {
+            }
+        }
+    }
+}
+exports.AgentTraceRecorder = AgentTraceRecorder;
+let globalRecorder = null;
+function getAgentTraceRecorder(config) {
+    if (!globalRecorder) {
+        globalRecorder = new AgentTraceRecorder(config);
+        globalRecorder.loadTracesFromDisk();
+    }
+    return globalRecorder;
+}
+function resetAgentTraceRecorder() {
+    globalRecorder = null;
+}
+//# sourceMappingURL=traceRecorder.js.map

package/dist/agent/traceRecorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceRecorder.js","sourceRoot":"","sources":["../../src/agent/traceRecorder.ts"],"names":[],"mappings":";AAAA,6CAA6C;AAC7C,0CAA0C;AAC1C,+DAA+D;;;;;;AAoK/D,sDAMC;AAED,0DAEC;AA5KD,4CAAoB;AACpB,gDAAwB;AAyBxB,MAAa,kBAAkB;IAI7B,YAAY,MAAqC;QAFzC,WAAM,GAAoB,EAAE,CAAC;QAGnC,IAAI,CAAC,MAAM,GAAG;YACZ,SAAS,EAAE,MAAM,EAAE,SAAS,IAAI,cAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC;YACxE,OAAO,EAAE,MAAM,EAAE,OAAO,IAAI,IAAI;YAChC,SAAS,EAAE,MAAM,EAAE,SAAS,IAAI,GAAG;SACpC,CAAC;QAEF,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,eAAe,EAAE,CAAC;QACzB,CAAC;IACH,CAAC;IAEO,eAAe;QACrB,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1C,YAAE,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,MAAM,CACJ,KAAa,EACb,OAAe,EACf,iBAAoC,EACpC,UAAkB;QAElB,MAAM,cAAc,GAAG,iBAAiB,CAAC,YAAY,CAAC,MAAM,CAC1D,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,EACtC,CAAC,CACF,CAAC;QAEF,MAAM,QAAQ,GAAkB;YAC9B,EAAE,EAAE,SAAS,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;YACpE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK;YACL,OAAO;YACP,iBAAiB;YACjB,QAAQ,EAAE;gBACR,eAAe,EAAE,iBAAiB,CAAC,aAAa;gBAChD,aAAa,EAAE,iBAAiB,CAAC,aAAa;gBAC9C,cAAc;gBACd,aAAa,EAAE,iBAAiB,CAAC,YAAY,CAAC,MAAM,CAClD,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,MAAM,EAC5E,CAAC,CACF;gBACD,WAAW,EAAE,iBAAiB,CAAC,YAAY,CAAC,MAAM;gBAClD,UAAU;aACX;SACF,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE3B,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,SAAU,EAAE,CAAC;YAChD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACtB,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC3B,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,SAAS,CAAC,KAAoB;QACpC,MAAM,QAAQ,GAAG,GAAG,KAAK,CAAC,EAAE,OAAO,CAAC;QACpC,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC5D,YAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,QAAQ,CAAC,EAAU;QACjB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,eAAe,CAAC,QAAgB,EAAE;QAChC,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,aAAa;QAOX,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO;gBACL,WAAW,EAAE,CAAC;gBACd,aAAa,EAAE,CAAC;gBAChB,aAAa,EAAE,CAAC;gBAChB,YAAY,EAAE,CAAC;gBACf,WAAW,EAAE,CAAC;aACf,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAC5B,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YACX,QAAQ,EAAE,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,eAAe;YACnD,UAAU,EAAE,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,QAAQ,CAAC,UAAU;YAClD,SAAS,EAAE,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,QAAQ,CAAC,cAAc;YACpD,QAAQ,EAAE,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,aAAa;SAClD,CAAC,EACF,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAC1D,CAAC;QAEF,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QACjC,OAAO;YACL,WAAW,EAAE,KAAK;YAClB,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,GAAG,KAAK,CAAC;YAC/C,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,UAAU,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG;YAC/D,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE;YAC3D,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,QAAQ,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE;SAC1D,CAAC;IACJ,CAAC;IAED,kBAAkB;QAChB,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;YAAE,OAAO;QAElD,MAAM,KAAK,GAAG,YAAE,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;aAChD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;aAChC,IAAI,EAAE,CAAC;QAEV,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,SAAU,CAAC,EAAE,CAAC;YACxD,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,YAAE,CAAC,YAAY,CAAC,cAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;gBACjF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAkB,CAAC;gBACnD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,CAAC;YAAC,MAAM,CAAC;YACT,CAAC;QACH,CAAC;IACH,CAAC;CACF;AApID,gDAoIC;AAED,IAAI,cAAc,GAA8B,IAAI,CAAC;AAErD,SAAgB,qBAAqB,CAAC,MAAqC;IACzE,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,cAAc,GAAG,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAChD,cAAc,CAAC,kBAAkB,EAAE,CAAC;IACtC,CAAC;IACD,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,SAAgB,uBAAuB;IACrC,cAAc,GAAG,IAAI,CAAC;AACxB,CAAC"}

package/dist/agent/types/agentProtocol.d.ts

@@ -0,0 +1,377 @@
+/**
+ * SmartPerfetto Agent Protocol Types
+ *
+ * Phase 2: Agent-ification with Skills as Tools
+ *
+ * This file defines the core types for the AI Agents system.
+ * Agents wrap existing Skills as "tools" they can invoke through AI reasoning.
+ */
+import { Finding } from '../types';
+import { SkillDefinition, SkillExecutionResult } from '../../services/skillEngine';
+import { DataEnvelope } from '../../types/dataContract';
+/**
+ * AgentTool - Wraps a Skill as a tool that an Agent can invoke
+ *
+ * Instead of replacing Skills, we wrap them as tools that Agents can reason about
+ * and decide when to invoke.
+ */
+export interface AgentTool {
+    /** Unique tool name */
+    name: string;
+    /** Human-readable description for LLM to understand when to use this tool */
+    description: string;
+    /** Optional skill ID this tool maps to */
+    skillId?: string;
+    /** Tool category for organization */
+    category: 'frame' | 'cpu' | 'memory' | 'binder' | 'startup' | 'interaction' | 'system' | 'general';
+    /** Required parameters */
+    parameters?: AgentToolParameter[];
+    /** Execute the tool */
+    execute: (params: Record<string, any>, context: AgentToolContext) => Promise<AgentToolResult>;
+}
+/**
+ * Tool parameter definition
+ */
+export interface AgentToolParameter {
+    name: string;
+    type: 'string' | 'number' | 'boolean' | 'timestamp' | 'duration' | 'array';
+    required: boolean;
+    description: string;
+    default?: any;
+}
+/**
+ * Context passed to tools during execution
+ */
+export interface AgentToolContext {
+    sessionId: string;
+    traceId: string;
+    traceProcessorService?: any;
+    /** AI service for AI-powered tools */
+    aiService?: {
+        chat: (prompt: string) => Promise<string>;
+    };
+    /** Package name being analyzed */
+    packageName?: string;
+    /** Time range for analysis (string for precision-safe ns timestamps) */
+    timeRange?: {
+        start: number | string;
+        end: number | string;
+    };
+    /** Additional context data */
+    additionalContext?: Record<string, any>;
+}
+/**
+ * Result from tool execution
+ */
+export interface AgentToolResult {
+    success: boolean;
+    data?: any;
+    findings?: Finding[];
+    error?: string;
+    executionTimeMs: number;
+    /** Layered result data from skill execution */
+    layeredResult?: any;
+    /** DataEnvelope(s) for SSE data events */
+    dataEnvelopes?: DataEnvelope[];
+    /** Optional metadata for debugging/tracking (e.g., dynamic SQL details) */
+    metadata?: Record<string, any>;
+}
+/**
+ * Task assigned to an agent
+ */
+export interface AgentTask {
+    /** Unique task ID */
+    id: string;
+    /** Task description */
+    description: string;
+    /** Agent ID to handle this task */
+    targetAgentId: string;
+    /** Priority (1 = highest) */
+    priority: number;
+    /** Task context */
+    context: AgentTaskContext;
+    /** Dependencies - task IDs that must complete first */
+    dependencies: string[];
+    /** Task timeout in ms */
+    timeout?: number;
+    /** Created timestamp */
+    createdAt: number;
+}
+/**
+ * Context for a task
+ */
+export interface AgentTaskContext {
+    /** Original user query */
+    query: string;
+    /** Parsed intent */
+    intent?: {
+        primaryGoal: string;
+        aspects: string[];
+    };
+    /** Domain of the task */
+    domain?: string;
+    /** Evidence or metrics required */
+    evidenceNeeded?: string[];
+    /** Hypothesis to investigate */
+    hypothesis?: Hypothesis;
+    /** Time range to focus on (string for precision-safe ns timestamps) */
+    timeRange?: {
+        start: number | string;
+        end: number | string;
+    };
+    /** Previous findings relevant to this task */
+    relevantFindings?: Finding[];
+    /** Additional context data */
+    additionalData?: Record<string, any>;
+}
+/**
+ * A hypothesis about the performance issue
+ */
+export interface Hypothesis {
+    /** Unique hypothesis ID */
+    id: string;
+    /** Hypothesis description */
+    description: string;
+    /** Confidence level (0-1) */
+    confidence: number;
+    /** Status */
+    status: 'proposed' | 'investigating' | 'confirmed' | 'rejected';
+    /** Evidence supporting this hypothesis */
+    supportingEvidence: Evidence[];
+    /** Evidence against this hypothesis */
+    contradictingEvidence: Evidence[];
+    /** Agent that proposed this hypothesis */
+    proposedBy: string;
+    /** Agents relevant to investigating this hypothesis */
+    relevantAgents?: string[];
+    /** Timestamp */
+    createdAt: number;
+    /** Last updated timestamp */
+    updatedAt: number;
+}
+/**
+ * Evidence for or against a hypothesis
+ */
+export interface Evidence {
+    /** Evidence ID */
+    id: string;
+    /** Description of the evidence */
+    description: string;
+    /** Source (finding ID, tool result, etc.) */
+    source: string;
+    /** Type of evidence */
+    type: 'finding' | 'metric' | 'observation' | 'inference';
+    /** Strength of evidence (0-1) */
+    strength: number;
+    /** Timestamp of the evidence */
+    timestamp?: number;
+}
+/**
+ * Response from an agent after completing a task
+ */
+export interface AgentResponse {
+    /** Agent ID that produced this response */
+    agentId: string;
+    /** Task ID this response is for */
+    taskId: string;
+    /** Whether the task was successful */
+    success: boolean;
+    /** Findings discovered */
+    findings: Finding[];
+    /** Hypothesis updates */
+    hypothesisUpdates?: HypothesisUpdate[];
+    /** Questions for other agents */
+    questionsForAgents?: InterAgentQuestion[];
+    /** Suggestions for further investigation */
+    suggestions?: string[];
+    /** Confidence in the response */
+    confidence: number;
+    /** Execution time in ms */
+    executionTimeMs: number;
+    /** Raw data from tool executions */
+    toolResults?: AgentToolResult[];
+    /** Reasoning trace */
+    reasoning?: ReasoningStep[];
+}
+/**
+ * Update to a hypothesis
+ */
+export interface HypothesisUpdate {
+    hypothesisId: string;
+    action: 'support' | 'contradict' | 'confirm' | 'reject' | 'update_confidence';
+    evidence?: Evidence;
+    newConfidence?: number;
+    reason: string;
+}
+/**
+ * Question from one agent to another
+ */
+export interface InterAgentQuestion {
+    /** From agent */
+    fromAgent: string;
+    /** Target agent */
+    toAgent: string;
+    /** Question */
+    question: string;
+    /** Context for the question */
+    context?: Record<string, any>;
+    /** Priority */
+    priority: number;
+}
+/**
+ * A step in the agent's reasoning process
+ */
+export interface ReasoningStep {
+    step: number;
+    type: 'observation' | 'analysis' | 'decision' | 'action';
+    content: string;
+    confidence: number;
+    timestamp: number;
+}
+/**
+ * Base configuration for all agents
+ */
+export interface AgentConfig {
+    /** Unique agent ID */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Agent domain */
+    domain: string;
+    /** Description of agent capabilities */
+    description: string;
+    /** Tools available to this agent */
+    tools: AgentTool[];
+    /** Maximum iterations for reasoning loop */
+    maxIterations: number;
+    /** Confidence threshold for conclusions */
+    confidenceThreshold: number;
+    /** Whether this agent can delegate to other agents */
+    canDelegate: boolean;
+    /** Agents this agent can delegate to */
+    delegateTo?: string[];
+}
+/**
+ * Message sent between agents
+ */
+export interface AgentMessage {
+    /** Unique message ID */
+    id: string;
+    /** Message type */
+    type: 'task' | 'response' | 'question' | 'broadcast' | 'event';
+    /** Sender agent ID */
+    from: string;
+    /** Recipient agent ID (or 'all' for broadcast) */
+    to: string;
+    /** Message payload */
+    payload: any;
+    /** Correlation ID for request-response patterns */
+    correlationId?: string;
+    /** Priority */
+    priority: number;
+    /** Timestamp */
+    timestamp: number;
+}
+/**
+ * Broadcast message to all agents
+ */
+export interface BroadcastMessage {
+    /** Message type */
+    type: 'hypothesis_proposed' | 'evidence_found' | 'conclusion_reached' | 'focus_shift';
+    /** Payload */
+    payload: any;
+    /** Sender agent ID */
+    from: string;
+    /** Timestamp */
+    timestamp: number;
+}
+/**
+ * Trace-level configuration detected from the trace file.
+ * Populated by vsync_config skill at the start of analysis.
+ *
+ * For VRR/LTPO devices, refresh rate varies dynamically.
+ * Use `dominantRefreshRateHz` for most jank calculations.
+ */
+export interface TraceConfig {
+    /** VSync period in nanoseconds (based on dominant refresh rate) */
+    vsyncPeriodNs?: number;
+    /** Refresh rate in Hz (dominant rate for VRR devices) */
+    refreshRateHz?: number;
+    /** VSync period in milliseconds (convenience) */
+    vsyncPeriodMs?: number;
+    /** Data source for vsync detection */
+    vsyncSource?: string;
+    /** Whether VRR (Variable Refresh Rate) is detected */
+    isVRR?: boolean;
+    /** VRR mode details if detected */
+    vrrMode?: 'VRR_ACTIVE' | 'VRR_LIMITED' | 'FIXED_RATE';
+    /** Minimum frame budget in ms (for strictest jank detection, use maxRefreshRateHz) */
+    minFrameBudgetMs?: number;
+    /** Maximum frame budget in ms (for most lenient detection, use minRefreshRateHz) */
+    maxFrameBudgetMs?: number;
+}
+/**
+ * Shared context accessible by all agents in a session
+ */
+export interface SharedAgentContext {
+    /** Session ID */
+    sessionId: string;
+    /** Trace ID */
+    traceId: string;
+    /** All proposed hypotheses */
+    hypotheses: Map<string, Hypothesis>;
+    /** Confirmed findings from all agents */
+    confirmedFindings: Finding[];
+    /** Current focus time range (string for precision-safe ns timestamps) */
+    focusedTimeRange?: {
+        start: number | string;
+        end: number | string;
+    };
+    /** Investigation path - trace of agent interactions */
+    investigationPath: InvestigationStep[];
+    /** Global metrics and statistics */
+    globalMetrics?: Record<string, any>;
+    /** User-provided context */
+    userContext?: Record<string, any>;
+    /** Trace-level configuration (vsync, refresh rate, etc.) */
+    traceConfig?: TraceConfig;
+    /**
+     * Jank cause summary aggregated from per-frame analysis.
+     * Populated by StrategyExecutor after Stage 2 (frame_analysis).
+     * Used by ConclusionGenerator to include structured root cause statistics.
+     */
+    jankCauseSummary?: import('../core/jankCauseSummarizer').JankCauseSummary;
+    /**
+     * Per-frame mechanism records captured directly from root_cause step outputs.
+     * Unlike findings, these records are not reduced by synthesis deduplication.
+     */
+    frameMechanismRecords?: import('./jankCause').FrameMechanismRecord[];
+}
+/**
+ * A step in the investigation path
+ */
+export interface InvestigationStep {
+    stepNumber: number;
+    agentId: string;
+    action: string;
+    timestamp: number;
+    result: 'success' | 'partial' | 'failed';
+    summary: string;
+}
+/**
+ * Create an AgentTool from a SkillDefinition
+ */
+export declare function createToolFromSkill(skill: SkillDefinition, category: AgentTool['category'], executor: (skillId: string, params: Record<string, any>, context: AgentToolContext) => Promise<SkillExecutionResult>): AgentTool;
+/**
+ * Create a unique task ID
+ */
+export declare function createTaskId(): string;
+/**
+ * Create a unique hypothesis ID
+ */
+export declare function createHypothesisId(): string;
+/**
+ * Create a unique message ID
+ */
+export declare function createMessageId(): string;
+//# sourceMappingURL=agentProtocol.d.ts.map

package/dist/agent/types/agentProtocol.d.ts.map

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

package/dist/agent/types/agentProtocol.js

@@ -0,0 +1,102 @@
+"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.createToolFromSkill = createToolFromSkill;
+exports.createTaskId = createTaskId;
+exports.createHypothesisId = createHypothesisId;
+exports.createMessageId = createMessageId;
+const skillEngine_1 = require("../../services/skillEngine");
+// =============================================================================
+// Factory Functions
+// =============================================================================
+/**
+ * Create an AgentTool from a SkillDefinition
+ */
+function createToolFromSkill(skill, category, executor) {
+    return {
+        name: `analyze_${skill.name.replace(/_/g, '_')}`,
+        description: skill.meta?.description || `Execute ${skill.name} analysis`,
+        skillId: skill.name,
+        category,
+        parameters: skill.inputs?.map((input) => ({
+            name: input.name,
+            type: input.type,
+            required: input.required,
+            description: input.description || `Parameter ${input.name}`,
+            default: input.default,
+        })),
+        execute: async (params, context) => {
+            const startTime = Date.now();
+            try {
+                const result = await executor(skill.name, params, context);
+                // Extract data from displayResults or rawResults
+                let data = null;
+                if (result.displayResults && result.displayResults.length > 0) {
+                    data = {};
+                    for (const dr of result.displayResults) {
+                        data[dr.stepId] = dr.data;
+                    }
+                }
+                else if (result.rawResults) {
+                    data = {};
+                    for (const [stepId, stepResult] of Object.entries(result.rawResults)) {
+                        data[stepId] = stepResult.data;
+                    }
+                }
+                // Extract findings from diagnostics
+                const findings = [];
+                if (result.diagnostics && result.diagnostics.length > 0) {
+                    for (const diag of result.diagnostics) {
+                        findings.push({
+                            id: `${skill.name}_${Date.now()}_${findings.length}`,
+                            category: category,
+                            severity: diag.severity,
+                            title: diag.diagnosis,
+                            description: diag.suggestions?.join('; ') || diag.diagnosis,
+                            source: skill.name,
+                            confidence: typeof diag.confidence === 'number' ? diag.confidence : 0.8,
+                            details: diag.evidence,
+                        });
+                    }
+                }
+                const dataEnvelopes = skillEngine_1.SkillExecutor.toDataEnvelopes(result);
+                return {
+                    success: result.success,
+                    data,
+                    findings,
+                    dataEnvelopes: dataEnvelopes.length > 0 ? dataEnvelopes : undefined,
+                    error: result.error,
+                    executionTimeMs: Date.now() - startTime,
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: error.message,
+                    executionTimeMs: Date.now() - startTime,
+                };
+            }
+        },
+    };
+}
+/**
+ * Create a unique task ID
+ */
+function createTaskId() {
+    return `task_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+}
+/**
+ * Create a unique hypothesis ID
+ */
+function createHypothesisId() {
+    return `hypo_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+}
+/**
+ * Create a unique message ID
+ */
+function createMessageId() {
+    return `msg_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+}
+//# sourceMappingURL=agentProtocol.js.map

package/dist/agent/types/agentProtocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentProtocol.js","sourceRoot":"","sources":["../../../src/agent/types/agentProtocol.ts"],"names":[],"mappings":";AAAA,6CAA6C;AAC7C,0CAA0C;AAC1C,+DAA+D;;AAia/D,kDAwEC;AAKD,oCAEC;AAKD,gDAEC;AAKD,0CAEC;AAlfD,4DAAkG;AA8YlG,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;GAEG;AACH,SAAgB,mBAAmB,CACjC,KAAsB,EACtB,QAA+B,EAC/B,QAAoH;IAEpH,OAAO;QACL,IAAI,EAAE,WAAW,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE;QAChD,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE,WAAW,IAAI,WAAW,KAAK,CAAC,IAAI,WAAW;QACxE,OAAO,EAAE,KAAK,CAAC,IAAI;QACnB,QAAQ;QACR,UAAU,EAAE,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,KAAU,EAAE,EAAE,CAAC,CAAC;YAC7C,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAW;YACvB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,aAAa,KAAK,CAAC,IAAI,EAAE;YAC3D,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;QACH,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;YACjC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;gBAE3D,iDAAiD;gBACjD,IAAI,IAAI,GAAQ,IAAI,CAAC;gBACrB,IAAI,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC9D,IAAI,GAAG,EAAE,CAAC;oBACV,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;wBACvC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;oBAC5B,CAAC;gBACH,CAAC;qBAAM,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;oBAC7B,IAAI,GAAG,EAAE,CAAC;oBACV,KAAK,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;wBACrE,IAAI,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC;oBACjC,CAAC;gBACH,CAAC;gBAED,oCAAoC;gBACpC,MAAM,QAAQ,GAAc,EAAE,CAAC;gBAC/B,IAAI,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACxD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;wBACtC,QAAQ,CAAC,IAAI,CAAC;4BACZ,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ,CAAC,MAAM,EAAE;4BACpD,QAAQ,EAAE,QAAQ;4BAClB,QAAQ,EAAE,IAAI,CAAC,QAAQ;4BACvB,KAAK,EAAE,IAAI,CAAC,SAAS;4BACrB,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS;4BAC3D,MAAM,EAAE,KAAK,CAAC,IAAI;4BAClB,UAAU,EAAE,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG;4BACvE,OAAO,EAAE,IAAI,CAAC,QAAQ;yBACvB,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;gBAED,MAAM,aAAa,GAAG,2BAAa,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;gBAE5D,OAAO;oBACL,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,IAAI;oBACJ,QAAQ;oBACR,aAAa,EAAE,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;oBACnE,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,eAAe,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;iBACxC,CAAC;YACJ,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,KAAK,CAAC,OAAO;oBACpB,eAAe,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;iBACxC,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY;IAC1B,OAAO,QAAQ,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACzE,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB;IAChC,OAAO,QAAQ,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACzE,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe;IAC7B,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACxE,CAAC"}

package/dist/agent/types/jankCause.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Structured per-frame mechanism record extracted from jank_frame_detail root cause output.
+ *
+ * These records preserve frame-level mechanism evidence before finding deduplication,
+ * so later aggregation can be based on frame samples instead of merged findings.
+ */
+export interface FrameMechanismRecord {
+    /** Stable frame identifier (falls back to interval id/start_ts when missing). */
+    frameId: string;
+    /** Session identifier if available. */
+    sessionId?: string;
+    /** Frame index inside session if available. */
+    frameIndex?: number;
+    /** Process/package name for this frame. */
+    processName?: string;
+    /** Process ID if available. */
+    pid?: number;
+    /** Frame analysis start timestamp (ns). */
+    startTs: string;
+    /** Frame analysis end timestamp (ns). */
+    endTs: string;
+    /** Scope label used in direct skill execution logs. */
+    scopeLabel: string;
+    /** Canonical cause type from root_cause/root_cause_summary. */
+    causeType: string;
+    /** Human-readable primary cause text. */
+    primaryCause?: string;
+    /** Additional context from root cause step. */
+    secondaryInfo?: string;
+    /** Confidence emitted by root cause step (numeric or label). */
+    confidenceLevel?: number | string;
+    /** Frame duration in ms if available. */
+    frameDurMs?: number;
+    /** Jank type label if available. */
+    jankType?: string;
+    /** Mechanism group from root cause classification (trigger/supply/amplification). */
+    mechanismGroup?: string;
+    /** Supply-side constraint category (frequency/scheduling/core placement/etc.). */
+    supplyConstraint?: string;
+    /** Layer where trigger signal is identified (app_producer/sf_consumer). */
+    triggerLayer?: string;
+    /** Classified amplification path, if detected. */
+    amplificationPath?: string;
+    /** Source step that produced the record. */
+    sourceStep: 'root_cause' | 'root_cause_summary';
+}
+//# sourceMappingURL=jankCause.d.ts.map