@cbxss/eoka 0.1.0-beta.1 → 0.1.0-beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,6 +1,10 @@
1
1
  # @cbxss/eoka
2
2
 
3
- The Node.js SDK for the eoka NDJSON browser sidecar. The source package remains private and unpublished; npm version `0.1.0-beta.1` is reserved for the qualified beta release and can be built and packed locally for integration testing. It supports **Node.js 24 LTS, starting at 24.21.0** (`^24.21.0`) and exports compiled ESM and TypeScript declarations. Node 22 and Current/non-LTS lines are outside the support policy. CommonJS `require` is not an export.
3
+ The Node.js SDK for the eoka NDJSON browser sidecar. Beta `0.1.0-beta.1` is published under the npm `next` tag; this source checkout prepares **`0.1.0-beta.2`, not yet published or qualified**. The repository source package remains private, with public artifacts staged only by the publication workflow. It supports **Node.js 24 LTS, starting at 24.21.0** (`^24.21.0`) and exports compiled ESM and TypeScript declarations. Node 22 and Current/non-LTS lines are outside the support policy. CommonJS `require` is not an export.
4
+
5
+ ```sh
6
+ npm install @cbxss/eoka@next
7
+ ```
4
8
 
5
9
  ## Current scope and platform qualification
6
10
 
@@ -8,7 +12,7 @@ The SDK provides correlated subprocess transport, typed browser/page operations,
8
12
 
9
13
  Managed targets are `linux-x64-gnu`, `linux-arm64-gnu`, `darwin-x64`, `darwin-arm64`, and `win32-x64`. Linux managed selection requires glibc >= 2.35 and rejects musl/Alpine; Windows arm64 and unknown combinations are rejected before downloads. GNU release artifacts are built on Ubuntu 22.04 and checked for GLIBC requirements no higher than 2.35. Arbitrary source-built or host-development binaries are not qualified by that result.
10
14
 
11
- Both explicit server and Chrome paths are an expert override for managed platform checks, not a new support guarantee. Node.js support does not imply Bun, Deno, browser-side JavaScript, or drop-in Puppeteer compatibility. Packed npm consumption is verified; pnpm/Yarn and registry-backed publication remain separate gates.
15
+ Both explicit server and Chrome paths are an expert override for managed platform checks, not a new support guarantee. Node.js support does not imply Bun, Deno, browser-side JavaScript, or drop-in Puppeteer compatibility. Packed npm consumption and credential-free registry installation with a Linux Chrome smoke are verified for beta.1; beta.2 requires fresh qualification. pnpm/Yarn remain unqualified.
12
16
 
13
17
  ## Managed launch and explicit preparation
14
18
 
