litmus-cli 1.4.101 → 1.5.0-beta.10

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 (80) hide show
  1. package/README.md +7 -4
  2. package/dist/commands/connect.d.ts +18 -0
  3. package/dist/commands/connect.d.ts.map +1 -1
  4. package/dist/commands/connect.js +245 -49
  5. package/dist/commands/connect.js.map +1 -1
  6. package/dist/commands/pause.d.ts.map +1 -1
  7. package/dist/commands/pause.js +12 -2
  8. package/dist/commands/pause.js.map +1 -1
  9. package/dist/cursor-session/extension.cjs +12 -3
  10. package/dist/cursor-session/package.json +3 -3
  11. package/dist/cursor-session/session.cjs +29 -6
  12. package/dist/index.js +10 -240
  13. package/dist/index.js.map +1 -1
  14. package/dist/lib/api.d.ts +1 -0
  15. package/dist/lib/api.d.ts.map +1 -1
  16. package/dist/lib/api.js +15 -4
  17. package/dist/lib/api.js.map +1 -1
  18. package/dist/lib/cursor-session.d.ts.map +1 -1
  19. package/dist/lib/cursor-session.js +4 -3
  20. package/dist/lib/cursor-session.js.map +1 -1
  21. package/dist/lib/editor-foreground.d.ts +9 -1
  22. package/dist/lib/editor-foreground.d.ts.map +1 -1
  23. package/dist/lib/editor-foreground.js +15 -0
  24. package/dist/lib/editor-foreground.js.map +1 -1
  25. package/dist/lib/environment-checks.d.ts +1 -3
  26. package/dist/lib/environment-checks.d.ts.map +1 -1
  27. package/dist/lib/environment-checks.js +2 -16
  28. package/dist/lib/environment-checks.js.map +1 -1
  29. package/dist/lib/hook-logger.cjs +40 -1
  30. package/dist/lib/hosted-capture.d.ts +4 -2
  31. package/dist/lib/hosted-capture.d.ts.map +1 -1
  32. package/dist/lib/hosted-capture.js +65 -14
  33. package/dist/lib/hosted-capture.js.map +1 -1
  34. package/dist/lib/installed-tools.d.ts +3 -0
  35. package/dist/lib/installed-tools.d.ts.map +1 -1
  36. package/dist/lib/installed-tools.js +31 -18
  37. package/dist/lib/installed-tools.js.map +1 -1
  38. package/dist/lib/launcher-cleanup-journal.d.ts +44 -0
  39. package/dist/lib/launcher-cleanup-journal.d.ts.map +1 -0
  40. package/dist/lib/launcher-cleanup-journal.js +196 -0
  41. package/dist/lib/launcher-cleanup-journal.js.map +1 -0
  42. package/dist/lib/launcher-inventory-cache.d.ts +44 -0
  43. package/dist/lib/launcher-inventory-cache.d.ts.map +1 -0
  44. package/dist/lib/launcher-inventory-cache.js +126 -0
  45. package/dist/lib/launcher-inventory-cache.js.map +1 -0
  46. package/dist/lib/launcher-preparation-cache.d.ts +46 -0
  47. package/dist/lib/launcher-preparation-cache.d.ts.map +1 -0
  48. package/dist/lib/launcher-preparation-cache.js +131 -0
  49. package/dist/lib/launcher-preparation-cache.js.map +1 -0
  50. package/dist/lib/node-version.d.ts +8 -0
  51. package/dist/lib/node-version.d.ts.map +1 -0
  52. package/dist/lib/node-version.js +23 -0
  53. package/dist/lib/node-version.js.map +1 -0
  54. package/dist/lib/portal-launcher-background.d.ts +2 -0
  55. package/dist/lib/portal-launcher-background.d.ts.map +1 -1
  56. package/dist/lib/portal-launcher-background.js.map +1 -1
  57. package/dist/lib/portal-launcher.d.ts +44 -5
  58. package/dist/lib/portal-launcher.d.ts.map +1 -1
  59. package/dist/lib/portal-launcher.js +417 -77
  60. package/dist/lib/portal-launcher.js.map +1 -1
  61. package/dist/lib/prepared-editor.d.ts.map +1 -1
  62. package/dist/lib/prepared-editor.js +20 -5
  63. package/dist/lib/prepared-editor.js.map +1 -1
  64. package/dist/lib/ssh-config-file.d.ts +13 -2
  65. package/dist/lib/ssh-config-file.d.ts.map +1 -1
  66. package/dist/lib/ssh-config-file.js +32 -27
  67. package/dist/lib/ssh-config-file.js.map +1 -1
  68. package/dist/lib/tool-installation-watcher.d.ts +20 -0
  69. package/dist/lib/tool-installation-watcher.d.ts.map +1 -0
  70. package/dist/lib/tool-installation-watcher.js +112 -0
  71. package/dist/lib/tool-installation-watcher.js.map +1 -0
  72. package/dist/lib/workspace-start-wait.d.ts +3 -1
  73. package/dist/lib/workspace-start-wait.d.ts.map +1 -1
  74. package/dist/lib/workspace-start-wait.js +36 -1
  75. package/dist/lib/workspace-start-wait.js.map +1 -1
  76. package/dist/program.d.ts +2 -0
  77. package/dist/program.d.ts.map +1 -0
  78. package/dist/program.js +244 -0
  79. package/dist/program.js.map +1 -0
  80. package/package.json +4 -4
