@relayfile/sdk 0.10.37 → 0.10.39

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export { RelayFileClient, DEFAULT_RELAYFILE_BASE_URL, type AccessTokenProvider,
 export type { RelayFileReadCacheOptions } from "./types.js";
 export { RelayfileSetup, RELAYFILE_SDK_VERSION, WorkspaceHandle } from "./setup.js";
 export { type RelayfileCloudLoginOptions, type RelayfileCloudTokenSet, type RelayfileCloudTokenSetupOptions } from "./cloud-login.js";
-export { CloudAbortError, CloudApiError, CloudTimeoutError, InvalidLocalDirError, InvalidMountModeError, InvalidRemotePathError, IntegrationConnectionTimeoutError, MalformedCloudResponseError, MissingConnectionIdError, MountModeUnavailableError, MountReadyTimeoutError, MountSessionInputError, ProviderNotConnectedError, ProviderNotReadyError, RelayfileSetupError, UnknownProviderError } from "./setup-errors.js";
+export { CloudAbortError, CloudApiError, CloudTimeoutError, InvalidLocalDirError, InvalidMountModeError, InvalidRemotePathError, IntegrationConnectionTimeoutError, MalformedCloudResponseError, MissingConnectionIdError, MountModeUnavailableError, MountMultiPathUnsupportedError, MountReadyTimeoutError, MountSessionInputError, ProviderNotConnectedError, ProviderNotReadyError, RelayfileSetupError, UnknownProviderError } from "./setup-errors.js";
 export { type EnsureMountedWorkspaceInput, WORKSPACE_INTEGRATION_PROVIDERS, type AgentWorkspaceInvite, type AgentWorkspaceInviteOptions, type AgentWorkspaceScopedInviteOptions, type ConnectIntegrationOptions, type ConnectIntegrationResult, type CreateWorkspaceOptions, type JoinWorkspaceOptions, type MountLauncher, type MountLauncherEvent, type MountLauncherInstance, type MountLauncherStart, type MountLocalLayout, type MountMode, type MountSessionRequest, type MountSessionResponse, type MountSessionResult, type MountSyncMode, type MountSupervisorEvent, type MountedWorkspaceHandle, type MountedWorkspaceStatus, type MountWorkspaceInput, type ReadMountedWorkspaceStatusInput, type RelayfileSetupOptions, type RelayfileSetupRetryOptions, type WaitForConnectionOptions, type WorkspaceInfo, type WorkspaceIntegrationProvider, type WorkspaceMountEnv, type WorkspaceMountEnvOptions, type WorkspacePermissions } from "./setup-types.js";
 export { RelayFileSync, type RelayFileSyncOptions, type RelayFileSyncPong, type RelayFileSyncReconnectOptions, type RelayFileSyncSocket, type RelayFileSyncStart, type RelayFileSyncState, type RelayFileSyncTokenProvider } from "./sync.js";
 export { onWrite, pathMatches, type OnWriteClient, type OnWriteHandler, type OnWriteHandlerError, type OnWriteOptions } from "./onWrite.js";

package/dist/index.js

@@ -1,6 +1,6 @@
 export { RelayFileClient, DEFAULT_RELAYFILE_BASE_URL } from "./client.js";
 export { RelayfileSetup, RELAYFILE_SDK_VERSION, WorkspaceHandle } from "./setup.js";
-export { CloudAbortError, CloudApiError, CloudTimeoutError, InvalidLocalDirError, InvalidMountModeError, InvalidRemotePathError, IntegrationConnectionTimeoutError, MalformedCloudResponseError, MissingConnectionIdError, MountModeUnavailableError, MountReadyTimeoutError, MountSessionInputError, ProviderNotConnectedError, ProviderNotReadyError, RelayfileSetupError, UnknownProviderError } from "./setup-errors.js";
+export { CloudAbortError, CloudApiError, CloudTimeoutError, InvalidLocalDirError, InvalidMountModeError, InvalidRemotePathError, IntegrationConnectionTimeoutError, MalformedCloudResponseError, MissingConnectionIdError, MountModeUnavailableError, MountMultiPathUnsupportedError, MountReadyTimeoutError, MountSessionInputError, ProviderNotConnectedError, ProviderNotReadyError, RelayfileSetupError, UnknownProviderError } from "./setup-errors.js";
 export { WORKSPACE_INTEGRATION_PROVIDERS } from "./setup-types.js";
 export { RelayFileSync } from "./sync.js";
 export { onWrite, pathMatches } from "./onWrite.js";

package/dist/mount-launcher.js

@@ -5,7 +5,8 @@ import path from "node:path";
 import process from "node:process";
 import { RelayFileClient } from "./client.js";
 import { getRelayfileMountBinaryPath } from "./mount-path.js";
-import { CloudAbortError, MountModeUnavailableError, MountReadyTimeoutError, RelayfileSetupError } from "./setup-errors.js";
+import { assertExactMountLayout } from "./mount-layout-guard.js";
+import { CloudAbortError, MountModeUnavailableError, MountMultiPathUnsupportedError, MountReadyTimeoutError, RelayfileSetupError } from "./setup-errors.js";
 const DEFAULT_READY_POLL_INTERVAL_MS = 250;
 const DEFAULT_STOP_TIMEOUT_MS = 10_000;
 const LOG_ROTATION_MAX_BYTES = 10 * 1024 * 1024;
@@ -45,8 +46,16 @@ export async function readMountedWorkspaceStatus(input) {
     };
 }
 async function startRelayfileMount(input, options) {
-    const localDir = path.resolve(input.env.RELAYFILE_LOCAL_DIR ?? process.cwd());
-    const mountLocalDir = resolveMountLocalDir(localDir, input.env.RELAYFILE_REMOTE_PATH, input.env.RELAYFILE_MOUNT_LOCAL_LAYOUT);
+    const effectiveEnv = {
+        ...process.env,
+        ...input.env
+    };
+    assertExactMountLayout(effectiveEnv);
+    if ((effectiveEnv.RELAYFILE_MOUNT_PATHS_FILE ?? "").trim() !== "") {
+        throw new MountMultiPathUnsupportedError();
+    }
+    const localDir = path.resolve(effectiveEnv.RELAYFILE_LOCAL_DIR ?? process.cwd());
+    const mountLocalDir = resolveMountLocalDir(localDir, effectiveEnv.RELAYFILE_REMOTE_PATH, effectiveEnv.RELAYFILE_MOUNT_LOCAL_LAYOUT);
     const relayDir = path.join(mountLocalDir, ".relay");
     const logPath = path.join(relayDir, "mount.log");
     const pidPath = path.join(relayDir, "mount.pid");
@@ -56,10 +65,7 @@ async function startRelayfileMount(input, options) {
     const args = input.background === false ? ["--once"] : [];
     const child = (options.spawnImpl ?? spawn)(command, args, {
         cwd: input.cwd ?? mountLocalDir,
-        env: {
-            ...process.env,
-            ...input.env
-        },
+        env: effectiveEnv,
         stdio: ["ignore", "pipe", "pipe"]
     });
     const outputBuffer = [];

package/dist/mount-layout-guard.d.ts

@@ -0,0 +1,2 @@
+/** Refuse scoped runtime state until all operator surfaces can enumerate it. */
+export declare function assertExactMountLayout(env: Record<string, string | undefined>): void;

package/dist/mount-layout-guard.js

@@ -0,0 +1,8 @@
+import { MountSessionInputError } from "./setup-errors.js";
+/** Refuse scoped runtime state until all operator surfaces can enumerate it. */
+export function assertExactMountLayout(env) {
+    if ((env.RELAYFILE_MOUNT_LOCAL_LAYOUT ?? "").trim().toLowerCase() !== "scoped") {
+        return;
+    }
+    throw new MountSessionInputError("The TypeScript mount launcher does not support RELAYFILE_MOUNT_LOCAL_LAYOUT=scoped until scoped operator surfaces are ready; use RELAYFILE_MOUNT_LOCAL_LAYOUT=exact.");
+}

package/dist/setup-errors.d.ts

@@ -45,6 +45,9 @@ export declare class MissingConnectionIdError extends RelayfileSetupError {
 export declare class MountSessionInputError extends RelayfileSetupError {
     constructor(message: string);
 }
+export declare class MountMultiPathUnsupportedError extends RelayfileSetupError {
+    constructor();
+}
 export declare class InvalidMountModeError extends RelayfileSetupError {
     readonly mode: string;
     constructor(mode: string);

package/dist/setup-errors.js

@@ -74,6 +74,11 @@ export class MountSessionInputError extends RelayfileSetupError {
         super(message, "mount_session_input_error");
     }
 }
+export class MountMultiPathUnsupportedError extends RelayfileSetupError {
+    constructor() {
+        super("The TypeScript mount launcher detected RELAYFILE_MOUNT_PATHS_FILE but supports only one remotePath; use the relayfile CLI for multi-path mounts until the TypeScript session and status types support multiple roots.", "mount_multi_path_unsupported");
+    }
+}
 export class InvalidMountModeError extends RelayfileSetupError {
     mode;
     constructor(mode) {

package/dist/workspace-mount.js

@@ -6,6 +6,7 @@ import https from 'node:https';
 import { createRequire } from 'node:module';
 import os from 'node:os';
 import path from 'node:path';
+import { assertExactMountLayout } from './mount-layout-guard.js';
 const require = createRequire(import.meta.url);
 const RELAYFILE_VERSION = String(require('../package.json').version);
 const RELEASE_BASE_URL = 'https://github.com/AgentWorkforce/relayfile/releases/download';
@@ -279,6 +280,7 @@ async function stopMountProcess(processRef) {
     });
 }
 export async function ensureRelayfileMount(config) {
+    assertExactMountLayout(process.env);
     const binaryPath = await ensureRelayfileMountBinary(config.binaryPath);
     if (!existsSync(binaryPath)) {
         throw new Error(`missing relayfile mount binary: ${binaryPath}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relayfile/sdk",
-  "version": "0.10.37",
+  "version": "0.10.39",
   "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.37",
+    "@relayfile/core": "0.10.39",
     "ignore": "^7.0.5",
     "tar": "^7.5.10"
   },
   "optionalDependencies": {
-    "@relayfile/mount-darwin-arm64": "0.10.37",
-    "@relayfile/mount-darwin-x64": "0.10.37",
-    "@relayfile/mount-linux-arm64": "0.10.37",
-    "@relayfile/mount-linux-x64": "0.10.37"
+    "@relayfile/mount-darwin-arm64": "0.10.39",
+    "@relayfile/mount-darwin-x64": "0.10.39",
+    "@relayfile/mount-linux-arm64": "0.10.39",
+    "@relayfile/mount-linux-x64": "0.10.39"
   },
   "devDependencies": {
     "typescript": "^5.7.3",