@nexum-hub/browser 0.0.0-stage → 0.0.1

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.
Files changed (100) hide show
  1. package/README.md +22 -2
  2. package/browser-extension/assets.js +654 -0
  3. package/browser-extension/build.mjs +111 -0
  4. package/browser-extension/clipboard.js +397 -0
  5. package/browser-extension/connection.js +880 -0
  6. package/browser-extension/dist/development/assets.js +654 -0
  7. package/browser-extension/dist/development/clipboard.js +397 -0
  8. package/browser-extension/dist/development/connection.js +880 -0
  9. package/browser-extension/dist/development/errors.js +106 -0
  10. package/browser-extension/dist/development/evaluate.js +160 -0
  11. package/browser-extension/dist/development/frames.js +256 -0
  12. package/browser-extension/dist/development/keyboard.js +167 -0
  13. package/browser-extension/dist/development/manifest.json +35 -0
  14. package/browser-extension/dist/development/native-node.js +85 -0
  15. package/browser-extension/dist/development/page-data.js +497 -0
  16. package/browser-extension/dist/development/page.js +772 -0
  17. package/browser-extension/dist/development/profile.js +2 -0
  18. package/browser-extension/dist/development/router.js +5961 -0
  19. package/browser-extension/dist/development/site-source.js +149 -0
  20. package/browser-extension/dist/development/transport.js +405 -0
  21. package/browser-extension/dist/development/visual.js +976 -0
  22. package/browser-extension/dist/development/worker.js +24 -0
  23. package/browser-extension/dist/production/assets.js +654 -0
  24. package/browser-extension/dist/production/clipboard.js +397 -0
  25. package/browser-extension/dist/production/connection.js +880 -0
  26. package/browser-extension/dist/production/errors.js +106 -0
  27. package/browser-extension/dist/production/evaluate.js +160 -0
  28. package/browser-extension/dist/production/frames.js +256 -0
  29. package/browser-extension/dist/production/keyboard.js +167 -0
  30. package/browser-extension/dist/production/manifest.json +35 -0
  31. package/browser-extension/dist/production/native-node.js +85 -0
  32. package/browser-extension/dist/production/page-data.js +497 -0
  33. package/browser-extension/dist/production/page.js +772 -0
  34. package/browser-extension/dist/production/profile.js +2 -0
  35. package/browser-extension/dist/production/router.js +5961 -0
  36. package/browser-extension/dist/production/site-source.js +149 -0
  37. package/browser-extension/dist/production/transport.js +405 -0
  38. package/browser-extension/dist/production/visual.js +976 -0
  39. package/browser-extension/dist/production/worker.js +24 -0
  40. package/browser-extension/errors.js +106 -0
  41. package/browser-extension/evaluate.js +160 -0
  42. package/browser-extension/frames.js +256 -0
  43. package/browser-extension/keyboard.js +167 -0
  44. package/browser-extension/native-node.js +85 -0
  45. package/browser-extension/page-data.js +497 -0
  46. package/browser-extension/page.js +772 -0
  47. package/browser-extension/release-info.json +21 -0
  48. package/browser-extension/route-manifest.json +807 -0
  49. package/browser-extension/router.js +5961 -0
  50. package/browser-extension/site-source.js +149 -0
  51. package/browser-extension/transport.js +405 -0
  52. package/browser-extension/visual.js +976 -0
  53. package/browser-extension/worker.js +24 -0
  54. package/dist/client/index.d.ts +6 -0
  55. package/dist/client/index.js +894 -0
  56. package/dist/client/index.js.map +1 -0
  57. package/dist/client/routes.d.ts +6 -0
  58. package/dist/client/routes.js +777 -0
  59. package/dist/client/routes.js.map +1 -0
  60. package/dist/client/serialize.d.ts +16 -0
  61. package/dist/client/serialize.js +355 -0
  62. package/dist/client/serialize.js.map +1 -0
  63. package/dist/client/types.d.ts +1342 -0
  64. package/dist/client/types.js +2 -0
  65. package/dist/client/types.js.map +1 -0
  66. package/dist/extension/artifacts.d.ts +60 -0
  67. package/dist/extension/artifacts.js +493 -0
  68. package/dist/extension/artifacts.js.map +1 -0
  69. package/dist/extension/assets.d.ts +10 -0
  70. package/dist/extension/assets.js +90 -0
  71. package/dist/extension/assets.js.map +1 -0
  72. package/dist/extension/batch.d.ts +6 -0
  73. package/dist/extension/batch.js +138 -0
  74. package/dist/extension/batch.js.map +1 -0
  75. package/dist/extension/files.d.ts +16 -0
  76. package/dist/extension/files.js +594 -0
  77. package/dist/extension/files.js.map +1 -0
  78. package/dist/extension/index.d.ts +3 -0
  79. package/dist/extension/index.js +623 -0
  80. package/dist/extension/index.js.map +1 -0
  81. package/dist/extension/protocol.d.ts +81 -0
  82. package/dist/extension/protocol.js +475 -0
  83. package/dist/extension/protocol.js.map +1 -0
  84. package/dist/extension/scope.d.ts +55 -0
  85. package/dist/extension/scope.js +563 -0
  86. package/dist/extension/scope.js.map +1 -0
  87. package/dist/extension/service.d.ts +113 -0
  88. package/dist/extension/service.js +905 -0
  89. package/dist/extension/service.js.map +1 -0
  90. package/docs/README.md +10 -0
  91. package/docs/api.md +1375 -0
  92. package/docs/connection.md +9 -0
  93. package/docs/lifecycle.md +17 -0
  94. package/docs/usage.md +75 -0
  95. package/implementation.json +2352 -0
  96. package/instructions/README.md +8 -0
  97. package/package.json +80 -4
  98. package/scripts/discover.js +12 -0
  99. package/scripts/screenshot.js +9 -0
  100. package/skills/browser-control/SKILL.md +12 -0