@@ -119,10 +123,10 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
119
123
  && rm -rf /var/lib/apt/lists/*
120
124
  WORKDIR /app
121
125
  RUN chown node:node /app
122
- COPY --chown=node:node cbxss-eoka-0.1.0-beta.1.tgz cbxss-eoka-server-linux-x64-gnu-0.1.0-beta.1.tgz ./
126
+ COPY --chown=node:node cbxss-eoka-0.1.0-beta.2.tgz cbxss-eoka-server-linux-x64-gnu-0.1.0-beta.2.tgz ./
123
127
  USER node
124
128
  RUN npm init -y && npm install --ignore-scripts --omit=optional --no-audit --no-fund \
125
- ./cbxss-eoka-server-linux-x64-gnu-0.1.0-beta.1.tgz ./cbxss-eoka-0.1.0-beta.1.tgz
129
+ ./cbxss-eoka-server-linux-x64-gnu-0.1.0-beta.2.tgz ./cbxss-eoka-0.1.0-beta.2.tgz
126
130
  ENV EOKA_BROWSER_CACHE_DIR=/app/browser-cache
127
131
  ENV EOKA_RUNTIME_DIR=/tmp/eoka
128
132
  RUN node node_modules/@cbxss/eoka/examples/install-browser.mjs
@@ -133,7 +137,7 @@ Network is needed during image preparation for npm dependencies and the pinned C
133
137
 
134
138
  ## Build, source staging, and local consumption
135
139
 
136
- This SDK and its five native packages share reserved npm version `0.1.0-beta.1`. The native server is pinned separately to `0.5.0`, published registry core to `0.7.0`, and the protocol to `1.3`; npm version equality is not wire compatibility. Release manifests accept exact semantic versions, including prereleases, but reject floating ranges, tags, and malformed versions. Packaged servers are checked against their name/version/platform, staged release metadata, actual binary digest, and expected handshake version. Explicit servers still must pass the protocol handshake.
140
+ This SDK and its five native packages share reserved npm version `0.1.0-beta.2`. The native server is pinned separately to `0.6.0`, published registry core to `0.7.0`, and the protocol to `1.3`; npm version equality is not wire compatibility. Release manifests accept exact semantic versions, including prereleases, but reject floating ranges, tags, and malformed versions. Packaged servers are checked against their name/version/platform, staged release metadata, actual binary digest, and expected handshake version. Explicit servers still must pass the protocol handshake.
137
141
 
138
142
  The source manifest intentionally has no fabricated hashes for unprepared native artifacts. The source package omits native optional dependencies so a clean `npm ci` does not need unpublished packages. Staging derives all five exact native dependencies from the validated release manifest and adds them to the staged SDK's package metadata. Packing the source SDK alone is useful for import/type gates, but is **not** a ready managed server distribution. Missing native packages (including after `--omit=optional`) raise `ServerPackageMissing`; a present package with an unstaged SDK pin raises `ReleaseNotPrepared`. There is no compile/download fallback.
139
143
 
@@ -166,8 +170,8 @@ In a separate ESM application, install the matching native tarball as a direct d
166
170
 
167
171
  ```sh
168
172
  npm install --ignore-scripts --omit=optional \
169
- /absolute/path/to/cbxss-eoka-server-linux-x64-gnu-0.1.0-beta.1.tgz \
170
- /absolute/path/to/cbxss-eoka-0.1.0-beta.1.tgz
173
+ /absolute/path/to/cbxss-eoka-server-linux-x64-gnu-0.1.0-beta.2.tgz \
174
+ /absolute/path/to/cbxss-eoka-0.1.0-beta.2.tgz
171
175
  npm install --save-dev typescript@5.9.3 @types/node@24.19.2
172
176
  ```
173
177
 
@@ -426,10 +430,26 @@ From the repository root use `mise run node-build`, `node-check`, or `node-consu
426
430
  ## Prerelease qualification and publication
427
431
 
428
432
  Core `0.7.0` is published on crates.io. Reserved prerelease versions are
429
- server/protocol crates `0.5.0`, wire protocol `1.3`, and SDK/native npm packages
430
- `0.1.0-beta.1`. Source and ordinary staged packages remain private;
433
+ server/protocol crates `0.6.0`, wire protocol `1.3`, and SDK/native npm packages
434
+ `0.1.0-beta.2`. Source and ordinary staged packages remain private;
431
435
  `--publication` is a separate, fail-closed staging mode.
432
436
 
437
+ ### Pending beta.2
438
+
439
+ Beta.1 remains published under `next`. Beta.2 repackages the existing native server
440
+ with the Windows operation-lock contention fix and shorter registry-smoke runtime
441
+ paths merged in [PR #63](https://github.com/shrimp-software/eoka-tools/pull/63)
442
+ at `c72892066bb12c51c084166e54059cae3854f0e6`. No Rust, core, protocol, Chrome,
443
+ or dependency version changes are required. Native binaries must be rebuilt from
444
+ the new release source; repacking beta.1 binaries would omit the lock fix.
445
+
446
+ Beta.2 has not been published. Release authorization requires local SDK checks
447
+ and fresh five-platform native qualification (including Windows live-owner
448
+ recovery) in the publication workflow at the exact current protected `main` commit.
449
+ The readiness record's `ready` status means no recorded source defect blocks
450
+ qualification; it is not beta.2 runtime evidence or permission to publish.
451
+ The historical evidence below is retained and does not qualify beta.2.
452
+
433
453
  `.github/workflows/qualify-node-release.yml` builds all five native targets and
434
454
  qualifies installed tarballs outside the repository. GNU builds use Ubuntu 22.04
435
455
  and enforce glibc ≤2.35; runtime checks use non-root hosted runners with Chrome's
@@ -467,6 +487,11 @@ including registry checksum
467
487
  Local host-development staging and `--preview` remain separate from release
468
488
  qualification and cannot authorize publication.
469
489
 
490
+ Every native build runs the live-runtime recovery regression, including Windows.
491
+ A held owner lock must preserve running operations; releasing it permits
492
+ interruption recovery. Only the platform's lock-contention error means the owner
493
+ is still alive; other lock failures remain errors.
494
+
470
495
  `scripts/publication-readiness.json` records unresolved release defects. Clearing
471
496
  a recording blocker requires deterministic repair/preservation regressions and
472
497
  fresh five-platform qualification, not passing samples alone. Every Chrome pin
@@ -489,7 +514,7 @@ the documented native timing defects; changing Chrome's container layout require
489
514
  renewed qualification, not an implicit generic muxer or transcoder.
490
515
 
491
516
  `publish-node.yml` is manual, restricted to an exact current protected `main`
492
- commit, and publishes only `0.1.0-beta.1` under `next` with npm provenance.
517
+ commit, and publishes only `0.1.0-beta.2` under `next` with npm provenance.
493
518
  It requires an existing `npm-prerelease` environment with required reviewers
494
519
  and a single allowed deployment branch, `main`. By default it uses only npm
495
520
  trusted publishing through OIDC, requires self-review to be disabled, and
@@ -511,11 +536,22 @@ Bootstrap accepts an absent name only when both public and authenticated registr
511
536
  reads return 404; an existing private package or an authorization failure aborts.
512
537
  Both modes retain GitHub OIDC provenance and the same qualification checks.
513
538
 
514
- After the first successful release, configure npm trusted publishers for all six
515
- packages, remove the bootstrap environment secret, revoke its npm token, and
516
- restore `prevent_self_review: true` with an independent environment reviewer before
517
- using normal publication. A bootstrap rerun after a partial upload still needs
518
- the token and must follow the same-run recovery procedure below.
539
+ Normal trusted publication still requires operator setup. On 2026-10-15, the
540
+ GitHub `npm-prerelease` environment allowed only branch `main`, but its sole
541
+ required reviewer was `cbxss` and `prevent_self_review` was `false`. The normal
542
+ publication gate therefore rejects that configuration. Before beta.2 publication,
543
+ an operator must enable `prevent_self_review: true`, arrange an independent
544
+ required reviewer, and confirm npm trusted publishers on all six existing packages
545
+ for owner `shrimp-software`, repository `eoka-tools`, workflow `publish-node.yml`,
546
+ and environment `npm-prerelease`. npm publisher settings were not independently
547
+ verified from public registry metadata; a provenance attestation does not prove
548
+ trusted-publisher configuration. Remove any remaining bootstrap environment
549
+ secret and revoke its token after confirming the migration. No environment,
550
+ secret, token, or npm setting is changed by this release preparation.
551
+
552
+ The bootstrap procedure above is historical first-publication guidance, not the
553
+ normal beta.2 release path or an automatic fallback. A bootstrap rerun after a
554
+ partial upload still needs the token and must follow same-run recovery below.
519
555
 
520
556
  The publish job accepts only same-run, same-source qualified artifacts and
521
557
  preflights all six registry versions before writing anything. Existing versions
@@ -535,6 +571,8 @@ tags, source, or unavailable registry evidence abort before any new upload.
535
571
  There is no automatic publish retry or retagging. If source or artifacts changed,
536
572
  do not bypass these checks: use a separately reviewed roll-forward release.
537
573
  The final smoke checks a credential-free registry installation and provenance.
574
+ Its private runtime root stays short for Chrome's POSIX socket-path limits;
575
+ cache/state isolation and sandboxing remain enabled.
538
576
 
539
577
  No tag, merge, or publication is part of PR preparation. Existing Rust publishing
540
578
  workflows trigger on `main`; merging the version changes is a release action.
@@ -19,7 +19,16 @@ export interface InstallationMarker {
19
19
  inventory: InventoryEntry[];
20
20
  }
21
21
  export declare function fingerprint(entries: InventoryEntry[]): string;
22
- export declare function inventoryTree(root: string): Promise<InventoryEntry[]>;
22
+ export interface InventoryOptions {
23
+ /**
24
+ * Root-relative, `/`-separated directory to skip while it is empty. Chrome
25
+ * creates `extensions/` next to its executable on every startup
26
+ * (component-extension staging) even with `--disable-component-update`; it
27
+ * is not part of the pinned archive, so it must not read as tampering.
28
+ */
29
+ ignoreEmptyDirectory?: string;
30
+ }
31
+ export declare function inventoryTree(root: string, options?: InventoryOptions): Promise<InventoryEntry[]>;
23
32
  export declare function validateExecutable(root: string, relative: string): Promise<void>;