@@ -0,0 +1,131 @@
1
+ /** Private, generation-fenced cache for completed launcher preparation work. */
2
+ import { createHash, randomUUID } from "crypto";
3
+ import fs from "fs";
4
+ import os from "os";
5
+ import path from "path";
6
+ import { CLI_VERSION } from "./version.js";
7
+ import { parseWorkspaceGeneration } from "./prepared-editor.js";
8
+ const CACHE_SCHEMA = 1;
9
+ export const LAUNCHER_PREPARATION_CACHE_MAX_AGE_MS = 15 * 60 * 1000;
10
+ const MAX_ENTRIES = 40;
11
+ const TOOLS = new Set(["vscode", "cursor", "codex", "claude", "ssh"]);
12
+ function defaultFile() { return path.join(os.homedir(), ".litmus", "launcher-preparation-cache.json"); }
13
+ function atomicWrite(file, value) {
14
+ fs.mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 });
15
+ const temporary = `${file}.${randomUUID()}.tmp`;
16
+ try {
17
+ fs.writeFileSync(temporary, JSON.stringify(value), { mode: 0o600, flag: "wx" });
18
+ fs.renameSync(temporary, file);
19
+ }
20
+ finally {
21
+ fs.rmSync(temporary, { force: true });
22
+ }
23
+ }
24
+ function defaultIo() {
25
+ return {
26
+ file: defaultFile(), platform: process.platform, arch: process.arch, now: Date.now,
27
+ read: file => fs.readFileSync(file, "utf8"), write: atomicWrite,
28
+ remove: file => fs.rmSync(file, { force: true }),
29
+ marker: command => {
30
+ try {
31
+ const stat = fs.statSync(fs.realpathSync(command));
32
+ return `${stat.size}:${Math.trunc(stat.mtimeMs)}`;
33
+ }
34
+ catch {
35
+ return null;
36
+ }
37
+ },
38
+ };
39
+ }
40
+ function origin(value) {
41
+ try {
42
+ const url = new URL(value);
43
+ return url.protocol === "https:" && !url.username && !url.password ? url.origin : null;
44
+ }
45
+ catch {
46
+ return null;
47
+ }
48
+ }
49
+ function scopeKey(context) {
50
+ return createHash("sha256").update(`${origin(context.backendUrl) ?? "invalid"}\0${context.alias}\0${context.token}`).digest("hex");
51
+ }
52
+ function entryKey(context, input) {
53
+ return createHash("sha256").update(`${scopeKey(context)}\0${input.generation.epoch}\0${input.generation.container_id}\0${input.tool}`).digest("hex");
54
+ }
55
+ function readFile(io) {
56
+ try {
57
+ const value = JSON.parse(io.read(io.file));
58
+ return value.schema === CACHE_SCHEMA && value.entries && typeof value.entries === "object"
59
+ ? { schema: CACHE_SCHEMA, entries: value.entries }
60
+ : { schema: CACHE_SCHEMA, entries: {} };
61
+ }
62
+ catch {
63
+ return { schema: CACHE_SCHEMA, entries: {} };
64
+ }
65
+ }
66
+ function validInput(input) {
67
+ if (!TOOLS.has(input.tool) || typeof input.command !== "string" || input.command.length > 4096 || /[\r\n\0]/.test(input.command) ||
68
+ !(path.posix.isAbsolute(input.command) || path.win32.isAbsolute(input.command)) ||
69
+ typeof input.preparationFingerprint !== "string" || !/^[a-f0-9]{64}$/i.test(input.preparationFingerprint))
70
+ return null;
71
+ return parseWorkspaceGeneration(input.generation);
72
+ }
73
+ export function hasLauncherPreparationCache(context, input, io = defaultIo()) {
74
+ const generation = validInput(input);
75
+ const backendOrigin = origin(context.backendUrl);
76
+ const entry = generation ? readFile(io).entries[entryKey(context, input)] : undefined;
77
+ const marker = io.marker(input.command);
78
+ return Boolean(entry && entry.schema === CACHE_SCHEMA && backendOrigin && entry.backendOrigin === backendOrigin &&
79
+ entry.alias === context.alias && entry.cliVersion === CLI_VERSION && entry.platform === io.platform && entry.arch === io.arch &&
80
+ entry.tool === input.tool && entry.generation?.epoch === generation?.epoch &&
81
+ entry.generation?.container_id === generation?.container_id &&
82
+ entry.preparationFingerprint === input.preparationFingerprint && marker && entry.commandMarker === marker &&
83
+ Number.isSafeInteger(entry.savedAt) && entry.savedAt <= io.now() && io.now() - entry.savedAt <= LAUNCHER_PREPARATION_CACHE_MAX_AGE_MS);
84
+ }
85
+ export function saveLauncherPreparationCache(context, input, io = defaultIo()) {
86
+ try {
87
+ const generation = validInput(input);
88
+ const backendOrigin = origin(context.backendUrl);
89
+ const commandMarker = io.marker(input.command);
90
+ if (!generation || !backendOrigin || !commandMarker)
91
+ return;
92
+ const cache = readFile(io);
93
+ cache.entries[entryKey(context, input)] = {
94
+ schema: CACHE_SCHEMA, savedAt: io.now(), cliVersion: CLI_VERSION, platform: io.platform, arch: io.arch,
95
+ backendOrigin, alias: context.alias, generation, tool: input.tool, commandMarker,
96
+ preparationFingerprint: input.preparationFingerprint,
97
+ };
98
+ const newest = Object.entries(cache.entries)
99
+ .filter((entry) => Boolean(entry[1]) && typeof entry[1] === "object" && Number.isSafeInteger(entry[1].savedAt))
100
+ .sort(([, a], [, b]) => b.savedAt - a.savedAt).slice(0, MAX_ENTRIES);
101
+ io.write(io.file, { schema: CACHE_SCHEMA, entries: Object.fromEntries(newest) });
102
+ }
103
+ catch { /* cache is optional */ }
104
+ }
105
+ export function clearLauncherPreparationCache(context, io = defaultIo()) {
106
+ const cache = readFile(io);
107
+ const prefix = scopeKey(context);
108
+ let changed = false;
109
+ for (const [key, entry] of Object.entries(cache.entries)) {
110
+ if (!entry || typeof entry !== "object")
111
+ continue;
112
+ const generation = parseWorkspaceGeneration(entry.generation);
113
+ if (!generation || !TOOLS.has(entry.tool))
114
+ continue;
115
+ const scoped = createHash("sha256").update(`${prefix}\0${generation.epoch}\0${generation.container_id}\0${entry.tool}`).digest("hex");
116
+ if (key !== scoped)
117
+ continue;
118
+ delete cache.entries[key];
119
+ changed = true;
120
+ }
121
+ if (!changed)
122
+ return;
123
+ try {
124
+ if (Object.keys(cache.entries).length)
125
+ io.write(io.file, cache);
126
+ else
127
+ io.remove(io.file);
128
+ }
129
+ catch { /* cache is optional */ }
130
+ }
131
+ //# sourceMappingURL=launcher-preparation-cache.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"launcher-preparation-cache.js","sourceRoot":"","sources":["../../src/lib/launcher-preparation-cache.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ /** Dependency-free CLI boot check, shared with setup-check and doctor. */
2
+ export declare const NODE_MIN_VERSION = "24.0.0";
3
+ export declare function checkNodeVersion(version?: string): {
4
+ name: "node";
5
+ status: "ok" | "warn" | "fail";
6
+ detail: string;
7
+ };
8
+ //# sourceMappingURL=node-version.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"node-version.d.ts","sourceRoot":"","sources":["../../src/lib/node-version.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,WAAW,CAAA;AAExC,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,MAAwB,GAAG;IACnE,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAA;IAC9B,MAAM,EAAE,MAAM,CAAA;CACf,CAkBA"}
@@ -0,0 +1,23 @@
1
+ /** Dependency-free CLI boot check, shared with setup-check and doctor. */
2
+ export const NODE_MIN_VERSION = "24.0.0";
3
+ export function checkNodeVersion(version = process.version) {
4
+ const value = version.trim();
5
+ if (!/^v?\d+(?:\.\d+){0,2}(?:[-+].*)?$/.test(value)) {
6
+ return { name: "node", status: "warn", detail: `Node.js: version could not be read (${version})` };
7
+ }
8
+ const parts = value.replace(/^v/, "").split(/[-+]/, 1)[0].split(".").map(Number);
9
+ const minimum = NODE_MIN_VERSION.split(".").map(Number);
10
+ for (let i = 0; i < 3; i++) {
11
+ if ((parts[i] ?? 0) < minimum[i]) {
12
+ return {
13
+ name: "node",
14
+ status: "fail",
15
+ detail: `Node.js: ${version} is too old. Update to Node.js ${NODE_MIN_VERSION} or newer, then run "litmus setup-check" again.`,
16
+ };
17
+ }
18
+ if ((parts[i] ?? 0) > minimum[i])
19
+ break;
20
+ }
21
+ return { name: "node", status: "ok", detail: `Node.js: ${version}` };
22
+ }
23
+ //# sourceMappingURL=node-version.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"node-version.js","sourceRoot":"","sources":["../../src/lib/node-version.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAA;AAExC,MAAM,UAAU,gBAAgB,CAAC,OAAO,GAAW,OAAO,CAAC,OAAO;IAKhE,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,CAAA;IAC5B,IAAI,CAAC,kCAAkC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,uCAAuC,OAAO,GAAG,EAAE,CAAA;IACpG,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAChF,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACvD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YACjC,OAAO;gBACL,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,YAAY,OAAO,kCAAkC,gBAAgB,iDAAiD;aAC/H,CAAA;QACH,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;YAAE,MAAK;IACzC,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,OAAO,EAAE,EAAE,CAAA;AACtE,CAAC"}
@@ -5,6 +5,8 @@ export interface PreparedLauncher {
5
5
  pageUrl: string;
6
6
  browserAvailable: boolean;
7
7
  assessmentName?: string;
8
+ /** Wall-clock command entry, carried across the detached worker boundary. */
9
+ connectStartedAt: number;
8
10
  }
