@jshookmcp/jshook 0.2.8 → 0.3.0

package/dist/manifest-DJ2vfEuW.mjs

@@ -0,0 +1,156 @@
+import { n as toolLookup } from "./registry-Bl8ZQW61.mjs";
+import { n as defineMethodRegistrations } from "./bind-helpers-ClV34xdn.mjs";
+import { t as tool } from "./tool-builder-BHJp32mV.mjs";
+//#region src/server/domains/syscall-hook/definitions.ts
+const BACKEND_OPTIONS = [
+	"etw",
+	"strace",
+	"dtrace"
+];
+const SYSCALL_EVENT_SCHEMA = {
+	type: "object",
+	properties: {
+		timestamp: {
+			type: "number",
+			description: "Relative elapsed time in milliseconds since bpftrace start"
+		},
+		pid: {
+			type: "number",
+			description: "Process identifier"
+		},
+		syscall: {
+			type: "string",
+			description: "Observed syscall name"
+		},
+		args: {
+			type: "array",
+			description: "Stringified syscall arguments",
+			items: { type: "string" }
+		},
+		returnValue: {
+			type: "number",
+			description: "Numeric syscall return value if available"
+		},
+		duration: {
+			type: "number",
+			description: "Execution duration in milliseconds if available"
+		}
+	},
+	required: [
+		"timestamp",
+		"pid",
+		"syscall",
+		"args"
+	]
+};
+const syscallHookToolDefinitions = [
+	tool("syscall_start_monitor", (t) => t.desc("Start syscall monitoring using ETW, strace, or dtrace.").enum("backend", BACKEND_OPTIONS, "Syscall capture backend").number("pid", "Optional PID to scope monitoring to a single process").boolean("simulate", "Use synthetic events instead of a real system tracer", { default: false }).required("backend")),
+	tool("syscall_stop_monitor", (t) => t.desc("Stop syscall monitoring.").idempotent()),
+	tool("syscall_capture_events", (t) => t.desc("Capture syscall events from the active or last monitoring session.").prop("filter", {
+		type: "object",
+		description: "Optional event filter",
+		properties: {
+			name: {
+				type: "array",
+				description: "Restrict events to specific syscall names",
+				items: { type: "string" }
+			},
+			pid: {
+				type: "number",
+				description: "Restrict events to a specific process ID"
+			}
+		}
+	}).query()),
+	tool("syscall_correlate_js", (t) => t.desc("Correlate captured syscalls with likely JavaScript functions.").array("syscallEvents", SYSCALL_EVENT_SCHEMA, "Syscall events to correlate").required("syscallEvents").query()),
+	tool("syscall_filter", (t) => t.desc("Filter captured syscall events by syscall name.").array("names", { type: "string" }, "Syscall names to keep").query()),
+	tool("syscall_get_stats", (t) => t.desc("Get syscall monitoring statistics.").query()),
+	tool("syscall_ebpf_trace", (t) => t.desc("Trace syscalls via Linux eBPF/bpftrace. Requires root or CAP_BPF.").number("pid", "Process ID to trace. 0 = trace all.", { default: 0 }).array("syscalls", { type: "string" }, "Specific syscall names to trace (empty = all)").number("durationSec", "Trace duration in seconds", {
+		default: 10,
+		minimum: 1,
+		maximum: 300
+	}).boolean("simulate", "Use synthetic events when bpftrace is unavailable", { default: false }).query())
+];
+//#endregion
+//#region src/server/domains/syscall-hook/manifest.ts
+const DOMAIN = "syscall-hook";
+const DEP_KEY = "syscallHookHandlers";
+const registrations = defineMethodRegistrations({
+	domain: DOMAIN,
+	depKey: DEP_KEY,
+	lookup: toolLookup(syscallHookToolDefinitions),
+	entries: [
+		{
+			tool: "syscall_start_monitor",
+			method: "handleSyscallStartMonitor"
+		},
+		{
+			tool: "syscall_stop_monitor",
+			method: "handleSyscallStopMonitor"
+		},
+		{
+			tool: "syscall_capture_events",
+			method: "handleSyscallCaptureEvents"
+		},
+		{
+			tool: "syscall_correlate_js",
+			method: "handleSyscallCorrelateJs"
+		},
+		{
+			tool: "syscall_filter",
+			method: "handleSyscallFilter"
+		},
+		{
+			tool: "syscall_get_stats",
+			method: "handleSyscallGetStats"
+		},
+		{
+			tool: "syscall_ebpf_trace",
+			method: "handleSyscallEbpfTrace"
+		}
+	]
+});
+async function ensure(ctx) {
+	const { SyscallHookHandlers } = await import("./handlers-4jmR0nMs.mjs");
+	const existing = ctx.getDomainInstance(DEP_KEY);
+	if (existing) return existing;
+	const handlers = new SyscallHookHandlers(void 0, void 0, ctx.eventBus);
+	ctx.setDomainInstance(DEP_KEY, handlers);
+	return handlers;
+}
+const manifest = {
+	kind: "domain-manifest",
+	version: 1,
+	domain: DOMAIN,
+	depKey: DEP_KEY,
+	profiles: ["full"],
+	ensure,
+	registrations,
+	workflowRule: {
+		patterns: [/\b(syscall|etw|strace|dtrace|kernel|system\s?call)\b/i, /(syscall|kernel).*(trace|monitor|capture|filter)/i],
+		priority: 78,
+		tools: [
+			"syscall_start_monitor",
+			"syscall_capture_events",
+			"syscall_correlate_js"
+		],
+		hint: "Syscall tracing: start monitor (ETW/strace/dtrace) → capture events → correlate with JS stacks."
+	},
+	prerequisites: {
+		syscall_start_monitor: [{
+			condition: "Administrator/root privileges required for ETW and dtrace; Linux strace needs ptrace_scope=0",
+			fix: "Run the MCP server with elevated privileges, or relax kernel restrictions on Linux"
+		}],
+		syscall_correlate_js: [{
+			condition: "A debugger or v8-inspector session must expose JS stacks",
+			fix: "Attach the debugger or v8-inspector domain before correlating"
+		}]
+	},
+	toolDependencies: [{
+		from: "memory",
+		to: "syscall-hook",
+		relation: "uses",
+		weight: .5
+	}]
+};
+//#endregion
+export { manifest as default };

