feat(javascript): expose bounded semantic tracing
This commit is contained in:
@@ -58,7 +58,8 @@ export const summarizeJavaScriptApplicationEvidence = (
|
||||
location: observation.evidence.location,
|
||||
};
|
||||
});
|
||||
const { graph: _graph, ...summary } = result;
|
||||
const summary =
|
||||
result.schema_version === 1 ? omitGraph(result) : omitGraphs(result);
|
||||
const unknowns = new Set([
|
||||
...result.limitations,
|
||||
...result.graph.limitations,
|
||||
@@ -77,6 +78,19 @@ export const summarizeJavaScriptApplicationEvidence = (
|
||||
);
|
||||
return javascriptApplicationAnalysisSummarySchema.parse({
|
||||
...summary,
|
||||
...(result.schema_version === 1
|
||||
? {}
|
||||
: {
|
||||
semantic_graph: {
|
||||
graph_id: result.semantic_graph.graph_id,
|
||||
nodes: result.semantic_graph.nodes.length,
|
||||
relations: result.semantic_graph.relations.length,
|
||||
unknown_frontiers: result.semantic_graph.unknowns.length,
|
||||
fingerprints: result.semantic_graph.fingerprints.length,
|
||||
coverage: result.semantic_graph.coverage.status,
|
||||
query_tool: "trace_javascript_semantics",
|
||||
},
|
||||
}),
|
||||
unknowns: [...unknowns],
|
||||
graph: {
|
||||
graph_id: result.graph.graph_id,
|
||||
@@ -101,3 +115,23 @@ export const summarizeJavaScriptApplicationEvidence = (
|
||||
},
|
||||
});
|
||||
};
|
||||
|
||||
const omitGraph = (
|
||||
result: Extract<
|
||||
ReturnType<typeof javascriptApplicationAnalysisResultSchema.parse>,
|
||||
{ readonly schema_version: 1 }
|
||||
>,
|
||||
) => {
|
||||
const { graph: _graph, ...summary } = result;
|
||||
return summary;
|
||||
};
|
||||
|
||||
const omitGraphs = (
|
||||
result: Extract<
|
||||
ReturnType<typeof javascriptApplicationAnalysisResultSchema.parse>,
|
||||
{ readonly schema_version: 2 }
|
||||
>,
|
||||
) => {
|
||||
const { graph: _graph, semantic_graph: _semanticGraph, ...summary } = result;
|
||||
return summary;
|
||||
};
|
||||
|
||||
@@ -1,6 +1,7 @@
|
||||
import type { McpServer } from "@modelcontextprotocol/server";
|
||||
|
||||
import { registerTraceFeatureTool } from "./registerApplicationTools/traceFeature.js";
|
||||
import { registerTraceJavaScriptSemanticsTool } from "./registerApplicationTools/traceSemantics.js";
|
||||
import { registerCompareApplicationVersionsTool } from "./registerApplicationTools/compareVersions.js";
|
||||
import { registerCompareJavaScriptExportShapesTool } from "./registerApplicationTools/compareExportShapes.js";
|
||||
import { registerControlledReplayTool } from "./registerApplicationTools/controlledReplay.js";
|
||||
@@ -16,6 +17,7 @@ export const registerApplicationTools = (
|
||||
options: ApplicationToolRegistration,
|
||||
): void => {
|
||||
registerTraceFeatureTool(server, options);
|
||||
registerTraceJavaScriptSemanticsTool(server, options);
|
||||
registerCompareApplicationVersionsTool(server, options);
|
||||
registerCompareJavaScriptExportShapesTool(server, options);
|
||||
registerControlledReplayTool(server, options);
|
||||
|
||||
@@ -0,0 +1,49 @@
|
||||
import type { McpServer } from "@modelcontextprotocol/server";
|
||||
|
||||
import { resolveTraceJavaScriptSemanticsRequestValidated } from "../../application/ApplicationWorkflowEvidenceResolver.js";
|
||||
import { traceJavaScriptSemanticsEvidenceValidated } from "../../application/JavaScriptSemanticTraceService.js";
|
||||
import { applicationToolContract } from "../../contracts/applicationToolContracts.js";
|
||||
import { traceJavaScriptSemanticsRequestSchema } from "../../contracts/applicationWorkflowInputContracts.js";
|
||||
import { safeParseToolInput } from "../toolInputValidation.js";
|
||||
import { logToolExecution } from "../toolLogging.js";
|
||||
import { toolRegistrationOptions } from "../toolRegistrationOptions.js";
|
||||
import { toCallToolResult } from "../toolResult.js";
|
||||
import { recordResult, recordSources } from "./helpers.js";
|
||||
import type { ApplicationToolRegistration } from "./types.js";
|
||||
|
||||
const contract = applicationToolContract("trace_javascript_semantics");
|
||||
|
||||
/** Register the bounded JavaScript semantic relation trace tool. */
|
||||
export const registerTraceJavaScriptSemanticsTool = (
|
||||
server: McpServer,
|
||||
options: ApplicationToolRegistration,
|
||||
): void => {
|
||||
server.registerTool(
|
||||
contract.name,
|
||||
toolRegistrationOptions(contract),
|
||||
async (input) => {
|
||||
const parsedInput = safeParseToolInput(
|
||||
traceJavaScriptSemanticsRequestSchema,
|
||||
input,
|
||||
contract.name,
|
||||
);
|
||||
if (!parsedInput.ok) return toCallToolResult(parsedInput, contract);
|
||||
const resolved = resolveTraceJavaScriptSemanticsRequestValidated(
|
||||
parsedInput.value,
|
||||
options.evidenceLookup,
|
||||
);
|
||||
if (!resolved.ok) return toCallToolResult(resolved, contract);
|
||||
const result = await logToolExecution(options.logger, contract.name, () =>
|
||||
Promise.resolve(
|
||||
traceJavaScriptSemanticsEvidenceValidated(resolved.value),
|
||||
),
|
||||
);
|
||||
if (!result.ok) return toCallToolResult(result, contract);
|
||||
const recorded = recordSources(options.recordEvidence, [
|
||||
resolved.value.application,
|
||||
]);
|
||||
if (!recorded.ok) return toCallToolResult(recorded, contract);
|
||||
return recordResult(options, contract, result.value);
|
||||
},
|
||||
);
|
||||
};
|
||||
Reference in New Issue
Block a user