@relayfile/sdk 0.10.56 → 0.10.57

package/dist/mount-launcher.js

@@ -14,6 +14,9 @@ const LOG_ROTATION_FILES = 3;
 const DEFAULT_CHECKPOINT_TIMEOUT_MS = 30_000;
 const MAX_CHECKPOINT_OUTPUT_BYTES = 1024 * 1024;
 const FUSE_UNAVAILABLE_SIGNATURE = "fuse mode is not available in this build";
+// relayfile-mount uses EX_TEMPFAIL only for the typed, resumable --once
+// bootstrap outcome. All other nonzero exits remain fatal.
+const INITIAL_BOOTSTRAP_INCOMPLETE_EXIT_CODE = 75;
 export const defaultMountLauncher = createDefaultMountLauncher();
 export function createDefaultMountLauncher(options = {}) {
     return {
@@ -92,7 +95,6 @@ async function startRelayfileMount(input, options) {
     });
 }
 class RelayfileMountProcessInstance {
-    pid;
     ready;
     child;
     logStream;
@@ -107,6 +109,7 @@ class RelayfileMountProcessInstance {
     cwd;
     spawnImpl;
     exited = false;
+    exitCode = null;
     stopping;
     readyResolved = false;
     checkpointPromise;
@@ -124,14 +127,14 @@ class RelayfileMountProcessInstance {
         this.effectiveEnv = input.effectiveEnv;
         this.cwd = input.cwd;
         this.spawnImpl = input.spawnImpl;
-        this.pid = input.child.pid ?? undefined;
         this.now = input.now;
         this.readyPollIntervalMs = input.readyPollIntervalMs;
-        this.child.once("exit", () => {
-            this.exited = true;
-        });
+        this.attachExitListener(input.child);
         this.ready = this.waitForReady();
     }
+    get pid() {
+        return this.child.pid ?? undefined;
+    }
     async status() {
         const status = await readMountedWorkspaceStatus({
             localDir: this.localDir,
@@ -146,7 +149,13 @@ class RelayfileMountProcessInstance {
             suggestedRefreshAt: null,
             pid: this.pid
         });
-        return this.exited ? { ...status, ready: false } : status;
+        // A foreground --once child is expected to exit after publishing its
+        // final state. Preserve that ready state; daemon exits still make an
+        // otherwise-stale state unready.
+        return this.exited &&
+            (this.input.background !== false || this.exitCode !== 0)
+            ? { ...status, ready: false }
+            : status;
     }
     async stop() {
         if (!this.stopping) {
@@ -203,14 +212,43 @@ class RelayfileMountProcessInstance {
                 throw new CloudAbortError("mountWorkspace");
             }
             const status = await this.status();
-            if (status.ready) {
+            // Foreground --once is authoritative only after the child exits 0. A
+            // prior run may have left a fresh-looking public state file behind, so
+            // accepting it while this attempt is still running (or after exit 75)
+            // would skip the resumable checkpoint retry contract.
+            if (!this.stopping &&
+                status.ready &&
+                (this.input.background !== false || (this.exited && this.exitCode === 0))) {
                 this.readyResolved = true;
                 return;
             }
             if (this.isFuseUnavailable()) {
                 throw new MountModeUnavailableError("fuse");
             }
+            // A typed foreground yield is retryable only inside the caller's
+            // readiness budget. Once that budget is exhausted, report the public
+            // timeout contract and run normal shutdown cleanup instead of falling
+            // through to the generic early-exit error.
+            if (!this.stopping &&
+                this.isResumableOnceExit() &&
+                this.now() >= timeoutAt) {
+                const error = new MountReadyTimeoutError(this.localDir, this.input.readyTimeoutMs);
+                await this.stop();
+                throw error;
+            }
             if (this.exited) {
+                if (this.isResumableOnceExit() &&
+                    !this.stopping &&
+                    this.now() < timeoutAt) {
+                    await delay(this.readyPollIntervalMs);
+                    if (this.stopping ||
+                        this.input.signal?.aborted ||
+                        this.now() >= timeoutAt) {
+                        continue;
+                    }
+                    await this.restartOnceMount();
+                    continue;
+                }
                 throw this.buildEarlyExitError();
             }
             if (this.now() >= timeoutAt) {
@@ -231,6 +269,39 @@ class RelayfileMountProcessInstance {
         return (normalizeMountMode(this.input.env.RELAYFILE_MOUNT_MODE) === "fuse" &&
             this.outputBuffer.join("").includes(FUSE_UNAVAILABLE_SIGNATURE));
     }
+    isResumableOnceExit() {
+        return (this.input.background === false &&
+            this.exitCode === INITIAL_BOOTSTRAP_INCOMPLETE_EXIT_CODE);
+    }
+    async restartOnceMount() {
+        const child = this.spawnImpl(this.command, ["--once"], {
+            cwd: this.cwd,
+            env: this.effectiveEnv,
+            stdio: ["ignore", "pipe", "pipe"]
+        });
+        pipeChildOutput(child, this.logStream, this.outputBuffer, this.input);
+        this.child = child;
+        this.exited = child.exitCode !== null;
+        this.exitCode = child.exitCode;
+        this.attachExitListener(child);
+        if (typeof child.pid === "number" && child.pid > 0) {
+            await writeAtomicFile(this.pidPath, `${child.pid}\n`);
+        }
+    }
+    attachExitListener(child) {
+        if (child.exitCode !== null) {
+            this.exited = true;
+            this.exitCode = child.exitCode;
+        }
+        child.once("exit", (code) => {
+            // A late event from a previous resumable attempt must not mark its
+            // replacement as exited.
+            if (this.child !== child)
+                return;
+            this.exited = true;
+            this.exitCode = code;
+        });
+    }
     async performStop() {
         if (!this.exited && typeof this.child.pid === "number") {
             this.child.kill("SIGTERM");

package/dist/sync.js

@@ -743,7 +743,7 @@ export class RelayFileSync {
         this.emitFilesystemEvent(normalized);
     }
     emitFilesystemEvent(event) {
-        if (!pathMatchesAnyFilter(this.paths, event.path)) {
+        if (event.type !== "sync.reconcile" && !pathMatchesAnyFilter(this.paths, event.path)) {
             return;
         }
         this.emit("event", event);

package/dist/types.d.ts

@@ -284,7 +284,7 @@ export interface WriteQueuedResponse {
         state?: WritebackState;
     };
 }
-export type FilesystemEventType = "file.created" | "file.updated" | "file.deleted" | "dir.created" | "dir.deleted" | "sync.error" | "sync.ignored" | "sync.suppressed" | "sync.stale" | "writeback.failed" | "writeback.succeeded";
+export type FilesystemEventType = "file.created" | "file.updated" | "file.deleted" | "dir.created" | "dir.deleted" | "sync.error" | "sync.ignored" | "sync.suppressed" | "sync.stale" | "sync.reconcile" | "writeback.failed" | "writeback.succeeded";
 export type EventOrigin = "provider_sync" | "agent_write" | "system";
 export interface FilesystemEvent {
     eventId: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relayfile/sdk",
-  "version": "0.10.56",
+  "version": "0.10.57",
   "description": "TypeScript SDK for relayfile — real-time filesystem for humans and agents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -59,15 +59,15 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@relayfile/core": "0.10.56",
+    "@relayfile/core": "0.10.57",
     "ignore": "^7.0.5",
     "tar": "^7.5.10"
   },
   "optionalDependencies": {
-    "@relayfile/mount-darwin-arm64": "0.10.56",
-    "@relayfile/mount-darwin-x64": "0.10.56",
-    "@relayfile/mount-linux-arm64": "0.10.56",
-    "@relayfile/mount-linux-x64": "0.10.56"
+    "@relayfile/mount-darwin-arm64": "0.10.57",
+    "@relayfile/mount-darwin-x64": "0.10.57",
+    "@relayfile/mount-linux-arm64": "0.10.57",
+    "@relayfile/mount-linux-x64": "0.10.57"
   },
   "devDependencies": {
     "typescript": "^5.7.3",