Summarize saved Wireshark4.x captures with enforced native resource limits, serialized admission, stable snapshot verification and retained fact/text pages. Preserve complete inventories within resource budgets and source uncertainty; report cleanup failure with partial Evidence and retained ownership. Verified six recorded corpora /13026 packets with independent Scapy/Python oracles, real CLI/MCP/schema parity,60 SNI names,132 DNS addresses and1000 URIs. Real TShark CI now exercises summary/paging. Actual Windows/Bun Wireshark remains unverified; macOS capture requires a separate enforceable-bound decision. Co-authored-by: 3QL <85309073+3QL@users.noreply.github.com> Co-authored-by: N0zoM1z0 <161784452+N0zoM1z0@users.noreply.github.com>
84 lines
2.8 KiB
TypeScript
84 lines
2.8 KiB
TypeScript
import type { EvidenceMcpServer } from "./EvidenceMcpServer.js";
|
|
import type { EvidenceWriter } from "../application/investigation/InvestigationRecordPort.js";
|
|
import { PcapAnalysisService } from "../application/pcap/PcapAnalysisService.js";
|
|
import { toolContract } from "../contracts/toolContracts.js";
|
|
import type { WithAdmittedAnalysis } from "./analysisAdmission.js";
|
|
import type { Logger } from "pino";
|
|
import {
|
|
createContractToolHandler,
|
|
createEvidenceToolHandler,
|
|
} from "./contractToolHandler.js";
|
|
import {
|
|
toolRegistrationOptions,
|
|
applicationValidatedInputSchema,
|
|
} from "./toolRegistrationOptions.js";
|
|
import type { EvidenceLookup } from "../application/EvidenceInputResolver.js";
|
|
import {
|
|
requireAnalysisViewRetention,
|
|
summarizeRetainedAnalysis,
|
|
} from "../application/analysisView/AnalysisViewService.js";
|
|
import { analysisInputErrorFromIssues } from "../domain/inputIssueProjection.js";
|
|
import { err } from "../domain/result.js";
|
|
|
|
/** Bind pcap handlers to their exact named contracts through admission. */
|
|
export const registerPcapTools = (
|
|
server: EvidenceMcpServer,
|
|
service: PcapAnalysisService,
|
|
logger: Logger,
|
|
recordEvidence?: EvidenceWriter["recordEvidence"],
|
|
withAdmittedAnalysis?: WithAdmittedAnalysis,
|
|
evidenceById?: EvidenceLookup,
|
|
): void => {
|
|
const handler = createContractToolHandler(
|
|
server,
|
|
service,
|
|
logger,
|
|
recordEvidence,
|
|
withAdmittedAnalysis,
|
|
);
|
|
const clientContract = toolContract("inspect_pcap_client");
|
|
server.registerTool(
|
|
clientContract.name,
|
|
toolRegistrationOptions(clientContract),
|
|
handler(clientContract),
|
|
);
|
|
const contract = toolContract("inspect_pcap_capture");
|
|
const registration = toolRegistrationOptions(contract);
|
|
const capture = createEvidenceToolHandler(
|
|
server,
|
|
async (rawInput, options) => {
|
|
const parsed = contract.inputSchema.safeParse(rawInput);
|
|
if (!parsed.success)
|
|
return err(
|
|
analysisInputErrorFromIssues(
|
|
contract.name,
|
|
parsed.error.issues,
|
|
rawInput,
|
|
{ cause: parsed.error },
|
|
),
|
|
);
|
|
const { detail, ...input } = parsed.data;
|
|
const retention = { recordEvidence, evidenceById };
|
|
if (detail === "summary") {
|
|
const ready = requireAnalysisViewRetention(contract.name, retention);
|
|
if (!ready.ok) return ready;
|
|
}
|
|
const result = await service.execute(contract.name, input, options);
|
|
return detail === "summary" && result.ok
|
|
? summarizeRetainedAnalysis(result.value, retention)
|
|
: result;
|
|
},
|
|
logger,
|
|
recordEvidence,
|
|
withAdmittedAnalysis,
|
|
);
|
|
server.registerTool(
|
|
contract.name,
|
|
{
|
|
...registration,
|
|
inputSchema: applicationValidatedInputSchema(registration.inputSchema),
|
|
},
|
|
capture(contract),
|
|
);
|
|
};
|