dev3000 0.0.189 → 0.0.192

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 (183) hide show
  1. package/README.md +101 -12
  2. package/dist/cdp-monitor.d.ts +10 -0
  3. package/dist/cdp-monitor.d.ts.map +1 -1
  4. package/dist/cdp-monitor.js +28 -4
  5. package/dist/cdp-monitor.js.map +1 -1
  6. package/dist/runtime/bridge.d.ts +2 -0
  7. package/dist/runtime/bridge.d.ts.map +1 -1
  8. package/dist/runtime/bridge.js +74 -0
  9. package/dist/runtime/bridge.js.map +1 -1
  10. package/dist/runtime/browser-capture.d.ts +117 -0
  11. package/dist/runtime/browser-capture.d.ts.map +1 -0
  12. package/dist/runtime/browser-capture.js +274 -0
  13. package/dist/runtime/browser-capture.js.map +1 -0
  14. package/dist/runtime/browser-compare.d.ts +91 -0
  15. package/dist/runtime/browser-compare.d.ts.map +1 -0
  16. package/dist/runtime/browser-compare.js +129 -0
  17. package/dist/runtime/browser-compare.js.map +1 -0
  18. package/dist/runtime/browser-events.d.ts +3 -2
  19. package/dist/runtime/browser-events.d.ts.map +1 -1
  20. package/dist/runtime/browser-events.js +11 -53
  21. package/dist/runtime/browser-events.js.map +1 -1
  22. package/dist/runtime/browser-metrics.d.ts +148 -0
  23. package/dist/runtime/browser-metrics.d.ts.map +1 -0
  24. package/dist/runtime/browser-metrics.js +243 -0
  25. package/dist/runtime/browser-metrics.js.map +1 -0
  26. package/dist/runtime/chrome-isolation.d.ts +4 -2
  27. package/dist/runtime/chrome-isolation.d.ts.map +1 -1
  28. package/dist/runtime/chrome-isolation.js +24 -35
  29. package/dist/runtime/chrome-isolation.js.map +1 -1
  30. package/dist/runtime/cli.js +67 -2
  31. package/dist/runtime/cli.js.map +1 -1
  32. package/dist/runtime/desktop-mcp.d.ts +216 -0
  33. package/dist/runtime/desktop-mcp.d.ts.map +1 -0
  34. package/dist/runtime/desktop-mcp.js +258 -0
  35. package/dist/runtime/desktop-mcp.js.map +1 -0
  36. package/dist/runtime/git-identity.d.ts +17 -0
  37. package/dist/runtime/git-identity.d.ts.map +1 -0
  38. package/dist/runtime/git-identity.js +41 -0
  39. package/dist/runtime/git-identity.js.map +1 -0
  40. package/dist/runtime/github-publish.d.ts +31 -0
  41. package/dist/runtime/github-publish.d.ts.map +1 -0
  42. package/dist/runtime/github-publish.js +237 -0
  43. package/dist/runtime/github-publish.js.map +1 -0
  44. package/dist/runtime/harness.d.ts +14 -3
  45. package/dist/runtime/harness.d.ts.map +1 -1
  46. package/dist/runtime/harness.js +55 -7
  47. package/dist/runtime/harness.js.map +1 -1
  48. package/dist/runtime/managed-cdp.d.ts +10 -0
  49. package/dist/runtime/managed-cdp.d.ts.map +1 -0
  50. package/dist/runtime/managed-cdp.js +80 -0
  51. package/dist/runtime/managed-cdp.js.map +1 -0
  52. package/dist/runtime/mcp-stdio.d.ts +17 -0
  53. package/dist/runtime/mcp-stdio.d.ts.map +1 -0
  54. package/dist/runtime/mcp-stdio.js +99 -0
  55. package/dist/runtime/mcp-stdio.js.map +1 -0
  56. package/dist/runtime/network-evidence.d.ts +28 -0
  57. package/dist/runtime/network-evidence.d.ts.map +1 -0
  58. package/dist/runtime/network-evidence.js +291 -0
  59. package/dist/runtime/network-evidence.js.map +1 -0
  60. package/dist/runtime/package-manager.d.ts +13 -0
  61. package/dist/runtime/package-manager.d.ts.map +1 -0
  62. package/dist/runtime/package-manager.js +69 -0
  63. package/dist/runtime/package-manager.js.map +1 -0
  64. package/dist/runtime/runtime.d.ts +7 -0
  65. package/dist/runtime/runtime.d.ts.map +1 -1
  66. package/dist/runtime/runtime.js +54 -30
  67. package/dist/runtime/runtime.js.map +1 -1
  68. package/dist/runtime/sandbox-agent.d.ts +5 -0
  69. package/dist/runtime/sandbox-agent.d.ts.map +1 -1
  70. package/dist/runtime/sandbox-agent.js +32 -0
  71. package/dist/runtime/sandbox-agent.js.map +1 -1
  72. package/dist/runtime/sandbox-cleanup.d.ts +14 -0
  73. package/dist/runtime/sandbox-cleanup.d.ts.map +1 -0
  74. package/dist/runtime/sandbox-cleanup.js +77 -0
  75. package/dist/runtime/sandbox-cleanup.js.map +1 -0
  76. package/dist/runtime/sandbox-command.d.ts +1 -0
  77. package/dist/runtime/sandbox-command.d.ts.map +1 -1
  78. package/dist/runtime/sandbox-command.js +39 -9
  79. package/dist/runtime/sandbox-command.js.map +1 -1
  80. package/dist/runtime/sandbox-context.d.ts +5 -0
  81. package/dist/runtime/sandbox-context.d.ts.map +1 -0
  82. package/dist/runtime/sandbox-context.js +42 -0
  83. package/dist/runtime/sandbox-context.js.map +1 -0
  84. package/dist/runtime/sandbox-fx-resume.d.ts +11 -0
  85. package/dist/runtime/sandbox-fx-resume.d.ts.map +1 -0
  86. package/dist/runtime/sandbox-fx-resume.js +45 -0
  87. package/dist/runtime/sandbox-fx-resume.js.map +1 -0
  88. package/dist/runtime/sandbox-gateway.d.ts +17 -0
  89. package/dist/runtime/sandbox-gateway.d.ts.map +1 -0
  90. package/dist/runtime/sandbox-gateway.js +34 -0
  91. package/dist/runtime/sandbox-gateway.js.map +1 -0
  92. package/dist/runtime/sandbox-git.d.ts +19 -0
  93. package/dist/runtime/sandbox-git.d.ts.map +1 -0
  94. package/dist/runtime/sandbox-git.js +42 -0
  95. package/dist/runtime/sandbox-git.js.map +1 -0
  96. package/dist/runtime/sandbox-github.d.ts +10 -0
  97. package/dist/runtime/sandbox-github.d.ts.map +1 -0
  98. package/dist/runtime/sandbox-github.js +35 -0
  99. package/dist/runtime/sandbox-github.js.map +1 -0
  100. package/dist/runtime/sandbox-local-harness.d.ts +34 -0
  101. package/dist/runtime/sandbox-local-harness.d.ts.map +1 -0
  102. package/dist/runtime/sandbox-local-harness.js +151 -0
  103. package/dist/runtime/sandbox-local-harness.js.map +1 -0
  104. package/dist/runtime/sandbox-ports.d.ts +6 -0
  105. package/dist/runtime/sandbox-ports.d.ts.map +1 -0
  106. package/dist/runtime/sandbox-ports.js +11 -0
  107. package/dist/runtime/sandbox-ports.js.map +1 -0
  108. package/dist/runtime/sandbox-preview.d.ts +14 -0
  109. package/dist/runtime/sandbox-preview.d.ts.map +1 -0
  110. package/dist/runtime/sandbox-preview.js +96 -0
  111. package/dist/runtime/sandbox-preview.js.map +1 -0
  112. package/dist/runtime/sandbox-process.d.ts +11 -0
  113. package/dist/runtime/sandbox-process.d.ts.map +1 -0
  114. package/dist/runtime/sandbox-process.js +77 -0
  115. package/dist/runtime/sandbox-process.js.map +1 -0
  116. package/dist/runtime/sandbox-proxy.d.ts +2 -0
  117. package/dist/runtime/sandbox-proxy.d.ts.map +1 -1
  118. package/dist/runtime/sandbox-proxy.js +75 -20
  119. package/dist/runtime/sandbox-proxy.js.map +1 -1
  120. package/dist/runtime/sandbox-recovery.d.ts +4 -0
  121. package/dist/runtime/sandbox-recovery.d.ts.map +1 -0
  122. package/dist/runtime/sandbox-recovery.js +36 -0
  123. package/dist/runtime/sandbox-recovery.js.map +1 -0
  124. package/dist/runtime/sandbox-sessions.d.ts +8 -1
  125. package/dist/runtime/sandbox-sessions.d.ts.map +1 -1
  126. package/dist/runtime/sandbox-sessions.js +20 -2
  127. package/dist/runtime/sandbox-sessions.js.map +1 -1
  128. package/dist/runtime/sandbox-setup.d.ts +5 -0
  129. package/dist/runtime/sandbox-setup.d.ts.map +1 -0
  130. package/dist/runtime/sandbox-setup.js +62 -0
  131. package/dist/runtime/sandbox-setup.js.map +1 -0
  132. package/dist/runtime/sandbox-shell.d.ts +27 -0
  133. package/dist/runtime/sandbox-shell.d.ts.map +1 -0
  134. package/dist/runtime/sandbox-shell.js +169 -0
  135. package/dist/runtime/sandbox-shell.js.map +1 -0
  136. package/dist/runtime/sandbox-watch.d.ts +11 -0
  137. package/dist/runtime/sandbox-watch.d.ts.map +1 -0
  138. package/dist/runtime/sandbox-watch.js +30 -0
  139. package/dist/runtime/sandbox-watch.js.map +1 -0
  140. package/dist/runtime/sandbox-workspace.d.ts +125 -0
  141. package/dist/runtime/sandbox-workspace.d.ts.map +1 -0
  142. package/dist/runtime/sandbox-workspace.js +205 -0
  143. package/dist/runtime/sandbox-workspace.js.map +1 -0
  144. package/dist/runtime/sandbox.d.ts +21 -2
  145. package/dist/runtime/sandbox.d.ts.map +1 -1
  146. package/dist/runtime/sandbox.js +473 -207
  147. package/dist/runtime/sandbox.js.map +1 -1
  148. package/dist/runtime/session.d.ts +1 -1
  149. package/dist/runtime/session.d.ts.map +1 -1
  150. package/dist/runtime/session.js +3 -3
  151. package/dist/runtime/session.js.map +1 -1
  152. package/dist/runtime/terminal.d.ts +19 -0
  153. package/dist/runtime/terminal.d.ts.map +1 -0
  154. package/dist/runtime/terminal.js +60 -0
  155. package/dist/runtime/terminal.js.map +1 -0
  156. package/dist/runtime/workspace-client.d.ts +2 -0
  157. package/dist/runtime/workspace-client.d.ts.map +1 -0
  158. package/dist/runtime/workspace-client.js +46 -0
  159. package/dist/runtime/workspace-client.js.map +1 -0
  160. package/package.json +2 -1
  161. package/scripts/eve/README.md +341 -0
  162. package/scripts/eve/agent/agent.ts +12 -0
  163. package/scripts/eve/agent/channels/eve.ts +23 -0
  164. package/scripts/eve/agent/instructions.md +53 -0
  165. package/scripts/eve/agent/sandbox.ts +34 -0
  166. package/scripts/eve/build-cache.mjs +18 -0
  167. package/scripts/eve/build-cache.test.mjs +32 -0
  168. package/scripts/eve/client.mjs +229 -0
  169. package/scripts/eve/connection.mjs +89 -0
  170. package/scripts/eve/conversation.mjs +91 -0
  171. package/scripts/eve/conversation.test.mjs +113 -0
  172. package/scripts/eve/fixture-agent.ts +101 -0
  173. package/scripts/eve/images.mjs +84 -0
  174. package/scripts/eve/launch.mjs +277 -0
  175. package/scripts/eve/model-command.mjs +21 -0
  176. package/scripts/eve/reconnect.mjs +22 -0
  177. package/scripts/eve/reconnect.test.mjs +41 -0
  178. package/scripts/eve/settings.mjs +33 -0
  179. package/scripts/eve/supervisor.mjs +41 -0
  180. package/scripts/eve/tui-client.mjs +234 -0
  181. package/scripts/eve/tui-input.mjs +114 -0
  182. package/scripts/eve/verify.mjs +575 -0
  183. package/skills/d3k/SKILL.md +60 -5
