@browserbasehq/stagehand
Version:
Browserbase's SDK for building browser agents
5,348 lines • 211 kB
text/typescript
import { z } from "zod/v4";
import Browserbase, { ClientOptions } from "@browserbasehq/sdk";
//#region ../protocol/json-rpc/wire-casing.d.ts
type WireCasingOptions = {
/** API-side container keys whose nested, user-controlled keys must retain their casing. */readonly opaqueKeys?: readonly string[];
/**
* API-side container keys whose nested fields use normal protocol casing,
* even when the key is opaque by default.
*/
readonly transformKeys?: readonly string[];
};
//#endregion
//#region ../protocol/json-rpc/schemas.d.ts
declare const JSONRPCRequestSchema: z.ZodObject<{
jsonrpc: z.ZodLiteral<"2.0">;
id: z.ZodInt;
method: z.ZodString;
params: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodJSONSchema>, z.ZodRecord<z.ZodString, z.ZodJSONSchema>]>>;
traceparent: z.ZodOptional<z.ZodString>;
tracestate: z.ZodOptional<z.ZodString>;
}, z.core.$strict>;
declare const JSONRPCResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
jsonrpc: z.ZodLiteral<"2.0">;
result: z.ZodJSONSchema;
id: z.ZodInt;
}, z.core.$strict>, z.ZodObject<{
jsonrpc: z.ZodLiteral<"2.0">;
error: z.ZodObject<{
code: z.ZodInt;
message: z.ZodString;
data: z.ZodOptional<z.ZodJSONSchema>;
}, z.core.$strict>;
id: z.ZodUnion<readonly [z.ZodInt, z.ZodNull]>;
}, z.core.$strict>]>;
declare const JSONRPCMessageSchema: z.ZodUnion<readonly [z.ZodObject<{
jsonrpc: z.ZodLiteral<"2.0">;
id: z.ZodInt;
method: z.ZodString;
params: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodJSONSchema>, z.ZodRecord<z.ZodString, z.ZodJSONSchema>]>>;
traceparent: z.ZodOptional<z.ZodString>;
tracestate: z.ZodOptional<z.ZodString>;
}, z.core.$strict>, z.ZodObject<{
jsonrpc: z.ZodLiteral<"2.0">;
method: z.ZodString;
params: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodJSONSchema>, z.ZodRecord<z.ZodString, z.ZodJSONSchema>]>>;
}, z.core.$strict>, z.ZodUnion<readonly [z.ZodObject<{
jsonrpc: z.ZodLiteral<"2.0">;
result: z.ZodJSONSchema;
id: z.ZodInt;
}, z.core.$strict>, z.ZodObject<{
jsonrpc: z.ZodLiteral<"2.0">;
error: z.ZodObject<{
code: z.ZodInt;
message: z.ZodString;
data: z.ZodOptional<z.ZodJSONSchema>;
}, z.core.$strict>;
id: z.ZodUnion<readonly [z.ZodInt, z.ZodNull]>;
}, z.core.$strict>]>]>;
type RPCMethod = {
name: string;
params: z.ZodType;
result: z.ZodType;
paramsWire?: WireCasingOptions;
resultWire?: WireCasingOptions;
};
//#endregion
//#region ../protocol/schema-registry.d.ts
declare const StagehandMethods: {
readonly stagehandInit: {
readonly name: "stagehand.init";
readonly params: z.ZodObject<{
protocolVersion: z.ZodString;
clientInfo: z.ZodObject<{
name: z.ZodString;
version: z.ZodString;
}, z.core.$strict>;
browserCdpUrl: z.ZodOptional<z.ZodString>;
browserbase: z.ZodOptional<z.ZodLiteral<"client">>;
browser: z.ZodOptional<z.ZodObject<{
sessionId: z.ZodString;
region: z.ZodOptional<z.ZodEnum<{
"us-west-2": "us-west-2";
"us-east-1": "us-east-1";
"eu-central-1": "eu-central-1";
"ap-southeast-1": "ap-southeast-1";
}>>;
}, z.core.$strict>>;
model: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
apiKey: z.ZodOptional<z.ZodString>;
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
modelName: z.ZodUnion<readonly [z.ZodTemplateLiteral<`openai/${string}`>, z.ZodTemplateLiteral<`anthropic/${string}`>, z.ZodTemplateLiteral<`google/${string}`>, z.ZodTemplateLiteral<`groq/${string}`>, z.ZodTemplateLiteral<`cerebras/${string}`>]>;
}, z.core.$strict>, z.ZodObject<{
source: z.ZodLiteral<"client">;
}, z.core.$strict>]>>;
telemetry: z.ZodOptional<z.ZodObject<{
traces: z.ZodObject<{
endpoint: z.ZodURL;
headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
}, z.core.$strict>;
}, z.core.$strict>>;
logLevel: z.ZodDefault<z.ZodEnum<{
error: "error";
off: "off";
warn: "warn";
info: "info";
debug: "debug";
}>>;
systemPrompt: z.ZodOptional<z.ZodString>;
selfHeal: z.ZodOptional<z.ZodBoolean>;
domSettleTimeoutMs: z.ZodOptional<z.ZodNumber>;
cache: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
threshold: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>]>>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
initialized: z.ZodLiteral<true>;
pages: z.ZodArray<z.ZodObject<{
pageId: z.ZodString;
url: z.ZodOptional<z.ZodString>;
title: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>;
};
readonly stagehandClose: {
readonly name: "stagehand.close";
readonly params: z.ZodObject<{}, z.core.$strict>;
readonly result: z.ZodObject<{
closed: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly stagehandAct: {
readonly name: "stagehand.act";
readonly params: z.ZodObject<{
pageId: z.ZodString;
instruction: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
selector: z.ZodString;
description: z.ZodString;
method: z.ZodOptional<z.ZodString>;
arguments: z.ZodOptional<z.ZodArray<z.ZodString>>;
}, z.core.$strict>]>;
options: z.ZodOptional<z.ZodObject<{
model: z.ZodOptional<z.ZodObject<{
apiKey: z.ZodOptional<z.ZodString>;
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
modelName: z.ZodUnion<readonly [z.ZodTemplateLiteral<`openai/${string}`>, z.ZodTemplateLiteral<`anthropic/${string}`>, z.ZodTemplateLiteral<`google/${string}`>, z.ZodTemplateLiteral<`groq/${string}`>, z.ZodTemplateLiteral<`cerebras/${string}`>]>;
}, z.core.$strict>>;
variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodObject<{
value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
description: z.ZodOptional<z.ZodString>;
}, z.core.$strict>]>>>;
timeout: z.ZodOptional<z.ZodNumber>;
locator: z.ZodOptional<z.ZodObject<{
selector: z.ZodString;
nth: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
ignoreLocators: z.ZodOptional<z.ZodArray<z.ZodObject<{
selector: z.ZodString;
nth: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>>;
cache: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
threshold: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>]>>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
data: z.ZodObject<{
success: z.ZodBoolean;
message: z.ZodString;
actionDescription: z.ZodString;
actions: z.ZodArray<z.ZodObject<{
selector: z.ZodString;
description: z.ZodString;
method: z.ZodOptional<z.ZodString>;
arguments: z.ZodOptional<z.ZodArray<z.ZodString>>;
}, z.core.$strict>>;
}, z.core.$strict>;
metadata: z.ZodObject<{
actionId: z.ZodOptional<z.ZodString>;
cache: z.ZodObject<{
status: z.ZodEnum<{
HIT: "HIT";
MISS: "MISS";
DISABLED: "DISABLED";
}>;
count: z.ZodOptional<z.ZodNumber>;
threshold: z.ZodOptional<z.ZodNumber>;
missReason: z.ZodOptional<z.ZodString>;
tokensSaved: z.ZodOptional<z.ZodObject<{
inputTokens: z.ZodDefault<z.ZodNumber>;
outputTokens: z.ZodDefault<z.ZodNumber>;
totalTokens: z.ZodDefault<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
usage: z.ZodObject<{
inputTokens: z.ZodDefault<z.ZodNumber>;
outputTokens: z.ZodDefault<z.ZodNumber>;
reasoningTokens: z.ZodDefault<z.ZodNumber>;
cachedInputTokens: z.ZodDefault<z.ZodNumber>;
inferenceTimeMs: z.ZodDefault<z.ZodNumber>;
}, z.core.$strict>;
}, z.core.$strict>;
}, z.core.$strict>;
readonly resultWire: {
readonly transformKeys: readonly ["data"];
};
};
readonly stagehandObserve: {
readonly name: "stagehand.observe";
readonly params: z.ZodObject<{
pageId: z.ZodString;
instruction: z.ZodOptional<z.ZodString>;
options: z.ZodOptional<z.ZodObject<{
model: z.ZodOptional<z.ZodObject<{
apiKey: z.ZodOptional<z.ZodString>;
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
modelName: z.ZodUnion<readonly [z.ZodTemplateLiteral<`openai/${string}`>, z.ZodTemplateLiteral<`anthropic/${string}`>, z.ZodTemplateLiteral<`google/${string}`>, z.ZodTemplateLiteral<`groq/${string}`>, z.ZodTemplateLiteral<`cerebras/${string}`>]>;
}, z.core.$strict>>;
variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodObject<{
value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
description: z.ZodOptional<z.ZodString>;
}, z.core.$strict>]>>>;
timeout: z.ZodOptional<z.ZodNumber>;
locator: z.ZodOptional<z.ZodObject<{
selector: z.ZodString;
nth: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
ignoreLocators: z.ZodOptional<z.ZodArray<z.ZodObject<{
selector: z.ZodString;
nth: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>>;
cache: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
threshold: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>]>>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
data: z.ZodArray<z.ZodObject<{
selector: z.ZodString;
description: z.ZodString;
method: z.ZodOptional<z.ZodString>;
arguments: z.ZodOptional<z.ZodArray<z.ZodString>>;
}, z.core.$strict>>;
metadata: z.ZodObject<{
actionId: z.ZodOptional<z.ZodString>;
cache: z.ZodObject<{
status: z.ZodEnum<{
HIT: "HIT";
MISS: "MISS";
DISABLED: "DISABLED";
}>;
count: z.ZodOptional<z.ZodNumber>;
threshold: z.ZodOptional<z.ZodNumber>;
missReason: z.ZodOptional<z.ZodString>;
tokensSaved: z.ZodOptional<z.ZodObject<{
inputTokens: z.ZodDefault<z.ZodNumber>;
outputTokens: z.ZodDefault<z.ZodNumber>;
totalTokens: z.ZodDefault<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
usage: z.ZodObject<{
inputTokens: z.ZodDefault<z.ZodNumber>;
outputTokens: z.ZodDefault<z.ZodNumber>;
reasoningTokens: z.ZodDefault<z.ZodNumber>;
cachedInputTokens: z.ZodDefault<z.ZodNumber>;
inferenceTimeMs: z.ZodDefault<z.ZodNumber>;
}, z.core.$strict>;
}, z.core.$strict>;
}, z.core.$strict>;
readonly resultWire: {
readonly transformKeys: readonly ["data"];
};
};
readonly stagehandExtract: {
readonly name: "stagehand.extract";
readonly params: z.ZodObject<{
pageId: z.ZodString;
instruction: z.ZodString;
schema: z.ZodDefault<z.ZodJSONSchema>;
options: z.ZodOptional<z.ZodObject<{
model: z.ZodOptional<z.ZodObject<{
apiKey: z.ZodOptional<z.ZodString>;
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
modelName: z.ZodUnion<readonly [z.ZodTemplateLiteral<`openai/${string}`>, z.ZodTemplateLiteral<`anthropic/${string}`>, z.ZodTemplateLiteral<`google/${string}`>, z.ZodTemplateLiteral<`groq/${string}`>, z.ZodTemplateLiteral<`cerebras/${string}`>]>;
}, z.core.$strict>>;
timeout: z.ZodOptional<z.ZodNumber>;
locator: z.ZodOptional<z.ZodObject<{
selector: z.ZodString;
nth: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
ignoreLocators: z.ZodOptional<z.ZodArray<z.ZodObject<{
selector: z.ZodString;
nth: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>>;
screenshot: z.ZodOptional<z.ZodBoolean>;
cache: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
threshold: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>]>>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
data: z.ZodJSONSchema;
metadata: z.ZodObject<{
actionId: z.ZodOptional<z.ZodString>;
cache: z.ZodObject<{
status: z.ZodEnum<{
HIT: "HIT";
MISS: "MISS";
DISABLED: "DISABLED";
}>;
count: z.ZodOptional<z.ZodNumber>;
threshold: z.ZodOptional<z.ZodNumber>;
missReason: z.ZodOptional<z.ZodString>;
tokensSaved: z.ZodOptional<z.ZodObject<{
inputTokens: z.ZodDefault<z.ZodNumber>;
outputTokens: z.ZodDefault<z.ZodNumber>;
totalTokens: z.ZodDefault<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
usage: z.ZodObject<{
inputTokens: z.ZodDefault<z.ZodNumber>;
outputTokens: z.ZodDefault<z.ZodNumber>;
reasoningTokens: z.ZodDefault<z.ZodNumber>;
cachedInputTokens: z.ZodDefault<z.ZodNumber>;
inferenceTimeMs: z.ZodDefault<z.ZodNumber>;
}, z.core.$strict>;
}, z.core.$strict>;
}, z.core.$strict>;
readonly paramsWire: {
readonly opaqueKeys: readonly ["schema"];
};
readonly resultWire: {
readonly opaqueKeys: readonly ["data"];
};
};
readonly stagehandMetrics: {
readonly name: "stagehand.metrics";
readonly params: z.ZodObject<{}, z.core.$strict>;
readonly result: z.ZodObject<{
actPromptTokens: z.ZodNumber;
actCompletionTokens: z.ZodNumber;
actReasoningTokens: z.ZodNumber;
actCachedInputTokens: z.ZodNumber;
actInferenceTimeMs: z.ZodNumber;
extractPromptTokens: z.ZodNumber;
extractCompletionTokens: z.ZodNumber;
extractReasoningTokens: z.ZodNumber;
extractCachedInputTokens: z.ZodNumber;
extractInferenceTimeMs: z.ZodNumber;
observePromptTokens: z.ZodNumber;
observeCompletionTokens: z.ZodNumber;
observeReasoningTokens: z.ZodNumber;
observeCachedInputTokens: z.ZodNumber;
observeInferenceTimeMs: z.ZodNumber;
totalPromptTokens: z.ZodNumber;
totalCompletionTokens: z.ZodNumber;
totalReasoningTokens: z.ZodNumber;
totalCachedInputTokens: z.ZodNumber;
totalInferenceTimeMs: z.ZodNumber;
}, z.core.$strict>;
};
readonly stagehandCallbackBatch: {
readonly name: "stagehand.callback_batch";
readonly params: z.ZodObject<{
callbackSource: z.ZodString;
input: z.ZodOptional<z.ZodJSONSchema>;
options: z.ZodObject<{
pageId: z.ZodOptional<z.ZodString>;
timeout: z.ZodDefault<z.ZodNumber>;
}, z.core.$strict>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
value: z.ZodOptional<z.ZodJSONSchema>;
}, z.core.$strict>;
readonly paramsWire: {
readonly opaqueKeys: readonly ["input"];
};
readonly resultWire: {
readonly opaqueKeys: readonly ["value"];
};
};
readonly browserbaseRequest: {
readonly name: "browserbase.request";
readonly params: z.ZodObject<{
operation: z.ZodEnum<{
"gateway.responses": "gateway.responses";
"cache.get": "cache.get";
"cache.set": "cache.set";
}>;
headers: z.ZodRecord<z.ZodString, z.ZodString>;
body: z.ZodString;
remainingTimeoutMs: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>;
readonly result: z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"response">;
status: z.ZodInt;
statusText: z.ZodString;
headers: z.ZodRecord<z.ZodString, z.ZodString>;
body: z.ZodString;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"error">;
reason: z.ZodEnum<{
timeout: "timeout";
network: "network";
cancelled: "cancelled";
unavailable: "unavailable";
disconnected: "disconnected";
}>;
message: z.ZodString;
}, z.core.$strict>], "type">;
};
readonly llmGenerate: {
readonly name: "llm.generate";
readonly params: z.ZodUnion<readonly [z.ZodObject<{
messages: z.ZodArray<z.ZodObject<{
role: z.ZodEnum<{
user: "user";
assistant: "assistant";
}>;
content: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_use">;
id: z.ZodString;
name: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_result">;
toolUseId: z.ZodString;
content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>], "type">>;
structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
isError: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>], "type">, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_use">;
id: z.ZodString;
name: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_result">;
toolUseId: z.ZodString;
content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>], "type">>;
structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
isError: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>], "type">>]>;
}, z.core.$strict>>;
systemPrompt: z.ZodOptional<z.ZodString>;
temperature: z.ZodOptional<z.ZodNumber>;
stopSequences: z.ZodOptional<z.ZodArray<z.ZodString>>;
responseFormat: z.ZodObject<{
type: z.ZodLiteral<"json_schema">;
name: z.ZodString;
description: z.ZodOptional<z.ZodString>;
schema: z.ZodJSONSchema;
}, z.core.$strict>;
}, z.core.$strict>, z.ZodObject<{
messages: z.ZodArray<z.ZodObject<{
role: z.ZodEnum<{
user: "user";
assistant: "assistant";
}>;
content: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_use">;
id: z.ZodString;
name: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_result">;
toolUseId: z.ZodString;
content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>], "type">>;
structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
isError: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>], "type">, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_use">;
id: z.ZodString;
name: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_result">;
toolUseId: z.ZodString;
content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>], "type">>;
structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
isError: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>], "type">>]>;
}, z.core.$strict>>;
systemPrompt: z.ZodOptional<z.ZodString>;
temperature: z.ZodOptional<z.ZodNumber>;
stopSequences: z.ZodOptional<z.ZodArray<z.ZodString>>;
tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
name: z.ZodString;
title: z.ZodOptional<z.ZodString>;
icons: z.ZodOptional<z.ZodArray<z.ZodObject<{
src: z.ZodURL;
mimeType: z.ZodOptional<z.ZodString>;
sizes: z.ZodOptional<z.ZodArray<z.ZodString>>;
theme: z.ZodOptional<z.ZodEnum<{
light: "light";
dark: "dark";
}>>;
}, z.core.$strict>>>;
description: z.ZodOptional<z.ZodString>;
inputSchema: z.ZodObject<{
$schema: z.ZodOptional<z.ZodString>;
type: z.ZodLiteral<"object">;
properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodJSONSchema>>>;
required: z.ZodOptional<z.ZodArray<z.ZodString>>;
}, z.core.$strict>;
execution: z.ZodOptional<z.ZodObject<{
taskSupport: z.ZodOptional<z.ZodEnum<{
optional: "optional";
required: "required";
forbidden: "forbidden";
}>>;
}, z.core.$strict>>;
outputSchema: z.ZodOptional<z.ZodObject<{
$schema: z.ZodOptional<z.ZodString>;
type: z.ZodLiteral<"object">;
properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodJSONSchema>>>;
required: z.ZodOptional<z.ZodArray<z.ZodString>>;
}, z.core.$strict>>;
annotations: z.ZodOptional<z.ZodObject<{
title: z.ZodOptional<z.ZodString>;
readOnlyHint: z.ZodOptional<z.ZodBoolean>;
destructiveHint: z.ZodOptional<z.ZodBoolean>;
idempotentHint: z.ZodOptional<z.ZodBoolean>;
openWorldHint: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>>;
}, z.core.$strict>>>;
toolChoice: z.ZodOptional<z.ZodObject<{
mode: z.ZodOptional<z.ZodEnum<{
required: "required";
auto: "auto";
none: "none";
}>>;
}, z.core.$strict>>;
responseFormat: z.ZodOptional<z.ZodObject<{
type: z.ZodLiteral<"text">;
}, z.core.$strict>>;
}, z.core.$strict>]>;
readonly result: z.ZodDiscriminatedUnion<[z.ZodObject<{
role: z.ZodEnum<{
user: "user";
assistant: "assistant";
}>;
content: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_use">;
id: z.ZodString;
name: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_result">;
toolUseId: z.ZodString;
content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>], "type">>;
structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
isError: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>], "type">, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_use">;
id: z.ZodString;
name: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_result">;
toolUseId: z.ZodString;
content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>], "type">>;
structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
isError: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>], "type">>]>;
stopReason: z.ZodOptional<z.ZodString>;
usage: z.ZodOptional<z.ZodObject<{
inputTokens: z.ZodNumber;
outputTokens: z.ZodNumber;
totalTokens: z.ZodNumber;
reasoningTokens: z.ZodOptional<z.ZodNumber>;
cachedInputTokens: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
outputFormat: z.ZodLiteral<"text">;
}, z.core.$strict>, z.ZodObject<{
role: z.ZodEnum<{
user: "user";
assistant: "assistant";
}>;
content: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_use">;
id: z.ZodString;
name: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_result">;
toolUseId: z.ZodString;
content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>], "type">>;
structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
isError: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>], "type">, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_use">;
id: z.ZodString;
name: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_result">;
toolUseId: z.ZodString;
content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>], "type">>;
structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
isError: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>], "type">>]>;
stopReason: z.ZodOptional<z.ZodString>;
usage: z.ZodOptional<z.ZodObject<{
inputTokens: z.ZodNumber;
outputTokens: z.ZodNumber;
totalTokens: z.ZodNumber;
reasoningTokens: z.ZodOptional<z.ZodNumber>;
cachedInputTokens: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
outputFormat: z.ZodLiteral<"json_schema">;
structuredContent: z.ZodJSONSchema;
}, z.core.$strict>], "outputFormat">;
readonly paramsWire: {
readonly opaqueKeys: readonly ["inputSchema", "outputSchema", "input", "structuredContent", "schema"];
};
readonly resultWire: {
readonly opaqueKeys: readonly ["structuredContent"];
};
};
readonly contextPages: {
readonly name: "context.pages";
readonly params: z.ZodObject<{}, z.core.$strict>;
readonly result: z.ZodArray<z.ZodObject<{
pageId: z.ZodString;
url: z.ZodOptional<z.ZodString>;
title: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
};
readonly contextNewPage: {
readonly name: "context.new_page";
readonly params: z.ZodObject<{
url: z.ZodOptional<z.ZodString>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
pageId: z.ZodString;
url: z.ZodOptional<z.ZodString>;
title: z.ZodOptional<z.ZodString>;
}, z.core.$strict>;
};
readonly contextActivePage: {
readonly name: "context.active_page";
readonly params: z.ZodObject<{}, z.core.$strict>;
readonly result: z.ZodNullable<z.ZodObject<{
pageId: z.ZodString;
url: z.ZodOptional<z.ZodString>;
title: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
};
readonly contextSetActivePage: {
readonly name: "context.set_active_page";
readonly params: z.ZodObject<{
pageId: z.ZodString;
}, z.core.$strict>;
readonly result: z.ZodObject<{
ok: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly contextAddInitScript: {
readonly name: "context.add_init_script";
readonly params: z.ZodObject<{
source: z.ZodString;
}, z.core.$strict>;
readonly result: z.ZodObject<{
ok: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly contextSetExtraHTTPHeaders: {
readonly name: "context.set_extra_http_headers";
readonly params: z.ZodObject<{
headers: z.ZodRecord<z.ZodString, z.ZodString>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
ok: z.ZodLiteral<true>;
}, z.core.$strict>;
readonly paramsWire: {
readonly opaqueKeys: readonly ["headers"];
};
};
readonly contextGetDomainPolicy: {
readonly name: "context.get_domain_policy";
readonly params: z.ZodObject<{}, z.core.$strict>;
readonly result: z.ZodNullable<z.ZodObject<{
allowedDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
blockedDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
}, z.core.$strict>>;
};
readonly contextSetDomainPolicy: {
readonly name: "context.set_domain_policy";
readonly params: z.ZodObject<{
policy: z.ZodNullable<z.ZodObject<{
allowedDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
blockedDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
ok: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly contextCookies: {
readonly name: "context.cookies";
readonly params: z.ZodObject<{
urls: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
}, z.core.$strict>;
readonly result: z.ZodArray<z.ZodObject<{
name: z.ZodString;
value: z.ZodString;
domain: z.ZodString;
path: z.ZodString;
expires: z.ZodNumber;
httpOnly: z.ZodBoolean;
secure: z.ZodBoolean;
sameSite: z.ZodEnum<{
Strict: "Strict";
Lax: "Lax";
None: "None";
}>;
}, z.core.$strict>>;
};
readonly contextAddCookies: {
readonly name: "context.add_cookies";
readonly params: z.ZodObject<{
cookies: z.ZodArray<z.ZodObject<{
name: z.ZodString;
value: z.ZodString;
url: z.ZodOptional<z.ZodString>;
domain: z.ZodOptional<z.ZodString>;
path: z.ZodOptional<z.ZodString>;
expires: z.ZodOptional<z.ZodNumber>;
httpOnly: z.ZodOptional<z.ZodBoolean>;
secure: z.ZodOptional<z.ZodBoolean>;
sameSite: z.ZodOptional<z.ZodEnum<{
Strict: "Strict";
Lax: "Lax";
None: "None";
}>>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
ok: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly contextClearCookies: {
readonly name: "context.clear_cookies";
readonly params: z.ZodObject<{
options: z.ZodOptional<z.ZodObject<{
name: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
source: z.ZodString;
flags: z.ZodOptional<z.ZodString>;
}, z.core.$strict>]>>;
domain: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
source: z.ZodString;
flags: z.ZodOptional<z.ZodString>;
}, z.core.$strict>]>>;
path: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
source: z.ZodString;
flags: z.ZodOptional<z.ZodString>;
}, z.core.$strict>]>>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
ok: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly contextClipboardReadText: {
readonly name: "context.clipboard_read_text";
readonly params: z.ZodObject<{
pageId: z.ZodOptional<z.ZodString>;
}, z.core.$strict>;
readonly result: z.ZodString;
};
readonly contextClipboardWriteText: {
readonly name: "context.clipboard_write_text";
readonly params: z.ZodObject<{
pageId: z.ZodOptional<z.ZodString>;
text: z.ZodString;
}, z.core.$strict>;
readonly result: z.ZodObject<{
ok: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly contextClipboardClear: {
readonly name: "context.clipboard_clear";
readonly params: z.ZodObject<{
pageId: z.ZodOptional<z.ZodString>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
ok: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly contextClipboardPaste: {
readonly name: "context.clipboard_paste";
readonly params: z.ZodObject<{
pageId: z.ZodOptional<z.ZodString>;
shortcut: z.ZodOptional<z.ZodEnum<{
"ControlOrMeta+V": "ControlOrMeta+V";
"Meta+V": "Meta+V";
"Control+V": "Control+V";
}>>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
ok: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly contextClipboardCopy: {
readonly name: "context.clipboard_copy";
readonly params: z.ZodObject<{
pageId: z.ZodOptional<z.ZodString>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
ok: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly contextClipboardCut: {
readonly name: "context.clipboard_cut";
readonly params: z.ZodObject<{
pageId: z.ZodOptional<z.ZodString>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
ok: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly pageGoto: {
readonly name: "page.goto";
readonly params: z.ZodObject<{
pageId: z.ZodString;
url: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
waitUntil: z.ZodOptional<z.ZodEnum<{
load: "load";
domcontentloaded: "domcontentloaded";
networkidle: "networkidle";
}>>;
timeout: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
page: z.ZodObject<{
pageId: z.ZodString;
url: z.ZodOptional<z.ZodString>;
title: z.ZodOptional<z.ZodString>;
}, z.core.$strict>;
response: z.ZodNullable<z.ZodObject<{
responseId: z.ZodString;
url: z.ZodString;
status: z.ZodNumber;
statusText: z.ZodString;
headers: z.ZodRecord<z.ZodString, z.ZodString>;
fromServiceWorker: z.ZodBoolean;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly resultWire: {
readonly opaqueKeys: readonly ["headers"];
};
};
readonly pageUrl: {
readonly name: "page.url";
readonly params: z.ZodObject<{
pageId: z.ZodString;
}, z.core.$strict>;
readonly result: z.ZodString;
};
readonly pageTitle: {
readonly name: "page.title";
readonly params: z.ZodObject<{
pageId: z.ZodString;
}, z.core.$strict>;
readonly result: z.ZodString;
};
readonly pageClose: {
readonly name: "page.close";
readonly params: z.ZodObject<{
pageId: z.ZodString;
}, z.core.$strict>;
readonly result: z.ZodObject<{
closed: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly pageReload: {
readonly name: "page.reload";
readonly params: z.ZodObject<{
pageId: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
waitUntil: z.ZodOptional<z.ZodEnum<{
load: "load";
domcontentloaded: "domcontentloaded";
networkidle: "networkidle";
}>>;
timeout: z.ZodOptional<z.ZodNumber>;
ignoreCache: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
page: z.ZodObject<{
pageId: z.ZodString;
url: z.ZodOptional<z.ZodString>;
title: z.ZodOptional<z.ZodString>;
}, z.core.$strict>;
response: z.ZodNullable<z.ZodObject<{
responseId: z.ZodString;
url: z.ZodString;
status: z.ZodNumber;
statusText: z.ZodString;
headers: z.ZodRecord<z.ZodString, z.ZodString>;
fromServiceWorker: z.ZodBoolean;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly resultWire: {
readonly opaqueKeys: readonly ["headers"];
};
};
readonly pageGoBack: {
readonly name: "page.go_back";
readonly params: z.ZodObject<{
pageId: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
waitUntil: z.ZodOptional<z.ZodEnum<{
load: "load";
domcontentloaded: "domcontentloaded";
networkidle: "networkidle";
}>>;
timeout: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
page: z.ZodObject<{
pageId: z.ZodString;
url: z.ZodOptional<z.ZodString>;
title: z.ZodOptional<z.ZodString>;
}, z.core.$strict>;
response: z.ZodNullable<z.ZodObject<{
responseId: z.ZodString;
url: z.ZodString;
status: z.ZodNumber;
statusText: z.ZodString;
headers: z.ZodRecord<z.ZodString, z.ZodString>;
fromServiceWorker: z.ZodBoolean;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly resultWire: {
readonly opaqueKeys: readonly ["headers"];
};
};
readonly pageGoForward: {
readonly name: "page.go_forward";
readonly params: z.ZodObject<{
pageId: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
waitUntil: z.ZodOptional<z.ZodEnum<{
load: "load";
domcontentloaded: "domcontentloaded";
networkidle: "networkidle";
}>>;
timeout: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
page: z.ZodObject<{
pageId: z.ZodString;
url: z.ZodOptional<z.ZodString>;
title: z.ZodOptional<z.ZodString>;
}, z.core.$strict>;
response: z.ZodNullable<z.ZodObject<{
responseId: z.ZodString;
url: z.ZodString;
status: z.ZodNumber;
statusText: z.ZodString;
headers: z.ZodRecord<z.ZodString, z.ZodString>;
fromServiceWorker: z.ZodBoolean;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly resultWire: {
readonly opaqueKeys: readonly ["headers"];
};
};
readonly pageClick: {
readonly name: "page.click";
readonly params: z.ZodObject<{
pageId: z.ZodString;
x: z.ZodNumber;
y: z.ZodNumber;
options: z.ZodOptional<z.ZodObject<{
button: z.ZodOptional<z.ZodEnum<{
left: "left";
right: "right";
middle: "middle";
}>>;
clickCount: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
ok: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly pageHover: {
readonly name: "page.hover";
readonly params: z.ZodObject<{
pageId: z.ZodString;
x: z.ZodNumber;
y: z.ZodNumber;
}, z.core.$strict>;
readonly result: z.ZodObject<{
ok: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly pageScroll: {
readonly name: "page.scroll";
readonly params: z.ZodObject<{
pageId: z.ZodString;
x: z.ZodNumber;
y: z.ZodNumber;
deltaX: z.ZodNumber;
deltaY: z.ZodNumber;
}, z.core.$strict>;
readonly result: z.ZodObject<{
ok: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly pageDragAndDrop: {
readonly name: "page.drag_and_drop";
readonly params: z.ZodObject<{
pageId: z.ZodString;
fromX: z.ZodNumber;
fromY: z.ZodNumber;
toX: z.ZodNumber;
toY: z.ZodNumber;
options: z.ZodOptional<z.ZodObject<{
button: z.ZodOptional<z.ZodEnum<{
left: "left";
right: "right";
middle: "middle";
}>>;
steps: z.ZodOptional<z.ZodNumber>;
delay: z.ZodOptional<z.ZodNumber>;
route: z.ZodOptional<z.ZodArray<z.ZodObject<{
x: z.ZodNumber;
y: z.ZodNumber;
}, z.core.$strict>>>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
ok: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly pageType: {
readonly name: "page.type";
readonly params: z.ZodObject<{
pageId: z.ZodString;
text: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
delay: z.ZodOptional<z.ZodNumber>;
withMistakes: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
ok: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly pageKeyPress: {
readonly name: "page.key_press";
readonly params: z.ZodObject<{
pageId: z.ZodString;
key: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
delay: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
ok: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly pageEvaluate: {
readonly name: "page.evaluate";
readonly params: z.ZodObject<{
pageId: z.ZodString;
expression: z.ZodString;
}, z.core.$strict>;
readonly result: z.ZodObject<{
value: z.ZodJSONSchema;
}, z.core.$strict>;
readonly resultWire: {
readonly opaqueKeys: readonly ["value"];
};
};
readonly pageAddInitScript: {
readonly name: "page.add_init_script";
readonly params: z.ZodObject<{
pageId: z.ZodString;
source: z.ZodString;
}, z.core.$strict>;
readonly result: z.ZodObject<{
ok: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly pageOn: {
readonly name: "page.on";
readonly params: z.ZodObject<{
pageId: z.ZodString;
subscriptionId: z.ZodString;
event: z.ZodEnum<{
console: "console";
toolsadded: "toolsadded";
toolsremoved: "toolsremoved";
}>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
ok: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly pageOff: {
readonly name: "page.off";
readonly params: z.ZodObject<{
subscriptionId: z.ZodString;
}, z.core.$strict>;
readonly result: z.ZodObject<{
ok: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly pageSetExtraHTTPHeaders: {
readonly name: "page.set_extra_http_headers";
readonly params: z.ZodObject<{
pageId: z.ZodString;
headers: z.ZodRecord<z.ZodString, z.ZodString>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
ok: z.ZodLiteral<true>;
}, z.core.$strict>;
readonly paramsWire: {
readonly opaqueKeys: readonly ["headers"];
};
};
readonly pageScreenshot: {
readonly name: "page.screenshot";
readonly params: z.ZodObject<{
pageId: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
animations: z.ZodOptional<z.ZodEnum<{
disabled: "disabled";
allow: "allow";
}>>;
caret: z.ZodOptional<z.ZodEnum<{
hide: "hide";
initial: "initial";
}>>;
clip: z.ZodOptional<z.ZodObject<{
x: z.ZodNumber;
y: z.ZodNumber;
width: z.ZodNumber;
height: z.ZodNumber;
}, z.core.$strict>>;
fullPage: z.ZodOptional<z.ZodBoolean>;
mask: z.ZodOptional<z.ZodArray<z.ZodObject<{
selector: z.ZodString;
nth: z.ZodOptional<z.ZodNumber>;
pageId: z.ZodString;
}, z.core.$strict>>>;
maskColor: z.ZodOptional<z.ZodString>;
omitBackground: z.ZodOptional<z.ZodBoolean>;
quality: z.ZodOptional<z.ZodNumber>;
scale: z.ZodOptional<z.ZodEnum<{
css: "css";
device: "device";
}>>;
style: z.ZodOptional<z.ZodString>;
timeout: z.ZodOptional<z.ZodNumber>;
type: z.ZodOptional<z.ZodEnum<{
png: "png";
jpeg: "jpeg";
}>>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
data: z.ZodBase64;
}, z.core.$strict>;
};
readonly pagePDF: {
readonly name: "page.pdf";
readonly params: z.ZodObject<{
pageId: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
landscape: z.ZodOptional<z.ZodBoolean>;
displayHeaderFooter: z.ZodOptional<z.ZodBoolean>;
printBackground: z.ZodOptional<z.ZodBoolean>;
scale: z.ZodOptional<z.ZodNumber>;
width: z.ZodOptional<z.ZodNumber>;
height: z.ZodOptional<z.ZodNumber>;
margin: z.ZodOptional<z.ZodObject<{
top: z.ZodOptional<z.ZodNumber>;
bottom: z.ZodOptional<z.ZodNumber>;
left: z.ZodOptional<z.ZodNumber>;
right: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
pageRanges: z.ZodOptional<z.ZodString>;
headerTemplate: z.ZodOptional<z.ZodString>;
footerTemplate: z.ZodOptional<z.ZodString>;
preferCSSPageSize: z.ZodOptional<z.ZodBoolean>;
tagged: z.ZodOptional<z.ZodBoolean>;
outline: z.ZodOptional<z.ZodBoolean>;
timeout: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
data: z.ZodBase64;
}, z.core.$strict>;
};
readonly pageSnapshot: {
readonly name: "page.snapshot";
readonly params: z.ZodObject<{
pageId: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
timeout: z.ZodOptional<z.ZodNumber>;
includeIframes: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
formattedTree: z.ZodString;
xpathMap: z.ZodRecord<z.ZodString, z.ZodString>;
urlMap: z.ZodRecord<z.ZodString, z.ZodString>;
}, z.core.$strict>;
readonly resultWire: {
readonly opaqueKeys: readonly ["xpathMap", "urlMap"];
};
};
readonly pageSetViewportSize: {
readonly name: "page.set_viewport_size";
readonly params: z.ZodObject<{
pageId: z.ZodString;
width: z.ZodNumber;
height: z.ZodNumber;
options: z.ZodOptional<z.ZodObject<{
deviceScaleFactor: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
ok: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly pageWaitForLoadState: {
readonly name: "page.wait_for_load_state";
readonly params: z.ZodObject<{
pageId: z.ZodString;
state: z.ZodEnum<{
load: "load";
domcontentloaded: "domcontentloaded";
networkidle: "networkidle";
}>;
timeout: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
ok: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly pageWaitForTimeout: {
readonly name: "page.wait_for_timeout";
readonly params: z.ZodObject<{
pageId: z.ZodString;
ms: z.ZodNumber;
}, z.core.$strict>;
readonly result: z.ZodObject<{
ok: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly pageWaitForSelector: {
readonly name: "page.wait_for_selector";
readonly params: z.ZodObject<{
pageId: z.ZodString;
selector: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
state: z.ZodOptional<z.ZodEnum<{
attached: "attached";
detached: "detached";
visible: "visible";
hidden: "hidden";
}>>;
timeout: z.ZodOptional<z.ZodNumber>;
pierceShadow: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
matched: z.ZodBoolean;
}, z.core.$strict>;
};
readonly pageWaitForFunction: {
readonly name: "page.wait_for_function";
readonly params: z.ZodObject<{
pageId: z.ZodString;
expression: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
polling: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"raf">, z.ZodNumber]>>;
timeout: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
value: z.ZodJSONSchema;
}, z.core.$strict>;
readonly resultWire: {
readonly opaqueKeys: readonly ["value"];
};
};
readonly pageWebMCPTools: {
readonly name: "page.webmcp_tools";
readonly params: z.ZodObject<{
options: z.ZodOptional<z.ZodObject<{
timeout: z.ZodDefault<z.ZodNumber>;
}, z.core.$strict>>;
pageId: z.ZodString;
}, z.core.$strict>;
readonly result: z.ZodObject<{
tools: z.ZodArray<z.ZodObject<{
name: z.ZodString;
description: z.ZodString;
inputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
annotations: z.ZodOptional<z.ZodObject<{
readOnly: z.ZodOptional<z.ZodBoolean>;
untrustedContent: z.ZodOptional<z.ZodBoolean>;
autosubmit: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>>;
frameId: z.ZodString;
backendNodeId: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly resultWire: {
readonly opaqueKeys: readonly ["inputSchema"];
};
};
readonly pageWebMCPInvokeTool: {
readonly name: "page.webmcp_invoke_tool";
readonly params: z.ZodObject<{
input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
frameId: z.ZodString;
toolName: z.ZodString;
pageId: z.ZodString;
}, z.core.$strict>;
readonly result: z.ZodObject<{
invocationId: z.ZodString;
toolName: z.ZodString;
frameId: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>;
readonly paramsWire: {
readonly opaqueKeys: readonly ["input"];
};
readonly resultWire: {
readonly opaqueKeys: readonly ["input"];
};
};
readonly pageWebMCPInvocationResult: {
readonly name: "page.webmcp_invocation_result";
readonly params: z.ZodObject<{
invocationId: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
timeout: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
pageId: z.ZodString;
}, z.core.$strict>;
readonly result: z.ZodObject<{
invocationId: z.ZodString;
status: z.ZodEnum<{
Completed: "Completed";
Canceled: "Canceled";
Error: "Error";
}>;
output: z.ZodOptional<z.ZodJSONSchema>;
errorText: z.ZodOptional<z.ZodString>;
exception: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
}, z.core.$strict>;
readonly resultWire: {
readonly opaqueKeys: readonly ["output", "exception"];
};
};
readonly pageWebMCPCancelInvocation: {
readonly name: "page.webmcp_cancel_invocation";
readonly params: z.ZodObject<{
invocationId: z.ZodString;
pageId: z.ZodString;
}, z.core.$strict>;
readonly result: z.ZodObject<{
ok: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly locatorClick: {
readonly name: "locator.click";
readonly params: z.ZodObject<{
selector: z.ZodString;
nth: z.ZodOptional<z.ZodNumber>;
pageId: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
timeout: z.ZodOptional<z.ZodNumber>;
button: z.ZodOptional<z.ZodEnum<{
left: "left";
right: "right";
middle: "middle";
}>>;
clickCount: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
clicked: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly locatorFill: {
readonly name: "locator.fill";
readonly params: z.ZodObject<{
selector: z.ZodString;
nth: z.ZodOptional<z.ZodNumber>;
pageId: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
timeout: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
value: z.ZodString;
}, z.core.$strict>;
readonly result: z.ZodObject<{
filled: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly locatorHover: {
readonly name: "locator.hover";
readonly params: z.ZodObject<{
selector: z.ZodString;
nth: z.ZodOptional<z.ZodNumber>;
pageId: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
timeout: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
hovered: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly locatorCount: {
readonly name: "locator.count";
readonly params: z.ZodObject<{
selector: z.ZodString;
nth: z.ZodOptional<z.ZodNumber>;
pageId: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
timeout: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodNumber;
};
readonly locatorIsChecked: {
readonly name: "locator.is_checked";
readonly params: z.ZodObject<{
selector: z.ZodString;
nth: z.ZodOptional<z.ZodNumber>;
pageId: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
timeout: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodBoolean;
};
readonly locatorInputValue: {
readonly name: "locator.input_value";
readonly params: z.ZodObject<{
selector: z.ZodString;
nth: z.ZodOptional<z.ZodNumber>;
pageId: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
timeout: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodString;
};
readonly locatorIsVisible: {
readonly name: "locator.is_visible";
readonly params: z.ZodObject<{
selector: z.ZodString;
nth: z.ZodOptional<z.ZodNumber>;
pageId: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
timeout: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodBoolean;
};
readonly locatorInnerText: {
readonly name: "locator.inner_text";
readonly params: z.ZodObject<{
selector: z.ZodString;
nth: z.ZodOptional<z.ZodNumber>;
pageId: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
timeout: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodString;
};
readonly locatorInnerHtml: {
readonly name: "locator.inner_html";
readonly params: z.ZodObject<{
selector: z.ZodString;
nth: z.ZodOptional<z.ZodNumber>;
pageId: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
timeout: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodString;
};
readonly locatorTextContent: {
readonly name: "locator.text_content";
readonly params: z.ZodObject<{
selector: z.ZodString;
nth: z.ZodOptional<z.ZodNumber>;
pageId: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
timeout: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodString;
};
readonly locatorScrollTo: {
readonly name: "locator.scroll_to";
readonly params: z.ZodObject<{
selector: z.ZodString;
nth: z.ZodOptional<z.ZodNumber>;
pageId: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
timeout: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
percent: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
scrolled: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly locatorCentroid: {
readonly name: "locator.centroid";
readonly params: z.ZodObject<{
selector: z.ZodString;
nth: z.ZodOptional<z.ZodNumber>;
pageId: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
timeout: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
x: z.ZodNumber;
y: z.ZodNumber;
}, z.core.$strict>;
};
readonly locatorHighlight: {
readonly name: "locator.highlight";
readonly params: z.ZodObject<{
selector: z.ZodString;
nth: z.ZodOptional<z.ZodNumber>;
pageId: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
timeout: z.ZodOptional<z.ZodNumber>;
durationMs: z.ZodOptional<z.ZodNumber>;
borderColor: z.ZodOptional<z.ZodObject<{
r: z.ZodNumber;
g: z.ZodNumber;
b: z.ZodNumber;
a: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
contentColor: z.ZodOptional<z.ZodObject<{
r: z.ZodNumber;
g: z.ZodNumber;
b: z.ZodNumber;
a: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
highlighted: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly locatorSendClickEvent: {
readonly name: "locator.send_click_event";
readonly params: z.ZodObject<{
selector: z.ZodString;
nth: z.ZodOptional<z.ZodNumber>;
pageId: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
timeout: z.ZodOptional<z.ZodNumber>;
bubbles: z.ZodOptional<z.ZodBoolean>;
cancelable: z.ZodOptional<z.ZodBoolean>;
composed: z.ZodOptional<z.ZodBoolean>;
detail: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
clicked: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly locatorType: {
readonly name: "locator.type";
readonly params: z.ZodObject<{
selector: z.ZodString;
nth: z.ZodOptional<z.ZodNumber>;
pageId: z.ZodString;
text: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
timeout: z.ZodOptional<z.ZodNumber>;
delay: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
typed: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly locatorSelectOption: {
readonly name: "locator.select_option";
readonly params: z.ZodObject<{
selector: z.ZodString;
nth: z.ZodOptional<z.ZodNumber>;
pageId: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
timeout: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
values: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
}, z.core.$strict>;
readonly result: z.ZodArray<z.ZodString>;
};
readonly locatorSetInputFiles: {
readonly name: "locator.set_input_files";
readonly params: z.ZodObject<{
selector: z.ZodString;
nth: z.ZodOptional<z.ZodNumber>;
pageId: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
timeout: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
files: z.ZodArray<z.ZodObject<{
name: z.ZodString;
mimeType: z.ZodOptional<z.ZodString>;
data: z.ZodBase64;
lastModified: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
readonly result: z.ZodObject<{
set: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly responseBody: {
readonly name: "response.body";
readonly params: z.ZodObject<{
responseId: z.ZodString;
}, z.core.$strict>;
readonly result: z.ZodObject<{
body: z.ZodString;
base64Encoded: z.ZodLiteral<true>;
}, z.core.$strict>;
};
readonly responseAllHeaders: {
readonly name: "response.all_headers";
readonly params: z.ZodObject<{
responseId: z.ZodString;
}, z.core.$strict>;
readonly result: z.ZodObject<{
headers: z.ZodRecord<z.ZodString, z.ZodString>;
}, z.core.$strict>;
readonly resultWire: {
readonly opaqueKeys: readonly ["headers"];
};
};
readonly responseHeadersArray: {
readonly name: "response.headers_array";
readonly params: z.ZodObject<{
responseId: z.ZodString;
}, z.core.$strict>;
readonly result: z.ZodObject<{
headers: z.ZodArray<z.ZodObject<{
name: z.ZodString;
value: z.ZodString;
}, z.core.$strict>>;
}, z.core.$strict>;
};
readonly responseSecurityDetails: {
readonly name: "response.security_details";
readonly params: z.ZodObject<{
responseId: z.ZodString;
}, z.core.$strict>;
readonly result: z.ZodObject<{
value: z.ZodNullable<z.ZodObject<{
issuer: z.ZodString;
protocol: z.ZodString;
subjectName: z.ZodString;
validFrom: z.ZodNumber;
validTo: z.ZodNumber;
}, z.core.$strict>>;
}, z.core.$strict>;
};
readonly responseServerAddr: {
readonly name: "response.server_addr";
readonly params: z.ZodObject<{
responseId: z.ZodString;
}, z.core.$strict>;
readonly result: z.ZodObject<{
value: z.ZodNullable<z.ZodObject<{
ipAddress: z.ZodString;
port: z.ZodNumber;
}, z.core.$strict>>;
}, z.core.$strict>;
};
readonly responseFinished: {
readonly name: "response.finished";
readonly params: z.ZodObject<{
responseId: z.ZodString;
}, z.core.$strict>;
readonly result: z.ZodObject<{
error: z.ZodNullable<z.ZodObject<{
message: z.ZodString;
}, z.core.$strict>>;
}, z.core.$strict>;
};
};
declare const StagehandNotifications: {
readonly browserbaseCancel: {
readonly name: "browserbase.cancel";
readonly params: z.ZodObject<{
requestId: z.ZodInt;
reason: z.ZodEnum<{
timeout: "timeout";
cancelled: "cancelled";
}>;
}, z.core.$strict>;
readonly paramsWire: undefined;
};
readonly log: {
readonly name: "stagehand.log";
readonly params: z.ZodObject<{
level: z.ZodEnum<{
error: "error";
warn: "warn";
info: "info";
debug: "debug";
}>;
message: z.ZodString;
data: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>;
readonly paramsWire: undefined;
};
readonly pageCDPEvent: {
readonly name: "page.cdp_event";
readonly params: z.ZodObject<{
subscriptionId: z.ZodString;
event: z.ZodObject<{
pageId: z.ZodString;
method: z.ZodEnum<{
"Runtime.consoleAPICalled": "Runtime.consoleAPICalled";
}>;
params: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
sessionId: z.ZodString;
targetId: z.ZodString;
}, z.core.$strict>;
}, z.core.$strict>;
readonly paramsWire: {
readonly opaqueKeys: readonly ["params"];
};
};
readonly pageEvent: {
readonly name: "page.event";
readonly params: z.ZodDiscriminatedUnion<[z.ZodObject<{
event: z.ZodLiteral<"toolsadded">;
tools: z.ZodArray<z.ZodObject<{
name: z.ZodString;
description: z.ZodString;
inputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
annotations: z.ZodOptional<z.ZodObject<{
readOnly: z.ZodOptional<z.ZodBoolean>;
untrustedContent: z.ZodOptional<z.ZodBoolean>;
autosubmit: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>>;
frameId: z.ZodString;
backendNodeId: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
subscriptionId: z.ZodString;
pageId: z.ZodString;
sessionId: z.ZodString;
targetId: z.ZodString;
}, z.core.$strict>, z.ZodObject<{
event: z.ZodLiteral<"toolsremoved">;
tools: z.ZodArray<z.ZodObject<{
frameId: z.ZodString;
name: z.ZodString;
}, z.core.$strict>>;
subscriptionId: z.ZodString;
pageId: z.ZodString;
sessionId: z.ZodString;
targetId: z.ZodString;
}, z.core.$strict>], "event">;
readonly paramsWire: {
readonly opaqueKeys: readonly ["inputSchema"];
};
};
};
type RegisteredNotificationSchema = { [Key in keyof typeof StagehandNotifications]: z.ZodType<{
jsonrpc: "2.0";
method: (typeof StagehandNotifications)[Key]["name"];
params: z.output<(typeof StagehandNotifications)[Key]["params"]>;
}> }[keyof typeof StagehandNotifications];
declare const StagehandRpcNotificationSchema: z.ZodUnion<[RegisteredNotificationSchema, ...RegisteredNotificationSchema[]]>;
//#endregion
//#region ../protocol/schemas.d.ts
declare const ModelNameSchema: z.ZodUnion<readonly [z.ZodTemplateLiteral<`openai/${string}`>, z.ZodTemplateLiteral<`anthropic/${string}`>, z.ZodTemplateLiteral<`google/${string}`>, z.ZodTemplateLiteral<`groq/${string}`>, z.ZodTemplateLiteral<`cerebras/${string}`>]>;
declare const CookieSchema: z.ZodObject<{
name: z.ZodString;
value: z.ZodString;
domain: z.ZodString;
path: z.ZodString;
expires: z.ZodNumber;
httpOnly: z.ZodBoolean;
secure: z.ZodBoolean;
sameSite: z.ZodEnum<{
Strict: "Strict";
Lax: "Lax";
None: "None";
}>;
}, z.core.$strict>;
declare const CookieParamSchema: z.ZodObject<{
name: z.ZodString;
value: z.ZodString;
url: z.ZodOptional<z.ZodString>;
domain: z.ZodOptional<z.ZodString>;
path: z.ZodOptional<z.ZodString>;
expires: z.ZodOptional<z.ZodNumber>;
httpOnly: z.ZodOptional<z.ZodBoolean>;
secure: z.ZodOptional<z.ZodBoolean>;
sameSite: z.ZodOptional<z.ZodEnum<{
Strict: "Strict";
Lax: "Lax";
None: "None";
}>>;
}, z.core.$strict>;
declare const DomainPolicySchema: z.ZodObject<{
allowedDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
blockedDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
}, z.core.$strict>;
declare const VariablesSchema: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodObject<{
value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
description: z.ZodOptional<z.ZodString>;
}, z.core.$strict>]>>;
declare const StagehandMetricsSchema: z.ZodObject<{
actPromptTokens: z.ZodNumber;
actCompletionTokens: z.ZodNumber;
actReasoningTokens: z.ZodNumber;
actCachedInputTokens: z.ZodNumber;
actInferenceTimeMs: z.ZodNumber;
extractPromptTokens: z.ZodNumber;
extractCompletionTokens: z.ZodNumber;
extractReasoningTokens: z.ZodNumber;
extractCachedInputTokens: z.ZodNumber;
extractInferenceTimeMs: z.ZodNumber;
observePromptTokens: z.ZodNumber;
observeCompletionTokens: z.ZodNumber;
observeReasoningTokens: z.ZodNumber;
observeCachedInputTokens: z.ZodNumber;
observeInferenceTimeMs: z.ZodNumber;
totalPromptTokens: z.ZodNumber;
totalCompletionTokens: z.ZodNumber;
totalReasoningTokens: z.ZodNumber;
totalCachedInputTokens: z.ZodNumber;
totalInferenceTimeMs: z.ZodNumber;
}, z.core.$strict>;
declare const CacheStatusSchema: z.ZodEnum<{
HIT: "HIT";
MISS: "MISS";
DISABLED: "DISABLED";
}>;
/** Server-side caching configuration: a boolean toggle, or an object enabling
* caching with an optional hit-count threshold (how many identical results
* must be seen before the cache serves a hit; overrides the project's
* configured threshold). */
declare const CachingSchema: z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
threshold: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>]>;
declare const ModelConfigSchema: z.ZodObject<{
apiKey: z.ZodOptional<z.ZodString>;
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
modelName: z.ZodUnion<readonly [z.ZodTemplateLiteral<`openai/${string}`>, z.ZodTemplateLiteral<`anthropic/${string}`>, z.ZodTemplateLiteral<`google/${string}`>, z.ZodTemplateLiteral<`groq/${string}`>, z.ZodTemplateLiteral<`cerebras/${string}`>]>;
}, z.core.$strict>;
/** Action object returned by observe and used by act */
declare const ActionSchema: z.ZodObject<{
selector: z.ZodString;
description: z.ZodString;
method: z.ZodOptional<z.ZodString>;
arguments: z.ZodOptional<z.ZodArray<z.ZodString>>;
}, z.core.$strict>;
declare const StagehandResultUsageSchema: z.ZodObject<{
inputTokens: z.ZodDefault<z.ZodNumber>;
outputTokens: z.ZodDefault<z.ZodNumber>;
reasoningTokens: z.ZodDefault<z.ZodNumber>;
cachedInputTokens: z.ZodDefault<z.ZodNumber>;
inferenceTimeMs: z.ZodDefault<z.ZodNumber>;
}, z.core.$strict>;
/** LLM tokens avoided by serving a request from the cache. */
declare const CacheTokenSavingsSchema: z.ZodObject<{
inputTokens: z.ZodDefault<z.ZodNumber>;
outputTokens: z.ZodDefault<z.ZodNumber>;
totalTokens: z.ZodDefault<z.ZodNumber>;
}, z.core.$strict>;
/**
* Cache observability for one act/observe/extract call. Always present, like
* `usage`: DISABLED says no lookup ran, and otherwise it is self-explaining —
* a miss carries why it missed, a hit carries how established the entry is.
*/
declare const CacheMetadataSchema: z.ZodObject<{
status: z.ZodEnum<{
HIT: "HIT";
MISS: "MISS";
DISABLED: "DISABLED";
}>;
count: z.ZodOptional<z.ZodNumber>;
threshold: z.ZodOptional<z.ZodNumber>;
missReason: z.ZodOptional<z.ZodString>;
tokensSaved: z.ZodOptional<z.ZodObject<{
inputTokens: z.ZodDefault<z.ZodNumber>;
outputTokens: z.ZodDefault<z.ZodNumber>;
totalTokens: z.ZodDefault<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
declare const StagehandResultMetadataSchema: z.ZodObject<{
actionId: z.ZodOptional<z.ZodString>;
cache: z.ZodObject<{
status: z.ZodEnum<{
HIT: "HIT";
MISS: "MISS";
DISABLED: "DISABLED";
}>;
count: z.ZodOptional<z.ZodNumber>;
threshold: z.ZodOptional<z.ZodNumber>;
missReason: z.ZodOptional<z.ZodString>;
tokensSaved: z.ZodOptional<z.ZodObject<{
inputTokens: z.ZodDefault<z.ZodNumber>;
outputTokens: z.ZodDefault<z.ZodNumber>;
totalTokens: z.ZodDefault<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
usage: z.ZodObject<{
inputTokens: z.ZodDefault<z.ZodNumber>;
outputTokens: z.ZodDefault<z.ZodNumber>;
reasoningTokens: z.ZodDefault<z.ZodNumber>;
cachedInputTokens: z.ZodDefault<z.ZodNumber>;
inferenceTimeMs: z.ZodDefault<z.ZodNumber>;
}, z.core.$strict>;
}, z.core.$strict>;
/** Inner act result data */
declare const ActResultDataSchema: z.ZodObject<{
success: z.ZodBoolean;
message: z.ZodString;
actionDescription: z.ZodString;
actions: z.ZodArray<z.ZodObject<{
selector: z.ZodString;
description: z.ZodString;
method: z.ZodOptional<z.ZodString>;
arguments: z.ZodOptional<z.ZodArray<z.ZodString>>;
}, z.core.$strict>>;
}, z.core.$strict>;
declare const ActResultSchema: z.ZodObject<{
data: z.ZodObject<{
success: z.ZodBoolean;
message: z.ZodString;
actionDescription: z.ZodString;
actions: z.ZodArray<z.ZodObject<{
selector: z.ZodString;
description: z.ZodString;
method: z.ZodOptional<z.ZodString>;
arguments: z.ZodOptional<z.ZodArray<z.ZodString>>;
}, z.core.$strict>>;
}, z.core.$strict>;
metadata: z.ZodObject<{
actionId: z.ZodOptional<z.ZodString>;
cache: z.ZodObject<{
status: z.ZodEnum<{
HIT: "HIT";
MISS: "MISS";
DISABLED: "DISABLED";
}>;
count: z.ZodOptional<z.ZodNumber>;
threshold: z.ZodOptional<z.ZodNumber>;
missReason: z.ZodOptional<z.ZodString>;
tokensSaved: z.ZodOptional<z.ZodObject<{
inputTokens: z.ZodDefault<z.ZodNumber>;
outputTokens: z.ZodDefault<z.ZodNumber>;
totalTokens: z.ZodDefault<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
usage: z.ZodObject<{
inputTokens: z.ZodDefault<z.ZodNumber>;
outputTokens: z.ZodDefault<z.ZodNumber>;
reasoningTokens: z.ZodDefault<z.ZodNumber>;
cachedInputTokens: z.ZodDefault<z.ZodNumber>;
inferenceTimeMs: z.ZodDefault<z.ZodNumber>;
}, z.core.$strict>;
}, z.core.$strict>;
}, z.core.$strict>;
declare const ExtractResultSchema: z.ZodObject<{
data: z.ZodJSONSchema;
metadata: z.ZodObject<{
actionId: z.ZodOptional<z.ZodString>;
cache: z.ZodObject<{
status: z.ZodEnum<{
HIT: "HIT";
MISS: "MISS";
DISABLED: "DISABLED";
}>;
count: z.ZodOptional<z.ZodNumber>;
threshold: z.ZodOptional<z.ZodNumber>;
missReason: z.ZodOptional<z.ZodString>;
tokensSaved: z.ZodOptional<z.ZodObject<{
inputTokens: z.ZodDefault<z.ZodNumber>;
outputTokens: z.ZodDefault<z.ZodNumber>;
totalTokens: z.ZodDefault<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
usage: z.ZodObject<{
inputTokens: z.ZodDefault<z.ZodNumber>;
outputTokens: z.ZodDefault<z.ZodNumber>;
reasoningTokens: z.ZodDefault<z.ZodNumber>;
cachedInputTokens: z.ZodDefault<z.ZodNumber>;
inferenceTimeMs: z.ZodDefault<z.ZodNumber>;
}, z.core.$strict>;
}, z.core.$strict>;
}, z.core.$strict>;
declare const ObserveResultSchema: z.ZodObject<{
data: z.ZodArray<z.ZodObject<{
selector: z.ZodString;
description: z.ZodString;
method: z.ZodOptional<z.ZodString>;
arguments: z.ZodOptional<z.ZodArray<z.ZodString>>;
}, z.core.$strict>>;
metadata: z.ZodObject<{
actionId: z.ZodOptional<z.ZodString>;
cache: z.ZodObject<{
status: z.ZodEnum<{
HIT: "HIT";
MISS: "MISS";
DISABLED: "DISABLED";
}>;
count: z.ZodOptional<z.ZodNumber>;
threshold: z.ZodOptional<z.ZodNumber>;
missReason: z.ZodOptional<z.ZodString>;
tokensSaved: z.ZodOptional<z.ZodObject<{
inputTokens: z.ZodDefault<z.ZodNumber>;
outputTokens: z.ZodDefault<z.ZodNumber>;
totalTokens: z.ZodDefault<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
usage: z.ZodObject<{
inputTokens: z.ZodDefault<z.ZodNumber>;
outputTokens: z.ZodDefault<z.ZodNumber>;
reasoningTokens: z.ZodDefault<z.ZodNumber>;
cachedInputTokens: z.ZodDefault<z.ZodNumber>;
inferenceTimeMs: z.ZodDefault<z.ZodNumber>;
}, z.core.$strict>;
}, z.core.$strict>;
}, z.core.$strict>;
declare const LoadStateSchema: z.ZodEnum<{
load: "load";
domcontentloaded: "domcontentloaded";
networkidle: "networkidle";
}>;
declare const PageNavigationOptionsSchema: z.ZodObject<{
waitUntil: z.ZodOptional<z.ZodEnum<{
load: "load";
domcontentloaded: "domcontentloaded";
networkidle: "networkidle";
}>>;
timeout: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>;
declare const PageScreenshotClipSchema: z.ZodObject<{
x: z.ZodNumber;
y: z.ZodNumber;
width: z.ZodNumber;
height: z.ZodNumber;
}, z.core.$strict>;
declare const SnapshotResultSchema: z.ZodObject<{
formattedTree: z.ZodString;
xpathMap: z.ZodRecord<z.ZodString, z.ZodString>;
urlMap: z.ZodRecord<z.ZodString, z.ZodString>;
}, z.core.$strict>;
declare const PageSnapshotOptionsSchema: z.ZodObject<{
timeout: z.ZodOptional<z.ZodNumber>;
includeIframes: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>;
declare const PageRefSchema: z.ZodObject<{
pageId: z.ZodString;
url: z.ZodOptional<z.ZodString>;
title: z.ZodOptional<z.ZodString>;
}, z.core.$strict>;
declare const NavigationHeaderSchema: z.ZodObject<{
name: z.ZodString;
value: z.ZodString;
}, z.core.$strict>;
declare const NavigationSecurityDetailsSchema: z.ZodObject<{
issuer: z.ZodString;
protocol: z.ZodString;
subjectName: z.ZodString;
validFrom: z.ZodNumber;
validTo: z.ZodNumber;
}, z.core.$strict>;
declare const NavigationServerAddrSchema: z.ZodObject<{
ipAddress: z.ZodString;
port: z.ZodNumber;
}, z.core.$strict>;
declare const NavigationResponseDescriptorSchema: z.ZodObject<{
responseId: z.ZodString;
url: z.ZodString;
status: z.ZodNumber;
statusText: z.ZodString;
headers: z.ZodRecord<z.ZodString, z.ZodString>;
fromServiceWorker: z.ZodBoolean;
}, z.core.$strict>;
declare const PageEventNameSchema: z.ZodEnum<{
console: "console";
}>;
declare const PageCDPEventSchema: z.ZodObject<{
pageId: z.ZodString;
method: z.ZodEnum<{
"Runtime.consoleAPICalled": "Runtime.consoleAPICalled";
}>;
params: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
sessionId: z.ZodString;
targetId: z.ZodString;
}, z.core.$strict>;
declare const WebMCPAnnotationSchema: z.ZodObject<{
readOnly: z.ZodOptional<z.ZodBoolean>;
untrustedContent: z.ZodOptional<z.ZodBoolean>;
autosubmit: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>;
declare const WebMCPToolDescriptorSchema: z.ZodObject<{
name: z.ZodString;
description: z.ZodString;
inputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
annotations: z.ZodOptional<z.ZodObject<{
readOnly: z.ZodOptional<z.ZodBoolean>;
untrustedContent: z.ZodOptional<z.ZodBoolean>;
autosubmit: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>>;
frameId: z.ZodString;
backendNodeId: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>;
declare const WebMCPToolIdentitySchema: z.ZodObject<{
frameId: z.ZodString;
name: z.ZodString;
}, z.core.$strict>;
declare const WebMCPInvocationDescriptorSchema: z.ZodObject<{
invocationId: z.ZodString;
toolName: z.ZodString;
frameId: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>;
declare const WebMCPInvocationStatusSchema: z.ZodEnum<{
Completed: "Completed";
Canceled: "Canceled";
Error: "Error";
}>;
declare const WebMCPRemoteObjectSchema: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
declare const WebMCPToolResponseSchema: z.ZodObject<{
invocationId: z.ZodString;
status: z.ZodEnum<{
Completed: "Completed";
Canceled: "Canceled";
Error: "Error";
}>;
output: z.ZodOptional<z.ZodJSONSchema>;
errorText: z.ZodOptional<z.ZodString>;
exception: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
}, z.core.$strict>;
declare const LocatorDescriptorSchema: z.ZodObject<{
selector: z.ZodString;
nth: z.ZodOptional<z.ZodNumber>;
pageId: z.ZodString;
}, z.core.$strict>;
declare const ImplementationInfoSchema: z.ZodObject<{
name: z.ZodString;
version: z.ZodString;
}, z.core.$strict>;
declare const DefaultExtractDataSchema: z.ZodObject<{
extraction: z.ZodString;
}, z.core.$strict>;
declare const ContextSetExtraHTTPHeadersParamsSchema: z.ZodObject<{
headers: z.ZodRecord<z.ZodString, z.ZodString>;
}, z.core.$strict>;
declare const ContextClipboardPasteParamsSchema: z.ZodObject<{
pageId: z.ZodOptional<z.ZodString>;
shortcut: z.ZodOptional<z.ZodEnum<{
"ControlOrMeta+V": "ControlOrMeta+V";
"Meta+V": "Meta+V";
"Control+V": "Control+V";
}>>;
}, z.core.$strict>;
declare const MouseButtonSchema: z.ZodEnum<{
left: "left";
right: "right";
middle: "middle";
}>;
declare const PageReloadParamsSchema: z.ZodObject<{
pageId: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
waitUntil: z.ZodOptional<z.ZodEnum<{
load: "load";
domcontentloaded: "domcontentloaded";
networkidle: "networkidle";
}>>;
timeout: z.ZodOptional<z.ZodNumber>;
ignoreCache: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>>;
}, z.core.$strict>;
declare const PageClickParamsSchema: z.ZodObject<{
pageId: z.ZodString;
x: z.ZodNumber;
y: z.ZodNumber;
options: z.ZodOptional<z.ZodObject<{
button: z.ZodOptional<z.ZodEnum<{
left: "left";
right: "right";
middle: "middle";
}>>;
clickCount: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
declare const PageDragAndDropRoutePointSchema: z.ZodObject<{
x: z.ZodNumber;
y: z.ZodNumber;
}, z.core.$strict>;
declare const PageDragAndDropParamsSchema: z.ZodObject<{
pageId: z.ZodString;
fromX: z.ZodNumber;
fromY: z.ZodNumber;
toX: z.ZodNumber;
toY: z.ZodNumber;
options: z.ZodOptional<z.ZodObject<{
button: z.ZodOptional<z.ZodEnum<{
left: "left";
right: "right";
middle: "middle";
}>>;
steps: z.ZodOptional<z.ZodNumber>;
delay: z.ZodOptional<z.ZodNumber>;
route: z.ZodOptional<z.ZodArray<z.ZodObject<{
x: z.ZodNumber;
y: z.ZodNumber;
}, z.core.$strict>>>;
}, z.core.$strict>>;
}, z.core.$strict>;
declare const PageTypeParamsSchema: z.ZodObject<{
pageId: z.ZodString;
text: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
delay: z.ZodOptional<z.ZodNumber>;
withMistakes: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>>;
}, z.core.$strict>;
declare const PageKeyPressParamsSchema: z.ZodObject<{
pageId: z.ZodString;
key: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
delay: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
declare const PageSetExtraHTTPHeadersParamsSchema: z.ZodObject<{
pageId: z.ZodString;
headers: z.ZodRecord<z.ZodString, z.ZodString>;
}, z.core.$strict>;
declare const PageScreenshotOptionsSchema: z.ZodObject<{
animations: z.ZodOptional<z.ZodEnum<{
disabled: "disabled";
allow: "allow";
}>>;
caret: z.ZodOptional<z.ZodEnum<{
hide: "hide";
initial: "initial";
}>>;
clip: z.ZodOptional<z.ZodObject<{
x: z.ZodNumber;
y: z.ZodNumber;
width: z.ZodNumber;
height: z.ZodNumber;
}, z.core.$strict>>;
fullPage: z.ZodOptional<z.ZodBoolean>;
mask: z.ZodOptional<z.ZodArray<z.ZodObject<{
selector: z.ZodString;
nth: z.ZodOptional<z.ZodNumber>;
pageId: z.ZodString;
}, z.core.$strict>>>;
maskColor: z.ZodOptional<z.ZodString>;
omitBackground: z.ZodOptional<z.ZodBoolean>;
quality: z.ZodOptional<z.ZodNumber>;
scale: z.ZodOptional<z.ZodEnum<{
css: "css";
device: "device";
}>>;
style: z.ZodOptional<z.ZodString>;
timeout: z.ZodOptional<z.ZodNumber>;
type: z.ZodOptional<z.ZodEnum<{
png: "png";
jpeg: "jpeg";
}>>;
}, z.core.$strict>;
declare const PagePDFMarginSchema: z.ZodObject<{
top: z.ZodOptional<z.ZodNumber>;
bottom: z.ZodOptional<z.ZodNumber>;
left: z.ZodOptional<z.ZodNumber>;
right: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>;
declare const PagePDFOptionsSchema: z.ZodObject<{
landscape: z.ZodOptional<z.ZodBoolean>;
displayHeaderFooter: z.ZodOptional<z.ZodBoolean>;
printBackground: z.ZodOptional<z.ZodBoolean>;
scale: z.ZodOptional<z.ZodNumber>;
width: z.ZodOptional<z.ZodNumber>;
height: z.ZodOptional<z.ZodNumber>;
margin: z.ZodOptional<z.ZodObject<{
top: z.ZodOptional<z.ZodNumber>;
bottom: z.ZodOptional<z.ZodNumber>;
left: z.ZodOptional<z.ZodNumber>;
right: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
pageRanges: z.ZodOptional<z.ZodString>;
headerTemplate: z.ZodOptional<z.ZodString>;
footerTemplate: z.ZodOptional<z.ZodString>;
preferCSSPageSize: z.ZodOptional<z.ZodBoolean>;
tagged: z.ZodOptional<z.ZodBoolean>;
outline: z.ZodOptional<z.ZodBoolean>;
timeout: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>;
declare const PageSetViewportSizeParamsSchema: z.ZodObject<{
pageId: z.ZodString;
width: z.ZodNumber;
height: z.ZodNumber;
options: z.ZodOptional<z.ZodObject<{
deviceScaleFactor: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
declare const PageWaitForTimeoutParamsSchema: z.ZodObject<{
pageId: z.ZodString;
ms: z.ZodNumber;
}, z.core.$strict>;
declare const PageWaitForFunctionParamsSchema: z.ZodObject<{
pageId: z.ZodString;
expression: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
polling: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"raf">, z.ZodNumber]>>;
timeout: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
declare const PageWaitForSelectorParamsSchema: z.ZodObject<{
pageId: z.ZodString;
selector: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
state: z.ZodOptional<z.ZodEnum<{
attached: "attached";
detached: "detached";
visible: "visible";
hidden: "hidden";
}>>;
timeout: z.ZodOptional<z.ZodNumber>;
pierceShadow: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>>;
}, z.core.$strict>;
declare const LocatorOptionsSchema: z.ZodObject<{
timeout: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>;
declare const LocatorClickParamsSchema: z.ZodObject<{
selector: z.ZodString;
nth: z.ZodOptional<z.ZodNumber>;
pageId: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
timeout: z.ZodOptional<z.ZodNumber>;
button: z.ZodOptional<z.ZodEnum<{
left: "left";
right: "right";
middle: "middle";
}>>;
clickCount: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
declare const LocatorScrollToParamsSchema: z.ZodObject<{
selector: z.ZodString;
nth: z.ZodOptional<z.ZodNumber>;
pageId: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
timeout: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
percent: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
}, z.core.$strict>;
declare const RgbaColorSchema: z.ZodObject<{
r: z.ZodNumber;
g: z.ZodNumber;
b: z.ZodNumber;
a: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>;
declare const LocatorHighlightParamsSchema: z.ZodObject<{
selector: z.ZodString;
nth: z.ZodOptional<z.ZodNumber>;
pageId: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
timeout: z.ZodOptional<z.ZodNumber>;
durationMs: z.ZodOptional<z.ZodNumber>;
borderColor: z.ZodOptional<z.ZodObject<{
r: z.ZodNumber;
g: z.ZodNumber;
b: z.ZodNumber;
a: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
contentColor: z.ZodOptional<z.ZodObject<{
r: z.ZodNumber;
g: z.ZodNumber;
b: z.ZodNumber;
a: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>>;
}, z.core.$strict>;
declare const LocatorSendClickEventParamsSchema: z.ZodObject<{
selector: z.ZodString;
nth: z.ZodOptional<z.ZodNumber>;
pageId: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
timeout: z.ZodOptional<z.ZodNumber>;
bubbles: z.ZodOptional<z.ZodBoolean>;
cancelable: z.ZodOptional<z.ZodBoolean>;
composed: z.ZodOptional<z.ZodBoolean>;
detail: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
declare const LocatorTypeParamsSchema: z.ZodObject<{
selector: z.ZodString;
nth: z.ZodOptional<z.ZodNumber>;
pageId: z.ZodString;
text: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
timeout: z.ZodOptional<z.ZodNumber>;
delay: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
}, z.core.$strict>;
declare const LocatorSelectOptionParamsSchema: z.ZodObject<{
selector: z.ZodString;
nth: z.ZodOptional<z.ZodNumber>;
pageId: z.ZodString;
options: z.ZodOptional<z.ZodObject<{
timeout: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
values: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
}, z.core.$strict>;
declare const LocatorCentroidResultSchema: z.ZodObject<{
x: z.ZodNumber;
y: z.ZodNumber;
}, z.core.$strict>;
declare const StagehandLogSchema: z.ZodObject<{
level: z.ZodEnum<{
error: "error";
warn: "warn";
info: "info";
debug: "debug";
}>;
message: z.ZodString;
data: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>;
//#endregion
//#region ../protocol/types.d.ts
type Variables = z.infer<typeof VariablesSchema>;
type MouseButton = z.infer<typeof MouseButtonSchema>;
type StagehandMetrics = z.infer<typeof StagehandMetricsSchema>;
type ModelConfig = z.infer<typeof ModelConfigSchema>;
type ModelName = z.infer<typeof ModelNameSchema>;
type Action = z.infer<typeof ActionSchema>;
type ActResultData = z.infer<typeof ActResultDataSchema>;
type ActResult = z.infer<typeof ActResultSchema>;
type ExtractResult$1 = z.infer<typeof ExtractResultSchema>;
type DefaultExtractData = z.infer<typeof DefaultExtractDataSchema>;
type ObserveResult = z.infer<typeof ObserveResultSchema>;
type PageRef = z.infer<typeof PageRefSchema>;
type PageEventName = z.infer<typeof PageEventNameSchema>;
type WebMCPToolIdentity = z.infer<typeof WebMCPToolIdentitySchema>;
type PageCDPEvent = z.infer<typeof PageCDPEventSchema>;
type PageNavigationOptions = z.infer<typeof PageNavigationOptionsSchema>;
type NavigationHeader = z.infer<typeof NavigationHeaderSchema>;
type NavigationSecurityDetails = z.infer<typeof NavigationSecurityDetailsSchema>;
type NavigationServerAddr = z.infer<typeof NavigationServerAddrSchema>;
type NavigationResponseDescriptor = z.infer<typeof NavigationResponseDescriptorSchema>;
type PageScreenshotClip = z.infer<typeof PageScreenshotClipSchema>;
type PageSnapshotOptions = z.infer<typeof PageSnapshotOptionsSchema>;
type SnapshotResult = z.infer<typeof SnapshotResultSchema>;
type WebMCPAnnotation = z.infer<typeof WebMCPAnnotationSchema>;
type WebMCPToolDescriptor = z.infer<typeof WebMCPToolDescriptorSchema>;
type WebMCPInvocationDescriptor = z.infer<typeof WebMCPInvocationDescriptorSchema>;
type WebMCPInvocationStatus = z.infer<typeof WebMCPInvocationStatusSchema>;
type WebMCPRemoteObject = z.infer<typeof WebMCPRemoteObjectSchema>;
type WebMCPToolResponse = z.infer<typeof WebMCPToolResponseSchema>;
type LocatorDescriptor = z.infer<typeof LocatorDescriptorSchema>;
type ImplementationInfo = z.infer<typeof ImplementationInfoSchema>;
type ContextClipboardPasteParams = z.infer<typeof ContextClipboardPasteParamsSchema>;
type ContextSetExtraHTTPHeadersParams = z.infer<typeof ContextSetExtraHTTPHeadersParamsSchema>;
type PageReloadParams = z.infer<typeof PageReloadParamsSchema>;
type PageClickParams = z.infer<typeof PageClickParamsSchema>;
type PageDragAndDropParams = z.infer<typeof PageDragAndDropParamsSchema>;
type PageDragAndDropRoutePoint = z.infer<typeof PageDragAndDropRoutePointSchema>;
type PageTypeParams = z.infer<typeof PageTypeParamsSchema>;
type PageKeyPressParams = z.infer<typeof PageKeyPressParamsSchema>;
type PageSetExtraHTTPHeadersParams = z.infer<typeof PageSetExtraHTTPHeadersParamsSchema>;
type PageScreenshotOptions = z.infer<typeof PageScreenshotOptionsSchema>;
type PagePDFMargin = z.infer<typeof PagePDFMarginSchema>;
type PagePDFOptions = z.infer<typeof PagePDFOptionsSchema>;
type PageSetViewportSizeParams = z.infer<typeof PageSetViewportSizeParamsSchema>;
type PageWaitForTimeoutParams = z.infer<typeof PageWaitForTimeoutParamsSchema>;
type PageWaitForSelectorParams = z.infer<typeof PageWaitForSelectorParamsSchema>;
type PageWaitForFunctionParams = z.infer<typeof PageWaitForFunctionParamsSchema>;
type LocatorOptions = z.infer<typeof LocatorOptionsSchema>;
type LocatorClickParams = z.infer<typeof LocatorClickParamsSchema>;
type LocatorScrollToParams = z.infer<typeof LocatorScrollToParamsSchema>;
type RgbaColor = z.infer<typeof RgbaColorSchema>;
type LocatorHighlightParams = z.infer<typeof LocatorHighlightParamsSchema>;
type LocatorSendClickEventParams = z.infer<typeof LocatorSendClickEventParamsSchema>;
type LocatorTypeParams = z.infer<typeof LocatorTypeParamsSchema>;
type LocatorSelectOptionParams = z.infer<typeof LocatorSelectOptionParamsSchema>;
type CacheStatus = z.infer<typeof CacheStatusSchema>;
type CacheTokenSavings = z.infer<typeof CacheTokenSavingsSchema>;
type CacheMetadata = z.infer<typeof CacheMetadataSchema>;
type StagehandResultUsage = z.infer<typeof StagehandResultUsageSchema>;
type StagehandResultMetadata = z.infer<typeof StagehandResultMetadataSchema>;
type LocatorCentroidResult = z.infer<typeof LocatorCentroidResultSchema>;
type StagehandLog = z.infer<typeof StagehandLogSchema>;
type StagehandRpcNotification = z.infer<typeof StagehandRpcNotificationSchema>;
type Caching = z.infer<typeof CachingSchema>;
type Cookie = z.infer<typeof CookieSchema>;
type CookieParam = z.infer<typeof CookieParamSchema>;
type DomainPolicy = z.infer<typeof DomainPolicySchema>;
type LoadState = z.infer<typeof LoadStateSchema>;
//#endregion
//#region src/commandClient.d.ts
/** The transport-independent command boundary used by Stagehand's public object model. */
interface StagehandCommandClient {
send<Method extends RPCMethod>(method: Method, params: z.input<Method["params"]>): Promise<z.output<Method["result"]>>;
onNotification(listener: (notification: StagehandRpcNotification) => void): () => void;
}
//#endregion
//#region src/fileUpload.d.ts
type FilePayload = {
name: string;
mimeType?: string;
buffer: ArrayBuffer | Uint8Array | string;
lastModified?: number;
};
type FileInput = string | string[] | FilePayload | FilePayload[];
//#endregion
//#region src/locator.d.ts
type LocatorClickOptions = NonNullable<LocatorClickParams["options"]>;
type LocatorHighlightOptions = NonNullable<LocatorHighlightParams["options"]>;
type LocatorSendClickEventOptions = NonNullable<LocatorSendClickEventParams["options"]>;
type LocatorTypeOptions = NonNullable<LocatorTypeParams["options"]>;
declare class Locator {
readonly rpcClient: StagehandCommandClient;
readonly descriptor: LocatorDescriptor;
constructor(rpcClient: StagehandCommandClient, descriptor: LocatorDescriptor);
click(options?: LocatorClickOptions): Promise<void>;
hover(options?: LocatorOptions): Promise<void>;
fill(value: string, options?: LocatorOptions): Promise<void>;
count(options?: LocatorOptions): Promise<number>;
isChecked(options?: LocatorOptions): Promise<boolean>;
inputValue(options?: LocatorOptions): Promise<string>;
isVisible(options?: LocatorOptions): Promise<boolean>;
innerText(options?: LocatorOptions): Promise<string>;
innerHtml(options?: LocatorOptions): Promise<string>;
textContent(options?: LocatorOptions): Promise<string>;
scrollTo(percent: LocatorScrollToParams["percent"], options?: LocatorOptions): Promise<void>;
centroid(options?: LocatorOptions): Promise<LocatorCentroidResult>;
highlight(options?: LocatorHighlightOptions): Promise<void>;
sendClickEvent(options?: LocatorSendClickEventOptions): Promise<void>;
type(text: string, options?: LocatorTypeOptions): Promise<void>;
selectOption(values: LocatorSelectOptionParams["values"], options?: LocatorOptions): Promise<string[]>;
setInputFiles(files: FileInput, options?: LocatorOptions): Promise<void>;
first(): Locator;
nth(index: number): Locator;
}
//#endregion
//#region src/pageScripts.d.ts
type InitScriptSource<Arg> = string | {
path?: string;
content?: string;
} | ((arg: Arg) => unknown);
//#endregion
//#region src/response.d.ts
type ResponseHeader = NavigationHeader;
type ResponseSecurityDetails = NavigationSecurityDetails;
type ResponseServerAddr = NavigationServerAddr;
declare class Response {
#private;
constructor(rpcClient: StagehandCommandClient, descriptor: NavigationResponseDescriptor);
url(): string;
status(): number;
statusText(): string;
ok(): boolean;
headers(): Record<string, string>;
allHeaders(): Promise<Record<string, string>>;
headerValue(name: string): Promise<string | null>;
headerValues(name: string): Promise<string[]>;
headersArray(): Promise<ResponseHeader[]>;
fromServiceWorker(): boolean;
securityDetails(): Promise<ResponseSecurityDetails | null>;
serverAddr(): Promise<ResponseServerAddr | null>;
body(): Promise<Uint8Array>;
text(): Promise<string>;
json<T = unknown>(): Promise<T>;
finished(): Promise<null | Error>;
}
//#endregion
//#region src/browser/index.d.ts
declare const stagehandBrowserBrand: unique symbol;
type StagehandBrowserProvider = "local" | "browserbase";
type StagehandBrowserOrigin = "launched" | "connected";
/**
* A browser whose Stagehand extension is ready for its first RPC call.
*
* Browser handles are created by Stagehand's browser factories. The private
* brand prevents arbitrary CDP connections from being passed to Stagehand.
*/
interface StagehandBrowser {
readonly [stagehandBrowserBrand]: true;
readonly provider: StagehandBrowserProvider;
readonly origin: StagehandBrowserOrigin;
/** Browserbase session id backing this browser; undefined for local browsers. */
readonly sessionId?: string;
readonly context: BrowserContext;
readonly closed: boolean;
close(): Promise<void>;
}
interface LocalBrowser {
launch(options?: LocalBrowserLaunchOptions): Promise<StagehandBrowser>;
connect(options: LocalBrowserConnectOptions): Promise<StagehandBrowser>;
}
interface BrowserbaseBrowser {
launch(options: BrowserbaseLaunchOptions): Promise<StagehandBrowser>;
connect(options: BrowserbaseConnectOptions): Promise<StagehandBrowser>;
search(options: BrowserbaseSearchOptions): Promise<BrowserbaseSearchResult>;
fetch(options: BrowserbaseFetchOptions): Promise<BrowserbaseFetchResult>;
}
//#endregion
//#region src/clientSchemas.d.ts
declare const LocalBrowserLaunchOptionsSchema: z.ZodObject<{
args: z.ZodOptional<z.ZodArray<z.ZodString>>;
executablePath: z.ZodOptional<z.ZodString>;
port: z.ZodOptional<z.ZodNumber>;
userDataDir: z.ZodOptional<z.ZodString>;
preserveUserDataDir: z.ZodOptional<z.ZodBoolean>;
headless: z.ZodOptional<z.ZodBoolean>;
devtools: z.ZodOptional<z.ZodBoolean>;
chromiumSandbox: z.ZodOptional<z.ZodBoolean>;
ignoreDefaultArgs: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
proxy: z.ZodOptional<z.ZodObject<{
server: z.ZodString;
bypass: z.ZodOptional<z.ZodString>;
username: z.ZodOptional<z.ZodString>;
password: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
locale: z.ZodOptional<z.ZodString>;
viewport: z.ZodOptional<z.ZodObject<{
width: z.ZodNumber;
height: z.ZodNumber;
}, z.core.$strict>>;
deviceScaleFactor: z.ZodOptional<z.ZodNumber>;
hasTouch: z.ZodOptional<z.ZodBoolean>;
ignoreHTTPSErrors: z.ZodOptional<z.ZodBoolean>;
downloadsPath: z.ZodOptional<z.ZodString>;
acceptDownloads: z.ZodOptional<z.ZodBoolean>;
keepAlive: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>;
declare const LocalBrowserConnectOptionsSchema: z.ZodObject<{
cdpUrl: z.ZodString;
headers: z.ZodOptional<z.ZodPreprocess<z.ZodRecord<z.ZodString, z.ZodString>>>;
extensionId: z.ZodOptional<z.ZodString>;
extensionCdpUrl: z.ZodOptional<z.ZodURL>;
}, z.core.$strict>;
/**
* HTTP settings for the Browserbase SDK client that Stagehand creates for session and extension
* management. `apiKey` and `baseUrl` stay top-level so one key authenticates both Browserbase and
* the Stagehand runtime.
*/
type BrowserbaseClientOptions = Pick<ClientOptions, "timeout" | "maxRetries" | "defaultHeaders" | "defaultQuery" | "fetch">;
type BrowserbaseLaunchOptionsInput = Browserbase.SessionCreateParams & {
apiKey: string;
baseUrl?: string;
clientOptions?: BrowserbaseClientOptions;
};
type BrowserbaseLaunchOptionsOutput = Browserbase.SessionCreateParams & {
apiKey: string;
baseUrl: string;
clientOptions?: BrowserbaseClientOptions;
};
/**
* Browserbase owns the session option surface. Keep this object loose so newly added SDK options
* pass through without requiring a Stagehand protocol or schema update.
*/
declare const BrowserbaseLaunchOptionsSchema: z.ZodType<BrowserbaseLaunchOptionsOutput, BrowserbaseLaunchOptionsInput>;
declare const BrowserbaseConnectOptionsSchema: z.ZodObject<{
apiKey: z.ZodString;
baseUrl: z.ZodDefault<z.ZodURL>;
clientOptions: z.ZodOptional<z.ZodType<BrowserbaseClientOptions, BrowserbaseClientOptions, z.core.$ZodTypeInternals<BrowserbaseClientOptions, BrowserbaseClientOptions>>>;
sessionId: z.ZodString;
extensionId: z.ZodOptional<z.ZodString>;
}, z.core.$strict>;
declare const BrowserbaseSearchOptionsSchema: z.ZodObject<{
query: z.ZodString;
numResults: z.ZodOptional<z.ZodInt>;
apiKey: z.ZodString;
baseUrl: z.ZodDefault<z.ZodURL>;
}, z.core.$strict>;
declare const BrowserbaseFetchOptionsSchema: z.ZodObject<{
url: z.ZodURL;
allowInsecureSsl: z.ZodOptional<z.ZodBoolean>;
allowRedirects: z.ZodOptional<z.ZodBoolean>;
format: z.ZodOptional<z.ZodEnum<{
raw: "raw";
json: "json";
markdown: "markdown";
}>>;
proxies: z.ZodOptional<z.ZodBoolean>;
schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
apiKey: z.ZodString;
baseUrl: z.ZodDefault<z.ZodURL>;
}, z.core.$strict>;
declare const BrowserbaseSearchResultSchema: z.ZodObject<{
query: z.ZodString;
requestId: z.ZodString;
results: z.ZodArray<z.ZodObject<{
id: z.ZodString;
title: z.ZodString;
url: z.ZodString;
author: z.ZodOptional<z.ZodNullable<z.ZodString>>;
favicon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
image: z.ZodOptional<z.ZodNullable<z.ZodString>>;
publishedDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
}, z.core.$strip>>;
}, z.core.$strip>;
declare const BrowserbaseFetchResultSchema: z.ZodObject<{
id: z.ZodString;
content: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>;
contentType: z.ZodString;
encoding: z.ZodString;
headers: z.ZodRecord<z.ZodString, z.ZodString>;
statusCode: z.ZodNumber;
}, z.core.$strip>;
declare const WebMCPToolsOptionsSchema: z.ZodObject<{
timeout: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
}, z.core.$strict>;
declare const WebMCPInvokeOptionsSchema: z.ZodObject<{
input: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>>;
}, z.core.$strict>;
declare const WebMCPResultOptionsSchema: z.ZodObject<{
timeout: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>;
/** An LLM callback implemented locally by the SDK consumer. It never crosses the wire. */
declare const ClientLLMSchema: z.ZodObject<{
generate: z.ZodFunction<z.ZodTuple<readonly [z.ZodUnion<readonly [z.ZodObject<{
messages: z.ZodArray<z.ZodObject<{
role: z.ZodEnum<{
user: "user";
assistant: "assistant";
}>;
content: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_use">;
id: z.ZodString;
name: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_result">;
toolUseId: z.ZodString;
content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>], "type">>;
structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
isError: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>], "type">, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_use">;
id: z.ZodString;
name: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_result">;
toolUseId: z.ZodString;
content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>], "type">>;
structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
isError: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>], "type">>]>;
}, z.core.$strict>>;
systemPrompt: z.ZodOptional<z.ZodString>;
temperature: z.ZodOptional<z.ZodNumber>;
stopSequences: z.ZodOptional<z.ZodArray<z.ZodString>>;
responseFormat: z.ZodObject<{
type: z.ZodLiteral<"json_schema">;
name: z.ZodString;
description: z.ZodOptional<z.ZodString>;
schema: z.ZodJSONSchema;
}, z.core.$strict>;
}, z.core.$strict>, z.ZodObject<{
messages: z.ZodArray<z.ZodObject<{
role: z.ZodEnum<{
user: "user";
assistant: "assistant";
}>;
content: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_use">;
id: z.ZodString;
name: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_result">;
toolUseId: z.ZodString;
content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>], "type">>;
structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
isError: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>], "type">, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_use">;
id: z.ZodString;
name: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_result">;
toolUseId: z.ZodString;
content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>], "type">>;
structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
isError: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>], "type">>]>;
}, z.core.$strict>>;
systemPrompt: z.ZodOptional<z.ZodString>;
temperature: z.ZodOptional<z.ZodNumber>;
stopSequences: z.ZodOptional<z.ZodArray<z.ZodString>>;
tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
name: z.ZodString;
title: z.ZodOptional<z.ZodString>;
icons: z.ZodOptional<z.ZodArray<z.ZodObject<{
src: z.ZodURL;
mimeType: z.ZodOptional<z.ZodString>;
sizes: z.ZodOptional<z.ZodArray<z.ZodString>>;
theme: z.ZodOptional<z.ZodEnum<{
light: "light";
dark: "dark";
}>>;
}, z.core.$strict>>>;
description: z.ZodOptional<z.ZodString>;
inputSchema: z.ZodObject<{
$schema: z.ZodOptional<z.ZodString>;
type: z.ZodLiteral<"object">;
properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodJSONSchema>>>;
required: z.ZodOptional<z.ZodArray<z.ZodString>>;
}, z.core.$strict>;
execution: z.ZodOptional<z.ZodObject<{
taskSupport: z.ZodOptional<z.ZodEnum<{
optional: "optional";
required: "required";
forbidden: "forbidden";
}>>;
}, z.core.$strict>>;
outputSchema: z.ZodOptional<z.ZodObject<{
$schema: z.ZodOptional<z.ZodString>;
type: z.ZodLiteral<"object">;
properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodJSONSchema>>>;
required: z.ZodOptional<z.ZodArray<z.ZodString>>;
}, z.core.$strict>>;
annotations: z.ZodOptional<z.ZodObject<{
title: z.ZodOptional<z.ZodString>;
readOnlyHint: z.ZodOptional<z.ZodBoolean>;
destructiveHint: z.ZodOptional<z.ZodBoolean>;
idempotentHint: z.ZodOptional<z.ZodBoolean>;
openWorldHint: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>>;
}, z.core.$strict>>>;
toolChoice: z.ZodOptional<z.ZodObject<{
mode: z.ZodOptional<z.ZodEnum<{
required: "required";
auto: "auto";
none: "none";
}>>;
}, z.core.$strict>>;
responseFormat: z.ZodOptional<z.ZodObject<{
type: z.ZodLiteral<"text">;
}, z.core.$strict>>;
}, z.core.$strict>]>], null>, z.ZodPromise<z.ZodDiscriminatedUnion<[z.ZodObject<{
role: z.ZodEnum<{
user: "user";
assistant: "assistant";
}>;
content: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_use">;
id: z.ZodString;
name: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_result">;
toolUseId: z.ZodString;
content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>], "type">>;
structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
isError: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>], "type">, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_use">;
id: z.ZodString;
name: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_result">;
toolUseId: z.ZodString;
content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>], "type">>;
structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
isError: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>], "type">>]>;
stopReason: z.ZodOptional<z.ZodString>;
usage: z.ZodOptional<z.ZodObject<{
inputTokens: z.ZodNumber;
outputTokens: z.ZodNumber;
totalTokens: z.ZodNumber;
reasoningTokens: z.ZodOptional<z.ZodNumber>;
cachedInputTokens: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
outputFormat: z.ZodLiteral<"text">;
}, z.core.$strict>, z.ZodObject<{
role: z.ZodEnum<{
user: "user";
assistant: "assistant";
}>;
content: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_use">;
id: z.ZodString;
name: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_result">;
toolUseId: z.ZodString;
content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>], "type">>;
structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
isError: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>], "type">, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_use">;
id: z.ZodString;
name: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_result">;
toolUseId: z.ZodString;
content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>], "type">>;
structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
isError: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>], "type">>]>;
stopReason: z.ZodOptional<z.ZodString>;
usage: z.ZodOptional<z.ZodObject<{
inputTokens: z.ZodNumber;
outputTokens: z.ZodNumber;
totalTokens: z.ZodNumber;
reasoningTokens: z.ZodOptional<z.ZodNumber>;
cachedInputTokens: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
outputFormat: z.ZodLiteral<"json_schema">;
structuredContent: z.ZodJSONSchema;
}, z.core.$strict>], "outputFormat">>>;
}, z.core.$strict>;
declare const StagehandClientLogLevelSchema: z.ZodUnion<readonly [z.ZodEnum<{
error: "error";
debug: "debug";
info: "info";
warn: "warn";
}>, z.ZodLiteral<"off">]>;
declare const StagehandClientLogFormatSchema: z.ZodEnum<{
json: "json";
pretty: "pretty";
}>;
declare const StagehandClientLoggingConfigSchema: z.ZodObject<{
level: z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<{
error: "error";
debug: "debug";
info: "info";
warn: "warn";
}>, z.ZodLiteral<"off">]>>;
format: z.ZodDefault<z.ZodEnum<{
json: "json";
pretty: "pretty";
}>>;
onLog: z.ZodOptional<z.ZodCustom<(log: StagehandLog) => void | Promise<void>, (log: StagehandLog) => void | Promise<void>>>;
}, z.core.$strict>;
declare const StagehandClientActOptionsSchema: z.ZodObject<{
model: z.ZodOptional<z.ZodObject<{
apiKey: z.ZodOptional<z.ZodString>;
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
modelName: z.ZodUnion<readonly [z.ZodTemplateLiteral<`openai/${string}`>, z.ZodTemplateLiteral<`anthropic/${string}`>, z.ZodTemplateLiteral<`google/${string}`>, z.ZodTemplateLiteral<`groq/${string}`>, z.ZodTemplateLiteral<`cerebras/${string}`>]>;
}, z.core.$strict>>;
variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodObject<{
value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
description: z.ZodOptional<z.ZodString>;
}, z.core.$strict>]>>>;
timeout: z.ZodOptional<z.ZodNumber>;
cache: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
threshold: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>]>>;
locator: z.ZodOptional<z.ZodCustom<Locator, Locator>>;
ignoreLocators: z.ZodOptional<z.ZodArray<z.ZodCustom<Locator, Locator>>>;
page: z.ZodOptional<z.ZodCustom<Page, Page>>;
}, z.core.$strict>;
declare const StagehandClientObserveOptionsSchema: z.ZodObject<{
model: z.ZodOptional<z.ZodObject<{
apiKey: z.ZodOptional<z.ZodString>;
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
modelName: z.ZodUnion<readonly [z.ZodTemplateLiteral<`openai/${string}`>, z.ZodTemplateLiteral<`anthropic/${string}`>, z.ZodTemplateLiteral<`google/${string}`>, z.ZodTemplateLiteral<`groq/${string}`>, z.ZodTemplateLiteral<`cerebras/${string}`>]>;
}, z.core.$strict>>;
variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodObject<{
value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
description: z.ZodOptional<z.ZodString>;
}, z.core.$strict>]>>>;
timeout: z.ZodOptional<z.ZodNumber>;
cache: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
threshold: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>]>>;
locator: z.ZodOptional<z.ZodCustom<Locator, Locator>>;
ignoreLocators: z.ZodOptional<z.ZodArray<z.ZodCustom<Locator, Locator>>>;
page: z.ZodOptional<z.ZodCustom<Page, Page>>;
}, z.core.$strict>;
declare const StagehandClientExtractOptionsSchema: z.ZodObject<{
model: z.ZodOptional<z.ZodObject<{
apiKey: z.ZodOptional<z.ZodString>;
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
modelName: z.ZodUnion<readonly [z.ZodTemplateLiteral<`openai/${string}`>, z.ZodTemplateLiteral<`anthropic/${string}`>, z.ZodTemplateLiteral<`google/${string}`>, z.ZodTemplateLiteral<`groq/${string}`>, z.ZodTemplateLiteral<`cerebras/${string}`>]>;
}, z.core.$strict>>;
timeout: z.ZodOptional<z.ZodNumber>;
screenshot: z.ZodOptional<z.ZodBoolean>;
cache: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
threshold: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>]>>;
locator: z.ZodOptional<z.ZodCustom<Locator, Locator>>;
ignoreLocators: z.ZodOptional<z.ZodArray<z.ZodCustom<Locator, Locator>>>;
page: z.ZodOptional<z.ZodCustom<Page, Page>>;
}, z.core.$strict>;
declare const StagehandClientCreateConfigSchema: z.ZodObject<{
systemPrompt: z.ZodOptional<z.ZodString>;
cache: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
threshold: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>]>>;
telemetry: z.ZodOptional<z.ZodObject<{
traces: z.ZodObject<{
endpoint: z.ZodURL;
headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
}, z.core.$strict>;
}, z.core.$strict>>;
selfHeal: z.ZodOptional<z.ZodBoolean>;
domSettleTimeoutMs: z.ZodOptional<z.ZodNumber>;
apiKey: z.ZodOptional<z.ZodString>;
apiUrl: z.ZodOptional<z.ZodURL>;
model: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
apiKey: z.ZodOptional<z.ZodString>;
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
modelName: z.ZodUnion<readonly [z.ZodTemplateLiteral<`openai/${string}`>, z.ZodTemplateLiteral<`anthropic/${string}`>, z.ZodTemplateLiteral<`google/${string}`>, z.ZodTemplateLiteral<`groq/${string}`>, z.ZodTemplateLiteral<`cerebras/${string}`>]>;
}, z.core.$strict>, z.ZodObject<{
generate: z.ZodFunction<z.ZodTuple<readonly [z.ZodUnion<readonly [z.ZodObject<{
messages: z.ZodArray<z.ZodObject<{
role: z.ZodEnum<{
user: "user";
assistant: "assistant";
}>;
content: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_use">;
id: z.ZodString;
name: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_result">;
toolUseId: z.ZodString;
content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>], "type">>;
structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
isError: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>], "type">, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_use">;
id: z.ZodString;
name: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_result">;
toolUseId: z.ZodString;
content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>], "type">>;
structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
isError: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>], "type">>]>;
}, z.core.$strict>>;
systemPrompt: z.ZodOptional<z.ZodString>;
temperature: z.ZodOptional<z.ZodNumber>;
stopSequences: z.ZodOptional<z.ZodArray<z.ZodString>>;
responseFormat: z.ZodObject<{
type: z.ZodLiteral<"json_schema">;
name: z.ZodString;
description: z.ZodOptional<z.ZodString>;
schema: z.ZodJSONSchema;
}, z.core.$strict>;
}, z.core.$strict>, z.ZodObject<{
messages: z.ZodArray<z.ZodObject<{
role: z.ZodEnum<{
user: "user";
assistant: "assistant";
}>;
content: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_use">;
id: z.ZodString;
name: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_result">;
toolUseId: z.ZodString;
content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>], "type">>;
structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
isError: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>], "type">, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_use">;
id: z.ZodString;
name: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_result">;
toolUseId: z.ZodString;
content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>], "type">>;
structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
isError: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>], "type">>]>;
}, z.core.$strict>>;
systemPrompt: z.ZodOptional<z.ZodString>;
temperature: z.ZodOptional<z.ZodNumber>;
stopSequences: z.ZodOptional<z.ZodArray<z.ZodString>>;
tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
name: z.ZodString;
title: z.ZodOptional<z.ZodString>;
icons: z.ZodOptional<z.ZodArray<z.ZodObject<{
src: z.ZodURL;
mimeType: z.ZodOptional<z.ZodString>;
sizes: z.ZodOptional<z.ZodArray<z.ZodString>>;
theme: z.ZodOptional<z.ZodEnum<{
light: "light";
dark: "dark";
}>>;
}, z.core.$strict>>>;
description: z.ZodOptional<z.ZodString>;
inputSchema: z.ZodObject<{
$schema: z.ZodOptional<z.ZodString>;
type: z.ZodLiteral<"object">;
properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodJSONSchema>>>;
required: z.ZodOptional<z.ZodArray<z.ZodString>>;
}, z.core.$strict>;
execution: z.ZodOptional<z.ZodObject<{
taskSupport: z.ZodOptional<z.ZodEnum<{
optional: "optional";
required: "required";
forbidden: "forbidden";
}>>;
}, z.core.$strict>>;
outputSchema: z.ZodOptional<z.ZodObject<{
$schema: z.ZodOptional<z.ZodString>;
type: z.ZodLiteral<"object">;
properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodJSONSchema>>>;
required: z.ZodOptional<z.ZodArray<z.ZodString>>;
}, z.core.$strict>>;
annotations: z.ZodOptional<z.ZodObject<{
title: z.ZodOptional<z.ZodString>;
readOnlyHint: z.ZodOptional<z.ZodBoolean>;
destructiveHint: z.ZodOptional<z.ZodBoolean>;
idempotentHint: z.ZodOptional<z.ZodBoolean>;
openWorldHint: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>>;
}, z.core.$strict>>>;
toolChoice: z.ZodOptional<z.ZodObject<{
mode: z.ZodOptional<z.ZodEnum<{
required: "required";
auto: "auto";
none: "none";
}>>;
}, z.core.$strict>>;
responseFormat: z.ZodOptional<z.ZodObject<{
type: z.ZodLiteral<"text">;
}, z.core.$strict>>;
}, z.core.$strict>]>], null>, z.ZodPromise<z.ZodDiscriminatedUnion<[z.ZodObject<{
role: z.ZodEnum<{
user: "user";
assistant: "assistant";
}>;
content: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_use">;
id: z.ZodString;
name: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_result">;
toolUseId: z.ZodString;
content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>], "type">>;
structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
isError: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>], "type">, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_use">;
id: z.ZodString;
name: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_result">;
toolUseId: z.ZodString;
content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>], "type">>;
structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
isError: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>], "type">>]>;
stopReason: z.ZodOptional<z.ZodString>;
usage: z.ZodOptional<z.ZodObject<{
inputTokens: z.ZodNumber;
outputTokens: z.ZodNumber;
totalTokens: z.ZodNumber;
reasoningTokens: z.ZodOptional<z.ZodNumber>;
cachedInputTokens: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
outputFormat: z.ZodLiteral<"text">;
}, z.core.$strict>, z.ZodObject<{
role: z.ZodEnum<{
user: "user";
assistant: "assistant";
}>;
content: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_use">;
id: z.ZodString;
name: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_result">;
toolUseId: z.ZodString;
content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>], "type">>;
structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
isError: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>], "type">, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_use">;
id: z.ZodString;
name: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_result">;
toolUseId: z.ZodString;
content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>], "type">>;
structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
isError: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>], "type">>]>;
stopReason: z.ZodOptional<z.ZodString>;
usage: z.ZodOptional<z.ZodObject<{
inputTokens: z.ZodNumber;
outputTokens: z.ZodNumber;
totalTokens: z.ZodNumber;
reasoningTokens: z.ZodOptional<z.ZodNumber>;
cachedInputTokens: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
outputFormat: z.ZodLiteral<"json_schema">;
structuredContent: z.ZodJSONSchema;
}, z.core.$strict>], "outputFormat">>>;
}, z.core.$strict>]>>;
logging: z.ZodDefault<z.ZodObject<{
level: z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<{
error: "error";
debug: "debug";
info: "info";
warn: "warn";
}>, z.ZodLiteral<"off">]>>;
format: z.ZodDefault<z.ZodEnum<{
json: "json";
pretty: "pretty";
}>>;
onLog: z.ZodOptional<z.ZodCustom<(log: StagehandLog) => void | Promise<void>, (log: StagehandLog) => void | Promise<void>>>;
}, z.core.$strict>>;
}, z.core.$strict>;
declare const StagehandBrowserSchema: z.ZodCustom<StagehandBrowser, StagehandBrowser>;
declare const StagehandCreateOptionsSchema: z.ZodObject<{
systemPrompt: z.ZodOptional<z.ZodString>;
cache: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
threshold: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>]>>;
telemetry: z.ZodOptional<z.ZodObject<{
traces: z.ZodObject<{
endpoint: z.ZodURL;
headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
}, z.core.$strict>;
}, z.core.$strict>>;
selfHeal: z.ZodOptional<z.ZodBoolean>;
domSettleTimeoutMs: z.ZodOptional<z.ZodNumber>;
apiKey: z.ZodOptional<z.ZodString>;
apiUrl: z.ZodOptional<z.ZodURL>;
model: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
apiKey: z.ZodOptional<z.ZodString>;
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
modelName: z.ZodUnion<readonly [z.ZodTemplateLiteral<`openai/${string}`>, z.ZodTemplateLiteral<`anthropic/${string}`>, z.ZodTemplateLiteral<`google/${string}`>, z.ZodTemplateLiteral<`groq/${string}`>, z.ZodTemplateLiteral<`cerebras/${string}`>]>;
}, z.core.$strict>, z.ZodObject<{
generate: z.ZodFunction<z.ZodTuple<readonly [z.ZodUnion<readonly [z.ZodObject<{
messages: z.ZodArray<z.ZodObject<{
role: z.ZodEnum<{
user: "user";
assistant: "assistant";
}>;
content: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_use">;
id: z.ZodString;
name: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_result">;
toolUseId: z.ZodString;
content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>], "type">>;
structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
isError: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>], "type">, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_use">;
id: z.ZodString;
name: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_result">;
toolUseId: z.ZodString;
content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>], "type">>;
structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
isError: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>], "type">>]>;
}, z.core.$strict>>;
systemPrompt: z.ZodOptional<z.ZodString>;
temperature: z.ZodOptional<z.ZodNumber>;
stopSequences: z.ZodOptional<z.ZodArray<z.ZodString>>;
responseFormat: z.ZodObject<{
type: z.ZodLiteral<"json_schema">;
name: z.ZodString;
description: z.ZodOptional<z.ZodString>;
schema: z.ZodJSONSchema;
}, z.core.$strict>;
}, z.core.$strict>, z.ZodObject<{
messages: z.ZodArray<z.ZodObject<{
role: z.ZodEnum<{
user: "user";
assistant: "assistant";
}>;
content: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_use">;
id: z.ZodString;
name: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_result">;
toolUseId: z.ZodString;
content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>], "type">>;
structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
isError: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>], "type">, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_use">;
id: z.ZodString;
name: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_result">;
toolUseId: z.ZodString;
content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>], "type">>;
structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
isError: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>], "type">>]>;
}, z.core.$strict>>;
systemPrompt: z.ZodOptional<z.ZodString>;
temperature: z.ZodOptional<z.ZodNumber>;
stopSequences: z.ZodOptional<z.ZodArray<z.ZodString>>;
tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
name: z.ZodString;
title: z.ZodOptional<z.ZodString>;
icons: z.ZodOptional<z.ZodArray<z.ZodObject<{
src: z.ZodURL;
mimeType: z.ZodOptional<z.ZodString>;
sizes: z.ZodOptional<z.ZodArray<z.ZodString>>;
theme: z.ZodOptional<z.ZodEnum<{
light: "light";
dark: "dark";
}>>;
}, z.core.$strict>>>;
description: z.ZodOptional<z.ZodString>;
inputSchema: z.ZodObject<{
$schema: z.ZodOptional<z.ZodString>;
type: z.ZodLiteral<"object">;
properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodJSONSchema>>>;
required: z.ZodOptional<z.ZodArray<z.ZodString>>;
}, z.core.$strict>;
execution: z.ZodOptional<z.ZodObject<{
taskSupport: z.ZodOptional<z.ZodEnum<{
optional: "optional";
required: "required";
forbidden: "forbidden";
}>>;
}, z.core.$strict>>;
outputSchema: z.ZodOptional<z.ZodObject<{
$schema: z.ZodOptional<z.ZodString>;
type: z.ZodLiteral<"object">;
properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodJSONSchema>>>;
required: z.ZodOptional<z.ZodArray<z.ZodString>>;
}, z.core.$strict>>;
annotations: z.ZodOptional<z.ZodObject<{
title: z.ZodOptional<z.ZodString>;
readOnlyHint: z.ZodOptional<z.ZodBoolean>;
destructiveHint: z.ZodOptional<z.ZodBoolean>;
idempotentHint: z.ZodOptional<z.ZodBoolean>;
openWorldHint: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>>;
}, z.core.$strict>>>;
toolChoice: z.ZodOptional<z.ZodObject<{
mode: z.ZodOptional<z.ZodEnum<{
required: "required";
auto: "auto";
none: "none";
}>>;
}, z.core.$strict>>;
responseFormat: z.ZodOptional<z.ZodObject<{
type: z.ZodLiteral<"text">;
}, z.core.$strict>>;
}, z.core.$strict>]>], null>, z.ZodPromise<z.ZodDiscriminatedUnion<[z.ZodObject<{
role: z.ZodEnum<{
user: "user";
assistant: "assistant";
}>;
content: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_use">;
id: z.ZodString;
name: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_result">;
toolUseId: z.ZodString;
content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>], "type">>;
structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
isError: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>], "type">, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_use">;
id: z.ZodString;
name: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_result">;
toolUseId: z.ZodString;
content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>], "type">>;
structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
isError: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>], "type">>]>;
stopReason: z.ZodOptional<z.ZodString>;
usage: z.ZodOptional<z.ZodObject<{
inputTokens: z.ZodNumber;
outputTokens: z.ZodNumber;
totalTokens: z.ZodNumber;
reasoningTokens: z.ZodOptional<z.ZodNumber>;
cachedInputTokens: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
outputFormat: z.ZodLiteral<"text">;
}, z.core.$strict>, z.ZodObject<{
role: z.ZodEnum<{
user: "user";
assistant: "assistant";
}>;
content: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_use">;
id: z.ZodString;
name: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_result">;
toolUseId: z.ZodString;
content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>], "type">>;
structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
isError: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>], "type">, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_use">;
id: z.ZodString;
name: z.ZodString;
input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"tool_result">;
toolUseId: z.ZodString;
content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
type: z.ZodLiteral<"text">;
text: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>, z.ZodObject<{
type: z.ZodLiteral<"image">;
data: z.ZodBase64;
mimeType: z.ZodString;
annotations: z.ZodOptional<z.ZodObject<{
audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
user: "user";
assistant: "assistant";
}>>>;
priority: z.ZodOptional<z.ZodNumber>;
lastModified: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
}, z.core.$strict>], "type">>;
structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
isError: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strict>], "type">>]>;
stopReason: z.ZodOptional<z.ZodString>;
usage: z.ZodOptional<z.ZodObject<{
inputTokens: z.ZodNumber;
outputTokens: z.ZodNumber;
totalTokens: z.ZodNumber;
reasoningTokens: z.ZodOptional<z.ZodNumber>;
cachedInputTokens: z.ZodOptional<z.ZodNumber>;
}, z.core.$strict>>;
outputFormat: z.ZodLiteral<"json_schema">;
structuredContent: z.ZodJSONSchema;
}, z.core.$strict>], "outputFormat">>>;
}, z.core.$strict>]>>;
logging: z.ZodDefault<z.ZodObject<{
level: z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<{
error: "error";
debug: "debug";
info: "info";
warn: "warn";
}>, z.ZodLiteral<"off">]>>;
format: z.ZodDefault<z.ZodEnum<{
json: "json";
pretty: "pretty";
}>>;
onLog: z.ZodOptional<z.ZodCustom<(log: StagehandLog) => void | Promise<void>, (log: StagehandLog) => void | Promise<void>>>;
}, z.core.$strict>>;
browser: z.ZodCustom<StagehandBrowser, StagehandBrowser>;
}, z.core.$strict>;
type ClientLLM = z.infer<typeof ClientLLMSchema>;
type StagehandClientLoggingConfig = z.input<typeof StagehandClientLoggingConfigSchema>;
type ResolvedStagehandClientLoggingConfig = z.output<typeof StagehandClientLoggingConfigSchema>;
type StagehandClientActOptions = z.input<typeof StagehandClientActOptionsSchema>;
type StagehandClientObserveOptions = z.input<typeof StagehandClientObserveOptionsSchema>;
type StagehandClientExtractOptions = z.input<typeof StagehandClientExtractOptionsSchema>;
type LocalBrowserLaunchOptions = z.infer<typeof LocalBrowserLaunchOptionsSchema>;
interface LocalBrowserConnectOptions extends z.infer<typeof LocalBrowserConnectOptionsSchema> {
/** @deprecated Ignored. Omit this option; Stagehand discovers the installed extension automatically. */
extensionId?: string | undefined;
}
type BrowserbaseLaunchOptions = z.input<typeof BrowserbaseLaunchOptionsSchema>;
interface BrowserbaseConnectOptions extends z.input<typeof BrowserbaseConnectOptionsSchema> {
/** @deprecated Ignored. Omit this option; Stagehand discovers the installed extension automatically. */
extensionId?: string | undefined;
}
type BrowserbaseSearchOptions = z.input<typeof BrowserbaseSearchOptionsSchema>;
type BrowserbaseFetchOptions = z.input<typeof BrowserbaseFetchOptionsSchema>;
type BrowserbaseSearchResult = z.infer<typeof BrowserbaseSearchResultSchema>;
type BrowserbaseFetchResult = z.infer<typeof BrowserbaseFetchResultSchema>;
type StagehandClientCreateConfig = z.input<typeof StagehandClientCreateConfigSchema>;
type StagehandCreateOptions = z.input<typeof StagehandCreateOptionsSchema>;
type ResolvedStagehandCreateOptions = z.output<typeof StagehandCreateOptionsSchema>;
type WebMCPToolsOptions = z.infer<typeof WebMCPToolsOptionsSchema>;
type WebMCPInvokeOptions = z.infer<typeof WebMCPInvokeOptionsSchema>;
type WebMCPResultOptions = z.infer<typeof WebMCPResultOptionsSchema>;
//#endregion
//#region src/webmcp.d.ts
declare class WebMCPTool {
#private;
readonly name: string;
readonly description: string;
readonly inputSchema?: WebMCPToolDescriptor["inputSchema"];
readonly annotations?: WebMCPAnnotation;
readonly frameId: string;
readonly backendNodeId?: number;
constructor(rpcClient: StagehandCommandClient, pageId: string, descriptor: WebMCPToolDescriptor);
invoke(options?: WebMCPInvokeOptions): Promise<WebMCPInvocation>;
}
declare class WebMCPInvocation {
#private;
readonly invocationId: string;
readonly toolName: string;
readonly frameId: string;
readonly input: WebMCPInvocationDescriptor["input"];
constructor(rpcClient: StagehandCommandClient, pageId: string, descriptor: WebMCPInvocationDescriptor);
result(options?: WebMCPResultOptions): Promise<WebMCPToolResponse>;
cancel(): Promise<void>;
}
//#endregion
//#region src/page.d.ts
type ScreenshotOptions = Omit<PageScreenshotOptions, "mask"> & {
mask?: Locator[];
path?: string;
};
type PDFOptions = PagePDFOptions & {
path?: string;
};
type PageClickOptions = NonNullable<PageClickParams["options"]>;
type PageDragAndDropOptions = NonNullable<PageDragAndDropParams["options"]>;
type PageKeyPressOptions = NonNullable<PageKeyPressParams["options"]>;
type PageReloadOptions = NonNullable<PageReloadParams["options"]>;
type PageSetViewportSizeOptions = NonNullable<PageSetViewportSizeParams["options"]>;
type PageTypeOptions = NonNullable<PageTypeParams["options"]>;
type PageWaitForSelectorOptions = NonNullable<PageWaitForSelectorParams["options"]>;
type PageWaitForFunctionOptions = NonNullable<PageWaitForFunctionParams["options"]>;
interface PageEventListener {
(event: PageCDPEvent): unknown;
}
type ToolsAddedListener = (tools: WebMCPTool[]) => unknown;
type ToolsRemovedListener = (tools: WebMCPToolIdentity[]) => unknown;
declare class CDPSubscription {
private readonly rpcClient;
private readonly subscriptionId;
private readonly removeLocalListener;
private readonly onDisposed;
private unsubscribePromise;
constructor(rpcClient: StagehandCommandClient, subscriptionId: string, removeLocalListener: () => void, onDisposed: () => void);
unsubscribe(): Promise<void>;
private unsubscribeOnce;
}
declare class Page {
readonly rpcClient: StagehandCommandClient;
currentRef: PageRef;
private readonly eventSubscriptions;
constructor(rpcClient: StagehandCommandClient, ref: PageRef);
get pageId(): string;
get ref(): PageRef;
goto(url: string, options?: PageNavigationOptions): Promise<Response | null>;
reload(options?: PageReloadOptions): Promise<Response | null>;
goBack(options?: PageNavigationOptions): Promise<Response | null>;
goForward(options?: PageNavigationOptions): Promise<Response | null>;
click(x: number, y: number, options?: PageClickOptions): Promise<void>;
hover(x: number, y: number): Promise<void>;
scroll(x: number, y: number, deltaX: number, deltaY: number): Promise<void>;
dragAndDrop(fromX: number, fromY: number, toX: number, toY: number, options?: PageDragAndDropOptions): Promise<void>;
type(text: string, options?: PageTypeOptions): Promise<void>;
keyPress(key: string, options?: PageKeyPressOptions): Promise<void>;
evaluate<R = unknown, Arg = unknown>(expression: string | ((arg: Arg) => R | Promise<R>), arg?: Arg): Promise<R>;
addInitScript<Arg = unknown>(script: InitScriptSource<Arg>, arg?: Arg): Promise<void>;
on(event: PageEventName, listener: PageEventListener): Promise<CDPSubscription>;
onToolsAdded(listener: ToolsAddedListener): Promise<CDPSubscription>;
onToolsRemoved(listener: ToolsRemovedListener): Promise<CDPSubscription>;
private subscribe;
setExtraHTTPHeaders(headers: PageSetExtraHTTPHeadersParams["headers"]): Promise<void>;
setViewportSize(width: number, height: number, options?: PageSetViewportSizeOptions): Promise<void>;
waitForLoadState(state: LoadState, timeout?: number): Promise<void>;
waitForTimeout(ms: PageWaitForTimeoutParams["ms"]): Promise<void>;
waitForSelector(selector: string, options?: PageWaitForSelectorOptions): Promise<boolean>;
/** Poll in the page's main world until the expression returns a truthy JSON value. */
waitForFunction<R = unknown, Arg = unknown>(expression: string | ((arg: Arg) => R | Promise<R>), arg?: Arg, options?: PageWaitForFunctionOptions): Promise<R>;
screenshot(options?: ScreenshotOptions): Promise<Uint8Array>;
pdf(options?: PDFOptions): Promise<Uint8Array>;
snapshot(options?: PageSnapshotOptions): Promise<SnapshotResult>;
tools(options?: WebMCPToolsOptions): Promise<WebMCPTool[]>;
url(): Promise<string>;
title(): Promise<string>;
close(): Promise<void>;
locator(selector: string): Locator;
}
//#endregion
//#region src/browserClipboard.d.ts
type ClipboardOptions = {
page?: Page;
};
type ClipboardPasteOptions = ClipboardOptions & {
shortcut?: ContextClipboardPasteParams["shortcut"];
};
declare class BrowserClipboard {
readonly rpcClient: StagehandCommandClient;
constructor(rpcClient: StagehandCommandClient);
readText(options?: ClipboardOptions): Promise<string>;
writeText(text: string, options?: ClipboardOptions): Promise<void>;
clear(options?: ClipboardOptions): Promise<void>;
paste(options?: ClipboardPasteOptions): Promise<void>;
copy(options?: ClipboardOptions): Promise<void>;
cut(options?: ClipboardOptions): Promise<void>;
}
//#endregion
//#region src/browserContext.d.ts
type ClearCookieOptions = {
name?: string | RegExp;
domain?: string | RegExp;
path?: string | RegExp;
};
declare class BrowserContext {
readonly rpcClient: StagehandCommandClient;
private readonly closeBrowser?;
clipboardRef?: BrowserClipboard;
constructor(rpcClient: StagehandCommandClient, closeBrowser?: (() => Promise<void>) | undefined);
get clipboard(): BrowserClipboard;
pages(): Promise<Page[]>;
newPage(url?: string): Promise<Page>;
activePage(): Promise<Page | undefined>;
setActivePage(page: Page): Promise<void>;
/** Close the underlying browser. */
close(): Promise<void>;
addInitScript<Arg = unknown>(script: InitScriptSource<Arg>, arg?: Arg): Promise<void>;
setExtraHTTPHeaders(headers: ContextSetExtraHTTPHeadersParams["headers"]): Promise<void>;
getDomainPolicy(): Promise<DomainPolicy | null>;
setDomainPolicy(policy: DomainPolicy | null): Promise<void>;
cookies(urls?: string | string[]): Promise<Cookie[]>;
addCookies(cookies: CookieParam[]): Promise<void>;
clearCookies(options?: ClearCookieOptions): Promise<void>;
}
//#endregion
//#region ../protocol/json-rpc/types.d.ts
type JSONRPCRequest = z.infer<typeof JSONRPCRequestSchema>;
type JSONRPCResponse = z.infer<typeof JSONRPCResponseSchema>;
type JSONRPCMessage = z.infer<typeof JSONRPCMessageSchema>;
//#endregion
//#region src/runtimeCompatibility.d.ts
type RuntimeRequirement = {
protocolVersion: string;
};
/**
* The marker a connected runtime published. Unlike the protocol's `RuntimeDescriptor`, the
* server name is not pinned to "stagehand" so a foreign runtime can be reported as incompatible
* rather than silently treated as unreadable.
*/
type ReportedRuntimeDescriptor = {
protocolVersion: string;
serverInfo: ImplementationInfo;
};
type RuntimeIncompatibilityReason = "protocol-invalid-version" | "protocol-major-mismatch" | "protocol-server-too-old" | "protocol-prerelease-mismatch" | "runtime-name-mismatch";
type RuntimeCompatibility = {
kind: "compatible";
protocolVersion: string;
serverInfo: ImplementationInfo;
} | {
kind: "incompatible";
reason: RuntimeIncompatibilityReason;
detail: string;
required: RuntimeRequirement;
reported: ReportedRuntimeDescriptor;
} | {
kind: "unknown";
reason: "missing-marker" | "unreadable-marker";
detail: string;
};
//#endregion
//#region src/cdpClient.d.ts
type ServiceWorkerInfo = {
targetId: string;
url: string;
title: string;
extensionId?: string;
};
/**
* Raised as soon as the connected Stagehand extension publishes a runtime marker this SDK cannot
* talk to. Initialization does not keep polling: the extension will not change its protocol
* version while the session is open.
*/
declare class StagehandRuntimeIncompatibleError extends Error {
readonly compatibility: Extract<RuntimeCompatibility, {
kind: "incompatible";
}>;
readonly reason: RuntimeIncompatibilityReason;
/** Human-readable negotiation failure, without the version summary or remediation. */
readonly detail: string;
/** Protocol version this SDK speaks. */
readonly clientProtocolVersion: string;
/** Protocol version the connected extension reported. */
readonly reportedProtocolVersion: string;
/** `serverInfo` published by the connected runtime (name + version). */
readonly serverInfo: ImplementationInfo;
readonly remediation: string;
constructor(compatibility: Extract<RuntimeCompatibility, {
kind: "incompatible";
}>);
}
declare class CDPConnectionClosedError extends Error {
constructor(options?: ErrorOptions & {
code?: number;
reason?: string;
});
}
//#endregion
//#region src/rpcErrors.d.ts
declare class RPCResponseTimeoutError extends Error {
readonly method: string;
readonly timeoutMs: number;
constructor(method: string, timeoutMs: number);
}
//#endregion
//#region src/rpcClient.d.ts
type PendingRequest = {
method: RPCMethod;
resolve(value: unknown): void;
reject(error: Error): void;
removeAbortListener?: () => void;
};
type RPCRequestContext = {
readonly requestId: number; /** Aborted when the RPC connection closes. */
readonly signal: AbortSignal;
};
type RegisteredRequestHandler = {
method: RPCMethod;
handle(params: unknown, context: RPCRequestContext): Promise<unknown>;
};
type RPCSendOptions = {
signal?: AbortSignal; /** Replaces the method's derived response deadline for this one request. */
responseTimeoutMs?: number;
};
type CDPTransport = {
readonly serviceWorker: ServiceWorkerInfo;
readonly webSocketDebuggerUrl?: string;
onmessage?: (message: unknown) => void | Promise<void>;
onclose?: (reason?: Error) => void;
onerror?: (error: Error) => void;
send(message: JSONRPCMessage, signal?: AbortSignal): Promise<void>;
close(): void;
};
declare class RPCClient {
readonly serviceWorker: ServiceWorkerInfo;
readonly browserWebSocketDebuggerUrl?: string;
nextRequestId: number;
pending: Map<number, PendingRequest>;
requestHandlers: Map<string, RegisteredRequestHandler>;
notificationListeners: Set<(notification: StagehandRpcNotification) => void>;
pendingNotifications: StagehandRpcNotification[];
closed: boolean;
private readonly closeController;
readonly cdp: CDPTransport;
constructor(cdp: CDPTransport);
send<Method extends RPCMethod>(method: Method, params: z.input<Method["params"]>, options?: RPCSendOptions): Promise<z.output<Method["result"]>>;
sendStagehandInit(params: z.input<typeof StagehandMethods.stagehandInit.params>, signal: AbortSignal): Promise<z.output<typeof StagehandMethods.stagehandInit.result>>;
onRequest<Method extends RPCMethod>(method: Method, handler: (params: z.output<Method["params"]>, context: RPCRequestContext) => z.input<Method["result"]> | Promise<z.input<Method["result"]>>): () => void;
onNotification(listener: (notification: StagehandRpcNotification) => void): () => void;
close(reason?: Error, {
closeTransport
}?: {
closeTransport?: boolean;
}): void;
waitForResponse(id: number, method: RPCMethod, signal?: AbortSignal): Promise<unknown>;
receive(raw: unknown): Promise<void>;
handleRequest(request: JSONRPCRequest): Promise<void>;
receiveResponse(response: JSONRPCResponse): void;
rejectPending(id: number, error: Error): void;
sendError(id: number | null, code: number, message: string, data?: unknown): Promise<void>;
handleNotification(notification: StagehandRpcNotification): void;
}
//#endregion
//#region src/browser/factories.d.ts
declare const localBrowser: LocalBrowser;
declare const browserbase: BrowserbaseBrowser;
//#endregion
//#region src/batch.d.ts
type ExperimentalBatchOptions = {
/** Page exposed as `batch.page`. AI operations still default to the active page. */page?: Page;
/**
* Overall callback deadline in milliseconds, enforced by the browser-side
* executor. The client waits `CALLBACK_BATCH_CLIENT_GRACE_MS` beyond it for
* the response. That local deadline fires when the executor never answers
* at all (stalled navigation, hung service worker), which the browser-side
* `timeout` cannot cover.
*/
timeout?: number;
};
/** Slack the client grants the executor to report its own `timeout` before giving up locally. */
declare const CALLBACK_BATCH_CLIENT_GRACE_MS = 15000;
/**
* The batch round trip exceeded its client-side deadline. The executor may
* still be running the callback; the browser session should be treated as
* unresponsive rather than retried blindly.
*/
declare class StagehandBatchTimeoutError extends Error {
readonly timeout: number;
readonly clientTimeout: number;
constructor(details: {
timeout: number;
clientTimeout: number;
}, options?: ErrorOptions);
}
type ExperimentalBatchBrowserContext = Omit<BrowserContext, "close" | "rpcClient" | "clipboardRef">;
type ExperimentalBatchExtractOptions = StagehandClientExtractOptions;
type ExperimentalBatchContext = {
/** Page selected when the batch starts; this does not change the default target of AI operations. */page: Page;
context: ExperimentalBatchBrowserContext;
act(instruction: string | Action, options?: StagehandClientActOptions): Promise<ActResult>;
observe(instruction?: string, options?: StagehandClientObserveOptions): Promise<ObserveResult>;
extract(instruction: string, options?: ExperimentalBatchExtractOptions): Promise<unknown>;
extract(instruction: string, schema: unknown, options?: ExperimentalBatchExtractOptions): Promise<unknown>;
metrics(): Promise<StagehandMetrics>;
};
type ExperimentalBatchCallback<Input, Result> = (batch: ExperimentalBatchContext, input: Input) => Result | Promise<Result>;
//#endregion
//#region src/stagehand.d.ts
type ProtocolExtractResult = ExtractResult$1;
type ExtractResult<Schema extends z.ZodType> = Omit<ProtocolExtractResult, "data"> & {
data: z.output<Schema>;
};
declare class Stagehand {
private readonly browserHandle;
private readonly createConfig;
isInitialized: boolean;
rpcClient: RPCClient | undefined;
removeNotificationListener: (() => void) | undefined;
removeClientLLMHandler: (() => void) | undefined;
private removeBrowserbaseTransport;
closePromise: Promise<void> | undefined;
initRequestStarted: boolean;
private constructor();
static create(input: StagehandCreateOptions): Promise<Stagehand>;
get browser(): StagehandBrowser;
get initialized(): boolean;
metrics(): Promise<StagehandMetrics>;
experimentalBatch<Result>(callback: ExperimentalBatchCallback<undefined, Result>): Promise<Awaited<Result>>;
experimentalBatch<Input, Result>(callback: ExperimentalBatchCallback<Input, Result>, input: Input, options?: ExperimentalBatchOptions): Promise<Awaited<Result>>;
private initialize;
act(instruction: string, options?: StagehandClientActOptions): Promise<ActResult>;
act(instruction: Action, options?: StagehandClientActOptions): Promise<ActResult>;
observe(instruction?: string, options?: StagehandClientObserveOptions): Promise<ObserveResult>;
extract(instruction: string, options?: StagehandClientExtractOptions): Promise<ExtractResult<z.ZodType<DefaultExtractData>>>;
extract<Schema extends z.ZodType>(instruction: string, schema: Schema, options?: StagehandClientExtractOptions): Promise<ExtractResult<Schema>>;
close(): Promise<void>;
private get connectedRpcClient();
}
//#endregion
//#region src/extensionAssets.d.ts
/**
* Returns the ZIP archive of the extension bundled with this SDK.
* Save or upload the bytes directly, or extract it to a directory for Chrome's
* Load unpacked option. No browser session is required.
*/
declare function getExtensionArchive(): Promise<Uint8Array>;
//#endregion
export { type ActResult, type ActResultData, type Action, BrowserClipboard, BrowserContext, type BrowserbaseBrowser, type BrowserbaseClientOptions, type BrowserbaseConnectOptions, BrowserbaseConnectOptionsSchema, type BrowserbaseFetchOptions, BrowserbaseFetchOptionsSchema, type BrowserbaseFetchResult, BrowserbaseFetchResultSchema, type BrowserbaseLaunchOptions, BrowserbaseLaunchOptionsSchema, type BrowserbaseSearchOptions, BrowserbaseSearchOptionsSchema, type BrowserbaseSearchResult, BrowserbaseSearchResultSchema, CALLBACK_BATCH_CLIENT_GRACE_MS, CDPConnectionClosedError, CDPSubscription, type CacheMetadata, type CacheStatus, type CacheTokenSavings, type Caching, type ClearCookieOptions, type ClientLLM, ClientLLMSchema, type ClipboardOptions, type ClipboardPasteOptions, type Cookie, type CookieParam, type DomainPolicy, type ExperimentalBatchBrowserContext, type ExperimentalBatchCallback, type ExperimentalBatchContext, type ExperimentalBatchExtractOptions, type ExperimentalBatchOptions, type ExtractResult, type FileInput, type FilePayload, type InitScriptSource, type LoadState, type LocalBrowser, type LocalBrowserConnectOptions, LocalBrowserConnectOptionsSchema, type LocalBrowserLaunchOptions, LocalBrowserLaunchOptionsSchema, Locator, type LocatorCentroidResult, type LocatorClickOptions, type LocatorHighlightOptions, type LocatorOptions, type LocatorSendClickEventOptions, type LocatorTypeOptions, type ModelConfig, type ModelName, type MouseButton, type ObserveResult, type PDFOptions, Page, type PageCDPEvent, type PageClickOptions, type PageDragAndDropOptions, type PageDragAndDropRoutePoint, type PageEventListener, type PageEventName, type PageKeyPressOptions, type PageNavigationOptions, type PagePDFMargin, type PagePDFOptions, type PageReloadOptions, type PageScreenshotClip, type PageSetViewportSizeOptions, type PageSnapshotOptions, type PageTypeOptions, type PageWaitForFunctionOptions, type PageWaitForSelectorOptions, RPCResponseTimeoutError, type ReportedRuntimeDescriptor, type ResolvedStagehandClientLoggingConfig, type ResolvedStagehandCreateOptions, Response, type ResponseHeader, type ResponseSecurityDetails, type ResponseServerAddr, type RgbaColor, type RuntimeCompatibility, type RuntimeIncompatibilityReason, type RuntimeRequirement, type ScreenshotOptions, type SnapshotResult, Stagehand, StagehandBatchTimeoutError, type StagehandBrowser, type StagehandBrowserOrigin, type StagehandBrowserProvider, StagehandBrowserSchema, type StagehandClientActOptions, type StagehandClientCreateConfig, StagehandClientCreateConfigSchema, type StagehandClientExtractOptions, StagehandClientLogFormatSchema, StagehandClientLogLevelSchema, type StagehandClientLoggingConfig, StagehandClientLoggingConfigSchema, type StagehandClientObserveOptions, type StagehandCreateOptions, StagehandCreateOptionsSchema, type StagehandMetrics, type StagehandResultMetadata, type StagehandResultUsage, StagehandRuntimeIncompatibleError, type ToolsAddedListener, type ToolsRemovedListener, type Variables, type WebMCPAnnotation, WebMCPInvocation, type WebMCPInvocationStatus, type WebMCPInvokeOptions, WebMCPInvokeOptionsSchema, type WebMCPRemoteObject, type WebMCPResultOptions, WebMCPResultOptionsSchema, WebMCPTool, type WebMCPToolIdentity, type WebMCPToolResponse, type WebMCPToolsOptions, WebMCPToolsOptionsSchema, browserbase, getExtensionArchive, localBrowser };
//# sourceMappingURL=index.d.mts.map