From 013b5453f369d86b67898ab50e715cd11f324281 Mon Sep 17 00:00:00 2001
From: Will0 <134891278+pr1m8@users.noreply.github.com>
Date: Sat, 12 Sep 2026 02:03:55 +0000
Subject: [PATCH] feat(snapshot): add opt-in locator hints
Assisted-by: Replit
---
.changeset/expanded-snapshots.md | 5 +
packages/docs/v4/reference/page.mdx | 15 +++
.../extension/tests/stagehand-clients.test.ts | 18 +++
packages/extension/types/private/snapshot.ts | 11 ++
.../understudy/a11y/snapshot/a11yTree.ts | 1 +
.../understudy/a11y/snapshot/capture.test.ts | 1 +
.../understudy/a11y/snapshot/capture.ts | 32 ++++-
.../understudy/a11y/snapshot/domTree.test.ts | 79 ++++++++++++-
.../understudy/a11y/snapshot/domTree.ts | 110 +++++++++++++++++-
.../a11y/snapshot/treeFormatUtils.ts | 9 +-
packages/extension/understudy/page.ts | 1 +
packages/protocol/schemas.ts | 1 +
packages/protocol/stagehand.v4.json | 3 +
.../protocol/page-command-schemas.test.ts | 4 +-
.../protocol/page-shared-schemas.test.ts | 9 +-
.../extensionassets/stagehand-extension.zip | Bin 440798 -> 442045 bytes
packages/sdk-go/models.gen.go | 3 +
.../src/stagehand/_generated/input_types.py | 1 +
.../src/stagehand/_generated/models.py | 1 +
packages/sdk-python/src/stagehand/page.py | 14 ++-
packages/sdk-ts/tests/objectWrapper.test.ts | 6 +-
packages/sdk-ts/tests/packageContract.test.ts | 2 +-
22 files changed, 307 insertions(+), 19 deletions(-)
create mode 100644 .changeset/expanded-snapshots.md
diff --git a/.changeset/expanded-snapshots.md b/.changeset/expanded-snapshots.md
new file mode 100644
index 0000000000..7d5bc55cfd
--- /dev/null
+++ b/.changeset/expanded-snapshots.md
@@ -0,0 +1,5 @@
+---
+"@browserbasehq/stagehand": minor
+---
+
+Add opt-in expanded page snapshots with safe, unique locator hints for interactive elements.
diff --git a/packages/docs/v4/reference/page.mdx b/packages/docs/v4/reference/page.mdx
index fff4074143..9b0d8ed8ae 100644
--- a/packages/docs/v4/reference/page.mdx
+++ b/packages/docs/v4/reference/page.mdx
@@ -600,6 +600,11 @@ const snapshot = await page.snapshot();
Whether to include iframe content.
+
+
+ Add safe, unique DOM attribute hints to interactive nodes in the formatted tree.
+ This is disabled by default and excludes password fields.
+
@@ -1264,6 +1269,11 @@ snapshot = await page.snapshot()
Whether to include iframe content.
+
+ Add safe, unique DOM attribute hints to interactive nodes in the formatted tree.
+ This is disabled by default and excludes password fields.
+
+
The operation result.
@@ -2017,6 +2027,11 @@ fmt.Println(snapshot.FormattedTree)
Whether to include iframe content.
+
+
+ Add safe, unique DOM attribute hints to interactive nodes in the formatted tree.
+ This is disabled by default and excludes password fields.
+
diff --git a/packages/extension/tests/stagehand-clients.test.ts b/packages/extension/tests/stagehand-clients.test.ts
index e5dfe29713..1206797b76 100644
--- a/packages/extension/tests/stagehand-clients.test.ts
+++ b/packages/extension/tests/stagehand-clients.test.ts
@@ -1972,6 +1972,24 @@ describe("Stagehand worker clients", () => {
},
]);
expect(page.snapshotCalls).toStrictEqual([{ includeIframes: true }]);
+
+ await expect(
+ handle({
+ jsonrpc: "2.0",
+ id: 32,
+ method: "page.snapshot",
+ params: { page_id: "page-a", options: { expanded: true } },
+ }),
+ ).resolves.toStrictEqual({
+ jsonrpc: "2.0",
+ id: 32,
+ result: {
+ formatted_tree: "root",
+ xpath_map: { frameOne: "/html/body" },
+ url_map: { frameOne: "https://example.test" },
+ },
+ });
+ expect(page.snapshotCalls).toStrictEqual([{ includeIframes: true }, { expanded: true }]);
});
it("routes WebMCP discovery and invocation operations through the owning page", async () => {
diff --git a/packages/extension/types/private/snapshot.ts b/packages/extension/types/private/snapshot.ts
index 70a4476454..63cdc33805 100644
--- a/packages/extension/types/private/snapshot.ts
+++ b/packages/extension/types/private/snapshot.ts
@@ -23,6 +23,8 @@ export type SnapshotOptions = {
* Toggle whether iframe subtrees are included in the merged snapshot. Defaults to true.
*/
includeIframes?: boolean;
+ /** Add unique, safe DOM attribute hints to supported interactive nodes. */
+ locatorHints?: boolean;
};
/**
@@ -55,6 +57,7 @@ export type SessionDomIndex = {
absByBe: Map;
tagByBe: Map;
scrollByBe: Map;
+ locatorHintsByBe: Map;
docRootOf: Map;
contentDocRootByIframe: Map;
enterByBe: Map;
@@ -65,9 +68,15 @@ export type FrameDomMaps = {
tagNameMap: Record;
xpathMap: Record;
scrollableMap: Record;
+ locatorHintsMap: Record;
urlMap: Record;
};
+export type LocatorHint = {
+ text: string;
+ linkOnly?: true;
+};
+
export type ResolvedLocation = {
frameId: string;
backendNodeId: number;
@@ -107,6 +116,7 @@ export type A11yNode = {
childIds?: string[];
children?: A11yNode[];
encodedId?: string;
+ locatorHints?: LocatorHint[];
};
export type A11yOptions = {
@@ -114,6 +124,7 @@ export type A11yOptions = {
isIgnoredBackendNode?: (backendNodeId: number) => boolean;
tagNameMap: Record;
scrollableMap: Record;
+ locatorHintsMap?: Record;
encode: (backendNodeId: number) => string;
};
diff --git a/packages/extension/understudy/a11y/snapshot/a11yTree.ts b/packages/extension/understudy/a11y/snapshot/a11yTree.ts
index 4e0c4d5c76..1dc4d29ba5 100644
--- a/packages/extension/understudy/a11y/snapshot/a11yTree.ts
+++ b/packages/extension/understudy/a11y/snapshot/a11yTree.ts
@@ -145,6 +145,7 @@ export function decorateRoles(
parentId: n.parentId,
childIds: n.childIds,
encodedId,
+ locatorHints: encodedId ? opts.locatorHintsMap?.[encodedId] : undefined,
};
});
}
diff --git a/packages/extension/understudy/a11y/snapshot/capture.test.ts b/packages/extension/understudy/a11y/snapshot/capture.test.ts
index b67bd73ea2..ab1d343d23 100644
--- a/packages/extension/understudy/a11y/snapshot/capture.test.ts
+++ b/packages/extension/understudy/a11y/snapshot/capture.test.ts
@@ -30,6 +30,7 @@ const emptyMaps = (): FrameDomMaps => ({
tagNameMap: {},
xpathMap: {},
scrollableMap: {},
+ locatorHintsMap: {},
urlMap: {},
});
diff --git a/packages/extension/understudy/a11y/snapshot/capture.ts b/packages/extension/understudy/a11y/snapshot/capture.ts
index 0335ed6391..1c2607d955 100644
--- a/packages/extension/understudy/a11y/snapshot/capture.ts
+++ b/packages/extension/understudy/a11y/snapshot/capture.ts
@@ -84,7 +84,12 @@ export async function captureHybridSnapshot(
if (scopedSnapshot) return scopedSnapshot;
}
- const sessionToIndex = await buildSessionIndexes(page, framesInScope, pierce);
+ const sessionToIndex = await buildSessionIndexes(
+ page,
+ framesInScope,
+ pierce,
+ options?.locatorHints,
+ );
const ignoredNodesByFrame = await resolveIgnoredNodes(
page,
options?.ignoreLocators,
@@ -216,12 +221,13 @@ export async function tryScopedSnapshot(
const parentId = context.parentByFrame.get(targetFrameId);
const sameSessionAsParent =
!!parentId && ownerSession(page, parentId) === ownerSession(page, targetFrameId);
- const { tagNameMap, xpathMap, scrollableMap } = await domMapsForSession(
+ const { tagNameMap, xpathMap, scrollableMap, locatorHintsMap } = await domMapsForSession(
owningSess,
targetFrameId,
pierce,
(fid, be) => `${page.getOrdinal(fid)}-${be}`,
sameSessionAsParent,
+ options?.locatorHints === true && targetFrameId === context.rootId,
);
const { outline, urlMap, scopeApplied } = await a11yForFrame(owningSess, targetFrameId, {
@@ -238,6 +244,7 @@ export async function tryScopedSnapshot(
),
tagNameMap,
scrollableMap,
+ locatorHintsMap,
encode: (backendNodeId) => `${page.getOrdinal(targetFrameId)}-${backendNodeId}`,
});
@@ -305,6 +312,7 @@ export async function buildSessionIndexes(
page: Page,
frames: string[],
pierce: boolean,
+ locatorHints = false,
): Promise> {
const sessionToIndex = new Map();
const sessionById = new Map();
@@ -314,7 +322,11 @@ export async function buildSessionIndexes(
if (!sessionById.has(sid)) sessionById.set(sid, sess);
}
for (const [sid, sess] of sessionById.entries()) {
- const idx = await buildSessionDomIndex(sess, pierce);
+ const idx = await buildSessionDomIndex(
+ sess,
+ pierce,
+ locatorHints && sess === ownerSession(page, page.mainFrameId()),
+ );
sessionToIndex.set(sid, idx);
}
return sessionToIndex;
@@ -348,7 +360,11 @@ export async function collectPerFrameMaps(
const sid = sess.id ?? "root";
let idx = sessionToIndex.get(sid);
if (!idx) {
- idx = await buildSessionDomIndex(sess, pierce);
+ idx = await buildSessionDomIndex(
+ sess,
+ pierce,
+ options?.locatorHints === true && frameId === context.rootId,
+ );
sessionToIndex.set(sid, idx);
}
@@ -360,6 +376,7 @@ export async function collectPerFrameMaps(
const tagNameMap: Record = {};
const xpathMap: Record = {};
const scrollableMap: Record = {};
+ const locatorHintsMap: FrameDomMaps["locatorHintsMap"] = {};
const isIgnoredBackendNode = makeIsIgnoredBackendNode(frameId, idx, exclusionIntervalsByFrame);
const enc = (be: number) => `${page.getOrdinal(frameId)}-${be}`;
const baseAbs = idx.absByBe.get(docRootBe) ?? "/";
@@ -376,17 +393,22 @@ export async function collectPerFrameMaps(
const tag = idx.tagByBe.get(be);
if (tag) tagNameMap[key] = tag;
if (idx.scrollByBe.get(be)) scrollableMap[key] = true;
+ if (options?.locatorHints && frameId === context.rootId) {
+ const hints = idx.locatorHintsByBe.get(be);
+ if (hints) locatorHintsMap[key] = hints;
+ }
}
const { outline, urlMap } = await a11yForFrame(sess, frameId, {
isIgnoredBackendNode,
tagNameMap,
scrollableMap,
+ locatorHintsMap,
encode: (backendNodeId) => `${page.getOrdinal(frameId)}-${backendNodeId}`,
});
perFrameOutlines.push({ frameId, outline });
- perFrameMaps.set(frameId, { tagNameMap, xpathMap, scrollableMap, urlMap });
+ perFrameMaps.set(frameId, { tagNameMap, xpathMap, scrollableMap, locatorHintsMap, urlMap });
}
return { perFrameMaps, perFrameOutlines };
diff --git a/packages/extension/understudy/a11y/snapshot/domTree.test.ts b/packages/extension/understudy/a11y/snapshot/domTree.test.ts
index 719d3168ae..6d24b7ac97 100644
--- a/packages/extension/understudy/a11y/snapshot/domTree.test.ts
+++ b/packages/extension/understudy/a11y/snapshot/domTree.test.ts
@@ -1,7 +1,7 @@
import type { Protocol } from "devtools-protocol";
import { describe, expect, it, vi } from "vitest";
import type { CDPSessionLike } from "../../cdp.js";
-import { getDomTreeWithFallback, hydrateDomTree } from "./domTree.js";
+import { domMapsForSession, getDomTreeWithFallback, hydrateDomTree } from "./domTree.js";
describe("DOM tree adaptive retries", () => {
it("throws the last original DOM.getDocument retry error", async () => {
@@ -53,3 +53,80 @@ describe("DOM tree adaptive retries", () => {
expect(send).toHaveBeenCalledOnce();
});
});
+
+describe("locator hints", () => {
+ it("collects safe unique hints only when requested", async () => {
+ const root = domNode({
+ nodeId: 1,
+ backendNodeId: 1,
+ nodeType: 9,
+ nodeName: "#document",
+ children: [
+ domNode({
+ nodeId: 2,
+ backendNodeId: 2,
+ nodeType: 1,
+ nodeName: "HTML",
+ children: [
+ domNode({
+ nodeId: 3,
+ backendNodeId: 3,
+ nodeType: 1,
+ nodeName: "BUTTON",
+ attributes: ["id", "submit-order", "data-testid", "submit"],
+ }),
+ domNode({
+ nodeId: 4,
+ backendNodeId: 4,
+ nodeType: 1,
+ nodeName: "INPUT",
+ attributes: ["type", "password", "id", "password"],
+ }),
+ ],
+ }),
+ ],
+ });
+ const session = {
+ send: vi.fn(async (method: string) => {
+ if (method === "DOM.enable") return {};
+ if (method === "DOM.getDocument") return { root };
+ throw new Error(`Unexpected method: ${method}`);
+ }),
+ } as unknown as CDPSessionLike;
+
+ const enabled = await domMapsForSession(
+ session,
+ "root",
+ true,
+ (_frame, id) => `0-${id}`,
+ false,
+ true,
+ );
+ const disabled = await domMapsForSession(
+ session,
+ "root",
+ true,
+ (_frame, id) => `0-${id}`,
+ false,
+ false,
+ );
+
+ expect(enabled.locatorHintsMap["0-3"]).toEqual([
+ { text: "#submit-order" },
+ { text: "testid=submit" },
+ ]);
+ expect(enabled.locatorHintsMap["0-4"]).toBeUndefined();
+ expect(disabled.locatorHintsMap).toEqual({});
+ });
+});
+
+function domNode(
+ node: Partial & Pick,
+): Protocol.DOM.Node {
+ return {
+ localName: node.nodeName.toLowerCase(),
+ nodeValue: "",
+ childNodeCount: node.children?.length ?? 0,
+ ...node,
+ } as Protocol.DOM.Node;
+}
diff --git a/packages/extension/understudy/a11y/snapshot/domTree.ts b/packages/extension/understudy/a11y/snapshot/domTree.ts
index 17fe646919..f5515d14f7 100644
--- a/packages/extension/understudy/a11y/snapshot/domTree.ts
+++ b/packages/extension/understudy/a11y/snapshot/domTree.ts
@@ -1,4 +1,5 @@
import type { Protocol } from "devtools-protocol";
+import type { LocatorHint } from "../../../types/private/snapshot.js";
import type { CDPSessionLike } from "../../cdp.js";
import type { SessionDomIndex } from "../../../types/private/snapshot.js";
import { buildChildXPathSegments, joinXPath, normalizeXPath } from "./xpathUtils.js";
@@ -157,10 +158,12 @@ export async function domMapsForSession(
pierce: boolean,
encode: (fid: string, backendNodeId: number) => string,
attemptOwnerLookup = true,
+ locatorHints = false,
): Promise<{
tagNameMap: Record;
xpathMap: Record;
scrollableMap: Record;
+ locatorHintsMap: Record;
}> {
await session.send("DOM.enable").catch(() => {});
const root = await getDomTreeWithFallback(session, pierce);
@@ -186,6 +189,8 @@ export async function domMapsForSession(
const tagNameMap: Record = {};
const xpathMap: Record = {};
const scrollableMap: Record = {};
+ const locatorHintsMap: Record = {};
+ const hintsByBe = locatorHints && pierce ? collectLocatorHints(startNode) : new Map();
type StackEntry = { node: Protocol.DOM.Node; xpath: string };
const stack: StackEntry[] = [{ node: startNode, xpath: "" }];
@@ -199,6 +204,8 @@ export async function domMapsForSession(
xpathMap[encId] = xpath || "/";
const isScrollable = node?.isScrollable === true;
if (isScrollable) scrollableMap[encId] = true;
+ const hints = hintsByBe.get(node.backendNodeId);
+ if (hints) locatorHintsMap[encId] = hints;
}
const kids = node.children ?? [];
@@ -222,7 +229,7 @@ export async function domMapsForSession(
}
}
- return { tagNameMap, xpathMap, scrollableMap };
+ return { tagNameMap, xpathMap, scrollableMap, locatorHintsMap };
}
/**
@@ -233,6 +240,7 @@ export async function domMapsForSession(
export async function buildSessionDomIndex(
session: CDPSessionLike,
pierce: boolean,
+ locatorHints = false,
): Promise {
await session.send("DOM.enable").catch(() => {});
const root = await getDomTreeWithFallback(session, pierce);
@@ -240,6 +248,7 @@ export async function buildSessionDomIndex(
const absByBe = new Map();
const tagByBe = new Map();
const scrollByBe = new Map();
+ const locatorHintsByBe = locatorHints && pierce ? collectLocatorHints(root) : new Map();
const docRootOf = new Map();
const contentDocRootByIframe = new Map();
const enterByBe = new Map();
@@ -315,6 +324,7 @@ export async function buildSessionDomIndex(
absByBe,
tagByBe,
scrollByBe,
+ locatorHintsByBe,
docRootOf,
contentDocRootByIframe,
enterByBe,
@@ -351,6 +361,104 @@ function getAttr(attrs: string[] | undefined, name: string): string | undefined
return undefined;
}
+function collectLocatorHints(root: Protocol.DOM.Node): Map {
+ const attributes: Array<[string, string]> = [
+ ["id", "#"],
+ ["data-testid", "testid="],
+ ["data-test", "test="],
+ ["data-cy", "cy="],
+ ["data-qa", "qa="],
+ ["data-automation-id", "automation-id="],
+ ["name", "name="],
+ ["autocomplete", "autocomplete="],
+ ["aria-label", "aria-label="],
+ ["href", "href="],
+ ["alt", "alt="],
+ ["placeholder", "placeholder="],
+ ];
+ const counts = new Map>();
+ const elements: Protocol.DOM.Node[] = [];
+ const stack: Array<{ node: Protocol.DOM.Node; eligible: boolean }> = [
+ { node: root, eligible: true },
+ ];
+ while (stack.length) {
+ const { node, eligible } = stack.pop()!;
+ if (node.nodeType === 1) {
+ if (eligible) elements.push(node);
+ for (const [attribute] of attributes) {
+ const value = getAttr(node.attributes, attribute);
+ if (!value || value.length > 64) continue;
+ const key =
+ attribute === "autocomplete" || attribute === "id" ? value.toLowerCase() : value;
+ const values = counts.get(attribute) ?? new Map();
+ values.set(key, (values.get(key) ?? 0) + 1);
+ counts.set(attribute, values);
+ }
+ }
+ for (const child of node.children ?? []) stack.push({ node: child, eligible });
+ for (const shadow of node.shadowRoots ?? []) {
+ stack.push({ node: shadow, eligible: eligible && shadow.shadowRootType === "open" });
+ }
+ }
+ const hintsByBe = new Map();
+ for (const node of elements) {
+ const tag = node.nodeName.toLowerCase();
+ if (tag === "input" && getAttr(node.attributes, "type")?.toLowerCase() === "password") continue;
+ const hints: LocatorHint[] = [];
+ for (const [attribute, prefix] of attributes) {
+ const value = getAttr(node.attributes, attribute);
+ if (!value || value.length > 64 || /[\0\uD800-\uDFFF]/u.test(value)) continue;
+ const key = attribute === "autocomplete" || attribute === "id" ? value.toLowerCase() : value;
+ if (counts.get(attribute)?.get(key) !== 1) continue;
+ if (
+ attribute === "id" &&
+ (/\s$/.test(value) ||
+ /^(?::|radix-|headlessui-|mui-|mantine-|chakra-|ember|ext-|yui_)|[a-f\d]{8}|\d{4}/i.test(
+ value,
+ ))
+ ) {
+ continue;
+ }
+ if (
+ (attribute === "name" || attribute === "autocomplete") &&
+ !["input", "textarea", "select", "button"].includes(tag)
+ ) {
+ continue;
+ }
+ if (
+ attribute === "href" &&
+ (!value.startsWith("/") ||
+ value.startsWith("//") ||
+ /[?#\\\s]/.test(value) ||
+ new URL(value, "https://stagehand.invalid").pathname !== value)
+ ) {
+ continue;
+ }
+ if (
+ attribute === "alt" &&
+ tag !== "img" &&
+ !(tag === "input" && getAttr(node.attributes, "type")?.toLowerCase() === "image")
+ ) {
+ continue;
+ }
+ const encoded = /[\s{}"'\\]|\p{Cc}/u.test(value)
+ ? JSON.stringify(value).replace(
+ /[\x7f-\x9f\u2028\u2029]/g,
+ (character) => `\\u${character.charCodeAt(0).toString(16).padStart(4, "0")}`,
+ )
+ : value;
+ hints.push({
+ text: `${prefix}${encoded}`,
+ ...(attribute === "href" ? { linkOnly: true } : {}),
+ });
+ }
+ if (hints.length && typeof node.backendNodeId === "number") {
+ hintsByBe.set(node.backendNodeId, hints);
+ }
+ }
+ return hintsByBe;
+}
+
/** Build an enriched tag name that includes the type attribute for inputs. */
function enrichedTagName(node: Protocol.DOM.Node): string {
const tag = String(node.nodeName).toLowerCase();
diff --git a/packages/extension/understudy/a11y/snapshot/treeFormatUtils.ts b/packages/extension/understudy/a11y/snapshot/treeFormatUtils.ts
index 4928894ca3..a5b3e9f21f 100644
--- a/packages/extension/understudy/a11y/snapshot/treeFormatUtils.ts
+++ b/packages/extension/understudy/a11y/snapshot/treeFormatUtils.ts
@@ -9,7 +9,14 @@ export function formatTreeLine(node: A11yNode, level = 0): string {
const indent = " ".repeat(level);
const labelId = node.encodedId ?? node.nodeId;
const stateFlags = formatStateFlags(node);
- const label = `[${labelId}] ${node.role}${node.name ? `: ${cleanText(node.name)}` : ""}${stateFlags}`;
+ const role = node.role.toLowerCase();
+ const hint =
+ /^(button|link|textbox|searchbox|checkbox|radio|combobox|select|listbox|option|slider|spinbutton|switch|tab|menuitem\w*|treeitem|input|file|input, file)$/.test(
+ role,
+ )
+ ? node.locatorHints?.find((candidate) => !candidate.linkOnly || role === "link")?.text
+ : undefined;
+ const label = `[${labelId}] ${node.role}${node.name ? `: ${cleanText(node.name)}` : ""}${hint ? ` {${hint}}` : ""}${stateFlags}`;
const kids = node.children?.map((c) => formatTreeLine(c, level + 1)).join("\n") ?? "";
return kids ? `${indent}${label}\n${kids}` : `${indent}${label}`;
}
diff --git a/packages/extension/understudy/page.ts b/packages/extension/understudy/page.ts
index 6ec5cb30a0..e0fd10690b 100644
--- a/packages/extension/understudy/page.ts
+++ b/packages/extension/understudy/page.ts
@@ -1884,6 +1884,7 @@ export class Page {
const { combinedTree, combinedXpathMap, combinedUrlMap } = await this.captureSnapshot({
pierceShadow: true,
includeIframes: options?.includeIframes,
+ locatorHints: options?.expanded === true,
});
return {
diff --git a/packages/protocol/schemas.ts b/packages/protocol/schemas.ts
index 87e0be02af..7425d76cb8 100644
--- a/packages/protocol/schemas.ts
+++ b/packages/protocol/schemas.ts
@@ -1339,6 +1339,7 @@ export const SnapshotResultSchema = z
export const PageSnapshotOptionsSchema = z
.strictObject({
includeIframes: z.boolean().optional(),
+ expanded: z.boolean().optional(),
})
.meta({ id: "PageSnapshotOptions" });
diff --git a/packages/protocol/stagehand.v4.json b/packages/protocol/stagehand.v4.json
index c91ab6cc08..01cee50035 100644
--- a/packages/protocol/stagehand.v4.json
+++ b/packages/protocol/stagehand.v4.json
@@ -3802,6 +3802,9 @@
"properties": {
"include_iframes": {
"type": "boolean"
+ },
+ "expanded": {
+ "type": "boolean"
}
},
"additionalProperties": false
diff --git a/packages/protocol/tests/protocol/page-command-schemas.test.ts b/packages/protocol/tests/protocol/page-command-schemas.test.ts
index f5f2509fce..cbda15f5ca 100644
--- a/packages/protocol/tests/protocol/page-command-schemas.test.ts
+++ b/packages/protocol/tests/protocol/page-command-schemas.test.ts
@@ -263,8 +263,8 @@ describe("page command schemas", () => {
});
expect(() => PageScreenshotResultSchema.parse({ data: "iVBORw==", type: "png" })).toThrow();
expect(
- PageSnapshotParamsSchema.parse({ pageId, options: { includeIframes: true } }),
- ).toStrictEqual({ pageId, options: { includeIframes: true } });
+ PageSnapshotParamsSchema.parse({ pageId, options: { includeIframes: true, expanded: true } }),
+ ).toStrictEqual({ pageId, options: { includeIframes: true, expanded: true } });
expect(() =>
PageScreenshotParamsSchema.parse({ pageId, options: { type: "png", quality: 80 } }),
).toThrow();
diff --git a/packages/protocol/tests/protocol/page-shared-schemas.test.ts b/packages/protocol/tests/protocol/page-shared-schemas.test.ts
index 1c49b60ccb..63dd9d4357 100644
--- a/packages/protocol/tests/protocol/page-shared-schemas.test.ts
+++ b/packages/protocol/tests/protocol/page-shared-schemas.test.ts
@@ -50,9 +50,12 @@ describe("shared page protocol schemas", () => {
});
it("parses snapshot options and results", () => {
- expect(PageSnapshotOptionsSchema.parse({ includeIframes: true })).toStrictEqual({
- includeIframes: true,
- });
+ expect(PageSnapshotOptionsSchema.parse({ includeIframes: true, expanded: true })).toStrictEqual(
+ {
+ includeIframes: true,
+ expanded: true,
+ },
+ );
expect(
SnapshotResultSchema.parse({
formattedTree: "root",
diff --git a/packages/sdk-go/internal/extensionassets/stagehand-extension.zip b/packages/sdk-go/internal/extensionassets/stagehand-extension.zip
index 3833853d84f687da61d8ecd646ebc574187bc0bc..c3d822f50709cd2c30c257880fc8dd1536ebdba9 100644
GIT binary patch
delta 361434
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≫7{_-pk+5;A((@#ERgf)3QaR0O8q1^y$z#)nKuSPqAe}R$+XPK1ev^`mYMQVh%>&U^)Eq__kKJaKc*WK&NsYbV#DWH
z$2WU#;J@l4%&R#}pDbLN7};ZPeuy8;=X;SK%Pk_K&|Gzbv8tr&XC`RixI+v3DJE>=
zqqv5bLoOMnA`
zL$(qH!~s);SaQc>m$9ko&B%^mgUEOA4)@!94+pO|g8}T4iZO|{r)X+2qm@FrZW}mw
zWoQA6GMx?CfI@QK)PBKdnVnM6Zmx3gbTl4oSo{=JM8D`jm4RA?&H=1{%2HdSEC9DY
z&!n^OL!->L*FT{?Zy9(k`$EkSX+pc&V*Vd(&;PhfTW9LlL
zJw@*C-kj3S?gEdcht`;Xs^(R<45A*gFNCUvce+F6ruX5G=9LTX?l2#ue^a;(Q)CAiZ6b$?6Rw
z@!1OgL<5neY_Qx8ZfyBvM&KNEN2pgI^FZa?Bu~=t2*ANHcyYpi;{FgI)Xdtm=P$N)
zo*-2C&f_1pRv9|(i@Tj$oqKohe{TQ$=dY_OG6JO&A?*pO)HwO9JbLh3c#RrrvE_RN
zG%V?9dbHSW
zl4+HgU3rxs7$h%$uQKE{Jgy!dBxmWd@E#xJ*_(#UOb)rW55O3h*5blaT=2TO+4UUi
za>;SeGsB|d)G_2aPmR#aU*pn%<$SxmD$ZI{IS8xkWpba1X8iuX*#a5OG#boRRt{+m
zRqR8hE$h@E#o}OWS7~|wbe>V={nPkA8F&-$YL;Jl1GUId&|i{pgp1X*??@Vl2w4I3x^(#X7cEz#DkzCf=e(vhrf3sL}&d
z1^;MrAEmzWAgO>n$Yw)tG%O99i9!F!9rgO>XCpCgMPKRnYKC^;(hnO)Zr{Zj6Y#%g
ze3#&J%D4XG^8+|IYg8lYkmJkf@RS=$X8(}Kh-bZj{OIw&AxM)!$ppE_M_5rl_qq9h
z(Y!-cewN~GBJLE~04^EFdwE$NQQPsC@Y*+Ld&crf#4!4=F)lBP}%eQwY!D5LOD%K!6|dDN1;eq$ugVP7X~6?HVO)?aM7CcIPM=~HM(I&i)qnqC!?WdH@>vB++t*VAX9l+fg(E{=@R7Z>kMo
zG37zJ0!#|8=RmBpWQGmuoS4DdsxlzaJ*1m+^F}iHzf4yWCx*qM$L%D+bkr4CY6<6m
z#c{rX`q=S_8zs~Fw)dQWgk1an?^Uv$1Lq31MM7ANneX5Iyp|imvzu~5;PS;6_rLm*
z%Pv;&#g`B6eWjpcB3VaJ#&T@@*4%%ICn*(w`2aD~r{rT>zkl%g1G_hroyI%PBafyL
z8)jUY@qyE<*w{9Wv!kFjtit?0oXYWkONO5%CzM%5m{P^I*y>onOO&SIKoLxdtZHfuj@~Neo;++PHEHWQ%tWCF1JjdsNdJG
zxrj)+{70$V9`3!pvToD{hCGB&a>a6`?TS8G*qQ&W?5n0HeuGHpjtw?{cfMtRX(Bom
z-6(BnAW07hbysKv%pabdlZNa9`l<>X#x*7C(-jELN+ypGQb%GtR^h1TZ)?pfn$jLm
zM0J_EZiA_&X(Rj#;weICc>NJtMbkzI39HzsTzi04(G2ZEiYB+`*7+2v
zUb96G&Z?T+CKBNbur-1^5R~43Zn`vogU|>|J(G8&HB#S`6cyqk)Bwgd>xQ%%CXe>b
z@b#NR{QuRBQJlkhMIV#tvPI$KDpkK`7dMOAK4w4pFuJChm@iY*G`VNdUTiK>Qa}Bj
zWYS~i%7%4`oVmssjvcyiR=X4*Em>xNrKt^7P40}e^U%iIsyhgsl~4eG4g2sIFMNqF
zh&=pTZ}`zgPyBRO;*G~{RXMGO7ci;oXyu{a+LM?zxNhf4v-`Hb7Hi)VQd7_XrVF2f
z1chr}t++cxPr(fh*G(FVsfoOb=5iYUij
z%+mLKS$@^M@gb+@oBBGV5duJFIgMgq#N?Dmp3@*Wgf~6Z^$?ZCk1!Fc7
zmb)0E4Jwwx*ODmEEmIB=C2EW-mA^qqJUoI-Em#0IK*+x}%|U?qM_Tr{GEF|rL=iGh
zQ*4Dkr_X9@Hc1_+`96r?f1dmpN11DzN|j(0@o+-Hsd~fQtzSofgIF0kov0H78@cg8
z>-Su8Y?x9`1-+L)9)la2y(tWKzP|Cn^FZf^_>c%)atC?HUyxfkN^nD)w0oUJaPMY`
zS(=|(=BPb8K
z%83AI&HBM2(XB)Fx%tzS4*5b(P0TDeNxuFjIB_rb8w?JSd?0=s1s}gH#2oX8QgSto
zvXoFU4K3~BP`NXh_a+6Y#YZs_!Ur{p*INt>)Ee$Np&6R6X;!r|nUY&G#RB!WYD*zz
z)Pke84Fyv3kVW3Ve=Cy6GM%E*ufEb6Y@}s1LXKMFi74@&ilyZat@SF*&Z9D4Ew@!)
zJxi%Z+8TK(&FgDD${&er(cD2zG`vaCo@K6R!NLlZp^$&91p?=@P=R*FaO+VPFM%Tw
zF<3uZAn%R{Hk-O()fP%MyB+P@5x@+%w5*RV;79~9sUn+Le^By7*;dWW3#MyK9WS=Kt)0-
z17zeiD-F4>
z?~-Xq0R9>pE7|{w^q4wi?R)IBj<2YQ7n`yoxnn4GJa}e+08>ztE`LSNml~zhCiEV?JfH
zjJPoD!9u=}_#8
z{ZhFke@gRwwNDApO-P#j1|KPjJCCT|Pg1O~^K*w30am3^c`PQ*_CCcm=Bqw0<6O-Q
zi}|;>RUFZPNs;yb$;+Gbt6i-wiTEXDcWReeJ$1h2s54UE2c=UsX;Ln~1SnpiTp>>?
zt{gQAUx(M0%U3C+6;E5lk)rlFCe1Egw>hm0fB(@V51JU(b_)Tr!bcnq>I&vL$gnI`
zWMW*C3|Ry|kCfNXk>!==o9DZcCr?HQfM;&V&h2$NID*!kVrlVYq%#RafUdyNLh*u?J174cSIkMGRnaR95x!?%l
z5$spm*BLymW?nnuu@l#ETZC*VpkkCE4FQe#lCpy6@8>bLWcxKd$8r(#s?TLm!NdY_
z+Fm2#Y!_0RiXw6X;_wV}@(n6&VkUu?f3V3p*=B`E8i5%#)^EWXGr#d7oMmt|)m5c}
zO7sO0CVxaa!5t7aPNCGl5rtll9^*RtF)8$o)cC)NLI^K%0Vs`+OC+oGe-EA1rtjVD
z4g>67(L#d#jb?pqWO*n572KmM+4!-SSL&P@`OVU~x-EoQ3mJs~%6r!TtNr`Kf0g>8
z)<<(t%GykS{!r`U{%Qa9(((QZkPW&N7@~vx=LfvVM)><|gukvcw=22+DgD;g{jVSF
z`Kc-F#=pdXhy4rIJ8gZxqWKQuKtuaE9y1vI_4@c{t7%F<+0OjkbQ_6A(~TzK`7Av)
z+mLCL%}p{!*F1J5>PW6~)I#x7e}JwA8;;23Rl%FM{ESv0SGgJ&7_d`_p}nfj4+pQt
zZ-;hsFNRWmDeaxUhd7{jijItqUc6Xai9sFp84#oOglAJ_P^06RuUkY#%kLVsvJb(~
znxb~ZitJEWc`g=xDk6lvNK?$U%Gg+CnN*-gWS`5*QSM}GjO!+(H77@df8S@R9IM=`
z2^K8;xqSD}QZr{pb7?{kf1UT{VZHO(rxDe&
z&9)?Hh=A?x^1}2E00Su-O1ak=`(;F(26O#@nh2
zp7CK}El#0^b;6@{G<7z)nsYqrQ;I(jF&O_kaGz#=W
zXeA3A6c(GVjS_l8hnI#dlr!vr8bXl5EQV!#+&`%=;`v<-WW`xsA43|FAAHc1jT?J6
zH;+gP^J!<>EG$9#<>+sDonuL4#U9nBSD2USlXPJh%
zLMH(*H>q_pT={`$207_fy!Fc5R{**tn$T5QT8v2~ApB-8srn6Q&WshQx~;)iNV64P
z@*qY8z%2cv@M;E?kluLtWO}&2Sl#mp)XPXmDY|^cf9hn)XbPcF2vt-J=IWgbF$gMQ
z54=_dLz&V`+UL6dH$I$-Xht56dj4J(agib)E1IlOV#1uLtoF2ZXYmjZv
zp4@}#{9Bw5YCEYR?!WIb>m08?#Qo_@P*hxgaLws^V|uR%BaU^Kfq;HNksofQAs|k4
z`I_@Ee`yK{B|3BMR_)>Z(Vq0}k)GImGEFZvWYw@s*Nf&*iQ?q@B@VX?s3iYfW2BYV
zI$B}%24WF{z_5zW7@-B+
zPL)f&cw*73Ar{8y3@FJ{HMUrDXiNDtty;}huQ+)gR;%TQX_e}ex(374Tu8k)BH1#k
z7(P@1#Vl2&2+H6D1B!8*^(RMiaM*v16=Ui0>k46R?ucu(-xw|NTfwg*Ru>}$x0(NZ
ze?REIMbJ*3B^kARoK~M7H5uNe9DBC%k7@x;rKUm@@JMOy6T*cXyp`ONNj&)FOFeWa
z$I(N7cY2-hKr$!cn>P1-ya++U!8^Yc|nBBJRVr^#td-Wo@nO?O<@S
zbcp+Ia}ET^5LkbBU@?OGg4jdaMqlrP3B0kRLSL^{((dh_K$;Tz2)p3!J>80Ud{a5i
zyLILBjP2u@dz`R2tOMj}E2~eIe_pI_?L6N2?)%Nv4Mw=x(YPK94D~sFc;`<4WY{w{
zL+~;jm`9L-9*%Hf4lLzl2s47F&a;e+OGHf$eco+pSf=A-Cx4zg-uAt
zjln(w!tZeyE!hC}2X)WG&dva1?rwvPE}Zr+Bml|+UDxz4M)W2VTln>_nvNITR$Chw
z%P<%Ye-8&kI;L*pD0_R1e=5r(pVWk1F+c*kAgFc@dU{+AUP1hiAF~Xg>o#dlo0JkeJwO4|GQG697`)D^j=Zn3@H!QPw|N8(aMOV!1-`C+8Z7I1y?FL
zlL^qyGh8ZN18+!4uCBM!-BJ-EUf4=CoBrn5GTmWG#f)}ZAS}S(Fn0KM^+2pXtQd}7
zu7lIre_~=&62@LTsH{#d)yC?ahw&cFt|}+xRi%ACBB2{*!)_?mW1}u&#t~tpN{567
z1wydi_jUzWO^a6@s9KJpb$Lpi#k!nHhObM@wu}`ophkl-
zC**Vs!;I>nJ_iY7uWohds&2kD_0LvRI<4zce*$u7Jw7XkBk01Rqvq`mQI^~_IKbsW
zpPS510sJZ!hxN{sp*x}lDkL5()~JADb?xe!21<5yB$-N4{pI~lq%4`67^>od3nSvJ
z`YZcw8LZn*DjLZpraJHRRG~7G05o${}%AB>{WJA?SN-2K~
ze>|oksH>sYj$zD3tE=VF(NWrY1)Rw-Hr5iIISnxPgtH#4=0J{ZSVPmmukB
zc7PnQK>s+cPA!bR?7K4h1eBx1c8hmB5b|&Hs@Ar
zF7~?!o}Q>^?q{-I0&PQH^IuWim%*8Ps{||iT$?VeNzsX02gGLfJ9L!kACQUO_~6D7
z)`82TF+vxM*?c0ie`|`jsn;1BU-KD|_<9&YBa4p_C)1*dW~FWv+tpTMe*xLC>D2bC
z&m%V}b%QoDIwd$KxP2G9Vt)uv43%i4UtXMdlCnnHE|xV$Gs_$aRP7h59H`d2_KA}5
zaO09K9Ux{6xOtu|t>E$%dJ`5e6x7IWhM#KfXr2;@JJU(?JH+x3hRIG#sCGfAM%dPz
z9Gp8ip2|1l&qb6MckOekj=VKPfg6{(9z7(N)RRbwE;@;+7H
z9_t>$au&?cRvat?Aa!R5ELo>o1TA4LDDB9-d5KZ9b|;J7Ndql|dlX;B1p(#ysS7*$
zNKFy_*s)k`Q(dZ3fKz2La(ypmrD;V}CcCJ@-^<<#dDW!b_yULoe`#QDIeC5*1NBA<
z(?ZSBVjh>~67+Ca*Wgr8YtJ&od9oxiE~^l4qPbs{2IAF~oRPpb<)4vCaQ+1=q)`s`
zX|EC^)-StKj4pGm7Cy-Gv^B1Z_}ymy7h6*QpS^F}j_XLWdscr%i6buo6ak3p%e2`N
zX;P#{oFPS;7kAI1f7n0)D3E1=00sq+#K>H$pZo##lh?9;uD`^4$0ai|Po7g%;6>dU
z=|M!Dled!@85t27u>-7!rm#d(=!PzHUE+CC5S!i&-}BkN#B?KY4W9axN}6=EQ!Jqk
z?H=#O^|b?Se>wWKW_u`Ft+IzMV5bbY{#9ErL@BC&F(SX^e=ml1&HIGjT{cqGE%!{_
z#3F;${ZkJV-By!Xu5%jP;$2kjl^d&{E7%wP5g9WeY{~8=YbZZFh1tH}&0fuRb3*1Y
z1S9n}L+F0%TW|$iinl&Px=tu*o4dnH%4iXZ$y}VRmCj_oJ=cH|4XZ9K_aPa{GBbn+
zY(OFyYLUu?f7T4_SObFK`Wx;mrpI`30tsm2u)$HIQ;nl-L`W?%5y_LPN0=NLZ)DfJ
zE1UGT;6-3yiXE+kQ7uLIAjA|ZRG>B;rZyqsURhDKa0v=TqH-b#!^m%V*qC=oyiy>l
zG?Jd!4os;TV+fucV8$VRT|c6@eLbedu9Odp)K3~owJ
zkLhNQXa(jdHW37#1~>`iap)&M)?!A}g@l5@Kid4)$45u|XUWcLOD}O}nr<7u+=%24
zJ%>pDI8EesoT@MktbH*h_^pQGvdm8~A?Ov;5z&|j9b%XV04(GWE_RiTcn_CTp$&vrc%|lKFYLo>^sH$4m!*J=m|pT`t$L)S1__0AUVxttqFMoNd;bJKLe*
zcGo!z^>W=$XPb~LS#jPNQhMs)apdgOOAdq;H-(SP9ZB6s-;{XT>ZPaTrB<9jC1nqN
zQ{w5Ymz@#R+a#l(KOtog1LKf1*XJ3>b5vYt9HEEyIAZ$ifFZPnW!>Y|?A7%4Bd^6?DUXpiuy}A6e>Y!&m%H-Hf
zt_mt|%K5b^_px&qr`1^x)e=j0NpeM%xn!D~?VFE~;dlg>)Cb6CockZk-43%5NSDiJXsQQ
z`5iuVj=N0|Ck3BrNS36*YB51lGB7N**mBXv^1USI*%t=s%%JC%=u>Nd4ECzI3n4?lIiDL^?d#Z4_m}G%#t7D$(|y@?&oQ)wwjjL^s|pF){+-F|(&@0Uo*?TN
zIQ5t5Rcj1(t4IA{zY%SIiOyMV6N>8QE-DU=A;8VQtK&@b9}S&l4iZ1uW5Rl0qF2<}
z6j1ZQt{wY*u=|AJzC`zbDL4L5?~da>*n0`Uw8Ril5hv#KWK*q0gCi-Rljfb_9r&bW
z_5zM^xpaY6aB{S1QHH~NqqoQ25f;eEOODRLA2w&GJa1r)j@pCjKpZbID%K^d-sAza
zDM-bG0L&&VTEDYCN$Y5Cpi=BaVg1}cX`8-b8fQT>2k|GXJPLRFCv1Gm+B0$%Y(h8=DL?P
zjsYwIL6>5V0V{uWvZgAUM#9<9`6F~Q{?ON0v&Bsdo)2x%yx?io7BewO_VdMPtjxUL
zM`$s{`>=GrzrUOmocc%2x#F)EzFzmzqYrDD>kOS;b~sjdQ{ryt4#-9md+HO$0T(o-
zgT%>ry0GMsM&;EvceVc9fjw;Y*Ecre&_VTCRK^U$V$FX|Z2f)-Gmoh1rSHzuQtmG~
z6t6dT9G-!{mw9qS2t!N6rr36QrIn2p6ReN?3)NJr{R}e%xqg>;RL1lfx6^Na3L%gFLK+Y`U87#^21;RU#SLbpD$@)mCt
z7bcg5V`0cBr$sfM(`xsP#(V*Zz(Q6GR|7wMeSWXy#RF*3Q&tVmhW3u$h1Qh0uvr+H
zye%CBt$%0Rc2*?i6uf|4$lu%3gP0TO1-K^-x}ipT#9DMmvpCv~!=01K$r_l(WK2xW
z)CTy=31BP84(KpuPKw@K`IgJ5$YVrDZkD;i<(aGl3eA?rvOmGu6>IqwxDc{AzFG$}
z*!JmMCj!Lpeq*E)D_P1YF8X7@oc&%`LEEy6M}I9Zb5D=BDT;so2mJG;b!o-;=raVT
zuWF-DrVNm<5#_
zYzMU@UfXjk74_AfFivA|k91mH2i_DeU71mkJ)|T^y7%NRR^#Bcv^)@km-oBKiq9RQ
z7k}vD5G;S$zUDV=pKjwkgipEoKkIfGu8pZXc&4s?&FT&`jYsp@XTE*0?tp%;_flQF
z2Rw;T?j8hD@;p5Rbt!V}R)?bl(P-!$%zKW3xr_FL9OZ7%8vYOnJnErBy0+8II%
z{JlM}T*j2!FeSRFq<}uF_fmXyWpr6;(|cbs)pdOrDb0iq*xcqkA
zRAtiba?Mh5(6|PPyL#>yOtsRL7ZP992-6{oyB#-=4)0F@fzESB{|)PtvQm(tXLvC`
z!@DqJJ{5>F`cD1?)1?#*i@H`%ygKI)mO=HKdwjaFUx+@@gy&~
zCLPK>+9BQE1rVrU(E?9Y{|4G%n%Ok#mqwR?XB)!KVZ7k_gwx&wgP!4;y&aUGlFK@4
zaCyY7jNh1^h)Q30W-D=gEBM@8c7N}vqFpV9)iN?-t35?`?XUSIIU2t98qHqP%SOBD
z9a~!UQQF5~PKx)Px3aD_4SuJUCZg}-@*cjX&U?8%J0-)@(80;!QAHfZaMr33td1@s
zegOovA#@@QEi$C!ac4)CTIh&8wFe)d#asAO_@MCQb8T%KD$~m;F?KG@UVj`Oo;(L|
zRh_EVjt@ERnxy7~X)a5Q7VOk09+x%dPIIi=nB;O$K94?)hMd)PyR8d?`aX@82h-Lp*^@^1}bE$DLn+edfrMCB?lpH@+Nn_Y)&ZKaJd
zX8olxWW6_ShyMifky4JUP;Uv{6y-;C@`sy?USP?^IcXAd|1gn>h-0Ann&RI45myzs
zccQeu*jF?*e^@T1LHhCC+SSOS@+|TJ7)>E0CynXadZC&?VwOl*7JoB)IG?0a8m{8a
zK|YZRh*inDDIeHEG3TibZ02LNuTG6Xv|w6o7@DOgBg|L;Qohcd_EqY*eX~>V{RP?i{1**^YXSynu=AL%
z=lZ97uKvkV`q!(;$5wQs5*i|}7w@9cL$?EK--)Nx5OZGzWRom)&kzQ*|ACG|lX@V#c(LF?T=03Z
zIfe}(ziIlaZIC&Vy2U&siIqeRlff57oZaOj#V&5{PhrxHH67iW#)&C$>kvAhXgy`hubER>BhAFTHCkd?>K@~ef-sfnIY^WBu^jO;
zj5b>|oWs;3!qx#SwJ+)Er~%G%g5MdFu5G|Pp%YEL)k2{o&nE@mx$x0
zM4$}{M=Ax#YO4IDh6ln#k5G+c8IsH_B&xE-D9+_{b6#dS!h=nO2*}uFU7Bm3U)5j|
z%t7jC_wZl>4B$+e?QMTBnd|~YP`GgnlrQNvZS)1yj@xs?WqwrW~4&|3Fm;nhTcL$^`ptpY}o{uGm
zib_gUJyyyK#L(rnM2>QWn0_$B2jQPzikDoN0W$#}mynnN6@Lq;EmHu|tTI2AU#V)B
zyiwH|E;6+lMshGaRSZWCI^!s__QLFg~K&X8MS1Deb5bbMO6v&9o!@FDCdm?w=~{qEVt&
z3yg^BiTAHfu$Ls60T@(Xtf8}$Gr1IA#A*(CkDfz7*M*}hswFE@u%q{u3AbH%+;-QH
zS2FwiV}mR@5K)Jj?Bt!`Du~;X-Tq8>;WE_gym5Fm2Dlw>_lqkuw&btKBrfZhkeLA)
ze+`1l
zK9Q;ed@M|=Sv}S}zov$)OYMF>T^&2B*u9sAm69r$B}jg(SBL5G@pyNN1Wi6KAE&Kk
z7$+qQ8^d9$TxvL39Z$DG{ZJ_`@b#L5f1{)omr5UN^6J!)w!{%|>Se&^G@8G9
zoGi2;@h*0uh3QKYZdu{^|aw=>R@YDaa;;@@ddnd(w?2gLSvBT>xAO<7qXp2pnk
z^PY*1&>_Xlw;cRhy)WCL;-)|noZFpV+@j=Lb|zpkOHh^c8}>>9LZ~q4tX!oef5_8H
zH;{qKi`6
zTG8ape>^JeK>{lSJlM&%imZlwiKZ;$xjas3in+27adIw?g1@~
z2IGg%$B;1|;L5pDwtfX=kaKXWXQpFbn687eY>e%*Z{QH$cX#y1$@qu6e~{<0jJSQq
z&K547QeNL!vY$}#d>tZ?N7D>Y6I-mV)7G+M&GnWVs#lX7S9&wLTt(!gKEarM~4i=g%M5)2KhYQ#78GHnzq_%%_Fb^U_Re_RLqo?G7sicJgj(V?RyI`jRpXkRtWEZUVuH>Ln*kzCt-
zrT{)B>YMyJo^6@BeZM+STwvOgR@iAI=@8{?YCDbMT`i+Ef1Wur>%-|ZQI5u6Yb)Kt
zh0o!@XN0_Xwg_|PE5}h5E{SmF0zx0^
z2RCPy1DbU~fs1~8mj-treyMSMNxIXDX?67{U+OnGTau&*nK6mz2WyMWzK5Mf1Nbh~
zarlr^)Xh;%f1}U*1EQr|%uk7Q`jh}(3B~rOW2Ek!ogfoKPlY6jzk1HFqLna=FA0IJ
z<15T{DdCyK1N9wT{k)~V1Thf|`%hBvrN+U6fNSo47WD*3pi-)8GEM!}Wll+4w;l0<
zt!K^a#=_)@Vvycns!`8#NlQtg81v~VLwn)$@16#2e`&RknCoHr220PQgDd~1UtDCk
zu)G?U<2B_8w8xi5U;H+0woU@fkZmrl^9a6-`@525PQ!b-oHAm>W828z{K2W#hl)#_
zPk!t!B%!%rta-vTRrSlK>;L@_F)0j?Vcs0QM?lMAZP+O5#^v%{3#(7{`sPVkyIc;$
zh50~ue|dWQ=BrPB%tPPEw$MN3{yM!E_OtM=o-euTyI=dIgnUvLDoO
z--iA>4KKP8YMacv+7WfT?`>-gt4`g;P_#7v{2@a?UJtF~Ym!=6U>fT7%Vn{4tEGWS
zJ?+}cX4SVktddvA8dz$0%|()C(?aQJe+L$e#rqd*5tC?GtYle^(=m@)V@TR$SEk%;
z$ZST{uRP`)aFz;}vzQFXxlYx`!aKX@Ob62GnzENofxpYf$FgkcxRJS5zT#Sr>vvj+
zY4>Axw+8c+dDh-uVrypo5%uo@_B?cXP-6hB>L#-f8!)P
z=lScWCTnwjnWXw6$#cnG5G#WAQ#
zy@=tl#1*LxNQJp)0S%pcdEjmdf1nLI=b&00@Zc@UvY^w`vwd_SxIl=PheQOYrlFmF
z`l*Etlrw6RedA1gy<$||Dslgyy#}vcTbMjz-iJ!$p(l(C&yltB^rZEI$U&{=1o!EC
zK05<#zqlgKZAHLh?SvRDw+q>Ohb$xu8svMeBos2>fa6J8do>S=f3mJI`A&mN
z$R4S?Li(t>DUUnB(9@u{vRqSd@X~2A{6S{G){4)Bgd^W=)vi51nv3p!BLgN;^W(~{X4W0tLQW6HFA)q*
z3tW$lBCo`cSe^PhTXJ!?f7p{kGyU{Zn2^NR=$&VK(QNAGUzwGfMx-%3T@V0NnRve6Z5?)wF>c
z_$d-1=lUw94OTM;e@~$YdJ~@>{D2EU3Y58-h7h+%o1JRO{+=5L2JX9(hTH>6rcB;m
zGt$r9vV=}b#E7%cul$GQmA;YqOrIAu;CE)kTI&Dk92eSJW6376^XN7F>2%Q;n_YisF?=K1Nc9z0YMQhE0PokPYxP2rJ$We8rbZ>5}_
zrheac>-#XQi2kg~RI_hI^=X?$*t@_a&b8Ht<|yv}a)%q-cgGFRLn?cm>8X^=4|+%$
zeLaB$qaEN3fBmbAqZ_AF+`|D^I`1;Di7}-^W~i8r#yI!)0V)y1#qF~!B7JJG3xaK`Bu_b1!GG#-Dd)v*y4=
z*N_h|LqWpc$%rNi{xyA|fWXEucQ&K^C64KP;?Ki-LEjLyKRm~GbZdOtu7Jm@X;fAV
z5WSO?%a=xLmy1YyWmqPOB%m^bW9WcPj}%lbm8h%PD|(_l|eZ36tU?npk75s(+RBuU@G#L
zVEzg4%A&`mmAQ`azTL@d
ze=T(h7YmJc01xQzk)CAw0%FxyquU2e`GMeQ8Xw>(lprg#0DJ;-)Sd!U%#inizNONX
z2+QdT1Ol6U9FS4EL&U;a9rhGTS!BVO7f4S}N6lB`?nQcmvXGwu!~eXAPpyR$
z!Fa-ihHBAElUKAyIK^Hj==&4-^|a-m9_Y$#woLM3-O
z!Bp1~!~7niZA}RMB+~_*mLm`WC0+_CAq|9LAaY(b9f7Tae4hW*bOb?*3UV4;e@@!M
z6LS&SEc(F>QR7J^k@)-q8r-6ib)^NfG7Ow8Rkt#(qd6i^9#p(Z^DBOB0ZA1gEdO99
zl1#_?(dq2Ddlu$clr{cB4(B8X
znZ9(t`gctb=|oPfEnXolyVmb>f02(MWg@H0t>G2&?*aM@;iB$qr6E?X%Th!k*(!W3
z@=oZt3Q8y^F>~0rn!*pTUFHyZ`Wl!`PP}XyoLfHxN<=VXC&8U_MrmECwD>_yqL+~o*f>;e-w7XtW6HS
zY3qio%K&{+EGaCp=6bGFY=%91n(+qxThiT~wdjviN#0%Oly=O^(Jc|-Y9g+(Zyrt7
zA)e`peAJt*?W
zTA|O9*-;vT#__Y^0d~v@e-oI0+WnlkK|v-B`fO5kMXAj)iDp}Ge>&=Q3kxPo!I5w8
zt|(Y)6v3>iaf4L#59q<#A{GdMm
z_p;{U!tC6OE(WY>ar54;w#W74~^VG=TvEC+?Zx
z$>UcZ(XZaD$}y~noHnT5so>op`b4|EMdT2lf1Q@+|M7_km%0cyZ+&z9@tsGTcW>Xl
zwfX2@?+f_bK&n(?OMRE}8BPz@ULbuBc9A6dOle@L%;P2ze;34Sv+*8Z0ET;dz%>={
zDcp=!S;$i+zx0taN$nZ)T<+m^m3US>H%cgJD+v@mN&N{3Y59YO1$FrMnw}`Nu#&hl
za4IA>CXCC5&D`8ZqtSxc&wZ=0&hNd?yF_as!~n_enw^TTqF=|_Q&B>K-fTH@#hHNb
zDK6JHGP*Bfe|B8qDtTLU(%|AW?yR?_S7S0)aG=8*{3GY0&3mCD_h!0VHlH9F{Itdd
z1WZTof!`x5E8qiEIRd_T*lUTGm0544x-D){KPsfHP?xIlEo3^!cEE0&$X`V(^%x>A
z7#M`zLTbjze8JAywoCTM87aTmBoO1-xNu3{wuMQOf7N(&ctbJ)ugI^k3wEBvZzI{w
z!n22(Vf5Eu{NwL_k2lGnh7f1?E~`b&{zgJzwwm$*+hds4QcH!0J0D8ur-T5VZVOXd
z(OMxLr#F*ZVLWN>$e`Ng1JvrJs;xj;BN2sU9$pb_1r(9e5=JPqAKV_cPY%bx$d+dG
z!csDle=g!xU|PGgzq{A}wE5uH-FuI2Z9cw#=ic?3n>YUT(XEI0*57`PEQXgq|Kd0H
zkFY+tewgC*EB<}|^q5(NuHet>qZ#DR7CO9GdZ1jqh~op^9VkVo6?Dw3
zATxL&yjt5wywmRt%0`uKM2bBaW+RN(b6xj@(jUei8nCP=1m(Z*M6n~8^s7>Qz
zQ2bveXNI57sagZt!i1!M@uG_w7cbhJVfG+!>_fs?(KL{kM$aa2A`@23=@RGb?c?dm
z$^HawjhIKCzBmlB7nK6Mn<++S>;3?~EXi=oyz!%LC@pJ~J)6q96L*A^E6$qj;u>`p*&UkN+JuBgUAW
zSu1&gxrk|D$ImdIB!RWjV~C%ltv(0(EqL!oOBGWz`07h;eK~W@Pe&VkfKD*WoR1e6
zXiCYyvgM-fv6fKDaBFq+>iGmPl9*8>+yPuPcsre%xN&S7B)=Q~-GB1Gaf;#{r{xMj
z2JjQ4pixUd960(tbo6P%$05D*yw@oMcBfYG5|T{hEf1n#u*(kI-oSt5H7{y6Yp$2B
zL&-=T(ki=f!xO!uGucE?e2JP-dVB>FltvV$Ewsuz?Q1B8viWHS1AX8M0M`7~0XMY<
z0VPyW_l1|k6n=6dqJMC?4i0I2|F3(S%m=|^mfYvrXQP5v_D!7`II-_57alp^AZux*c`>QR1@BM
zoC)rab$O#vVt8=!9J~Mo&&{3VVHCy#vMja{+5-Cm!E+MnPJj5~2>vH>9AYB?CM9lX
z;eQ_qn5qc7I2)VN?UE+PY-cGiqKu)?9%F#D9mnK3nk_l+HztMLgY&rO>xj0Pk6cW-
zIl<097Ul!a1}Wzl-ah*(zk6n{lS8vzo9(;TPd=Lz+{+oGEe&naficKekKkv>TSN6&
ztf=dIA+PTV879x|HWyoCAwYJ(}Nji~Jh#OMzg!$|Ra&nIW
zOJ+F3vNaa|#HDvl2#ilG1Sss<4A(O$J3&wd;Cqi`7=NiyveH^yQMtEQVdmk4T=?Y2
zsGq&Lpt1lcmW&s~$|?Ho=XYa!Sig*=?*jmz_q9hq;Rb|K57iM5wj
z4Hs1LR9O_gF!NkjWvs0)Fmbm+T(9
zv_8t=unwj77Ql#8F-Iv1HpqO|ZULxlnLv}PVo+xlkWyTZERTw&nlicEIR`hRj
z!23SP`mQ2|u;Ws9)CYRwRN0E&rfy5eH4lu2RDU+KUVQ$ClN?%fAF_+YS7Ns5>9af0-L
zA)wLXNVntio=Lv)btv)@`K4%d7#V*laMIy8gW)Ii_CYTwqG@##T|B
zvcuQwFIc1zh->Uwq&7*hMMPJq8|+r=FwVB11q-dscki!p?W5k`>Om~jz^e@m&6DAz
zF(|yC`x_L&0~&J+x5&B$e39oQgI)qxI}Hoa
zd~y#viMhv&FeH>BR6?45X&L61$=*I}A~Yp37-47E%)F1RdmdA&13p0^wS;`2uHUwHF_EWoH>
z_+)$!yyILav|u6D=V?eb{q9b12(M9Uq7kKamRH&B>q>?IQF%@!ng{FIn-ZzSQt@Ix
zAynnCxccQo$yVr*(E0I$Q$T%mAAhIl+&cidE?);S4L8t6TXmRf8s~fpowV!v|KU~Kous3sXHyE~)rUIg?&55b6YRy|DFTEb%fkFf39LN!ASj&Tg2BW-
z*H+~6g4ampS=T({2%2bOv0p6MIp!Hy<;q2e@dBeNk2M~FzX*1J%Yt3&yTl%lQtaO4
z+DdNS#J^}PWZrzfAt_=yU4JmdSX>y~IWu;9dU7J@X@c;c4VWKnw;;VLxL4R3u&zl2
zda*xbJ3Ks@9N|U^e=%ypG_9;7Vuuv8X}XeL!dMtP>wd9n+bZlTTJg5}DRQOwCR}T>
z9b~w804Ra9_i`hF?y8!jzy8nvB~}XLIK|eq&3}Y@UzJ!#zro9+!mF8vaaO7Cty@2}wvKK8mSg5Ddj|ue|Vh@Y!cBY`o==i!tM_
zeukTQ4|52^j^nn0+mAdfM8toZM3)kkyt|>Ihr$
z%k9J6v#W5iF|CIMUm)yj$eVTm4!>TA%c=$8ELUchvjy)hbuPV
zpH3TkdlJ=e@f7NZ_w|bwBUJnRzcF&dMJOEbn57(SeZw>1Z5EIjyHiSF
zv(bH623{SDu^FacpsPy4D!*Ju0Kkb2{Y3w#|sQM(qt?K^yL-`gaN=*VG
ztE5aeq!#*sJ~toyS|eSdxkbo!F=}=Ayg4zqFYrNRSK_7Kg`Vw?Q*D>F!3h;|Jpk#rkwzu7$`f%Re2q{rt7LQ
z3%x&<$&k1Jt%jiBY+M%DCu>eH)2S51tOcDCl(n!yuyIm)?03p*NH`_o=VWLx_UzH2
z1RPY8;Ni#>E@2gInI}|{(1DMahqnP4e`tOrSkK-K+qWExNh>}3**?_h6>-9tLUOoz
zTleqY5Z(>=@;qBPq^a~nDfvP<07t%e(&$~#O=JciS;jk%TIWG^b>!8CDrf$47eFWl4fX+
zP#_Nw;~vI-O00v-%xkVG(N~FKI;-b#(B)wMJhHIF&h2d=)y&?kBIYYYvGW{D-d;VY
zS-bQI2%Fj>ETrL_QpivFw$;e?fAaQd$)kGS2gdGo--n1QOCzVf*pj0T0+|s49{BDa
zaRXib`GyY*#YBps2MC7ZVEWGw#a2i)SYK)E2jb9^0)^Kw`i*hhBORD6IFrzp8aDP2
zi8Dof*qPNN{G?aRCKS}SO}@3kzaAfLQ6FHC3j<%&_MXI2nR|Y4az^-jf7Y2~g5Scy
zI~X`Ht3y&s?=J7%*fCS{b8!pHxTfdghi#6ooMz{_{S@}N^SpppdArUs?_Id7xi`x;
z?>6o4{*Je6`4G_>hC%q=9m9r?zzPr5kvOcaFID)yx>cy7>fWcSr7$cQB6oOBV1y~9
zo2rB2)`xwkV9%vZkp=Hbe|O6E&avm9wZJOcjW+i73?4z^jrFg9xptlnTVhSVb7P0h
ziS1mS8k`G@m^yqS<|>b6x&zIM{w~cQ9U60AQ055(cd4vo8goE$K>$L!RDwI-v*)m9
zK&h0B9R=Y`A+$)j4|L1_{>=naXV&&%OY&@^$=pK^K4%=JWKe|;oj3vT!R$MJY~
zdiYe<9EB`RyReq)`-qw3jKlo}1}}KMkJmi!JCBa*4{l$FonRN2nWe8gpqsVW&yOnX
z!~PzrqHqmT3#0NKF+ElmQ00ELA+*~3tRf%$vsq^*Zm^XW@uO`iTxhYaO1;(wF8ASA
zTr!_qA_fBXGyaV_f5pM%Sm5kS89W#MIj$`~*go&)vAD8~-#)r~$H0B6eae@(0sDDw
zQ~UCt(Lzdoj1}k|&_&kJ;W6$YT^++5hTEGF~-Va}?ZA!cb
zX|zFD8kAdGPkGY72!I_0m^mGQg8rt1pCfnte?-ulHOh@`2jKq_5YKSz
z^nHrutRWff3egjk5MH4t?$=RZ3HXJ6SBZQnA<$zSMh9z-0H))M30e*a5NALR!O=WR
zPaIe%#H3FV{~>`A@o5OG*H@%-a&`!NYw~ESJa+6j#ieizr
zGVSmjruFUGS?JA{c%I%wP0WKtA~LQBMlvi}9jA!PV!VZgGra&nFJN(C%sdm&2J(i2
zPZT@)CyHnE9HY9DB}9j!a(vEIF7bI072N<7?}SBG$t}9^k)G)yVvQNvc*mFVy8#q`
zYr(~x^?F@qcyj5fNjO|hVF$d2)kxJkPFeIa^KbFZPb>%D|Frtb&Vm8!fDSX7w2RX#
zz&;At(?=FF$*Dd2;U^;x0Vpeo;%dHSde=lyGKd!T{ClGYCx<8AmnWh*-$&whza0f!
zeo(^S_~2AN`nu_luE`%W_`f~L9
z2EYJtpn+ciWGwfVE_#lv>b1Bwr_{v_CtDgV-qWt-r^5^fK;#V+pf;CsoT`nv9
zy8QXu^5;LM=8Ek7@Z?>2J;TW0!H<70+rMAfzrTLEib$;AXiG4Nubf#~{3~UD@voG{
zzg9MZ2lwNZMzBos1Up7^5&KG+{w7unHBc7@n*^#8F5{x)}z`VP-fJMc#g!rE8J->9Y*T
ztIe3KAk#-DVgDM0B~A~lP~LqfFOJgGYnFPKM~j7v89Aiv!*m43x(h0QQ!kF@-Z>V%
zEQiyfyNNCZG2+&)MEcqtiu+Y8@e0vx(t4jCcma2x)B)CK(nQ}!y}
zq`lsIdRjMC-`0%2J0O;ELOzTf9L&Qw_}vMDAV6I>l0^qfy0Ux}U?HdbXUbK4=k~HW
z>&Ue!S*6V6l)dqE!{7{!)O+Pg^XeEry9zrMz(wn!s22mO%9sL{zX1<_0h~t$JM0OL
zxG$xiFHNY!tU87K2ZYlOeAm^7#4W6!ip8#Wcw~>HE?U3Mzf}o>it8^_PC9~jPBGGr
zC2S@Xk35%`05&Xpq)^(Y@xh=G8}9n6)m&SSGQ3^O@y+=+I6lyhE^>WE=N+@+Xn}digsEE
zCf#{0Xwgo-uKBgCnATjx{P>HxuywAW{cJPr7zpi@`38PDgl5H&rmz>|hRAFxF;2?k
z?J3ZNP+o*vm6&+SB;4~T?Ni)RhOKf4>x9EDBunpT0JZS14)vyg=@2EnN
zE$Dzo^Au2?ebaBK}WNtHnYEcM}
zGZbC}=r$3TiNtBZeyX&=5s`RXVo{LTD9zbV@s9Yz|8@$0Ap%0BH+=8j{oCKD`C(TN
zW4DVGLqFZOfM0$(E$u0&!v*yd2y^+o$xlxf>H4
zET*CkZ@35mmbyr_&1zbwartQ|V
z@;g(pifxvEoL%w5hiJ&P*Ch@j>O7R^^MExx74miU;RV
zN3uz44G^bvj$rCn(FFG%4CKyqZ?ba+Y;AFto!t^WQNx2$xm&0K$)d%E2O~hRwx(F%g&mB7xZ>x53Nc
z)FKlQ=t4n`XYvxPEDi||+;kzU9M_#k0^buuSYFZ^VM5{^fY)LvxGBmaM73=^KA4;k
zNc}e80s7xg`L+||HcUu1*%r@LQyJzR8?ughDAqX%37Cb2N
zDIhX`BtGRYVZA%V!(2gYgm22v0U%GhISTC8mN9^SVr5
zkGAB4w?>+?Mr0n!|J#xfg^s);3$gxaOPA$;`u0rn-h8V#)2boNU}sVo5;zMyhw$zbOkRfu9n5-spr#a$y61
zg+u9Uqb;DtzuDOMY#6+hkhl#qHv%EJ+cP&Ip4YIZ3xfv$?`+A@h*
zGrho>;(1C1==D0feE~H&e~*q}V_K|#0rb;2qnuDy=SqGyqNXCDep$u2Oum5N^Ml>G
z3R==sUYBU6%#(&jbaFJ$0gOd!wD#~bEhiHZ)