@agent-relay/factory 0.0.0 → 0.1.2

package/dist/mount/relayfile-binary.js

@@ -0,0 +1,177 @@
+import { accessSync, constants, readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+// ESM has no __dirname; derive this module's directory for the default search
+// start (used when no caller-supplied deployment dir is available).
+const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
+const STALE_RECONCILE_MS = 15 * 60 * 1000;
+const NOT_FOUND_ERROR = '[factory] relayfile-mount binary not found. Install dependencies or run: npm run relayfile-mount:install';
+export function coercePid(value) {
+    return typeof value === 'number' && Number.isInteger(value) && value > 0 ? value : undefined;
+}
+function canExecute(filePath) {
+    if (!filePath)
+        return false;
+    try {
+        accessSync(filePath, constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function devArchSuffix() {
+    if (process.platform === 'darwin') {
+        return process.arch === 'arm64' ? 'darwin-arm64' : 'darwin-amd64';
+    }
+    if (process.platform === 'linux') {
+        return process.arch === 'arm64' ? 'linux-arm64' : 'linux-amd64';
+    }
+    return `${process.platform}-${process.arch}`;
+}
+function binaryName() {
+    return process.platform === 'win32' ? 'relayfile-mount.exe' : 'relayfile-mount';
+}
+function optionalPackageArchSuffix() {
+    return `${process.platform}-${process.arch}`;
+}
+function findPearRoot(startDir) {
+    let current = resolve(startDir);
+    for (;;) {
+        try {
+            accessSync(join(current, 'factory.config.json'), constants.R_OK);
+            return current;
+        }
+        catch {
+            const parent = dirname(current);
+            if (parent === current)
+                return null;
+            current = parent;
+        }
+    }
+}
+function devRelayfileCandidates(pearRoot) {
+    const distRoot = resolve(process.env.RELAYFILE_DIST_DIR ?? join(pearRoot, '..', 'relayfile', 'dist'));
+    const suffix = devArchSuffix();
+    return [
+        join(distRoot, `relayfile-mount-${suffix}`),
+        join(distRoot, suffix, binaryName()),
+    ];
+}
+// @relayfile/sdk carries relayfile-mount through per-platform optional
+// dependencies. Prefer that bundled binary so factory start does not depend on
+// a global relayfile install or a manually populated repo bin/ directory.
+function optionalPackageCandidates(pearRoot) {
+    const suffix = optionalPackageArchSuffix();
+    return [
+        join(pearRoot, 'node_modules', '@relayfile', `mount-${suffix}`, 'bin', binaryName()),
+        join(pearRoot, 'node_modules', '@relayfile', 'sdk', 'node_modules', '@relayfile', `mount-${suffix}`, 'bin', binaryName()),
+    ];
+}
+export function resolveRelayfileMountBinary(startDir = MODULE_DIR) {
+    if (process.env.RELAYFILE_MOUNT_BIN) {
+        const explicitBinary = resolve(process.env.RELAYFILE_MOUNT_BIN);
+        if (canExecute(explicitBinary))
+            return explicitBinary;
+        throw new Error(NOT_FOUND_ERROR);
+    }
+    const pearRoot = findPearRoot(startDir);
+    const candidates = pearRoot
+        ? [
+            ...optionalPackageCandidates(pearRoot),
+            join(pearRoot, 'bin', binaryName()),
+            ...devRelayfileCandidates(pearRoot),
+        ]
+        : [];
+    for (const candidate of candidates) {
+        if (canExecute(candidate))
+            return resolve(candidate);
+    }
+    throw new Error(NOT_FOUND_ERROR);
+}
+function cliName() {
+    return process.platform === 'win32' ? 'relayfile.exe' : 'relayfile';
+}
+// The `relayfile` CLI (as opposed to the raw relayfile-mount binary) resolves
+// workspace credentials itself and bundles an up-to-date mount, so the factory
+// can start/refresh the writeback mount without plumbing a token — and without
+// depending on a possibly-stale @relayfile/mount-* node_modules binary. Prefer
+// it; fall back to the raw binary only when no CLI is on PATH.
+export function resolveRelayfileCli() {
+    const explicit = process.env.RELAYFILE_BIN;
+    if (explicit)
+        return canExecute(explicit) ? resolve(explicit) : undefined;
+    const exe = cliName();
+    const separator = process.platform === 'win32' ? ';' : ':';
+    for (const dir of (process.env.PATH ?? '').split(separator)) {
+        if (!dir)
+            continue;
+        const candidate = join(dir, exe);
+        if (canExecute(candidate))
+            return resolve(candidate);
+    }
+    return undefined;
+}
+export function checkMountStaleness(stateFilePath, workspaceId, 
+// Alternate identifiers that name the SAME workspace (e.g. the cloud-side
+// UUID for a `rw_` handle). The local mount records the cloud UUID in its
+// state.json, so without these aliases a handle-vs-UUID comparison would
+// report a false "workspace mismatch".
+acceptableWorkspaceIds = []) {
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(stateFilePath, 'utf8'));
+    }
+    catch (error) {
+        if (typeof error === 'object' && error !== null && 'code' in error && error.code === 'ENOENT') {
+            return { stale: false };
+        }
+        return { stale: true, reason: `mount state is unreadable: ${error instanceof Error ? error.message : String(error)}` };
+    }
+    if (typeof parsed !== 'object' || parsed === null) {
+        return { stale: true, reason: 'mount state is unreadable: expected object' };
+    }
+    const registeredWorkspaceId = typeof parsed.workspaceId === 'string' ? parsed.workspaceId : undefined;
+    const accepted = new Set([workspaceId, ...acceptableWorkspaceIds]);
+    if (registeredWorkspaceId === undefined || !accepted.has(registeredWorkspaceId)) {
+        return {
+            stale: true,
+            reason: `workspace mismatch: registered=${registeredWorkspaceId ?? 'unknown'} expected=${[...accepted].join('|')}`,
+        };
+    }
+    // Prefer the top-level pid; fall back to the CLI-daemonized mount's daemon.pid.
+    const pid = coercePid(parsed.pid) ?? coercePid(parsed.daemon?.pid);
+    const lastReconcileAt = typeof parsed.lastReconcileAt === 'string'
+        ? Date.parse(parsed.lastReconcileAt)
+        : NaN;
+    if (!Number.isFinite(lastReconcileAt)) {
+        return { stale: true, reason: 'last reconcile timestamp is missing', pid };
+    }
+    const ageMs = Date.now() - lastReconcileAt;
+    if (ageMs > STALE_RECONCILE_MS) {
+        return {
+            stale: true,
+            reason: `last reconcile ${Math.floor(ageMs / 60000)}m ago`,
+            pid,
+        };
+    }
+    if (pid === undefined) {
+        // Neither a top-level pid nor daemon.pid was recorded. The fresh
+        // lastReconcileAt validated above is itself proof the mount is live and
+        // reconciling, so fall back to that rather than declaring a healthy mount
+        // stale and forcing a spurious refresh (which previously tore down the live
+        // mount and then failed to re-spawn).
+        return { stale: false };
+    }
+    try {
+        process.kill(pid, 0);
+    }
+    catch (error) {
+        if (typeof error === 'object' && error !== null && 'code' in error && error.code === 'EPERM') {
+            return { stale: false, pid };
+        }
+        return { stale: true, reason: `mount process (pid ${pid}) is not running`, pid };
+    }
+    return { stale: false, pid };
+}
+//# sourceMappingURL=relayfile-binary.js.map

package/dist/mount/relayfile-binary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relayfile-binary.js","sourceRoot":"","sources":["../../src/mount/relayfile-binary.ts"],"names":[],"mappings":"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"}

package/dist/mount/relayfile-cloud-mount-client.d.ts

@@ -0,0 +1,123 @@
+import { type ActiveWorkspaceDescriptor, type CloudSession, type CloudSessionOptions } from '@agent-relay/cloud';
+import { type ChangeEvent, type DeleteFileInput, type EventFeedResponse, type FileReadResponse, type GetEventsOptions, type ListTreeOptions, type ResourceAtEventResult, type OperationStatusResponse, type Subscription, type TreeResponse, type WriteFileInput, type WriteQueuedResponse } from '@relayfile/sdk';
+import type { EventPage, MountClient, ProviderSyncStatus, SubscribeOptions } from '../ports/index.js';
+import { type RelayfileEventClient, type TokenProvider } from '../subscriptions/index.js';
+export declare const FACTORY_RELAYFILE_SCOPES: readonly ["relayfile:fs:read:/linear/issues/**", "relayfile:fs:write:/linear/issues/**", "relayfile:fs:read:/github/repos/**", "relayfile:fs:read:/slack/channels/**", "relayfile:fs:write:/slack/channels/**", "relayfile:fs:read:/slack/users/**"];
+export type CloudSessionProvider = (options?: CloudSessionOptions) => Promise<CloudSession>;
+export type ActiveWorkspaceResolver = (options?: {
+    interactive?: boolean;
+}) => Promise<ActiveWorkspaceDescriptor>;
+export interface ResolvedFactoryWorkspace {
+    /** Relayfile workspace handle (e.g. `rw_7ccfea89`) — what the mount/config use. */
+    workspaceId: string;
+    /**
+     * Cloud-side UUID for the same workspace (e.g. `50587328-…`). The local
+     * relayfile mount records this form in its state.json, so it is passed to the
+     * staleness check as an accepted alias to avoid a spurious "workspace
+     * mismatch" warning when handle and UUID refer to the same workspace.
+     */
+    cloudWorkspaceId?: string;
+}
+/**
+ * Derive the factory's workspace from the active cloud session rather than a
+ * hardcoded config value. `resolveActiveWorkspace()` resolves the locally
+ * pinned workspace against the cloud API and returns both identifier forms.
+ * Falls back to the built-in default when resolution fails (offline / no
+ * session), so callers always get a usable handle.
+ */
+export declare function resolveFactoryWorkspace(resolver?: ActiveWorkspaceResolver): Promise<ResolvedFactoryWorkspace>;
+export interface RelayfileWorkspaceHandleLike {
+    info: {
+        relayfileUrl: string;
+    };
+    client(): RelayFileClientLike;
+    getToken(): Promise<string> | string;
+}
+export type RelayfileSetupFactory = (options: {
+    cloudApiUrl: string;
+    tokenProvider: () => Promise<string>;
+}) => {
+    joinWorkspace(workspaceId: string, options?: {
+        agentName?: string;
+        scopes?: string[];
+    }): Promise<RelayfileWorkspaceHandleLike>;
+};
+export interface RelayfileCloudMountClientConfig {
+    backend?: 'relayfile-cloud';
+    workspaceId?: string;
+    cloudApiUrl?: string;
+    cloudSessionProvider?: CloudSessionProvider;
+    cloudSessionRefreshTimeoutMs?: number;
+    cloudSessionEnv?: NodeJS.ProcessEnv;
+    relayfileSetupFactory?: RelayfileSetupFactory;
+    agentName?: string;
+    scopes?: string[];
+    client?: RelayFileClientLike;
+    tokenProvider?: TokenProvider;
+    baseUrl?: string;
+    eventClient?: RelayfileEventClient;
+    isAllowedDraft?: (path: string, content: unknown, opts?: {
+        guarded?: boolean;
+    }) => boolean | Promise<boolean>;
+    isAllowedDelete?: (path: string, currentContent: unknown) => boolean | Promise<boolean>;
+}
+export type RelayFileClientLike = {
+    readFile(workspaceId: string, path: string): Promise<FileReadResponse>;
+    writeFile(input: WriteFileInput): Promise<WriteQueuedResponse>;
+    deleteFile(input: DeleteFileInput): Promise<WriteQueuedResponse>;
+    listTree(workspaceId: string, options?: ListTreeOptions): Promise<TreeResponse>;
+    getEvents(workspaceId: string, options?: GetEventsOptions): Promise<EventFeedResponse>;
+    listLastNChanges?(limit: number, context?: {
+        workspaceId: string;
+        token?: string;
+    }): Promise<{
+        events: ChangeEvent[];
+    }>;
+    getResourceAtEvent(eventId: string, context?: {
+        workspaceId: string;
+        token?: string;
+    }): Promise<ResourceAtEventResult>;
+    getOp?(workspaceId: string, opId: string): Promise<OperationStatusResponse>;
+    getSyncStatus?(workspaceId: string, options?: {
+        provider?: string;
+    }): Promise<unknown>;
+    getToken?(): Promise<string> | string;
+    getBaseUrl?(): string;
+};
+export declare class RelayfileCloudMountClient implements MountClient {
+    #private;
+    readonly workspaceId: string;
+    readonly writebackTransport = "relayfile-cloud";
+    constructor(config?: RelayfileCloudMountClientConfig);
+    setDefaultAllowedDraftPredicate(predicate: (path: string, content: unknown, opts?: {
+        guarded?: boolean;
+    }) => boolean | Promise<boolean>): void;
+    static fromConfig(config?: RelayfileCloudMountClientConfig): Promise<RelayfileCloudMountClient>;
+    readFile(path: string): Promise<{
+        content: unknown;
+        revision?: string;
+    }>;
+    writeFile(path: string, content: unknown, opts?: {
+        guarded?: boolean;
+    }): Promise<void>;
+    deleteFile(path: string): Promise<void>;
+    listTree(prefix: string): Promise<string[]>;
+    subscribe(globs: string[], onChange: (event: ChangeEvent) => void, opts?: SubscribeOptions): Subscription;
+    getEvents(opts: {
+        cursor?: string;
+        limit?: number;
+        provider?: string;
+        last?: number;
+    }): Promise<EventPage>;
+    getEventHighWatermark(opts?: {
+        provider?: string;
+    }): Promise<string | undefined>;
+    getSyncStatus(provider: string): Promise<ProviderSyncStatus | undefined>;
+    confirmWrite(path: string, opts?: {
+        timeoutMs?: number;
+    }): Promise<'acked' | 'pending' | 'failed' | 'timeout'>;
+    ensureSubRoot(prefix: string, _opts?: {
+        timeoutMs?: number;
+    }): Promise<'ready' | 'absent'>;
+}
+//# sourceMappingURL=relayfile-cloud-mount-client.d.ts.map

package/dist/mount/relayfile-cloud-mount-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relayfile-cloud-mount-client.d.ts","sourceRoot":"","sources":["../../src/mount/relayfile-cloud-mount-client.ts"],"names":[],"mappings":"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"}