9
11
  /** Pass credentials over IPC, never argv or a persistent settings/log file.
10
12
  * Wait for registration and discovery before releasing the terminal.
@@ -1 +1 @@
1
- {"version":3,"file":"portal-launcher-background.d.ts","sourceRoot":"","sources":["../../src/lib/portal-launcher-background.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,gBAAgB,EAAE,OAAO,CAAA;IACzB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,gBAAgB,EAAE,SAAS,SAAU,EAAE,MAAM,oBAA0D,GAAG,OAAO,CAAC,OAAO,CAAC,CA+B1K"}
1
+ {"version":3,"file":"portal-launcher-background.d.ts","sourceRoot":"","sources":["../../src/lib/portal-launcher-background.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,gBAAgB,EAAE,OAAO,CAAA;IACzB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,6EAA6E;IAC7E,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,gBAAgB,EAAE,SAAS,SAAU,EAAE,MAAM,oBAA0D,GAAG,OAAO,CAAC,OAAO,CAAC,CA+B1K"}
@@ -1 +1 @@
1
- {"version":3,"file":"portal-launcher-background.js","sourceRoot":"","sources":["../../src/lib/portal-launcher-background.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAA;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAWrC;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAyB,EAAE,SAAS,GAAG,MAAO,EAAE,MAAM,GAAG,IAAI,GAAG,CAAC,6BAA6B,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC;IACtJ,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;QAC9B,OAAO,GAAG,CAAC,uBAAuB,CAAA;QAClC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,EAAE;YAC7D,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,GAAG;YACjE,WAAW,EAAE,IAAI;SAClB,CAAC,CAAA;QACF,IAAI,MAAM,GAAyC,UAAU,CAAA;QAC7D,IAAI,OAAO,GAAG,KAAK,CAAA;QACnB,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,EAAE;YAC/B,IAAI,OAAO;gBAAE,OAAM;YACnB,OAAO,GAAG,IAAI,CAAA;YACd,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,IAAI,KAAK,EAAE,CAAC;gBAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YAAC,CAAC;iBACrC,CAAC;gBAAC,KAAK,CAAC,KAAK,EAAE,CAAC;gBAAC,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,CAAA;YAAC,CAAC;QACrD,CAAC,CAAA;QACD,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC,CAAA;QAC3G,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;QAC5C,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAC5B,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAC3B,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAA;QAC5E,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE;YAC5B,MAAM,IAAI,GAAI,OAAoC,EAAE,IAAI,CAAA;YACxD,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;gBAAC,MAAM,GAAG,aAAa,CAAC;gBAAC,OAAM;YAAC,CAAC;YAC9D,IAAI,IAAI,KAAK,OAAO,IAAI,MAAM,KAAK,UAAU;gBAAE,OAAM;YACrD,MAAM,GAAG,OAAO,CAAA;YAChB,KAAK,CAAC,IAAK,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,KAAK,CAAC,EAAE,GAAG,IAAI,KAAK;gBAAE,OAAO,EAAE,CAAA,CAAC,CAAC,CAAC,CAAA;QACpE,CAAC,CAAC,CAAA;QACF,KAAK,CAAC,IAAK,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,GAAG,IAAI,KAAK;YAAE,OAAO,EAAE,CAAA,CAAC,CAAC,CAAC,CAAA;IACzD,CAAC,CAAC,CAAA;AACJ,CAAC"}
1
+ {"version":3,"file":"portal-launcher-background.js","sourceRoot":"","sources":["../../src/lib/portal-launcher-background.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAA;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAarC;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAyB,EAAE,SAAS,GAAG,MAAO,EAAE,MAAM,GAAG,IAAI,GAAG,CAAC,6BAA6B,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC;IACtJ,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;QAC9B,OAAO,GAAG,CAAC,uBAAuB,CAAA;QAClC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,EAAE;YAC7D,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,GAAG;YACjE,WAAW,EAAE,IAAI;SAClB,CAAC,CAAA;QACF,IAAI,MAAM,GAAyC,UAAU,CAAA;QAC7D,IAAI,OAAO,GAAG,KAAK,CAAA;QACnB,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,EAAE;YAC/B,IAAI,OAAO;gBAAE,OAAM;YACnB,OAAO,GAAG,IAAI,CAAA;YACd,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,IAAI,KAAK,EAAE,CAAC;gBAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YAAC,CAAC;iBACrC,CAAC;gBAAC,KAAK,CAAC,KAAK,EAAE,CAAC;gBAAC,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,CAAA;YAAC,CAAC;QACrD,CAAC,CAAA;QACD,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC,CAAA;QAC3G,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;QAC5C,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAC5B,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAC3B,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAA;QAC5E,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE;YAC5B,MAAM,IAAI,GAAI,OAAoC,EAAE,IAAI,CAAA;YACxD,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;gBAAC,MAAM,GAAG,aAAa,CAAC;gBAAC,OAAM;YAAC,CAAC;YAC9D,IAAI,IAAI,KAAK,OAAO,IAAI,MAAM,KAAK,UAAU;gBAAE,OAAM;YACrD,MAAM,GAAG,OAAO,CAAA;YAChB,KAAK,CAAC,IAAK,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,KAAK,CAAC,EAAE,GAAG,IAAI,KAAK;gBAAE,OAAO,EAAE,CAAA,CAAC,CAAC,CAAC,CAAA;QACpE,CAAC,CAAC,CAAA;QACF,KAAK,CAAC,IAAK,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,GAAG,IAAI,KAAK;YAAE,OAAO,EAAE,CAAA,CAAC,CAAC,CAAC,CAAA;IACzD,CAAC,CAAC,CAAA;AACJ,CAAC"}
@@ -1,14 +1,35 @@
1
- import { spawn, fork } from "child_process";
2
- import { type InstalledTool, type LaunchTool } from "./installed-tools.js";
1
+ import { execFile, spawn, fork } from "child_process";
2
+ import { type InstalledLaunchTool, type InstalledTool, type LaunchTool } from "./installed-tools.js";
3
3
  import { type WorkspaceGeneration, type PreparedEditor } from "./prepared-editor.js";
4
4
  export declare function permanentLauncherFailure(error: unknown): boolean;
5
5
  export type LaunchResult = "dispatched" | "action_required" | "failed";
6
+ export interface LaunchOutcome {
7
+ status: LaunchResult;
8
+ reason?: "confirmation_required";
9
+ }
10
+ export declare function desktopLaunchOutcome(tool: "codex" | "claude", opened: boolean): LaunchResult | LaunchOutcome;
11
+ type TimingStage = "cli_started" | "tool_inventory_complete" | "tool_preparation_started" | "tool_preparation_complete" | "launcher_ready" | "command_received" | "os_open_started" | "os_open_finished" | "remote_ready" | "result_acknowledged" | "cleanup_complete" | "cleanup_queued" | "cleanup_retry" | "cleanup_abandoned" | "tool_inventory_cache_hit" | "tool_inventory_cache_miss" | "tool_inventory_cache_rejected" | "tool_inventory_revalidated" | "tool_preparation_cache_hit" | "tool_preparation_cache_miss";
12
+ /** Fixed-schema best-effort receipt; observation can never delay the launcher. */
13
+ export declare function reportLauncherTiming(backendUrl: string, token: string, stage: TimingStage, elapsedMs: number, extra?: {
14
+ tool?: LaunchTool;
15
+ outcome?: "ok" | "failed" | "timeout" | "cancelled";
16
+ sessionId?: string;
17
+ requestId?: string;
18
+ temperature?: "cold" | "warm" | "unknown";
19
+ readinessPath?: "event" | "poll";
20
+ }): void;
6
21
  export declare function desktopUrl(tool: "codex" | "claude", alias: string): string;
