@iwsdk/cli 0.5.3 → 1.0.0-rc.0

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 (39) hide show
  1. package/README.md +62 -1
  2. package/bin/iwsdk.js +1 -1
  3. package/dist/browser-lease.d.ts +14 -0
  4. package/dist/browser-lease.d.ts.map +1 -0
  5. package/dist/cli-types.d.ts +1 -1
  6. package/dist/cli-types.d.ts.map +1 -1
  7. package/dist/cli.js +2811 -485
  8. package/dist/cli.js.map +1 -1
  9. package/dist/commands/browser.d.ts +14 -0
  10. package/dist/commands/browser.d.ts.map +1 -0
  11. package/dist/commands/dev.d.ts +6 -2
  12. package/dist/commands/dev.d.ts.map +1 -1
  13. package/dist/commands/runtime.d.ts.map +1 -1
  14. package/dist/commands/status.d.ts.map +1 -1
  15. package/dist/contract.js +481 -30
  16. package/dist/contract.js.map +1 -1
  17. package/dist/help.d.ts +1 -0
  18. package/dist/help.d.ts.map +1 -1
  19. package/dist/index.d.ts.map +1 -1
  20. package/dist/index.js +2813 -487
  21. package/dist/index.js.map +1 -1
  22. package/dist/mcp-stdio.d.ts.map +1 -1
  23. package/dist/runtime-contract.d.ts +70 -1
  24. package/dist/runtime-contract.d.ts.map +1 -1
  25. package/dist/runtime-files.d.ts +19 -0
  26. package/dist/runtime-files.d.ts.map +1 -0
  27. package/dist/runtime-files.js +318 -0
  28. package/dist/runtime-files.js.map +1 -0
  29. package/dist/runtime-owner.d.ts +50 -0
  30. package/dist/runtime-owner.d.ts.map +1 -0
  31. package/dist/runtime-owner.js +539 -0
  32. package/dist/runtime-owner.js.map +1 -0
  33. package/dist/runtime-state.d.ts +20 -18
  34. package/dist/runtime-state.d.ts.map +1 -1
  35. package/dist/runtime-transport.d.ts.map +1 -1
  36. package/dist/screenshot-output.d.ts +13 -0
  37. package/dist/screenshot-output.d.ts.map +1 -0
  38. package/guidance/AGENTS.md +96 -37
  39. package/package.json +16 -2