@@ -0,0 +1,90 @@
1
+ import { readFile, mkdir, mkdtemp, readdir, lstat, rename, rm, copyFile, } from "node:fs/promises";
2
+ import { createHash } from "node:crypto";
3
+ import { fileURLToPath } from "node:url";
4
+ import path from "node:path";
5
+ import { check, identifier, record } from "./protocol.js";
6
+ const pluginRoot = fileURLToPath(new URL("../../browser-extension/", import.meta.url));
7
+ /** Copies only this package's generated plugin, never installs it into a browser. */
8
+ export async function preparePlugin(host, signal) {
9
+ signal.throwIfAborted();
10
+ const profile = host.context.profile;
11
+ check(profile === "production" || profile === "development", "PROFILE_MISMATCH", "This browser package needs an explicit supported Agent profile.");
12
+ const paths = host.context.paths;
13
+ check(record(paths) &&
14
+ typeof paths.work === "string" &&
15
+ path.isAbsolute(paths.work), "INVALID_ARGUMENT", "The Agent work directory is unavailable.");
16
+ const release = JSON.parse(await readFile(path.join(pluginRoot, "release-info.json"), "utf8"));
17
+ const build = release.profiles[profile];
18
+ check(build &&
19
+ build.profile === profile &&
20
+ /^[a-p]{32}$/.test(build.extensionId) &&
21
+ identifier(release.extensionVersion) &&
22
+ release.protocolVersion === 1 &&
23
+ build.port === (profile === "production" ? 43831 : 43832), "PROTOCOL_MISMATCH", "The matching plugin release metadata is unavailable.");
24
+ const source = path.join(pluginRoot, "dist", profile);
25
+ const manifest = JSON.parse(await readFile(path.join(source, "manifest.json"), "utf8"));
26
+ const extensionId = [
27
+ ...createHash("sha256")
28
+ .update(Buffer.from(manifest.key, "base64"))
29
+ .digest()
30
+ .subarray(0, 16),
31
+ ]
32
+ .map((value) => String.fromCharCode(97 + (value >> 4), 97 + (value & 15)))
33
+ .join("");
34
+ check(manifest.key === build.key &&
35
+ extensionId === build.extensionId &&
36
+ manifest.version === release.extensionVersion, "PROTOCOL_MISMATCH", "The plugin manifest identity does not match this package release.");
37
+ const parent = path.join(paths.work, ".nexum-browser"), destination = path.join(parent, "extension");
38
+ host.authorize({ type: "path", value: parent, access: "write" });
39
+ await mkdir(parent, { recursive: true, mode: 0o700 });
40
+ check(!(await lstat(parent)).isSymbolicLink(), "PERMISSION_DENIED", "The browser package directory cannot be a symbolic link.");
41
+ signal.throwIfAborted();
42
+ const temporary = await mkdtemp(path.join(parent, ".plugin-"));
43
+ let backup, committed = false;
44
+ try {
45
+ for (const entry of await readdir(source, { withFileTypes: true })) {
46
+ signal.throwIfAborted();
47
+ check(entry.isFile() &&
48
+ !entry.isSymbolicLink() &&
49
+ !entry.name.startsWith("."), "PROTOCOL_MISMATCH", "The plugin build must contain regular owned files.");
50
+ await copyFile(path.join(source, entry.name), path.join(temporary, entry.name));
51
+ }
52
+ signal.throwIfAborted();
53
+ host.authorize({ type: "path", value: destination, access: "write" });
54
+ try {
55
+ check(!(await lstat(destination)).isSymbolicLink(), "PERMISSION_DENIED", "The stable plugin path cannot redirect elsewhere.");
56
+ backup = await mkdtemp(path.join(parent, ".previous-"));
57
+ await rm(backup, { recursive: true });
58
+ await rename(destination, backup);
59
+ }
60
+ catch (cause) {
61
+ if (cause.code !== "ENOENT")
62
+ throw cause;
63
+ }
64
+ try {
65
+ await rename(temporary, destination);
66
+ committed = true;
67
+ }
68
+ catch (cause) {
69
+ if (backup)
70
+ await rename(backup, destination);
71
+ backup = undefined;
72
+ throw cause;
73
+ }
74
+ if (backup)
75
+ await rm(backup, { recursive: true, force: true });
76
+ signal.throwIfAborted();
77
+ return {
78
+ profile,
79
+ port: build.port,
80
+ extensionId: build.extensionId,
81
+ extensionVersion: release.extensionVersion,
82
+ directory: destination,
83
+ };
84
+ }
85
+ finally {
86
+ if (!committed)
87
+ await rm(temporary, { recursive: true, force: true });
88
+ }
89
+ }
90
+ //# sourceMappingURL=assets.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"assets.js","sourceRoot":"","sources":["../../src/extension/assets.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ import type { Invocation } from "@nexum-hub/sdk";
2
+ import type { TabsContentResult } from "../client/types.js";
3
+ import { BrowserRuntime } from "./scope.js";
4
+ import { type Target } from "./protocol.js";
5
+ /** Actual temporary tabs, sharing only this invocation's ordinary managed scope. */
6
+ export declare function collectTabContent(input: Record<string, unknown>, target: Target, call: Invocation, runtime: BrowserRuntime, remember: (target: Target, value: unknown, method: string) => void): Promise<TabsContentResult[]>;
@@ -0,0 +1,138 @@
1
+ import { validateTarget } from "../client/serialize.js";
2
+ import { check, record, failure } from "./protocol.js";
3
+ function authority(call, url) {
4
+ const parsed = new URL(url);
5
+ check(["http:", "https:"].includes(parsed.protocol) &&
6
+ !parsed.username &&
7
+ !parsed.password, "INVALID_ARGUMENT", "Batch page reading requires HTTP(S) URLs without credentials.");
8
+ call.authorize({ type: "url", value: parsed.href, access: "read" });
9
+ }
10
+ function nativeCode(cause) {
11
+ if (!cause ||
12
+ typeof cause !== "object" ||
13
+ Object.getPrototypeOf(cause) !== Error.prototype)
14
+ return null;
15
+ const code = Object.getOwnPropertyDescriptor(cause, "code"), effect = Object.getOwnPropertyDescriptor(cause, "effect");
16
+ return code &&
17
+ "value" in code &&
18
+ typeof code.value === "string" &&
19
+ effect &&
20
+ "value" in effect
21
+ ? code.value
22
+ : null;
23
+ }
24
+ function truncate(value, length) {
25
+ let result = value.slice(0, length);
26
+ if (result.length && /[\uD800-\uDBFF]/.test(result.at(-1)))
27
+ result = result.slice(0, -1);
28
+ return result;
29
+ }
30
+ /** Actual temporary tabs, sharing only this invocation's ordinary managed scope. */
31
+ export async function collectTabContent(input, target, call, runtime, remember) {
32
+ check(record(input.options) &&
33
+ Array.isArray(input.options.urls) &&
34
+ input.options.urls.length > 0 &&
35
+ input.options.urls.length <= 8, "INVALID_ARGUMENT", "A batch reads one to eight pages.");
36
+ const options = input.options, urls = options.urls;
37
+ for (const url of urls) {
38
+ check(typeof url === "string", "INVALID_ARGUMENT", "A page URL must be text.");
39
+ authority(call, url);
40
+ }
41
+ const deadline = Math.min(call.deadline, Date.now() +
42
+ Math.min(30000, typeof options.timeoutMs === "number" ? options.timeoutMs : 30000));
43
+ const results = [];
44
+ for (const url of urls) {
45
+ call.signal.throwIfAborted();
46
+ if (Date.now() >= deadline) {
47
+ results.push({ url, title: null, content: null, truncated: false });
48
+ continue;
49
+ }
50
+ let temporary;
51
+ try {
52
+ const created = await runtime.action("tabs.createTemporary", {
53
+ target,
54
+ url,
55
+ options: {
56
+ active: false,
57
+ timeoutMs: Math.max(1, deadline - Date.now()),
58
+ },
59
+ }, target, call, true);
60
+ check(record(created) && record(created.target), "PROTOCOL_MISMATCH", "A temporary page was not identified.");
61
+ temporary = validateTarget(created.target, true);
62
+ remember(target, created, "tabs.new");
63
+ await runtime.action("playwright.waitForLoadState", {
64
+ target: temporary,
65
+ options: {
66
+ state: "domcontentloaded",
67
+ timeoutMs: Math.max(1, deadline - Date.now()),
68
+ },
69
+ background: true,
70
+ }, temporary, call, false);
71
+ const currentUrl = await runtime.action("tab.url", { target: temporary, background: true }, temporary, call, false);
72
+ check(typeof currentUrl === "string", "TARGET_GONE", "The temporary page no longer has a URL.");
73
+ authority(call, currentUrl);
74
+ const title = await runtime.action("tab.title", { target: temporary, background: true }, temporary, call, false);
75
+ const value = options.contentType === "domSnapshot"
76
+ ? await runtime.action("playwright.domSnapshot", { target: temporary, background: true }, temporary, call, false)
77
+ : await runtime.action("tab.contentExport", {
78
+ target: temporary,
79
+ options: {
80
+ format: options.contentType === "html" ? "html" : "text",
81
+ },
82
+ background: true,
83
+ }, temporary, call, false);
84
+ const content = typeof value === "string"
85
+ ? value
86
+ : record(value) && typeof value.data === "string"
87
+ ? value.data
88
+ : null;
89
+ check(content !== null, "PROTOCOL_MISMATCH", "The browser did not return the actual page text.");
90
+ results.push({
91
+ url,
92
+ title: typeof title === "string" ? title : null,
93
+ content: truncate(content, 4096),
94
+ truncated: content.length > 4096 || (record(value) && value.truncated === true),
95
+ });
96
+ }
97
+ catch (cause) {
98
+ call.signal.throwIfAborted();
99
+ if (![
100
+ "TIMEOUT",
101
+ "TARGET_GONE",
102
+ "NAVIGATION_FAILED",
103
+ "CDP_DISCONNECTED",
104
+ "EXTENSION_OFFLINE",
105
+ "UNKNOWN_RESULT",
106
+ ].includes(nativeCode(cause) ?? ""))
107
+ throw cause;
108
+ results.push({ url, title: null, content: null, truncated: false });
109
+ }
110
+ finally {
111
+ if (temporary) {
112
+ try {
113
+ await runtime.action("tabs.closeTemporary", { target: temporary, id: temporary.tabId, background: true }, temporary, call, true);
114
+ remember(temporary, null, "tab.close");
115
+ }
116
+ catch (cause) {
117
+ if (nativeCode(cause) !== "TARGET_GONE")
118
+ throw cause;
119
+ }
120
+ }
121
+ }
122
+ }
123
+ // Preserve URL identity. Only actual page content is shortened to the batch budget.
124
+ while (Buffer.byteLength(JSON.stringify(results)) > 60000) {
125
+ let candidate;
126
+ for (const row of results)
127
+ if (row.content &&
128
+ (!candidate || row.content.length > candidate.content.length))
129
+ candidate = row;
130
+ if (!candidate)
131
+ throw failure("OUTPUT_TOO_LARGE", "Page metadata alone exceeds the batch result budget.");
132
+ const excess = Buffer.byteLength(JSON.stringify(results)) - 60000;
133
+ candidate.content = truncate(candidate.content, Math.max(0, candidate.content.length - Math.max(1, excess)));
134
+ candidate.truncated = true;
135
+ }
136
+ return results;
137
+ }
138
+ //# sourceMappingURL=batch.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"batch.js","sourceRoot":"","sources":["../../src/extension/batch.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ import type { Invocation } from "@nexum-hub/sdk";
2
+ import type { BrowserArtifact, BrowserFileSource, FileChooserFiles } from "../client/types.js";
3
+ export interface PreparedBrowserFile {
4
+ path: string;
5
+ name: string;
6
+ mimeType?: string;
7
+ }
8
+ export interface DownloadFileInput {
9
+ path: string;
10
+ name?: string;
11
+ expectedSize?: number;
12
+ destination?: string;
13
+ }
14
+ export declare const browserFileBudget: number;
15
+ export declare function materializeDownload(input: DownloadFileInput, call: Invocation, work: string): Promise<BrowserArtifact>;
16
+ export declare function prepareFiles(input: FileChooserFiles | BrowserFileSource[], call: Invocation, work: string): Promise<PreparedBrowserFile[]>;