7
22
  export declare function spawnDetached(command: string, args: string[]): Promise<boolean>;
8
23
  export declare function terminalRemoteCommand(requestId?: string): string;
24
+ /** Foreground the live, assessment-scoped Terminal session before opening another shell. */
25
+ export declare function focusExistingMacTerminal(alias: string, execFileFn?: typeof execFile): Promise<boolean>;
26
+ /** Close only the assessment tab that the portal launcher created on macOS. */
27
+ export declare function closeOwnedMacTerminal(alias: string, platform?: NodeJS.Platform, execFileFn?: typeof execFile): Promise<"closed" | "not_found" | "unsupported">;
9
28
  export declare function openTerminal(alias: string, terminal: string, requestId?: string): Promise<boolean>;
29
+ /** Remove only the launcher file created for this exact assessment alias. */
30
+ export declare function removeTerminalLauncher(alias: string, home?: string): void;
10
31
  /** Isolate existing fatal/exit paths and synchronous probes from the heartbeat process. */
11
- export declare function openNativeEditor(tool: "vscode" | "cursor", token: string, signal?: AbortSignal, forkFn?: typeof fork, onPrepared?: (editor: PreparedEditor) => void, generation?: WorkspaceGeneration): Promise<LaunchResult>;
32
+ export declare function openNativeEditor(tool: "vscode" | "cursor", token: string, signal?: AbortSignal, forkFn?: typeof fork, onPrepared?: (editor: PreparedEditor) => void, generation?: WorkspaceGeneration, remoteReady?: Promise<boolean>, onRemoteReady?: () => void): Promise<LaunchResult>;
12
33
  /** Announce preparation before skills, key creation and workspace startup.
13
34
  * Older/unavailable launcher APIs must not prevent the assessment connection.
14
35
  * A killed process expires server-side; normal exits remove only this session.
@@ -29,15 +50,33 @@ export interface LauncherOptions {
29
50
  launch: (tool: LaunchTool, installed: InstalledTool[], signal: AbortSignal, context?: {
30
51
  requestId: string;
31
52
  generation?: WorkspaceGeneration;
32
- }) => Promise<LaunchResult>;
33
- prepareTools?: (installed: InstalledTool[], signal: AbortSignal) => Promise<InstalledTool[]>;
53
+ remoteReady?: Promise<boolean>;
54
+ }) => Promise<LaunchResult | LaunchOutcome>;
55
+ prepareTools?: (installed: InstalledTool[], signal: AbortSignal, onPrepared: (tool: InstalledTool) => Promise<void>, generation?: unknown) => Promise<InstalledTool[]>;
34
56
  onReady?: () => void;
57
+ onRegistered?: (generation: unknown) => void | Promise<void>;
35
58
  onSubmitted?: () => void | Promise<void>;
59
+ reportTiming?: (stage: TimingStage, elapsedMs: number, extra?: Parameters<typeof reportLauncherTiming>[4]) => void;
60
+ connectStartedAt?: number;
36
61
  signal?: AbortSignal;
37
62
  /** Injectable scheduling for deterministic retry tests. Production defaults to 5s. */
