@relayfile/sdk 0.7.23 → 0.7.25

package/README.md

@@ -15,7 +15,7 @@ The recommended way to use `@relayfile/sdk` in an agent workflow is through
 environment variable generation for `relayfile-mount`, and agent invites.
 
 ```ts
-import { RelayfileSetup } from '@relayfile/sdk'
+import { RelayfileSetup } from '@relayfile/sdk/cli'
 
 const setup = await RelayfileSetup.login({
   onLoginUrl: (url) => console.log(`Sign in to Relayfile Cloud: ${url}`),
@@ -72,6 +72,12 @@ advanced hosts that already provide a valid Cloud bearer token. After Cloud auth
 complete the Notion OAuth flow as described in
 [`docs/agent-workspace-golden-path.md`](../../../docs/agent-workspace-golden-path.md).
 
+The default `@relayfile/sdk` entry point is safe for Worker-style bundles and
+does not statically import the CLI-only mount launcher or local browser login
+helpers. Import interactive login and local mount launcher utilities from
+`@relayfile/sdk/cli`, `@relayfile/sdk/cloud-login`, or
+`@relayfile/sdk/mount-launcher`.
+
 ---
 
 ## Low-Level Client Example

package/dist/cli/index.d.ts

@@ -0,0 +1,6 @@
+export * from "../index.js";
+export { RelayfileSetup } from "./setup.js";
+export { createDefaultMountLauncher, defaultMountLauncher, readMountedWorkspaceStatus } from "../mount-launcher.js";
+export { runRelayfileCloudLogin, type RelayfileCloudLoginOptions, type RelayfileCloudTokenSet, type RelayfileCloudTokenSetupOptions } from "../cloud-login.js";
+export { createRelayfileCloudAccessTokenProvider } from "../cloud-token-provider.js";
+export type { MountLauncher, MountLauncherEvent, MountLauncherInstance, MountLauncherStart, MountedWorkspaceStatus, ReadMountedWorkspaceStatusInput } from "../setup-types.js";

package/dist/cli/index.js

@@ -0,0 +1,5 @@
+export * from "../index.js";
+export { RelayfileSetup } from "./setup.js";
+export { createDefaultMountLauncher, defaultMountLauncher, readMountedWorkspaceStatus } from "../mount-launcher.js";
+export { runRelayfileCloudLogin } from "../cloud-login.js";
+export { createRelayfileCloudAccessTokenProvider } from "../cloud-token-provider.js";

package/dist/cli/setup.d.ts

@@ -0,0 +1,9 @@
+import { type RelayfileCloudLoginOptions, type RelayfileCloudTokenSet, type RelayfileCloudTokenSetupOptions } from "../cloud-login.js";
+import { RelayfileSetup as BaseRelayfileSetup } from "../setup.js";
+import type { MountLauncher, MountedWorkspaceStatus, ReadMountedWorkspaceStatusInput } from "../setup-types.js";
+export declare class RelayfileSetup extends BaseRelayfileSetup {
+    static login(options?: RelayfileCloudLoginOptions): Promise<RelayfileSetup>;
+    static fromCloudTokens(tokens: RelayfileCloudTokenSet, options?: RelayfileCloudTokenSetupOptions): RelayfileSetup;
+    protected getDefaultMountLauncher(): MountLauncher;
+    protected readMountedWorkspaceStatus(input: ReadMountedWorkspaceStatusInput): Promise<MountedWorkspaceStatus>;
+}

package/dist/cli/setup.js

@@ -0,0 +1,39 @@
+import { createRelayfileCloudAccessTokenProvider } from "../cloud-token-provider.js";
+import { runRelayfileCloudLogin } from "../cloud-login.js";
+import { defaultMountLauncher, readMountedWorkspaceStatus } from "../mount-launcher.js";
+import { RelayfileSetup as BaseRelayfileSetup } from "../setup.js";
+const DEFAULT_CLOUD_API_URL = "https://agentrelay.com/cloud";
+export class RelayfileSetup extends BaseRelayfileSetup {
+    static async login(options = {}) {
+        const cloudApiUrl = options.cloudApiUrl ?? DEFAULT_CLOUD_API_URL;
+        const tokens = await runRelayfileCloudLogin({
+            ...options,
+            cloudApiUrl
+        });
+        await options.onTokens?.({ ...tokens });
+        return RelayfileSetup.fromCloudTokens(tokens, {
+            ...options,
+            cloudApiUrl: tokens.apiUrl ?? cloudApiUrl
+        });
+    }
+    static fromCloudTokens(tokens, options = {}) {
+        const cloudApiUrl = options.cloudApiUrl ?? tokens.apiUrl ?? DEFAULT_CLOUD_API_URL;
+        return new RelayfileSetup({
+            ...options,
+            cloudApiUrl,
+            accessToken: createRelayfileCloudAccessTokenProvider({
+                ...tokens,
+                apiUrl: tokens.apiUrl ?? cloudApiUrl
+            }, {
+                ...options,
+                cloudApiUrl
+            })
+        });
+    }
+    getDefaultMountLauncher() {
+        return defaultMountLauncher;
+    }
+    readMountedWorkspaceStatus(input) {
+        return readMountedWorkspaceStatus(input);
+    }
+}

package/dist/cloud-login.d.ts

@@ -1,17 +1,6 @@
-import type { AccessTokenProvider } from "./client.js";
-import type { RelayfileSetupOptions } from "./setup-types.js";
-export interface RelayfileCloudTokenSet {
-    apiUrl?: string;
-    accessToken: string;
-    refreshToken: string;
-    accessTokenExpiresAt: string;
-    refreshTokenExpiresAt?: string;
-}
-export interface RelayfileCloudTokenSetupOptions extends Omit<RelayfileSetupOptions, "accessToken" | "cloudApiUrl"> {
-    cloudApiUrl?: string;
-    refreshWindowMs?: number;
-    onTokens?: (tokens: RelayfileCloudTokenSet) => void | Promise<void>;
-}
+import type { RelayfileCloudTokenSetupOptions, RelayfileCloudTokenSet } from "./cloud-token-provider.js";
+export type { RelayfileCloudTokenSetupOptions, RelayfileCloudTokenSet } from "./cloud-token-provider.js";
+export { createRelayfileCloudAccessTokenProvider } from "./cloud-token-provider.js";
 export interface RelayfileCloudLoginOptions extends RelayfileCloudTokenSetupOptions {
     redirectHost?: string;
     redirectPort?: number;
@@ -24,4 +13,3 @@ export interface RelayfileCloudLoginOptions extends RelayfileCloudTokenSetupOpti
     successMessage?: string;
 }
 export declare function runRelayfileCloudLogin(options?: RelayfileCloudLoginOptions): Promise<RelayfileCloudTokenSet>;
-export declare function createRelayfileCloudAccessTokenProvider(initialTokens: RelayfileCloudTokenSet, options?: RelayfileCloudTokenSetupOptions): AccessTokenProvider;

package/dist/cloud-login.js

@@ -1,11 +1,9 @@
-import { CloudAbortError, CloudApiError, CloudTimeoutError, MalformedCloudResponseError } from "./setup-errors.js";
-import { RELAYFILE_SDK_VERSION } from "./version.js";
+import { CloudAbortError, CloudTimeoutError, MalformedCloudResponseError } from "./setup-errors.js";
 const DEFAULT_CLOUD_API_URL = "https://agentrelay.com/cloud";
 const DEFAULT_LOGIN_TIMEOUT_MS = 5 * 60 * 1000;
 const DEFAULT_REDIRECT_HOST = "127.0.0.1";
 const DEFAULT_REDIRECT_PATH = "/callback";
-const DEFAULT_REQUEST_TIMEOUT_MS = 30_000;
-const DEFAULT_REFRESH_WINDOW_MS = 60_000;
+export { createRelayfileCloudAccessTokenProvider } from "./cloud-token-provider.js";
 export async function runRelayfileCloudLogin(options = {}) {
     const cloudApiUrl = normalizeNonEmptyString(options.cloudApiUrl) ?? DEFAULT_CLOUD_API_URL;
     const redirectHost = normalizeNonEmptyString(options.redirectHost) ?? DEFAULT_REDIRECT_HOST;
@@ -108,71 +106,6 @@ export async function runRelayfileCloudLogin(options = {}) {
         });
     });
 }
-export function createRelayfileCloudAccessTokenProvider(initialTokens, options = {}) {
-    const cloudApiUrl = normalizeNonEmptyString(options.cloudApiUrl) ??
-        normalizeNonEmptyString(initialTokens.apiUrl) ??
-        DEFAULT_CLOUD_API_URL;
-    const requestTimeoutMs = Math.max(1, Math.floor(options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS));
-    const refreshWindowMs = Math.max(0, Math.floor(options.refreshWindowMs ?? DEFAULT_REFRESH_WINDOW_MS));
-    let tokens = {
-        ...initialTokens,
-        apiUrl: normalizeNonEmptyString(initialTokens.apiUrl) ?? cloudApiUrl
-    };
-    let refreshPromise;
-    return async () => {
-        if (shouldRefresh(tokens, refreshWindowMs)) {
-            if (!refreshPromise) {
-                refreshPromise = refresh();
-            }
-            try {
-                await refreshPromise;
-            }
-            finally {
-                refreshPromise = undefined;
-            }
-        }
-        return tokens.accessToken;
-    };
-    async function refresh() {
-        const response = await fetchWithTimeout(buildCloudUrl(cloudApiUrl, "api/v1/auth/token/refresh").toString(), {
-            method: "POST",
-            headers: {
-                "Content-Type": "application/json",
-                "X-Relayfile-SDK-Version": RELAYFILE_SDK_VERSION
-            },
-            body: JSON.stringify({ refreshToken: tokens.refreshToken })
-        }, requestTimeoutMs);
-        const payload = await readResponseBody(response);
-        if (!response.ok) {
-            throw new CloudApiError(response.status, payload);
-        }
-        tokens = readTokenSetFromPayload(payload, cloudApiUrl);
-        await options.onTokens?.({ ...tokens });
-    }
-}
-function shouldRefresh(tokens, refreshWindowMs) {
-    const expiresAt = Date.parse(tokens.accessTokenExpiresAt);
-    if (Number.isNaN(expiresAt)) {
-        return true;
-    }
-    return expiresAt - Date.now() <= refreshWindowMs;
-}
-async function fetchWithTimeout(url, init, timeoutMs) {
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), timeoutMs);
-    try {
-        return await fetch(url, { ...init, signal: controller.signal });
-    }
-    catch (error) {
-        if (controller.signal.aborted) {
-            throw new CloudTimeoutError("refreshCloudAccessToken", timeoutMs);
-        }
-        throw error;
-    }
-    finally {
-        clearTimeout(timer);
-    }
-}
 function readTokenSetFromSearchParams(params, fallbackApiUrl) {
     return {
         apiUrl: normalizeNonEmptyString(params.get("api_url") ?? undefined) ?? fallbackApiUrl,
@@ -182,15 +115,6 @@ function readTokenSetFromSearchParams(params, fallbackApiUrl) {
         refreshTokenExpiresAt: normalizeNonEmptyString(params.get("refresh_token_expires_at") ?? undefined)
     };
 }
-function readTokenSetFromPayload(payload, fallbackApiUrl) {
-    return {
-        apiUrl: readOptionalStringField(payload, "apiUrl") ?? fallbackApiUrl,
-        accessToken: requireStringField(payload, "accessToken"),
-        refreshToken: requireStringField(payload, "refreshToken"),
-        accessTokenExpiresAt: requireStringField(payload, "accessTokenExpiresAt"),
-        refreshTokenExpiresAt: readOptionalStringField(payload, "refreshTokenExpiresAt")
-    };
-}
 function requireSearchParam(params, field) {
     const value = normalizeNonEmptyString(params.get(field) ?? undefined);
     if (!value) {
@@ -198,22 +122,6 @@ function requireSearchParam(params, field) {
     }
     return value;
 }
-async function readResponseBody(response) {
-    const text = await response.text();
-    if (text === "") {
-        return null;
-    }
-    const contentType = response.headers.get("content-type") ?? "";
-    if (contentType.includes("application/json")) {
-        try {
-            return JSON.parse(text);
-        }
-        catch {
-            return text;
-        }
-    }
-    return text;
-}
 function requireStringField(payload, field) {
     const value = readField(payload, field);
     if (typeof value !== "string" || value.trim() === "") {

package/dist/cloud-token-provider.d.ts

@@ -0,0 +1,15 @@
+import type { AccessTokenProvider } from "./client.js";
+import type { RelayfileSetupOptions } from "./setup-types.js";
+export interface RelayfileCloudTokenSet {
+    apiUrl?: string;
+    accessToken: string;
+    refreshToken: string;
+    accessTokenExpiresAt: string;
+    refreshTokenExpiresAt?: string;
+}
+export interface RelayfileCloudTokenSetupOptions extends Omit<RelayfileSetupOptions, "accessToken" | "cloudApiUrl"> {
+    cloudApiUrl?: string;
+    refreshWindowMs?: number;
+    onTokens?: (tokens: RelayfileCloudTokenSet) => void | Promise<void>;
+}
+export declare function createRelayfileCloudAccessTokenProvider(initialTokens: RelayfileCloudTokenSet, options?: RelayfileCloudTokenSetupOptions): AccessTokenProvider;

package/dist/cloud-token-provider.js

@@ -0,0 +1,129 @@
+import { CloudApiError, CloudTimeoutError, MalformedCloudResponseError } from "./setup-errors.js";
+import { RELAYFILE_SDK_VERSION } from "./version.js";
+const DEFAULT_CLOUD_API_URL = "https://agentrelay.com/cloud";
+const DEFAULT_REQUEST_TIMEOUT_MS = 30_000;
+const DEFAULT_REFRESH_WINDOW_MS = 60_000;
+export function createRelayfileCloudAccessTokenProvider(initialTokens, options = {}) {
+    const cloudApiUrl = normalizeNonEmptyString(options.cloudApiUrl) ??
+        normalizeNonEmptyString(initialTokens.apiUrl) ??
+        DEFAULT_CLOUD_API_URL;
+    const requestTimeoutMs = Math.max(1, Math.floor(options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS));
+    const refreshWindowMs = Math.max(0, Math.floor(options.refreshWindowMs ?? DEFAULT_REFRESH_WINDOW_MS));
+    let tokens = {
+        ...initialTokens,
+        apiUrl: normalizeNonEmptyString(initialTokens.apiUrl) ?? cloudApiUrl
+    };
+    let refreshPromise;
+    return async () => {
+        if (shouldRefresh(tokens, refreshWindowMs)) {
+            if (!refreshPromise) {
+                refreshPromise = refresh();
+            }
+            try {
+                await refreshPromise;
+            }
+            finally {
+                refreshPromise = undefined;
+            }
+        }
+        return tokens.accessToken;
+    };
+    async function refresh() {
+        const response = await fetchWithTimeout(buildCloudUrl(cloudApiUrl, "api/v1/auth/token/refresh").toString(), {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "X-Relayfile-SDK-Version": RELAYFILE_SDK_VERSION
+            },
+            body: JSON.stringify({ refreshToken: tokens.refreshToken })
+        }, requestTimeoutMs);
+        const payload = await readResponseBody(response);
+        if (!response.ok) {
+            throw new CloudApiError(response.status, payload);
+        }
+        tokens = readTokenSetFromPayload(payload, cloudApiUrl);
+        await options.onTokens?.({ ...tokens });
+    }
+}
+function shouldRefresh(tokens, refreshWindowMs) {
+    const expiresAt = Date.parse(tokens.accessTokenExpiresAt);
+    if (Number.isNaN(expiresAt)) {
+        return true;
+    }
+    return expiresAt - Date.now() <= refreshWindowMs;
+}
+async function fetchWithTimeout(url, init, timeoutMs) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        return await fetch(url, { ...init, signal: controller.signal });
+    }
+    catch (error) {
+        if (controller.signal.aborted) {
+            throw new CloudTimeoutError("refreshCloudAccessToken", timeoutMs);
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function readTokenSetFromPayload(payload, fallbackApiUrl) {
+    return {
+        apiUrl: readOptionalStringField(payload, "apiUrl") ?? fallbackApiUrl,
+        accessToken: requireStringField(payload, "accessToken"),
+        refreshToken: requireStringField(payload, "refreshToken"),
+        accessTokenExpiresAt: requireStringField(payload, "accessTokenExpiresAt"),
+        refreshTokenExpiresAt: readOptionalStringField(payload, "refreshTokenExpiresAt")
+    };
+}
+async function readResponseBody(response) {
+    const text = await response.text();
+    if (text === "") {
+        return null;
+    }
+    const contentType = response.headers.get("content-type") ?? "";
+    if (contentType.includes("application/json")) {
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            return text;
+        }
+    }
+    return text;
+}
+function requireStringField(payload, field) {
+    const value = readField(payload, field);
+    if (typeof value !== "string" || value.trim() === "") {
+        throw new MalformedCloudResponseError(field, payload);
+    }
+    return value;
+}
+function readOptionalStringField(payload, field) {
+    const value = readField(payload, field);
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value !== "string" || value.trim() === "") {
+        throw new MalformedCloudResponseError(field, payload);
+    }
+    return value;
+}
+function readField(payload, field) {
+    if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
+        return undefined;
+    }
+    return payload[field];
+}
+function buildCloudUrl(baseUrl, path) {
+    const base = new URL(baseUrl);
+    if (!base.pathname.endsWith("/")) {
+        base.pathname = `${base.pathname}/`;
+    }
+    return new URL(path.replace(/^\/+/, ""), base);
+}
+function normalizeNonEmptyString(value) {
+    const normalized = value?.trim();
+    return normalized ? normalized : undefined;
+}

package/dist/index.d.ts

@@ -2,8 +2,7 @@ export { RelayFileClient, DEFAULT_RELAYFILE_BASE_URL, type AccessTokenProvider,
 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 { 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 MountMode, type MountSessionRequest, type MountSessionResponse, type MountSessionResult, type MountedWorkspaceHandle, type MountedWorkspaceStatus, type MountWorkspaceInput, type RelayfileSetupOptions, type RelayfileSetupRetryOptions, type WaitForConnectionOptions, type WorkspaceInfo, type WorkspaceIntegrationProvider, type WorkspaceMountEnv, type WorkspaceMountEnvOptions, type WorkspacePermissions } from "./setup-types.js";
-export { createDefaultMountLauncher, defaultMountLauncher, readMountedWorkspaceStatus } from "./mount-launcher.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 MountMode, type MountSessionRequest, type MountSessionResponse, type MountSessionResult, 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 RelayFileSyncState, type RelayFileSyncTokenProvider } from "./sync.js";
 export { onWrite, pathMatches, type OnWriteClient, type OnWriteHandler, type OnWriteHandlerError, type OnWriteOptions } from "./onWrite.js";
 export { InvalidStateError, PayloadTooLargeError, QueueFullError, RelayFileApiError, RevisionConflictError } from "./errors.js";

package/dist/index.js

@@ -2,7 +2,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 { WORKSPACE_INTEGRATION_PROVIDERS } from "./setup-types.js";
-export { createDefaultMountLauncher, defaultMountLauncher, readMountedWorkspaceStatus } from "./mount-launcher.js";
 export { RelayFileSync } from "./sync.js";
 export { onWrite, pathMatches } from "./onWrite.js";
 export { InvalidStateError, PayloadTooLargeError, QueueFullError, RelayFileApiError, RevisionConflictError } from "./errors.js";

package/dist/mount-launcher.d.ts

@@ -1,21 +1,10 @@
 import { spawn } from "node:child_process";
-import type { MountLauncher, MountMode, MountedWorkspaceStatus } from "./setup-types.js";
+import type { MountLauncher, MountedWorkspaceStatus, ReadMountedWorkspaceStatusInput } from "./setup-types.js";
 interface DefaultMountLauncherOptions {
     spawnImpl?: typeof spawn;
     now?: () => number;
     readyPollIntervalMs?: number;
 }
-interface ReadMountedWorkspaceStatusInput {
-    localDir: string;
-    workspaceId: string;
-    remotePath: string;
-    mode: MountMode;
-    relayfileBaseUrl: string;
-    relayfileToken: string;
-    expiresAt: string | null;
-    suggestedRefreshAt: string | null;
-    pid?: number;
-}
 export declare const defaultMountLauncher: MountLauncher;
 export declare function createDefaultMountLauncher(options?: DefaultMountLauncherOptions): MountLauncher;
 export declare function readMountedWorkspaceStatus(input: ReadMountedWorkspaceStatusInput): Promise<MountedWorkspaceStatus>;

package/dist/setup-types.d.ts

@@ -117,6 +117,17 @@ export interface MountedWorkspaceStatus {
     pendingWriteback?: number;
     pendingConflicts?: number;
 }
+export interface ReadMountedWorkspaceStatusInput {
+    localDir: string;
+    workspaceId: string;
+    remotePath: string;
+    mode: MountMode;
+    relayfileBaseUrl: string;
+    relayfileToken: string;
+    expiresAt: string | null;
+    suggestedRefreshAt: string | null;
+    pid?: number;
+}
 export interface MountedWorkspaceHandle {
     readonly workspaceId: string;
     readonly localDir: string;

package/dist/setup.d.ts

@@ -1,6 +1,7 @@
 import { RelayFileClient, type AccessTokenProvider } from "./client.js";
-import { type RelayfileCloudLoginOptions, type RelayfileCloudTokenSet, type RelayfileCloudTokenSetupOptions } from "./cloud-login.js";
-import { type EnsureMountedWorkspaceInput, type AgentWorkspaceInvite, type AgentWorkspaceInviteOptions, type AgentWorkspaceScopedInviteOptions, type ConnectIntegrationOptions, type ConnectIntegrationResult, type CreateWorkspaceOptions, type JoinWorkspaceOptions, type MountedWorkspaceHandle, type MountWorkspaceInput, type RelayfileSetupOptions, type WaitForConnectionOptions, type WorkspaceMountEnv, type WorkspaceMountEnvOptions, type WorkspaceInfo, type WorkspaceIntegrationProvider, type WorkspacePermissions } from "./setup-types.js";
+import { type RelayfileCloudTokenSet, type RelayfileCloudTokenSetupOptions } from "./cloud-token-provider.js";
+import type { RelayfileCloudLoginOptions } from "./cloud-login.js";
+import { type EnsureMountedWorkspaceInput, type AgentWorkspaceInvite, type AgentWorkspaceInviteOptions, type AgentWorkspaceScopedInviteOptions, type ConnectIntegrationOptions, type ConnectIntegrationResult, type CreateWorkspaceOptions, type JoinWorkspaceOptions, type MountLauncher, type MountedWorkspaceHandle, type MountedWorkspaceStatus, type MountWorkspaceInput, type ReadMountedWorkspaceStatusInput, type RelayfileSetupOptions, type WaitForConnectionOptions, type WorkspaceMountEnv, type WorkspaceMountEnvOptions, type WorkspaceInfo, type WorkspaceIntegrationProvider, type WorkspacePermissions } from "./setup-types.js";
 export { RELAYFILE_SDK_VERSION } from "./version.js";
 interface JoinWorkspaceResponse {
     workspaceId?: string;
@@ -53,6 +54,8 @@ export declare class RelayfileSetup {
     }): Promise<ValidatedJoinWorkspaceResponse>;
     requestJson(options: CloudRequestOptions): Promise<unknown>;
     getCloudApiUrl(): string;
+    protected getDefaultMountLauncher(): MountLauncher;
+    protected readMountedWorkspaceStatus(input: ReadMountedWorkspaceStatusInput): Promise<MountedWorkspaceStatus>;
     private resolveWorkspaceForMount;
     private createMountSession;
 }

package/dist/setup.js

@@ -1,10 +1,8 @@
-import path from "node:path";
 import { RelayFileClient } from "./client.js";
-import { createRelayfileCloudAccessTokenProvider, runRelayfileCloudLogin } from "./cloud-login.js";
-import { CloudAbortError, CloudApiError, CloudTimeoutError, InvalidLocalDirError, InvalidMountModeError, InvalidRemotePathError, IntegrationConnectionTimeoutError, MalformedCloudResponseError, MissingConnectionIdError, MountSessionInputError, ProviderNotConnectedError, ProviderNotReadyError, UnknownProviderError } from "./setup-errors.js";
+import { createRelayfileCloudAccessTokenProvider } from "./cloud-token-provider.js";
+import { CloudAbortError, CloudApiError, CloudTimeoutError, InvalidLocalDirError, InvalidMountModeError, InvalidRemotePathError, IntegrationConnectionTimeoutError, MalformedCloudResponseError, MissingConnectionIdError, MountSessionInputError, ProviderNotConnectedError, ProviderNotReadyError, RelayfileSetupError, UnknownProviderError } from "./setup-errors.js";
 import { WORKSPACE_INTEGRATION_PROVIDERS } from "./setup-types.js";
 import { RELAYFILE_SDK_VERSION } from "./version.js";
-import { defaultMountLauncher, readMountedWorkspaceStatus } from "./mount-launcher.js";
 export { RELAYFILE_SDK_VERSION } from "./version.js";
 const DEFAULT_CLOUD_API_URL = "https://agentrelay.com/cloud";
 const DEFAULT_RELAYCAST_BASE_URL = "https://api.relaycast.dev";
@@ -19,22 +17,19 @@ const DEFAULT_WAIT_TIMEOUT_MS = 300_000;
 const DEFAULT_MOUNT_READY_TIMEOUT_MS = 60_000;
 const DEFAULT_MOUNT_AGENT_NAME = "relayfile-mount";
 const TOKEN_REFRESH_AGE_MS = 55 * 60 * 1000;
+const nodeOnlyMountLauncher = {
+    async start() {
+        throw new RelayfileSetupError("The default relayfile-mount launcher is only available from @relayfile/sdk/cli. Import RelayfileSetup from @relayfile/sdk/cli or pass a custom launcher to mountWorkspace().", "node_only_sdk_feature");
+    }
+};
 export class RelayfileSetup {
     cloudApiUrl;
     accessToken;
     requestTimeoutMs;
     retryOptions;
     static async login(options = {}) {
-        const cloudApiUrl = options.cloudApiUrl ?? DEFAULT_CLOUD_API_URL;
-        const tokens = await runRelayfileCloudLogin({
-            ...options,
-            cloudApiUrl
-        });
-        await options.onTokens?.({ ...tokens });
-        return RelayfileSetup.fromCloudTokens(tokens, {
-            ...options,
-            cloudApiUrl: tokens.apiUrl ?? cloudApiUrl
-        });
+        void options;
+        throw new RelayfileSetupError("RelayfileSetup.login() starts a local HTTP callback server and is only available from @relayfile/sdk/cli. Import RelayfileSetup from @relayfile/sdk/cli for interactive Cloud login.", "node_only_sdk_feature");
     }
     static fromCloudTokens(tokens, options = {}) {
         const cloudApiUrl = options.cloudApiUrl ?? tokens.apiUrl ?? DEFAULT_CLOUD_API_URL;
@@ -107,7 +102,7 @@ export class RelayfileSetup {
         const normalized = normalizeMountWorkspaceInput(input);
         const workspace = await this.resolveWorkspaceForMount(normalized);
         const mountSession = await this.createMountSession(workspace, normalized);
-        const launcher = normalized.launcher;
+        const launcher = normalized.launcher ?? this.getDefaultMountLauncher();
         const launcherInstance = await launcher.start({
             env: buildMountLauncherEnv(mountSession),
             signal: normalized.signal,
@@ -129,7 +124,8 @@ export class RelayfileSetup {
         return new MountedWorkspaceHandleImpl({
             mountSession,
             launcherInstance: normalized.background ? launcherInstance : undefined,
-            probeOnly: !normalized.background
+            probeOnly: !normalized.background,
+            readStatus: (statusInput) => this.readMountedWorkspaceStatus(statusInput)
         });
     }
     async ensureMountedWorkspace(input) {
@@ -218,6 +214,18 @@ export class RelayfileSetup {
     getCloudApiUrl() {
         return this.cloudApiUrl;
     }
+    getDefaultMountLauncher() {
+        return nodeOnlyMountLauncher;
+    }
+    async readMountedWorkspaceStatus(input) {
+        return {
+            ready: true,
+            mode: input.mode,
+            pid: input.pid,
+            expiresAt: input.expiresAt,
+            suggestedRefreshAt: input.suggestedRefreshAt
+        };
+    }
     async resolveWorkspaceForMount(input) {
         if (input.workspace) {
             return input.workspace;
@@ -686,6 +694,7 @@ class MountedWorkspaceHandleImpl {
     mountSession;
     launcherInstance;
     probeOnly;
+    readStatus;
     readySnapshot = true;
     stopPromise;
     constructor(input) {
@@ -698,6 +707,7 @@ class MountedWorkspaceHandleImpl {
         this.suggestedRefreshAt = input.mountSession.suggestedRefreshAt;
         this.launcherInstance = input.launcherInstance;
         this.probeOnly = input.probeOnly;
+        this.readStatus = input.readStatus;
     }
     get ready() {
         return this.readySnapshot;
@@ -706,7 +716,17 @@ class MountedWorkspaceHandleImpl {
         return buildMountedWorkspaceEnv(this.mountSession);
     }
     async status() {
-        const status = await readMountedWorkspaceStatus({
+        if (this.launcherInstance) {
+            const status = await this.launcherInstance.status();
+            const mergedStatus = {
+                ...status,
+                expiresAt: this.expiresAt,
+                suggestedRefreshAt: this.suggestedRefreshAt
+            };
+            this.readySnapshot = mergedStatus.ready;
+            return mergedStatus;
+        }
+        const status = await this.readStatus({
             localDir: this.localDir,
             workspaceId: this.workspaceId,
             remotePath: this.remotePath,
@@ -907,14 +927,14 @@ function normalizeMountWorkspaceInput(input) {
     return {
         workspace: input.workspace,
         workspaceId: normalizeNonEmptyString(input.workspaceId),
-        localDir: path.resolve(localDir),
+        localDir: resolveLocalDir(localDir),
         remotePath: normalizeMountRemotePath(input.remotePath),
         mode: normalizeMountModeInput(input.mode),
         background: input.background !== false,
         agentName: normalizeNonEmptyString(input.agentName),
         scopes: input.scopes && input.scopes.length > 0 ? [...input.scopes] : undefined,
         signal: input.signal,
-        launcher: input.launcher ?? defaultMountLauncher,
+        launcher: input.launcher,
         readyTimeoutMs: Math.max(1, Math.floor(input.readyTimeoutMs ?? DEFAULT_MOUNT_READY_TIMEOUT_MS))
     };
 }
@@ -943,12 +963,63 @@ function normalizeMountRemotePath(remotePath) {
     if (segments.some((segment) => segment === "..")) {
         throw new InvalidRemotePathError(normalized);
     }
-    const resolved = path.posix.normalize(normalized.startsWith("/") ? normalized : `/${normalized}`);
+    const resolved = normalizePosixPath(normalized.startsWith("/") ? normalized : `/${normalized}`);
     if (!resolved.startsWith("/")) {
         throw new InvalidRemotePathError(normalized);
     }
     return resolved === "/" ? "/" : resolved.replace(/\/+$/, "");
 }
+function resolveLocalDir(localDir) {
+    const normalized = localDir.replace(/\\/g, "/");
+    if (isAbsolutePathLike(normalized)) {
+        return normalizePosixPath(normalized);
+    }
+    const cwd = readProcessCwd();
+    if (!cwd) {
+        return normalized;
+    }
+    return normalizePosixPath(`${cwd.replace(/\\/g, "/")}/${normalized}`);
+}
+function isAbsolutePathLike(value) {
+    return value.startsWith("/") || /^[A-Za-z]:\//.test(value);
+}
+function readProcessCwd() {
+    const maybeProcess = globalThis.process;
+    try {
+        return maybeProcess?.cwd?.();
+    }
+    catch {
+        return undefined;
+    }
+}
+function normalizePosixPath(value) {
+    const isDrivePath = /^[A-Za-z]:\//.test(value);
+    const prefix = isDrivePath
+        ? value.slice(0, 3)
+        : value.startsWith("/")
+            ? "/"
+            : "";
+    const rest = isDrivePath ? value.slice(3) : value;
+    const segments = [];
+    for (const segment of rest.split("/")) {
+        if (!segment || segment === ".") {
+            continue;
+        }
+        if (segment === "..") {
+            segments.pop();
+            continue;
+        }
+        segments.push(segment);
+    }
+    const joined = segments.join("/");
+    if (prefix === "/") {
+        return joined ? `/${joined}` : "/";
+    }
+    if (prefix) {
+        return joined ? `${prefix}${joined}` : prefix;
+    }
+    return joined || ".";
+}
 function normalizeNonEmptyString(value) {
     const normalized = value?.trim();
     return normalized ? normalized : undefined;

package/package.json

@@ -1,10 +1,35 @@
 {
   "name": "@relayfile/sdk",
-  "version": "0.7.23",
+  "version": "0.7.25",
   "description": "TypeScript SDK for relayfile — real-time filesystem for humans and agents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./cli": {
+      "types": "./dist/cli/index.d.ts",
+      "default": "./dist/cli/index.js"
+    },
+    "./cloud-login": {
+      "types": "./dist/cloud-login.d.ts",
+      "default": "./dist/cloud-login.js"
+    },
+    "./mount-launcher": {
+      "types": "./dist/mount-launcher.d.ts",
+      "default": "./dist/mount-launcher.js"
+    },
+    "./mount-harness": {
+      "types": "./dist/mount-harness.d.ts",
+      "default": "./dist/mount-harness.js"
+    },
+    "./dist/*": "./dist/*",
+    "./package.json": "./package.json"
+  },
+  "sideEffects": false,
   "files": [
     "dist"
   ],
@@ -22,7 +47,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@relayfile/core": "0.7.23"
+    "@relayfile/core": "0.7.25"
   },
   "devDependencies": {
     "typescript": "^5.7.3",