@@ -1 +1 @@
1
- {"version":3,"file":"mcp-stdio.d.ts","sourceRoot":"","sources":["../src/mcp-stdio.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAW/B,MAAM,WAAW,iCAAiC;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;CACtD;AAyID,wBAAsB,0BAA0B,CAAC,EAC/C,UAAoB,EACpB,OAAiB,EACjB,cAAc,GACf,EAAE,iCAAiC,GAAG,OAAO,CAAC,IAAI,CAAC,CAsKnD"}
1
+ {"version":3,"file":"mcp-stdio.d.ts","sourceRoot":"","sources":["../src/mcp-stdio.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAY/B,MAAM,WAAW,iCAAiC;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;CACtD;AAoND,wBAAsB,0BAA0B,CAAC,EAC/C,UAAoB,EACpB,OAAiB,EACjB,cAAc,GACf,EAAE,iCAAiC,GAAG,OAAO,CAAC,IAAI,CAAC,CAsMnD"}
@@ -7,6 +7,8 @@
7
7
  export type AiTool = 'claude' | 'cursor' | 'copilot' | 'codex' | 'opencode';
8
8
  export declare const DEFAULT_RUNTIME_COMMAND_TIMEOUT_MS = 30000;
9
9
  export declare const UI_RENDER_PREVIEW_TIMEOUT_MS = 60000;
10
+ export declare const ASSET_RENDER_PREVIEW_TIMEOUT_MS = 120000;
11
+ export declare const BROWSER_RUNTIME_COMMAND_TIMEOUT_MS = 60000;
10
12
  export declare function getDefaultRuntimeCommandTimeoutMs(method: string): number;
11
13
  export type JsonSchema = {
12
14
  type?: string;
@@ -21,6 +23,7 @@ export type JsonSchema = {
21
23
  minimum?: number;
22
24
  exclusiveMinimum?: number;
23
25
  maximum?: number;
26
+ maxLength?: number;
24
27
  minItems?: number;
25
28
  maxItems?: number;
26
29
  pattern?: string;
@@ -44,15 +47,22 @@ export interface RuntimeOperationDefinition {
44
47
  mcpName: string;
45
48
  wsMethod: string;
46
49
  target?: RuntimePageTarget;
50
+ execution: 'server' | 'host' | 'runtime';
51
+ physical: boolean;
47
52
  description: string;
48
53
  inputSchema: JsonSchema;
49
54
  }
50
55
  export type RuntimePageRole = 'app' | 'editor' | 'preview';
56
+ export type RuntimeDeviceClass = 'managed' | 'physical';
51
57
  export interface RuntimePageTarget {
52
58
  role?: RuntimePageRole;
59
+ deviceClass?: RuntimeDeviceClass;
53
60
  pageId?: string;
54
61
  tabGeneration?: number;
55
62
  sceneSessionId?: string;
63
+ headsetId?: string;
64
+ browserEpoch?: number;
65
+ sessionId?: string;
56
66
  }
57
67
  export declare const IWSDK_PROJECT_STATE_DIR = ".iwsdk";
58
68
  export declare const IWSDK_RUNTIME_STATE_DIR = ".iwsdk/runtime";
@@ -62,6 +72,8 @@ export declare const IWSDK_RUNTIME_LAUNCH_PATH = ".iwsdk/runtime/launch.json";
62
72
  export declare const IWSDK_RUNTIME_STATE_SCHEMA_VERSION = 2;
63
73
  export declare const IWSDK_RUNTIME_BROWSER_READY_SCHEMA_VERSION = 2;
64
74
  export declare const INTERNAL_BROWSER_PROBE_METHOD = "__iwsdk_browser_probe";
75
+ export declare const INTERNAL_RUNTIME_SHUTDOWN_METHOD = "__iwsdk_runtime_shutdown";
76
+ export declare const INTERNAL_RUNTIME_LAUNCH_CLAIM_ENV = "IWSDK_DEV_LAUNCH_CLAIM_ID";
65
77
  export type RuntimeIssueCause = 'browser_not_ready' | 'browser_not_launched' | 'browser_launch_failed' | 'connection_lost' | 'permission_denied' | 'browser_relaunched' | 'tab_throttled' | 'open_failed';
66
78
  export interface RuntimeIssueInfo {
67
79
  cause: RuntimeIssueCause;
@@ -69,11 +81,51 @@ export interface RuntimeIssueInfo {
69
81
  at: string;
70
82
  }
71
83
  export type RuntimeBrowserStatus = 'not_launched' | 'launching' | 'waiting_for_connection' | 'connected' | 'disconnected' | 'launch_failed';
84
+ export interface RuntimeBrowserClient {
85
+ pageId: string;
86
+ role: RuntimePageRole;
87
+ deviceClass: RuntimeDeviceClass;
88
+ tabGeneration: number;
89
+ commandReady: boolean;
90
+ sceneSessionId?: string;
91
+ headsetId?: string;
92
+ browserEpoch?: number;
93
+ sessionId?: string;
94
+ }
95
+ export interface RuntimeBrowserLifecycle {
96
+ state: 'idle' | 'launching' | 'running' | 'closing' | 'failed' | 'stopped';
97
+ policy: 'disabled' | 'eager';
98
+ sessionId: string;
99
+ browserEpoch: number;
100
+ revision: number;
101
+ stateEnteredAt: string;
102
+ lastObservedAt: string;
103
+ attemptId?: string;
104
+ phase?: 'installing' | 'starting';
105
+ deadline?: string;
106
+ cleanupConfirmed?: boolean;
107
+ issueAt?: string;
108
+ issueCause?: RuntimeIssueCause;
109
+ historyTruncated?: boolean;
110
+ attemptLimit?: number;
111
+ failures: number;
112
+ retryEligible: boolean;
113
+ nextAction: string;
114
+ issue?: string;
115
+ history: Array<{
116
+ revision: number;
117
+ state: RuntimeBrowserLifecycle['state'];
118
+ at: string;
119
+ reason: string;
120
+ }>;
121
+ }
72
122
  export interface RuntimeBrowserState {
123
+ lifecycle?: RuntimeBrowserLifecycle;
73
124
  status: RuntimeBrowserStatus;
74
125
  connected: boolean;
75
126
  commandReady: boolean;
76
127
  connectedClientCount: number;
128
+ clients?: RuntimeBrowserClient[];
77
129
  lastTransitionAt: string;
78
130
  lastBridgeConnectedAt?: string;
79
131
  lastCommandReadyAt?: string;
@@ -90,18 +142,35 @@ export interface RuntimeSession {
90
142
  sessionId: string;
91
143
  workspaceRoot: string;
92
144
  pid: number;
145
+ processStart?: string | null;
93
146
  port: number;
94
147
  localUrl: string;
95
148
  networkUrls: string[];
96
149
  aiMode?: string;
97
150
  browser?: RuntimeBrowserState;
151
+ browserAutomation?: {
152
+ configured: boolean;
153
+ enabled: boolean;
154
+ endpoint?: string;
155
+ protocol: 'cdp';
156
+ targetId?: string;
157
+ };
98
158
  registeredAt: string;
99
159
  updatedAt: string;
100
160
  }
101
161
  export interface LaunchMetadata {
102
162
  schemaVersion: number;
163
+ /** Unique owner token for compare-and-clear startup coordination. */
164
+ claimId?: string;
165
+ /** Distinguishes an interruptible startup claim from a running child. */
166
+ phase?: 'starting' | 'running';
103
167
  workspaceRoot: string;
104
168
  pid: number;
169
+ processStart?: string | null;
170
+ /** Package-manager shim initially spawned by the CLI. */
171
+ launcherPid?: number;
172
+ /** Detached POSIX process group used to stop the complete dev subprocess tree. */
173
+ processGroupId?: number;
105
174
  command: string;
106
175
  args: string[];
107
176
  logPath: string | null;
@@ -130,7 +199,7 @@ export declare const APP_RUNTIME_SCENE_MCP_TOOL_NAMES: readonly ["scene_get_rend
130
199
  export declare const RUNTIME_MCP_TOOLS: McpToolDefinition[];
131
200
  export declare const RUNTIME_TOOL_TO_METHOD: Record<string, string>;
132
201
  export declare const RUNTIME_CLI_PATHS: Record<string, string[]>;
133
- export declare const SCENE_EDITOR_MCP_TOOL_NAMES: readonly ["scene_get_capabilities", "scene_get_state", "scene_select", "scene_set_camera", "scene_screenshot", "scene_set_preview_visibility", "scene_measure_image_regions", "ui_list_assets", "ui_render_preview"];
202
+ export declare const SCENE_EDITOR_MCP_TOOL_NAMES: readonly ["scene_get_capabilities", "scene_get_state", "scene_select", "scene_set_camera", "scene_screenshot", "scene_set_preview_visibility", "scene_measure_image_regions", "asset_render_preview", "ui_list_assets", "ui_render_preview"];
134
203
  export declare const SCENE_FILE_MCP_TOOL_NAMES: readonly ["scene_open", "scene_render_file", "scene_flatten_file"];
135
204
  export declare const PROJECT_ASSET_MCP_TOOL_NAMES: readonly [];
136
205
  export declare const REVIEW_EVIDENCE_MCP_TOOL_NAMES: readonly [];
@@ -1 +1 @@
1
- {"version":3,"file":"runtime-contract.d.ts","sourceRoot":"","sources":["../src/runtime-contract.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"runtime-contract.d.ts","sourceRoot":"","sources":["../src/runtime-contract.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,19 @@
1
+ /**
2
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
3
+ *
4
+ * This source code is licensed under the MIT license found in the
5
+ * LICENSE file in the root directory of this source tree.
6
+ */
7
+ export declare function normalizeWorkspaceRoot(workspaceRoot: string): string;
8
+ export declare function getRuntimeFilePath(workspaceRoot: string, relativePath: string): string;
9
+ export declare function readRuntimeJson<T>(filePath: string): Promise<T | null>;
10
+ export declare function writeRuntimeJson(filePath: string, value: unknown): Promise<void>;
11
+ export declare function removeRuntimeFile(filePath: string): Promise<void>;
12
+ export declare function isRuntimeProcessAlive(pid: number): boolean;
13
+ export declare function getRuntimeFileLockPath(filePath: string): string;
14
+ /** OS process birth identity distinguishes a live owner from a reused PID. */
15
+ export declare function getRuntimeProcessStart(pid: number): string | null;
16
+ /** Atomic publication is also used by exit-time cleanup; never publish an empty lock. */
17
+ export declare function tryRuntimeFileLockSync(filePath: string): (() => void) | null;
18
+ export declare function withRuntimeFileLock<T>(filePath: string, operation: () => Promise<T>): Promise<T>;
19
+ //# sourceMappingURL=runtime-files.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime-files.d.ts","sourceRoot":"","sources":["../src/runtime-files.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqDH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAOpE;AAED,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,GACnB,MAAM,CAER;AAED,wBAAsB,eAAe,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAM5E;AAED,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,IAAI,CAAC,CAaf;AAED,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvE;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAU1D;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE/D;AAsBD,8EAA8E;AAC9E,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiDjE;AAwED,yFAAyF;AACzF,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CA4B5E;AA4DD,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC,CAAC,CAAC,CAoBZ"}
@@ -0,0 +1,318 @@
1
+ import { execFileSync } from 'child_process';
2
+ import { randomUUID } from 'crypto';
3
+ import { existsSync, realpathSync, readFileSync, mkdirSync, writeFileSync, renameSync, unlinkSync, rmdirSync, rmSync } from 'fs';
4
+ import { readFile, mkdir, writeFile, rm, rename, mkdtemp, readdir, unlink, rmdir } from 'fs/promises';
5
+ import path from 'path';
6
+
7
+ /**
8
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
9
+ *
10
+ * This source code is licensed under the MIT license found in the
11
+ * LICENSE file in the root directory of this source tree.
12
+ */
13
+ const LOCK_TIMEOUT_MS = 5_000;
14
+ const mutationQueues = new Map();
15
+ async function renameRuntimeFile(tempPath, filePath) {
16
+ for (let attempt = 0;; attempt += 1) {
17
+ try {
18
+ await rename(tempPath, filePath);
19
+ return;
20
+ }
21
+ catch (error) {
22
+ const code = error.code;
23
+ if (process.platform !== 'win32' ||
24
+ attempt >= 4 ||
25
+ !['EACCES', 'EBUSY', 'EPERM'].includes(code ?? '')) {
26
+ throw error;
27
+ }
28
+ await new Promise((resolve) => setTimeout(resolve, 25 * 2 ** attempt));
29
+ }
30
+ }
31
+ }
32
+ function normalizeWorkspaceRoot(workspaceRoot) {
33
+ const resolved = path.resolve(workspaceRoot);
34
+ try {
35
+ return existsSync(resolved) ? realpathSync.native(resolved) : resolved;
36
+ }
37
+ catch {
38
+ return resolved;
39
+ }
40
+ }
41
+ function getRuntimeFilePath(workspaceRoot, relativePath) {
42
+ return path.join(normalizeWorkspaceRoot(workspaceRoot), relativePath);
43
+ }
44
+ async function readRuntimeJson(filePath) {
45
+ try {
46
+ return JSON.parse(await readFile(filePath, 'utf8'));
47
+ }
48
+ catch {
49
+ return null;
50
+ }
51
+ }
52
+ async function writeRuntimeJson(filePath, value) {
53
+ await mkdir(path.dirname(filePath), { recursive: true, mode: 0o700 });
54
+ const tempPath = `${filePath}.${process.pid}.${randomUUID()}.tmp`;
55
+ try {
56
+ await writeFile(tempPath, `${JSON.stringify(value, null, 2)}\n`, {
57
+ encoding: 'utf8',
58
+ flag: 'wx',
59
+ mode: 0o600,
60
+ });
61
+ await renameRuntimeFile(tempPath, filePath);
62
+ }
63
+ finally {
64
+ await rm(tempPath, { force: true }).catch(() => { });
65
+ }
66
+ }
67
+ async function removeRuntimeFile(filePath) {
68
+ await rm(filePath, { force: true }).catch(() => { });
69
+ }
70
+ function isRuntimeProcessAlive(pid) {
71
+ if (!Number.isInteger(pid) || pid <= 0) {
72
+ return false;
73
+ }
74
+ try {
75
+ process.kill(pid, 0);
76
+ return true;
77
+ }
78
+ catch (error) {
79
+ return error.code === 'EPERM';
80
+ }
81
+ }
82
+ function getRuntimeFileLockPath(filePath) {
83
+ return `${filePath}.lock`;
84
+ }
85
+ async function removeOrphanedTempFiles(filePath) {
86
+ const directory = path.dirname(filePath);
87
+ const prefix = `${path.basename(filePath)}.`;
88
+ let entries;
89
+ try {
90
+ entries = await readdir(directory);
91
+ }
92
+ catch {
93
+ return;
94
+ }
95
+ await Promise.all(entries
96
+ .filter((entry) => entry.startsWith(prefix) && entry.endsWith('.tmp'))
97
+ .map((entry) => rm(path.join(directory, entry), { force: true }).catch(() => { })));
98
+ }
99
+ const processStarts = new Map();
100
+ /** OS process birth identity distinguishes a live owner from a reused PID. */
101
+ function getRuntimeProcessStart(pid) {
102
+ if (!Number.isInteger(pid) || pid <= 0) {
103
+ return null;
104
+ }
105
+ const cached = processStarts.get(pid);
106
+ if (pid === process.pid && cached) {
107
+ return cached;
108
+ }
109
+ let value = null;
110
+ try {
111
+ if (process.platform === 'linux') {
112
+ const stat = readFileSync(`/proc/${pid}/stat`, 'utf8');
113
+ const boot = readFileSync('/proc/sys/kernel/random/boot_id', 'utf8').trim();
114
+ value = `${boot}:${stat.slice(stat.lastIndexOf(')') + 2).split(' ')[19]}`;
115
+ }
116
+ else if (process.platform === 'win32') {
117
+ value =
118
+ execFileSync('powershell.exe', [
119
+ '-NoProfile',
120
+ '-NonInteractive',
121
+ '-Command',
122
+ `(Get-Process -Id ${pid} -ErrorAction Stop).StartTime.ToUniversalTime().Ticks`,
123
+ ], {
124
+ encoding: 'utf8',
125
+ timeout: 1500,
126
+ stdio: ['ignore', 'pipe', 'ignore'],
127
+ }).trim() || null;
128
+ }
129
+ else {
130
+ value =
131
+ execFileSync('ps', ['-p', String(pid), '-o', 'lstart='], {
132
+ encoding: 'utf8',
133
+ timeout: 1500,
134
+ env: { ...process.env, LC_ALL: 'C', TZ: 'UTC' },
135
+ stdio: ['ignore', 'pipe', 'ignore'],
136
+ }).trim() || null;
137
+ }
138
+ }
139
+ catch { }
140
+ // A transient Windows/ps failure must remain retryable. Only a positive
141
+ // identity is stable enough to cache for the lifetime of this process.
142
+ if (pid === process.pid && value != null) {
143
+ processStarts.set(pid, value);
144
+ }
145
+ return value;
146
+ }
147
+ const liveLockOwners = new Map();
148
+ function ownerIsDead(owner) {
149
+ if (!isRuntimeProcessAlive(owner.pid)) {
150
+ return true;
151
+ }
152
+ if (owner.processStart) {
153
+ const key = `${owner.pid}:${owner.processStart}:${owner.lockId ?? 'legacy'}`;
154
+ if ((liveLockOwners.get(key) ?? 0) > Date.now()) {
155
+ return false;
156
+ }
157
+ const current = getRuntimeProcessStart(owner.pid);
158
+ if (current != null && current !== owner.processStart) {
159
+ return true;
160
+ }
161
+ // Especially on Windows, avoid a synchronous OS query on every 25ms
162
+ // contention poll. PID death is still checked immediately above; cached
163
+ // liveness only delays reclamation and can never steal a live lock.
164
+ if (liveLockOwners.size >= 128) {
165
+ liveLockOwners.clear();
166
+ }
167
+ liveLockOwners.set(key, Date.now() + 1000);
168
+ }
169
+ return false;
170
+ }
171
+ async function reclaimFileLock(lockPath) {
172
+ let entries;
173
+ try {
174
+ entries = await readdir(lockPath);
175
+ }
176
+ catch {
177
+ return;
178
+ }
179
+ if (entries.length === 1 &&
180
+ (entries[0] === 'owner.json' ||
181
+ /^owner-[a-f0-9-]+\.json$/u.test(entries[0]))) {
182
+ const ownerPath = path.join(lockPath, entries[0]);
183
+ const owner = await readRuntimeJson(ownerPath);
184
+ if (!owner ||
185
+ !Number.isInteger(owner.pid) ||
186
+ owner.pid <= 0 ||
187
+ !ownerIsDead(owner)) {
188
+ return;
189
+ }
190
+ // A successor has a different filename. A delayed reclaimer cannot remove
191
+ // its owner file, and rmdir cannot remove a populated successor directory.
192
+ await unlink(ownerPath).catch(() => { });
193
+ }
194
+ else if (entries.length !== 0) {
195
+ return;
196
+ }
197
+ await rmdir(lockPath).catch(() => { });
198
+ }
199
+ function newLockOwner() {
200
+ return {
201
+ acquiredAt: Date.now(),
202
+ pid: process.pid,
203
+ lockId: randomUUID(),
204
+ processStart: getRuntimeProcessStart(process.pid),
205
+ };
206
+ }
207
+ /** Atomic publication is also used by exit-time cleanup; never publish an empty lock. */
208
+ function tryRuntimeFileLockSync(filePath) {
209
+ const lockPath = getRuntimeFileLockPath(filePath);
210
+ const owner = newLockOwner();
211
+ const filename = `owner-${owner.lockId}.json`;
212
+ const prepared = `${lockPath}.${owner.lockId}.prepared`;
213
+ try {
214
+ if (existsSync(`${lockPath}.recovery`)) {
215
+ return null;
216
+ }
217
+ mkdirSync(path.dirname(lockPath), { recursive: true });
218
+ mkdirSync(prepared, { mode: 0o700 });
219
+ writeFileSync(path.join(prepared, filename), JSON.stringify(owner), {
220
+ mode: 0o600,
221
+ });
222
+ renameSync(prepared, lockPath);
223
+ return () => {
224
+ try {
225
+ unlinkSync(path.join(lockPath, filename));
226
+ }
227
+ catch { }
228
+ try {
229
+ rmdirSync(lockPath);
230
+ }
231
+ catch { }
232
+ };
233
+ }
234
+ catch {
235
+ return null;
236
+ }
237
+ finally {
238
+ rmSync(prepared, { recursive: true, force: true });
239
+ }
240
+ }
241
+ async function acquireRuntimeFileLock(filePath) {
242
+ const lockPath = getRuntimeFileLockPath(filePath);
243
+ const deadline = Date.now() + LOCK_TIMEOUT_MS;
244
+ await mkdir(path.dirname(lockPath), { recursive: true });
245
+ const owner = newLockOwner();
246
+ const filename = `owner-${owner.lockId}.json`;
247
+ const prepared = await mkdtemp(`${lockPath}.prepared-`);
248
+ try {
249
+ await writeFile(path.join(prepared, filename), JSON.stringify(owner), {
250
+ mode: 0o600,
251
+ });
252
+ while (true) {
253
+ // Respect a live recovery guard left by an older CLI. New writers do not
254
+ // need a recovery guard, so its own crash cannot create another lock layer.
255
+ await reclaimFileLock(`${lockPath}.recovery`);
256
+ let recoveryExists = false;
257
+ try {
258
+ await readdir(`${lockPath}.recovery`);
259
+ recoveryExists = true;
260
+ }
261
+ catch { }
262
+ try {
263
+ if (recoveryExists) {
264
+ throw Object.assign(new Error('Legacy recovery in progress'), {
265
+ code: 'EEXIST',
266
+ });
267
+ }
268
+ await rename(prepared, lockPath);
269
+ await removeOrphanedTempFiles(filePath);
270
+ return async () => {
271
+ await unlink(path.join(lockPath, filename)).catch(() => { });
272
+ await rmdir(lockPath).catch(() => { });
273
+ };
274
+ }
275
+ catch (error) {
276
+ if (!['EEXIST', 'ENOTEMPTY', 'EPERM', 'EACCES'].includes(error.code ?? '')) {
277
+ throw error;
278
+ }
279
+ }
280
+ if (!recoveryExists) {
281
+ await reclaimFileLock(lockPath);
282
+ }
283
+ if (Date.now() >= deadline) {
284
+ throw new Error(`Timed out acquiring runtime state lock ${lockPath}. Inspect its owner and stop the owning process before removing an unreadable legacy lock or recovery guard.`);
285
+ }
286
+ await new Promise((resolve) => setTimeout(resolve, 25));
287
+ }
288
+ }
289
+ finally {
290
+ await rm(prepared, { recursive: true, force: true });
291
+ }
292
+ }
293
+ async function withRuntimeFileLock(filePath, operation) {
294
+ const previous = mutationQueues.get(filePath) ?? Promise.resolve();
295
+ const next = previous
296
+ .catch(() => { })
297
+ .then(async () => {
298
+ const release = await acquireRuntimeFileLock(filePath);
299
+ try {
300
+ return await operation();
301
+ }
302
+ finally {
303
+ await release().catch(() => { });
304
+ }
305
+ });
306
+ mutationQueues.set(filePath, next);
307
+ try {
308
+ return await next;
309
+ }
310
+ finally {
311
+ if (mutationQueues.get(filePath) === next) {
312
+ mutationQueues.delete(filePath);
313
+ }
314
+ }
315
+ }
316
+
317
+ export { getRuntimeFileLockPath, getRuntimeFilePath, getRuntimeProcessStart, isRuntimeProcessAlive, normalizeWorkspaceRoot, readRuntimeJson, removeRuntimeFile, tryRuntimeFileLockSync, withRuntimeFileLock, writeRuntimeJson };
318
+ //# sourceMappingURL=runtime-files.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime-files.js","sources":["../src/runtime-files.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
@@ -0,0 +1,50 @@
1
+ /**
2
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
3
+ *
4
+ * This source code is licensed under the MIT license found in the
5
+ * LICENSE file in the root directory of this source tree.
6
+ */
7
+ export interface RuntimeOwnerIdentity {
8
+ sessionId: string;
9
+ workspaceRoot: string;
10
+ pid: number;
11
+ endpoint: string;
12
+ processStart?: string | null;
13
+ }
14
+ export interface RuntimeOwnerLease {
15
+ identity: RuntimeOwnerIdentity;
16
+ release(): Promise<void>;
17
+ }
18
+ export type RuntimeOwnerErrorCode = 'runtime_owner_conflict' | 'runtime_owner_identity_unavailable' | 'runtime_owner_unverified' | 'runtime_owner_shutdown_failed';
19
+ export declare class RuntimeOwnerError extends Error {
20
+ readonly owner: RuntimeOwnerIdentity | null;
21
+ readonly code: RuntimeOwnerErrorCode;
22
+ constructor(message: string, owner: RuntimeOwnerIdentity | null, code?: RuntimeOwnerErrorCode);
23
+ }
24
+ export declare function runtimeOwnerEndpoint(workspaceRoot: string): string;
25
+ /** Read-only, bounded liveness check. Never unlinks or claims an endpoint. */
26
+ export declare function probeRuntimeOwner(endpoint: string): Promise<RuntimeOwnerIdentity | null>;
27
+ export type RuntimeOwnerObservation = {
28
+ state: 'live';
29
+ owner: RuntimeOwnerIdentity;
30
+ } | {
31
+ state: 'absent';
32
+ } | {
33
+ state: 'unknown';
34
+ reason: string;
35
+ };
36
+ /** A timeout is uncertainty; only ENOENT/ECONNREFUSED proves absence. */
37
+ export declare function inspectRuntimeOwner(endpoint: string): Promise<RuntimeOwnerObservation>;
38
+ /**
39
+ * The kernel-held IPC listener owns the workspace, not a JSON timestamp or
40
+ * PID. Serialize bind + stale unlink under a short state-file lock so two
41
+ * recovery attempts cannot unlink one another's live listener. Uncertain
42
+ * state fails closed; this function never terminates another process.
43
+ */
44
+ export declare function acquireRuntimeOwner(workspaceRoot: string, sessionId: string): Promise<RuntimeOwnerLease>;
45
+ /** Stop only the runtime whose live endpoint was positively verified. */
46
+ export declare function stopRuntimeOwner(owner: RuntimeOwnerIdentity, requestShutdown: () => Promise<boolean>, timing?: {
47
+ graceMs?: number;
48
+ signalMs?: number;
49
+ }): Promise<void>;
50
+ //# sourceMappingURL=runtime-owner.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime-owner.d.ts","sourceRoot":"","sources":["../src/runtime-owner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AACD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AACD,MAAM,MAAM,qBAAqB,GAC7B,wBAAwB,GACxB,oCAAoC,GACpC,0BAA0B,GAC1B,+BAA+B,CAAC;AACpC,qBAAa,iBAAkB,SAAQ,KAAK;IAGxC,QAAQ,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI;IAC3C,QAAQ,CAAC,IAAI,EAAE,qBAAqB;gBAFpC,OAAO,EAAE,MAAM,EACN,KAAK,EAAE,oBAAoB,GAAG,IAAI,EAClC,IAAI,GAAE,qBAAgD;CAKlE;AAuBD,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CASlE;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAItC;AAED,MAAM,MAAM,uBAAuB,GAC/B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,oBAAoB,CAAA;CAAE,GAC9C;IAAE,KAAK,EAAE,QAAQ,CAAA;CAAE,GACnB;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,yEAAyE;AACzE,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,uBAAuB,CAAC,CA8ClC;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,CAAC,CA4H5B;AAQD,yEAAyE;AACzE,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,oBAAoB,EAC3B,eAAe,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EACvC,MAAM,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GACnD,OAAO,CAAC,IAAI,CAAC,CA4Ff"}