38
63
  wait?: (ms: number, signal: AbortSignal) => Promise<void>;
64
+ discoverTools?: () => InstalledTool[];
65
+ discoverTool?: (tool: InstalledLaunchTool) => InstalledTool | null;
66
+ watchInstallations?: (onChange: (tool: InstalledLaunchTool | null) => void, signal: AbortSignal) => () => void;
67
+ /** Full scan fallback for missed filesystem events. Production defaults to five minutes. */
68
+ inventoryReconcileMs?: number;
69
+ /** Last local inventory is display-only until this run revalidates it. */
70
+ cachedInventory?: {
71
+ tools: InstalledTool[];
72
+ generation: WorkspaceGeneration;
73
+ savedAt: number;
74
+ };
75
+ onInventoryRevalidated?: (tools: InstalledTool[], generation: unknown) => void;
76
+ onInventoryCacheRejected?: () => void;
39
77
  }
40
78
  export declare function runPortalLauncher(options: LauncherOptions): Promise<void>;
41
79
  /** Observe the OS opener's exit status; spawning it alone does not prove dispatch. */
42
80
  export declare function openDesktop(app: InstalledTool, alias: string, signal: AbortSignal, platform?: NodeJS.Platform, spawnFn?: typeof spawn): Promise<boolean>;
81
+ export {};
43
82
  //# sourceMappingURL=portal-launcher.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"portal-launcher.d.ts","sourceRoot":"","sources":["../../src/lib/portal-launcher.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"portal-launcher.d.ts","sourceRoot":"","sources":["../../src/lib/portal-launcher.ts"],"names":[],"mappings":"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"}