Files
reverse-engineering-anything/src/cli/webRuntimeCommands.ts
T
Ysopwnableandgensokyo-dev 4ea24b6f8e refactor(cli): derive build catalogs from the REA command registry
Read CLI catalogs and registrar ownership from the REA command records, type-check the catalog helper and consolidate registrar types. Preserve the generated catalogs, mapping and CLI parity.

Co-authored-by: gensokyo-dev <342580529+gensokyo-dev@users.noreply.github.com>
2026-11-16 18:57:12 +08:00

102 lines
3.3 KiB
TypeScript

import type { CliInstance } from "./types.js";
import type { Logger } from "pino";
import type { WebRuntimeService } from "../application/WebRuntimeService.js";
import type { ExecutionOptions } from "../ports/AnalysisProvider.js";
import { createWebRuntimeService } from "../composition/webRuntime.js";
import { WEB_RUNTIME_TOOL_CONTRACTS } from "../contracts/webRuntimeToolContracts.js";
import type { AnalysisError } from "../domain/analysisErrorBase.js";
import type { Evidence } from "../domain/evidence.js";
import type { Result } from "../domain/result.js";
import { browserTargetProjection } from "./browserContractCommands.js";
import { cliProgressReporter } from "./cliProgress.js";
import { contractNamed } from "./contractCliDescription.js";
import {
registerContractCommand,
type ContractCommandContext,
} from "./contractCommand.js";
import { finishAnalysisCommand } from "./finishAnalysisCommand.js";
import { projectCliAnalysisResult } from "./projectCliAnalysisResult.js";
const targetFields = {
...browserTargetProjection.fields,
cdp_endpoint: {
name: "endpoint",
description: "Existing loopback browser CDP endpoint",
},
target_id: {
description: "Selected page target ID from list-browser-targets",
},
} as const;
/** Register public equivalents of the two modular website runtime tools. */
export const registerWebRuntimeCommands = (
cli: CliInstance,
logger: Logger,
): void => {
registerContractCommand(
cli,
logger,
contractNamed(WEB_RUNTIME_TOOL_CONTRACTS, "observe_web_execution"),
{
description:
"Observe precise page execution; resets counters and temporarily disables optimization",
positionals: browserTargetProjection.positionals,
fields: {
...targetFields,
observation_ms: { description: "Observation duration in milliseconds" },
},
},
throughWebRuntime((service, input, options) =>
service.observe(input, { ...options, progress: cliProgressReporter }),
),
);
registerContractCommand(
cli,
logger,
contractNamed(WEB_RUNTIME_TOOL_CONTRACTS, "inspect_web_event_listeners"),
{
description:
"Inspect native listener source locations on the first main-document CSS match",
positionals: [...browserTargetProjection.positionals, "selector"],
fields: {
...targetFields,
selector: {
description:
"Native CSS selector; inspect the first main-document match",
},
},
},
throughWebRuntime((service, input, options) =>
service.inspect(input, options),
),
);
};
/**
* Run one web runtime operation with a disposable service, whose contract
* parse admits the input, and await its provider's close.
*/
const throughWebRuntime =
(
run: (
service: WebRuntimeService,
input: unknown,
options: ExecutionOptions,
) => Promise<Result<Evidence, AnalysisError>>,
) =>
async (input: unknown, { operation, signal }: ContractCommandContext) => {
const service = createWebRuntimeService();
return finishAnalysisCommand(
() => run(service, input, { signal }),
{
close: async () => {
await service.provider.close?.();
},
},
service.provider.identity().id,
operation,
signal,
).then(projectCliAnalysisResult);
};