package/dist/manifest-DPXDYhEu.mjs

@@ -0,0 +1,80 @@
+import { n as toolLookup } from "./registry-Bl8ZQW61.mjs";
+import { n as defineMethodRegistrations } from "./bind-helpers-ClV34xdn.mjs";
+import { t as tool } from "./tool-builder-BHJp32mV.mjs";
+import { resolve } from "node:path";
+//#region src/server/domains/evidence/definitions.ts
+const evidenceTools = [
+	tool("evidence_query", (t) => t.desc("Query reverse evidence graph by URL, function name, or script ID to find associated nodes.").enum("by", [
+		"url",
+		"function",
+		"script"
+	], "Query dimension").string("value", "Search value: URL/fragment, function name, or script ID").required("by", "value").query()),
+	tool("evidence_export", (t) => t.desc("Export the reverse evidence graph as JSON snapshot or Markdown report.").enum("format", ["json", "markdown"], "Export format").required("format").query()),
+	tool("evidence_chain", (t) => t.desc("Get full provenance chain from a node ID in specified direction").string("nodeId", "Evidence node ID to start from").enum("direction", ["forward", "backward"], "Traversal direction", { default: "forward" }).required("nodeId").query())
+];
+//#endregion
+//#region src/server/domains/evidence/manifest.ts
+const DOMAIN = "evidence";
+const DEP_KEY = "evidenceHandlers";
+const registrations = defineMethodRegistrations({
+	domain: DOMAIN,
+	depKey: DEP_KEY,
+	lookup: toolLookup(evidenceTools),
+	entries: [
+		{
+			tool: "evidence_query",
+			method: "handleQueryDispatch"
+		},
+		{
+			tool: "evidence_export",
+			method: "handleExportDispatch"
+		},
+		{
+			tool: "evidence_chain",
+			method: "handleChain"
+		}
+	]
+});
+async function ensure(ctx) {
+	const { ReverseEvidenceGraph } = await import("./ReverseEvidenceGraph-C02-gXOh.mjs").then((n) => n.t);
+	const { EvidenceGraphBridge } = await import("./EvidenceGraphBridge-318Oi0Lf.mjs");
+	const { EvidenceHandlers } = await import("./handlers-Bndn6QvE.mjs");
+	let graph = ctx.getDomainInstance("evidenceGraph");
+	if (!graph) {
+		graph = new ReverseEvidenceGraph();
+		graph.setEventBus(ctx.eventBus);
+		ctx.setDomainInstance("evidenceGraph", graph);
+	}
+	let bridge = ctx.getDomainInstance("evidenceGraphBridge");
+	if (!bridge) {
+		bridge = new EvidenceGraphBridge(graph);
+		ctx.setDomainInstance("evidenceGraphBridge", bridge);
+	}
+	ctx.getDomainInstance("instrumentationSessionManager")?.setEvidenceBridge(bridge);
+	if (!ctx.evidenceHandlers) ctx.evidenceHandlers = new EvidenceHandlers(graph);
+	const scheduler = ctx.getDomainInstance("snapshotScheduler");
+	const stateDir = ctx.getDomainInstance("snapshotStateDir");
+	graph.setPersistNotifier(scheduler ? () => scheduler.notifyDirty() : void 0);
+	if (scheduler && stateDir && !ctx.getDomainInstance("evidenceGraphSnapshotRegistered")) {
+		scheduler.register(resolve(stateDir, "evidence-graph", "current.json"), graph);
+		ctx.setDomainInstance("evidenceGraphSnapshotRegistered", true);
+	}
+	return ctx.evidenceHandlers;
+}
+const manifest = {
+	kind: "domain-manifest",
+	version: 1,
+	domain: DOMAIN,
+	depKey: DEP_KEY,
+	profiles: ["full"],
+	ensure,
+	workflowRule: {
+		patterns: [/(evidence|provenance|chain).*(graph|query|export|report)/i, /(证据|溯源|链).*(图|查询|导出|报告)/i],
+		priority: 90,
+		tools: ["evidence_query", "evidence_export"],
+		hint: "Evidence graph: query by URL/function/scriptId → get provenance chain → export as JSON or Markdown report"
+	},
+	registrations
+};
+//#endregion
+export { manifest as default };

