Deliver complete Evidence directly through MCP with required nullable analysis profiles and immutable per-server delivery settings. Bind selected environments at construction and require typed cleanup outcomes with retained retry ownership. Remove test-only routing, duplicate session and snapshot metadata, producer-field repairs, and ambiguous provider arguments. Separate artifact byte identity from occurrence classification and retain typed source-map and partial native facts across CLI, MCP, and verifier consumers. BREAKING CHANGE: obsolete Evidence envelopes, session aliases, incomplete snapshots, and missing normalized producer facts are no longer accepted.
80 lines
2.7 KiB
TypeScript
80 lines
2.7 KiB
TypeScript
import type { CdpEvent } from "./CdpConnection.js";
|
|
import { CdpCaptureCompleteness } from "./CdpCaptureCompleteness.js";
|
|
import {
|
|
numberValue,
|
|
recordValue,
|
|
scriptMetadataValues,
|
|
cdpStringValue,
|
|
} from "./CdpCaptureValues.js";
|
|
|
|
export interface ElectronScriptDraft {
|
|
readonly scriptId: string;
|
|
readonly rawUrl: string;
|
|
readonly hash: string | null;
|
|
readonly length: number | null;
|
|
readonly isModule: boolean | null;
|
|
readonly language: string | null;
|
|
readonly executionContextKey: string | null;
|
|
}
|
|
|
|
/** Retain script/frame metadata from passive Electron events. */
|
|
export const ingestElectronScriptEvent = (input: {
|
|
readonly event: CdpEvent;
|
|
readonly scripts: ElectronScriptDraft[];
|
|
readonly executionContextFrames: Map<string, string>;
|
|
readonly completeness: CdpCaptureCompleteness;
|
|
}): void => {
|
|
if (input.event.method === "Runtime.executionContextsCleared") {
|
|
input.executionContextFrames.clear();
|
|
return;
|
|
}
|
|
if (input.event.method === "Runtime.executionContextDestroyed") {
|
|
const parameters = recordValue(input.event.params);
|
|
const key = executionContextKey(parameters?.executionContextId);
|
|
if (key !== null) input.executionContextFrames.delete(key);
|
|
return;
|
|
}
|
|
if (input.event.method === "Runtime.executionContextCreated") {
|
|
retainExecutionContext(input.event, input.executionContextFrames);
|
|
return;
|
|
}
|
|
if (input.event.method !== "Debugger.scriptParsed") return;
|
|
const value = recordValue(input.event.params);
|
|
const scriptId = cdpStringValue(value?.scriptId);
|
|
const rawUrl = cdpStringValue(value?.url);
|
|
if (scriptId === undefined) {
|
|
input.completeness.exclude("scripts", "invalid_protocol_value");
|
|
return;
|
|
}
|
|
if (rawUrl === undefined || rawUrl === "") {
|
|
input.completeness.exclude("scripts", "unattributed_origin");
|
|
return;
|
|
}
|
|
input.scripts.push({
|
|
scriptId,
|
|
rawUrl,
|
|
...scriptMetadataValues(value),
|
|
language: cdpStringValue(value?.scriptLanguage) ?? null,
|
|
executionContextKey: executionContextKey(value?.executionContextId),
|
|
});
|
|
};
|
|
|
|
const retainExecutionContext = (
|
|
event: CdpEvent,
|
|
frames: Map<string, string>,
|
|
): void => {
|
|
const parameters = recordValue(event.params);
|
|
const runtimeContext = recordValue(parameters?.context);
|
|
const contextKey = executionContextKey(runtimeContext?.id);
|
|
const frameId = cdpStringValue(recordValue(runtimeContext?.auxData)?.frameId);
|
|
if (contextKey === null || frameId === undefined) return;
|
|
frames.set(contextKey, frameId);
|
|
};
|
|
|
|
const executionContextKey = (value: unknown): string | null => {
|
|
const identifier = numberValue(value);
|
|
return identifier !== undefined && Number.isSafeInteger(identifier)
|
|
? String(identifier)
|
|
: null;
|
|
};
|