Skip to content

Make stagehand.init the first runtime RPC #2461

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
miguelg719 wants to merge 7 commits into
base: v4-spike
Choose a base branch
from
Open

Make stagehand.init the first runtime RPC #2461

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
59c3589
Make stagehand.init the first runtime RPC
miguelg719 Jul 27, 2026
30a7788
Cover init handoff contracts
miguelg719 Jul 27, 2026
80de813
Merge remote-tracking branch 'stagehand/v4-spike' into feat/stagehand…
miguelg719 Jul 27, 2026
82b8765
Remove public browser connection status RPC
miguelg719 Jul 27, 2026
1d037f1
Format resident browser initialization
miguelg719 Jul 27, 2026
1451d8c
Sort generated protocol imports
miguelg719 Jul 27, 2026
f732df4
Harden Stagehand initialization boundaries
miguelg719 Jul 27, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
39 changes: 0 additions & 39 deletions packages/docs/v4/reference/stagehand.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -61,26 +61,6 @@ const status = await stagehand.ping();
</ResponseField>
</ResponseField>

## runtimeLoopbackStatus()

Inspect the runtime loopback connection status.

```typescript
const status = await stagehand.runtimeLoopbackStatus();
```

<ResponseField name="result" type="Promise<RuntimeLoopbackStatusResult>">
The operation result.

<ResponseField name="result.configured" type="boolean">
Whether loopback is configured.
</ResponseField>

<ResponseField name="result.connected" type="boolean">
Whether loopback is connected.
</ResponseField>
</ResponseField>

## browserGetVersion()

Read version information from the connected browser.
Expand Down Expand Up @@ -544,25 +524,6 @@ status = await stagehand.ping()
</ResponseField>
</ResponseField>

## runtime_loopback_status()

Inspect the runtime loopback connection status.

```python
status = await stagehand.runtime_loopback_status()
```

<ResponseField name="result" type="RuntimeLoopbackStatusResult">
The operation result.

<ResponseField name="result.configured" type="bool">
Whether loopback is configured.
</ResponseField>

<ResponseField name="result.connected" type="bool">
Whether loopback is connected.
</ResponseField>
</ResponseField>

## browser_get_version()

Expand Down
13 changes: 0 additions & 13 deletions packages/protocol/schema-registry.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -89,9 +89,6 @@ import {
PageWaitForSelectorParamsSchema,
PageWaitForSelectorResultSchema,
PageWaitForTimeoutParamsSchema,
RuntimeConfigureParamsSchema,
RuntimeConfigureResultSchema,
RuntimeLoopbackStatusResultSchema,
StagehandActParamsSchema,
StagehandCloseResultSchema,
StagehandExtractParamsSchema,
Expand All @@ -111,16 +108,6 @@ export const StagehandSendToHostBindingSchema = z

export const StagehandMethods = {
ping: { name: "ping", params: EmptyParamsSchema, result: StagehandPingResultSchema },
runtimeConfigure: {
name: "runtime.configure",
params: RuntimeConfigureParamsSchema,
result: RuntimeConfigureResultSchema,
},
runtimeLoopbackStatus: {
name: "runtime.loopback_status",
params: EmptyParamsSchema,
result: RuntimeLoopbackStatusResultSchema,
},
browserGetVersion: {
name: "browser.get_version",
params: EmptyParamsSchema,
Expand Down
30 changes: 4 additions & 26 deletions packages/protocol/schemas.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1404,10 +1404,14 @@ export const TelemetryConfigSchema = z

export const StagehandInitParamsSchema = z
.object({
protocolVersion: z.literal(STAGEHAND_PROTOCOL_VERSION),
clientInfo: ImplementationInfoSchema,
browserCdpUrl: z.string().min(1).optional(),
apiKey: z.string().min(1).optional(),
browser: BrowserbaseBrowserSourceSchema.optional(),
model: z.union([ModelConfigSchema, ClientModelReferenceSchema]).optional(),
telemetry: TelemetryConfigSchema.default(DEFAULT_TELEMETRY_CONFIG),
logLevel: z.enum(["off", "error", "warn", "info", "debug"]).default("info"),
systemPrompt: z.string().optional(),
selfHeal: z.boolean().optional(),
domSettleTimeoutMs: z.number().int().positive().optional(),
Expand All @@ -1419,17 +1423,6 @@ export const StagehandInitParamsSchema = z
.strict()
.meta({ id: "StagehandInitParams" });

export const RuntimeConfigureParamsSchema = z
.object({
protocolVersion: z.int().positive().optional(),
clientInfo: ImplementationInfoSchema.optional(),
cdpUrl: z.string().min(1),
telemetry: TelemetryConfigSchema.default(DEFAULT_TELEMETRY_CONFIG),
logLevel: z.enum(["off", "error", "warn", "info", "debug"]).default("info"),
})
.strict()
.meta({ id: "RuntimeConfigureParams" });

export const StagehandActParamsSchema = z
.object({
pageId: z.string().min(1),
Expand Down Expand Up @@ -1863,21 +1856,6 @@ export const StagehandPingResultSchema = z
.strict()
.meta({ id: "StagehandPingResult" });

export const RuntimeConfigureResultSchema = z
.object({
configured: z.literal(true),
})
.strict()
.meta({ id: "RuntimeConfigureResult" });

export const RuntimeLoopbackStatusResultSchema = z
.object({
configured: z.boolean(),
connected: z.boolean(),
})
.strict()
.meta({ id: "RuntimeLoopbackStatusResult" });

export const BrowserGetVersionResultSchema = z
.object({
protocolVersion: z.string().optional(),
Expand Down
Loading
Loading