Files
reverse-engineering-anything/src/domain/webMcpDiscovery.ts
T
Ryan S 9d0e87f331 feat(browser): reuse admitted browser-socket transport and allow discovery_timeout_ms (#9203)
* feat(browser): reuse admitted browser-socket transport and allow discovery_timeout_ms

* fix(browser): close unhealthy shared sockets and clamp max discovery timer

* fix(browser): retry failed shared-socket cleanup while peer leases remain active

* test(browser): race observation readiness with awaitAcknowledgement and join before mock restore

* fix(browser): isolate shared-socket discovery aborts and coalesce cold connects

* fix(browser): observe pending cold-connect cleanup failures and isolate fake CDP sessions

* refactor(browser): carry typed connect cleanup owners and gate concurrent session test

* test(browser): cover loopback socket reuse-key normalization

* test(browser): verify distinct browser socket path IDs stay separate
2026-11-08 23:06:56 +00:00

75 lines
2.5 KiB
TypeScript

import { z } from "zod";
import {
browserDiscoveryTimeoutSchema,
webRuntimeCommandTimeoutSchema,
} from "./browserDeadline.js";
import { browserCompletenessSchema } from "./browserCompleteness.js";
import {
browserAllowedOriginsSchema,
browserObservationEndpointSchema,
} from "./browserObservation.js";
import { browserVersionSchema } from "./browserObservationSchemas.js";
import { cdpResourceColumnSchema } from "./cdpObservationSchemas.js";
import { jsonValueSchema } from "./jsonValue.js";
import { digestSchema, prefixedDigestSchema } from "./../domain/digests.js";
/** Input for passive discovery of page-registered WebMCP tools. */
export const discoverWebMcpToolsInputSchema = z.strictObject({
cdp_endpoint: browserObservationEndpointSchema,
allowed_origins: browserAllowedOriginsSchema,
discovery_timeout_ms: browserDiscoveryTimeoutSchema,
target_id: z.string().min(1),
observation_ms: z.int().min(0).default(100),
command_timeout_ms: webRuntimeCommandTimeoutSchema,
});
export type DiscoverWebMcpToolsInput = z.infer<
typeof discoverWebMcpToolsInputSchema
>;
const webMcpToolSchema = z.object({
tool_key: prefixedDigestSchema("webmcp"),
name: z.string(),
description: z.string(),
frame_id: z.string(),
frame_url: z.string(),
owner_origin: z.string(),
declaration_kind: z.enum(["declarative", "imperative"]),
input_schema: jsonValueSchema.nullable(),
input_schema_sha256: digestSchema.nullable(),
annotations: z.object({
read_only: z.boolean().nullable(),
untrusted_content: z.boolean().nullable(),
// Absent when this annotation was not recorded or its protocol value was invalid; null
// distinguishes a declaration that omitted it from a declared false.
consequential: z.boolean().nullable().optional(),
autosubmit: z.boolean().nullable(),
}),
registration_source: z
.object({
url: z.string(),
line: z.int().min(0).nullable(),
column: cdpResourceColumnSchema.nullable(),
})
.nullable(),
trust: z.literal("page-declared-untrusted"),
});
/** Passive WebMCP inventory; it intentionally has no invocation surface. */
export const webMcpDiscoverySchema = z.object({
browser: browserVersionSchema,
target: z.object({
target_id: z.string(),
url: z.string(),
origin: z.string(),
}),
status: z.enum(["available", "unavailable"]),
tools: z.object({
total: z.int().min(0),
items: z.array(webMcpToolSchema),
}),
completeness: browserCompletenessSchema,
limitations: z.array(z.string()),
});
export type WebMcpDiscovery = z.infer<typeof webMcpDiscoverySchema>;