24
33
  export declare function createMarker(root: string, buildId: string, platform: string, pin: ChromePlatformRelease, executablePath: string): Promise<void>;
25
34
  export declare function verifyInstallation(root: string, buildId: string, platform: string, pin: ChromePlatformRelease, executablePath: string): Promise<boolean>;
@@ -11,7 +11,7 @@ function inside(root, target) {
11
11
  const relative = path.relative(root, target);
12
12
  return relative === '' || (!relative.startsWith(`..${path.sep}`) && relative !== '..' && !path.isAbsolute(relative));
13
13
  }
14
- export async function inventoryTree(root) {
14
+ export async function inventoryTree(root, options = {}) {
15
15
  const rootInfo = await lstat(root);
16
16
  if (!rootInfo.isDirectory() || rootInfo.isSymbolicLink())
17
17
  throw new InstallationError('IntegrityMismatch', 'Browser installation root is not a regular directory');
@@ -26,6 +26,8 @@ export async function inventoryTree(root) {
26
26
  const absolute = path.join(directory, name);
27
27
  const info = await lstat(absolute);
28
28
  const mode = info.mode & 0o555;
29
+ if (relative === options.ignoreEmptyDirectory && info.isDirectory() && (await readdir(absolute)).length === 0)
30
+ continue;
29
31
  if (info.isSymbolicLink()) {
30
32
  const target = await readlink(absolute);
31
33
  try {
@@ -88,7 +90,11 @@ export async function verifyInstallation(root, buildId, platform, pin, executabl
88
90
  if (marker.schema !== 1 || marker.buildId !== buildId || marker.platform !== platform || marker.archiveSha256 !== pin.sha256 || marker.archiveUrl !== pin.url || marker.executablePath !== executablePath || !Array.isArray(marker.inventory) || marker.inventorySha256 !== fingerprint(marker.inventory))
89
91
  throw new Error('Installation inventory does not match the pinned release');
90
92
  await validateExecutable(root, executablePath);
91
- const actual = await inventoryTree(root);
93
+ // The marker is always written from a strict inventory (createMarker).
94
+ // Chrome's archive never ships `extensions/`; the leniency only covers the
95
+ // empty directory it creates beside the executable after the first launch.
96
+ const runtimeExtensions = path.posix.join(path.posix.dirname(executablePath), 'extensions');
97
+ const actual = await inventoryTree(root, { ignoreEmptyDirectory: runtimeExtensions });
92
98
  if (fingerprint(actual) !== marker.inventorySha256)
93
99
  throw new Error('Browser distribution resources have changed');
94
100
  return true;
@@ -1600,8 +1600,11 @@ export type MethodBrowserConnectResult = {
1600
1600
  };
1601
1601
  export type MethodBrowserConnectResult__BrowserOwnership = (("owned" | "borrowed") & string);
1602
1602
  export type MethodBrowserLaunchParams = {
1603
+ "aggressiveCdpEvasion"?: boolean;
1603
1604
  "deviceScaleFactor": (number | null);
1604
1605
  "executablePath"?: (string | null);
1606
+ "extraArgs"?: Array<string>;
1607
+ "geoAlign"?: boolean;
1605
1608
  "headless"?: boolean;
1606
1609
  "proxy"?: (MethodBrowserLaunchParams__ProxyParams | null);
1607
1610
  "runtimeDir"?: (string | null);
@@ -2084,6 +2087,16 @@ export type MethodPageEvaluateResult = {
2084
2087
  "result": unknown;
2085
2088
  [key: string]: unknown;
2086
2089
  };
2090
+ export type MethodPageEvaluateInFrameParams = {
2091
+ "frameId": string;
2092
+ "js": string;
2093
+ "pageId": string;
2094
+ [key: string]: unknown;
2095
+ };
2096
+ export type MethodPageEvaluateInFrameResult = {
2097
+ "result": unknown;
2098
+ [key: string]: unknown;
2099
+ };
2087
2100
  export type MethodPageExecuteParams = {
2088
2101
  "js": string;
2089
2102
  "pageId": string;
@@ -2260,6 +2273,17 @@ export type MethodPageFillResult__ActionReceipt = {
2260
2273
  };
2261
2274
  export type MethodPageFillResult__DispatchState = (("not_sent" & string) | ("may_have_been_sent" & string) | ("acknowledged" & string));
2262
2275
  export type MethodPageFillResult__OperationState = (("running" | "finished" | "interrupted" | "expired") & string);
2276
+ export type MethodPageFramesParams = {
2277
+ "pageId": string;
2278
+ [key: string]: unknown;
2279
+ };
2280
+ export type MethodPageFramesResult = Array<MethodPageFramesResult__FrameInfo>;
2281
+ export type MethodPageFramesResult__FrameInfo = {
2282
+ "id": string;
2283
+ "name"?: (string | null);
2284
+ "url": string;
2285
+ [key: string]: unknown;
2286
+ };
2263
2287
  export type MethodPageGetAttributeParams = {
2264
2288
  "name": string;
2265
2289
  "pageId": string;
@@ -3773,11 +3797,13 @@ export type MethodParams = {
3773
3797
  "page.close": MethodPageCloseParams;
3774
3798
  "page.content": MethodPageContentParams;
3775
3799
  "page.evaluate": MethodPageEvaluateParams;
3800
+ "page.evaluate_in_frame": MethodPageEvaluateInFrameParams;
3776
3801
  "page.execute": MethodPageExecuteParams;
3777
3802
  "page.exists": MethodPageExistsParams;
3778
3803
  "page.fetch": MethodPageFetchParams;
3779
3804
  "page.fetch_bounded": MethodPageFetchBoundedParams;
3780
3805
  "page.fill": MethodPageFillParams;
3806
+ "page.frames": MethodPageFramesParams;
3781
3807
  "page.get_attribute": MethodPageGetAttributeParams;
3782
3808
  "page.get_text": MethodPageGetTextParams;
3783
3809
  "page.goto": MethodPageGotoParams;
@@ -3833,11 +3859,13 @@ export type MethodResults = {
3833
3859
  "page.close": MethodPageCloseResult;
3834
3860
  "page.content": MethodPageContentResult;
3835
3861
  "page.evaluate": MethodPageEvaluateResult;
3862
+ "page.evaluate_in_frame": MethodPageEvaluateInFrameResult;
3836
3863
  "page.execute": MethodPageExecuteResult;
3837
3864
  "page.exists": MethodPageExistsResult;
3838
3865
  "page.fetch": MethodPageFetchResult;
3839
3866
  "page.fetch_bounded": MethodPageFetchBoundedResult;
3840
3867
  "page.fill": MethodPageFillResult;
3868
+ "page.frames": MethodPageFramesResult;
3841
3869
  "page.get_attribute": MethodPageGetAttributeResult;
3842
3870
  "page.get_text": MethodPageGetTextResult;
3843
3871
  "page.goto": MethodPageGotoResult;
@@ -3898,4 +3926,4 @@ export declare const protocolVersion: {
3898
3926
  readonly major: 1;
3899
3927
  readonly minor: 3;
3900
3928
  };
3901
- export declare const methodNames: readonly ["actions.perform", "agent.observe", "agent.step", "browser.close", "browser.close_tab", "browser.connect", "browser.launch", "browser.new_page", "browser.tabs", "operations.cancel", "operations.get", "operations.list", "operations.wait", "page.capture_state", "page.click", "page.click_text", "page.close", "page.content", "page.evaluate", "page.execute", "page.exists", "page.fetch", "page.fetch_bounded", "page.fill", "page.get_attribute", "page.get_text", "page.goto", "page.hover", "page.human_click", "page.human_click_text", "page.human_fill", "page.key_down", "page.key_up", "page.mouse_down", "page.mouse_move", "page.mouse_up", "page.press_key", "page.release_all_inputs", "page.reset_viewport", "page.restore_state", "page.screenshot", "page.screenshot_to_file", "page.select", "page.set_viewport", "page.solve_captcha", "page.text", "page.title", "page.type_into", "page.url", "page.wait_for", "page.wait_for_text", "page.wait_for_visible", "recording.cancel", "recording.get", "recording.start", "recording.stop", "server.hello", "server.shutdown"];
3929
+ export declare const methodNames: readonly ["actions.perform", "agent.observe", "agent.step", "browser.close", "browser.close_tab", "browser.connect", "browser.launch", "browser.new_page", "browser.tabs", "operations.cancel", "operations.get", "operations.list", "operations.wait", "page.capture_state", "page.click", "page.click_text", "page.close", "page.content", "page.evaluate", "page.evaluate_in_frame", "page.execute", "page.exists", "page.fetch", "page.fetch_bounded", "page.fill", "page.frames", "page.get_attribute", "page.get_text", "page.goto", "page.hover", "page.human_click", "page.human_click_text", "page.human_fill", "page.key_down", "page.key_up", "page.mouse_down", "page.mouse_move", "page.mouse_up", "page.press_key", "page.release_all_inputs", "page.reset_viewport", "page.restore_state", "page.screenshot", "page.screenshot_to_file", "page.select", "page.set_viewport", "page.solve_captcha", "page.text", "page.title", "page.type_into", "page.url", "page.wait_for", "page.wait_for_text", "page.wait_for_visible", "recording.cancel", "recording.get", "recording.start", "recording.stop", "server.hello", "server.shutdown"];
@@ -1,2 +1,2 @@
1
1
  export const protocolVersion = { "major": 1, "minor": 3 };
2
- export const methodNames = ["actions.perform", "agent.observe", "agent.step", "browser.close", "browser.close_tab", "browser.connect", "browser.launch", "browser.new_page", "browser.tabs", "operations.cancel", "operations.get", "operations.list", "operations.wait", "page.capture_state", "page.click", "page.click_text", "page.close", "page.content", "page.evaluate", "page.execute", "page.exists", "page.fetch", "page.fetch_bounded", "page.fill", "page.get_attribute", "page.get_text", "page.goto", "page.hover", "page.human_click", "page.human_click_text", "page.human_fill", "page.key_down", "page.key_up", "page.mouse_down", "page.mouse_move", "page.mouse_up", "page.press_key", "page.release_all_inputs", "page.reset_viewport", "page.restore_state", "page.screenshot", "page.screenshot_to_file", "page.select", "page.set_viewport", "page.solve_captcha", "page.text", "page.title", "page.type_into", "page.url", "page.wait_for", "page.wait_for_text", "page.wait_for_visible", "recording.cancel", "recording.get", "recording.start", "recording.stop", "server.hello", "server.shutdown"];
2
+ export const methodNames = ["actions.perform", "agent.observe", "agent.step", "browser.close", "browser.close_tab", "browser.connect", "browser.launch", "browser.new_page", "browser.tabs", "operations.cancel", "operations.get", "operations.list", "operations.wait", "page.capture_state", "page.click", "page.click_text", "page.close", "page.content", "page.evaluate", "page.evaluate_in_frame", "page.execute", "page.exists", "page.fetch", "page.fetch_bounded", "page.fill", "page.frames", "page.get_attribute", "page.get_text", "page.goto", "page.hover", "page.human_click", "page.human_click_text", "page.human_fill", "page.key_down", "page.key_up", "page.mouse_down", "page.mouse_move", "page.mouse_up", "page.press_key", "page.release_all_inputs", "page.reset_viewport", "page.restore_state", "page.screenshot", "page.screenshot_to_file", "page.select", "page.set_viewport", "page.solve_captcha", "page.text", "page.title", "page.type_into", "page.url", "page.wait_for", "page.wait_for_text", "page.wait_for_visible", "recording.cancel", "recording.get", "recording.start", "recording.stop", "server.hello", "server.shutdown"];
@@ -2366,6 +2366,10 @@
2366
2366
  },
2367
2367
  "$schema": "https://json-schema.org/draft/2020-12/schema",
2368
2368
  "properties": {
2369
+ "aggressiveCdpEvasion": {
2370
+ "default": false,
2371
+ "type": "boolean"
2372
+ },
2369
2373
  "deviceScaleFactor": {
2370
2374
  "exclusiveMinimum": 0,
2371
2375
  "type": [
@@ -2379,6 +2383,17 @@
2379
2383
  "null"
2380
2384
  ]
2381
2385
  },
2386
+ "extraArgs": {
2387
+ "default": [],
2388
+ "items": {
2389
+ "type": "string"
2390
+ },
2391
+ "type": "array"
2392
+ },
2393
+ "geoAlign": {
2394
+ "default": false,
2395
+ "type": "boolean"
2396
+ },
2382
2397
  "headless": {
2383
2398
  "default": true,
2384
2399
  "type": "boolean"
@@ -4883,6 +4898,41 @@
4883
4898
  "type": "object"
4884
4899
  }
4885
4900
  },
4901
+ "page.evaluate_in_frame": {
4902
+ "params": {
4903
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
4904
+ "properties": {
4905
+ "frameId": {
4906
+ "type": "string"
4907
+ },
4908
+ "js": {
4909
+ "description": "JavaScript expression evaluated in the frame's isolated world. Frame IDs come from `page.frames`; detached or unrelated IDs are rejected.",
4910
+ "type": "string"
4911
+ },
4912
+ "pageId": {
4913
+ "type": "string"
4914
+ }
4915
+ },
4916
+ "required": [
4917
+ "pageId",
4918
+ "frameId",
4919
+ "js"
4920
+ ],
4921
+ "title": "FrameJsParams",
4922
+ "type": "object"
4923
+ },
4924
+ "result": {
4925
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
4926
+ "properties": {
4927
+ "result": true
4928
+ },
4929
+ "required": [
4930
+ "result"
4931
+ ],
4932
+ "title": "EvaluateResult",
4933
+ "type": "object"
4934
+ }
4935
+ },
4886
4936
  "page.execute": {
4887
4937
  "params": {
4888
4938
  "$schema": "https://json-schema.org/draft/2020-12/schema",
@@ -5751,6 +5801,52 @@
5751
5801
  "type": "object"
5752
5802
  }
5753
5803
  },
5804
+ "page.frames": {
5805
+ "params": {
5806
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
5807
+ "properties": {
5808
+ "pageId": {
5809
+ "type": "string"
5810
+ }
5811
+ },
5812
+ "required": [
5813
+ "pageId"
5814
+ ],
5815
+ "title": "FramesParams",
5816
+ "type": "object"
5817
+ },
5818
+ "result": {
5819
+ "$defs": {
5820
+ "FrameInfo": {
5821
+ "properties": {
5822
+ "id": {
5823
+ "type": "string"
5824
+ },
5825
+ "name": {
5826
+ "type": [
5827
+ "string",
5828
+ "null"
5829
+ ]
5830
+ },
5831
+ "url": {
5832
+ "type": "string"
5833
+ }
5834
+ },
5835
+ "required": [
5836
+ "id",
5837
+ "url"
5838
+ ],
5839
+ "type": "object"
5840
+ }
5841
+ },
5842
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
5843
+ "items": {
5844
+ "$ref": "#/$defs/FrameInfo"
5845
+ },
5846
+ "title": "Array_of_FrameInfo",
5847
+ "type": "array"
5848
+ }
5849
+ },
5754
5850
  "page.get_attribute": {
5755
5851
  "params": {
5756
5852
  "$schema": "https://json-schema.org/draft/2020-12/schema",
@@ -1,63 +1,63 @@
1
1
  {
2
2
  "schemaVersion": 1,
3
- "sdkVersion": "0.1.0-beta.1",
3
+ "sdkVersion": "0.1.0-beta.2",
4
4
  "installerVersion": "3.2.4",
5
5
  "server": {
6
- "version": "0.5.0",
6
+ "version": "0.6.0",
7
7
  "protocolVersion": "1.3",
8
8
  "platforms": {
9
9
  "linux-x64-gnu": {
10
10
  "packageName": "@cbxss/eoka-server-linux-x64-gnu",
11
- "packageVersion": "0.1.0-beta.1",
11
+ "packageVersion": "0.1.0-beta.2",
12
12
  "target": "x86_64-unknown-linux-gnu",
13
13
  "asset": "eoka-server-linux-amd64",
14
14
  "executablePath": "bin/eoka-server",
15
- "sha256": "5eb3ba769d92389626d78f8e6d9917fecfdbb9690da37a6e327cee05818884e3",
16
- "size": 16897520,
15
+ "sha256": "4f6b5dca392902fca36f454a2735c9722832e74697feea5e87aacc23ea6b8e46",
16
+ "size": 16997800,
17
17
  "minimumGlibc": "2.35",
18
18
  "development": false
19
19
  },
20
20
  "linux-arm64-gnu": {
21
21
  "packageName": "@cbxss/eoka-server-linux-arm64-gnu",
22
- "packageVersion": "0.1.0-beta.1",
22
+ "packageVersion": "0.1.0-beta.2",
23
23
  "target": "aarch64-unknown-linux-gnu",
24
24
  "asset": "eoka-server-linux-arm64",
25
25
  "executablePath": "bin/eoka-server",
26
- "sha256": "10497b7fe4cdd460ee0c6bb0a54675e3cb3e716e066d895c8533b547107460b8",
27
- "size": 16210368,
26
+ "sha256": "014fdd7c78797f4955e7c3788984a94cc01d3a1f91501b9be32dc33ebdb30d3c",
27
+ "size": 16288304,
28
28
  "minimumGlibc": "2.35",
29
29
  "development": false
30
30
  },
31
31
  "darwin-x64": {
32
32
  "packageName": "@cbxss/eoka-server-darwin-x64",
33
- "packageVersion": "0.1.0-beta.1",
33
+ "packageVersion": "0.1.0-beta.2",
34
34
  "target": "x86_64-apple-darwin",
35
35
  "asset": "eoka-server-darwin-amd64",
36
36
  "executablePath": "bin/eoka-server",
37
- "sha256": "d5570334ed5f0cc927ec8ad5cebf4fd81b756eee2a6bdde903f75eb706725169",
38
- "size": 14995968,
37
+ "sha256": "20eca3d9f171e94f6b9f86ed8f2f7c49813b8905574c0b5234e9f2efad75577b",
38
+ "size": 15079232,
39
39
  "minimumGlibc": null,
40
40
  "development": false
41
41
  },
42
42
  "darwin-arm64": {
43
43
  "packageName": "@cbxss/eoka-server-darwin-arm64",
44
- "packageVersion": "0.1.0-beta.1",
44
+ "packageVersion": "0.1.0-beta.2",
45
45
  "target": "aarch64-apple-darwin",
46
46
  "asset": "eoka-server-darwin-arm64",
47
47
  "executablePath": "bin/eoka-server",
48
- "sha256": "2437c1d3835ef9bd3f4cce5f9f6c0120000e791023cffcf552e8ac89d28683f3",
49
- "size": 14543216,
48
+ "sha256": "0c10b1a0aaacc57be62904bb39f72cee92125cf8d4fb858330a3f458bda9ec5d",
49
+ "size": 14608624,
50
50
  "minimumGlibc": null,
51
51
  "development": false
52
52
  },
53
53
  "win32-x64": {
54
54
  "packageName": "@cbxss/eoka-server-win32-x64",
55
- "packageVersion": "0.1.0-beta.1",
55
+ "packageVersion": "0.1.0-beta.2",
56
56
  "target": "x86_64-pc-windows-msvc",
57
57
  "asset": "eoka-server-windows-amd64.exe",
58
58
  "executablePath": "bin/eoka-server.exe",
59
- "sha256": "e3a13dcdedaba1ad4d1fb85c6a1a71ab5dab7a906d4d980161541fc2afe9f743",
60
- "size": 14008320,
59
+ "sha256": "000978048095b63cafc6c5e4cb250dd40267a8dd0a73697f84f99e51a3066b3d",
60
+ "size": 14114816,
61
61
  "minimumGlibc": null,
62
62
  "development": false
63
63
  }
package/dist/release.js CHANGED
@@ -29,7 +29,7 @@ export function validateReleaseManifest(value) {
29
29
  const chrome = object(manifest.chrome);
30
30
  const servers = object(server.platforms);
31
31
  const browsers = object(chrome.platforms);
32
- if (manifest.schemaVersion !== 1 || !exactNpmVersion(manifest.sdkVersion) || manifest.installerVersion !== '3.2.4' || server.version !== '0.5.0' || server.protocolVersion !== `${protocolVersion.major}.${protocolVersion.minor}` || chrome.buildId !== '155.0.8059.39')
32
+ if (manifest.schemaVersion !== 1 || !exactNpmVersion(manifest.sdkVersion) || manifest.installerVersion !== '3.2.4' || server.version !== '0.6.0' || server.protocolVersion !== `${protocolVersion.major}.${protocolVersion.minor}` || chrome.buildId !== '155.0.8059.39')
33
33
  throw new Error('Incompatible release versions');
34
34
  if (Object.keys(servers).length !== platformIds.length || Object.keys(browsers).length !== platformIds.length)
35
35
  throw new Error('Incomplete platform mapping');
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cbxss/eoka",
3
- "version": "0.1.0-beta.1",
3
+ "version": "0.1.0-beta.2",
4
4
  "private": false,
5
5
  "type": "module",
6
6
  "description": "Node.js SDK with pinned Chrome installation and verified eoka sidecar resolution",
@@ -58,11 +58,11 @@
58
58
  "typescript": "5.9.3"
59
59
  },
60
60
  "optionalDependencies": {
61
- "@cbxss/eoka-server-linux-x64-gnu": "0.1.0-beta.1",
62
- "@cbxss/eoka-server-linux-arm64-gnu": "0.1.0-beta.1",
63
- "@cbxss/eoka-server-darwin-x64": "0.1.0-beta.1",
64
- "@cbxss/eoka-server-darwin-arm64": "0.1.0-beta.1",
65
- "@cbxss/eoka-server-win32-x64": "0.1.0-beta.1"
61
+ "@cbxss/eoka-server-linux-x64-gnu": "0.1.0-beta.2",
62
+ "@cbxss/eoka-server-linux-arm64-gnu": "0.1.0-beta.2",
63
+ "@cbxss/eoka-server-darwin-x64": "0.1.0-beta.2",
64
+ "@cbxss/eoka-server-darwin-arm64": "0.1.0-beta.2",
65
+ "@cbxss/eoka-server-win32-x64": "0.1.0-beta.2"
66
66
  },
67
67
  "repository": {
68
68
  "type": "git",