@@ -0,0 +1,62 @@
1
+ import { createHash } from "node:crypto";
2
+ import { readdirSync, readFileSync } from "node:fs";
3
+ import { join } from "node:path";
4
+ /** Hash published inputs, not tar metadata or the shared canary version. */
5
+ export function distributionFingerprint(root) {
6
+ const hash = createHash("sha256");
7
+ const visit = (relative) => {
8
+ for (const entry of readdirSync(join(root, relative), { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
9
+ const name = join(relative, entry.name);
10
+ if (entry.isDirectory())
11
+ visit(name);
12
+ else if (entry.isFile())
13
+ hash
14
+ .update(name)
15
+ .update("\0")
16
+ .update(readFileSync(join(root, name)))
17
+ .update("\0");
18
+ }
19
+ };
20
+ hash.update(readFileSync(join(root, "package.json")));
21
+ for (const directory of ["bin", "dist", "scripts/eve", "skills/d3k"])
22
+ visit(directory);
23
+ return hash.digest("hex");
24
+ }
25
+ // Resolve against remote files, using the exact d3k distribution installed in the VM.
26
+ export const dependencyInstallPlanScript = `
27
+ const { pathToFileURL } = await import('node:url');
28
+ const { dependencyInstallPlan } = await import(pathToFileURL(process.argv[1]).href);
29
+ console.log(JSON.stringify(dependencyInstallPlan(process.cwd(), process.argv[2], process.argv[3])));
30
+ `;
31
+ // Runs in the repository. Include workspace manifests and lockfiles, including
32
+ // uncommitted edits. Save only after a successful install, which can update locks.
33
+ export const dependencyCacheScript = `
34
+ const fs = require('node:fs');
35
+ const path = require('node:path');
36
+ const { execFileSync } = require('node:child_process');
37
+ const { createHash } = require('node:crypto');
38
+ const [mode, marker, seed] = process.argv.slice(1);
39
+ const root = execFileSync('git', ['rev-parse', '--show-toplevel'], {encoding:'utf8'}).trim();
40
+ const files = [...new Set(execFileSync('git', ['ls-files', '-z', '--cached', '--others', '--exclude-standard'], {cwd:root, encoding:'utf8'}).split('\\0').filter(Boolean))].sort();
41
+ const hash = createHash('sha256').update(seed).update(process.version).update(process.arch).update(process.platform);
42
+ for (const name of files) {
43
+ if (!/^(package.json|bun.lockb?|package-lock.json|npm-shrinkwrap.json|yarn.lock|pnpm-lock.yaml|pnpm-workspace.yaml|bunfig.toml|.npmrc|.yarnrc.yml)$/.test(path.basename(name))) continue;
44
+ const file = path.join(root, name);
45
+ if (fs.existsSync(file)) hash.update(name).update('\\0').update(fs.readFileSync(file)).update('\\0');
46
+ }
47
+ const fingerprint = hash.digest('hex');
48
+ if (mode === 'save') {
49
+ fs.mkdirSync(path.dirname(marker), {recursive:true});
50
+ fs.writeFileSync(marker, fingerprint);
51
+ } else {
52
+ let directory = process.cwd();
53
+ let installed = false;
54
+ for (;;) {
55
+ installed ||= ['node_modules', '.pnp.cjs', '.pnp.js'].some(name => fs.existsSync(path.join(directory, name)));
56
+ if (directory === root || directory === path.dirname(directory)) break;
57
+ directory = path.dirname(directory);
58
+ }
59
+ process.exit(installed && fs.existsSync(marker) && fs.readFileSync(marker, 'utf8') === fingerprint ? 0 : 10);
60
+ }
61
+ `;
62
+ //# sourceMappingURL=sandbox-setup.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sandbox-setup.js","sourceRoot":"","sources":["../../src/runtime/sandbox-setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,4EAA4E;AAC5E,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAA;IACjC,MAAM,KAAK,GAAG,CAAC,QAAgB,EAAE,EAAE;QACjC,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC3F,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAC7B,EAAE,CAAC;YACF,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;YACvC,IAAI,KAAK,CAAC,WAAW,EAAE;gBAAE,KAAK,CAAC,IAAI,CAAC,CAAA;iBAC/B,IAAI,KAAK,CAAC,MAAM,EAAE;gBACrB,IAAI;qBACD,MAAM,CAAC,IAAI,CAAC;qBACZ,MAAM,CAAC,IAAI,CAAC;qBACZ,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;qBACtC,MAAM,CAAC,IAAI,CAAC,CAAA;QACnB,CAAC;IACH,CAAC,CAAA;IACD,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,CAAA;IACrD,KAAK,MAAM,SAAS,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,CAAC;QAAE,KAAK,CAAC,SAAS,CAAC,CAAA;IACtF,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAC3B,CAAC;AAED,sFAAsF;AACtF,MAAM,CAAC,MAAM,2BAA2B,GAAG;;;;CAI1C,CAAA;AAED,+EAA+E;AAC/E,mFAAmF;AACnF,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BpC,CAAA"}
@@ -0,0 +1,27 @@
1
+ import type { Readable, Writable } from "node:stream";
2
+ import type { Sandbox } from "@vercel/sandbox";
3
+ interface TerminalInput extends Readable {
4
+ isTTY?: boolean;
5
+ isRaw?: boolean;
6
+ setRawMode?: (raw: boolean) => unknown;
7
+ unref?: () => unknown;
8
+ }
9
+ interface TerminalOutput extends Writable {
10
+ columns?: number;
11
+ rows?: number;
12
+ }
13
+ export declare class SandboxShellDisconnected extends Error {
14
+ }
15
+ /** Use the Sandbox PTY protocol directly so a dropped socket is never a shell exit. */
16
+ export declare function runSandboxShell(options: {
17
+ sandbox: Pick<Sandbox, "openInteractive">;
18
+ cwd: string;
19
+ execution: [string, ...string[]];
20
+ env: Record<string, string>;
21
+ signal: AbortSignal;
22
+ input?: TerminalInput;
23
+ output?: TerminalOutput;
24
+ heartbeatMs?: number;
25
+ }): Promise<number | undefined>;
26
+ export {};
27
+ //# sourceMappingURL=sandbox-shell.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sandbox-shell.d.ts","sourceRoot":"","sources":["../../src/runtime/sandbox-shell.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAErD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAI9C,UAAU,aAAc,SAAQ,QAAQ;IACtC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAA;IACtC,KAAK,CAAC,EAAE,MAAM,OAAO,CAAA;CACtB;AACD,UAAU,cAAe,SAAQ,QAAQ;IACvC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,qBAAa,wBAAyB,SAAQ,KAAK;CAAG;AAEtD,uFAAuF;AACvF,wBAAsB,eAAe,CAAC,OAAO,EAAE;IAC7C,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAA;IACzC,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAA;IAChC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC3B,MAAM,EAAE,WAAW,CAAA;IACnB,KAAK,CAAC,EAAE,aAAa,CAAA;IACrB,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAwJ9B"}
@@ -0,0 +1,169 @@
1
+ import { setTimeout as delay } from "node:timers/promises";
2
+ import { WebSocket } from "ws";
3
+ import { terminalRestorer } from "./terminal.js";
4
+ export class SandboxShellDisconnected extends Error {
5
+ }
6
+ /** Use the Sandbox PTY protocol directly so a dropped socket is never a shell exit. */
7
+ export async function runSandboxShell(options) {
8
+ options.signal.throwIfAborted();
9
+ const { url, token } = await options.sandbox.openInteractive({ signal: options.signal });
10
+ options.signal.throwIfAborted();
11
+ const endpoint = new URL(url);
12
+ // Tokens go only to the TLS endpoint supplied by the SDK. Loopback HTTP is
13
+ // useful for protocol fixtures and never exposes credentials off-machine.
14
+ if (endpoint.protocol !== "wss:" && !(endpoint.protocol === "ws:" && endpoint.hostname === "127.0.0.1"))
15
+ throw new Error("Sandbox returned an insecure terminal endpoint");
16
+ const health = new URL("/health", endpoint);
17
+ health.protocol = endpoint.protocol === "wss:" ? "https:" : "http:";
18
+ let healthy = false;
19
+ for (let attempt = 0; attempt < 6; attempt++) {
20
+ options.signal.throwIfAborted();
21
+ healthy = await fetch(health, {
22
+ signal: AbortSignal.any([options.signal, AbortSignal.timeout(3000)])
23
+ })
24
+ .then(async (response) => {
25
+ await response.body?.cancel();
26
+ return response.ok;
27
+ })
28
+ .catch(() => false);
29
+ if (healthy)
30
+ break;
31
+ await delay(250 * (attempt + 1), undefined, { signal: options.signal });
32
+ }
33
+ if (!healthy)
34
+ throw new SandboxShellDisconnected("Remote terminal endpoint did not become ready");
35
+ endpoint.searchParams.set("token", token);
36
+ const input = options.input ?? process.stdin;
37
+ const output = options.output ?? process.stdout;
38
+ const restoreTerminal = terminalRestorer(input, output);
39
+ const wasFlowing = input.readableFlowing === true;
40
+ const socket = new WebSocket(endpoint, { handshakeTimeout: 10000, maxPayload: 1024 * 1024 });
41
+ return new Promise((resolve, reject) => {
42
+ let finished = false;
43
+ let missedPongs = 0;
44
+ let heartbeat;
45
+ let backpressure = false;
46
+ const cleanup = () => {
47
+ clearInterval(heartbeat);
48
+ options.signal.removeEventListener("abort", abort);
49
+ input.off("data", onInput);
50
+ input.off("end", onInputEnd);
51
+ output.off("drain", onDrain);
52
+ process.off("SIGWINCH", resize);
53
+ restoreTerminal();
54
+ if (!wasFlowing) {
55
+ input.pause();
56
+ input.unref?.();
57
+ }
58
+ socket.terminate();
59
+ };
60
+ const settle = (error, code) => {
61
+ if (finished)
62
+ return;
63
+ finished = true;
64
+ cleanup();
65
+ if (error)
66
+ reject(error);
67
+ else
68
+ resolve(code);
69
+ };
70
+ const abort = () => settle();
71
+ const onInput = (chunk) => {
72
+ if (socket.readyState !== WebSocket.OPEN)
73
+ return;
74
+ if (socket.bufferedAmount > 1024 * 1024) {
75
+ settle(new SandboxShellDisconnected("Terminal input connection is stalled"));
76
+ return;
77
+ }
78
+ socket.send(chunk, { binary: true }, (error) => {
79
+ if (error)
80
+ settle(new SandboxShellDisconnected("Terminal input connection failed"));
81
+ });
82
+ };
83
+ const onInputEnd = () => settle(new SandboxShellDisconnected("Local terminal input closed"));
84
+ const resize = () => {
85
+ if (socket.readyState === WebSocket.OPEN)
86
+ socket.send(JSON.stringify({ type: "resize", cols: output.columns ?? 80, rows: output.rows ?? 24 }));
87
+ };
88
+ const onDrain = () => {
89
+ if (backpressure)
90
+ socket.resume();
91
+ backpressure = false;
92
+ };
93
+ options.signal.addEventListener("abort", abort, { once: true });
94
+ socket.on("error", () => settle(new SandboxShellDisconnected("Terminal WebSocket connection failed")));
95
+ socket.on("close", (code) => {
96
+ settle(new SandboxShellDisconnected(`Terminal connection closed without a remote exit message (WebSocket ${code})`));
97
+ });
98
+ socket.on("pong", () => {
99
+ missedPongs = 0;
100
+ });
101
+ socket.on("open", () => {
102
+ if (finished)
103
+ return;
104
+ socket.send(JSON.stringify({
105
+ type: "start",
106
+ command: options.execution[0],
107
+ args: options.execution.slice(1),
108
+ env: Object.entries({ TERM: process.env.TERM || "xterm-256color", ...options.env }).map(([key, value]) => `${key}=${value}`),
109
+ cwd: options.cwd,
110
+ cols: output.columns ?? 80,
111
+ rows: output.rows ?? 24
112
+ }));
113
+ try {
114
+ if (input.isTTY)
115
+ input.setRawMode?.(true);
116
+ }
117
+ catch {
118
+ settle(new SandboxShellDisconnected("Local terminal is unavailable"));
119
+ return;
120
+ }
121
+ input.on("data", onInput);
122
+ input.once("end", onInputEnd);
123
+ input.resume();
124
+ output.on("drain", onDrain);
125
+ process.on("SIGWINCH", resize);
126
+ heartbeat = setInterval(() => {
127
+ if (missedPongs >= 2) {
128
+ settle(new SandboxShellDisconnected("Terminal connection stopped responding to keepalives"));
129
+ return;
130
+ }
131
+ missedPongs++;
132
+ socket.ping();
133
+ }, options.heartbeatMs ?? 30000);
134
+ heartbeat.unref();
135
+ });
136
+ socket.on("message", (data, binary) => {
137
+ if (finished)
138
+ return;
139
+ if (binary) {
140
+ const chunk = Array.isArray(data) ? Buffer.concat(data) : Buffer.isBuffer(data) ? data : Buffer.from(data);
141
+ if (!output.write(chunk)) {
142
+ backpressure = true;
143
+ socket.pause();
144
+ }
145
+ return;
146
+ }
147
+ let message;
148
+ try {
149
+ message = JSON.parse(data.toString());
150
+ }
151
+ catch {
152
+ output.write(data.toString());
153
+ return;
154
+ }
155
+ if (message.type === "exit") {
156
+ // The controller omits a zero-valued code. An explicit exit frame is
157
+ // still required; a WebSocket close alone never means success.
158
+ const code = message.code ?? 0;
159
+ if (!Number.isInteger(code))
160
+ settle(new SandboxShellDisconnected("Remote exit message contained an invalid code"));
161
+ else
162
+ settle(undefined, code);
163
+ }
164
+ });
165
+ if (options.signal.aborted)
166
+ abort();
167
+ });
168
+ }
169
+ //# sourceMappingURL=sandbox-shell.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sandbox-shell.js","sourceRoot":"","sources":["../../src/runtime/sandbox-shell.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ /** A failed API request is not evidence that a remote process exited. */
2
+ export declare function watchSandboxRuntime(options: {
3
+ status: (signal: AbortSignal) => Promise<{
4
+ exitCode: number | null;
5
+ }>;
6
+ signal: AbortSignal;
7
+ onExit: (code: number) => void;
8
+ log: (message: string) => void;
9
+ intervalMs?: number;
10
+ }): Promise<void>;
11
+ //# sourceMappingURL=sandbox-watch.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sandbox-watch.d.ts","sourceRoot":"","sources":["../../src/runtime/sandbox-watch.ts"],"names":[],"mappings":"AAEA,yEAAyE;AACzE,wBAAsB,mBAAmB,CAAC,OAAO,EAAE;IACjD,MAAM,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAA;IACrE,MAAM,EAAE,WAAW,CAAA;IACnB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9B,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBhB"}
@@ -0,0 +1,30 @@
1
+ import { setTimeout as delay } from "node:timers/promises";
2
+ /** A failed API request is not evidence that a remote process exited. */
3
+ export async function watchSandboxRuntime(options) {
4
+ let disconnected = false;
5
+ while (!options.signal.aborted) {
6
+ try {
7
+ const state = await options.status(AbortSignal.any([options.signal, AbortSignal.timeout(10000)]));
8
+ if (options.signal.aborted)
9
+ return;
10
+ if (disconnected)
11
+ options.log("Remote runtime monitoring reconnected");
12
+ disconnected = false;
13
+ if (state.exitCode !== null) {
14
+ options.onExit(state.exitCode);
15
+ return;
16
+ }
17
+ }
18
+ catch {
19
+ if (options.signal.aborted)
20
+ return;
21
+ if (!disconnected)
22
+ options.log("Remote runtime status unavailable; retrying without interrupting the shell");
23
+ disconnected = true;
24
+ }
25
+ await delay(options.intervalMs ?? (disconnected ? 15000 : 5000), undefined, {
26
+ signal: options.signal
27
+ }).catch(() => { });
28
+ }
29
+ }
30
+ //# sourceMappingURL=sandbox-watch.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sandbox-watch.js","sourceRoot":"","sources":["../../src/runtime/sandbox-watch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAE1D,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAMzC;IACC,IAAI,YAAY,GAAG,KAAK,CAAA;IACxB,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;YACjG,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO;gBAAE,OAAM;YAClC,IAAI,YAAY;gBAAE,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAA;YACtE,YAAY,GAAG,KAAK,CAAA;YACpB,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;gBAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;gBAC9B,OAAM;YACR,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO;gBAAE,OAAM;YAClC,IAAI,CAAC,YAAY;gBAAE,OAAO,CAAC,GAAG,CAAC,4EAA4E,CAAC,CAAA;YAC5G,YAAY,GAAG,IAAI,CAAA;QACrB,CAAC;QACD,MAAM,KAAK,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE;YAC1E,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IACpB,CAAC;AACH,CAAC"}
@@ -0,0 +1,125 @@
1
+ import type { Sandbox } from "@vercel/sandbox";
2
+ export declare const workspaceTools: readonly [{
3
+ readonly name: "sandbox_recover";
4
+ readonly description: "Recover a stopped or unhealthy dev runtime and browser bridge in the SAME sandbox, preserving files, the local browser, and the agent. No clone or dependency reinstall. Start returns immediately; poll with action status until recovered or failed, then reread sandbox_runtime status. A restarted runtime loses its old in-memory evidence. Does not replay agent commands, renew Gateway keys or extend compute lifetime.";
5
+ readonly inputSchema: {
6
+ readonly type: "object";
7
+ readonly properties: {
8
+ readonly action: {
9
+ readonly type: "string";
10
+ readonly enum: readonly ["start", "status"];
11
+ };
12
+ };
13
+ readonly additionalProperties: false;
14
+ };
15
+ }, {
16
+ readonly name: "sandbox_exec";
17
+ readonly description: "Run a shell command in the REMOTE project. Use for search, tests, dependencies, Git branches and commits. Nothing executes on the laptop.";
18
+ readonly inputSchema: {
19
+ readonly type: "object";
20
+ readonly properties: {
21
+ readonly command: {
22
+ readonly type: "string";
23
+ };
24
+ };
25
+ readonly required: readonly ["command"];
26
+ readonly additionalProperties: false;
27
+ };
28
+ }, {
29
+ readonly name: "sandbox_read_file";
30
+ readonly description: "Read a UTF-8 project file inside the sandbox. Paths are relative to the remote project root.";
31
+ readonly inputSchema: {
32
+ readonly type: "object";
33
+ readonly properties: {
34
+ readonly path: {
35
+ readonly type: "string";
36
+ };
37
+ };
38
+ readonly required: readonly ["path"];
39
+ readonly additionalProperties: false;
40
+ };
41
+ }, {
42
+ readonly name: "sandbox_write_file";
43
+ readonly description: "Write a UTF-8 project file inside the sandbox. Read existing files first. Nothing is saved to the laptop.";
44
+ readonly inputSchema: {
45
+ readonly type: "object";
46
+ readonly properties: {
47
+ readonly path: {
48
+ readonly type: "string";
49
+ };
50
+ readonly content: {
51
+ readonly type: "string";
52
+ };
53
+ };
54
+ readonly required: readonly ["path", "content"];
55
+ readonly additionalProperties: false;
56
+ };
57
+ }, {
58
+ readonly name: "sandbox_runtime";
59
+ readonly description: "Read d3k status or the shared browser/server events inside the running sandbox. Use events --after CURSOR for logs. Do not start or stop the runtime.";
60
+ readonly inputSchema: {
61
+ readonly type: "object";
62
+ readonly properties: {
63
+ readonly args: {
64
+ readonly type: "array";
65
+ readonly items: {
66
+ readonly type: "string";
67
+ };
68
+ };
69
+ };
70
+ readonly required: readonly ["args"];
71
+ readonly additionalProperties: false;
72
+ };
73
+ }, {
74
+ readonly name: "sandbox_browser";
75
+ readonly description: "Control the user's existing local Chrome through d3k. agent-browser arguments, e.g. [snapshot,-i], [fill,@e2,text], [click,@e3]. Loading metrics: [metrics,URL,--new-tab]. For requested page/UI changes or loading/jank investigations, capture BEFORE edits with [capture,URL,--output,/absolute/new-before-dir], repeat after edits into another directory, then [compare,/absolute/new-before-dir,/absolute/new-after-dir,--output,/absolute/report.html]. Optional capture flags: --ready CSS, --actions JSON (click/scroll/waitFor), --runs 1..5, --settle-ms 250..5000. Export paths are on the LOCAL laptop, not the remote repo. Videos and metrics are explicit local lab evidence, not field Web Vitals. CDP is already connected.";
76
+ readonly inputSchema: {
77
+ readonly type: "object";
78
+ readonly properties: {
79
+ readonly args: {
80
+ readonly type: "array";
81
+ readonly items: {
82
+ readonly type: "string";
83
+ };
84
+ };
85
+ };
86
+ readonly required: readonly ["args"];
87
+ readonly additionalProperties: false;
88
+ };
89
+ }, {
90
+ readonly name: "sandbox_github";
91
+ readonly description: "Publish branches/PRs for this sandbox's linked GitHub repository using LOCAL GitHub CLI authentication. GitHub credentials never enter the sandbox. Use Git Data APIs (blobs, trees, commits, refs) to publish remote Git objects, then /pulls to create a PR. No force pushes. Paths are repo-relative, e.g. /git/ref/heads/main or /pulls.";
92
+ readonly inputSchema: {
93
+ readonly type: "object";
94
+ readonly properties: {
95
+ readonly method: {
96
+ readonly type: "string";
97
+ readonly enum: readonly ["GET", "POST", "PATCH"];
98
+ };
99
+ readonly path: {
100
+ readonly type: "string";
101
+ };
102
+ readonly body: {
103
+ readonly type: "object";
104
+ };
105
+ };
106
+ readonly required: readonly ["method", "path"];
107
+ readonly additionalProperties: false;
108
+ };
109
+ }];
110
+ export type WorkspaceResult = {
111
+ content: {
112
+ type: "text";
113
+ text: string;
114
+ }[];
115
+ isError?: boolean;
116
+ };
117
+ export declare function workspaceHandler(sandbox: Sandbox, workdir: string, gitIdentity?: Record<string, string>): (name: string, args: Record<string, unknown>) => Promise<WorkspaceResult>;
118
+ /** A per-session loopback broker holds the live SDK credentials in the launcher.
119
+ * Harness configs contain only this ephemeral local connection capability. */
120
+ export declare function startWorkspaceBroker(call: (name: string, args: Record<string, unknown>) => Promise<WorkspaceResult>): Promise<{
121
+ url: string;
122
+ token: string;
123
+ close: () => Promise<void>;
124
+ }>;
125
+ //# sourceMappingURL=sandbox-workspace.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sandbox-workspace.d.ts","sourceRoot":"","sources":["../../src/runtime/sandbox-workspace.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAE9C,eAAO,MAAM,cAAc;aAEvB,IAAI,EAAE,iBAAiB;aACvB,WAAW,EACT,iaAAia;aACna,WAAW;iBACT,IAAI,EAAE,QAAQ;iBACd,UAAU;qBAAI,MAAM;yBAAI,IAAI,EAAE,QAAQ;yBAAE,IAAI,YAAG,OAAO,EAAE,QAAQ;;;iBAChE,oBAAoB;;;aAItB,IAAI,EAAE,cAAc;aACpB,WAAW,EACT,2IAA2I;aAC7I,WAAW;iBACT,IAAI,EAAE,QAAQ;iBACd,UAAU;qBAAI,OAAO;yBAAI,IAAI,EAAE,QAAQ;;;iBACvC,QAAQ,YAAG,SAAS;iBACpB,oBAAoB;;;aAItB,IAAI,EAAE,mBAAmB;aACzB,WAAW,EAAE,8FAA8F;aAC3G,WAAW;iBACT,IAAI,EAAE,QAAQ;iBACd,UAAU;qBAAI,IAAI;yBAAI,IAAI,EAAE,QAAQ;;;iBACpC,QAAQ,YAAG,MAAM;iBACjB,oBAAoB;;;aAItB,IAAI,EAAE,oBAAoB;aAC1B,WAAW,EACT,2GAA2G;aAC7G,WAAW;iBACT,IAAI,EAAE,QAAQ;iBACd,UAAU;qBAAI,IAAI;yBAAI,IAAI,EAAE,QAAQ;;qBAAI,OAAO;yBAAI,IAAI,EAAE,QAAQ;;;iBACjE,QAAQ,YAAG,MAAM,EAAE,SAAS;iBAC5B,oBAAoB;;;aAItB,IAAI,EAAE,iBAAiB;aACvB,WAAW,EACT,uJAAuJ;aACzJ,WAAW;iBACT,IAAI,EAAE,QAAQ;iBACd,UAAU;qBAAI,IAAI;yBAAI,IAAI,EAAE,OAAO;yBAAE,KAAK;6BAAI,IAAI,EAAE,QAAQ;;;;iBAC5D,QAAQ,YAAG,MAAM;iBACjB,oBAAoB;;;aAItB,IAAI,EAAE,iBAAiB;aACvB,WAAW,EACT,+sBAA+sB;aACjtB,WAAW;iBACT,IAAI,EAAE,QAAQ;iBACd,UAAU;qBAAI,IAAI;yBAAI,IAAI,EAAE,OAAO;yBAAE,KAAK;6BAAI,IAAI,EAAE,QAAQ;;;;iBAC5D,QAAQ,YAAG,MAAM;iBACjB,oBAAoB;;;aAItB,IAAI,EAAE,gBAAgB;aACtB,WAAW,EACT,8UAA8U;aAChV,WAAW;iBACT,IAAI,EAAE,QAAQ;iBACd,UAAU;qBACR,MAAM;yBAAI,IAAI,EAAE,QAAQ;yBAAE,IAAI,YAAG,KAAK,EAAE,MAAM,EAAE,OAAO;;qBACvD,IAAI;yBAAI,IAAI,EAAE,QAAQ;;qBACtB,IAAI;yBAAI,IAAI,EAAE,QAAQ;;;iBAExB,QAAQ,YAAG,QAAQ,EAAE,MAAM;iBAC3B,oBAAoB;;EAGhB,CAAA;AAEV,MAAM,MAAM,eAAe,GAAG;IAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAI9F,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,UAClF,MAAM,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,OAAO,CAAC,eAAe,CAAC,CA2DrF;AAED;8EAC8E;AAC9E,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,eAAe,CAAC;;;;GA2DhF"}