@gracker/smartperfetto 1.0.14 → 1.0.15

package/dist/services/symbol/breakpadSymParser.js

@@ -0,0 +1,40 @@
+"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.parseBreakpadSym = parseBreakpadSym;
+exports.resolveBreakpadAddress = resolveBreakpadAddress;
+function parseBreakpadSym(text) {
+    const module = { functions: [] };
+    for (const line of text.replace(/\r\n?/g, '\n').split('\n')) {
+        const moduleMatch = line.match(/^MODULE\s+(\S+)\s+(\S+)\s+(\S+)\s+(.+)$/);
+        if (moduleMatch) {
+            module.os = moduleMatch[1];
+            module.arch = moduleMatch[2];
+            module.buildId = moduleMatch[3];
+            module.moduleName = moduleMatch[4].trim();
+            continue;
+        }
+        const funcMatch = line.match(/^FUNC\s+([0-9a-fA-F]+)\s+([0-9a-fA-F]+)\s+([0-9a-fA-F]+)\s+(.+)$/);
+        if (!funcMatch)
+            continue;
+        module.functions.push({
+            address: BigInt(`0x${funcMatch[1]}`),
+            size: BigInt(`0x${funcMatch[2]}`),
+            parameterSize: BigInt(`0x${funcMatch[3]}`),
+            name: funcMatch[4].trim(),
+        });
+    }
+    module.functions.sort((a, b) => a.address < b.address ? -1 : a.address > b.address ? 1 : 0);
+    return module;
+}
+function resolveBreakpadAddress(module, address) {
+    for (const func of module.functions) {
+        if (address >= func.address && address < func.address + func.size) {
+            return { func, offset: address - func.address };
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=breakpadSymParser.js.map

package/dist/services/symbol/breakpadSymParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"breakpadSymParser.js","sourceRoot":"","sources":["../../../src/services/symbol/breakpadSymParser.ts"],"names":[],"mappings":";AAAA,6CAA6C;AAC7C,0CAA0C;AAC1C,+DAA+D;;AAiB/D,4CAsBC;AAED,wDAUC;AAlCD,SAAgB,gBAAgB,CAAC,IAAY;IAC3C,MAAM,MAAM,GAAmB,EAAC,SAAS,EAAE,EAAE,EAAC,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5D,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC1E,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,CAAC,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YAC3B,MAAM,CAAC,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YAC7B,MAAM,CAAC,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YAChC,MAAM,CAAC,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC1C,SAAS;QACX,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,kEAAkE,CAAC,CAAC;QACjG,IAAI,CAAC,SAAS;YAAE,SAAS;QACzB,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC;YACpB,OAAO,EAAE,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YACpC,IAAI,EAAE,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YACjC,aAAa,EAAE,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1C,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;SAC1B,CAAC,CAAC;IACL,CAAC;IACD,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5F,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAgB,sBAAsB,CACpC,MAAsB,EACtB,OAAe;IAEf,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACpC,IAAI,OAAO,IAAI,IAAI,CAAC,OAAO,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAClE,OAAO,EAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC,OAAO,EAAC,CAAC;QAChD,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/services/symbol/kallsymsParser.d.ts

@@ -0,0 +1,12 @@
+export interface KallsymsEntry {
+    address: bigint;
+    type: string;
+    symbol: string;
+    module?: string;
+}
+export declare function parseKallsyms(text: string): KallsymsEntry[];
+export declare function resolveKallsymsAddress(entries: readonly KallsymsEntry[], address: bigint): {
+    entry: KallsymsEntry;
+    offset: bigint;
+} | undefined;
+//# sourceMappingURL=kallsymsParser.d.ts.map

package/dist/services/symbol/kallsymsParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kallsymsParser.d.ts","sourceRoot":"","sources":["../../../src/services/symbol/kallsymsParser.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAc3D;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,SAAS,aAAa,EAAE,EACjC,OAAO,EAAE,MAAM,GACd;IAAC,KAAK,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,GAAG,SAAS,CAepD"}

package/dist/services/symbol/kallsymsParser.js

@@ -0,0 +1,41 @@
+"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.parseKallsyms = parseKallsyms;
+exports.resolveKallsymsAddress = resolveKallsymsAddress;
+function parseKallsyms(text) {
+    const entries = [];
+    for (const line of text.replace(/\r\n?/g, '\n').split('\n')) {
+        const match = line.trim().match(/^([0-9a-fA-F]+)\s+([A-Za-z])\s+(\S+)(?:\s+\[([^\]]+)\])?/);
+        if (!match)
+            continue;
+        entries.push({
+            address: BigInt(`0x${match[1]}`),
+            type: match[2],
+            symbol: match[3],
+            ...(match[4] ? { module: match[4] } : {}),
+        });
+    }
+    entries.sort((a, b) => a.address < b.address ? -1 : a.address > b.address ? 1 : 0);
+    return entries;
+}
+function resolveKallsymsAddress(entries, address) {
+    let lo = 0;
+    let hi = entries.length - 1;
+    let best;
+    while (lo <= hi) {
+        const mid = Math.floor((lo + hi) / 2);
+        const entry = entries[mid];
+        if (entry.address <= address) {
+            best = entry;
+            lo = mid + 1;
+        }
+        else {
+            hi = mid - 1;
+        }
+    }
+    return best ? { entry: best, offset: address - best.address } : undefined;
+}
+//# sourceMappingURL=kallsymsParser.js.map

package/dist/services/symbol/kallsymsParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kallsymsParser.js","sourceRoot":"","sources":["../../../src/services/symbol/kallsymsParser.ts"],"names":[],"mappings":";AAAA,6CAA6C;AAC7C,0CAA0C;AAC1C,+DAA+D;;AAS/D,sCAcC;AAED,wDAkBC;AAlCD,SAAgB,aAAa,CAAC,IAAY;IACxC,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAC5F,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,OAAO,CAAC,IAAI,CAAC;YACX,OAAO,EAAE,MAAM,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YAChC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;YAChB,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SACxC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAgB,sBAAsB,CACpC,OAAiC,EACjC,OAAe;IAEf,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAC5B,IAAI,IAA+B,CAAC;IACpC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACtC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,KAAK,CAAC,OAAO,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,GAAG,KAAK,CAAC;YACb,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC;QACf,CAAC;aAAM,CAAC;YACN,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC,CAAC,CAAC,EAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC,OAAO,EAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1E,CAAC"}

package/dist/services/symbol/r8MappingParser.d.ts

@@ -0,0 +1,40 @@
+export interface R8ClassMapping {
+    originalClass: string;
+    obfuscatedClass: string;
+    methods: R8MethodMapping[];
+}
+export interface R8MethodMapping {
+    originalName: string;
+    obfuscatedName: string;
+    originalClass: string;
+    obfuscatedClass: string;
+    originalLineRange?: {
+        start: number;
+        end: number;
+    };
+    obfuscatedLineRange?: {
+        start: number;
+        end: number;
+    };
+    signature?: string;
+}
+export interface R8RetraceResult {
+    success: boolean;
+    originalClass?: string;
+    originalName?: string;
+    originalSymbol?: string;
+    lineRange?: {
+        start: number;
+        end: number;
+    };
+    inlineFrames: R8MethodMapping[];
+    degradedReason?: 'no_mapping' | 'class_only';
+}
+export declare function parseR8Mapping(text: string): R8ClassMapping[];
+export declare function retraceR8Symbol(mappings: readonly R8ClassMapping[], opts: {
+    obfuscatedClass?: string;
+    obfuscatedMethod?: string;
+    obfuscatedSymbol?: string;
+    line?: number;
+}): R8RetraceResult;
+//# sourceMappingURL=r8MappingParser.d.ts.map

package/dist/services/symbol/r8MappingParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"r8MappingParser.d.ts","sourceRoot":"","sources":["../../../src/services/symbol/r8MappingParser.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAC,CAAC;IACjD,mBAAmB,CAAC,EAAE;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAC,CAAC;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAC,CAAC;IACzC,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,cAAc,CAAC,EAAE,YAAY,GAAG,YAAY,CAAC;CAC9C;AASD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,CAqC7D;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,SAAS,cAAc,EAAE,EACnC,IAAI,EAAE;IAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAC,GACpG,eAAe,CAuCjB"}

package/dist/services/symbol/r8MappingParser.js

@@ -0,0 +1,99 @@
+"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.parseR8Mapping = parseR8Mapping;
+exports.retraceR8Symbol = retraceR8Symbol;
+function parseLineRange(value) {
+    if (!value)
+        return undefined;
+    const parts = value.split(':').map(part => Number(part));
+    if (parts.length !== 2 || parts.some(part => !Number.isFinite(part)))
+        return undefined;
+    return { start: parts[0], end: parts[1] };
+}
+function parseR8Mapping(text) {
+    const classes = [];
+    let current;
+    for (const rawLine of text.replace(/\r\n?/g, '\n').split('\n')) {
+        if (!rawLine.trim() || rawLine.trim().startsWith('#'))
+            continue;
+        const classMatch = rawLine.match(/^(\S.*?)\s+->\s+([A-Za-z0-9_.$]+):\s*$/);
+        if (classMatch) {
+            current = {
+                originalClass: classMatch[1].trim(),
+                obfuscatedClass: classMatch[2].trim(),
+                methods: [],
+            };
+            classes.push(current);
+            continue;
+        }
+        if (!current)
+            continue;
+        const line = rawLine.trim();
+        const arrow = line.match(/^(.*?)\s+->\s+([A-Za-z_$][A-Za-z0-9_$]*)$/);
+        if (!arrow)
+            continue;
+        const lhs = arrow[1].trim();
+        const obfuscatedName = arrow[2].trim();
+        const ranged = lhs.match(/^(?:(\d+:\d+):)?(.+?)(?::(\d+:\d+))?$/);
+        if (!ranged)
+            continue;
+        const signature = ranged[2].trim();
+        const nameMatch = signature.match(/([A-Za-z_$][A-Za-z0-9_$<>]*)\s*\([^)]*\)\s*$/);
+        if (!nameMatch)
+            continue;
+        current.methods.push({
+            originalName: nameMatch[1],
+            obfuscatedName,
+            originalClass: current.originalClass,
+            obfuscatedClass: current.obfuscatedClass,
+            ...(parseLineRange(ranged[3]) ? { originalLineRange: parseLineRange(ranged[3]) } : {}),
+            ...(parseLineRange(ranged[1]) ? { obfuscatedLineRange: parseLineRange(ranged[1]) } : {}),
+            signature,
+        });
+    }
+    return classes;
+}
+function retraceR8Symbol(mappings, opts) {
+    const className = opts.obfuscatedClass ?? opts.obfuscatedSymbol?.split('.').slice(0, -1).join('.');
+    const methodName = opts.obfuscatedMethod ?? opts.obfuscatedSymbol?.split('.').pop();
+    const classMapping = mappings.find(mapping => mapping.obfuscatedClass === className);
+    if (!classMapping)
+        return { success: false, inlineFrames: [], degradedReason: 'no_mapping' };
+    if (!methodName) {
+        return {
+            success: true,
+            originalClass: classMapping.originalClass,
+            originalSymbol: classMapping.originalClass,
+            inlineFrames: [],
+            degradedReason: 'class_only',
+        };
+    }
+    const candidates = classMapping.methods.filter(method => method.obfuscatedName === methodName);
+    const byLine = opts.line
+        ? candidates.filter(method => !method.obfuscatedLineRange ||
+            (opts.line >= method.obfuscatedLineRange.start && opts.line <= method.obfuscatedLineRange.end))
+        : candidates;
+    const selected = byLine[0] ?? candidates[0];
+    if (!selected) {
+        return {
+            success: true,
+            originalClass: classMapping.originalClass,
+            originalName: methodName,
+            originalSymbol: `${classMapping.originalClass}.${methodName}`,
+            inlineFrames: [],
+            degradedReason: 'class_only',
+        };
+    }
+    return {
+        success: true,
+        originalClass: selected.originalClass,
+        originalName: selected.originalName,
+        originalSymbol: `${selected.originalClass}.${selected.originalName}`,
+        ...(selected.originalLineRange ? { lineRange: selected.originalLineRange } : {}),
+        inlineFrames: byLine.length > 0 ? byLine : [selected],
+    };
+}
+//# sourceMappingURL=r8MappingParser.js.map

package/dist/services/symbol/r8MappingParser.js.map

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

package/dist/services/symbol/symbolResolver.d.ts

@@ -0,0 +1,59 @@
+import type { RagChunk } from '../../types/sparkContracts';
+import type { RagStore } from '../ragStore';
+export interface ResolveAppSymbolOptions {
+    symbol: string;
+    codebaseId?: string;
+    buildId?: string;
+    filePath?: string;
+    r8MappingText?: string;
+    obfuscatedClass?: string;
+    obfuscatedMethod?: string;
+    line?: number;
+    topK?: number;
+}
+export interface ResolveKernelSymbolOptions {
+    symbol?: string;
+    address?: string;
+    codebaseId?: string;
+    vendor?: string;
+    buildId?: string;
+    kallsymsText?: string;
+    systemMapText?: string;
+    topK?: number;
+}
+export interface ResolveNativeSymbolOptions {
+    symbol?: string;
+    address?: string;
+    codebaseId?: string;
+    buildId?: string;
+    breakpadSymText?: string;
+    topK?: number;
+}
+export interface ResolvedSymbolCandidate {
+    chunkId: string;
+    codebaseId?: string;
+    filePath?: string;
+    lineRange?: {
+        start: number;
+        end: number;
+    };
+    symbol?: string;
+    language?: RagChunk['language'];
+    confidence: 'exact' | 'file' | 'text';
+}
+export interface ResolveAppSymbolResult {
+    success: boolean;
+    query: string;
+    candidates: ResolvedSymbolCandidate[];
+    degradedReason?: 'missing_build_id' | 'no_match' | 'symbol_only_low_confidence';
+}
+export type ResolveSymbolResult = ResolveAppSymbolResult;
+export declare class SymbolResolver {
+    private readonly store;
+    constructor(store: RagStore);
+    resolveApp(opts: ResolveAppSymbolOptions): ResolveAppSymbolResult;
+    resolveKernel(opts: ResolveKernelSymbolOptions): ResolveSymbolResult;
+    resolveNative(opts: ResolveNativeSymbolOptions): ResolveSymbolResult;
+    private resolveSourceKind;
+}
+//# sourceMappingURL=symbolResolver.d.ts.map

package/dist/services/symbol/symbolResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbolResolver.d.ts","sourceRoot":"","sources":["../../../src/services/symbol/symbolResolver.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,4BAA4B,CAAC;AACzD,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,aAAa,CAAC;AAK1C,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAC,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IAChC,UAAU,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;CACvC;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,uBAAuB,EAAE,CAAC;IACtC,cAAc,CAAC,EAAE,kBAAkB,GAAG,UAAU,GAAG,4BAA4B,CAAC;CACjF;AAED,MAAM,MAAM,mBAAmB,GAAG,sBAAsB,CAAC;AAczD,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,QAAQ;IAE5C,UAAU,CAAC,IAAI,EAAE,uBAAuB,GAAG,sBAAsB;IAgEjE,aAAa,CAAC,IAAI,EAAE,0BAA0B,GAAG,mBAAmB;IAkBpE,aAAa,CAAC,IAAI,EAAE,0BAA0B,GAAG,mBAAmB;IAiBpE,OAAO,CAAC,iBAAiB;CA2B1B"}

package/dist/services/symbol/symbolResolver.js

@@ -0,0 +1,147 @@
+"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.SymbolResolver = void 0;
+const breakpadSymParser_1 = require("./breakpadSymParser");
+const kallsymsParser_1 = require("./kallsymsParser");
+const r8MappingParser_1 = require("./r8MappingParser");
+function toCandidate(chunk, confidence) {
+    return {
+        chunkId: chunk.chunkId,
+        ...(chunk.codebaseId ? { codebaseId: chunk.codebaseId } : {}),
+        ...(chunk.filePath ? { filePath: chunk.filePath } : {}),
+        ...(chunk.lineRange ? { lineRange: chunk.lineRange } : {}),
+        ...(chunk.symbol ? { symbol: chunk.symbol } : {}),
+        ...(chunk.language ? { language: chunk.language } : {}),
+        confidence,
+    };
+}
+class SymbolResolver {
+    constructor(store) {
+        this.store = store;
+    }
+    resolveApp(opts) {
+        const retraced = opts.r8MappingText
+            ? (0, r8MappingParser_1.retraceR8Symbol)((0, r8MappingParser_1.parseR8Mapping)(opts.r8MappingText), {
+                obfuscatedSymbol: opts.symbol,
+                obfuscatedClass: opts.obfuscatedClass,
+                obfuscatedMethod: opts.obfuscatedMethod,
+                line: opts.line,
+            })
+            : undefined;
+        const querySymbol = retraced?.originalSymbol ?? opts.symbol;
+        const symbolName = retraced?.originalName ?? querySymbol.split('.').pop() ?? querySymbol;
+        const topK = opts.topK ?? 5;
+        const base = {
+            kinds: ['app_source'],
+            topK,
+            ...(opts.codebaseId ? { codebaseIds: [opts.codebaseId] } : {}),
+            ...(opts.buildId ? { buildId: opts.buildId } : {}),
+        };
+        const exact = this.store.search(querySymbol, {
+            ...base,
+            symbolExact: symbolName,
+        });
+        if (exact.results.length > 0) {
+            return {
+                success: true,
+                query: querySymbol,
+                candidates: exact.results
+                    .filter(hit => hit.chunk)
+                    .map(hit => toCandidate(hit.chunk, 'exact')),
+                degradedReason: opts.buildId ? undefined : 'symbol_only_low_confidence',
+            };
+        }
+        if (opts.filePath) {
+            const byFile = this.store.search(querySymbol, {
+                ...base,
+                filePathExact: opts.filePath,
+            });
+            if (byFile.results.length > 0) {
+                return {
+                    success: true,
+                    query: querySymbol,
+                    candidates: byFile.results
+                        .filter(hit => hit.chunk)
+                        .map(hit => toCandidate(hit.chunk, 'file')),
+                    degradedReason: opts.buildId ? undefined : 'symbol_only_low_confidence',
+                };
+            }
+        }
+        const text = this.store.search(querySymbol, base);
+        return {
+            success: text.results.length > 0,
+            query: querySymbol,
+            candidates: text.results
+                .filter(hit => hit.chunk)
+                .map(hit => toCandidate(hit.chunk, 'text')),
+            degradedReason: text.results.length > 0
+                ? (opts.buildId ? undefined : 'symbol_only_low_confidence')
+                : 'no_match',
+        };
+    }
+    resolveKernel(opts) {
+        let query = opts.symbol;
+        if (!query && opts.address && (opts.kallsymsText || opts.systemMapText)) {
+            const parsed = (0, kallsymsParser_1.parseKallsyms)(opts.kallsymsText ?? opts.systemMapText ?? '');
+            const resolved = (0, kallsymsParser_1.resolveKallsymsAddress)(parsed, parseAddress(opts.address));
+            query = resolved?.entry.symbol;
+        }
+        if (!query) {
+            return { success: false, query: opts.address ?? '', candidates: [], degradedReason: 'no_match' };
+        }
+        return this.resolveSourceKind(query, 'kernel_source', {
+            codebaseId: opts.codebaseId,
+            vendor: opts.vendor,
+            buildId: opts.buildId,
+            topK: opts.topK,
+        });
+    }
+    resolveNative(opts) {
+        let query = opts.symbol;
+        if (!query && opts.address && opts.breakpadSymText) {
+            const module = (0, breakpadSymParser_1.parseBreakpadSym)(opts.breakpadSymText);
+            const resolved = (0, breakpadSymParser_1.resolveBreakpadAddress)(module, parseAddress(opts.address));
+            query = resolved?.func.name;
+        }
+        if (!query) {
+            return { success: false, query: opts.address ?? '', candidates: [], degradedReason: 'no_match' };
+        }
+        return this.resolveSourceKind(query, 'aosp', {
+            codebaseId: opts.codebaseId,
+            buildId: opts.buildId,
+            topK: opts.topK,
+        });
+    }
+    resolveSourceKind(symbol, kind, opts) {
+        const topK = opts.topK ?? 5;
+        const symbolName = symbol.split('::').pop()?.split('.').pop() ?? symbol;
+        const base = {
+            kinds: [kind],
+            topK,
+            ...(opts.codebaseId ? { codebaseIds: [opts.codebaseId] } : {}),
+            ...(opts.vendor ? { vendor: opts.vendor } : {}),
+            ...(opts.buildId ? { buildId: opts.buildId } : {}),
+        };
+        const exact = this.store.search(symbol, { ...base, symbolExact: symbolName });
+        const result = exact.results.length > 0 ? exact : this.store.search(symbol, base);
+        return {
+            success: result.results.length > 0,
+            query: symbol,
+            candidates: result.results
+                .filter(hit => hit.chunk)
+                .map(hit => toCandidate(hit.chunk, exact.results.length > 0 ? 'exact' : 'text')),
+            degradedReason: result.results.length > 0
+                ? (opts.buildId ? undefined : 'symbol_only_low_confidence')
+                : 'no_match',
+        };
+    }
+}
+exports.SymbolResolver = SymbolResolver;
+function parseAddress(value) {
+    const trimmed = value.trim();
+    return BigInt(trimmed.startsWith('0x') || trimmed.startsWith('0X') ? trimmed : `0x${trimmed}`);
+}
+//# sourceMappingURL=symbolResolver.js.map

package/dist/services/symbol/symbolResolver.js.map

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

package/dist/services/symbol/traceSymbolContext.d.ts

@@ -0,0 +1,14 @@
+export interface TraceSymbolFrame {
+    module?: string;
+    buildId?: string;
+    address?: string;
+    relativePc?: string;
+    symbol?: string;
+}
+export interface TraceSymbolContext {
+    frames: TraceSymbolFrame[];
+    hasBuildIds: boolean;
+    modules: string[];
+}
+export declare function normalizeTraceSymbolRows(rows: readonly Record<string, unknown>[]): TraceSymbolContext;
+//# sourceMappingURL=traceSymbolContext.d.ts.map

package/dist/services/symbol/traceSymbolContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceSymbolContext.d.ts","sourceRoot":"","sources":["../../../src/services/symbol/traceSymbolContext.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,kBAAkB,CAsBrG"}

package/dist/services/symbol/traceSymbolContext.js

@@ -0,0 +1,45 @@
+"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.normalizeTraceSymbolRows = normalizeTraceSymbolRows;
+function normalizeTraceSymbolRows(rows) {
+    const frames = [];
+    const modules = new Set();
+    let hasBuildIds = false;
+    for (const row of rows) {
+        const module = firstString(row, ['module', 'module_name', 'mapping_name', 'name']);
+        const buildId = firstString(row, ['build_id', 'buildId', 'buildid']);
+        const address = firstString(row, ['address', 'addr', 'pc']);
+        const relativePc = firstString(row, ['relative_pc', 'rel_pc', 'relativePc']);
+        const symbol = firstString(row, ['symbol', 'function_name', 'frame_name']);
+        if (!module && !buildId && !address && !relativePc && !symbol)
+            continue;
+        if (module)
+            modules.add(module);
+        if (buildId)
+            hasBuildIds = true;
+        frames.push({
+            ...(module ? { module } : {}),
+            ...(buildId ? { buildId } : {}),
+            ...(address ? { address } : {}),
+            ...(relativePc ? { relativePc } : {}),
+            ...(symbol ? { symbol } : {}),
+        });
+    }
+    return { frames, hasBuildIds, modules: Array.from(modules).sort() };
+}
+function firstString(row, keys) {
+    for (const key of keys) {
+        const value = row[key];
+        if (typeof value === 'string' && value.trim())
+            return value.trim();
+        if (typeof value === 'number' && Number.isFinite(value))
+            return String(value);
+        if (typeof value === 'bigint')
+            return value.toString();
+    }
+    return undefined;
+}
+//# sourceMappingURL=traceSymbolContext.js.map

package/dist/services/symbol/traceSymbolContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceSymbolContext.js","sourceRoot":"","sources":["../../../src/services/symbol/traceSymbolContext.ts"],"names":[],"mappings":";AAAA,6CAA6C;AAC7C,0CAA0C;AAC1C,+DAA+D;;AAgB/D,4DAsBC;AAtBD,SAAgB,wBAAwB,CAAC,IAAwC;IAC/E,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;QACnF,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;QACrE,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;QAC5D,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,aAAa,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;QAC7E,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,eAAe,EAAE,YAAY,CAAC,CAAC,CAAC;QAC3E,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,IAAI,CAAC,UAAU,IAAI,CAAC,MAAM;YAAE,SAAS;QACxE,IAAI,MAAM;YAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAChC,IAAI,OAAO;YAAE,WAAW,GAAG,IAAI,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC;YACV,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAC,MAAM,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3B,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAC,OAAO,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7B,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAC,OAAO,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7B,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAC,UAAU,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACnC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAC,MAAM,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAC,CAAC;AACpE,CAAC;AAED,SAAS,WAAW,CAAC,GAA4B,EAAE,IAAuB;IACxE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QACvB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE;YAAE,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;QACnE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9E,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IACzD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/types/sparkContracts.d.ts

@@ -94,7 +94,11 @@ export type RagSourceKind =
 /** Plan 44 — world-scope consolidated memory (post-review). */
  | 'world_memory'
 /** Plan 54 — published case library entries. */
- | 'case_library';
+ | 'case_library'
+/** Codebase-aware analysis — user application source. */
+ | 'app_source'
+/** Codebase-aware analysis — Linux kernel or vendor kernel source. */
+ | 'kernel_source';
 /**
  * Pointer to a RAG-indexed document chunk.
  *
@@ -1164,6 +1168,27 @@ export interface RagChunk {
      * traceable.
      */
     unsupportedReason?: string;
+    /** Path relative to the registered codebase root, when this chunk is source-backed. */
+    filePath?: string;
+    /** 1-based source line range covered by this chunk. */
+    lineRange?: {
+        start: number;
+        end: number;
+    };
+    /** Primary symbol/function/class represented by the chunk. */
+    symbol?: string;
+    /** Best-effort language tag for source-backed chunks. */
+    language?: 'cpp' | 'c' | 'java' | 'kotlin' | 'rust' | 'go' | 'py' | 'unknown';
+    /** Pinned source commit, when available. */
+    commitHash?: string;
+    /** Vendor tag for kernel/OEM sources. */
+    vendor?: string;
+    /** Build-id or equivalent artifact identity used to pin symbolization. */
+    buildId?: string;
+    /** Registered codebase id for user-configured source chunks. */
+    codebaseId?: string;
+    /** Origin that decides legacy-vs-codebase filtering. Missing old values are backfilled by RagStore. */
+    registryOrigin?: 'codebase_registry' | 'legacy_plan55' | 'plan44_memory' | 'plan54_cases';
 }
 /** A single retrieval hit — supports per-hit missing-data paths. */
 export interface RagRetrievalHit {
@@ -1559,13 +1584,16 @@ export interface CaseGraphLibraryContract extends SparkProvenance {
  * Tool exposure level. Drives whether external hosts (Claude Code,
  * Cursor, Codex via stdio) and remote A2A peers see the tool.
  *
- * - `public` — safe for any host. Read-only data tools.
+ * - `public` — safe for any host.
+ * - `public-readonly` — externally visible read-only metadata tool.
  * - `internal` — agentv3 protocol tools (plan / hypothesis / note
  *   updates). Writing them from an external host would corrupt the
  *   active session.
+ * - `requires_codebase_permission` — only visible inside a request/session
+ *   with codebase permission; never exposed via stdio/A2A.
  * - `deprecated` — kept for compatibility, hidden from public surface.
  */
-export type McpToolExposure = 'public' | 'internal' | 'deprecated';
+export type McpToolExposure = 'public' | 'public-readonly' | 'internal' | 'requires_codebase_permission' | 'deprecated';
 /**
  * ACI — Agent-Callable Interface descriptor (Spark #96).
  *