package/dist/manifest-Dd4fQb0a.mjs

@@ -0,0 +1,322 @@
+import { n as toolLookup, t as ensureBrowserCore } from "./registry-Bl8ZQW61.mjs";
+import { n as defineMethodRegistrations } from "./bind-helpers-ClV34xdn.mjs";
+import { n as advancedBrowserToolDefinitions, t as browserTools } from "./definitions-BRaefg3u.mjs";
+//#region src/server/domains/browser/manifest.ts
+const DOMAIN = "browser";
+const DEP_KEY = "browserHandlers";
+const registrations = defineMethodRegistrations({
+	domain: DOMAIN,
+	depKey: DEP_KEY,
+	lookup: toolLookup([...browserTools, ...advancedBrowserToolDefinitions]),
+	entries: [
+		{
+			tool: "get_detailed_data",
+			method: "handleGetDetailedData"
+		},
+		{
+			tool: "browser_attach",
+			method: "handleBrowserAttach"
+		},
+		{
+			tool: "browser_list_tabs",
+			method: "handleBrowserListTabs"
+		},
+		{
+			tool: "browser_list_cdp_targets",
+			method: "handleBrowserListCdpTargets"
+		},
+		{
+			tool: "browser_select_tab",
+			method: "handleBrowserSelectTab"
+		},
+		{
+			tool: "browser_attach_cdp_target",
+			method: "handleBrowserAttachCdpTarget"
+		},
+		{
+			tool: "browser_detach_cdp_target",
+			method: "handleBrowserDetachCdpTarget"
+		},
+		{
+			tool: "browser_evaluate_cdp_target",
+			method: "handleBrowserEvaluateCdpTarget"
+		},
+		{
+			tool: "browser_launch",
+			method: "handleBrowserLaunch"
+		},
+		{
+			tool: "browser_close",
+			method: "handleBrowserClose"
+		},
+		{
+			tool: "browser_status",
+			method: "handleBrowserStatus"
+		},
+		{
+			tool: "page_navigate",
+			method: "handlePageNavigate"
+		},
+		{
+			tool: "page_reload",
+			method: "handlePageReload"
+		},
+		{
+			tool: "page_back",
+			method: "handlePageBack"
+		},
+		{
+			tool: "page_forward",
+			method: "handlePageForward"
+		},
+		{
+			tool: "page_click",
+			method: "handlePageClick"
+		},
+		{
+			tool: "page_type",
+			method: "handlePageType"
+		},
+		{
+			tool: "page_select",
+			method: "handlePageSelect"
+		},
+		{
+			tool: "page_hover",
+			method: "handlePageHover"
+		},
+		{
+			tool: "page_scroll",
+			method: "handlePageScroll"
+		},
+		{
+			tool: "page_wait_for_selector",
+			method: "handlePageWaitForSelector"
+		},
+		{
+			tool: "page_evaluate",
+			method: "handlePageEvaluate"
+		},
+		{
+			tool: "page_screenshot",
+			method: "handlePageScreenshot"
+		},
+		{
+			tool: "get_all_scripts",
+			method: "handleGetAllScripts"
+		},
+		{
+			tool: "get_script_source",
+			method: "handleGetScriptSource"
+		},
+		{
+			tool: "console_monitor",
+			method: "handleConsoleMonitor"
+		},
+		{
+			tool: "console_get_logs",
+			method: "handleConsoleGetLogs"
+		},
+		{
+			tool: "console_execute",
+			method: "handleConsoleExecute"
+		},
+		{
+			tool: "page_inject_script",
+			method: "handlePageInjectScript"
+		},
+		{
+			tool: "page_cookies",
+			method: "handlePageCookiesDispatch"
+		},
+		{
+			tool: "page_set_viewport",
+			method: "handlePageSetViewport"
+		},
+		{
+			tool: "page_emulate_device",
+			method: "handlePageEmulateDevice"
+		},
+		{
+			tool: "page_local_storage",
+			method: "handlePageLocalStorageDispatch"
+		},
+		{
+			tool: "page_press_key",
+			method: "handlePagePressKey"
+		},
+		{
+			tool: "captcha_detect",
+			method: "handleCaptchaDetect"
+		},
+		{
+			tool: "captcha_wait",
+			method: "handleCaptchaWait"
+		},
+		{
+			tool: "captcha_config",
+			method: "handleCaptchaConfig"
+		},
+		{
+			tool: "stealth_inject",
+			method: "handleStealthInject"
+		},
+		{
+			tool: "stealth_set_user_agent",
+			method: "handleStealthSetUserAgent"
+		},
+		{
+			tool: "stealth_configure_jitter",
+			method: "handleStealthConfigureJitter"
+		},
+		{
+			tool: "stealth_generate_fingerprint",
+			method: "handleStealthGenerateFingerprint"
+		},
+		{
+			tool: "stealth_verify",
+			method: "handleStealthVerify"
+		},
+		{
+			tool: "camoufox_geolocation",
+			method: "handleCamoufoxGeolocation"
+		},
+		{
+			tool: "camoufox_server",
+			method: "handleCamoufoxServerDispatch"
+		},
+		{
+			tool: "framework_state_extract",
+			method: "handleFrameworkStateExtract"
+		},
+		{
+			tool: "indexeddb_dump",
+			method: "handleIndexedDBDump"
+		},
+		{
+			tool: "js_heap_search",
+			method: "handleJSHeapSearch"
+		},
+		{
+			tool: "tab_workflow",
+			method: "handleTabWorkflow"
+		},
+		{
+			tool: "human_mouse",
+			method: "handleHumanMouse"
+		},
+		{
+			tool: "human_scroll",
+			method: "handleHumanScroll"
+		},
+		{
+			tool: "human_typing",
+			method: "handleHumanTyping"
+		},
+		{
+			tool: "captcha_solver_capabilities",
+			method: "handleCaptchaSolverCapabilities"
+		},
+		{
+			tool: "captcha_vision_solve",
+			method: "handleCaptchaVisionSolve"
+		},
+		{
+			tool: "widget_challenge_solve",
+			method: "handleWidgetChallengeSolve"
+		},
+		{
+			tool: "browser_jsdom_parse",
+			method: "handleJsdomParse"
+		},
+		{
+			tool: "browser_jsdom_query",
+			method: "handleJsdomQuery"
+		},
+		{
+			tool: "browser_jsdom_execute",
+			method: "handleJsdomExecute"
+		},
+		{
+			tool: "browser_jsdom_serialize",
+			method: "handleJsdomSerialize"
+		},
+		{
+			tool: "browser_jsdom_cookies",
+			method: "handleJsdomCookies"
+		}
+	]
+});
+async function ensure(ctx) {
+	const { BrowserToolHandlers } = await import("./browser-Dx3_S2cG.mjs");
+	await ensureBrowserCore(ctx);
+	if (!ctx.browserHandlers) ctx.browserHandlers = new BrowserToolHandlers(ctx.collector, ctx.pageController, ctx.scriptManager, ctx.consoleMonitor, ctx.eventBus);
+	return ctx.browserHandlers;
+}
+const manifest = {
+	kind: "domain-manifest",
+	version: 1,
+	domain: DOMAIN,
+	depKey: DEP_KEY,
+	profiles: ["workflow", "full"],
+	ensure,
+	workflowRule: {
+		patterns: [/(browser|page|navigate|screenshot|click|type|scrape)/i, /(浏览器|页面|导航|截图|点击|输入|爬取)/i],
+		priority: 90,
+		tools: [
+			"page_navigate",
+			"page_evaluate",
+			"browser_jsdom_parse",
+			"console_get_logs",
+			"page_click",
+			"page_type",
+			"page_screenshot"
+		],
+		hint: "Browser automation workflow: bootstrap browser/page state -> inspect page state -> interact -> capture visual evidence only when needed"
+	},
+	prerequisites: {
+		page_navigate: [{
+			condition: "Browser must be launched",
+			fix: "Call browser_launch or browser_attach first"
+		}],
+		page_click: [{
+			condition: "Browser must be launched",
+			fix: "Call browser_launch or browser_attach first"
+		}],
+		page_type: [{
+			condition: "Browser must be launched",
+			fix: "Call browser_launch or browser_attach first"
+		}],
+		page_screenshot: [{
+			condition: "Browser must be launched",
+			fix: "Call browser_launch or browser_attach first"
+		}],
+		page_evaluate: [{
+			condition: "Browser must be launched",
+			fix: "Call browser_launch or browser_attach first"
+		}],
+		page_hover: [{
+			condition: "Browser must be launched",
+			fix: "Call browser_launch or browser_attach first"
+		}],
+		page_back: [{
+			condition: "Browser must be launched",
+			fix: "Call browser_launch or browser_attach first"
+		}],
+		page_forward: [{
+			condition: "Browser must be launched",
+			fix: "Call browser_launch or browser_attach first"
+		}],
+		page_reload: [{
+			condition: "Browser must be launched",
+			fix: "Call browser_launch or browser_attach first"
+		}],
+		page_scroll: [{
+			condition: "Browser must be launched",
+			fix: "Call browser_launch or browser_attach first"
+		}]
+	},
+	registrations
+};
+//#endregion
+export { manifest as default };